Python 基础笔记 day-11 模块

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

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

模块化编程的重要优势

1. 便于将一个任务分解成多个模块，实现团队协同开发，完成大规模程序
2. 实现代码复用。一个模块实现后，可以被反复调用。
3. 可维护性增强。

模块化编程的流程

模块化编程的一般流程：

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

API

API(Application Programming Interface 应用程序编程接口)是用于描述模块中提供的函数和类的功能描述和使用方式描述。
我们可以通过help(模块名)查看模块的API。一般使用时先导入模块 然后通过help查看，也可以在 python 的 api 文档中查询

import math
help(math)

一个例子

"""
    用于计算公司员工的薪资
"""

company = "北京尚学堂"

def yearSalary(monthSalary):
    #计算年薪
    """根据传入的月薪的值，计算出年薪：monthsalary*12"""
    return monthSalary*12


def daySalary(monthSalary):
    """根据传入的月薪值，计算出1天的薪资。一个月按照22.5天计算（国家规定的工作日）"""
    return monthSalary/22.5



if __name__ == "__main__": # 模块被作为程序入口时
    print(yearSalary(5000))

import MySalary

print(MySalary.__doc__) #读取相关内容
print(MySalary.yearSalary.__doc__)

模块的导入

import

import 语句的基本语法格式如下：
import 模块名 #导入一个模块
import 模块 1，模块 2… #导入多个模块
import 模块名 as 模块别名 #导入模块并使用新名字

import math
import numpy , math
import tensorflow as tf

import 本质上是使用了内置函数__import__()。
我们通过 import 导入多个模块，本质上也是生成多个 module 类的对象而已。

from…import 导入

Python 中可以使用 from…import 导入模块中的成员。基本语法格式如下：
from 模块名 import 成员 1，成员 2
如果希望导入一个模块中的所有成员，则可以采用如下方式：
from 模块名 import *

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

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

import 导入的是模块。from…import 导入的是模块中的一个函数/一个类。
from…import 导入的是文件下的“内容”，我们直接使用这些“内容”即可，前面再也不需要加“文件名称”了。

'''
    一个实现四则运算的计算器
'''
def add(a,b):
    return a+b

def minus(a,b):
    return a-b

class MyNum():
    def print123(self):
     print(123)

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()

import()动态导入

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

s = "math"
m = __import__(s) #导入后生成的模块对象的引用给变量 m
print(m.pi)

一般不建议我们自行使用__import__()导入，其行为在 python2 和 python3 中有差异，会导致意外错误。如果需要动态导入可以使用 importlib 模块。

import importlib
a = importlib.import_module("math")
print(a.pi)

当导入一个模块时， 模块中的代码都会被执行。不过，如果再次导入这个模块，则不会再次执行。

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

import test02
import test02

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

包package的使用

包(package)的概念和结构

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

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

pycharm创建

导入包内的模块

上一节中的包结构，我们需要导入 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”文件**。也就是说，”import pack1”意味着执行了包 pack1 下面的__init__.py 文件。 这样，可以在__init__.py 中批量导入我们需要的模块，而不再需要一个个导入

__init__.py 的三个核心作用：

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

__init__.py

import turtle
import math
print("导入 a 包")

import a
print(a.math.pi)

用*导入包

import * 这样的语句理论上是希望文件系统找出包中所有的子模块，然后导入它们。这可能会花长时间等。Python 解决方案是提供一个明确的包索引。

这个索引由 init.py 定义__all__变量，该变量为一列表，如上例 a 包下的__init__.py 中，可定义:
__all__ = ["module_A","module_A2"] 这意味着， from sound.effects import * 会从对应的包中导入以上两个子模块；

【注】尽管提供 import * 的方法，仍不建议在生产代码中使用这种写法。

__init__.py

import turtle
import math

print("导入a包")

__all__=["module_A","module_A2"]

包内引用

如果是子包内的引用，可以按相对位置引入子模块 以 aa 包下的 module_AA 中导入 a包下内容为例：
from … import module_A #…表示上级目录
from . import module_A2 #.表示同级目录

sys.path 和模块搜索路径

告诉解释器去哪里找对应模块，（当我们导入某个模块文件时， Python 解释器去哪里找这个文件呢？）
解释器一般按照如下路径寻找模块文件（按照顺序寻找，找到即停不继续往下寻找）：

1. 内置模块
2. 当前目录
3. 程序的主目录
4. pythonpath 目录（如果已经设置了 pythonpath 环境变量）
5. 标准链接库目录
6. 第三方库目录（site-packages 目录）
7. .pth 文件的内容（如果存在的话）
8. sys.path.append()临时添加的目录

当任何一个 python 程序启动时，就将上面这些搜索路径(除内置模块以外的路径)进行收集，放到 sys 模块的 path 属性中（sys.path）。使用 sys.path 查看和临时修改搜索路径
我们在项目的 b 目录下建立测试模块：

import sys
sys.path.append("d:/")
print(sys.path)

执行结果：

pythonpath 环境变量的设置

环境变量、新建系统变量、pythonpath

模块发布和安装

模块的本地发布

在文件夹中创建一个setup.py的文件

from distutils.core import setup

setup(
    name='baizhanMath2',  # 对外我们模块的名字
    version='1.0', # 版本号
    description='这是第一个对外发布的模块，测试哦',  #描述
    author='gaoqi', # 作者
    author_email='gaoqi110@163.com',
    py_modules=['baizhanMath2.demo1','baizhanMath2.demo2'] # 要发布的模块
)

构建一个发布文件。通过终端，cd 到模块文件夹 c 下面，再键入命令：

python setup.py sdist

最后变为

本地安装模块

将发布安装到你的本地计算机上。仍在 cmd 命令行模式下操作，进 setup.py 所在目录，键入命令：

python setup.py install

安装成功后，我们进入 python 目录/Lib/site-packages 目录（第三方模块都安装的这里,python 解释器执行时也会搜索这个路径）：

这之后再import导入即可

上传模块到 PyPI

PyPI(Python Package Index)是 python 官方的第三方库的仓库，所有人都可以下载第三方库或上传自己开发的库到 PyPI。PyPI 推荐使用 pip 包管理器来下载第三方库。
pip 是一个现代的，通用的 Python 包管理工具。

安装第三方扩展库的 2 种方式

pillow 是Python 平台事实上的图像处理标准库，本节以安装 pillow 为例，给大家介绍第三方库的两种常用的安装方法。

第一种方式：命令行下远程安装

以安装第三方 pillow 图像库为例，在命令行提示符下输入：pip install pillow安装完成后，我们就可以开始使用

第二种方式：Pycharm 中直接安装到项目中

让别人使用你的模块