在Python的世界里，模块化开发是提高代码复用性和协作效率的关键。当你精心打造了一个功能完备、设计优雅的模块，自然希望它不仅能服务于当前项目，还能在其他场景中大放异彩。这时，打包与分发你的模块就显得尤为重要。通过打包，你可以将模块整理成符合标准的文件结构，方便他人安装和使用。而分发，则能让全世界的Python开发者在PyPI（Python Package Index）这样的平台上找到并下载你的模块。
今天，我们就来学习如何使用Python中最常用的打包工具——setuptools，通过六个简单步骤，让你的模块从本地走向世界！
setuptools是Python生态中用于创建和管理软件包的神器。它提供了一套标准流程，帮助我们将源代码、依赖项、文档等打包成符合Python打包规范（如wheel或tar.gz格式）的文件。同时，setuptools还支持生成易于安装的脚本，使得用户只需一条简单的命令，就能在自己的环境中安装你的模块。
(1) 创建项目目录结构
首先，我们需要为模块创建一个整洁的目录结构。一个典型的Python打包项目通常包含如下部分：
your_package/├── your_package/│ ├── __init__.py│ └── your_code.py├── tests/│ ├── __init__.py│ └── test_your_code.py├── setup.py├── setup.cfg└── MANIFEST.in其中，your_package目录存放你的模块代码，tests目录存放单元测试代码，setup.py是打包配置脚本，setup.cfg和MANIFEST.in用于辅助打包过程。
(2) 编写setup.py文件
接下来，我们来编写setup.py。这个脚本是setuptools的核心入口，定义了模块的基本信息和打包规则。
from setuptools import setupsetup( name='your_package', # 模块名称 version='0.1.0', # 版本号 packages=['your_package'], # 包含的Python包 python_requires='>=3.9', # 支持的Python版本 install_requires=[], # 依赖的外部库 author='Your Name', # 作者信息 author_email='you@example.com', description='A fantastic Python module!', # 简短描述 long_description=open('README.md', 'r').read(), # 长描述（通常读取自README文件） long_description_content_type='text/markdown', # 长描述类型 url='https://github.com/your_username/your_package', # 项目主页 classifiers=[ # 项目分类标签 'Programming Language :: Python :: 3', 'License :: OSI Approved :: MIT License', 'Operating System :: OS Independent', ],)(3) 解析setup()函数参数
上述setup()函数的参数意义如下：
(1) setup.cfg的作用与内容
setup.cfg是一个INI格式的配置文件，用于存储一些常见且不太可能频繁变动的设置。例如，我们可以将setup.py中的install_requires移到这里：
[options]install_requires = dependency1 >= 1.0 dependency2 == 2.5这样做可以使setup.py更简洁，也方便持续集成等自动化流程直接读取依赖关系。
(2) MANIFEST.in的作用与示例配置
MANIFEST.in用于指定哪些非.py文件（如数据文件、LICENSE、README等）应包含在打包结果中。例如：
include README.mdinclude LICENSErecursive-include your_package/data *.csv这表示将README.md、LICENSE文件以及your_package/data目录下所有的.csv文件纳入打包范围。
(1) 模块代码结构与规范
在your_package目录下编写你的模块代码。确保每个子模块都有一个__init__.py文件，以便它们被视为Python包。遵循PEP8编码规范，编写清晰的函数和类，添加必要的文档字符串。
(2) 编写单元测试用例
在tests目录下编写单元测试，使用如unittest、pytest等测试框架。确保覆盖模块的主要功能，为用户提供高质量、可信赖的代码。
() 使用python setup.py sdist命令打包
在项目根目录下执行：
python setup.py sdist这将生成一个.tar.gz文件（如dist/your_package-0.1.0.tar.gz），包含了项目的所有源码、配置文件和指定的额外文件。
(2) 使用pip install dist/your_package.tar.gz安装
在另一台机器或虚拟环境中，通过以下命令安装打包好的模块：
pip install dist/your_package-0.1.0.tar.gz安装成功后，即可在该环境中导入并使用你的模块。
(1) 注册PyPI账号
访问https://pypi.org/，使用邮箱注册一个账号。记住用户名和密码，后续会用到。
(2) 配置twine工具
twine是一个安全、便捷的Python包上传工具。在终端中安装：
pip install twine(3) 使用twine upload dist/*上传包
登录PyPI账号后，回到项目根目录，执行以下命令上传打包好的模块：
twine upload dist/*按照提示输入PyPI用户名和密码（或使用API令牌）。上传成功后，你的模块就会出现在PyPI仓库中，全球的Python开发者都可以通过pip install your_package来安装它了！
恭喜你！通过以上六个步骤，你已经掌握了使用setuptools打包和分发Python模块的全过程。继续探索Python打包的更多高级特性，如 wheel 文件、版本控制、自动化部署等，让你的模块在开源社区中更具影响力。
本文链接：http://www.28at.com/showinfo-26-86992-0.htmlPython打包，setuptools打包六步法
声明：本网页内容旨在传播知识，若有侵权等问题请及时与本网联系，我们将在第一时间删除处理。邮件：2376512515@qq.com
上一篇： 使用 Google Wire 在 Go 中进行依赖注入
下一篇： 递归反转句子：C# 编程技术探究
Copyright © 2016-2023 天津谷骐科技有限公司 版权所有 sitemap.xml
违法及侵权请联系：2376512515@qq.com 津ICP备18001702号
津公网安备 12010102000574号