本教程将指导你使用 uv 工具创建一个 Python 包并将其发布到 PyPI。uv 是一个快速、现代的 Python 包管理工具,适合替代传统的 pip 和 setuptools。
前提条件
- 安装 Python(建议 3.8 或以上版本)。
- 拥有一个 PyPI 账户(在 PyPI.org 注册)。
- (可选)如果你需要发布到 TestPyPI,可以在 test.pypi.org 注册。
安装 uv:
pip install uv
步骤 1:创建项目结构
pyproject.toml:项目的元数据和依赖配置文件。src/my_python_package/__init__.py:包的初始化文件。name:包的名称,需在 PyPI 上唯一。version:包的版本号,建议遵循 SemVer。description:包的简短描述。authors:作者信息。readme:指向 README 文件(稍后创建)。license:许可证类型(如 MIT、Apache-2.0 等)。
在 src/my_python_package/__init__.py 中添加一些示例代码:
def hello():
return "Hello from my-python-package!"
创建 README.md 文件,描述你的项目:
echo "# My Python Package\n\nA simple Python package for demonstration purposes." > README.md
检查 pyproject.toml,确保内容正确。以下是一个示例:
[project]
name = "my-python-package"
version = "0.1.0"
description = "A simple Python package"
authors = [{name = "Your Name", email = "[email protected]"}]
dependencies = []
=
=
= {text = }
= []
=

