Python包怎么创建_Python包的创建方法与结构组织说明

首先创建标准目录结构并添加__init__.py文件，接着编写setup.py和pyproject.toml配置元数据，最后通过build工具构建并本地安装包进行验证。

如果您尝试构建一个可重用的Python模块集合，但不知道如何组织代码结构或正确声明包信息，可能是由于缺乏对Python包结构的理解。以下是创建Python包的具体步骤：

一、准备包的基本结构

一个标准的Python包需要具备特定的目录结构，以便被Python解释器识别为可安装和导入的模块单元。该结构包含初始化文件和功能模块。

1、创建项目根目录，例如命名为 my_python_package。

2、在根目录下新建一个同名的子目录，如 my_python_package，用于存放实际的Python代码。

立即学习“Python免费学习笔记（深入）”；

3、在该子目录中添加 __init__.py 文件，即使为空，也需存在以标识其为Python包。

4、在包目录内创建具体的模块文件，例如 utils.py 或 core.py，并编写所需函数或类。

5、在根目录下创建其他必要文件，包括 setup.py、README.md 和 pyproject.toml（如果使用现代构建系统）。

二、编写 setup.py 配置文件

setup.py 是包的元数据描述文件，定义了包名、版本、依赖项等关键信息，是打包和发布的基础。

1、在项目根目录创建 setup.py 文件。

2、写入以下内容：

from setuptools import setup, find_packages

setup(

    name='my_python_package',

    version='0.1.0',

    packages=find_packages(),

    description='A sample Python package',

    author='Your Name',

    author_email='your.email@example.com',

    install_requires=[

        'requests',

        'click'

    python_requires='>=3.7'

)

豆包爱学

豆包旗下AI学习应用

674

查看详情

三、使用 pyproject.toml 替代 setup.py

现代Python项目推荐使用 pyproject.toml 来声明构建系统和依赖关系，避免直接依赖 setuptools 在运行时的存在。

1、在项目根目录创建 pyproject.toml 文件。

2、添加以下内容：

[build-system]

requires = ["setuptools>=45", "wheel"]

build-backend = "setuptools.build_meta"

[project]

name = "my_python_package"

version = "0.1.0"

description = "A sample Python package"

authors = [{name = "Your Name", email = "your.email@example.com"}]

dependencies = [

  "requests",

  "click"

]

requires-python = ">=3.7"

四、构建和本地安装包

完成配置后，可以将项目构建成可分发的格式，并进行本地测试安装，确保包能正常工作。

1、打开终端并进入项目根目录。

2、运行命令安装构建工具：pip install build。

3、执行构建命令：python -m build，生成 dist/ 目录下的 .whl 和 .tar.gz 文件。

4、使用 pip 安装生成的包：pip install dist/my_python_package-0.1.0-py3-none-any.whl。

5、在另一个Python脚本中尝试导入：from my_python_package.utils import some_function，验证是否成功。

以上就是Python包怎么创建_Python包的创建方法与结构组织说明的详细内容，更多请关注php中文网其它相关文章！