프로젝트 소개

Black은 Python Software Foundation이 유지 관리하는 의견이 강한 Python 코드 포매터입니다. 명시된 목표는 단일かつ 일관된 스타일을 적용하여 손 포맷팅에 대한 논쟁을 종식시키는 것입니다: 사용자는 속도, 결정성, 스타일 체커 불만으로부터 자유로움을 얻기 위해 포맷팅 세부 사항에 대한 통제권을 양도합니다. README에 설명된 주요 특징: - 이전 포맷팅을 무시하고(문서화된 실용적 예외를 제외하고) 전체 파일을 제자리에서 재포맷합니다. - 의도적으로 제한된 구성 옵션; 합리적인 기본값이 강조되며, 프로젝트 설정은 pyproject.toml에서 읽을 수 있습니다(예: include/exclude 패턴). - 가능한 가장 작은 diffs를 생성하는 것을 목표로 하며, 프로젝트는これが 코드 리뷰를 더 빠르게 만든다고 말합니다. - 재포맷된 코드가 여전히 원본과 효과적으로 동등한 유효한 AST를 생성하는지 확인하는 안전 검사가 포함되어 있으며, --fast 플래그는 이 검사를 건너뜁니다. - PEP 8 준수와 스타일 변경을 규율하는 안정성 정책을 주장합니다. 설치 및 사용: - pip install black을 통해 설치할 수 있으며, Python 3.10 이상이 필요합니다. - Jupyter Notebook 포맷팅은 black[jupyter] extra를 통해 제공됩니다. - Python 설치가 없는 사용자를 위해 GitHub 릴리스에서 PyInstaller로 빌드된 독립 실행형 실행 파일이 제공됩니다. - black {source_file_or_directory} 또는 python -m black {source_file_or_directory} 로 실행할 수 있습니다. 생태계 및 채택: README에는 pytest, tox, Pyramid, Django, Django Channels, Hypothesis, attrs, SQLAlchemy, Poetry, PyPA 애플리케이션, pandas, Pillow, Twisted, LocalStack, Home Assistant, Zulip, Kedro 등을 사용하는 많은 오픈소스 프로젝트가 나열되어 있습니다. 또한 Dropbox, Lyft, Mozilla, Quora, Duolingo, Tesla 등을 사용자 조직으로 명시하고 있습니다. 개발자 Mike Bayer, Hynek Schlawack, Kenneth Reitz, Carl Meyer 등의 추천사가 인용되어 있습니다. 이 프로젝트는 MIT 라이선스이며, ReadTheDocs에서 문서를 제공하고, 별도의 파일에 변경 로그와 저자 목록을 유지하며, 기여 문서와 Discord 채널을 통해 기여를 초대합니다. 또한 Python Community Code of Conduct를 참조합니다.