1、 自定义模块

1.1 模块和包

import hashlib


def encrypt(data):
    """ 数据加密 """
    hash_object = hashlib.md5()
    hash_object.update(data.encode('utf-8'))
    return hash_object.hexdigest()


user = input("请输入用户名:")
pwd = input("请输入密码:")
md5_password = encrypt(pwd)

message = "用户名:{},密码:{}".format(user, md5_password)
print(message)

在开发简单的程序时,使用一个py文件就可以搞定,如果程序比较庞大,需要些10w行代码,此时为了,代码结构清晰,将功能按照某种规则拆分到不同的py文件中,使用时再去导入即可。另外,当其他项目也需要此项目的某些模块时,也可以直接把模块拿过去使用,增加重用性。

如果按照某个规则进行拆分,发现拆分到 commons.py 中函数太多,也可以通过文件夹来进行再次拆分,例如:

├── commons
 │   ├── convert.py
 │   ├── page.py
 │   └── utils.py
 └── run.py

在Python中一般对文件和文件的称呼(很多开发者的平时开发中也有人都称为模块)

  • 一个py文件,模块(module)。
  • 含多个py文件的文件夹,包(package)。

注意:在包(文件夹)中有一个默认内容为空的__init__.py的文件,一般用于描述当前包的信息(在导入他下面的模块时,也会自动加载)。

  • py2必须有,如果没有导入包就会失败。
  • py3可有可无。

1.2 导入

当定义好一个模块或包之后,如果想要使用其中定义的功能,必须要先导入,然后再能使用。

导入,其实就是将模块或包加载的内存中,以后再去内存中去拿就行。

  • 关于导入时的路径

在Python内部默认设置了一些路径,导入模块或包时,都会按照指定顺序逐一去特定的路径查找。

import sys
print(sys.path)

['当前脚本目录',
 'D:\\Program Files\\JetBrains\\PyCharm 2020.1\\plugins\\python\\helpers\\pycharm_display',
 'D:\\Program Files\\Virtualenv\\base\\Scripts\\python37.zip', 'd:\\program files\\python\\python37\\DLLs',
 'd:\\program files\\python\\python37\\lib', 'd:\\program files\\python\\python37',
 'D:\\Program Files\\Virtualenv\\base', 'D:\\Program Files\\Virtualenv\\base\\lib\\site-packages',
 'd:\\program files\\python\\python37\\lib\\site-packages',
 'd:\\program files\\python\\python37\\lib\\site-packages\\win32',
 'd:\\program files\\python\\python37\\lib\\site-packages\\win32\\lib',
 'd:\\program files\\python\\python37\\lib\\site-packages\\Pythonwin',
 'D:\\Program Files\\JetBrains\\PyCharm 2020.1\\plugins\\python\\helpers\\pycharm_matplotlib_backend']

想要导入任意的模块和包,都必须写在如下路径下,才能被找到。

也可以自动手动在sys.path中添加指定路径,然后再导入可以,例如:

import sys
sys.path.append("路径A")

import xxxxx  # 导入路径A下的一个xxxxx.py文件

1. 以后写模块名称时,千万不能和内置和第三方的同名(新手容易犯错误)。

2. 项目执行文件一般都在项目根目录,如果执行文件嵌套的内存目录,就需要自己手动在sys.path中添加路径。

sys.path.append(os.path.dirname(os.path.abspath(__file__)))

3. pycharm中默认会将项目目录加入到sys.path中

 

  • 关于导入的方式:

导入本质上是将某个文件中的内容先加载到内存中,然后再去内存中拿过来使用。而在Python开发中常用的导入的方式有2类方式,每类方式都也多种情况。

  1. 第一类:import xxxx(开发中,一般多用于导入sys.path目录下的一个py文件)
  • 模块级别
├── commons
 │   ├── __init__.py
 │   ├── convert.py
 │   ├── page.py
 │   ├── tencent
 │   │   ├── __init__.py
 │   │   ├── sms.py
 │   │   └── wechat.py
 │   └── utils.py
 ├── many.py
 └── run.py

python 自定义驱动程序 自定义python模块_python 自定义驱动程序

  • 包级别
├── commons
 │   ├── __init__.py
 │   ├── convert.py
 │   ├── page.py
 │   └── utils.py
 ├── third
 │   ├── __init__.py
 │   ├── ali
 │   │   └── oss.py
 │   └── tencent
 │       ├── __init__.py
 │       ├── __pycache__
 │       ├── sms.py
 │       └── wechat.py
 └── run.py

python 自定义驱动程序 自定义python模块_python_02

  1. 第二类:from xxx import xxx 【常用】,一般适用于多层嵌套和导入模块中某个成员的情况。
  • 成员级别
├── commons
 │   ├── __init__.py
 │   ├── convert.py
 │   ├── page.py
 │   └── utils.py
 ├── many.py
 └── run.py

python 自定义驱动程序 自定义python模块_Python_03

提示:基于from模式也可以支持 from many import *,即:导入一个模块中所有的成员(可能会重名,所以用的少)。

  • 模块级别
├── commons
 │   ├── __init__.py
 │   ├── convert.py
 │   ├── page.py
 │   └── utils.py
 ├── many.py
 └── run.py

python 自定义驱动程序 自定义python模块_python 自定义驱动程序_04

  • 包级别
