20_Python-模块与包

一、模块

模块就是工具包,要想使用这个工具包中的工具(就好比函数),就需要导入这个模块

二、如何导入模块

当解释器遇到import语句,如果模块在当前的搜索路径就会被导入

1、为什么必须加上模块名调用呢？
import 模块名.函数名
因为可能存在这样一种情况:在多个模块中含有相同名称的函数,
如果只是通过函数名来调用,解释器无法知道到底要调用哪个函数。
所以如果像上述这样引入模块的时候,调用函数必须加上模块名。

2、如果只需要用到模块中的某个函数/变量/类,如何导入呢?
from 模块名 import 函数/变量名
通过这种方式引入的时候,调用函数时只能给出函数名,不能给出模块名,但是当两个模块中含有相同名称函数的时候,后面一次引入会覆盖前一次引入。

3、如果导入的模块名/函数名/变量名过长,该如何操作呢?
import 长模块名 as 短模块名
from 模块名 import 长函数名 as 短函数名

4、如果把一个模块的所有内容全部导入，如何操作呢？
**from 模块名 import ***
这提供了一个简单的方法来导入一个模块中的所有项目。然而这种声明不该被过多地使用。

5、模块中的 __all__有什么作用？
如果一个文件中有all变量，那么也就意味着这个变量中的元素，不会被from xxx import * 时导入

三、如何定位模块？

（1）导入一个模块,Python解析器对模块位置的搜索顺序是:

1. 当前目录
2. 如果不在当前目录,Python则搜索在shell变量PYTHONPATH下的每个目录。
3. 如果都找不到,Python会察看默认路径。UNIX下,默认路径一般为/usr/local/lib/python/
4. 模块搜索路径存储在system模块的sys.path变量中。

四、包

（1）包将有联系的模块组织在一起，有效避免模块名称冲突问题，让应用组织结构更加清晰。

一个普通的python应用程序目录结构：

假设你现在想要设计一个模块集（一个“包”）来统一处理声音文件和声音数据。
存在几种不同的声音格式（通常由它们的扩展名来标识，例如： .wav, .aiff, .au ）
于是，为了在不同类型的文件格式之间转换，你需要维护一个不断增长的包集合。
可能你还想要对声音数据做很多不同的操作（例如混音，添加回声，应用平衡 功能，创建一个人造效果）
所以你要加入一个无限流模块来执行这些操作。你的包可能会是这个样子（通过分级的文件体系来进行分组）：

（2）官方文档中的例子

import sound.efforts.echo
导入 sound.effects.echo 子模块。但必须通过完整的名称来引用

from sound.effects import echo
加载了 echo 子模块，且使得在没有包前缀的情况下也可以使用

from sound.effects.echo import echofilter
加载了 echo 字模块，但这样就可以直接调用它的 echofilter() 函数

（3）从*导入包

1、import * 理论上是希望文件系统找出包中所有的子模块，然后导入它们。But 会花长时间，并出现边界效应等。Python 解决方案是提供一个明确的包索引。
这个索引由 init.py 定义 all 变量，该变量为一列表， 只会导入指定的内容

五、模块的制作与发布

1、模块制作
（1）定义模块
在Python中,每个Python文件都可以作为一个模块,模块的名字就是文件的名字。
（2）调用模块
（3）测试模块
在实际开中,当一个开发人员编写完一个模块后,为了让模块能够在项目中达到想要的效果,这个开发人员会自行在py文件中添加一些测试信息。

2、测试代码,应该是单独执行文件时才应该执行的,不应该是其他的文件中引用而执行, 如何解决这个问题呢?
python在执行一个文件时有个变量 name
可以根据__name__变量的结果能够判断出,是直接执行的python脚本还是被引入执行的,从而能够有选择性的执行测试代码.

if   __name__=='__main__':
	pass

3、模块发布:准备发布
（1）. 为模块文件创建一个文件夹，并将模块文件复制到这个文件中（一般，文件夹的名字和模块的名字一样）

（2）. 在文件夹中创建一个名为『setup.py』的文件，内容如下：

4、模块发布: 构建发布 & 发布预览
（1）构建模块并一个发布文件

python setup.py build
python setup.py sdist

（2）将发布安装到你的Python本地副本中：

python setup.py install

（3）发布预览