Python 中的模块是一个带有 .py
扩展名的 Python 脚本,其中包含诸如类、函数等对象。Python 中的包进一步扩展了模块化方法的概念。包是一个文件夹,包含一个或多个模块文件;另外,还可能包含一个特别的文件 __init__.py
,该文件可能是空的,但可能包含包列表。
创建 Python 包
让我们创建一个名为 mypackage
的 Python 包。请按照以下步骤操作:
-
创建一个外层文件夹来保存
mypackage
的内容。假设它的名字为 packagedemo
。
-
在其中创建另一个名为
mypackage
的文件夹。这将是我们将要构建的 Python 包。在 mypackage
内创建两个 Python 模块 areafunctions.py
和 mathfunctions.py
。
-
在
mypackage
文件夹内创建一个空的 __init__.py
文件。
-
在外层文件夹内,我们稍后会存放一个 Python 脚本
example.py
来测试我们的包。
文件/文件夹结构应该如下所示:
使用您喜欢的代码编辑器,在 mypackage
文件夹中保存以下两个 Python 模块:
创建 Python 包的示例
def sum(x, y):
val = x + y
return val
def average(x, y):
val = (x + y) / 2
return val
def power(x, y):
val = x ** y
return val
创建另一个 Python 脚本:
def rectangle(w, h):
area = w * h
return area
def circle(r):
import math
area = math.pi * math.pow(r, 2)
return area
现在让我们通过一个位于包文件夹之上的 Python 脚本来测试 mypackage
包。参考上面的文件夹结构。
from mypackage.areafunctions import rectangle
print("面积:", rectangle(10, 20))
from mypackage.mathfunctions import average
print("平均值:", average(10, 20))
此程序从 mypackage
导入函数。如果执行上述脚本,您应该得到以下输出:
面积: 200
平均值: 15.0
定义包列表
您可以将选定的函数或包中的任何其他资源放入 __init__.py
文件中。让我们将以下代码放入其中:
from .areafunctions import circle
from .mathfunctions import sum, power
要从此包导入可用函数,请将以下脚本保存为 testpackage.py
,如同之前一样,在包文件夹之上。
定义包列表的示例
from mypackage import power, circle
print("圆的面积:", circle(5))
print("10 的 2 次方:", power(10, 2))
它将产生以下输出:
圆的面积: 78.53981633974483
10 的 2 次方: 100
包安装
目前,我们能够从位于包文件夹之上的脚本访问包资源。为了能够在文件系统的任何地方使用该包,您需要使用 PIP 工具进行安装。
首先,在包文件夹级别处的父文件夹中保存以下脚本:
from setuptools import setup
setup(
name='mypackage',
version='0.1',
description='Package setup script',
url='#',
author='匿名',
author_email='test@gmail.com',
license='MIT',
packages=['mypackage'],
zip_safe=False
)
在保持在父文件夹中的情况下,从命令提示符运行 PIP 工具:
C:\Users\user\packagedemo>pip3 install .
Processing c:\users\user\packagedemo
Preparing metadata (setup.py) ... done
Installing collected packages: mypackage
Running setup.py install for mypackage ... done
Successfully installed mypackage-0.1
现在您应该能够在任何环境中导入包的内容。
C:\Users>python
Python 3.11.2 (tags/v3.11.2:878ead1, Feb 7 2023, 16:38:35) [MSC v.1934 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> import mypackage
>>> mypackage.circle(5)
78.53981633974483