cargo-coupling - カップリング分析ツール (project)

Rust プロジェクトのカップリング分析を実行します。

基本コマンド

# 基本分析
cargo run -- coupling ./src

# サマリーのみ
cargo run -- coupling --summary ./src

# 日本語出力
cargo run -- coupling --summary --japanese ./src

# AI フレンドリー出力
cargo run -- coupling --ai ./src

# Git 履歴上のヘルス推移
cargo run -- coupling --history ./src
cargo run -- coupling --history=8 --git-months=12 --json ./src

# ベースラインとの差分 / ラチェットゲート
cargo run -- coupling --baseline main ./src
cargo run -- coupling --check --baseline main --fail-on=high ./src

分析オプション

# テストコードを除外
cargo run -- coupling --exclude-tests ./src

# 全ての問題を表示（Low 含む）
cargo run -- coupling --all ./src

# Not Analyzed (blind spots) を全文表示
cargo run -- coupling --blind-spots ./src

# Git 履歴分析をスキップ
cargo run -- coupling --no-git ./src

# 閾値を変更
cargo run -- coupling --max-deps 20 --max-dependents 25 ./src

特定用途コマンド

# ホットスポット（リファクタリング優先度）
cargo run -- coupling --hotspots ./src
cargo run -- coupling --hotspots=10 ./src

# 影響分析
cargo run -- coupling --impact <module> ./src

# 依存関係トレース
cargo run -- coupling --trace <function> ./src

# CI/CD 品質ゲート
cargo run -- coupling --check ./src
cargo run -- coupling --check --min-grade B ./src
cargo run -- coupling --check --baseline main --fail-on=high ./src

出力形式

# JSON 形式
cargo run -- coupling --json ./src

# ファイル出力
cargo run -- coupling -o report.md ./src

Web 可視化

# Web UI 起動
cargo run -- coupling --web ./src

# カスタムポート
cargo run -- coupling --web --port 8080 ./src

# ブラウザ自動起動なし
cargo run -- coupling --web --no-open ./src

設定ファイル

.coupling.toml で設定をカスタマイズ:

[thresholds]
max_dependencies = 15
max_dependents = 20

[analysis]
exclude_tests = true
prelude_modules = ["src/lib.rs", "src/prelude.rs"]
exclude = ["src/generated/*", "src/generated/**"]

[subdomains]
core = ["src/balance.rs", "src/metrics.rs"]
supporting = ["src/analyzer.rs", "src/report.rs", "src/cli_output.rs"]
generic = ["src/config.rs", "src/workspace.rs", "src/web/**"]

[analysis].exclude は .coupling.toml が置かれたディレクトリ基準で評価される。 [subdomains] は core/supporting/generic を分類し、essential volatility と accidental volatility の判定に使われる。実例はリポジトリ直下の .coupling.toml を参照。

オプション一覧

オプション	説明
--summary, -s	サマリーのみ表示
--ai	AI フレンドリー出力
--exclude-tests	テストコード除外
--json	JSON 形式出力
--web	Web UI 起動
--hotspots[=N]	ホットスポット表示
--impact <MODULE>	影響分析
--trace <ITEM>	依存トレース
--history[=N]	Git revision ごとのヘルス推移
--baseline <REF>	ベースラインとの差分
--check	品質ゲートチェック
--fail-on <SEVERITY>	--check 失敗の severity 閾値
--japanese, --jp	日本語出力
--all	Low 含む全問題表示
--blind-spots	Not Analyzed 宣言を全文表示
--no-git	Git 分析スキップ

ヘルスグレード

グレード	意味
A	Well-balanced（優良）
B	Healthy（健全）
C	Needs Attention（要注意）
D	At Risk（リスクあり）
F	Critical（要対応）