模块(module)

目录 

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

1.1模块和包概念的进化史

1.2 标准库模块(standard library)

1.3 为什么需要模块化编程

1.4 模块化编程的流程

1.5 模块的API和功能描述要点

1.6 模块的创建和测试代码

1.7 模块文档字符串和API设计

 二：模块的导入

---

---

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

1.1模块和包概念的进化史

“量变引起质变”本质上理解， 随着数量的增加，管理方式会发生本质的变化；旧的管理方式完全不适合，必须采用新的管理方式。

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

1.2 标准库模块(standard library)

模块也分为标准库模块和用户自定义模块。

1.3 为什么需要模块化编程

模块对应于Python源代码（.py文件），可以将一个 Python程序分解成多个模块，便于后期的重复应用。

模块化编程将一个任务分解成多个模块。每个模块就像一个积木一样，便于后期的反复使用、反复搭建。

1.4 模块化编程的流程

模块化编程的一般流程：

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

1.5 模块的API和功能描述要点

API(应用程序编程接口)是用于描述模块中提供的函数和类的功能描述和使用方式描述。
模块化编程中，首先设计的就是模块的API（即要实现的功能描述），然后开始编 码实现API中描述的功能。最后，在其他模块中导入本模块进行调用。

查看模块的API：

• 通过help(模块名)查看模块的API。 一般使用时先导入模块 然后通过help函数查看

import math
help(math)

• 在python的api文档中查询。首先进入python的安装目录下的docs子目录：双击打开chm文档

【示例】设计计算薪水模块的API

"""
本模块用于计算公司的员工的薪资
"""
company='sshyes'

def yearSalary(monthSalary):
    """根据传入月薪，计算出年薪"""
    pass

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

如上模块只有功能描述和规范，需要编码人员按照要求实现编码。我们可以通过__doc__可以获得模块的文档字符串的内容。

import Salary

print(Salary.__doc__)
print(Salary.daySalary.__doc__)  #函数的说明

1.6 模块的创建和测试代码

每个模块都有一个名称，通过特殊变量__name__可以获取模块的名称。在正常情况下，模块名字对应源文件名。 

仅有一个例外，就是当一个模块被作为程序入口时（主程序、交互式提示符下），它的__name__的值为“__main__”。我们可以根据这个特点，将模块源代码文件中的测试代码进行独立的处理

【示例】通过__name==“__main__”独立处理模块的测试代码 

# -*- coding: UTF-8 -*-
"""
本模块用于计算公司的员工的薪资
"""
company = 'sshyes'
def yearSalary(monthSalary):
    """传入月薪，计算其年薪"""
    return monthSalary*12

def daySalary(monthSalary):
    """传入月薪，计算其日薪"""
    return monthSalary/22.5

if __name__ == "__main__":
    print(yearSalary(12000))
    print(daySalary(12000))

1.7 模块文档字符串和API设计

可以在模块的第一行增加一个文档字符串，用于描述模块的相关功能。然后，通过 __doc__可以获得文档字符串的内容

import Salary

print(Salary.__doc__)
print(Salary.daySalary.__doc__)  #函数的说明

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

 二：模块的导入

 

本文地址：https://blog.csdn.net/weixin_44359595/article/details/107306622