模块（module）

1. 模块化(module)程序设计理念

1.1模块和包概念进化史

量变质变、物以类聚
包类似文件夹 模块类似文件

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

1.2 标准库模块(standard library)

与函数类似，模块也分为标准库模块和用户自定义模块。 Python 标准库提供了操作系统功能、网络通信、文本处理、文件处理、数学运算等基 本的功能。

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

1.3 为什么需要模块化编程

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

1.4模块化编程流程

模块化编程的一般流程：

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

1.5 模块的 API 和功能描述要点

API(Application Programming Interface 应用程序编程接口)是用于描述模块中提供的函数和类的功能描述和使用方式描述

 """
 本模块用于计算公司员工的薪资
 """
 company = "北京尚学堂" 
 def yearSalary(monthSalary):
    """根据传入的月薪，计算出年薪"""
    pass 
 def daySalary(monthSalary): 
   """根据传入的月薪，计算出每天的薪资"""
    pass

我们可以通过__doc__可以获得模块的文档字符串的内容。

import salary 

print(salary.__doc__) 
print(salary.yearSalary.__doc__)

1.6 模块的创建和测试代码

每个模块都有一个名称，通过特殊变量__name__可以获取模块的名称。在正常情况下，模块名字对应源文件名。 仅有一个例外，就是当一个模块被作为程序入口时（主程序、交互式提示符下），它的__name__的值为“main”。我们可以根据这个特点，将模块源代码文件中的测试代码进行独立的处理。
例如：
import math
math.name #输出’math

"""
本模块用于计算公司员工的薪资 
"""
company = "北京尚学堂" 
def yearSalary(monthSalary): 
	"""根据传入的月薪，计算出年薪""" 
	return monthSalary*12 
def daySalary(monthSalary): 
	"""根据传入的月薪，计算出每天的薪资""" 
	return monthSalary/22.5 #国家规定每个月的平均工作日是 22.5 
if __name__ =="__main__": #测试代码 		
	print(yearSalary(3000)) 
	print(daySalary(3000))

1.7 模块文档字符串和 API 设计

我们可以在模块的第一行增加一个文档字符串，用于描述模块的相关功能。然后，通过 __doc__可以获得文档字符串的内容。

import MySalary 
print(MySalary.__doc__) 
print(MySalary.yearSalary.__doc__)

2. 模块的导入

2.1 import 语句导入

import 加载的模块分为四个通用类别：
a.使用 python 编写的代码（.py 文件）；
b.已被编译为共享库或 DLL 的 C 或 C++扩展；
c.包好一组模块的包
d.使用 C 编写并链接到 python 解释器的内置模块；

我们一般通过 import 语句实现模块的导入和使用，import 本质上是使用了内置函数 import()。

我们通过 import 导入多个模块，本质上也是生成多个 module 类的对象而已

【取别名】

import math as m 
#import math #m = math 
print(m.sqrt(4)) #开方运算

2.2 from…import 导入

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

from math import pi,sin 
print(sin(pi/2)) #输出 1.0

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

import 是模块
from … import 是类或函数

2.4 import()动态导入

import 语句本质上就是调用内置函数__import__()，我们可以通过它实现动态导入。给 import()动态传递不同的的参数值，就能导入不同的模块。

s = "math" 
m = __import__(s) #导入后生成的模块对象的引用给变量 m 
print(m.pi)

注意：一般不建议我们自行使用__import__()导入，其行为在 python2 和 python3 中 有差异，会导致意外错误。如果需要动态导入可以使用 importlib 模块

2.5 模块的加载问题

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

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

import test02 
import test02 
print("####") 
import importlib 
importlib.reload(test02)

3. 包 package 的使用

3.1 包(package)的概念和结构

包”就是一个必须有__init__.py 的文件夹
也可以再包含“子包(subpackage)”

3.2 pycharm 中创建包

New–>Python package 即可。pycharm 会自动帮助我们生成带有__init__.py 文件的包

3.3 导入包操作和本质

上一节中的包结构，我们需要导入 module_AA.py。方式如下：

1. import a.aa.module_AA 在使用时，必须加完整名称来引用，比如：a.aa.module_AA.fun_AA()
2. from a.aa import module_AA 在使用时，直接可以使用模块名。 比如：module_AA.fun_AA()
3. from a.aa.module_AA import fun_AA 直接导入函数 在使用时，直接可以使用函数名。 比如：fun_AA()

【注】
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 文件中做这个包的初始化、以及 需要统一执行代码、批量导入。

包的本质还是模块

3.4 用*导入包

import * 这样的语句理论上是希望文件系统找出包中所有的子模块，然后导入它们。 这可能会花长时间等。Python 解决方案是提供一个明确的包索引。 这个索引由 init.py 定义 all 变量，该变量为一列表，如上例 a 包下的 init.py 中，可定义 all = [“module_A”,“module_A2”] 这意味着， from sound.effects import * 会从对应的包中导入以上两个子模块；

3.5 包内引用

如果是子包内的引用，可以按相对位置引入子模块 以 aa 包下的 module_AA 中导入 a 包下内容为例：
from … import module_A #…表示上级目录 .表示同级目录
from . import module_A2 #.表示同级目录

3.6 sys.path 和模块搜索路径

它一般按照如下路径寻找模块文件（按照顺序寻找，找 到即停不继续往下寻找）：

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

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

import sys 
sys.path.append("d:/") 
print(sys.path)

4. 模块发布和安装

4.1 模块的本地发布

1.为模块文件创建如下结构的文件夹（一般，文件夹的名字和模块的名字一样）：

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

from distutils.core import setup 

setup( 
	name='baizhanMath2', # 对外我们模块的名字 
	version='1.0', # 版本号 
	description='这是第一个对外发布的模块，测试哦', #描述 
	author='gaoqi', # 作者 
	author_email='gaoqi110@163.com', 
	py_modules['baizhanMath2.demo1','baizhanMath2.demo2'] # 要发布的模块 
)

3.构建一个发布文件。通过终端，cd 到模块文件夹 c 下面，再键入命令： python setup.py sdist

4.2 本地安装模块

仍在 cmd 命令行模式下操作，进 setup.py 所在目 录，键入命令：
python setup.py install

4.3 上传模块到 PyPI

·注册 PyPI 网站：http://pypi.python.org
【注意】会发送一封邮件到你的邮箱。请点击验证后继续下面的步骤。
·创建用户信息文件.pypirc
上传并远程发布->管理你的模块

4.4 让别人使用你的模块