19模块 和 包

 

1. 模块

---

1.1 模块的概念

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

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

1.2 模块的两种导入方式

1) import 导入

import 模块名1, 模块名2  # 会报错, 有波浪线, 不推荐

提示 : 在导入模块时, 每个导入应该独占一行

import 模块名1
import 模块名2

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

使用 as 指定模块的别名

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

import 模块名1 as 模块别名

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

2) from...import 导入

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

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

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

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

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

form ... import * (知道)

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

注意

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

1.3 模块的搜索顺序(扩展)

Python 的解释器在 导入模块 时, 会 :

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

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

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

示例

import random

rand = random.randint(0, 10)

print(rand)
print(random.__file__)

注意: 如果当前目录下, 存在一个 random.py 的文件, 程序就无法正常执行了!

• 这个时候, Python 的解释器会 加载当前目录 下的 random.py 而不会加载 系统的 random 模块

1.4 原则 ---- 每一个文件都应该是可以被导入的

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

实际开发场景

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

__name__ 属性

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

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

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

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

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

# 根据 __name__ 判断是否执行下方代码
if __name__ == "__main__":
    main()
或者
# 全局变量,函数,类,注意: 直接执行的代码不是向外界提供的工具!

# 文件被导入时, 能够直接执行的代码不需要被执行!


def say_hello():
    print("hello world")


if __name__ == "__main__":
    print("直接执行!!!")
    print(__name__)

    say_hello()

if __name__ == "__main__": 意思就是执行当前程序, 下面的代码都加了缩进

2. 包 (package)

---

概念

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

好处

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

案例演练

1. 新建一个 wk_message 的 包
2. 在目录下, 新建两个文件 send_message 和 receive_message
3. 在 send_message 文件中定义一个 send 函数
4. 在 receive_message 文件中定义一个 receive 函数
5. 在外部直接导入 wk_message

__init__.py

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

# 从 当前目录 导入 模块列表

from . import send_message
from . import receive_message  

3. 发布模块 (知道)

---

• 如果希望自己开发的模块, 分享 给其他人, 可以按以下操作来

3.1 制作发布压缩包步骤

1) 创建 setup.py 的文件

from distutils.core import setup

setup(name="wk_message",  # 包名
      version="1.0",  # 版本
      description="发送信息和接收信息模块",
      long_description="完整的描述信息",
      author="作者",
      author_email="作者邮箱",
      url="主页",
      py_modules=["wk_message.send_message",
                  "wk_message.receive_message"])

2) 构建模块 (控制台)

$ python3 setup.py build

3) 生成发布压缩包 (控制台)

$ python3 setup.py sdist

注意: 要制作哪个版本的模块, 就使用哪个版本的解释器

3.2 安装模块

$ tar -zxvf wk_message-1.0.tar.gz
$ sudo python3 setup.py install

卸载模块

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

$ sudo rm -r wk_message*

3.3 pip 安装第三方模块

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

安装和卸载命令如下:

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