练习1:模块设置的初体验
1. __doc __打印出模块或其函数的功能描述
设计出的模块:命名为mymodule01
""" 本模块用于计算公司员工的薪资 """ company = "Clichong" def yearsalary(monthsalary): """根据传入的月薪,计算出年薪""" return monthsalary*12 def daysalary(monthsalary): """根据出入的月薪,计算出日薪""" return monthsalary/12
测试代码:
import mymodule01 import math #测试自定义的模块 print(mymodule01.__doc__) print(mymodule01.yearsalary.__doc__) print(mymodule01.daysalary.__doc__) #测试第三方库模块 print(math.cos.__doc__) print(math.acos.__doc__)
结果:
2. __name __可以获取模块的名称
""" 本模块用于计算公司员工的薪资 """ company = "Clichong" def yearsalary(monthsalary): """根据传入的月薪,计算出年薪""" return monthsalary*12 def daysalary(monthsalary): """根据出入的月薪,计算出日薪""" return monthsalary/12 print(yearsalary.__name__) print(__name__) #可以自定义测试函数 if __name__ == "__main__": print(yearsalary(10000)) print(daysalary(10000))
另外调用模块:
import mymodule01 import math print(math.__name__) print(mymodule01.__name__) print(mymodule01.daysalary.__name__)
再调用模块的时候,会全部执行代码,包括两条打印语句。而__name __在测试文件里面的名称就不是 __ main__了,而是变成了模块的名称mymodule01
3. import导入问题与importlib模块
import 语句的基本语法格式如下:
import 模块名 #导入一个模块
import 模块 1,模块 2… #导入多个模块
import 模块名 as 模块别名 #导入模块并使用新名字
from 模块名 import 成员 1,成员 2,…
#自定义导入模块名 from mymodule01 import daysalary as dd from math import cos #动态导入测试 import importlib print(cos.__name__) print(my.__name__) print(dd.__name__) s = "math" Clichong = importlib.import_module(s) print(Clichong.pi)
一般来说,模块只能被导入一次不能多次导入,而有时候我们确实需要重新加载一个模块,这时候可以使用:importlib.reload()
练习2:包package的使用
1.包的导入
- 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()
ps:
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 文件中做这个包的初始化、以及
需要统一执行代码、批量导入。
2.包内引用
from … import module_A #…表示上级目录 .表示同级目录
from . import module_A2 #.表示同级目录
练习3:sys模块搜索路径
当我们导入某个模块文件时, Python 解释器去哪里找这个文件呢?只有找到这个文件才能读取、装载运行该模块文件。它一般按照如下路径寻找模块文件(按照顺序寻找,找到即停不继续往下寻找):
- 内置模块
- 当前目录
- 程序的主目录
- pythonpath 目录(如果已经设置了 pythonpath 环境变量) #永久有效
- 标准链接库目录
- 第三方库目录(site-packages 目录)
- .pth 文件的内容(如果存在的话) #永久有效
- sys.path.append()临时添加的目录 #只对当前程序有效
查看当前搜索路径:
import sys #sys.path.append( "d:/") #动态添加环境变量 print(sys.path)
结果如下:
['E:\\PyCharm\\workspace\\myImport', 'E:\\PyCharm\\workspace\\myImport', 'E:\\PyCharm\\PyCharm 2019.3.3\\plugins\\python\\helpers\\pycharm_display', 'E:\\PyCharm\\workspace\\myImport\\venv\\Scripts\\python37.zip', 'E:\\python\\python3.7\\DLLs', 'E:\\python\\python3.7\\lib', 'E:\\python\\python3.7', 'E:\\PyCharm\\workspace\\myImport\\venv', 'E:\\PyCharm\\workspace\\myImport\\venv\\lib\\site-packages', 'E:\\PyCharm\\workspace\\myImport\\venv\\lib\\site-packages\\setuptools-40.8.0-py3.7.egg', 'E:\\PyCharm\\workspace\\myImport\\venv\\lib\\site-packages\\pip-19.0.3-py3.7.egg', 'E:\\PyCharm\\PyCharm 2019.3.3\\plugins\\python\\helpers\\pycharm_matplotlib_backend']
1.pythonpath 环境变量的设置
可以看见已建好
2.·.pth 文件环境变量的设置
E:\python\python3.7\Lib\site-packages目录下添加.pth 文件。并在文件中增加内容。
练习4:模块本地的发布安装操作
1.模块本地发布
- 为模块文件创建如下结构的文件夹(一般,文件夹的名字和模块的名字一样)
- 在文件夹中创建一个名为『setup.py』的文件,内容如下:
from distutils.core import setup setup( name='mypackage', # 对外我们模块的名字 version='1.1.1', # 版本号 description='这是第一个描述,用于测试本地包的发布', #描述 author='Clichong', # 作者 author_email='1234567890@qq.com', py_modules=['mypackage.module01','mypackage.module02'] # 要发布的模块,还有一个不发布 )
- 构建一个发布文件。通过终端,cd 到模块文件夹 c 下面,再键入命令:
命令为:
命令为:
python setup.py sdist
执行完毕后,目录结构变为:
2.模块本地安装
- 将发布安装到你的本地计算机上。仍在 cmd 命令行模式下操作,进 setup.py 所在目录,键入命令
python setup.py install
2. 安装成功后,我们进入 python 目录/Lib/site-packages 目录(第三方模块都安装的这里,python 解释器执行时也会搜索这个路径)
使用测试:
成功!
练习5:上传模块到 PyPI
参考链接:官方文档
- 注册 PyPI 网站:http://pypi.python.org
- 创建用户信息文件 .pypirc
在用户的家目录里创建一个文件名为.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 网站后应该能在右侧导航栏看到管理入口。点击包名进去后你可以对你的模块进行管理,当然你也可以从这里删除这个模块。