razel-py-cli 0.0.3

Razel Python CLI (Typer): installable command-line tool

razel-py-cli

razel-py-cli：基于 Typer，命令 razel-py-cli 或 python -m razel_py_cli。 使用前请先执行 razel-py-cli init，生成 ~/.razel/config.json 并配置密钥（见 config）。

子命令文档

顶层命令包括 init、config、speech-to-text、acceptance-toolkit。选项与示例在对应源码目录的 README 中：

• init
• config
• speech-to-text
• acceptance_toolkit

基本使用

razel-py-cli init              # 首次使用前执行
razel-py-cli --help
razel-py-cli speech-to-text --help
razel-py-cli acceptance-toolkit --help
razel-py-cli acceptance-toolkit parse-template --help
razel-py-cli acceptance-toolkit plan --help
razel-py-cli acceptance-toolkit build --help
razel-py-cli acceptance-toolkit revise --help
razel-py-cli acceptance-toolkit finalize --help

开发

uv sync --group dev
uv run razel-py-cli --help
uv run pytest

若本地没有全局 uv，也可以直接使用仓库内虚拟环境：

./.venv/bin/python -m pytest -q
PYTHONPATH=src ./.venv/bin/python -m razel_py_cli --help

新增顶层子命令时，请在 tests/ 下补充对应测试（约定见 tests/conftest.py 顶部说明）。

依赖版本以 uv.lock 为准；修改 pyproject.toml 的依赖后，请同时刷新 uv.lock 并一起提交，这样本地、CI 和发布构建看到的解析结果才会保持一致。

测试与 CI

• 最小 CI 位于 .github/workflows/tests.yml
• 当前 CI 做的事情是：安装项目（含 dev 依赖）并执行 pytest -q
• acceptance-toolkit 的运行时依赖除了 ASR 相关包外，还包含 python-docx 与 lxml

构建与发布（仅发布 wheel）

统一脚本放在仓库根目录 scripts/：

• macOS / Linux:
  • bash scripts/build.sh
  • bash scripts/publish_pypi.sh
• Windows (PowerShell):
  • powershell -ExecutionPolicy Bypass -File scripts/build.ps1
  • powershell -ExecutionPolicy Bypass -File scripts/publish_pypi.ps1

制品在 dist/（仅 *.whl）。版本号以 pyproject.toml 为准；安装示例中的文件名请按实际构建结果替换。

本地 wheel 安装：

pip install /path/to/razel_py_cli-<version>-py3-none-any.whl

发布前需要先设置 PyPI token（不要写入仓库）：

• macOS / Linux:
  • export UV_PUBLISH_TOKEN="pypi-xxxx"
• Windows PowerShell:
  • $env:UV_PUBLISH_TOKEN="pypi-xxxx"

publish_pypi 脚本会执行 uv publish dist/*.whl（PowerShell 版本等价），只上传 wheel，不上传 sdist。