Python语法之模块和包

这一节，我将为大家介绍模块和包：
> 在开发大型软件时，随着代码写的越来越多，如果将所有的代码都放在一个文件里，势必为以后的维护带来很大的困难。正如仓颉造字一样，仓颉是黄帝的史官，用祖传结绳记事的老办法记载史实。时间一长，那些大大小小，奇形怪状的绳结都记了些什么，连他自己也没法辨认了。于是，仓颉开始想新的办法，用什么方式可以帮助大家分辨清不同的事物，在仓颉的努力下，他创造了文字，解决了这个问题。而在 Python 中，为了编写易于维护的代码，我们会将代码拆分放到不同的文件里，这样每个文件包含的代码相对就会减少。在 Python 中，一个 .py 文件称为一个模块（Module）。

模块化能够带来很多好处：
（1）简化问题求解
将所有代码放在一个文件中时，我们需要考虑的是整个问题的求解，代码实现的复杂度大大增加。将代码拆分放在多个文件中时，每个文件只需要对子问题进行求解，代码实现的复杂度大大降低。
（2）提高代码可维护性
由于解决不同子问题的代码放在了不同的文件中，代码之间的依赖性小，其中一个文件的修改对其他文件产生影响的几率大大降低。维护人员可以对其中一个文件的代码进行修改，而不必熟悉其他文件中的代码。由于每个文件专注于解决一个子问题，文件之间的并行开发成为可能。
（3）提高代码可重用性
一个模块编写完成后，可以被其他地方引用。我们在编写程序的时候，也可以引用其他模块，包括 Python 内置的模块和来自第三方的模块。这样就不需要重复造轮子。大大提高了代码的复用性和开发效率。
（4）减少代码冲突
模块提供了一个独立的命名空间，独立命名空间的好处是可以避免函数名和变量名冲突。相同名字的函数和变量可以放在不同的模块中。因此，我们自己在编写模块时，不必考虑名字会与其他模块冲突。但是也要注意，尽量不要与内置函数名字冲突。
了解了模块是什么之后，我们一起来看下如何创建模块？
```python

```
## 1. 模块的创建
模块的创建非常简单，一个 .py 文件便是一个模块（Module）。将下面的代码保存在 utils.py 文件中，这个操作是非常简单的，只需要我们创建一个文件名为 utils 的 py 文件，然后将代码复制到 utils 的 py 文件中就完成了一个模块的创建。
```
# utils.py模块
def max_num(a, b):
    if a >= b:
        return a
    else:
        return b

def min_num(a, b):
    if a > b:
        return b
    else:
        return a
```
这样我们便创建了一个名为 utils 的模块，在这个模块中，定义了两个函数： max_num和min_num ，两个函数分别为求两个数中的大数和小数。
## 2. 模块的导入
### 2.1import <module_name>
模块创建完成后，可以使用 import 关键字来导入模块，例如：
```
import utils
```
我们看到通过 import 模块名 的方式完成了模块导入。
执行上述指令后，Python 首先会从自己内置模块中查找是否含有该模块的定义，若未查询到会从 sys.path 对应的模块路径查询是否含有对应模块的定义，如果搜索完成，仍然没有对应的模块时，则抛出 import 的异常。
也就是说当执行 import utils 这条指令时，Python 会从以下路径中搜索模块 utils.py 。
在当前目录下搜索该模块。
在环境变量 PYTHONPATH 指定的路径列表中依次搜索。
在 Python 安装路径的 lib 库中搜索。
上述路径可以通过变量 sys.path 获得，该变量位于模块 sys 中。sys.path是 Python 的一个系统变量，是 Python 搜索模块的路径列表。其获取的方法如下：
```
import sys

print(sys.path)
```
为了让创建的模块能够被找到，需要将模块放到上述路径中的一个，因为 Python 只会在这些路径中去查找模块，如果没有将模块创建在这些路径中，则找不到对应的模块，也就没办法应用模块中的对象和方法了。
现在呢，我们想要去调用模块 utils 中的 max_num 和 min_num 方法，第一步为导入模块 utils，第二步为调用模块 utils 中的两个方法，具体语句如下：
```
#导入模块utils
import utils

print(utils.max_num(4, 5))
print(utils.min_num(4, 5))
```
下一节接着讲模块创建的其他属性。。。
### 2.2 from <module_name> import <name(s)>
下面，我们一起来看模块导入的另一种方法，直接导入模块中的对象，语句为：from 模块名 import 方法名，我们一起看下方实例：
```
from utils import max_num, min_num

print(max_num(4, 5))
print(min_num(4, 5))
```
使用这种方式导入时，调用 max_num 和 min_num 函数便不需要添加前缀 utils.。
有时候，为了方便，会使用 from <module_name> import * 来导入模块中的所有对象。
```
from utils import *

print(max_num(4, 5))
print(min_num(4, 5))
```
### 2.3 from <module_name> import  as <alt_name>
Python 中模块内的对象和方法也可以有自己的别名，实现语句为： from 模块名 import *** as 别名 ，该命令为导入的对象起一个别名。这样就可以通过别名来使用对象。例如：
```
from utils import max_num as max_n, min_num as min_n

print(max_n(4, 5))
print(min_n(4, 5))
```
在上面的例子中，分别为 max_num,min_num 取了别名 max_n,min_n。这样在调用函数时，便可以使用 max_n,min_n。
### 2.4 import <module_name> as <alt_name>
我们还可以为导入的整个模块起一个别名，这样便可以通过模块的别名来使用模块，使用方法是一样的，都是将 模块名. 作为前缀。例如：
```
import utils as ul

print(ul.max_num(4, 5))
print(ul.min_num(4, 5))
```
在上面的例子中，为模块 utils 取了别名 ul，这样在调用函数时，便可以使用 ul. 前缀。
### 2.5 包含单个类的模块
一起来看下包含单个类的模块，我们创建一个模块(car.py)，包含类 car ，语句如下：
```
class Car:
    def __init__(self, mk, md, y, c):
        self.make = mk
        self.model = md
        self.year = y
        self.color = c
        self.mileage = 0

    def get_description(self):
        description = f'{self.year} {self.color} {self.make} {self.model}'
        print(description)

    def get_mileage(self):
        print(f"This car has {self.mileage} miles on it")

    def update_mileage(self, mile):
        self.mileage = mile
```
导入类(my_car.py)：
```
from car import Car

my_car = Car('audi', 'a4', 2016, 'white')
my_car.get_description()
my_car.update_mileage(30)
my_car.get_mileage()
```
### 2.6 包含多个类的模块
我们创建模块(car.py)，其中包含父类 car 和继承类 Electriccar ，语句如下：
```
class Car:
    def __init__(self, mk, md, y, c):
        self.make = mk
        self.model = md
        self.year = y
        self.color = c
        self.mileage = 0

    def get_description(self):
        description = f'{self.year} {self.color} {self.make} {self.model}'
        print(description)

    def get_mileage(self):
        print(f"This car has {self.mileage} miles on it")

    def update_mileage(self, mile):
        self.mileage = mile

class ElectricCar(Car):
    def __init__(self, mk, md, y, c):
        super().__init__(mk, md, y, c)
        self.battery_size = 100

    def get_battery(self):
        print(f"This car has {self.battery_size} -kWh battery.")
```
导入单个类(my_electirc_car.py):
```
from car import ElectricCar

my_tesla = ElectricCar('tesla', 'model 3', 2018, 'white')
my_tesla.get_description()
my_tesla.get_battery()
```
导入多个类(my_cars.py):
```
from car import ElectricCar, Car

my_car = Car('audi', 'a4', 2016, 'white')
my_car.update_mileage(30)
my_car.get_mileage()

my_tesla = ElectricCar('tesla', 'model 3', 2018, 'white')
my_tesla.get_description()
my_tesla.get_battery()
```
导入整个模块：
```
import car

my_car = car.Car('audi', 'a4', 2016, 'white')
my_car.update_mileage(30)
my_car.get_mileage()

my_tesla = car.ElectricCar('tesla', 'model 3', 2018, 'white')
my_tesla.get_description()
my_tesla.get_battery()
```
导入模块中的全部类：
```
from car import *

my_car = Car('audi', 'a4', 2016, 'white')
my_car.update_mileage(30)
my_car.get_mileage()

my_tesla = ElectricCar('tesla', 'model 3', 2018, 'white')
my_tesla.get_description()
my_tesla.get_battery()
```
## 3. 包
在程序中呢，也会遇到和仓颉一样的问题，就是假设我们开发了一个很庞大的应用程序，程序包含了非常多的模块。随着模块数量的增长，如果将模块都放在同一个目录下，将变得越来越难管理。特别当模块具有相似的名称或相似的功能。这时候我们非常希望对这些模块进行分组管理，Python 中的包实现了对模块分组管理的功能。包的创建非常简单，它利用了操作系统的分层文件结构。我们只要将模块放在一个目录下便可。
在上图中，目录 pkg 下有两个模块，utils1.py 和 utils2.py，pkg 便是一个包。（包相当于一个文件夹，模块则相当于文件夹中的文件）
两个模块中的语句如下：（语句相当于文件中的内容）
utils1.py:
```
def max_num(a, b):
    if a >= b:
        return a
    else:
        return b

def min_num(a, b):
    if a > b:
        return b
    else:
        return a
```
utils2.py:
```
def sum_num(a, b):
    return a + b

def abs_num(a):
    if a >= 0:
        return a
    else:
        return -a
```
### 3.1 import <module_name>[, <module_name> ...]
导入包中的模块，语法规则为：import 包.模块名，我们一起看下方语句：
```
import pkg.utils1
import pkg.utils2

print(pkg.utils1.max_num(4, 5))
print(pkg.utils2.sum_num(4, 5))
```
导入包 pkg 中的模块 utils1 和模块 utils2，并调用两个模块中的方法，将 pkg.utils1. 作为前缀放在 max_num()方法前，表示是在 pkg 包中的模块 utils1 内的方法。
### 3.2 from <package_name> import <modules_name>[, <module_name> ...]
我们也可以通过 from 语句来实现模块的导入，我们一起看下方语句：
```
from pkg import utils1, utils2

print(utils1.max_num(4, 5))
print(utils2.sum_num(4, 5))
```
### 3.3 from <module_name> import <name(s)>
我们再来一起看下，定义包之后，导入指定模块中的对象，我们看下方语句：
```
from pkg.utils1 import max_num

print(max_num(4, 5))
```
和第二部分模块导入相比，就是在模块名前将包的名字作为前缀 pkg.utils1 来实现的，其余语句均与模块导入一致。
### 3.4 from <module_name> import  as <alt_name>
为模块内的对象和方法设置别名，语句如下：
```
from pkg.utils1 import max_num as max_n

print(max_n(4, 5))
```
### 3.5 from <package_name> import <module_name> as <alt_name>
为导入的整个模块设置别名，语句如下：
```
from pkg import utils1 as ul1

print(ul1.max_num(4, 5))
```
## 4. 小试牛刀
自定义一个模块，并在另一个文件中导入这个模块。