テンプレート一覧に戻る
Python CLI
Python + Click/Typer + rich のCLIツール開発向けCLAUDE.md。リッチな出力のPython CLIアプリ開発に最適です。
中級pythonclityperrich
CLAUDE.md
# プロジェクト名
Python で構築されたCLIツール。
## 技術スタック
- **言語**: Python 3.12+
- **CLIフレームワーク**: Typer / Click
- **出力**: rich（リッチテキスト出力）
- **パッケージ管理**: uv
- **配布**: PyPI / pipx
## コマンド
| コマンド | 用途 |
|---------|------|
| `uv run python -m mycli` | 直接実行 |
| `uv run pytest` | テスト実行 |
| `uv run ruff check .` | Lint実行 |
| `uv build` | パッケージビルド |
| `pipx install .` | ローカルインストール |
## ディレクトリ構造
| パス | 役割 |
|-----|------|
| `src/mycli/cli.py` | エントリーポイント（Typerアプリ） |
| `src/mycli/commands/` | サブコマンド定義 |
| `src/mycli/lib/` | コアロジック |
| `tests/` | テストコード |
| `pyproject.toml` | プロジェクト設定 |
## コーディング規約
- 型ヒント必須
- Typer callback でサブコマンドを整理
- rich.console で出力フォーマット統一
- 設定ファイルは `~/.config/mycli/` に保存
- 終了コードは0（成功）/1（エラー）を遵守
- `--verbose` / `--quiet` フラグを標準装備
## Git規約
- ブランチ: `feature/`, `fix/`, `chore/`
- コミットメッセージ: Conventional Commits形式