Python基础知识(10):模块

目录

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

1.1 模块和包概念的进化史

1.2 标准库模块(standard library)

 1.3 为什么需要模块化编程

1.4 模块化编程的流程

1.6 模块的创建和测试代码

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

2. 模块的导入

2.1 import 语句导入

2.2 from…import 导入

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

2.4 __import__()动态导入

2.5 模块的加载问题

3. 包package 的使用

3.1 包(package)的概念和结构

3.2 pycharm 中创建包

 3.3 导入包操作和本质

3.4 用*导入包

3.5 包内引用

3.6 sys.path 和模块搜索路径

4. 模块发布和安装

4.1 模块的本地发布

4.2 本地安装模块

4.3 上传模块到PyPI


​​​​​​​

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

1.1 模块和包概念的进化史

        “量变引起质变”是哲学中一个重要的理论。量变为什么会引起质变呢?本质上理解,随着数量的增加,管理方式会发生本质的变化;旧的管理方式完全不适合,必须采用新的管理方式。
        程序越来越复杂,语句多了,怎么管理?很自然的,我们会将实现同一个功能的语句封装到函数中,统一管理和调用,于是函数诞生了。
        程序更加复杂,函数和变量多了,怎么管理?同样的思路,“物以类聚”,我们将同一类型对象的“数据和行为”,也就是“变量和函数”,放到一起统一管理和调用,于是“类和对象”诞生了。
程序继续复杂,函数和类更加多了,怎么办?好,我们将实现类似功能的函数和类统统放到一个模块中,于是“模块”诞生了。
        程序还要复杂,模块多了,怎么办? 于是,我们将实现类似功能的模块放到一起,于是“包”就诞生了。

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

1.2 标准库模块(standard library)

        与函数类似,模块也分为标准库模块和用户自定义模块。
        Python 标准库提供了操作系统功能、网络通信、文本处理、文件处理、数学运算等基本的功能。比如:random(随机数)、math(数学运算)、time(时间处理)、file(文件处理)、os(和操作系统交互)、sys(和解释器交互)等。
        另外,Python 还提供了海量的第三方模块,使用方式和标准库类似。功能覆盖了我们能想象到的所有领域,比如:科学计算、WEB 开发、大数据、人工智能、图形系统等。

 1.3 为什么需要模块化编程

        模块(module)对应于Python 源代码文件(.py 文件)。模块中可以定义变量、函数、类、普通语句。这样,我们可以将一个Python 程序分解成多个模块,便于后期的重复应用。
        模块化编程(Modular Programming)将一个任务分解成多个模块。每个模块就像一个积木一样,便于后期的反复使用、反复搭建。

模块化编程有如下几个重要优势:
1. 便于将一个任务分解成多个模块,实现团队协同开发,完成大规模程序
2. 实现代码复用。一个模块实现后,可以被反复调用。
3. 可维护性增强。

1.4 模块化编程的流程

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

"""
    用于计算公司员工的薪资
"""
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))

1.6 模块的创建和测试代码

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

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

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

2. 模块的导入

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

2.1 import 语句导入

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

 import 加载的模块分为四个通用类别:
a.使用python 编写的代码(.py 文件);
b.已被编译为共享库或DLL 的C 或C++扩展;
c.包好一组模块的包
d.使用C 编写并链接到python 解释器的内置模块;

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

2.2 from…import 导入

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

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

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

import 导入的是模块。from...import 导入的是模块中的一个函数/一个类。
如果进行类比的话,import 导入的是“文件”,我们要使用该“文件”下的内容,必须前面加“文件名称”。from...import 导入的是文件下的“内容”,我们直接使用这些“内容”即可,前面再也不需要加“文件名称”了。

2.4 __import__()动态导入

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

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

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

2.5 模块的加载问题

当导入一个模块时, 模块中的代码都会被执行。不过,如果再次导入这个模块,则不会再次执行。
Python 的设计者为什么这么设计?因为,导入模块更多的时候需要的是定义模块中的变量、函数、对象等。这些并不需要反复定义和执行。“ 只导入一次import-only-once”就成了一种优化。

一个模块无论导入多少次,这个模块在整个解释器进程内有且仅有一个实例对象。

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

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

3. 包package 的使用

3.1 包(package)的概念和结构

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

 

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

 

 上图中,a 是上层的包,下面有一个子包:aa。可以看到每个包里面都有__init__.py 文件。

