DT走过的路

# pyproject.toml

[build-system] # 构建系统配置，指定构建工具和依赖
requires = ["hatchling"] # 依赖的后端构建工具
build-backend = "hatchling.build" # 使用哪个工具的哪个模块来构建项目

[project] # 工程描述
name = "dt-utils" # 发行版名称
version = "0.0.1" # 版本号，遵循语义化版本控制
description = "一个用于学习 Python 公共库构建和发布的示例工程" # 项目简介
requires-python = ">=3.13" # 指定支持的 Python 版本
readme = "README.md" # 指定项目的 README 文件路径
dependencies = [
    "python-dateutil>=2.8", # 依赖的第三方库，指定版本要求
    "Markdown>=3.5", # 另一个依赖
]

[tool.hatch.build.targets.sdist] # 配置源代码分发包
# 配置留空，表示它会默认包含所有项目文件

[tool.hatch.build.targets.wheel] # 配置 wheel 包
packages = ["src/dt_utils"] # 配置 wheel 包的构建目标，指定包含的包路径

构建方式

# 1. 创建虚拟环境
python -m venv .venv
​
# 2. 激活虚拟环境
source .venv/bin/activate
​
windows:
.\.venv\Scripts\activate
​
# 3. 安装构建工具
pip install build
​
# 4. 运行构建
python -m build

构建产物放到了./dist中

发布和安装

发布前的准备

# 先构建
​
# 安装官方的发布工具
pip install twine
​
# 【可选】验证构建产物的完整性
twine check dist/*

发布到官方仓库

1. 注册账号：https://pypi.org/account/register/
2. 创建一个token：https://pypi.org/manage/account/token/
3. 复制token
4. 运行twine upload dist/*命令上传

发布到私有仓库

通常使用云服务完成私有仓库的搭建

1. 创建阿里云效制品仓库 https://packages.aliyun.com/
2. 按照仓库指南配置并上传包