在PYPI上分发Python包装

要在PYPI上放置Python软件包，请按照以下步骤：首先使用SRC/文件夹，Setup.py或Pyproject.toml，Readme.md和许可证来组织您的项目结构；接下来，使用pyproject.toml为现代设置创建适当的元数据；然后使用构建和麻线工具构建和上传软件包。首先，正确构建项目以避免以后避免导入问题，以确保存在所有必要的文件。将pyproject.toml用于元数据，确保指定独特的名称，正确的版本，作者详细信息，描述，许可证和分类器。准备代码和元数据后，安装构建和麻线，运行Python -M构建以生成分发文件，首先使用Python -M -M Twine Upload -Repository -url https://test.pypi.org/legacy/legacy/legacy/ distroad测试testpypi上载，并最终与Pypi -pypi -pytolof -pytolof -twince -mm -m。请记住，一旦上传版本，就无法重复使用，因此请仔细管理版本号，尤其是在早期发行期间。

将您的Python软件包放在PYPI上不是魔术，但确实需要一些仔细的步骤。核心想法是正确准备您的代码，创建正确的文件并使用标准工具上传。到达那里后，人们可以像其他任何包装一样使用PIP安装它。

设置您的项目结构

甚至在考虑上传到PYPI之前，请确保您的项目正确组织。干净的结构使一切变得更加容易 - 对于您和以后可能安装包装的用户。

至少，您应该有：

• 一个包含您实际Python代码的src/文件夹（或类似）
• setup.py或pyproject.toml文件（在下一部分中详细介绍）
• 用于文档的README.md
• LICENSE文件

您不必遵循此布局，但这是标准的，有助于避免混乱。一个常见的错误是将所有内容都放在没有源文件夹的情况下 - 起初有效，但以后可能会导致进口问题。

创建正确的元数据

元数据告诉PYPI您的软件包是什么，它是什么版本以及如何处理文件。您可以使用setup.py （classic）或pyproject.toml （现代）。

如果您开始新鲜，请使用pyproject.toml 。它更简单和防止。这是一个基本示例：

 [构建系统]
需要= [“ setuptools> = 61.0”]
build-backend =“ setuptools.build_meta”

[项目]
name =“ your-pakeage-name”
版本=“ 0.1.0”
作者= [
  {name =“您的名字”，email =“ you@example.com”}
这是给出的
描述=“包裹的简短描述”
readme =“ readme.md”
许可= {file =“许可”}
需要python =“> = 3.7”
分类器= [
    “编程语言:: python :: 3”，
    “许可证:: OSI批准:: MIT许可”，
    “操作系统:: OS独立”，
这是给出的

确保名称是独一无二的，并遵循命名规则（ lowercase-with-dashes ，而不是CamelCase ）。另外，仔细检查您的版本编号是有道理的 - 管理更新时，您将稍后感谢自己。

建造和上传您的包裹

一旦您的代码和元数据准备就绪，就该建立和上传了。您需要的两个工具： build和twine 。

将它们安装一次：

 PIP安装构建麻线

然后，从您的项目root运行：

 Python -M构建

这将在新的dist/文件夹中创建两个文件： .tar.gz源存档和.whl Wheel文件。

现在用TestPypi首先测试上传（良好实践）：

 Python -M Twine上传-Repository-URL https://test.pypi.org/legacy/ dist/*

如果有效，请执行真正的操作：

 Python -M Twine上传dist/*

它会要求您的PYPI用户名和密码（或API令牌）。完毕！

人们经常忘记的一件事：如果您弄乱了上传，则无法重复使用相同的版本号。因此，如果您仍在快速迭代，请仔细选择您的版本 - 使用0.0.1 0.0.2a 。

基本上就是这样。一旦完成一次，还不错。只需记住要在推出新版本之前保持元数据更新并进行测试。

以上是在PYPI上分发Python包装的详细内容。更多信息请关注PHP中文网其他相关文章！