Koo's tech diary

오픈소스를 분석하다보면 잘 작성된 주석과 독스트링에 고마움을 느끼곤 한다. 잘 설명된 주석과 독스트링이 없었다면, 오픈소스를 분석하는 것에 더 많은 시간을 쏟아야 했을 것이다. 이를 교훈삼아 나도 오픈소스를 개발할 때면, 주석과 독스트링 작성에 더 신경쓰게 되었던 것 같다. 해당 포스팅은 [클린코드, 이제는 파이썬이다] 저서의 일부입니다. 주석 Comment 주석은 다음과 같이 나타낼 수 있다. # comment ''' This is several rows comment. we can explain more '''주석의 특징 코드 행 끝(인라인 주석) 보다는 새로운 행에 독자적으로 작성할 것 적절한 대문자를 포함한 하나의 문장으로 작성할 것 코드와 마찬가지로 행..

수많은 프로그래밍 언어는 저마다 장단점이 있다. 파이썬은 가독성이 쉽고 뭐 내장모듈이 많고 어쩌고... 이렇게들 많이 말하곤 한다. 각 프로그래밍 언어의 강점을 잘 살리고, 약점을 커버할 수 있도록 설계하는 것이 바람직하다고 생각한다. 그렇다면, 파이썬답게(파이써닉하게) 코드를 작성하는 방법은 무엇일까? . 해당 포스팅은 [클린코드, 이제는 파이썬이다] 저서의 일부입니다. 파이썬의 선 (Zen of Python) 파이썬 언어 설계와 프로그램을 위한 20가지 지침이라고 한다. 아래처럼 import this 를 불러오면 볼 수 있다. 이중 몇 가지 재미난 부분에 대해 알아보자 아름다운 것이 흉한거보다 낫다 당연한 사실이다. 파이썬은 중괄호가 사라지고 간결하게 코드를 작성하게 거의 강제하면서, 가독성을 높이고..

보기 좋은 코드로 작성하는 것은 프로그래밍 유지 보수를 도와주는 필수 스킬이다. 초심자는 단순히 기술적 지식을 늘리거나, 코드를 작동하게 하는 것에 의의를 두어 이런 부분을 신경쓰지 않을 수도 있다. 하지만 자신의 코드를 나중에 볼 때, 혹은 남에게 보여주며 도움을 구할 때, 함께 프로그래밍 할 때 등 생각보다 가독성 좋은 코드를 작성해야하는 것은 기술을 구현하는 것만큼 중요하다. 지금부터 파이썬만의 가독성 좋은 클린코드를 작성하는 방법을 알아보자. 해당 포스팅은 [클린코드, 이제는 파이썬이다] 저서의 일부입니다. 용어 정리 Code Formatting : 코드 포매팅, 소스코드에 일련의 규칙을 적용하여 특정 형식을 갖추게 하는 것 Style Guide : 스타일 가이드는 특정 집단에서 일련의 코드 포메..