### 使用 setuptools 打包并发布 Python 源码 使用 `setuptools` 打包和发布 Python 项目，通常包括以下几个步骤： 1. **初始化项目结构** 创建一个标准的 Python 项目目录结构。例如： ``` my_project/ ├── my_package/ │ └── __init__.py ├── setup.py └── README.md ``` 2. **编写 `setup.py` 文件** 在项目根目录下创建 `setup.py` 文件，定义项目的元数据和打包配置： ```python from setuptools import setup, find_packages setup( name='my_package', version='0.1.0', packages=find_packages(), include_package_data=True, description='A simple example package', long_description=open('README.md').read(), long_description_content_type='text/markdown', author='Your Name', author_email='your.email@example.com', url='https://github.com/yourusername/my_package', install_requires=[ # 列出依赖项 ], classifiers=[ 'Programming Language :: Python :: 3', 'License :: OSI Approved :: MIT License', 'Operating System :: OS Independent', ], python_requires='>=3.6', ) ``` 3. **构建分发包** 使用以下命令生成 wheel 和源码分发包： ```bash python setup.py sdist bdist_wheel ``` 构建完成后，会在 `dist/` 目录下生成 `.tar.gz`（源码包）和 `.whl`（wheel 包）文件。 4. **上传到 PyPI** 安装 `twine` 并使用它将包上传到 PyPI： ```bash pip install twine twine upload dist/* ``` 首次上传时需要在 [PyPI](https://pypi.org/) 注册账号，并填写项目信息。 ### 使用 Poetry 打包并发布 Python 源码 `Poetry` 提供了更简洁的打包和发布流程，并内置依赖管理和虚拟环境支持。 1. **初始化项目** 如果尚未初始化项目，可以使用以下命令创建新项目： ```bash poetry new my_package cd my_package ``` 2. **配置 `pyproject.toml`** 修改 `pyproject.toml` 文件，填写项目信息、依赖项等： ```toml [tool.poetry] name = "my_package" version = "0.1.0" description = "A simple example package" authors = ["Your Name <your.email@example.com>"] readme = "README.md" [tool.poetry.dependencies] python = "^3.8" requests = "^2.25" [build-system] requires = ["poetry-core"] build-backend = "poetry.core.masonry.api" ``` 3. **构建包** 使用以下命令构建 wheel 和源码包： ```bash poetry build ``` 构建后的文件会出现在 `dist/` 目录中。 4. **发布到 PyPI** 使用 `poetry publish` 命令将包上传到 PyPI： ```bash poetry publish --build ``` 如果是首次发布，需要先注册 PyPI 账号，并在命令行中输入用户名和密码。 ### 注意事项 - 确保版本号正确更新，避免覆盖已有版本。 - 可以通过 `poetry config pypi-token.pypi YOUR_API_TOKEN` 设置 API Token 来简化认证过程。 - 若需私有仓库部署，可配置 `repository` 字段指向自建的 PyPI 服务器[^3]。 --- ###