3.2 pycharm 中创建包

在pycharm 开发环境中创建包,非常简单。在要创建包的地方单击右键:New-->Python package 即可。pycharm 会自动帮助我们生成带有__init__.py 文件的包。

 3.3 导入包操作和本质

上一节中的包结构,我们需要导入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()
【注】
1. from package import item 这种语法中,item 可以是包、模块,也可以是函数、类、变量。
2. import item1.item2 这种语法中,item 必须是包或模块,不能是其他。

导入包的本质其实是“导入了包的__init__.py”文件。也就是说,”import pack1”意味着执行了包pack1 下面的__init__.py 文件。这样,可以在__init__.py 中批量导入我们需要的模块,而不再需要一个个导入。
__init__.py 的三个核心作用:
1. 作为包的标识,不能删除。
2. 用来实现模糊导入
3. 导入包实质是执行__init__.py 文件,可以在__init__.py 文件中做这个包的初始化、以及
需要统一执行代码、批量导入。

3.4 用*导入包

        import * 这样的语句理论上是希望文件系统找出包中所有的子模块,然后导入它们。这可能会花长时间等。Python 解决方案是提供一个明确的包索引。
        这个索引由__init__.py 定义__all__ 变量,该变量为一列表,如上例a 包下的__init__.py 中,可定义__all__ = ["module_A","module_A2"]
        这意味着, from sound.effects import * 会从对应的包中导入以上两个子模块;
【注】尽管提供import * 的方法,仍不建议在生产代码中使用这种写法。

3.5 包内引用

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

3.6 sys.path 和模块搜索路径

当我们导入某个模块文件时, Python 解释器去哪里找这个文件呢?只有找到这个文件才能读取、装载运行该模块文件。它一般按照如下路径寻找模块文件(按照顺序寻找,找到即停不继续往下寻找):
1. 内置模块
2. 当前目录
3. 程序的主目录
4. pythonpath 目录(如果已经设置了pythonpath 环境变量)
5. 标准链接库目录
6. 第三方库目录(site-packages 目录)
7. .pth 文件的内容(如果存在的话)
8. sys.path.append()临时添加的目录

· pythonpath 环境变量的设置
windows 系统中通过如下操作添加和设置pythonpath 环境变量。

 · .pth 文件的写法
我们可以在site-packages 目录下添加.pth 文件。并在文件中增加内容:

#一行一个目录
g:\a
g:\b
g:\c

【注】
1. 需确保g:\a,g:\b,g:\c 对应的目录真实存在。
2. 在windows 系统中建立.pth 文件,由于没有文件名不能直接建立。需要输入“.pth.”才能正常建立.pth 文件。

4. 模块发布和安装

4.1 模块的本地发布

当我们完成了某个模块开发后,可以将他对外发布,其他开发者也可以以“第三方扩展库”的方式使用我们的模块。我们按照如下步骤即可实现模块的发布:
1.为模块文件创建如下结构的文件夹(一般,文件夹的名字和模块的名字一样):

2.在文件夹中创建一个名为『setup.py』的文件,内容如下: 

2.在文件夹中创建一个名为『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'] # 要发布的模块
)

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

python setup.py sdist

执行完毕后,目录结构变为:

4.2 本地安装模块

将发布安装到你的本地计算机上。仍在cmd 命令行模式下操作,进setup.py 所在目录,键入命令:python setup.py install
安装成功后,我们进入python 目录/Lib/site-packages 目录(第三方模块都安装的这里,python 解释器执行时也会搜索这个路径): 

 安装成功后,直接使用import 导入即可:import baizhanMath2.demo1

4.3 上传模块到PyPI

        将自己开发好的模块上传到PyPI 网站上,将成为公开的资源,可以让全球用户自由使用。按照如下步骤做,很容易就实现上传模块操作。

·注册PyPI 网站
注册PyPI 网站:http://pypi.python.org
【注意】会发送一封邮件到你的邮箱。请点击验证后继续下面的步骤。
·创建用户信息文件.pypirc
·方式1: 使用命令(适用Linux)
输入并执行后python setup.py register ,然后输入用户名和密码,即可。
·方式2:使用文件(适用windows,Linux)
在用户的家目录里创建一个文件名为.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 官网,可以看到:
如果你的模块已经上传成功,那么当你登录PyPI 网站后应该能在右侧导航栏看到管理
入口。

 

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值