inpoxia-tools

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Inpoxia Tooling Workflow

Inpoxia 工具工作流

Run Inpoxia repo tasks with consistent commands and validation gates.
使用一致的命令和验证环节运行Inpoxia仓库任务。

Quick Start

快速开始

  1. Detect task type: CLI behavior, GraphMail library behavior, configuration/auth flow, or packaging/release.
  2. Run the narrowest command that validates the change first (single test module or targeted command).
  3. Run broader checks before finishing: tests plus static checks relevant to changed files.
  4. Report exact commands executed and key results.
  1. 检测任务类型:CLI行为、GraphMail库行为、配置/认证流程,或打包/发布。
  2. 首先运行最精准的命令来验证变更(单个测试模块或目标命令)。
  3. 在完成前运行更全面的检查:针对变更文件的测试及相关静态检查。
  4. 报告执行的具体命令和关键结果。

Use Repo Commands

使用仓库命令

Use
uv
-managed tools in this repo.
  • Run tests:
    pytest
  • Run targeted tests:
    pytest tests/inpoxia/test_cli_messages.py -q
  • Run type checks:
    pyright
  • Run lint checks:
    ruff check .
  • Run formatting:
    ruff format .
  • Run CLI locally:
    ./.venv/bin/inpoxia --help
Prefer targeted test selection first, then expand scope as confidence increases.
使用本仓库中由
uv
管理的工具。
  • 运行测试:
    pytest
  • 运行目标测试:
    pytest tests/inpoxia/test_cli_messages.py -q
  • 运行类型检查:
    pyright
  • 运行代码检查:
    ruff check .
  • 运行格式化:
    ruff format .
  • 本地运行CLI:
    ./.venv/bin/inpoxia --help
优先选择目标测试,随着信心提升再扩大范围。

Validate By Change Type

根据变更类型进行验证

CLI command/output changes (
src/inpoxia/cli/**
)

CLI命令/输出变更(
src/inpoxia/cli/**

  1. Run the relevant CLI test module under
    tests/inpoxia/
    .
  2. Run related GraphMail tests if the command calls
    inpoxia.graphmail
    .
  3. Run
    ruff check .
    and
    pyright
    .
  1. 运行
    tests/inpoxia/
    下对应的CLI测试模块。
  2. 如果命令调用了
    inpoxia.graphmail
    ,运行相关的GraphMail测试。
  3. 运行
    ruff check .
    pyright

GraphMail library changes (
src/inpoxia/graphmail/**
)

GraphMail库变更(
src/inpoxia/graphmail/**

  1. Run matching tests under
    tests/inpoxia/graphmail/
    .
  2. Run full
    tests/inpoxia/graphmail/
    suite when behavior contracts change.
  3. Run
    pyright
    and
    ruff check .
    .
  1. 运行
    tests/inpoxia/graphmail/
    下的匹配测试。
  2. 当行为契约变更时,运行完整的
    tests/inpoxia/graphmail/
    测试套件。
  3. 运行
    pyright
    ruff check .

Config/auth/token handling changes

配置/认证/令牌处理变更

  1. Run
    tests/inpoxia/test_config*.py
    ,
    tests/inpoxia/test_cli_auth.py
    , and
    tests/inpoxia/test_auth_manager.py
    as applicable.
  2. Confirm token resolution order and error handling behavior remain consistent.
  1. 根据情况运行
    tests/inpoxia/test_config*.py
    tests/inpoxia/test_cli_auth.py
    tests/inpoxia/test_auth_manager.py
  2. 确认令牌解析顺序和错误处理行为保持一致。

Use References

使用参考文档

Read
references/command-recipes.md
for a compact command map and task-to-test routing.
阅读
references/command-recipes.md
以获取简洁的命令映射表和任务到测试的路由指南。