위키득계정 ↗
기술

Black 코드 포매터

Black 코드 포매터기술
대상 언어
Python
소프트웨어 유형
코드 포매터
스타일 방향
제한된 선택과 일관된 기본값
설정 파일
pyproject TOML
Black은 Python 소스 코드를 일관된 스타일로 다시 정리하는 포매터다. 세부 스타일 선택을 제한해 파일 전체에 공통 규칙을 적용하며 형식 변경 전후의 추상 구문 트리를 비교하는 검사를 기본으로 수행한다.

파일 전체의 형식 정리

이전의 세부적인 줄 배치보다 정해진 스타일을 기준으로 파일 전체를 정리한다. 프로젝트마다 형식을 논의하는 부담을 줄이고 일정한 표현을 만드는 것이 목적이다. 프로그램의 동작을 검사하는 테스트와는 역할이 다르다.

변경 전후의 구문 검사

기본 모드에서는 정리한 코드가 유효한 추상 구문 트리를 만들고 원래 코드와 실질적으로 같은지 확인한다. 이 확인은 형식 정리의 안전 장치이며 빠른 모드에서 생략할 수 있다. 검사 방식과 단순 실행 속도의 선택이 나뉘어 있다.

프로젝트와 도구의 연결

파일이나 디렉터리를 대상으로 실행하고 pyproject 파일에서 기본 옵션과 포함 및 제외 조건을 설정할 수 있다. Jupyter 노트북 지원도 선택 기능으로 제공한다. 코드 스타일은 안정성 정책에 따라 관리되어 도구 변경과 형식 변경의 관계를 구분한다.

관련 문서

Ruff / Rustfmt / Mypy / Pyright / Python / 소프트웨어