Code Formatter

---

black / isort / mypy / test

• poetry run black .

  • 코드 포맷 자동 정리
    • Python 코드 스타일을 Black 규칙에 맞게 강제로 통일 (코드를 직접 수정함)
    • 공백, 줄바꿈, 따옴표, 줄 길이 등 사람이 신경 쓸 필요 없게 함

• poetry run isort .

  • import 순서 정리 → import 문을 표준 순서로 자동 정렬
  • 사용하지 않는 import 정리 가능(코드를 직접 수정)

• poetry run mypy .

• poetry run dmypy run -- .

  • Python 타입 힌트(: str, -> User 등)를 기준으로 타입 오류를 정적 분석
  • 실행은 안 하고 “논리적으로 맞는지” 검사
  • dmypy는 mypy의 데몬 모드 → 빠름(수정은 X, 에러만 알려줌)

• poetry run coverage run manage.py test

  • 테스트 실행 + 커버리지 측정

    • coverage 요약 보기

      • poetry run coverage report
    • HTML 리포트 생성
      • poetry run coverage html

---

ruff / black / mypy / test

• 1. 린트 및 Import 정리 (자동 수정)

  poetry run ruff check . --fix

  • 린트 회피: # noqa

• 2. 코드 포맷팅 (자동 수정)

  poetry run black .

• 3. 타입 검사

  poetry run mypy .

  • 마이파이 회피: # type: ignore
  • 캐시: rm -rf .mypy_cache

• poetry run coverage run manage.py test

  • 테스트 실행 + 커버리지 측정

    • coverage 요약 보기

      • poetry run coverage report
    • HTML 리포트 생성
      • poetry run coverage html