reqs

帮助处理Python要求（reqs）文件

• reqs引导程序:
  • 安装uv（默认）或升级pip & 安装pip-tools以激活venv
  • 确保reqs将使用项目使用的Python版本编译锁文件
• reqs编译:
  • 将.in reqs文件编译成.txt "锁"文件
  • 考虑文件修改时间和文件依赖关系（当使用-r或-c时）
• reqs同步:
  • 编译（默认，可选）
  • 同步活动虚拟环境与锁文件
  • 当"sync_pipx"为true时：将通过安装/升级为pipx的可编辑包在本地系统上使项目脚本可用。

安装

建议在用户级别安装，而不是按应用程序安装。

• pipx安装reqs-cli（推荐）
• [uv] pip install --user reqs-cli

配置

使用pyproject.toml进行配置

# The options shown are the default values and DO NOT need to be specified
# if the default is sufficient.

[tool.reqs]
# Path to the directory containing the .in and .txt requirements files.  Relative to pyproject.toml.
dpath = 'requirements'

# Use pipx to install an editable version of the project.  True for tools like reqs and env-config
# that a developer would want available for different projects.  False for most client projects
# deployed on servers.
sync_pipx = false

开发

• 可以从copier-py-package更新
  • hatch run copier:update：GitHub上最新的标记版本
  • hatch run copier:update-head：GitHub上master的头部
• 发布
  • 使用mise run bump [-- --help]更新版本、标签并将推送到GitHub
  • GitHub工作流完成剩余工作