第十一节：模块/包

模块

模块化编程理念

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

与函数类似，模块也分为标准库模块和用户自定义模块
Python标准库提供了操作系统功能、网络通信、文本处理、文件处理、数学运算等基本的功能。另外，Python还提供了海量的第三方模块，使用方式和标准库类似。功能覆盖了我们能想象到的所有领域，比如：科学计算、WEB开发、大数据、人工智能、图形系统等。

模块化编程流程

模块(module)对应于Python源代码文件(.py文件)。
模块中可以定义变量、函数、类、普通语句。这样，我们可以将一个Python程序分解成多个模块，便于后期的重复应用。
模块化编程（ModularProgramming将一个任务分解成多个模块。每个模块就像一个积木一样，便于后期的反复使用、反复搭建.
模块化编程的一般流程：
1.设计API，进行功能描述。
2.编码实现API中描述的功能。
3.在模块中编写测试代码，并消除全局代码。
4.使用私有函数实现不被外部客户端调用的模块函数。

API(ApplicationProgrammingInterface应用程序编程接口)是用于描述模块中提供的函数和类的功能描述和使用方式描述。
模块化编程中，首先设计的就是模块的API（即要实现的功能描述），然后开始编码实现API中描述的功能。最后，在其他模块中导入本模块进行调用。
我们可以通过help(模块名)查看模块的API。一般使用时先导入模块然后通过help函数查看
【示例】导入math模块，并通过help()查看math模块的API：

import math
help(math)

也可以在python的api文档中查询。首先进入python的安装目录下的docs子目录
双击打开chm文档，即可通过索引输入“math”查询到对应的API内容

模块的创建和测试代码

每个模块都有一个名称，通过特殊变量__name__可以获取模块的名称。在正常情况下，模块名字对应源文件名。
仅有一个例外，就是当一个模块被作为程序入口时（主程序、交互式提示符下），它的__name__的值为“main”。我们可以根据这个特点，将模块源代码文件中的测试代码进行独立的处理。
我们可以在模块的第一行增加一个文档字符串，用于描述模块的相关功能。然后，通过__doc__可以获得文档字符串的内容。

import Mysalary
print(MySalary._doc_)

模块导入_import和from_import

模块化设计的好处之一就是“代码复用性高”。写好的模块可以被反复调用，重复使用。模块的导入就是“在本模块中使用其他模块”

import

mport语句的基本语法格式如下：
import模块名 #导入一个模块
import模块1，模块2… #导入多个模块
import模块名as模块别名 #导入模块并使用新名字
import加载的模块分为四个通用类别：
a.使用python编写的代码（.py文件）；
b.已被编译为共享库或DLL的C或C++扩展；
c.包好一组模块的包
d.使用C编写并链接到python解释器的内置模块；
我们一般通过import语句实现模块的导入和使用，import本质上是使用了内置函数__import__()。
当我们通过import导入一个模块时，python解释器进行执行，最终会生成一个对象，这个对象就代表了被加载的模块。

from…import

Python中可以使用from…import导入模块中的成员。
基本语法格式如下：
from模块名import成员1，成员2，…
如果希望导入一个模块中的所有成员，则可以采用如下方式：
from模块名import*

import和from…import的区别

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

import()动态导入

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

s='math'
m=__import__(s)
print(m.pi)

import加载底层原理

当导入一个模块时，模块中的代码都会被执行。不过，如果再次导入这个模块，则不会再次执行.
一个模块无论导入多少次，这个模块在整个解释器进程内有且仅有一个实例对象。

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

包

概念

当一个项目中有很多个模块时，需要再进行组织。我们将功能类似的模块放到一起，形成了“包”。本质上，“包”就是一个必须有__init__.py的文件夹。

包下面可以包含“模块(module)”，也可以再包含“子包(subpackage)”。就像文件夹下面可以有文件，也可以有子文件夹一样

包的创建和导入

在pycharm开发环境中创建包，非常简单。在要创建包的地方单击右键：New–>Pythonpackage即可。pycharm会自动帮助我们生成带有__init__.py文件的包。

包的本质

上一节中的包结构，我们需要导入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文件_批量导入_包内引用

导入包的本质其实是“导入了包的__init__.py”文件。也就是说，”import pack1”意味着执行了包pack1下面的__init__.py文件。这样，可以在__init__.py中批量导入我们需要的模块，而不再需要一个个导入。

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

用*导入包

import 这样的语句理论上是希望文件系统找出包中所有的子模块，然后导入它们。这可能会花长时间等。Python解决方案是提供一个明确的包索引。
这个索引由__init__.py定义__all__变量，该变量为一列表，如上例a包下的__init__.py中，可定义__all__=[“module_A”,“module_A2”]
这意味着，from sound.effects import会从对应的包中导入以上两个子模块；
【注】尽管提供import*的方法，仍不建议在生产代码中使用这种写法。

包内引用

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

sys.path和模块搜索路径详解

当我们导入某个模块文件时，Python解释器去哪里找这个文件呢？
只有找到这个文件才能读取、装载运行该模块文件。它一般按照如下路径寻找模块文件（按照顺序寻找，找到即停不继续往下寻找）：
1.内置模块
2.当前目录
3.程序的主目录
4.pythonpath目录（如果已经设置了pythonpath环境变量）
5.标准链接库目录
6.第三方库目录（site-packages目录）
7…pth文件的内容（如果存在的话）
8.sys.path.append()临时添加的目录
当任何一个python程序启动时，就将上面这些搜索路径(除内置模块以外的路径)进行收集，放到sys模块的path属性中（sys.path）。

模块的本地发布_模块的安装

模块的本地发布

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下面，再键入命令：
pythonsetup.pysdist
执行完毕后，目录结构变为：

模块的本地上传

将发布安装到你的本地计算机上。仍在cmd命令行模式下操作，进setup.py所在目录，键入命令：
python setup.py install
安装成功后，我们进入python目录/Lib/site-packages目录（第三方模块都安装的这里,python解释器执行时也会搜索这个路径）：

安装成功后，直接使用import导入即可。

PyPI官网_远程上传和管理模块_PIP方式安装模块

将自己开发好的模块上传到PyPI网站上，将成为公开的资源，可以让全球用户自由使用。按照如下步骤做，很容易就实现上传模块操作。
注册PyPI网站
注册PyPI网站：http://pypi.python.org
创建用户信息文件
·方式1：使用命令(适用Linux)
输入并执行后pythonsetup.pyregister，然后输入用户名和密码，即可。
·方式2：使用文件（适用windows,Linux）
在用户的家目录里创建一个文件名为.pypirc,内容为：

[distutils]
index-servers=pypi
[pypi]
repository=https://upload.pypi.org/legacy/
username=账户名
password=你自己的密码

【注】Linux的家目录：~/.pypircWindows的家目录是：c:/user/用户名在windows下直接创建不包含文件名的文件会失败，因此创建时文件名为“.pypirc.”，前后都有两个点即可。

上传并远程发布
入setup.py文件所在目录，使用命令“pythonsetup.pysdistupload”，即可以将模块代码上传并发布：

管理你的模块
我们登录pypi官网，可以看到：
如果你的模块已经上传成功，那么当你登录PyPI网站后应该能在右侧导航栏看到管理入口。

点击包名进去后你可以对你的模块进行管理，当然你也可以从这里删除这个模块。

让别人使用你的模块

模块发布完成后，其他人只需要使用pip就可以安装你的模块文件.

如果你更新了模块，别人可以可以通过–update参数来更新：