Python——模块 [ 笔记 ]

---

01. 模块化(module)程序设计概念

模块和包概念的进化史

  程序越来越复杂，语句 多了，我们会将实现同一个功能的语句封装到函数中，统一管理和调用，于是 “函数” 诞生了。

  程序更加复杂，函数和变量 多了，我们将同一类型对象的“数据和行为”，也就是“变量和函数”，放到一起统一管理和调用，于是 “类和对象” 诞生了。

  程序继续复杂，函数和类 更加多了，我们将实现类似功能的函数和类统统放到一个模块中，于是 “模块” 诞生了。

  程序还要复杂，模块 多了，我们将实现类似功能的模块放到一起，于是 “包” 就诞生了。

1. Python 程序由模块组成。一个模块对应 python 源文件，一般后缀名是：.py。
2. 模块由语句组成。运行 Python 程序时，按照模块中语句的顺序依次执行。
3. 语句是 Python 程序的构造单元，用于创建对象、变量赋值、调用函数、控制语句等。

标准库模块(standard library)

  与函数类似，模块也分为 标准库模块 和 用户自定义模块。

  Python 标准库提供了操作系统功能、网络通信、文本处理、文件处理、数学运算等基 本的功能。比如：random(随机数)、math(数学运算)、time(时间处理)、file(文件处理)、 os(和操作系统交互)、sys(和解释器交互)等。

  另外，Python 还提供了海量的第三方模块（即用户自定义模块），使用方式和标准库类似。功能覆盖了我们 能想象到的所有领域，比如：科学计算、WEB 开发、大数据、人工智能、图形系统等。

为什么需要模块化编程

  模块(module)对应于Python源代码文件(.py文件)。模块中可以定义变量、函数、类、普通语句。这样，我们可以将一个 Python程序分解成多个模块，便于后期的重复应用。
  模块化编程（Modular Programming）将一个任务分解成多个模块。每个模块就像一个积木一样，便于后期的反复使用、反复搭建。

  模块化编程有如下几个重要优势：

1. 便于将一个任务分解成多个模块，实现团队协同开发，完成大规模程序
2. 实现代码复用。一个模块实现后，可以被反复调用。
3. 可维护性增强。

模块化编程的流程

1. 设计 API（Application Programming Interface，应用程序编程接口），进行功能描述。
2. 编码实现 API 中描述的功能。
3. 在模块中编写测试代码，并消除全局代码。
4. 使用私有函数实现不被外部客户端调用的模块函数。

  每个模块都有一个名称，通过特殊变量 __name__ 可以获取模块的名称。在正常情况下，模块名字对应源文件名。
  仅有一个例外，就是当一个模块被作为程序入口时（主程序、交互式提示符下），它的__name__的值为 “__main__”。

# 设计计算薪水模块的API

'''
    用于计算公司员工的薪资
'''

company = 'kuiuz'

def yearSalary(monthSalary):
    '''根据传入的月薪的值，计算出年薪：monthsalary*12'''
    return monthSalary*12

def daySalary(monthSalary):
    '''根据传入的月薪值，计算出一天的薪资，一个月按22.5天计算（国家规定的工作日）'''
    return monthSalary/22.5

# 通过__doc__获得模块的文档字符串的内容
import Salary
print(Salary.__doc__)
print(Salary.daySalary.__doc__)

---

02. 模块的导入

import语句导入

• import 语句的 基本语法格式 如下：
   import 模块名 #导入一个模块
   import 模块 1，模块 2… #导入多个模块
   import 模块名 as 模块别名 #导入模块并使用新名字
• import 加载的模块分为 四个通用类别 ：
   ① 使用 python 编写的代码（.py 文件）；
   ② 已被编译为共享库或 DLL 的 C 或 C++扩展；
   ③ 包好一组模块的包
   ④ 使用 C 编写并链接到 python 解释器的内置模块；

from…import导入

  Python 中可以使用 from…import 导入模块中的成员。基本语法格式如下：

