Python入门【模块化(module)程序设计理念、模块和包概念的进化史、标准库模块(standard library) 、模块化编程的流程、模块的创建和测试代码 、模块文档字符串】(二十一)

👏作者简介：大家好，我是爱敲代码的小王，CSDN博客博主,Python小白
📕系列专栏：python入门到实战、Python爬虫开发、Python办公自动化、Python数据分析、Python前后端开发
📧如果文章知识点有错误的地方，请指正！和大家一起学习，一起进步👀
🔥如果感觉博主的文章还不错的话，请👍三连支持👍一下博主哦
🍂博主正在努力完成2023计划中：以梦为马，扬帆起航，2023追梦人

🔥🔥🔥 python入门到实战专栏：从入门到实战 

🔥🔥🔥 Python爬虫开发专栏：从入门到实战

🔥🔥🔥 Python办公自动化专栏：从入门到实战

🔥🔥🔥 Python数据分析专栏：从入门到实战

🔥🔥🔥 Python前后端开发专栏：从入门到实战 

目录

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

模块和包概念的进化史

标准库模块(standard library) 

模块化编程的流程

模块的创建和测试代码 

模块文档字符串和API设计

模块的导入

---

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

模块和包概念的进化史

1、 Python程序由模块组成。一个模块对应python源文件，一般后缀名是： .py

2 、模块由语句组成。运行Python程序时，按照模块中语句的顺序依次执行

3、 语句是Python程序的构造单元，用于创建对象、变量赋值、调用函数、控制语句等 

 “量变引起质变”是哲学中一个重要的理论。量变为什么会引起质 变呢？本质上理解，随着数量的增加，管理方式会发生本质的 变化；旧的管理方式完全不适合，必须采用新的管理方式。 程序越来越复杂，语句多了，怎么管理？很自然的，我们会将实现同一个功能的语句封装到 函数中，统一管理和调用，于是函数诞生了。

1、 程序更加复杂，函数和变量多了，怎么管理？同样的思路，“物以类聚”，我们将同一类型对 象的“数据和行为”，也就是“变量和函数”，放到一起统一管理和调用，于是“类和对象”诞生 了。

2、 程序继续复杂，函数和类更加多了，怎么办？好，我们将实现类似功能的函数和类统统放到 一个模块中，于是“模块”诞生了。

3、 程序还要复杂，模块多了，怎么办？ 于是，我们将实现类似功能的模块放到一起，于是“包” 就诞生了。

❤️大家可以清晰的看到这发展的流程，核心的哲学思想就是“量 变引起质变”、“物以类聚”。同样的思路，在企业管理、人的管 理中思路完全一致。大家可以举一反三。

标准库模块(standard library) 

与函数类似，模块也分为标准库模块和用户自定义模块。 Python标准库提供了操作系统功能、网络通信、文本处理、文件处理、数学运算等基本的功能。比如：random(随机数)、math(数学 运算)、time(时间处理)、file(文件处理)、os(和操作系统交互)、 sys(和解释器交互)等。

另外，Python还提供了海量的第三方模块，使用方式和标准库类似。功能覆盖了我们能想象到的所有领域，比如：科学计算、WEB 开发、大数据、人工智能、图形系统等。

为什么需要模块化编程

模块(module)对应于Python源代码文件(.py文件)。模块中可以定义变量、函数、类、普通语句。 这样，我们可以将一个Python程序分解成多个模块，便于后期的重复应用。

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

模块化编程有如下几个重要优势：

1、 便于将一个任务分解成多个模块，实现团队协同开发，完成大规模程序

2、 实现代码复用。一个模块实现后，可以被反复调用

3、 可维护性增强 

模块化编程的流程

模块化编程的一般流程：

1、 设计API，进行功能描述。

2、 编码实现API中描述的功能。

3、 在模块中编写测试代码，并消除全局代码。

4 、使用私有函数实现不被外部客户端调用的模块函数。

模块的API和功能描述要点

API(Application Programming Interface 应用程序编程接口)是用 于描述模块中提供的函数和类的功能描述和使用方式描述。

模块化编程中，首先设计的就是模块的API（即要实现的功能描 述），然后开始编码实现API中描述的功能。

最后，在其他模块中导 入本模块进行调用。 可以通过help(模块名)查看模块的API。一般使用时先导入模块 然后 通过help函数查看。

【示例】导入math模块，并通过help()查看math模块的API：

