#!/usr/bin/env python3 """이번 브랜치가 남긴 빚과 치울 것을 보여 준다(`techdebt` 스킬이 부른다). 아무것도 고치지 않는다. python3 techdebt.py [--base <커밋>] 기준이 없으면 origin/main(없으면 main)과 갈라진 곳 보여 주는 것: diff가 더한 줄의 TODO·건너뛴 테스트·검사 끄기·디버그 출력, 추적하지 않는 파일, 지울 수 있는 worktree, 이미 합쳐진 로컬 브랜치. """ import argparse import re import subprocess import sys MARKERS = [ ("할 일 표시", re.compile(r"\b(TODO|FIXME|XXX|HACK)\b")), ("건너뛴 테스트", re.compile(r"@Disabled\b|\.skip\(|\bx(it|describe)\(|@pytest\.mark\.skip|@unittest\.skip")), ("검사 끄기", re.compile(r"@SuppressWarnings|eslint-disable|@ts-ignore|@ts-expect-error|#\s*noqa|#\s*type:\s*ignore")), ("디버그 출력", re.compile(r"\bconsole\.log\(|System\.out\.println\(|\bdebugger;")), ] MAX_PER_KIND = 20 def git(*args): r = subprocess.run(["git", *args], capture_output=True, text=True) return r.stdout if r.returncode == 0 else "" def default_base(): for ref in ("origin/main", "main", "origin/master", "master"): base = git("merge-base", "HEAD", ref).strip() if base: return base return "" def added_lines(base): """(파일, 줄 번호, 내용): base 이후 더한 줄. 커밋 안 된 변경도 포함한다.""" out, path, line_no = [], None, 0 for line in git("diff", "--unified=0", "--no-color", base).splitlines(): if line.startswith("+++ "): path = line[6:] if line.startswith("+++ b/") else None elif line.startswith("@@"): m = re.search(r"\+(\d+)", line) line_no = int(m.group(1)) if m else 0 elif line.startswith("+") and path: out.append((path, line_no, line[1:])) line_no += 1 return out def main(argv): p = argparse.ArgumentParser() p.add_argument("--base") args = p.parse_args(argv) if not git("rev-parse", "--git-dir"): print("git 저장소가 아니다.", file=sys.stderr) return 1 base = args.base or default_base() if not base: print("기준 커밋을 찾지 못했다. --base로 준다.", file=sys.stderr) return 1 print("기준: %s" % git("log", "-1", "--format=%h %s", base).strip()) found = {label: [] for label, _ in MARKERS} for path, line_no, text in added_lines(base): for label, pattern in MARKERS: if pattern.search(text): found[label].append("%s:%d %s" % (path, line_no, text.strip()[:100])) for label, rows in found.items(): print("\n## %s (%d)" % (label, len(rows))) print("\n".join(rows[:MAX_PER_KIND]) or "없음") if len(rows) > MAX_PER_KIND: print("… %d개 더" % (len(rows) - MAX_PER_KIND)) untracked = git("ls-files", "--others", "--exclude-standard").split() print("\n## 추적하지 않는 파일 (%d)" % len(untracked)) print("\n".join(untracked[:MAX_PER_KIND]) or "없음") prunable = [b for b in git("worktree", "list", "--porcelain").split("\n\n") if "\nprunable" in b] print("\n## 지울 수 있는 worktree (%d)" % len(prunable)) print("\n".join(b.split("\n")[0] for b in prunable) or "없음") current = git("branch", "--show-current").strip() merged = [b.strip(" *+") for b in git("branch", "--merged", base).splitlines()] merged = [b for b in merged if b and b != current and b not in ("main", "master")] print("\n## 기준에 이미 합쳐진 로컬 브랜치 (%d)" % len(merged)) print("\n".join(merged[:MAX_PER_KIND]) or "없음") return 0 if __name__ == "__main__": sys.exit(main(sys.argv[1:]))