구름을 채우다

5장. 데코레이터를 사용한 코드 개선 파이썬의 데코레이터 @modifier def original(...): # ... 데코레이터는 데코레이터 이후에 나오는 것을 데코레이터의 첫 번째 파라미터로 하고 데코레이터의 결과 값을 반환하게 하는 문법적 설탕(syntax sugar)일 뿐이다. ... 예제에서 말하는 modifier는 파이썬 용어로 데코레이터라 하고, original을 데코레이팅된(decorated) 함수 또는 래핑된(wrapped) 객체라 한다. 함수 데코레이터 함수에 데코레이터를 사용하면 어떤 종류의 로직이라도 적용할 수 있다. 파라미터의 유효성을 검사하거나 사전조건을 검사하거나, 기능 전체를 새롭게 정의할 수도 있고, 서명을 변경할 수도 있고, 원래 함수의 결과를 캐시하는 등의 작업을 모두 ..

4장. SOLID 원칙 👉 S: 단일 책임 원칙 👉 O: 개방/폐쇄의 원칙 👉 L: 리스코프(Liskov) 치환 원칙 👉 I: 인터페이스 분리 원칙 👉 D: 의존성 역전 원칙 단일 책임 원칙 (S) 단일 책임 원칙(Single Responsibility Principle - SRP)은 소프트웨어 컴포넌트 (일반적으로 클래스)가 단 하나의 책임을 져야한다는 원칙이다. 클래스가 유일한 책임이 있다는 것은 하나의 구체적인 일을 담당한다는 것을 의미하며, 따라서 변화해야 할 이유는 단 하나뿐이다. 도메인의 문제가 변경되면 클래스를 업데이트해야 한다. 다른 이유로 클래스를 수정해야 한다면 추상화가 잘못되어 클래스에 너무 많은 책임이 있다는 것을 뜻한다. 여기서 말하는 도메인의 문제가 뭘까? 그리고 다른 이유로 클..

3장. 좋은 코드의 일반적인 특징 계약에 의한 디자인 계약에 의한 디자인(Design by Contract)이란 이런 것이다. 관계자가 기대하는 바를 암묵적으로 코드에 삽입하는 대신 양측이 동의하는 계약을 먼저 한 다음, 계약을 어겼을 경우는 명시적으로 왜 계속할 수 없는지 예외를 발생시키라는 것이다. 이 책에서 말하는 계약은 소프트웨어 컴포넌트 간의 통신 중에 반드시 지켜져야 할 몇 가지 규칙을 강제하는 것이다. 계약은 주로 사전조건과 사후조건을 명시하지만 때로는 불변식과 부작용을 기술한다. 여기서 말하는 계약이란 쉽게 말해 docstring과 같은 문서화를 의미한다. 정확한 결과를 보장하기 위해 컴포넌트(함수, 메서드 등) 간 상호작용 중에 반드시 지켜야 할 규칙을 문서화하고, 이를 기반으로 컴포넌트..

2장. 파이썬스러운(Pythonic) 코드 인덱스와 슬라이스 .. 만약 래퍼도 아니고 내장(builtin) 객체를 사용하지도 않은 경우는 자신만의 시퀀스를 구현할 수 있다. 이때는 다음 사항에 유의해야 한다. 👉 범위로 인덱싱하는 결과는 해당 클래스와 같은 타입의 인스턴스여야 한다 👉 slice에 의해 제공된 범위는 파이썬이 하는 것처럼 마지막 요소는 제외해야 한다. 여기서 말하는 시퀀스(sequence)란 기본적으로 list, tuple, range 객체를 의미한다. (이외에 다른 시퀀스 타입도 존재한다.) 컨텍스트 관리자 (Context Manager) 컨텍스트 관리자는 파이썬이 제공하는 유용한 기능이다. 이것이 특별히 유용한 이유는 패턴에 잘 대응되기 때문이다. 이 패턴은 사실상 모든 코드에 적용될..