from 模块名 import 成员 1，成员 2，…

  如果希望导入一个模块中的所有成员，则可以采用如下方式：

from 模块名 import \*
【注】尽量避免“from 模块名 import * ”这种写法。\* 它表示导入模块中所有的不是以下划线(_)开头的名字都导入到当前位置。 但你不知道你导入什么名字，很有可能会覆盖掉你之前已经定义的名字，而且可读性极其的差。

import()动态导入

  import 语句本质上就是调用内置函数__import__()，我们可以通过它实现动态导入。给 __import__()动态传递不同的的参数值，就能导入不同的模块。
  注意：一般不建议我们自行使用__import__()导入，其行为在 python2 和 python3 中 有差异，会导致意外错误。如果需要动态导入可以使用 importlib 模块：importlib.import_module(模块名)

import 语句和 from…import 语句的区别

  import 导入的是 模块。from…import 导入的是 模块中的一个函数/一个类。
  如果进行类比的话，import 导入的是 “文件” ，我们要使用该“文件”下的内容，必须前面加“文件名称”。from…import 导入的是文件下的 “内容” ，我们直接使用这些“内容”即可，前面再也不需要加“文件名称”了。

模块的加载问题

  一个模块无论导入多少次，这个模块在整个解释器进程内有且仅有一个实例对象。

重新加载：
  有时候我们确实需要重新加载一个模块，这时候可以使用：importlib.reload() 方法。

---

03. 包（package）的使用

包(package)的概念和结构

  当一个项目中有很多个模块时，需要再进行组织。我们将功能类似的模块放到一起， 形成了“包”。本质上，“包”就是一个必须有 __init__.py 的文件夹。
  包下面可以包含 “模块(module)”，也可以再包含 “子包(subpackage)”。就像文件夹下面可以有文件，也可以有子文件夹一样。

导入包操作和本质

1. from package import item 这种语法中，item 可以是包、模块，也可以是函数、类、变量。
2. import item1.item2 这种语法中，item 必须是包或模块，不能是其他。导入包的本质其实是“导入了包的__init__.py”文件。也就是说，”import pack1”意味 着执行了包 pack1 下面的__init__.py 文件。 这样，可以在__init__.py 中批量导入我们需要 的模块，而不再需要一个个导入。

__init__.py 的三个核心作用：

1. 作为包的标识，不能删除。
2. 用来实现模糊导入
3. 导入包实质是执行__init__.py 文件，可以在__init__.py 文件中做这个包的初始化、以及需要统一执行代码、批量导入。

用*导入包

  Python 提供一个明确的包索引。 这个索引由 __init__.py 定义 __all__ 变量，该变量为一列表，如上例 a 包下的 __init__.py 中，可定义 __all__ = [“module_A”,“module_A2”]
  这意味着， from sound.effects import * 会从对应的包中导入以上两个子模块，即 * 代表__all__定义的内容。
  【注】尽管提供 import * 的方法，仍不建议在生产代码中使用这种写法。

包内引用

• from … import module_A   #…表示上级目录 ( 2个.）
• from . import module_A2   #.表示同级目录 (1个. )

sys.path 和模块搜索路径

  当我们导入某个模块文件时， Python 解释器一般按照如下路径寻找模块文件（按照顺序寻找，找 到即停不继续往下寻找）：

1. 内置模块
2. 当前目录
3. 程序的主目录
4. pythonpath 目录（如果已经设置了 pythonpath 环境变量）
5. 标准链接库目录
6. 第三方库目录（site-packages 目录）
7. .pth 文件的内容（如果存在的话）
8. sys.path.append()临时添加的目录

  当任何一个 python 程序启动时，就将上面这些搜索路径(除内置模块以外的路径)进行收集， 放到 sys 模块的 path 属性中（sys.path）。

使用 sys.path 查看和临时修改搜索路径：

sys.path.append(路径)

---

04. 模块的发布和安装

略