Repolode
peterjc

peterjc/flake8-black

black 포매터의 검사 모드를 실행하고 포맷 차이를 flake8 BLK 위반으로 보고하는 flake8 플러그인입니다.

스타
167
포크
11
열린 이슈
3
마지막 커밋
3일 전

어떤 프로젝트인가요?

flake8-black은 flake8 린팅 과정에서 black을 검사 모드로 실행하는 flake8 플러그인입니다. black이 다시 포맷할 파일은 모두 BLK100 위반으로 보고하므로, 다른 린트 규칙에 사용하는 것과 같은 flake8 명령으로 black 스타일 검사도 실행할 수 있습니다.

이 플러그인은 하나의 flake8 실행으로 black 포맷 검사와 다른 검사를 함께 수행할 수 있어 git pre-commit 훅과 지속적 통합에 유용합니다. pyproject.toml에서 target_version, skip_string_normalization, line_length 등의 black 설정을 읽고, 공용 설정 파일을 지정하는 --black-config 옵션도 지원합니다. 읽을 수 없는 파일이나 잘못된 TOML 같은 내부 오류는 BLK9xx 코드로 보고합니다.

README에 따르면 이 플러그인은 black의 include 및 exclude 설정을 따르지 않으므로, black에서 제외한 파일은 flake8에서도 제외해야 합니다. black 업데이트로 새로운 BLK100 위반이 생길 수 있으므로 특정 black 버전을 고정하는 것이 좋습니다.

핵심 기능

  • 01black이 다시 포맷할 파일을 flake8 BLK100 위반으로 보고합니다.
  • 02pyproject.toml에서 line_length, target_version 등의 black 설정을 읽습니다.
  • 03공용 설정 파일을 지정하는 --black-config 옵션을 지원합니다.
  • 04읽을 수 없는 파일이나 잘못된 TOML 등의 내부 문제를 BLK9xx 코드로 보고합니다.
  • 05PyPI 또는 conda-forge에서 설치할 수 있습니다.

활용 사례

  • CI에서 다른 flake8 규칙과 함께 black 스타일 검사를 실행합니다.
  • git pre-commit 훅으로 일관된 포맷을 적용합니다.
  • 여러 Python 프로젝트에서 하나의 black 설정을 공유합니다.

빠른 시작

  1. 1

    pip으로 PyPI에서 플러그인을 설치합니다

    pip install flake8-black
  2. 2

    Python 파일에 flake8을 실행해 BLK 코드를 확인합니다

    flake8 example.py

사용 전 알아둘 점

  • black의 include 및 exclude 설정을 따르지 않으므로 해당 파일은 flake8에서 별도로 제외해야 합니다.
  • README에 명시된 것처럼 0.3.7 이후 버전은 black 25.9.0과 호환되지 않습니다. 이를 수정할 v0.4.0은 출시를 기다리는 중입니다.

포함된 컬렉션

토픽

자주 묻는 질문

flake8-black은(는) 무엇인가요?
black 포매터의 검사 모드를 실행하고 포맷 차이를 flake8 BLK 위반으로 보고하는 flake8 플러그인입니다. flake8-black은 flake8 린팅 과정에서 black을 검사 모드로 실행하는 flake8 플러그인입니다. black이 다시 포맷할 파일은 모두 BLK100 위반으로 보고하므로, 다른 린트 규칙에 사용하는 것과 같은 flake8 명령으로 black 스타일 검사도 실행할 수 있습니다.
flake8-black은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
flake8-black은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
flake8-black은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. flake8-black의 마지막 커밋은 2026년 11월 3일입니다.
flake8-black은(는) 어디에 사용할 수 있나요?
CI에서 다른 flake8 규칙과 함께 black 스타일 검사를 실행합니다. git pre-commit 훅으로 일관된 포맷을 적용합니다. 여러 Python 프로젝트에서 하나의 black 설정을 공유합니다.
flake8-black는 어떻게 설치하나요?
pip으로 PyPI에서 플러그인을 설치합니다: pip install flake8-black Python 파일에 flake8을 실행해 BLK 코드를 확인합니다: flake8 example.py
flake8-black은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/peterjc/flake8-black

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트