1장. 코드 포맷팅과 도구 클린 코드의 중요성 코드의 품질을 관리하지 않는다면 결과적으로 기술 부채가 누적되어 실패한 프로젝트가 될 가능성이 높아진다. 클린 코드인지 아닌지는 다른 엔지니어가 코드를 읽고 유지 관리할 수 있는지 여부에 달려있다. 개인적으로 상당히 공감하는 말이다. 클린 코드 판단은 내 코드 리뷰에서도 이루어지는데, 내 코드가 꼼꼼하지 않게 승인돼도 큰 상관이 없다. 리뷰를 받는 코드의 maintainer는 나 자신(=코드 작성자)이기 때문이다. 하지만 대부분의 개발자는 은퇴할 때까지 한 곳에서만 일하지 않기 때문에, 내가 이직을 한다면 내 동료는 내가 작성한 코드를 유지보수해야만 한다. 내가 팀을 떠날 때의 maintainer는 내 동료이며, 내 코드에 대한 평가는 이때에도 이루어진다. ..

Formatter: 코드 스타일을 수정함 (예: spacing, 줄바꿈, 주석 등) Linter: 에러를 찾기 위해 코드를 분석하고, 더 나은 코드 퀄리티를 위한 모범 사례를 제공함 Formatter의 예는 아래와 같다. a = [first_element, second_element, third_element, forth_element, fifth_element, sixth_element] 가 아래와 같이 변경된다. a = [ first_element, second_element, third_element, forth_element, fifth_element, sixth_element ] Linter의 예는 아래와 같다. type(a) is list 가 아래와 같이 변경된다. isinstance(a, l..

얼마전 동료에게 CS(Customer Service) 문의가 들어왔다. A 유저가 투표한 내용이 B 유저에게 노출이 됐다는 것이다. 내가 보기엔 꽤나 흥미롭고 귀찮은 이슈였는데(😭), 동료가 분석한 원인은 다음과 같았다. A가 '홍길동'에게 투표했음 A의 고유 ID는 ABCDE B의 고유 ID는 ABcdE (대소문자만 다름) Django 서버는 DB 설정에 따라서 대소문자를 구별함 (utf8_general_ci) Django ORM filter()를 통해 case-sensitive한 쿼리(__exact__ field lookup)를 보내도, DB에서 case-insensitive하게 처리 DB에서 case-insensitive하게 처리하므로 A와 B는 동일한 사용자로 판단 이는 MySQL의 collati..

네트워크 인터페이스 (Network Interface) 네트워크 인터페이스는 존재할 수 있는 모든 네트워크 어댑터에 대한 지속적 인터페이스를 IP 계층에 제공하기 위해 네트워크 고유 장치 드라이버 및 IP 계층과 통신하는 네트워크 고유 소프트웨어입니다. 또한, 네트워크 인터페이스에는 네트워크 주소가 있습니다. 가상 머신과 마찬가지로 도커 컨테이너 또한 가상 IP를 할당받는데요, 기본적으로 도커는 172.17.0.xxx의 IP 주소를 순차적으로 컨테이너에게 할당합니다. 먼저, 호스트의 네트워크 인터페이스를 살펴보겠습니다. 여기서 우리는 docker0라는 네트워크 인터페이스를 확인할 수 있는데요, docker0는 실제 네트워크 어댑터가 연결되어있지 않은 가상의 리눅스 브릿지로, IP주소 172.17.0.1/..

도전

본 포스트 이후 모든 글은 Ubuntu 18.04를 기준으로 포스팅할 예정이니 참고 바랍니다. 설치 전제조건 (Prerequisites) 도커 엔진을 설치하기 위해서는 다음 우분투 버전 중 64비트 버전이 필요합니다. Ubuntu Focal 20.04 (LTS) Ubuntu Eoan 19.10 Ubuntu Bionic 18.04 (LTS) Ubuntu Xenial 16.04 (LTS) 이전 버전 설치 제거하기 도커의 이전 버전들은 docker, docker.io 또는 docker-engine으로 불립니다. 만약 이 버전들이 설치되어 있다면 삭제하시면 됩니다. $ sudo apt-get remove docker docker-engine docker.io containerd runc 만약 apt-get 명령..