预备工作
注册账号:https://test.pypi.org/manage/projects/
一个简单的项目
本教程使用一个名为的简单项目example_pkg。如果您不熟悉Python的模块和导入包,请花几分钟时间阅读包含文件包和模块的Python文档。即使您已经有一个要打包的项目,我们仍然建议您按照本示例包使用此示例包,然后尝试使用自己的包。
要在本地创建此项目,请创建以下文件结构:
/packaging_tutorial
/example_pkg
__init__.py
这只是为了让您可以在本教程后面验证它是否正确安装,并且PyPI不会使用它。
创建包文件
您现在将创建一些文件来打包此项目并准备分发。创建下面列出的新文件 - 您将在以下步骤中向其添加内容。
/packaging_tutorial
/example_pkg
__init__.py
setup.py
LICENSE
README.md
创建setup.py
setup.py是setuptools的构建脚本。它告诉setuptools你的包(例如名称和版本)以及要包含的代码文件。
打开setup.py并输入以下内容。更新软件包名称以包含您的用户名(例如,example-pkg-theacodes),这可确保您拥有唯一的软件包名称,并且您的软件包与本教程后其他人上传的软件包不会发生冲突。
import setuptools
with open("README.md", "r") as fh:
long_description = fh.read()
setuptools.setup(
name="example-pkg-your-username",
version="0.0.1",
author="Example Author",
author_email="author@example.com",
description="A small example package",
long_description=long_description,
long_descriptio