Python 简明教程

Python - Packages

在 Python 中，模块是一个 Python 脚本，其带有 .py 扩展名，并包含类、 functions 等对象。模块化方法会进一步扩展 Packages in Python 概念。包是一个包含一个或多个模块文件的文件夹；此外，一个特殊文件 "init.py" 可能是空的，但可能包含包列表。

Create a Python Package

让我们创建一个名称为 mypackage 的 Python package 。请按照以下步骤进行操作：

  1. 创建外套文件夹来容纳 mypackage 的内容。其名称为 packagedemo 。

  2. 在其内部，创建一个名为 mypackage 的文件夹。这将是我们要构建的 Python package 。将在 mypackage 内部创建两个 Python 模块 areafunctions.py 和 mathfunctions.py。

  3. 在 mypackage 文件夹内部创建一个空的 ".init.py" 文件。

  4. 在外部文件夹内部，稍后我们将存储一个 Python 脚本 example.py 以测试我们的包。

file/folder structure 应如下所示：

folder structure

使用您喜爱的代码编辑器，将以下两个 Python modules 保存至 mypackage 文件夹中。

Example to Create a Python Package

# mathfunctions.py
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 脚本：

# areafunctions.py
def rectangle(w,h):
   area = w*h
   return area

def circle(r):
   import math
   area = math.pi*math.pow(r,2)
   return area

现在，让我们使用此包文件夹之上的 Python 脚本来测试 myexample 包。请参阅以上文件夹结构。

#example.py
from mypackage.areafunctions import rectangle
print ("Area :", rectangle(10,20))

from mypackage.mathsfunctions import average
print ("average:", average(10,20))

此程序从 mypackage 导入功能。如果执行以上脚本，您应该获得以下 output ：

Area : 200
average: 15.0

Define Package List

您可以将包中的选定功能或任何其他资源放置到“ init .py”文件中。让我们将以下代码放入其中。

from .areafunctions import circle
from .mathsfunctions import sum, power

要从该包中导入可用功能，请将以下脚本保存为 testpackage.py，该脚本位于包文件夹的上方，同前。

Example to Define a Package List

#testpackage.py
from mypackage import power, circle

print ("Area of circle:", circle(5))
print ("10 raised to 2:", power(10,2))

它将生成以下 output −

Area of circle: 78.53981633974483
10 raised to 2: 100

Package Installation

目前，我们只能从包文件夹上方的脚本访问包资源。若要在文件系统中的任何位置使用包，您需要使用 PIP 实用程序对其进行安装。

首先，将以下脚本保存到父文件夹中，它位于包文件夹的级别上。

#setup.py
from setuptools import setup
setup(name='mypackage',
version='0.1',
description='Package setup script',
url='#',
author='anonymous',
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

您现在应该能够在任何环境中导入 package 的内容了。

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