google/yapf

어떤 프로젝트인가요?

핵심 기능

• 01pep8이나 google 같은 사전 정의된 스타일 또는 사용자 지정 스타일에 맞게 Python 파일을 재포맷합니다.
• 02설정 파일이나 명령줄에서 수십 가지 스타일 옵션을 조정할 수 있습니다.
• 03파일에서 지정한 줄 범위만 포맷할 수 있습니다.
• 04명령줄 패턴이나 .yapfignore / pyproject.toml을 사용한 제외를 지원합니다.
• 05포맷 변경이 필요할 때 0이 아닌 종료 코드를 반환하는 diff 모드를 제공해 CI 검사에 적합합니다.
• 06명령줄 도구나 Python 라이브러리로 사용할 수 있습니다.

활용 사례

• Python 팀이나 저장소 전체에 일관된 코드 스타일을 적용할 때.
• diff 모드로 CI 파이프라인에 포맷 검사를 추가할 때.
• 에디터 연동에서 패치나 편집으로 변경된 줄만 포맷할 때.
• Python 코드를 생성하거나 변환하는 스크립트에서 스타일 정리를 자동화할 때.

빠른 시작

1. 1

   PyPI에서 YAPF를 설치합니다

   pip install yapf
2. 2

   --diff 또는 --in-place 같은 옵션을 사용해 Python 파일에서 yapf를 실행합니다

사용 전 알아둘 점

• !README에서는 YAPF를 베타 버전으로 설명하며, 릴리스가 자주 변경될 수 있습니다.
• !PEP 695 타입 매개변수 구문과 PEP 701 f-string 형식화 등 일부 최신 Python 기능은 아직 지원하지 않습니다.

포함된 컬렉션

토픽

자주 묻는 질문

yapf은(는) 무엇인가요?

clang-format의 레이아웃 알고리즘을 바탕으로 설정한 스타일에 맞게 Python 소스 파일을 재구성하는 코드 포매터입니다. YAPF는 선택한 스타일에 가장 잘 맞는 레이아웃을 계산해 Python 소스 코드를 포맷하므로, 개발자가 들여쓰기, 공백, 줄바꿈을 일일이 손보는 시간을 줄여 줍니다. clang-format의 재포맷 알고리즘을 기반으로 하며, 명령줄에서 실행하거나 FormatCode 및 FormatFile 함수를 통해 라이브러리로 호출할 수 있습니다.

yapf은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

yapf은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

yapf은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. yapf의 마지막 커밋은 2026년 10월 30일입니다.

yapf은(는) 어디에 사용할 수 있나요?

Python 팀이나 저장소 전체에 일관된 코드 스타일을 적용할 때. diff 모드로 CI 파이프라인에 포맷 검사를 추가할 때. 에디터 연동에서 패치나 편집으로 변경된 줄만 포맷할 때. Python 코드를 생성하거나 변환하는 스크립트에서 스타일 정리를 자동화할 때.

yapf는 어떻게 설치하나요?

PyPI에서 YAPF를 설치합니다: pip install yapf --diff 또는 --in-place 같은 옵션을 사용해 Python 파일에서 yapf를 실행합니다

yapf은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/google/yapf