19. 模块和包（发布包还有一点小问题未解决）

模块：

模块的概念

模块的两种导入方式

模块：

模块的概念

模块是 Python 程序架构的一个核心概念

每一个以扩展名 py 结尾的 Python 源代码文件都是一个模块
模块名 同样也是一个 标识符，需要符合标识符的命名规则
在模块中定义的 全局变量 、函数、类都是提供给外界直接使用的工具
模块就好比是 工具包，要想使用这个工具包中的工具，就需要先导入这个模块

模块的两种导入方式

import导入

import 模块名1
import 模块名2

导入之后
- 通过 模块名. 使用 模块提供的工具 —— 全局变量、函数、类

使用 as 指定模块的别名

如果模块的名字太长，可以使用 as 指定模块的名称，以方便在代码中的使用

import 模块名1 as 模块别名

注意：模块别名 应该符合 大驼峰命名法

演示

写两个.py作为模块

使 import 导入第一个文件，使用import as 取一个别名导入第二个文件

from...import 导入

如果希望 从某一个模块 中，导入部分工具，就可以使用 from ... import 的方式
import 模块名 是 一次性 把模块中 所有工具全部导入，并且通过 模块名/别名 访问

# 从 模块 导入 某一个工具
from 模块名1 import 工具名

导入之后
- 不需要 通过 模块名.
- 可以直接使用 模块提供的工具 —— 全局变量、函数、类

注意

如果 两个模块，存在 同名的函数，那么 后导入模块的函数，会 覆盖掉先导入的函数

开发时 import 代码应该统一写在 代码的顶部，更容易及时发现冲突
一旦发现冲突，可以使用 as 关键字 给其中一个工具起一个别名

from...import *（知道）

# 从 模块 导入 所有工具
from 模块名1 import *

注意

这种方式不推荐使用，因为函数重名并没有任何的提示，出现问题不好排查

演示：

模块的搜索顺序

Python 的解释器在 导入模块 时，会：

搜索 当前目录 指定模块名的文件，如果有就直接导入
如果没有，再搜索 系统目录

在开发时，给文件起名，不要和系统的模块文件重名

Python 中每一个模块都有一个内置属性 __file__ 可以 查看模块 的 完整路径

演示：

`name` 属性:

一个 独立的 Python 文件 就是一个模块
在导入文件时，文件中 所有没有任何缩进的代码 都会被执行一遍！

实际开发场景

在实际开发中，每一个模块都是独立开发的，大多都有专人负责
开发人员 通常会在 模块下方 增加一些测试代码
- 仅在模块内使用，而被导入到其他文件中不需要执行

__name__ 属性

__name__ 属性可以做到，测试模块的代码 只在测试情况下被运行，而在 被导入时不会被执行！

__name__ 是 Python 的一个内置属性，记录着一个 字符串
如果 是被其他文件导入的，__name__ 就是 模块名
如果 是当前执行的程序 __name__ 是 __main__

在很多 Python 文件中都会看到以下格式的代码：

# 导入模块
# 定义全局变量
# 定义类
# 定义函数

# 在代码的最下方
def main():
    # ...
    pass

# 根据 __name__ 判断是否执行下方代码
if __name__ == "__main__":
    main()

演示：

我们在模块中需要测试一下：例如这样，

我在另一个文件中导入这个模块就会出现问题：只写一个导入语句，然后执行

结果是这样的：把导入文件中的测试部分直接执行了。

解决办法：__name__:如果在这个模块中执行 __name__记录的字符串就是 __main__

包（Package）

概念

包是一个 包含多个模块 的 特殊目录
目录下有一个 特殊的文件 __init__.py
包名的 命名方式 和变量名一致，小写字母 + _

好处

使用 import 包名 可以一次性导入包中 所有的模块

`init.py`

要在外界使用包中的模块，需要在 __init__.py 中指定 对外界提供的模块列表

# 从 当前目录 导入 模块列表
from . import send_message
from . import receive_message

演示：

1.新建一个包的文件：

新建之后，该文件夹会出现一个__init__.py文件。也可以自己建立一个文件夹，在文件夹里创建一个__init__.py文件

2.在新建的文件夹里，就可以建立.py文件。我将上面用来测试的两个模块文件复制到该文件夹下（偷懒）

3.需要在 __init__.py 中指定对外界提供的模块列表

4.在包外的文件中新建.py文件，然后在导入包，在调用包内的模块。

发布模块

如果希望自己开发的模块，分享给其他人，可以按照以下步骤操作

制作发布压缩包步骤

1) 创建 setup.py

setup.py 的文件

from distutils.core import setup

setup(name="",  # 包名
      version="",  # 版本
      description="",  # 描述信息
      long_description="",  # 完整描述信息
      author="",  # 作者
      author_email="",  # 作者邮箱
      url="",  # 主页
      py_modules=["",
                  ""])

2) 构建模块

$ python3 setup.py build

3) 生成发布压缩包

$ python3 setup.py sdist

注意：要制作哪个版本的模块，就使用哪个版本的解释器执行！

安装模块

$ tar -zxvf 压缩包名字.tar.gz 

$ sudo python3 setup.py install

卸载模块

直接从安装目录下，把安装模块的目录删除就可以

$ cd /usr/local/lib/python3.5/dist-packages/
$ sudo rm -r hm_message*

演示：

1.setup

2.构建模块：

3.生成发布压缩包：

4.解压安装包

5.安装模块

6.卸载模块:

找到包的路径：

直接从安装目录下，把安装模块的目录删除就可以

`pip` 安装第三方模块

第三方模块 通常是指由 知名的第三方团队 开发的 并且被 程序员广泛使用 的 Python 包 / 模块
- 例如 pygame 就是一套非常成熟的 游戏开发模块
pip 是一个现代的，通用的 Python 包管理工具
提供了对 Python 包的查找、下载、安装、卸载等功能

安装和卸载命令如下：

# 将模块安装到 Python 2.x 环境
$ sudo pip install pygame
$ sudo pip uninstall pygame

# 将模块安装到 Python 3.x 环境
$ sudo pip3 install pygame
$ sudo pip3 uninstall pygame