import math
help(math)

也可以在python的api文档中查询。首先进入python的安装目录下 的docs子目录：

双击打开chm文档，即可通过索引输入“math”查询到对应的API内容：

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

#encoding=utf-8
"""
本模块用于计算公司员工的薪资
"""
company = "python小王"
def yearSalary(monthSalary):
    """根据传入的月薪，计算出年薪"""
    pass
def daySalary(monthSalary):
    """根据传入的月薪，计算出每天的薪资"""
    pass

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

#encoding=utf-8
import salary
print(salary.__doc__)
print(salary.yearSalary.__doc__)

运行结果：

本模块用于计算公司员工的薪资

根据传入的月薪，计算出年薪

模块的创建和测试代码 

每个模块都有一个名称，通过特殊变量 __name__ 可以获取模块的名 称。在正常情况下，模块名字对应源文件名。 仅有一个例外，就是 当一个模块被作为程序入口时（主程序、交互式提示符下），它的 __name__ 的值为 __main__ 。我们可以根据这个特点，将模块源代码文件中的测试代码进行独立的处理。例如：

import math
print(math.__name__)    #输出'math'

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

#encoding=utf-8
"""
本模块用于计算公司员工的薪资
"""
company = "python小王"
def yearSalary(monthSalary):
    """根据传入的月薪，计算出年薪"""
    return monthSalary*12
def daySalary(monthSalary):
    """根据传入的月薪，计算出每天的薪资"""
    return monthSalary/22.5      #国家规定每个月的平均工作日是22.5
if __name__ =="__main__":       #测试代码
    print(yearSalary(3000))
    print(daySalary(3000))

模块文档字符串和API设计

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

【示例】模块文档字符串示例以及导入后如何读取文档字符串

#encoding=utf-8
import MySalary
print(MySalary.__doc__)
print(MySalary.yearSalary.__doc__)

运行结果：

本模块实现根据月薪计算各种薪水的功能

根据月薪，计算年薪

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

模块的导入

模块化设计的好处之一就是“代码复用性高”。写好的模块可以被反复调用，重复使用。模块的导入就是“在本模块中使用其他模块”。

import语句导入

import 语句的基本语法格式如下：

import  模块名               #导入一个模块
import  模块1，模块2…      #导入多个模块
import  模块名   as 模块别名     #导入模块并使用新名字

import 加载的模块分为四种类型：

1 、使用python编写的代码 .py文件

2 、已被编译为共享库或 DLL 的C或C++扩展

3 、一组模块的包

4 、使用C编写并链接到python解释器的内置模块

我们一般通过 import 语句实现模块的导入和使用， import 本质上是使 用了内置函数 __import__() 。 当我们通过 import 导入一个模块时，python解释器进行执行，最终会生成一个对象，这个对象就代表了被加载的模块。 

import  math
print(id(math))
print(type(math))
print(math.pi)    #通过math.成员名来访问模块中的成员

执行结果是：

31840800
<class 'module'>

由上，我们可以看到 math 模块被加载后，实际会生成一个 module 类的 对象，该对象被math变量引用。我们可以通过 math 变量引用模块中所有的内容。

我们通过 import 导入多个模块，本质上也是生成多个 module 类的对象而已。

有时候，我们也需要给模块起个别名，本质上，这个别名仅仅是新创建一个变量引用加载的模块对象而已。

import  math  as  m
#import math
#m = math
print(m.sqrt(4)) #开方运算

from…import导入

Python中可以使用 from…import 导入模块中的成员。

基本语法格式如 下：

from 模块名 import 成员1，成员2，…

如果希望导入一个模块中的所有成员，则可以采用如下方式：

from 模块名 import *

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

【示例】使用from…import导入模块指定的成员 

from math import pi,sin
print(sin(pi/2))    #输出1.0

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

import 导入的是模块。 from...import 导入的是模块中的函数/类。

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

 我们自定义一个模块 calculator.py ：

"""一个实现四则运算的计算器"""
def add(a,b):
    return a+b
def minus(a,b):
    return a-b
class MyNum():
    def print123(self):
        print(123)

我们在另一个模块 test.py 测试：

import calculator
a = calculator.add(30,40)
# add(100,200)     #不加模块名无法识别
print(a)

from calculator import * a = add(100,200)    #无需模块名，可以直接引用里面的函数/类
print(a)
b = MyNum()
b.print123()