模块
1模块化程序设计理念
1.1模块和包概念的进化史
1.Python程序由模块组成。一个模块对应python源文件,一般后缀名是:.py。
2.模块由语句组成。运行Python程序时,按照模块中语句的顺序依次执行。
3.语句是Python程序的构造单元,用于创建对象、变量赋值、调用函数、控制语句等。
1.2标准库模块
与函数类似,模块也分为标准库模块和用户自定义模块。
Python标准库提供了操作系统功能、网络通信、文本处理、文件处理、数学运算等基本的功能。比如:random(随机数)、math(数学运算)、time(时间处理)、file(文件处理)、os(和操作系统交互)、sys(和解释器交互)等。
另外,Python还提供了海量的第三方模块
1.3为什么需要模块化编程
模块化编程有如下几个重要优势:
1.便于将一个任务分解成多个模块,实现团队协同开发,完成大规模程序
2.实现代码复用。一个模块实现后,可以被反复调用。
3.可维护性增强。
1.4模块化编程的流程
模块化编程的一般流程:
1.设计API,进行功能描述。
2.编码实现API中描述的功能。
3.在模块中编写测试代码,并消除全局代码。
4.使用私有函数实现不被外部客户端调用的模块函数。
1.5模块的API和功能描述要点
API(ApplicationProgrammingInterface应用程序编程接口)是用于描述模
块中提供的函数和类的功能描述和使用方式描述。
【示例】设计计算薪水模块的API
"""
本模块用于计算公司员工的薪资
"""
company="北京尚学堂"
def yearSalary(monthSalary):
"""根据传入的月薪,计算出年薪"""
pass
def daySalary(monthSalary):
"""根据传入的月薪,计算出每天的薪资"""
pass
通过**doc可以获得模块的文档字符串的内容**。
test.py的源代码:
import salary
print(salary.__doc__)
print(salary.yearSalary.__doc__)
运行结果:
本模块用于计算公司员工的薪资
根据传入的月薪,计算出年薪
1.6模块的创建和测试代码
每个模块都有一个名称,通过特殊变量**name可以获取模块的名称。**在正常情况下,模块名字对应源文件名。仅有一个例外,就是当一个模块被作为程序入口时(主程序、交互式提示符下),它的__name__的值为“main”。我们可以根据这个特点,将模块源代码文件中的测试代码进行独立的处理。例如:
import math
math.name #输出’math’
【示例】通过__name==“main”独立处理模块的测试代码
"""
本模块用于计算公司员工的薪资
"""
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))
2.模块的导入
2.1import语句导入
import 语句的基本语法格式如下:
import 模块名 #导入一个模块
import 模块1,模块2… #导入多个模块
import 模块名as模块别名 #导入模块并使用新名字
import加载的模块分为四个通用类别:
a.使用python编写的代码(.py文件);
b.已被编译为共享库或DLL的C或C++扩展;
c.包好一组模块的包
d.使用C编写并链接到python解释器的内置模块;
2.2from…import导入
Python中可以使用 from…import 导入模块中的成员。基本语法格式如下:
from 模块名 import 成员1,成员2,…
2.3import语句和from…import语句的区别
import导入的是模块。from…import导入的是模块中的一个函数/一个类。
import导入的是“文件
from…import导入的是文件下的“内容”
2.4__import__()动态导入
如果需要动态导入可以使用 importlib模块。
import importlib
a = importlib.import_module("math")
print(a.pi)
2.5模块的加载问题
一个模块无论导入多少次,这个模块在整个解释器进程内有且仅有一个实例对象。
重新加载
有时候我们确实需要重新加载一个模块,这时候可以使用:importlib.reload() 方法:
3.包package的使用
3.1包(package)的概念和结构
当一个项目中有很多个模块时,需要再进行组织。我们将功能类似的模块放到一起,形成了“包”。本质上,“包”就是一个必须有**init.py**的文件夹。
包下面可以包含“模块(module)”,也可以再包含“子包 (subpackage)”。
每个包里面都有__init__.py文件。
3.2pycharm中创建包
在要创建包的地方单击右键: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()
导入包的本质其实是“导入了包的__init__.py”文件。可以在__init__.py中批量导入我们需要的模块,而不再需要一个个导入。
init_.py的三个核心作用:
1.作为包的标识,不能删除。
2.用来实现模糊导入
3.导入包实质是执行__init__.py文件,可以在__init__.py文件中做这个包的初始化、以及需要统一执行代码、批量导入。
包的本质还是模块”
3.5包内引用
如果是子包内的引用,可以按相对位置引入子模块以aa包下的module_AA中导入a包下内容为例:
from …import module_A #…表示上级目录.表示同级目录
from .import module_A2 #.表示同级目录
3.6 sys.path和模块搜索路径
当我们导入某个模块文件时,Python解释器去哪里找这个文件呢?只有找到这个文件才能读取、装载运行该模块文件。它一般按照如下路径寻找模块文件(按照顺序寻找,找到即停不继续往下寻找):
1.内置模块
2.当前目录
3.程序的主目录
4.pythonpath目录(如果已经设置了pythonpath环境变量)
5.标准链接库目录
6.第三方库目录(site-packages目录)
7…pth文件的内容(如果存在的话)
8.sys.path.append()临时添加的目录
在项目的b目录下建立测试模块:
4.模块发布和安装
4.1模块的本地发布
1.为模块文件创建如下结构的文件夹(一般,文件夹的名字和模块的名字一样):
2.在文件夹中创建一个名为『setup.py』的文件,内容如下:
from distutils.core import setup
3.构建一个发布文件。通过终端,cd到模块文件夹c下面,再键入命令:
python setup.pysdist
执行完毕后,目录结构变为:
4.2本地安装模块
将发布安装到你的本地计算机上。仍在cmd命令行模式下操作,进setup.py所在目录,键入命令:
python setup.py install
安装成功后,我们进入python目录/Lib/site-packages目录(第三方模块都安装的这里,python解释器执行时也会搜索这个路径):
检查是否安装成功?
安装成功后,直接使用import导入即可。
4.3上传模块到PyPI
· 注册PyPI网站
注册PyPI网站:http://pypi.python.org
· 创建用户信息文件.pypirc
· 上传并远程发布
进入setup.py文件所在目录,使用命令“python setup.py sdist upload”,即可以将模块代码上传并发布:
· 管理你的模块
我们登录pypi官网,可以看到:
如果你的模块已经上传成功,那么当你登录PyPI网站后应该能在右侧导航栏看到管理入口。
4.4让别人使用你的模块
模块发布完成后,其他人只需要使用pip就可以安装你的模块文件。比如:
pip install package-name