Python学习第十天——模块

一、模块化(module)程序设计理念

1.基本内容

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

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

优势：

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

流程：

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

2.模块的API 和功能描述要点

        API(Application Programming Interface 应用程序编程接口)是用于描述模块中提供的函数和类的功能描述和使用方式描述。
        模块化编程中，首先设计的就是模块的API（即要实现的功能描述），然后开始编码实现API 中描述的功能。最后，在其他模块中导入本模块进行调用。
        我们可以通过help(模块名)查看模块的API。一般使用时先导入模块然后通过help函数查看。例如：
import math
help(math)
        也可以在python 的api 文档中查询。首先进入python 的安装目录下的docs 子目录，双击打开chm 文档，即可通过索引输入“math”查询到对应的API 内容。

        模块创建初首先设计API，有清晰的结构，然后需要编码人员按照要求实现编码。

"""
用于计算公司员工的薪资
"""
company = "爱学习"


def yearsalary(monthsalary):
    """根据传入的月薪的值，计算出年薪：monthsalary*12"""
    pass


def daysalary(monthsalary):
    """根据传入的月薪值，计算出一天的薪资"""
    pass

        设计好API后，可以通过__doc__获得模块的文档字符串的内容。

import mod_01
print(mod_01.__doc__)
print(mod_01.daysalary.__doc__)
print(mod_01.__name__)

3.模块的创建和测试代码

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

        可以通过__name__==“__main__”独立处理模块的测试代码：

"""
用于计算公司员工的薪资
"""
company = "爱学习"


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


def daysalary(monthsalary):
    """根据传入的月薪值，计算出一天的薪资"""
    return monthsalary / 22.5  # 国家规定每个月的平均工作日是22.5


if __name__ == "__main__":  # 测试代码
    print(yearsalary(3000))
    print(daysalary(3000))

二、模块的导入

1.import 语句导入

import 语句的基本语法格式如下：
        import 模块名#导入一个模块
        import 模块1，模块2… #导入多个模块
        import 模块名as 模块别名#导入模块并使用新名字

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

        我们一般通过import 语句实现模块的导入和使用，import 本质上是使用了内置函数__import__()。
        当我们通过import 导入一个模块时，python 解释器进行执行，最终会生成一个对象，这个对象就代表了被加载的模块。

2.from…import 导入

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

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

        例如，使用from…import 导入模块指定的成员：

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

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

3.__import__()动态导入

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

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

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

import importlib
a = importlib.import_module("math")
print(a.pi)

4.模块的加载问题

        当导入一个模块时， 模块中的代码都会被执行。不过，如果再次导入这个模块，则不会再次执行。
        Python 的设计者为什么这么设计？因为，导入模块更多的时候需要的是定义模块中的变量、函数、对象等。这些并不需要反复定义和执行。“ 只导入一次import-only-once”就成了一种优化。
        一个模块无论导入多少次，这个模块在整个解释器进程内有且仅有一个实例对象。

        重新加载：

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

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

三、包package 的使用

1.包(package)的概念和结构

        当一个项目中有很多个模块时，需要再进行组织。我们将功能类似的模块放到一起，形成了“包”。本质上，“包”就是一个必须有__init__.py 的文件夹。
        包下面可以包含“模块(module)”，也可以再包含“子包(subpackage)”。就像文件夹下面可以有文件，也可以有子文件夹一样。
        在pycharm 开发环境中创建包，非常简单。在要创建包的地方单击右键：New-->Pythonpackage 即可。pycharm 会自动帮助我们生成带有__init__.py 文件的包。

        如图，a为一个包，其中有__init__命名的.py文件和其他.py文件，还有一个名为aa的子包，aa内同样也有__init__的.py文件和其他的.py文件，完全就是有__init__.py文件的文件夹。

2.导入包操作和本质

        如果我们需要导入module_AA.py。方式如下：
①import a.aa.module_AA
        在使用时，必须加完整名称来引用，比如：a.aa.module_AA.fun_AA()
②from a.aa import module_AA
        在使用时，直接可以使用模块名。比如：module_AA.fun_AA()
③from a.aa.module_AA import fun_AA 直接导入函数
        在使用时，直接可以使用函数名。比如：fun_AA()

        注：
        A.from package import item 这种语法中，item 可以是包、模块，也可以是函数、类、变量。
        B.import item1.item2 这种语法中，item 必须是包或模块，不能是其他。

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

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

3.用*导入包

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

4.包内引用

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

5.sys.path 和模块搜索路径

        当我们导入某个模块文件时， Python 解释器去哪里找这个文件呢？只有找到这个文件才能读取、装载运行该模块文件。它一般按照如下路径寻找模块文件（按照顺序寻找，找到即停不继续往下寻找）：
        (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)

 如果.pth文件无法创建，可以创建.pth.即可。

        Ⅰ.pythonpath 环境变量的设置
        windows 系统中通过在高级系统属性中点击环境变量添加路径。变量名为pythonpath，变量值为路径，不同路径用分号隔开。

        Ⅱ.pth 文件的写法
        我们可以在site-packages 目录下添加.pth 文件。并在文件中增加内容。
        ①需确保g:\a,g:\b,g:\c 对应的目录真实存在。
        ②在windows 系统中建立.pth 文件，由于没有文件名不能直接建立。需要输入：“.pth.”才能正常建立.pth 文件。

四、模块发布和安装

1.模块的本地发布

        当我们完成了某个模块开发后，可以将他对外发布，其他开发者也可以以“第三方扩展库”的方式使用我们的模块。我们按照如下步骤即可实现模块的发布：
        ①为模块文件创建如下结构的文件夹（一般，文件夹的名字和模块的名字一样）：

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

from distutils.core import setup

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

        ③构建一个发布文件。通过终端，cd 到模块文件夹c 下面，再键入命令：
                                                                python setup.py sdist
        执行完毕后，目录结构变为：

2.本地安装模块

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

3.上传模块到PyPI

        将自己开发好的模块上传到PyPI 网站上，将成为公开的资源，可以让全球用户自由使用。

        ①注册PyPI 网站：http://pypi.python.org
        ②创建用户信息文件.pypirc
        方式1： 使用命令(适用Linux)
输入并执行后python setup.py register ，然后输入用户名和密码，即可。
        方式2：使用文件（适用windows,Linux）
在用户的家目录里创建一个文件名为.pypirc, 内容为：

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

        注：
        Linux 的家目录： ~/.pypirc
        Windows 的家目录是： c:/user/用户名
        在windows 下直接创建不包含文件名的文件会失败，因此创建时文件名为“.pypirc.”，前后都有两个点即可。
        ③上传并远程发布
        进入setup.py 文件所在目录，使用命令“python setup.py sdist upload”，即可以将模块代码上传并发布
        ④管理你的模块
        我们登录pypi 官网，如果你的模块已经上传成功，那么当你登录PyPI 网站后应该能在右侧导航栏看到管理入口。点击包名进去后你可以对你的模块进行管理，当然你也可以从这里删除这个模块。

4.让别人使用你的模块

        模块发布完成后，其他人只需要使用pip 就可以安装你的模块文件。比如：
                                                        pip install package-name

        如果你更新了模块，别人可以可以通过--update 参数来更新：
                                                        pip install package-name update