Pythonプロジェクトの未使用コードを一掃！vultureで始めるコード整理術

uv add vulture --dev

# プロジェクト全体をチェック
uv run vulture src/

# 信頼度60%以上のもののみ表示（推奨）
uv run vulture src/ --min-confidence 60

# 結果をサイズ順でソート（大きなコードから順に表示）
uv run vulture src/ --min-confidence 60 --sort-by-size

src/utils/helpers.py:10: unused variable 'client' (60% confidence)
src/api/endpoints.py:68: unused function 'format_response' (60% confidence)
src/handlers/base.py:214: unused method 'process_data' (60% confidence)

# CI/CDでエラーにしたい場合（高い信頼度のみ）
uv run vulture src/ --min-confidence 80

# 手動レビューで幅広くチェックしたい場合
uv run vulture src/ --min-confidence 60

# 明らかに不要なもの
import unused_module  # どこでも使われていない
client = create_client()  # 作ったけど使ってない

def orphan_function():  # どこからも呼ばれない
    return "Never called"

# 動的ディスパッチで呼ばれるメソッド
class Handler:
    def process_phase_start(self):  # 実際は動的に呼び出される
        pass

# 実際の呼び出し
method_name = f"process_phase_{phase}"
getattr(handler, method_name)()

# TypeDictのフィールド
class ConfigType(TypedDict):
    enabled: bool  # 型定義として必要
    timeout: int

# 「将来使う予定」は削除対象
FUTURE_FEATURE = "not_implemented"

# vulture_whitelist.py
import mymodule.handlers as handlers
import mymodule.types as types

# TypeDictフィールドを明示的に参照
types.ConfigType.enabled  # type: ignore
types.ConfigType.timeout  # type: ignore

# Enum値を参照
handlers.Status.PENDING
handlers.Status.COMPLETED

# 動的ディスパッチメソッドを参照
handlers.Handler.process_phase_start  # type: ignore
handlers.Handler.process_phase_end  # type: ignore

# ホワイトリストを含めて実行
uv run vulture src/ vulture_whitelist.py --min-confidence 60

# PYTHONPATHが必要な場合
PYTHONPATH=src uv run vulture src/ vulture_whitelist.py --min-confidence 60

uv run vulture src/ --min-confidence 60 --ignore-names "process_phase_*

[tool.vulture]
min_confidence = 60
sort_by_size = true
paths = ["src/", "vulture_whitelist.py"]

ignore_names = [
    "process_phase_*",      # 動的呼び出しメソッド
    "_private_*",          # プライベートメソッド
]

exclude = [
    "tests/",
    "*/conftest.py",
    "*/__init__.py",
]

uv run vulture

# 明らかな未使用importから開始
uv run vulture src/ --min-confidence 90 | grep "unused import"

# 次に未使用変数
uv run vulture src/ --min-confidence 60 | grep "unused variable"

# 必ず各段階でテスト実行
uv run pytest && uv run ruff check