『클린 코드 이제는 파이썬이다』 - 알 스웨이가트

🐍 클린 코드 이제는 파이썬이다 – 읽기 좋고 유지보수 쉬운 파이썬 코드 작성법

“코드는 기계보다 사람을 위해 읽기 쉽게 써라.”

---

1. 읽게 된 계기

파이썬은 문법이 간결하고 배우기 쉬워서 금방 코드를 작성할 수 있습니다.
하지만 프로젝트가 커질수록 코드가 복잡해지고, 읽는 사람 입장에서 혼란스러워지기 마련입니다.
이 책은 ‘클린 코드’의 철학을 파이썬 스타일로 풀어낸 가이드라서 실무 코드 품질을 높이고 싶은 마음에 읽게 됐습니다.

---

2. 핵심 내용

저자 알 스웨이가트는 “좋은 코드는 처음 보는 사람도 이해할 수 있는 코드”라고 강조합니다.
이를 위해 파이썬의 철학(PEP 8, Zen of Python)에 맞춘 구체적인 원칙들을 제시합니다.

📌 주요 클린 코드 원칙 (파이썬 버전)

1. 명확한 네이밍 – 함수와 변수 이름만 보고 역할이 드러나야 함.
2. 작은 함수 – 하나의 함수는 하나의 작업만 하도록.
3. 일관된 스타일 – 공백, 들여쓰기, 줄바꿈 등 시각적 통일성 유지.
4. 표현력 있는 데이터 구조 – dict, namedtuple, dataclass 적극 활용.
5. 중복 제거 – 같은 코드 패턴은 함수나 모듈로 추출.
6. 예외 처리의 명확성 – 오류를 숨기지 말고, 상황별로 정확하게 대응.

---

3. 인상 깊었던 부분

• 파이썬의 언어적 유연성 때문에 오히려 코드 스타일이 제각각이 되는 문제를 해결하려면,
  팀 내 코딩 규칙을 엄격히 합의해야 한다는 조언이 와 닿았습니다.
• “읽기 쉬운 코드가 빠른 코드보다 우선”이라는 점을 계속 강조한 부분이 인상적이었습니다.
  최적화는 필요할 때만, 가독성은 항상.
• list comprehension이나 generator expression을 남용하지 말고, 복잡해지면 일반 for문으로 풀어 쓰라는 실용적인 조언.

---

4. 실무 적용 아이디어

• 프로젝트에 **PEP 8 기반 린터(Flake8, Black)**를 적용해 스타일 자동화.
• 모듈 단위로 명확한 책임 분리 – 한 파일에 너무 많은 기능 넣지 않기.
• 리뷰 시 “이 변수를 보면 역할이 바로 떠오르는가?”라는 질문을 기준으로 네이밍 검토.
• 예외 처리 시 try-except 블록 범위를 최소화하여 오류 원인 추적 쉽게 만들기.

---

5. 읽고 난 소감

이 책은 단순히 파이썬 문법 책이 아니라, 파이썬다운 방식으로 클린 코드를 구현하는 법을 알려줍니다.
클린 코드의 원칙을 이미 알고 있는 개발자라도, 파이썬 특유의 문법과 철학에 맞춘 팁이 많아서 유익합니다.

---

한 줄 평

“파이썬답게, 그리고 사람 친화적으로.”

---

📌 결론

『클린 코드 이제는 파이썬이다』는 초보부터 숙련 개발자까지 모두 읽을 가치가 있는 책입니다.
파이썬 프로젝트의 유지보수성을 높이고 싶다면, 이 책에서 제시하는 원칙들을 팀 규칙에 녹여보길 추천합니다.