├── commons
 │   ├── __init__.py
 │   ├── convert.py
 │   ├── page.py
 │   ├── tencent
 │   │   ├── __init__.py
 │   │   ├── sms.py
 │   │   └── wechat.py
 │   └── utils.py
 ├── many.py
 └── run.py

python 自定义驱动程序 自定义python模块_python_05

1.3 相对导入

在导入模块时,对于 from xx import xx这种模式,还支持相对到导入。

python 自定义驱动程序 自定义python模块_python 自定义驱动程序_06

切记,相对导入只能用在包中的py文件中(即:嵌套在文件中的py文件才可以使用,项目根目录下无法使用)。

python 自定义驱动程序 自定义python模块_Python_07

1.4 导入别名

如果项目中导入 成员/模块/包 有重名,那么后导入的会覆盖之前导入,为了避免这种情况的发生,Python支持重命名,即:

xxxxxxxxxx from xxx.xxx import xx as xoimport x1.x2 as pg

除此之外,有了as的存在,让 import xx.xxx.xxxx.xxx 在调用执行时,会更加简单(不常用,了解即可)。

  • 原来
import commons.page

v1 = commons.page.pagination()
  • 现在
import commons.page as pg

v1 = pg.pagination()

1.5 主文件

  • 执行一个py文件时
__name__ = "__main__"
  • 导入一个py文件时
__name__ = "模块名"

主文件,其实就是在程序执行的入口文件,例如

├── commons
 │   ├── __init__.py
 │   ├── convert.py
 │   ├── page.py
 │   ├── tencent
 │   │   ├── __init__.py
 │   │   ├── sms.py
 │   │   └── wechat.py
 │   └── utils.py
 ├── many.py
 └── run.py

我们通常是执行 run.py 去运行程序,其他的py文件都是一些功能代码。当我们去执行一个文件时,文件内部的 __name__变量的值为 __main__,所以,主文件经常会看到:

import many
from commons import page
from commons import utils


def start():
    v1 = many.show()
    v2 = page.pagination()
    v3 = utils.encrypt()


if __name__ == '__main__':
    start()

只有是以主文件的形式运行此脚本时start函数才会执行,被导入时则不会被执行。

2、第三方模块

Python内部提供的模块有限,所以在平时在开发的过程中,经常会使用第三方模块。

而第三方模块必须要先安装才能可以使用,下面介绍常见的3中安装第三方模块的方式。

其实,使用第三方模块的行为就是去用别人写好并开源出来的py代码,这样自己拿来就用,不必重复造轮子了。。。。

2.1 pip安装(最常用)

这是Python中最最最常用的安装第三方模块的方式。

pip其实是一个第三方模块包管理工具,默认安装Python解释器时自动会安装,默认目录:

Windows系统,即:Python安装路径的scripts目录下
     C:\Python39\Scripts\pip3.exe
     C:\Python39\Scripts\pip3.9.exe

提示:为了方便在终端运行pip管理工具,我们也会把它所在的路径添加到系统环境变量中。

pip3 install 模块名称

默认安装的是最新的版本,如果想要指定版本:

pip3 install 模块名称==版本

# 例如:
pip3 install django==2.2
  • pip更新
C:\Python39\Scripts\pip3.9.exe -m pip install --upgrade pip

注意:根据自己电脑的提示命令去执行,不要用我这里的提示命令。

  • 豆瓣源

 

pip默认是去 https://pypi.org 去下载第三方模块(本质上就是别人写好的py代码),国外的网站速度会比较慢,为了加速可以使用国内的豆瓣源。

一次性使用

pip3.9 install 模块名称  -i  https://pypi.douban.com/simple/

永久使用

配置

# 在终端执行如下命令
pip3.9 config set global.index-url https://pypi.douban.com/simple/

# 执行完成后,提示在我的本地文件中写入了豆瓣源,以后再通过pip去安装第三方模块时,就会默认使用豆瓣源了。
# 自己以后也可以打开文件直接修改源地址。
Writing to /Users/hqss/.config/pip/pip.conf

使用

pip3.9 install 模块名称

写在最后,也还有其他的源可供选择(豆瓣应用广泛)

阿里云:http://mirrors.aliyun.com/pypi/simple/
中国科技大学:https://pypi.mirrors.ustc.edu.cn/simple/ 
清华大学:https://pypi.tuna.tsinghua.edu.cn/simple/
中国科学技术大学:http://pypi.mirrors.ustc.edu.cn/simple/

2.2 源码安装

如果要安装的模块在pypi.org中不存在 或 因特殊原因无法通过pip install 安装时,可以直接下载源码,然后基于源码安装。

  • 下载requests源码(压缩包zip、tar、tar.gz)并解压。

下载地址:https://pypi.org/project/requests/#files

  • 进入目录
  • 执行编译和安装命令
python3 setup.py build
python3 setup.py install

2.3 wheel 安装

wheel是Python的第三方模块包的文件格式的一种,我们也可以基于wheel去安装一些第三方模块。

  • 安装wheel格式支持,这样pip再安装第三方模块时,就可以处理wheel格式的文件了。
pip3.9 install xxx.wheel

python 自定义驱动程序 自定义python模块_python_08

  • 进入下载目录,在终端基于pip直接安装

无论通过什么形式去安装第三方模块,默认模块的安装路径在:

Windows系统:
    C:\Python39\Lib\site-packages\

至此,关于Python的自定义模块和第三方模块内容总结完毕