原文：https://ichochy.com/posts/shell/20250910.html
如何打包一个简单的Python项目，构建软件包，以及将其上传到 Python 软件包索引，分享你的项目。
分为如下几步：新建项目、构建项目、上传项目、安装项目
macOS Homebrew 安装 Poetry
Poetry:https://python-poetry.org
pyproject.toml)介绍：Poetry 配置文件介绍：https://python-poetry.org/docs/pyproject
Python 编写配置文件: writing-pyproject-toml
pyproject.toml)实例（iGTTS）：pyproject.toml
[project]
name = "iGTTS"
version = "0.1.1"
description = "Gemini TTS CLI"
authors = [
{name = "iChochy",email = "[email protected]"}
]
readme = "docs/README.md"
keywords = ["TTS", "Gemini"]
license-files = "LICENSE"
license = {text = "MIT"}
requires-python = ">=3.13"
dependencies = [
"google-genai (>=1.36.0,<2.0.0)"
]
[project.scripts]
igtts = "igtts:main"
[project.urls]
Homepage = "https://tts.ichochy.com"
[build-system]
requires = ["poetry-core>=2.0.0,<3.0.0"]
build-backend = "poetry.core.masonry.api"
说明：
dependencies：声明项目的所需依赖包
[project.scripts]：声明项目的命令脚本
[build-system]：声明项目的构建系统
poetry install
---------------
Updating dependencies
Resolving dependencies... (0.4s)
.....
Writing lock file
Installing the current project: iGTTS (0.1.2)
通过配置文件(pyproject.toml)构建项目
poetry build
---------
Building iGTTS (0.1.1)
Building sdist
- Building sdist
- Built igtts-0.1.1.tar.gz
Building wheel
- Building wheel
- Built igtts-0.1.1-py3-none-any.whl
打包项目文件
dist/
├── igtts-0.1.2.tar.gz
└── igtts-0.1.2-py3-none-any.whl
在 PyPI 账户设置中创建一个 API token
添加 PyPI token：https://pypi.org/manage/account/token/
pypi-AgEIcHlwaS5vcmcCJDVl...
poetry config pypi-token.pypi pypi-AgEIcHlwaS5vcmcCJDVl...
poetry publish
-----------------
Publishing iGTTS (0.1.2) to PyPI
- Uploading igtts-0.1.2-py3-none-any.whl 100%
- Uploading igtts-0.1.2.tar.gz 100%
pip install igtts
--------------------
Collecting igtts
Using cached igtts-0.1.2-py3-none-any.whl (10 kB)
Installing collected packages: igtts
Successfully installed igtts-0.1.2
igtts
-------------
语音内容: Hello，这是一个 Gemini TTS CLI 工具，记...
语音名称: Zephyr
开始生成音频...
音频已成功保存到 'output.wav'
一个 Gemini TTS 的终端命名工具，可以将文本信息转为音频文件的终端命令。
至此，使用 Poetry 创建项目、构建打包，再到发布和安装。走完了整个项目发布到 PyPI 流程。
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。