OpenStack 스타일 가이드에 맞춰 Python 코드를 검사하는 flake8 플러그인 모음입니다.
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
pip으로 PyPI에서 플러그인을 설치합니다
pip install flake8-black - 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 통계는 매일 갱신됩니다.
관련 프로젝트
PEP 257 규약에 맞게 docstring을 자동으로 다시 포맷하는 Python CLI 도구입니다.
PyFlakes, pycodestyle, McCabe를 하나의 명령으로 실행하고 서드파티 플러그인을 지원하는 Python 린터입니다.
여러 프로젝트의 공통 설정을 검사하고 설정 파일을 자동으로 수정하는 CLI 도구이자 flake8 플러그인입니다.
선택한 스타일 가이드에 따라 Python import의 그룹과 순서를 검사하는 flake8 및 Pylama 플러그인입니다.
Jupyter Notebook에서 ruff, isort, black, mypy, flake8 같은 Python 린터와 포매터를 바로 실행하는 CLI 도구입니다.