스타일에 맞는 배치 계산
YAPF는 clang-format의 접근을 바탕으로 설정한 스타일에 맞는 서식을 계산한다. 들여쓰기와 줄바꿈 같은 배치를 일관되게 다루는 것이 목적이다. 코드의 기능을 새로 작성하거나 결함을 찾는 정적 분석기와는 역할이 다르다.
프로젝트별 형식 설정
미리 정의된 스타일을 선택하거나 설정 파일에서 세부 옵션을 조정할 수 있다. 스타일 파일과 setup.cfg, pyproject.toml 등을 통해 기준을 관리한다. 같은 도구라도 설정이 다르면 출력 형식이 달라지므로 팀에서 공유하는 스타일과 적용 범위를 함께 정하는 방식이다.
변경과 검사 흐름
파일을 직접 수정하는 방식 외에 차이만 출력하는 방식과 특정 줄 범위를 정리하는 기능을 제공한다. 차이가 있는지 종료 상태로 확인해 CI의 서식 검사에 활용할 수 있다. Python API로 문자열이나 파일을 처리하거나 편집기 확장을 통해 작성 과정에 연결하는 방식도 가능하다.
관련 문서
Black 코드 포매터 / Isort / Ruff / Prettier / EditorConfig