1. 模块化(module)程序设计理念
1.1模块和包概念进化史
量变质变、物以类聚
包类似文件夹 模块类似文件
- Python 程序由模块组成。一个模块对应 python 源文件,一般后缀名是:.py。
- 模块由语句组成。运行 Python 程序时,按照模块中语句的顺序依次执行。
- 语句是 Python 程序的构造单元,用于创建对象、变量赋值、调用函数、控制语句等。
1.2 标准库模块(standard library)
与函数类似,模块也分为标准库模块和用户自定义模块。 Python 标准库提供了操作系统功能、网络通信、文本处理、文件处理、数学运算等基 本的功能。
另外,Python 还提供了海量的第三方模块,使用方式和标准库类似。功能覆盖了我们 能想象到的所有领域,比如:科学计算、WEB 开发、大数据、人工智能、图形系统等。
1.3 为什么需要模块化编程
- 便于将一个任务分解成多个模块,实现团队协同开发,完成大规模程序
- 实现代码复用。
- 可维护性增强。
1.4模块化编程流程
模块化编程的一般流程:
- 设计 API,进行功能描述。
- 编码实现 API 中描述的功能。
- 在模块中编写测试代码,并消除全局代码。
- 使用私有函数实现不被外部客户端调用的模块函数。
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。方式如下:
- 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()
【注】
1 from package import item 这种语法中,item 可以是包、模块,也可以是函数、 类、变量。
2. import item1.item2 这种语法中,item 必须是包或模块,不能是其他。
导入包的本质其实是“导入了包的__init__.py”文件。也就是说,”import pack1”意味 着执行了包 pack1 下面的__init__.py 文件。 这样,可以在__init__.py 中批量导入我们需要 的模块,而不再需要一个个导入
init.py 的三个核心作用:
- 作为包的标识,不能删除。
- 用来实现模糊导入
- 导入包实质是执行__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 和模块搜索路径
它一般按照如下路径寻找模块文件(按照顺序寻找,找 到即停不继续往下寻找):
- 内置模块
- 当前目录
- 程序的主目录
- pythonpath 目录(如果已经设置了 pythonpath 环境变量)
- 标准链接库目录
- 第三方库目录(site-packages 目录)
- .pth 文件的内容(如果存在的话)
- 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
上传并远程发布->管理你的模块