본문 바로가기

클린코드/클린코드 애장일 소프트웨어 장인 정신

(3)
클린코드 4장 주석 우리는 코드로 의도를 표현하지 못해, 그러니깐 실패를 만회하기 위해 주석을 사용한다. 주석을 달 때마다 자신에게 표현력이 없다는 사실을 푸념해야 마땅하다. 프로그래머들이 주석을 엄격하게 관리해야 한다고 그래서 복구성과 관련성과 정확성이 언제나 높아야 한다. 애초에 주석이 필요 없는 방향으로 에너지를 쏟는편이 낫다. 진실은 한곳에만 존재한다. 바로 코드다. 코드만이 자기가 히는일을 진실되게 말한다. 주석을 넣을때는 반드시 필요한경우 코드로만으로 설명이 되지 않는 부분만 넣도록 한다.
클린코드 5장 형식맞추기 프로그래머라면 형식을 깔끔하게 맞춰 코드를 짜야한다. 코드 형식을 맞추기 위한 간단한 규칙을 정하고 그 규칙을 따라야 한다. 팀으로 일한다면 팀이 합의해 규칙을 정하고 따라야한다. 필요하다면 규칙을 자동으로 적용하는 도구를 활용한다. 코드가 바뀌어도 맨처음 잡아놓은 구현 스타일과 가독성 수준은 유지보수와 확정성에 영향을 끼치기에 중요하다. 대표 프로젝트 junit, fitnesse 등도 500줄을 넘지않고 200줄 정도의 파일로도(한 클래스의 코드수) 커다란 시스템을 구축할 수 있다!!!. 일반적으로 큰 파일보다 작은 파일이 이해하기 쉽다. 신문을 읽을때 독자는 위에서 아래로 읽는다. 최상단에 기사를 몇마디로 요약하는 표제가 나온다. 독자는 표제르 ㄹ보고서 기사를 읽을지 말지 결정한다. 첫문단은 전체 기..
클린코드 9장 "단위 테스트" 정리 TDD 법칙 세가지 1. 실패하는 단위 테스트를 작성할 때까지 실제 코드를 작성하지 않는다. 2. 컴파일은 실패하지 않으면서 실행이 실패하는 정도로만 단위 테스트를 작성한다. 3. 현재 실패하는 테스트를 통과할 정도로만 실제 코드를 작성한다. 테스트가 체계적으로 작성되어 있지 않으면 코드 변경이 두려워지고 유연성이 떨어질뿐 아니라 코드 변경은 잠정적인 에러발생을 유발하므로 체계적인 깨끗한 테스트코드 작성은 꼭 필요하다. 이를 위해 Build-Operate-Check 패턴이 테스트 구조에 적합하여 적용된다. 각 테스트는 명확히 세 부분으로 나눠진다. 첫부분은 테스트 자료를 만든다. 두번째 부분은 테스트 자료를 조작하며, 세번째 부분은 조작한 결과가 올바른지 확인한다. 잡다하고 세세한 코드는 모두 없애고 코..