【学习笔记】Python 基础知识 - Day11

模块

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

模块和包概念的进化史

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

模块化编程的流程

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

模块的 API 和功能描述要点

API 是用于描述模块中提供的函数和类的功能描述和使用方式描述。

# 导入 math 模块，并通过 help() 查看 math 模块的 API
import math
help(math)

设计计算薪水模块的API

"""
本模块用于计算公司员工的薪资
"""
company = "北京尚学堂"

def yearSalary(monthSalary):
	"""根据传入的月薪，计算出年薪"""
	pass
	
def daySalary(monthSalary):
	"""根据传入的月薪，计算出每天的薪资"""
	pass

我们可以通过__doc__可以获得模块的文档字符串的内容。

import salary

print(salary.__doc__)
print(salary.yearSalary.__doc__)

'''
运行结果：
本模块用于计算公司员工的薪资
根据传入的月薪，计算出年薪
'''

模块的创建和测试代码

每个模块都有一个名称，通过特殊变量__name__可以获取模块的名称。在正常情况下，模块名字对应源文件名。仅有一个例外，就是当一个模块被作为程序入口时（主
程序、交互式提示符下），它的__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))

模块的导入

import 语句导入

from…import 导入

尽量避免“from 模块名import *”这种写法。* 它表示导入模块中所有的不是以下划线(_)开头的名字都导入到当前位置。但你不知道你导入什么名字，很有可能会覆盖掉你之前已经定义的名字，而且可读性极其的差，一般生产环境中尽量避免使用。

import 语句和 from…import 语句的区别

import 导入的是模块。from…import 导入的是模块中的一个函数/一个类。

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

__import__() 动态导入

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

模块的加载问题

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

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

import test02  # 执行
import test02  # 不执行

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

包 package 的使用

包(package)的概念和结构

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

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

导入包操作和本质

1.from package import item 这种语法中，item 可以是包、模块，也可以是函数、类、变量。
2.import item1.item2 这种语法中，item 必须是包或模块，不能是其他。
3.导入包的本质其实是“导入了包的__init__.py”文件。也就是说，”import pack1”意味着执行了包 pack1 下面的__init__.py 文件。这样，可以在__init__.py 中批量导入我们需要的模块，而不再需要一个个导入。

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

用*导入包

包内引用

sys.path 和模块搜索路径

# 使用 sys.path 查看和临时修改搜索路径
import sys
sys.path.append("d:/")
print(sys.path)