OSS探訪GitHubでログイン

Typer製CLIを実行・テスト・自動検査まで揃った構成から作り始める

スコアの見方

OSS規模スコアはStars・Watchers・Forks・Contributorsを対数圧縮して重み付けした現在の規模指標(上限なし)です。発掘スコアは現在のOSS規模スコアから発掘時点のOSS規模スコアを引いた値、更新ペースは直近30日Commit数、成長モメンタムは直近の観測期間におけるOSS規模スコア差、OSS健全度は取得できた更新状況・Community Health・Releaseの0〜100評価です。

Stars
0
主要言語
Python
リポジトリ最終更新
2026/07/20
ページ内ナビ

概要

Python CLI Templateは、Typerでコマンドを実装し、uvで依存関係を固定し、pyテストとRuffで検査する流れをまとめたプロジェクト雛形です。

特徴と向いている用途

公式資料に基づく紹介・実機未検証 · 内容確認日:

主な特徴

コマンド、サブコマンド、テスト、品質検査を一つの雛形にまとめる

Python CLI TemplateはTyperのコマンドとサブコマンド、pytest、Ruff、pre-commit、GitHub Actions、uvのロックファイルを同じ構成に用意します。例のtemplate-cliには挨拶とmail操作があり、引数、選択肢、エラー処理の置き場所を確認できます。

出典:[1][2]

向いている用途

CLIの機能実装へ早く移りたい小規模プロジェクトに向く

配布名、Pythonパッケージ名、実行コマンドを決めた後、共通のlint・整形・テスト・利用文書を一から組み立てずに開発を始めたい場合に向きます。固定コミットではPython 3.14以上とuvを使い、同梱コマンドとテストをローカルで確認できます。

出典:[1][3]

導入前の確認

初期化ワークフローとライセンスの確認を公開前に済ませる

READMEの正式な初期化はGitHub Actionsからパッケージ名とCLI名を書き換え、コミットをプッシュする操作です。評価では固定コミットを直接実行し、実際のプロジェクトでは自分のリポジトリでワークフロー結果を確認してください。GitHubメタデータはライセンスを示さずルートにもライセンスファイルがないため、再配布条件は作者へ確認が必要です。

出典:[1][4]

参考にした公式資料

  1. [1]Python CLI Template README at commit 3739120(2026-10-05)
  2. [2]Template CLI generated usage at commit 3739120(2026-10-05)
  3. [3]Python and dependency requirements at commit 3739120(2026-10-05)
  4. [4]python-cli-template GitHub metadata(2026-10-05)
編集部からの補足

Python CLIのコマンド設計に集中しながら、テスト、lint、利用文書、CIを最初から揃えたい場合に役立つ雛形です。固定コミットを実行して構成を理解し、GitHub Actionsの初期化結果とライセンス条件を確認してから自分のプロジェクトへ採用してください。

3ステップで試す

  1. 1

    固定コミットの雛形を取得して要件を確認する

    Git、Python 3.14以上、uvが必要です。隔離した一時ディレクトリへ雛形を取得し、固定コミットと実行環境を確認します。

    cli_demo_dir=$(mktemp -d "${TMPDIR:-/tmp}/python-cli-template.XXXXXX") && cd "$cli_demo_dir" && git clone https://github.com/st4rfox/python-cli-template.git . && git checkout --detach 37391208b6f971f7fb653ca36bfa4465e9ef7ebc && python3 -c 'import sys;assert sys.version_info>=(3,14)' && uv --version
  2. 2

    依存関係を同期して例のCLIを実行する

    ロックファイルどおりに環境を作り、同梱のtemplate-cliでWorldへの挨拶結果を確認します。

    uv sync --locked && [ "$(uv run template-cli hello --name World)" = 'Hello, World!' ]
  3. 3

    同梱テストを実行する

    同じディレクトリでpytestを実行し、コマンド、オプション、サブコマンドの代表的な振る舞いを検証します。

    uv run pytest -q
公式READMEで確認

成長

成長の推移 · 直近30日

0 Stars

推移データを蓄積中です。

開発アクティビティ

直近90日・週次

Commit(直近30日)
0
Open PR
0

開発アクティビティを蓄積中です。

Built with

カテゴリとタグ

タグ

GitHubデータ

GitHubのデータGitHubの詳細データを見る
Stars
0
Forks
0
Watchers
0
Open Issues
0
Contributors
1
所有者種別
User
主要言語
Python
リポジトリ最終更新
2026/07/20

このOSSの使い方や活用事例をMarkdownで投稿できます。管理者が承認した後に公開されます。

情報の誤りを報告

掲載内容に誤りや古い情報があればお知らせください。

このページを読んで、次に何をすればよいか分かりましたか?
Python CLI Templateとは?Typer製CLIの雛形 | OSS探訪