Chapter 1-3 Python 코드 포매터 Black 설치 및 설정 가이드

2025. 5. 23. 10:24·Fastapi

🧹 Python 코드 포매터 Black 설치 및 설정 가이드

🧾 Black이란?

  • Black은 **Python 코드 자동 정렬 도구(formatter)**입니다.
  • 수십 명이 협업하는 실무 환경에서 일관된 코드 스타일을 유지하도록 도와주는 중요한 도구입니다.
  • 작성한 코드를 PEP 8 및 자체 포맷 기준에 맞게 자동으로 정리해줍니다.

🔗 공식 깃허브: https://github.com/psf/black


⚙️ 설치 방법

poetry add --group=dev black==24.10.0
  • 개발 환경 전용으로 --group=dev 옵션을 사용
  • 설치 후 pyproject.toml에 자동 등록됨

▶️ Black 실행 방법

  1. 프로젝트 루트 디렉터리에서 실행:
poetry run black .
  1. 포매팅 예시
print("Life is Toooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooo Short")

실행하면 자동으로 줄바꿈되어 가독성 있게 포맷됩니다.


🛠️ Black 설정 (pyproject.toml)

[tool.black]
line-length = 120
  • [tool.black]은 섹션 단위로 설정을 지정합니다.
  • line-length = 120 : 줄 바꿈 기준을 120자로 설정 (요즘 모니터 기준 최적화)

📘 공식문서: https://black.readthedocs.io/en/stable/usage_and_configuration/the_basics.html#configuration-via-a-file


🧑‍💻 PyCharm 연동 팁

  • PyCharm의 Code Style 설정에서 Hard wrap at 120으로 지정하면, IDE 상에서도 동일한 라인 길이 기준으로 줄바꿈이 적용됩니다.

🔁 Recap

  • ✅ black은 협업 시 코드 스타일을 통일시켜주는 필수 도구입니다.
  • ✅ poetry를 이용해 손쉽게 설치 및 그룹별 관리 가능
  • ✅ pyproject.toml 하나로 다양한 설정 통합 가능
  • ✅ line-length 기본값을 120자로 설정해 가독성을 높일 수 있음
  • ✅ 설치 후에는 꼭 git commit을 잊지 말고 기록하세요 🙂

'Fastapi' 카테고리의 다른 글

Chapter 2-1 Pytest 설치 및 단위 테스트 입문 가이드  (0) 2025.05.23
Chapter 1-6 Mypy 설치 및 정적 타입 검사 가이드  (0) 2025.05.23
Chapter 1-5 Git 기본 세팅 및 커밋 가이드  (0) 2025.05.23
Chapter 1-2 Poetry 설치 가이드  (0) 2025.05.23
Chapter 1-1 Meetifyr - 간편한 약속 일정 조율 웹사이트 리뷰  (0) 2025.05.23
'Fastapi' 카테고리의 다른 글
  • Chapter 1-6 Mypy 설치 및 정적 타입 검사 가이드
  • Chapter 1-5 Git 기본 세팅 및 커밋 가이드
  • Chapter 1-2 Poetry 설치 가이드
  • Chapter 1-1 Meetifyr - 간편한 약속 일정 조율 웹사이트 리뷰
Chansman
Chansman
안녕하세요! 코딩을 시작한 지 얼마 되지 않은 초보 개발자 찬스맨입니다. 이 블로그는 제 학습 기록을 남기고, 다양한 코딩 실습을 통해 성장하는 과정을 공유하려고 합니다. 초보자의 눈높이에 맞춘 실습과 팁, 그리고 개발하면서 겪은 어려움과 해결 과정을 솔직하게 풀어내려 합니다. 함께 성장하는 개발자 커뮤니티가 되기를 바랍니다.
  • Chansman
    찬스맨의 프로그래밍 스토리
    Chansman
  • 전체
    오늘
    어제
    • 분류 전체보기 (787)
      • Python (32)
      • 프로젝트 (110)
      • 과제 (25)
      • Database (40)
      • 멘토링 (11)
      • 특강 (37)
      • 기술블로그 (41)
      • 기술블로그-Fastapi편 (33)
      • 기술블로그-Django편 (153)
      • 기술블로그-Flask편 (36)
      • AI 분석 (5)
      • HTML & CSS (31)
      • JavaScript (17)
      • AWS_Cloud (21)
      • 웹스크래핑과 데이터 수집 (14)
      • Flask (42)
      • Django (77)
      • Fastapi (16)
      • 연예 (14)
  • 블로그 메뉴

    • 홈
    • 태그
    • 방명록
  • 링크

  • 공지사항

  • 인기 글

  • 태그

    btscomeback
    btsjungkook
    remittance
    americaparty
    basalcellcarcinoma
    travel ban
    college reunions
    newpoliticalparty
    americanlaw
    global politics
    chatgpterror
    youngprofessionals
    chinanightlife
    livebroadcast
    bts
    RM
    self-growth
    life reflection
    urbantrends
    gpterror
    titaniumcase
    classaction
    trumpmuskclash
    lawsuitculture
    smartphonedurability
    btsreunion
    btsdischarge
    homebartrend
    hotcoffeecase
    뷔
  • 최근 댓글

  • 최근 글

  • hELLO· Designed By정상우.v4.10.3
Chansman
Chapter 1-3 Python 코드 포매터 Black 설치 및 설정 가이드
상단으로

티스토리툴바