Leon's Tech blog

개발자는 왜 유닛 테스트를 작성 해야 하는가?

Wed, 25 Mar 2020 13:00:00 GMT

무엇을 개발해야 하는지 이해하는데 도움이 된다 (Understand what to build)

개발자가 무엇을 개발해야 하는지 정할 때 여러사람들(도메인 전문가, QA, 디자이너, 아키텍트, 사용자 등)과 협업을 한다.

단위 테스트를 작성하면 비즈니스 규칙(도메인 지식)을 좀더 명확히 할 수 있다.

코드로 명시적으로 표현하기 때문에 2가지 이점이 생긴다.

첫번째는 관계자들과 명확한 의사소통을 할 수 있다.

두번째는 명확히 하는 과정에서 고려하지 못한 사항도 알게 된다.

문서화되는 단위 기능 (Document the units)

개발자 사이에 의사소통도 명확해진다. 단위 테스트 자체가 해당 단위의 API 사용법이 예제가 되기 때문이다.

이로 인해 2가지 이점이 생긴다.

첫째 해당 기능의 개발자의 개발 의도를 이해할 수 있게 된다.

둘째 타 개발자들도 이 예제를 통해 단위 기능의 사용법을 알게 된다.

단위 설계 (Design the units)

유닛 테스트는 테스트 가능한 단위로 분리하게 된다.

결과적으로 분리된 단위 만큼 낮은 결합도와 높은 응집력(Loose coupling & High Cohesion) 을 가진 설계구조로 가게 된다.

또한 유닛 테스트는 개발자가 인터페이스(함수 이름, 함수 시그니쳐)와 구현을 분리하여 설계를 고민하게 한다.

유닛 테스트를 작성하면서 자연스럽게 해당 단위 기능의 인터페이스를 호출하는 입장에서 작성하게 되기 때문이다.

회귀 보호(Regression protection)

회귀 테스트(Regression test)란 회귀 버그를 찾는 소프트웨어 테스트 방식이다. 그리고 회귀 버그는 이전에 제대로 작동하던 소프트웨어 기능에 문제가 생기는 것을 가리킨다.

즉 개발하면서 추가/변경된 사항이 영향을 미쳐서 원래 기능에 없던 버그가 생기는 것을 말한다.

기존 단위 테스트 들을 추가/변경 개발후에 테스트 함으로 회귀 버그가 생기는지 인지할 수 있다.

즉 변경의 영향을 단위 테스트로 알아낼 수 있고 변경후 다른 기능들이 문제가 없음을 보증할수 있는 수단이 된다.

회귀 보호는 기존 시스템이 복잡할 수록 더 필요하며, 기존 시스템의 품질을 유지하는데 유용하다.

10만명의 유저가 될때까지 백엔드 인프라 확장하기

Mon, 10 Feb 2020 12:00:00 GMT

이 글은 원문 Scaling to 100k Users(https://alexpareto.com/scalability/systems/2020/02/03/scaling-100k.html) 원 저자인 Alex Pareto 의 동의 하에 번역하였음을 알려드립니다.

많은 스타트업이 있습니다. 수많은 신규 사용자가 매일 계정에 쉴세없이 등록하는 것처럼 느껴지고 엔지니어링 팀은 인프라가 지속적으로 유지하기 위해 분투합니다.

행복한 고민이지만 0 에서 수십만 명의 사용자를 받는 웹앱을 구현하는 정보가 부족할 수 있습니다.

일반적으로 솔루션은 갑자기 발생한 집중된 트래픽이나 병목현상을 찾아내는 것에서(종종 두가지 모두) 얻게 됩니다.

그렇긴 하지만 저는 확장성이 높은 사이드 프로젝트를 수행하면서 주요 패턴 중 상당수가 비교적 정형회되어 있다는 것을 알게 되었습니다.

이 글은 그 공식의 기본을 글로 만들기 위한 시도입니다. 이제 우리는 새로운 사진 공유 웹 사이트인 Graminsta를 1명에서 10만명의 사용자로 만들 것입니다.

1 사용자: 1개 머신

거의 모든 에플리케이션(즉 웹 사이트 또는 모바일 응용 프로그램)은 API, 데이터베이스, 클라이언트(일반적으로 응용 프로그램 또는 웹 사이트)의 세 가지 주요 구성 요소가 있습니다.

최신 에플리케이션 개발에서 클라이언트를 API 와 완전히 별도의 개체로 생각하면 응용 프로그램 확장에 대한 추론이 훨씬 쉬워진다는 것²을 알았습니다.

처음으로 에플리케이션을 빌드 할 때 이 3가지가 모두 하나의 서버에서 실행되는 것이 좋습니다. 어떤면에서 이것은 개발 환경과 비슷합니다. 한 엔지니어가 데이터베이스, API 및 클라이언트를 모두 같은 컴퓨터에서 실행합니다.

이론적으로는 아래와 같이 단일 DigitalOcean Droplet 또는 AWS EC2 인스턴스의 클라우드에 이를 배포 할 수 있습니다:

따라서 Graminsta를 한 사람 이상이 사용할 것으로 예상되는 경우 거의 항상 데이터베이스 계층을 분리하는 것이 좋습니다.

10 명의 사용자 : 데이터베이스 계층 분리

데이터베이스를 Amazon RDS 또는 Digital Ocean의 Managed Database와 같은 관리형 서비스로 분리하면 오랫동안 우리에게 도움이 될 것입니다.

단일머신 또는 EC2 인스턴스에서 자체 호스팅보다 약간 비싸지만 이러한 서비스를 사용하면 즉시 사용 가능한 많은 추가 기능을 즉시 사용할 수 있습니다.

멀티 리전 중복성, 읽기 전용 복제본, 자동 백업 등

Graminsta 시스템의 모습은 다음과 같습니다:

100 명의 사용자 : 클라이언트 분리

운 좋게도 처음 몇 명의 사용자는 Graminsta를 좋아합니다. 이제 트래픽이 더욱 안정적으로 시작되었으므로 이제 고객을 분리해야합니다. 한 가지 주목할 점은 엔티티를 분리하는 것이 확장 가능한 응용 프로그램을 빌드하는 데 있어 핵심적인 요소라는 것입니다. 시스템의 한 부분이 더 많은 트래픽을 얻으면 자체 트래픽 패턴을 기반으로 서비스 확장을 처리 할 수 있도록 분할 할 수 있습니다.

이것이 제가 클라이언트를 API와 분리 된 것으로 생각하는 이유입니다. 웹, 모바일 웹, iOS, Android, 데스크톱 앱, 타사 서비스 등 여러 플랫폼을 구축하는 데 있어 추론하기가 매우 쉽습니다². 모두 동일한 API를 사용하는 클라이언트 일 뿐입니다.

같은 맥락에서 사용자로부터 얻는 가장 큰 피드백은 Graminsta를 휴대 전화에서 원한다는 것입니다. 따라서 모바일 앱을 사용하는 동안 모바일 앱을 시작하겠습니다.

시스템의 모습은 다음과 같습니다:

1,000 명의 사용자 : 로드 밸런서 추가

Graminsta의 상황이 호전되고 있습니다. 사용자가 사진을 어디서든지 업로드하고 있습니다. 더 많은 가입을 시작하고 있습니다. 외로운 API 인스턴스가 모든 트래픽을 유지하는 데 문제가 있습니다. 더 많은 컴퓨팅 파워가 필요합니다!

로드 밸런서는 매우 강력합니다. 핵심 아이디어는 API 앞에로드 밸런서를 배치하고 트래픽을 해당 서비스의 인스턴스로 라우팅한다는 것입니다. 이를 통해 수평적 확장이 가능합니다 (동일한 코드를 실행하는 서버를 더 추가하여 처리 할 수있는 요청량 증가).

우리는 웹 클라이언트와 API 앞에 별도의 로드 밸런서를 배치 할 것입니다. 즉, API 및 웹 클라이언트 코드를 실행하는 인스턴스가 여러 개 있을 수 있습니다. 로드 밸런서는 트래픽이 가장 적은 인스턴스로 요청을 라우팅합니다.

이것으로부터 우리가 얻는 것은 이중화입니다. 한 인스턴스가 다운되면 (오버로드 또는 충돌이 발생하더라도) 전체 시스템이 중단되는 대신 들어오는 요청에 응답 할 수있는 다른 인스턴스가 있습니다.

로드 밸런서는 또한 자동 확장을 가능하게 합니다. 모든 사용자가 온라인 상태인 슈퍼볼 기간 동안 인스턴스 수를 늘리고 모든 사용자가 잠들 때 인스턴스 수를 줄이도록 로드 밸런서를 설정할 수 있습니다.

로드 밸런서를 사용하면 API 계층이 실질적으로 무한대로 확장 될 수 있으므로 더 많은 요청을 받을 때 인스턴스를 계속 추가 할 수 있습니다.

참고 사항 : 지금까지 우리가 보유한 것은 Heroku 또는 AWS의 Elastic Beanstalk과 같은 PaaS 회사가 기본적으로 제공하는 것과 매우 유사합니다(인기가 높은 이유). Heroku는 데이터베이스를 별도의 호스트에 배치하고 자동 확장으로 로드 밸런서를 관리하며 API와 별도로 웹 클라이언트를 호스팅 할 수 있습니다. 이것은 프로젝트 또는 초기 단계의 스타트업에 Heroku와 같은 서비스를 사용하는 좋은 이유입니다. 필요한 모든 기본 사항이 기본적으로 제공됩니다.

10,000 사용자 : CDN

처음부터 이렇게 했어야 했는데, 그러나 Graminsta에서 빠르게 이동하고 있습니다. 이 모든 이미지를 제공하고 업로드하면 서버에 너무 많은 부하가 걸리기 시작합니다.

이 시점에서 이미지, 비디오 등을 생각하는(AWS의 S3 또는 Digital Ocean’s Spaces) 정적 콘텐츠를 호스팅하기 위해 클라우드 스토리지 서비스를 사용해야 합니다. 일반적으로 API는 이미지 및 이미지 업로드와 같은 작업을 처리하지 않아야 합니다.

우리가 클라우드 스토리지 서비스에서 얻는 또 다른 것은 CDN입니다(AWS에서는 이것이 Cloudfront라는 추가 기능이지만 많은 클라우드 스토리지 서비스가 즉시 제공합니다). CDN은 전 세계의 다른 데이터 센터에 이미지를 자동으로 캐시합니다.

주요 데이터 센터가 오하이오에서 호스팅 될 수 있지만 누군가 일본에서 이미지를 요청하면 클라우드 제공 업체가 사본을 만들어 일본의 데이터 센터에 저장합니다. 다음으로 일본에서 이미지를 요청한 사람은 이미지를 훨씬 더 빨리받습니다. 이는 전 세계에 적제 및 전송하는 데 오랜 시간이 걸리는 이미지 또는 비디오와 같은 더 큰 파일 크기를 제공해야 할 때 중요합니다.

100,000 명의 사용자 : 데이터 계층 확장

CDN은 우리에게 많은 도움을 주었습니다. Graminsta에서 많은 일들이 일어나고 있습니다. YouTube 유명인사인 Mavid Mobrick이 방금 가입하여 이야기를 게시했습니다. 환경에 10개의 API 인스턴스를 추가하는 로드 밸런서 덕분에 API CPU 및 메모리 사용량이 전반적으로 낮습니다. 그러나 요청에 대해 많은 시간 초과가 발생하기 시작했습니다. 왜 모든 요청이 오래 걸리는걸까요?

좀 더 자세히 조사해보면 데이터베이스 CPU가 80~90% 로 차 있습니다. 우리는 최대 한도를 초과했습니다.

데이터 계층의 스케일링은 아마도 방정식의 가장 까다로운 부분 일 것입니다. 상태 비 저장 요청을 처리하는 API 서버의 경우 인스턴스를 더 추가 할 수 있지만 대부분의 데이터베이스 시스템에서는 동일하지 않습니다. 이 경우 널리 사용되는 관계형 데이터베이스 시스템 (PostgreSQL, MySQL 등)을 살펴 보겠습니다.

캐싱

데이터베이스를 최대한 활용하는 가장 쉬운 방법 중 하나는 시스템에 새로운 구성 요소 인 캐시 계층을 도입하는 것입니다. 캐시를 구현하는 가장 일반적인 방법은 Redis 또는 Memcached와 같은 메모리 내 키 값 저장소를 사용하는 것입니다. 대부분의 클라우드에는 AWS의 Elasticache 및 Google Cloud의 Memorystore와 같은 관리 서비스 버전이 있습니다.

서비스가 동일한 정보에 대해 데이터베이스를 반복적으로 많이 호출 할 때 캐시가 유용합니다. 기본적으로 데이터베이스를 한 번 누르고 캐시에 정보를 저장하며 데이터베이스를 다시 만질 필요가 없습니다.

예를 들어 Graminsta에서 누군가가 Mavid Mobrick의 프로필 페이지를 방문 할 때마다 API 계층은 데이터베이스에서 Mavid Mobrick의 프로필 정보를 요청합니다. 이것은 계속해서 또 다시 일어나고 있습니다. Mavid Mobrick의 프로필 정보는 모든 요청에 따라 변경되지 않으므로 해당 정보는 캐시에 적합합니다.

Redis의 데이터베이스 결과를 키 user : id 아래에 만료 시간 30 초로 캐시합니다. 이제 누군가 Mavid Mobrick의 프로필을 방문하면 Redis를 먼저 확인하고 Redis에서 데이터를 제공합니다. Mavid Mobrick이 사이트에서 가장 인기가 있지만 프로파일을 요청하면 데이터베이스에 거의 부하가 걸리지 않습니다.

대부분의 캐시 서비스의 또 다른 장점은 데이터베이스보다 쉽게 확장 할 수 있다는 것입니다. Redis에는 로드 밸런서¹와 유사한 방식으로 Redis 클러스터 모드가 내장되어있어 Redis 캐시를 여러 머신 (수천 대의 경우 수천 대)에 분산시킬 수 있습니다.

거의 모든 고도로 확장 된 응용 프로그램은 캐싱을 충분히 활용하므로 빠른 API를 만드는 데 절대적으로 필요한 부분입니다. 더 나은 쿼리와 성능이 좋은 코드는 모두 방정식의 일부이지만 캐시가 없으면 수백만 명의 사용자로 확장하기에 충분하지 않습니다.

읽기 전용 복제본

우리 데이터베이스가 꽤 많은 타격을 받기 시작한 지금 우리가 할 수있는 또 다른 일은 데이터베이스 관리 시스템을 사용하여 읽기 복제본을 추가하는 것입니다. 위의 관리 서비스를 사용하면 한 번의 클릭으로 수행 할 수 있습니다. 읽기 전용 복제본은 마스터 DB를 최신 상태로 유지하며 SELECT 문에 사용될 수 있습니다.

시스템은 다음과 같습니다:

그 이후에

앱이 계속 확장됨에 따라 독립적으로 확장 할 수있는 서비스를 분할하는 데 집중하려고 합니다. 예를 들어, 웹 소켓을 사용하기 시작하면 웹 소켓 처리 코드를 꺼내는 것이 좋습니다. 우리는 HTTP 로드 수에 관계없이 개방 또는 폐쇄 된 웹 소켓 연결 수에 따라 확장 및 축소 할 수 있는 자체 로드밸런서 뒤에 새로운 안정성을 제공 할 수 있습니다.

또한 데이터 계층의 한계에 부딪 치려고 계속 노력할 것입니다. 데이터베이스를 분할하고 샤딩하기 시작하려고 할 때입니다. 이 두 가지 모두 더 많은 오버 헤드가 필요하지만 효과적으로 데이터 계층을 무한대로 확장 할 수 있습니다.

New Relic 또는 Datadog 와 같은 서비스를 사용하여 모니터링을 설치했는지 확인하려고 합니다. 이를 통해 요청이 느리고 개선이 필요한 부분을 이해할 수 있습니다. 규모를 확장 할 때 종종 이전 섹션의 일부 아이디어를 활용하여 병목 현상을 찾아 수정하는 데 집중하려고 합니다.

이 시점에서 우리는 팀에 도움을 줄 다른 사람들도 있습니다!

참고 문헌 :

이 게시물은 High Scalability에 대해 제가 가장 좋아하는 게시물 중 하나에서 영감을 받았습니다. 나는 위의 게시물에 초기 단계의 내용을 조금 더 풍부하게 하고 클라우드에 구애받지 않기를 원했습니다. 이런 것들에 관심이 있다면 꼭 확인하십시오.

각주

여러 인스턴스에 로드를 분산시킬 수 있다는 점에서 비슷하지만 Redis Cluster의 기본 구현은 로드 밸런서와 크게 다릅니다.
↩
프로그래밍의 관용적 표현
↩

Linux 에서 사용자의 그룹확인 및 특정 그룹에 추가

Wed, 15 Jan 2020 12:00:00 GMT

현재 로그인한 사용자가 속한 그룹 확인

$ groups
ubuntu adm dialout cdrom floppy sudo audio dip video plugdev lxd netdev

특정 사용자 그룹 확인(예 : tomcat)

$ groups tomcat
tomcat : tomcat sudo

leonkim 사용자를 wheel 그룹에 추가할 때

대부분 sudo권한이 있는 user가 입력 가능함.

$ sudo gpasswd -a leonkim wheel
Adding user leonkim to group wheel

leonkim 사용자를 wheel 그룹에 뺄때

$ sudo gpasswd -d leonkim wheel
Removing user leonkim from group wheel

AWS EC2 디스크 용량 늘리기

Mon, 13 Jan 2020 15:30:15 GMT

가끔 운영중인 EC2의 디스크가 부족해 디스크 용량을 늘려야 할 경우가 생긴다.

디스크 용량을 늘리는 방법은 생각보다 손쉬웠는데 EC2 를 stop 시키지 않아도 되었다.

그 방법을 정리해 보았다.

AWS 콘솔 설정

AWS console에 접속 > EC2 서비스 이동

EC2 인스턴스를 선택후 detail 탭의 Root device 를 선택. EBS_ID 링크로 EBS 콘솔 화면으로 이동

해당되는 EBS 선택된 상태로 ‘Modify Volume’ 을 선택

원하는 디스크 사이즈 입력하고 Modify 버튼 클릭

물리적 디스크 용량은 늘어나지만 여기가 끝이 아님.

파티션 설정

ssh 로 들어가서 df로 확인해보면 하드디스크 용량은 아직 늘지 않았다.

$ df -hT
Filesystem     Type      Size  Used Avail Use% Mounted on
udev           devtmpfs  1.9G     0  1.9G   0% /dev
tmpfs          tmpfs     390M  772K  389M   1% /run
/dev/nvme0n1p1 ext4       15G   13G  1.8G  89% /
tmpfs          tmpfs     2.0G     0  2.0G   0% /dev/shm
tmpfs          tmpfs     5.0M     0  5.0M   0% /run/lock
tmpfs          tmpfs     2.0G     0  2.0G   0% /sys/fs/cgroup
/dev/loop0     squashfs   90M   90M     0 100% /snap/core/7713
/dev/loop1     squashfs   18M   18M     0 100% /snap/amazon-ssm-agent/1480
/dev/loop2     squashfs   90M   90M     0 100% /snap/core/8268
tmpfs          tmpfs     390M     0  390M   0% /run/user/1000

파티션 설정이 되어 있지 않아 늘어난 볼륨이 반영 되어 있지 않기 때문이다.

$ lsblk
NAME        MAJ:MIN RM  SIZE RO TYPE MOUNTPOINT
loop0         7:0    0   89M  1 loop /snap/core/7713
loop1         7:1    0   18M  1 loop /snap/amazon-ssm-agent/1480
loop2         7:2    0 89.1M  1 loop /snap/core/8268
nvme0n1     259:0    0   50G  0 disk
└─nvme0n1p1 259:1    0   15G  0 part /

위의 명령어로 확인해보면 50G 로 늘어난 것은 보이지만 실제 /(루트)에는 15G 밖에 할당되어 있지 않음

파티션 설정을 해보자.

Linux 파티션 크기 조정

$ sudo growpart /dev/nvme0n1 1
CHANGED: partition=1 start=2048 old: size=31455199 end=31457247 new: size=104855519,end=104857567

파티션이 적용되어 있는지 확인해보면

$ lsblk
NAME        MAJ:MIN RM  SIZE RO TYPE MOUNTPOINT
loop0         7:0    0   89M  1 loop /snap/core/7713
loop1         7:1    0   18M  1 loop /snap/amazon-ssm-agent/1480
loop2         7:2    0 89.1M  1 loop /snap/core/8268
nvme0n1     259:0    0   50G  0 disk
└─nvme0n1p1 259:1    0   50G  0 part /

늘어난 만큼 파티션 크기가 반영되었다.

그러나 리눅스는 파일 시스템 확장까지 해야 실제 하드디스크를 이용할 수 있다.

ex4 파일 시스템 확장

파일시스템의 종류에 따라 파일시스템 변경방식이 다르다.

현재 ex4 파일시스템을 / 에 쓰고 있으므로 다음 명령어로 확장해보자.

$ sudo resize2fs /dev/nvme0n1p1
resize2fs 1.44.1 (24-Mar-2018)
Filesystem at /dev/nvme0n1p1 is mounted on /; on-line resizing required
old_desc_blocks = 2, new_desc_blocks = 7
The filesystem on /dev/nvme0n1p1 is now 13106939 (4k) blocks long.

실제로 파일 시스템이 확장 되었는지 확인해보자.

$ df -hT
Filesystem     Type      Size  Used Avail Use% Mounted on
udev           devtmpfs  1.9G     0  1.9G   0% /dev
tmpfs          tmpfs     390M  772K  389M   1% /run
/dev/nvme0n1p1 ext4       49G   13G   36G  27% /
tmpfs          tmpfs     2.0G     0  2.0G   0% /dev/shm
tmpfs          tmpfs     5.0M     0  5.0M   0% /run/lock
tmpfs          tmpfs     2.0G     0  2.0G   0% /sys/fs/cgroup
/dev/loop0     squashfs   90M   90M     0 100% /snap/core/7713
/dev/loop1     squashfs   18M   18M     0 100% /snap/amazon-ssm-agent/1480
/dev/loop2     squashfs   90M   90M     0 100% /snap/core/8268
tmpfs          tmpfs     390M     0  390M   0% /run/user/1000

루트가 확장되어 50G 모두 반영되었다.

참고

https://docs.aws.amazon.com/ko_kr/AWSEC2/latest/UserGuide/recognize-expanded-volume-linux.html

파이썬을 이용한 클린 코드를 위한 테스트 주도 개발 - 5장 사용자 입력 저장하기

Mon, 23 Dec 2019 14:00:00 GMT

Intro

다시 한번 강조! TDD의 핵심은 한 번에 한가지만 하는 것

기능 테스트에 최소한의 기능만 구현

이번장에서 보여줄 것은?

사용자가 입력한 작업 아이템을 서버로 보내고 이를 저장한 후 다시 사용자에게 보여주는 시스템
TDD 가 어떻게 반복적인 개발 스타일을 지원하는지 => 가장 빠른 방법은 아니나 결과적으로 개발 속도를 높여줌.
장고 모델, POST 요청처리, 장고 템플릿 테그 같은새로운 개념 소개

POST 요청을 전송하기 위한 폼(Form) 연동(예제 : 05-01)

4장 마지막에서 하지못했던 사용자 입력 기능을 구현해보도록 한다.

바로 아래 기능 테스트 부분이다.

        # 그녀는 바로 작업을 추가하기로 한다.
        inputbox = self.browser.find_element_by_id('id_new_item')
        self.assertEqual(
            inputbox.get_attribute('placeholder'),
            '작업 아이템 입력'
            )

        # "공작깃털 사기" 라고 텍스트 상자에 입력한다.
        # (에디스의 취미는 날치 잡이용 그물을 만드는 것이다)
        inputbox.send_keys('공작깃털 사기')

        # 엔터키를 치면 페이지가 갱신되고 작업 목록에
        # "1: 공작깃털 사기" 아이템이 추가된다
        inputbox.send_keys(Keys.ENTER)

        table = self.browser.find_element_by_id('id_list_table')
        rows = table.find_elements_by_tag_name('tr')
        self.assertTrue(
            any(row.text == '1: 공작깃털 사기' for row in rows),
            '신규 작업이 테이블에 표시되지 않는다'
            )

브라우저가 POST 요청을 보내기 위해서는

<input> 속성에 name= 속성을 지정
<form> 테그로 감싸야 함
<form> 테그에 method=“POST” 지정해서 전송 방식 설정

이 내용을 반영한 내용이 아래에 링크되어 있다.

lists/templates/home.html

이제 반영이 되었으니 기능 테스트를 돌려본다.

$ python functional_test.py
E
======================================================================
ERROR: test_can_start_a_list_and_retrieve_it_later (__main__.NewVisitorTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "functional_test.py", line 39, in test_can_start_a_list_and_retrieve_it_later
    table = self.browser.find_element_by_id('id_list_table')
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/selenium/webdriver/remote/webdriver.py", line 360, in find_element_by_id
    return self.find_element(by=By.ID, value=id_)
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/selenium/webdriver/remote/webdriver.py", line 978, in find_element
    'value': value})['value']
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/selenium/webdriver/remote/webdriver.py", line 321, in execute
    self.error_handler.check_response(response)
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/selenium/webdriver/remote/errorhandler.py", line 242, in check_response
    raise exception_class(message, screen, stacktrace)
selenium.common.exceptions.NoSuchElementException: Message: no such element: Unable to locate element: {"method":"css selector","selector":"[id="id_list_table"]"}
  (Session info: chrome=78.0.3904.108)

----------------------------------------------------------------------
Ran 1 test in 7.253s

FAILED (errors=1)

이전에 보지 못했던 몇가지 특이한 에러(그리고 현상)들이 나온다.

이 에러들을 파악해보려면 몇가지 디버깅 방법이 있다.

print 문을 이용해 현재 페이지 텍스트 확인하기
에러 메시지를 개선해서 더 자세한 정보를 출력하기
수동으로 사이트를 열어보기
time.sleep을 이용해 실행중에 있는 테스트를 잠시 정지시키기

여기서 마지막 sleep을 사용해보도록 한다.

functional_test.py - sleep 추가

기능 테스트를 다시 실행하면 브라우저가 10초 정도 멈추게 되는데 다음과 같은 화면이 나온다.

장고는 CSRF 보호를 기본으로 지원한다. CSRF에 대해서는 CSRF 란? 을 참고하자.

CSRF 보호를 위해 장고는 각 폼이 생성하는 POST 요청에 토큰을 부여한다.

현재 방금 form에 그 처리가 되어 있지 않아 이 에러가 CSRF validation fail 이 발생한 것이다.

장고는 이 기능도 간편하게 제공한다. CSRF 전용 템플릿 테그를 추가한다.

lists/templates/home.html

장고 내부에서는 이 테그를 CSRF 토근을 포함하는 <input type="hidden"> 요소로 변경해서 랜더링한다.

다시 기능 테스트를 돌려보면 브라우저의 CSRF 에러는 나오지 않는다.

하지만 테스트 결과는 Fail 이 된다.

$ python functional_test.py
F
======================================================================
FAIL: test_can_start_a_list_and_retrieve_it_later (__main__.NewVisitorTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "functional_test.py", line 47, in test_can_start_a_list_and_retrieve_it_later
    '신규 작업이 테이블에 표시되지 않는다'
AssertionError: False is not true : 신규 작업이 테이블에 표시되지 않는다

----------------------------------------------------------------------
Ran 1 test in 16.030s

FAILED (failures=1)

이제 브라우저 동작을 확인했으니 time.sleep은 필요없으므로 제거하자.

서버에서 POST 요청 처리(예제 : 05-02)

폼에 action= 속성 내용이 없는 상태에서 submit 을 하면?

method=POST 가 지정되어 있으므로 현재 동일 URL에 POST 방식으로 요청함

이것을 검증할 단위 테스트가 필요하다.

lists/tests.py - 단위 테스트 추가

HttpRequest 내 속성 정리

.method : HTTP 요청 메서드(string 타입)
.POST : POST 메서드인 요청 http body 내용(dict 타입)

새로 단위 테스트를 추가했으므로 의도적인 실패가 일어나는지 확인하자

python manage.py test
Creating test database for alias 'default'...
System check identified no issues (0 silenced).
FF.
======================================================================
FAIL: test_home_page_can_save_a_POST_request (lists.tests.HomePageTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "/Users/pilhwankim/Github/books/test_driven_development_with_python/ch05/05-02/superlists/lists/tests.py", line 28, in test_home_page_can_save_a_POST_request
    self.assertIn('신규 작업 아이템', response.content.decode())
AssertionError: '신규 작업 아이템' not found in '<html>\n    <head>\n        <title>To-Do lists</title>\n    </head>\n    <body>\n        <h1>Your To-Do list</h1>\n        <form method="POST">\n            <input name="item_text" id="id_new_item" placeholder="작업 아이템 입력">\n            <input type="hidden" name="csrfmiddlewaretoken" value="67JC67qNcs6bsJlmhjMGrbMSvevTJ7qYVFfbZlGQ9WPLwK82e9r0jFfpSD9XJAUt">\n        </form>\n\n        <table id="id_list_table">\n        </table>\n    </body>\n</html>'

======================================================================
FAIL: test_home_page_returns_correct_html (lists.tests.HomePageTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "/Users/pilhwankim/Github/books/test_driven_development_with_python/ch05/05-02/superlists/lists/tests.py", line 18, in test_home_page_returns_correct_html
    self.assertEqual(response.content.decode(), expected_html)
AssertionError: '<htm[227 chars]     <input type="hidden" name="csrfmiddleware[171 chars]tml>' != '<htm[227 chars]     \n        </form>\n\n        <table id="i[50 chars]tml>'

----------------------------------------------------------------------
Ran 3 tests in 0.006s

FAILED (failures=2)
Destroying test database for alias 'default'...

예상치 못한 상황이 발생했다. 보면 3개중 2개의 단위 테스트가 에러가 난다.

테스트 로그를 확인해보면 원인은 5장 맨처음 csrf tag를 넣음으로 템플릿 html 문자열과 응답 문자열(csrf input 이 포함된) 결과가 차이가 나서 생기는 실패이다.

이 차이는 어떻게 극복해야 하나?

스텍오버플로우에 관련 질문을 찾아보니 우회하는 방법이 있었다.

https://stackoverflow.com/questions/34629261/django-render-to-string-ignores-csrf-token/39859042#39859042

요약하면 csrfmiddlewaretoken 히든 필드를 테스트 코드에서 파이썬 정규표현식으로 제거하는 함수를 만드는 것이다.

def remove_csrf(html_code):
    csrf_regex = r'&lt;input[^&gt;]+csrfmiddlewaretoken[^&gt;]+&gt;'
    return re.sub(csrf_regex, '', html_code)

lists/tests.py remove_csrf 함수를 다음과 같이 추가한다.

    def test_home_page_returns_correct_html(self):
        #...생략...
        expected_html = render_to_string('home.html', request=request)
        self.assertEqual(remove_csrf(response.content.decode()), remove_csrf(expected_html))

테스트를 다시 돌려보면

$ python manage.py test
Creating test database for alias 'default'...
System check identified no issues (0 silenced).
F..
======================================================================
FAIL: test_home_page_can_save_a_POST_request (lists.tests.HomePageTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "/Users/pilhwankim/Github/books/test_driven_development_with_python/ch05/05-02/superlists/lists/tests.py", line 36, in test_home_page_can_save_a_POST_request
    self.assertIn('신규 작업 아이템', response.content.decode())
AssertionError: '신규 작업 아이템' not found in '<html>\n    <head>\n        <title>To-Do lists</title>\n    </head>\n    <body>\n        <h1>Your To-Do list</h1>\n        <form method="POST">\n            <input name="item_text" id="id_new_item" placeholder="작업 아이템 입력">\n            <input type="hidden" name="csrfmiddlewaretoken" value="FO3gHv4cwdk1hJyTEmkpr5e3KGenddLiKNXz7K31FIcgFDOUi5tL47OXeohJW0Xs">\n        </form>\n\n        <table id="id_list_table">\n        </table>\n    </body>\n</html>'

----------------------------------------------------------------------
Ran 3 tests in 0.006s

FAILED (failures=1)
Destroying test database for alias 'default'..

이제 1가지 테스트 실패만 남았는데 이번에 추가한 테스트 코드이다.

이 것을 해결하려면 POST 요청을 처리하는 코드를 작성해야 한다.

제일 간단한 방식으로 반환값을 이용해서 해결해보자.

lists/views.py

def home_page(request):
      return HttpResponse(request.POST['item_text'])

테스트는 모두 통과한다. 그러나 우리가 최종 원하는 결과는 아니다.

우리가 원하는 결과는 템플릿에 있는 새 TODO 리스트에 ‘신규 작업 아이템’ 이 추가되는 것이다.

파이썬 변수를 전달해서 템플릿에 출력하기(예제 : 05-03)

어떻게 ‘신규 작업 아이템’을 추가해야 할까?

장고는 템플릿 구문을 이용하면 파이썬 뷰 코드에 있는 변수를 그대로 추가 가능하다.

lists/templates/home.html

        <table id="id_list_table">
            <tr><td>{{ new_item_text }}</td></tr>
        </table>

뷰가 제대로 된 값을 newitemtext 에 전달하는지 어떻게 테스트 하는가?

rendertostring 함수를 이용한다.

lists/tests.py

        self.assertIn('신규 작업 아이템', response.content.decode())
        expected_html = render_to_string(
            'home.html',
            {'new_item_text': '신규 작업 아이템'}
        )
        self.assertEqual(remove_csrf(response.content.decode()), remove_csrf(expected_html))

rendertostring 두번째 인수에 변수명과 값을 매칭한 dict 를 넣는다.

이는 ‘newitemtext’ 라는 변수를 home.html 템플릿의 {{newitemtext}} 를 값으로 치환시킨다.

다시 테스트를 돌려보면 실제 뷰 처리가 없어 실패한다. 다시 뷰 처리를 해보자.

lists/views.py

def home_page(request):
    return render(request, 'home.html', {
        'new_item_text': request.POST.get('item_text', ''),
        })

다시 테스트를 돌려보자! 예상하지 못한 테스트 실패(에러) 가 나온다.

$ python manage.py test
Creating test database for alias 'default'...
System check identified no issues (0 silenced).
FE.
======================================================================
ERROR: test_home_page_returns_correct_html (lists.tests.HomePageTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/django/utils/datastructures.py", line 78, in __getitem__
    list_ = super().__getitem__(key)
KeyError: 'item_text'

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/Users/pilhwankim/Github/books/test_driven_development_with_python/ch05/05-03/superlists/lists/tests.py", line 25, in test_home_page_returns_correct_html
    response = home_page(request)
  File "/Users/pilhwankim/Github/books/test_driven_development_with_python/ch05/05-03/superlists/lists/views.py", line 9, in home_page
    'new_item_text': request.POST['item_text']
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/django/utils/datastructures.py", line 80, in __getitem__
    raise MultiValueDictKeyError(key)
django.utils.datastructures.MultiValueDictKeyError: 'item_text'

공교롭게도 우리가 POST관련 내용을 변경하고 있을 때 다른 테스트에서 실패가 발생하였다. 이 결과로 방금의 POST 요청 처리 코드는 잘 못되었음을 발견 할 수 있다.

이것이 우리가 테스트를 작성해야 하는 이유이다. 테스트가 에플리케이션을 망가뜨릴수 있는 상황에서 우리를 구해주었다.

이 에러 케이스도 반영해서 다음과 같이 변경하자.

lists/views.py

    return render(request, 'home.html', {
        'new_item_text': request.POST.get('item_text', ''),
        })

이제 단위 테스트는 통과한다. 기능 테스트는 어떤지 알아보자.

$ python functional_test.py
F
======================================================================
FAIL: test_can_start_a_list_and_retrieve_it_later (__main__.NewVisitorTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "functional_test.py", line 45, in test_can_start_a_list_and_retrieve_it_later
    '신규 작업이 테이블에 표시되지 않는다'
AssertionError: False is not true : 신규 작업이 테이블에 표시되지 않는다

----------------------------------------------------------------------
Ran 1 test in 12.803s

FAILED (failures=1)

TF 디버깅 방법 “에러 메시지를 개선” 하는 방법을 사용하자.

functional_test.py

        self.assertIn('1: 공작깃털 사기', [row.text for row in rows], 
            f'신규 작업이 테이블에 표시되지 않는다 -- 해당 텍스트:\n{table.text}'
        )

다음과 같이 유용한 메시지를 출력한다.

AssertionError: False is not true : 신규 작업이 테이블에 표시되지 않는다 -- 해당 텍스트:
공작깃털 사기

다시 테스트의 문제 해결로 돌아와보자. FT 가 실패하는 원인은 “1:“로 시작하는 첫번째 아이템을 원한다는 것이다. 약간의 편법을 동원하자.

lists/templates/home.html

        <table id="id_list_table">
            <tr><td>1: {{ new_item_text }}</td></tr>
        </table>

finish the test! 결과를 볼수 있다.

그러나.. 모두 알다시피 이런 꼼수는 2번째 아이템 등록에서는 동작하지 않는다. 2번째 아이템 등록 테스트를 추가해보자.

functional_test.py

        # 그녀는 바로 작업을 추가하기로 한다.
        inputbox = self.browser.find_element_by_id('id_new_item')
        self.assertEqual(
            inputbox.get_attribute('placeholder'), 
            '작업 아이템 입력'
            )    

        # "공작깃털 사기" 라고 텍스트 상자에 입력한다.
        # (에디스의 취미는 날치 잡이용 그물을 만드는 것이다)
        inputbox.send_keys('공작깃털 사기')

        # 엔터키를 치면 페이지가 갱신되고 작업 목록에
        # "1: 공작깃털 사기" 아이템이 추가된다
        inputbox.send_keys(Keys.ENTER)
        self.assertIn('1: 공작깃털 사기', [row.text for row in rows], 
            f'신규 작업이 테이블에 표시되지 않는다 -- 해당 텍스트:\n{table.text}'
        )

        import time
        time.sleep(2)

        # (에디스는 매우 체계적인 사람이다)
        inputbox = self.browser.find_element_by_id('id_new_item')
        inputbox.send_keys('공작깃털을 이용해서 그물 만들기')
        inputbox.send_keys(Keys.ENTER)

        import time
        time.sleep(2)
        # 페에제는 다시 갱신되고, 두 개 아이템이 목록에 보인다.
        table = self.browser.find_element_by_id('id_list_table')
        rows = table.find_elements_by_tag_name('tr')
        self.assertIn('1: 공작깃털 사기', [row.text for row in rows], 
            f'신규 작업이 테이블에 표시되지 않는다 -- 해당 텍스트:\n{table.text}'
        )
        self.assertIn(
            '2: 공작깃털을 이용해서 그물 만들기', 
            [row.text for row in rows], 
            f'신규 작업이 테이블에 표시되지 않는다 -- 해당 텍스트:\n{table.text}'
        )

예상된 실패를 보여준다.

$ python functional_test.py
F
======================================================================
FAIL: test_can_start_a_list_and_retrieve_it_later (__main__.NewVisitorTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "functional_test.py", line 53, in test_can_start_a_list_and_retrieve_it_later
    f'신규 작업이 테이블에 표시되지 않는다 -- 해당 텍스트:\n{table.text}'
AssertionError: '1: 공작깃털 사기' not found in ['1: 공작깃털을 이용해서 그물 만들기'] : 신규 작업이 테이블에 표시되지 않는다 -- 해당 텍스트:
1: 공작깃털을 이용해서 그물 만들기

----------------------------------------------------------------------
Ran 1 test in 6.966s

FAILED (failures=1)

단위 테스트 주기 - 레드/그린/리팩터 그리고 삼각법

레드 : 실패할 단위 테스트를 작성함으로써 작업을 시작한다.
그린 : 이 테스트를 통과할 최소 코드를 작성한다. 편법도 상관없다.
리펙터링 : 이해할 수 있는 코드로 바꾼다.
- 삼각법(Triangulation) : 방금 우리가 보여준 방식. 두번째 아이템도 추가해 본다.

스트라이크 3개면 리팩터(예제 : 05-04)

Three strikes and Refactor : 한번 정도는 복사-붙여넣기를 해줄 수 있지만, 같은 코드가 3번 이상 등장하게 되면 중복을 제거 해야 한다는 이론
DRY(Don’t Repeat Yourself)
리펙토링 전에는 커밋을 하고 진행할 것(일단은 돌아가는 코드 베이스로 시작하는 의미)

FT를 리팩토링 해보자. 저번 FT 코드의 증가로 중복된 코드 내용이 생겼다.

이 부분을 check_for_row_in_list_table 함수로 추출하는 리펙토링 한다.

functional_test.py

    def check_for_row_in_list_table(self, row_text):
        table = self.browser.find_element_by_id('id_list_table')
        rows = table.find_elements_by_tag_name('tr')
        self.assertIn(row_text, [row.text for row in rows])

    def test_can_start_a_list_and_retrieve_it_later(self):
        (...생략...)

        # "공작깃털 사기" 라고 텍스트 상자에 입력한다.
        # (에디스의 취미는 날치 잡이용 그물을 만드는 것이다)
        inputbox.send_keys('공작깃털 사기')

        # 엔터키를 치면 페이지가 갱신되고 작업 목록에
        # "1: 공작깃털 사기" 아이템이 추가된다
        inputbox.send_keys(Keys.ENTER)
        
        import time
        time.sleep(2)
        
        self.check_for_row_in_list_table('1: 공작깃털 사기')

        # (에디스는 매우 체계적인 사람이다)
        inputbox = self.browser.find_element_by_id('id_new_item')
        inputbox.send_keys('공작깃털을 이용해서 그물 만들기')
        inputbox.send_keys(Keys.ENTER)

        import time
        time.sleep(2)
        
        # 페이지는 다시 갱신되고, 두 개 아이템이 목록에 보인다.
        self.check_for_row_in_list_table('1: 공작깃털 사기')
        self.check_for_row_in_list_table('2: 공작깃털을 이용해서 그물 만들기')

FT 를 실행해보면 결과가 바뀌지 않은 것을 확인 할수 있다. 작은 변경이지만 테스트 코드의 가독성이 좋아졌다.

Django ORM과 첫 모델(예제 : 05-05)

객체 관계형 맵핑(Object-Relational Mapper, ORM)

데이터 베이스의 테이블, 레코드, 칼럼 형태로 저장된 데이터를 추상화한 것
객체지향 코딩 스타일을 그대로 유지하는 게 목적
Django는 기본 ORM을 탑재하고 있음.

RDB	객체지향 언어
테이블	클래스
칼럼	속성
레코드	인스턴스

유닛 테스트에 새로운 클래스를 추가해 보자.

lists/tests.py

[...]

from lists.models import Item

[...]

class ItemModelTest(TestCase):
    def test_saving_and_retrieving_items(self):
        first_item = Item()
        first_item.text = '첫 번째 아이템'
        first_item.save()
        second_item = Item()
        second_item.text = '두 번째 아이템'
        second_item.save()

        saved_items = Item.objects.all()
        self.assertEqual(saved_items.count(), 2)

        first_saved_item = saved_items[0]
        second_saved_item = saved_items[1]

        self.assertEqual(first_saved_item.text, '첫 번째 아이템')
        self.assertEqual(second_saved_item.text, '두 번째 아이템')

위의 테스트 코드 ORM 내용 정리

save() : 비교적 쉽게 DB에 레코드 생성 가능
objects.all() : 테이블에 있는 모든 레코드 조회
QuerySet : 리스트 형태 객체. 개별 객체 조회가능
count() : 조회한 객체의 갯수

단위 테스트를 이제 실행해보자.

$ python manage.py test
[...]
  File "/superlists/lists/tests.py", line 9, in <module>
    from lists.models import Item
ImportError: cannot import name 'Item' from 'lists.models' (/superlists/lists/models.py)
[...]

~~지겹지만~~ 의도적인 실패(에러)가 발생했다.

임포트 문제를 해결해 나가보자.

lists/models.py

from django.db import models


class Item(object):
    pass

다시 테스트를 실행해보면?

$ python manage.py test
[...]
Traceback (most recent call last):
  File "/Users/pilhwankim/Github/books/test_driven_development_with_python/ch05/05-05/superlists/lists/tests.py", line 46, in test_saving_and_retrieving_items
    first_item.save()
AttributeError: 'Item' object has no attribute 'save'
[...]

Item 클래스에는 save 메소드가 없다. 이걸 어떻게 해야하나?

저자는 이미 알고 있는데 뜸을 들이고 있다.

해결책은 Django model을 상속받아 사용하려는 의도이다.

lists/models.py

from django.db import models


class Item(models.Model):
    pass

다시 또! 테스트를 실행해보자.

$ python manage.py test
[...]
    return Database.Cursor.execute(self, query, params)
django.db.utils.OperationalError: no such table: lists_item
[...]

no such table 이라고 나온다. 이유는 간단하다. ORM을 사용하려면 그 전에 필요한 과정이 있기 때문이다.

우리는 지금까지 DB 구성을 한 적이 없다. 이제 ORM은 당연하게도 DB 가 필요한데도 말이다.

친절하게도 Django ORM 은 마이그레이션(Migration) 기능을 넣어두었다.

마이그레이션(Migration)

각 app의 models.py 파일에 적용된 내용 기반으로, 사용자가 테이블/칼럼을 삭제/추가/변경 가능하게 한다.
데이터베이스를 위한 버전관리 시스템
프로젝트 루트에 manage.py 의 관련 명령이 있음(migrate, makemigrations 등)

자 이제 다음 명령으로 DB셋업을 시작해보자.

 python manage.py makemigrations
Migrations for 'lists':
  lists/migrations/0001_initial.py
    - Create model Item

이 명령을 실행해보고 다음 위치 lists/migrations 디렉토리 가 생성되고 그 하위에 파일이 생성된다.

뭔가 변하였으므로 다시 테스트를 실행해 본다.

$ python manage.py test
[...]
Traceback (most recent call last):
  File "/Users/pilhwankim/Github/books/test_driven_development_with_python/ch05/05-05/superlists/lists/tests.py", line 58, in test_saving_and_retrieving_items
    self.assertEqual(first_saved_item.text, '첫 번째 아이템')
AttributeError: 'Item' object has no attribute 'text'
[...]

테스트 결과가 뭔가 달라졌다. 아예 DB가 없다는 내용이었는데 attribute 가 없다는 식으로 변했다.

Django ORM 추가 내용 정리

models.Model 를 상속한 클래스 - DB의 Table
클래스가 생성될 때 PK(Primary key) 역할의 ID 속성은 기본 생성됨
다른 칼럼들은 직접 정의 필요

위의 테스트 결과를 해결하려면 정리 내용대로 text 칼럼을 추가해야 한다.

lists/models.py

from django.db import models


class Item(models.Model):
    text = models.TextField()

이제 될거리 믿고 다시 테스트를 실행해보자.

[...]
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/django/db/backends/sqlite3/base.py", line 383, in execute
    return Database.Cursor.execute(self, query, params)
django.db.utils.OperationalError: no such column: lists_item.text

모델에 칼럼을 추가했지만 그것으로 끝나지 않는다. ORM은 마이그레이션 과정을 원한다.

$ python manage.py makemigrations
You are trying to add a non-nullable field 'text' to item without a default; we can't do that (the database needs something to populate existing rows).
Please select a fix:
 1) Provide a one-off default now (will be set on all existing rows with a null value for this column)
 2) Quit, and let me add a default in models.py
Select an option: 2

다음과 같은 물음이 나오는데 초기값이 필요하다고 한다. 초기값을 추가해주자.

lists/models.py

from django.db import models


class Item(models.Model):
    text = models.TextField(default='')

또 다시 시도해보자 마이그래이션이 성공한다.

$ python manage.py makemigrations
Migrations for 'lists':
  lists/migrations/0002_item_text.py
    - Add field text to item

다시 테스트로 돌아와서 실행시켜보자.

 python manage.py test
Creating test database for alias 'default'...
System check identified no issues (0 silenced).
....
----------------------------------------------------------------------
Ran 4 tests in 0.010s

OK
Destroying test database for alias 'default'...

이번 테스트도 마무리 되었다!

POST를 데이터베이스에 저장하기(예제 : 05-06)

지금까지는 POST 요청이 테스트 결과에 맞춰 단순히 응답에 반환되도록 짜여저 있다.

이제 이것을 데이터베이스에 저장하도록 수정하는 작업을 해보자.

먼저 단위 테스트 부터 변경한다.

lists/tests.py

[...]
    def test_home_page_can_save_a_POST_request(self):
        [...]
        response = home_page(request)

        self.assertEqual(Item.objects.count(), 1)
        new_item = Item.objects.first()
        self.assertEqual(new_item.text, '신규 작업 아이템')

        self.assertIn('신규 작업 아이템', response.content.decode())
        [...]

POST 요청 후에 ORM으로 DB조회 결과를 확인하는 테스트 코드가 추가되었다.

어디선가 코드 냄새가 난다. 왜? 단위 테스트 길이가 너무 길기 때문에.

단위 테스트가 길다는 것은?

테스트 자체가 복잡하다
테스트를 몇 개로 나눌수 있다

언제나 그랬듯 변경이 있으면 테스트를 실행한다. 여기서는 의도된 실패나 나와야 한다.

======================================================================
FAIL: test_home_page_can_save_a_POST_request (lists.tests.HomePageTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "/superlists/lists/tests.py", line 34, in test_home_page_can_save_a_POST_request
    self.assertEqual(Item.objects.count(), 1)
AssertionError: 0 != 1

의도대로 진행되었다. 이제는 장고 뷰를 코딩해야 한다.

lists/views.py

from .models import Item


def home_page(request):
    item = Item()
    item.text = request.POST.get('item_text', '')
    item.save()

    return render(request, 'home.html', {
        'new_item_text': request.POST.get('item_text', ''),
        })

이 코드의 문제점은? 모든 요청에 대해서 빈 아이템을 저장하고 있는것

이 문제점은 잠시 메모하고 일단 테스트를 실행해 보자. 실패하던 테스트는 성공한다.

저자의 깨알 Hint : 문제를 발견하면?

문제가 작으면? - 하던 것을 멈추고 다시 한다.
문제가 크면? - 일단 메모하고 뒤로 미룬다.
저자는 생각해보면 참 원칙주의자이다. 책 전체에서 진짜로 한번에 한가지 일(문제해결)만 한다.

메모해둔 문제점 리스트를 다시 정리하면…

모든 요청에 대한 비어있는 요청은 저장하지 않는다.
코드 냄새: POST 테스트가 너무 긴가?
테이블에 아이템 여러 개 표시하기
하나 이상의 목록 지원하기

=> 목록도 엄청 디테일하게 짜여져 있다. 의도적이라는 생각이 든다. TDD 기본이 10~15분 내에 해결 가능한 수준으로 잘게 쪼개서 문제 해결 사이클을 작게 유지하는게 핵심이기 때문이다.

저 작업중 1번째 것을 진행한다. 우선 검증할 단위 테스트를 추가한다.

lists/tests.py

    def test_home_page_only_saves_items_when_necessary(self):
        request = HttpRequest()
        home_page(request)
        self.assertEqual(Item.objects.all().count(), 0)

테스트를 돌려보면 의도적인 실패가 발생한다.

Traceback (most recent call last):
  File "/superlists/lists/tests.py", line 48, in test_home_page_only_saves_items_when_necessary
    self.assertEqual(Item.objects.all().count(), 0)
AssertionError: 1 != 0

비어있는 요청과 분리하는 코딩을 해보자.

lists/views.py

def home_page(request):
    if request.method == 'POST':
        new_item_text = request.POST['item_text']
        Item.objects.create(text=new_item_text)
    else:
        new_item_text = ''
        
    return render(request, 'home.html', {
        'new_item_text': new_item_text,
        })

완료되었으면 테스트가 통과하는지 확인한다.

Ran 5 tests in 0.020s

OK

POST 후에 리디렉션(예제 : 05-07)

POST 후에는 항상 리디렉션하라(https://en.wikipedia.org/wiki/Post/Redirect/Get)

POST 요청의 응답은 HTML렌더링이 아니라 GET 리디렉션 응답으로 변경하는게 목적이다.

그 목적에 맞게 단위 테스트를 변경한다.

lists/tests.py

    def test_home_page_can_save_a_POST_request(self):
        request = HttpRequest()
        request.method = 'POST'
        request.POST['item_text'] = '신규 작업 아이템'

        response = home_page(request)

        self.assertEqual(Item.objects.count(), 1)
        new_item = Item.objects.first()
        self.assertEqual(new_item.text, '신규 작업 아이템')

        self.assertEqual(response.status_code, 302)
        self.assertEqual(response['location'], '/')

HTML 본문을 확인하는 assertion을 제거하고 대신 HTTP status가 302(리디렉션 코드), 리디렉션 URL 이 맞는지 확인하는 코드이다.

변경했으니 테스트를 돌려본다. status code가 아직 200이어서 200 != 302 에러를 일으킨다.

뷰를 그에 맞게 수정한다.

lists/views.py

def home_page(request):
    if request.method == 'POST':
        Item.objects.create(text=request.POST['item_text'])
        return redirect('/')
        
    return render(request, 'home.html')

테스트 결과는 성공한다.

HINT : 좋은 단위 테스트란?

한 가지만 테스트를 하는 것
왜 그래야 하나요?
- 버그 추적이 용이해짐
- assertion 이 많아지면 무엇이 틀렸는지 파악하기 힘듦(assertion 이 적을수록 유리)

위의 내용을 기준으로 `testhomepagecansaveaPOST_request`를 2개로 나눠보자.

lists/tests.py

    def test_home_page_can_save_a_POST_request(self):
        request = HttpRequest()
        request.method = 'POST'
        request.POST['item_text'] = '신규 작업 아이템'

        response = home_page(request)

        self.assertEqual(response.status_code, 302)
        self.assertEqual(response['location'], '/')
    
    def test_home_page_redirects_after_POST(self):
        request = HttpRequest()
        request.method = 'POST'
        request.POST['item_text'] = '신규 작업 아이템'

        response = home_page(request)

        self.assertEqual(Item.objects.count(), 1)
        new_item = Item.objects.first()
        self.assertEqual(new_item.text, '신규 작업 아이템')

테스트를 돌려보면 테스트가 6개로 늘었고 결과는 OK이다.

$ python manage.py test
Creating test database for alias 'default'...
System check identified no issues (0 silenced).
......
----------------------------------------------------------------------
Ran 6 tests in 0.016s

OK
Destroying test database for alias 'default'...

템플릿에 있는 아이템 렌더링(예제 : 05-08)

문제점 리스트는 현재 다음과 같은 상태이다.

~~모든 요청에 대한 비어있는 요청은 저장하지 않는다.~~
~~코드 냄새: POST 테스트가 너무 긴가?~~
테이블에 아이템 여러 개 표시하기
하나 이상의 목록 지원하기

이제 테이블에 아이템 여러 개 표시하기 작업을 해 보자.

일단 여러 아이템을 출력 하는 단위 테스트를 만들어 보자.

lists/tests.py

class HomePageTest(TestCase):
  [...]
    def test_home_page_displays_all_list_items(self):
        Item.objects.create(text='itemey 1')
        Item.objects.create(text='itemey 2')

        request = HttpRequest()
        response = home_page(request)

        self.assertIn('itemey 1', response.content.decode())
        self.assertIn('itemey 2', response.content.decode())

테스트를 돌려보면 예상되는 실패가 나타났다.

    self.assertIn('itemy 1', response.content.decode())
AssertionError: 'itemy 1' not found in '<html>\n    <head>\n        <title>To-Do lists</title>\n    </head>\n    <body>\n        <h1>Your To-Do list</h1>\n        <form method="POST">\n            <input name="item_text" id="id_new_item" placeholder="작업 아이템 입력">\n            <input type="hidden" name="csrfmiddlewaretoken" value="QeSZ9iAYixbuEvIboVutb0LnrSaJqN2RHuzEzBFetxuzXg7jsKn4alwUfL0JqOUb">\n        </form>\n\n        <table id="id_list_table">\n            <tr><td>1: </td></tr>\n        </table>\n    </body>\n</html>'

Django 템플릿은 리스트 반복 처리를 위한 테그를 제공

{% for .. in .. %}

lists/templates/home.html

[...]
        <table id="id_list_table">
            {% for item in items %}
                <tr><td>{{forloop.counter}}: {{ item.text }}</td></tr>
            {% endfor %}
        </table>
[...]

다시 테스트를 해도 통과되진 않는다. 템플릿에 items 를 건네주어야 한다.

lists/views.py

[...]
def home_page(request):
    [...]

    items = Item.objects.all()
    return render(request, 'home.html', {'items': items})

여기까지 하면 단위 테스트는 통과한다.

기능 테스트도 실행해 보자.

$ python functional_test.py
F
======================================================================
FAIL: test_can_start_a_list_and_retrieve_it_later (__main__.NewVisitorTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "functional_test.py", line 25, in test_can_start_a_list_and_retrieve_it_later
    self.assertIn('To-Do', self.browser.title)
AssertionError: 'To-Do' not found in 'OperationalError at /'

----------------------------------------------------------------------
Ran 1 test in 2.690s

FAILED (failures=1)

불행히도 실패한다. 왜 그런걸까? 일단 브러우저로 수동 접속을 해보면 다음과 같은 에러가 뜬다.

마이그레이션을 이용한 운영 데이터베이스 생성하기(예제 : 05-08)

코드상 기능은 분명 완성되었는데 왜 이런 에러가 표시되는걸까?

에러를 보고 구글링해보면 실제 데이터베이스가 생성되지 않아 생기는 문제임을 알 수 있다.

진짜 데이터베이스를 구축해 보자. Django 는 기본으로 localhost 의 SQLite 를 기본 DB로 설정하고 있다.

superlists/settings.py

[...]
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}
[...]

이전 makemigrate 로 마이그레이션 히스토리를 작성했다면, 이번에는 그 히스토리를 토대로 진짜 DB에 적용하는 과정이 필요하다. migrate 명령이 그 역할을 한다.

$ python manage.py migrate
Operations to perform:
  Apply all migrations: admin, auth, contenttypes, lists, sessions
Running migrations:
  Applying contenttypes.0001_initial... OK
  Applying auth.0001_initial... OK
  Applying admin.0001_initial... OK
  Applying admin.0002_logentry_remove_auto_add... OK
  Applying admin.0003_logentry_add_action_flag_choices... OK
  Applying contenttypes.0002_remove_content_type_name... OK
  Applying auth.0002_alter_permission_name_max_length... OK
  Applying auth.0003_alter_user_email_max_length... OK
  Applying auth.0004_alter_user_username_opts... OK
  Applying auth.0005_alter_user_last_login_null... OK
  Applying auth.0006_require_contenttypes_0002... OK
  Applying auth.0007_alter_validators_add_error_messages... OK
  Applying auth.0008_alter_user_username_max_length... OK
  Applying auth.0009_alter_user_last_name_max_length... OK
  Applying auth.0010_alter_group_name_max_length... OK
  Applying auth.0011_update_proxy_permissions... OK
  Applying lists.0001_initial... OK
  Applying lists.0002_item_text... OK
  Applying sessions.0001_initial... OK

이 명령을 실행하면 django 루트 디렉토리에 db.sqlite3 파일이 생성된 것을 확인 가능하다.

$ ls
db.sqlite3 lists      manage.py  superlists

Sqlite DB 가 생성된 것이다.

이제 django 서버를 다시 기동하고 FT 를 돌려보자.

python functional_test.py
F
======================================================================
FAIL: test_can_start_a_list_and_retrieve_it_later (__main__.NewVisitorTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "functional_test.py", line 64, in test_can_start_a_list_and_retrieve_it_later
    self.fail('Finish the test!')
AssertionError: Finish the test!

----------------------------------------------------------------------
Ran 1 test in 6.858s

FAILED (failures=1)

성공할 것이다. 그러나 약간의 문제가 남아있다.

FT를 매번 실행하면 할 수록 같은 목록이 반복되어 늘어난다.

이전 FT 에서 입력한 내용이 계속 DB에 저장되기 때문이다. 대첵은 다음에 세우도록 한다.

일단은 임시로 DB 를 지운후에 재생성한다.

$ rm db.sqlite3
$ python manage.py migrate --noinput

다시 DB 가 잘 리셋된다. 일단 이번 장을 여기서 마치자.

파이썬을 이용한 클린 코드를 위한 테스트 주도 개발 - 4장 왜 테스트를 하는 것인가(그리고 리펙토링)?

Mon, 23 Dec 2019 13:00:00 GMT

프로그래밍은 우물에서 물을 퍼 올리는 것과 같다

켄트 벡(Kent Back, TDD) says
- 우물가에 있는 물 뜨는 두레박 비유
- 처음 몇번은 두레박으로 물을 퍼올리는건 쉬움
- 시간이 지나면서 곧 지치기 시작함
- 도르레 를 이용하면 직접 퍼올리는 것보도 효율적
TDD는 도르레 와 같이 작업 효율을 올려줌, 작업이 뒤로 미끄러져 가는것도 막아줌
TDD는 훈련 이다. 자연스럽게 익혀지는 것이 아니다. 성과가 즉시 나는 것이 아닌 오랜 기간을 거쳐야 한다.
필자가 보여주고자 하는 것은 철저한 TDD. 무술의 카타kata와 같음
결론은 개발 내공증진에 분명 도움되니 무술처럼 연습해서 익혀라!

셀레늄을 이용한 사용자 반응 테스트(예제 : 04-01)

이전 장 마지막에 이어서 작업한다.

바로 아래 주석 처리되어 있는 내용의 테스트 코드를 작성한다.

        # 그녀는 바로 작업을 추가하기로 한다.

        # "공작깃털 사기" 라고 텍스트 상자에 입력한다.
        # (에디스의 취미는 날치 잡이용 그물을 만드는 것이다)

        # 엔터키를 치면 페이지가 갱신되고 작업 목록에
        # "1: 공작깃털 사기" 아이템이 추가된다

functional_test.py - 추가 작성한 테스트 코드

셀레늄 메소드 설명
- findelement(s)by_id - tag id로 요소를 찾음. ‘s’는 복수개의 요소를 list로 반환
- findelementbytagname - tag 이름으로 요소를 찾음. ‘s’는 복수개의 요소를 list로 반환
- send_keys : 입력 요소를 타이핑함.

작성한 FT를 실행해보면 의도된 실패가 발생한다.

$ python functional_test.py

======================================================================
ERROR: test_can_start_a_list_and_retrieve_it_later (__main__.NewVisitorTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "functional_test.py", line 21, in test_can_start_a_list_and_retrieve_it_later
    header_text = self.browser.find_element_by_tag_name('h1').text
  File "/tdd-with-python-env/lib/python3.7/site-packages/selenium/webdriver/remote/webdriver.py", line 530, in find_element_by_tag_name
    return self.find_element(by=By.TAG_NAME, value=name)
  File "/tdd-with-python-env/lib/python3.7/site-packages/selenium/webdriver/remote/webdriver.py", line 978, in find_element
    'value': value})['value']
  File "/tdd-with-python-env/lib/python3.7/site-packages/selenium/webdriver/remote/webdriver.py", line 321, in execute
    self.error_handler.check_response(response)
  File "/tdd-with-python-env/lib/python3.7/site-packages/selenium/webdriver/remote/errorhandler.py", line 242, in check_response
    raise exception_class(message, screen, stacktrace)
selenium.common.exceptions.NoSuchElementException: Message: no such element: Unable to locate element: {"method":"css selector","selector":"h1"}
  (Session info: chrome=78.0.3904.108)

----------------------------------------------------------------------
Ran 1 test in 7.356s

FAILED (errors=1)

“상수는 테스트하지 마라”는 규칙과 탈출구로 사용할 템플릿 (예제 : 04-02)

단위 테스트 시의 규칙 : 상수는 테스트하지 마라

아래의 코드를

wibble = 3

아래 테스트로 굳이 만들 필요는 없다.

from myprogram import wibble
assert wibble == 3

단위 테스트는 로직이나 흐름제어, 설정 등을 테스트하기 위한 것이다. 현재 테스트로 구현된 HTML 테스트는 문자열 비교를 하고 있는데 이것은 상수 테스트와 유사하다.

템플릿을 사용하기 위한 리펙터링

리펙터링이란?

기능(결과물)은 바꾸지 않고 코드 자체를 개선하는 작업
기능(결과물)은 바꾸지 않고 가 핵심이다. 즉 기능 변경, 추가와 병행하면 안된다는 뜻이다. 반드시 문제가 발생한다.

지금부터 할 일은 HTML을 상수 문자열로 응답하고 테스트 했던 것을 Django 템플릿 기능으로 리펙터링 하는 과정이다.

먼저 단위 테스트를 실행하여 통과하는지 확인한다. 통과가 되어야 이 결과 기준으로 리펙토링을 시작할 수 있다.

$ python manage.py test

Creating test database for alias 'default'...
System check identified no issues (0 silenced).
..
----------------------------------------------------------------------
Ran 2 tests in 0.020s

OK
Destroying test database for alias 'default'...

HTML 문자열을 별도의 파일(템플릿 파일)에 저장

lists/templates/home.html

뷰 함수를 새로 만든 템플릿 파일에 지정함

lists/views.py

테스트 동작 여부 확인

$ python manage.py test

Creating test database for alias 'default'...
System check identified no issues (0 silenced).
E.
======================================================================
ERROR: test_home_page_returns_correct_html (lists.tests.HomePageTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "/superlists/lists/tests.py", line 15, in test_home_page_returns_correct_html
    response = home_page(request)
  File "/superlists/lists/views.py", line 6, in home_page
    return render(request, 'home.html')
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/django/shortcuts.py", line 36, in render
    content = loader.render_to_string(template_name, context, request, using=using)
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/django/template/loader.py", line 61, in render_to_string
    template = get_template(template_name, using=using)
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/django/template/loader.py", line 19, in get_template
    raise TemplateDoesNotExist(template_name, chain=chain)
django.template.exceptions.TemplateDoesNotExist: home.html

----------------------------------------------------------------------
Ran 2 tests in 0.011s

FAILED (errors=1)
Destroying test database for alias 'default'...

왜 통과되지 않는지 확인해 보자면

testhomepagereturnscorrect_html 테스트가 ERROR 가 난다.
TemplateDoesNotExist 인 것을 보면 템플릿을 찾을 수 없다고 한다.
lists/views.py 6번째 라인에 문제가 있다. 찾아보면 render 함수 호출 부분이다.

문제의 원인은 Django 내 settings.py 의 INSTALLED_APPS 에 lists 앱을 사용한다는 등록이 되지 않았기 때문이다. 자세한 내용은(https://docs.djangoproject.com/en/2.2/ref/settings/#installed-apps)에 언급되어 있다.

INSTALLED_APPS 항목 추가

superlists/settings.py

# Application definition

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'lists', # 추가
]

단위 테스트 재 확인

$ python manage.py test

Creating test database for alias 'default'...
System check identified no issues (0 silenced).
..
----------------------------------------------------------------------
Ran 2 tests in 0.035s

OK

코드 리펙토링 과정을 마쳤다. 한 가지가 남았다. 테스트 코드가 아직 HTML 문자열 상수로 남아있는데 이것도 고쳐주는 것이 좋다.

lists/tests.py

(...생략...)

from django.template.loader import render_to_string

(...생략...)

    def test_home_page_returns_correct_html(self):
        request = HttpRequest()
        response = home_page(request)
        expected_html = render_to_string('home.html')
        self.assertEqual(response.content.decode(), expected_html)

response.content.decode() 의 decode() 함수는 response.content 바이트 데이터를 유니코드 문자열로 변환한다.

이것으로 바이트와 바이트를 비교 했던 것들을 문자열과 문자열로 비교하는 것으로 테스트가 바뀌었다.

리펙터링에 관하여

중요! - 리펙터링 시에는 앱 코드와 테스트 코드를 한 번에 수정하는 것이 아니라 하나씩 수정해야 한다.
보통은 간단한 변경이라고 생각해서 단계를 건너뛰는 경우가 많다. 그게 쌓이다 보면 꼬이게 되고 돌아돌아 작업해야 하는 경우가 발생한다.

메인 페이지 추가 수정 (예제 : 04-03)

Reminder - 4장 처음에 추가했던 기능 테스트가 아직은 실패하고 있는 상태

다시 기능 테스트를 돌려 보면 추가가 필요한게 있다. home.html의 <h1> 이다.

lists/templates/home.html

추가후에 기능 테스트를 다시 돌리면

$ python functional_test.py
E
======================================================================
ERROR: test_can_start_a_list_and_retrieve_it_later (__main__.NewVisitorTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "functional_test.py", line 25, in test_can_start_a_list_and_retrieve_it_later
    inputbox = self.browser.find_element_by_id('id_new_item')
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/selenium/webdriver/remote/webdriver.py", line 360, in find_element_by_id
    return self.find_element(by=By.ID, value=id_)
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/selenium/webdriver/remote/webdriver.py", line 978, in find_element
    'value': value})['value']
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/selenium/webdriver/remote/webdriver.py", line 321, in execute
    self.error_handler.check_response(response)
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/selenium/webdriver/remote/errorhandler.py", line 242, in check_response
    raise exception_class(message, screen, stacktrace)
selenium.common.exceptions.NoSuchElementException: Message: no such element: Unable to locate element: {"method":"css selector","selector":"[id="id_new_item"]"}
  (Session info: chrome=78.0.3904.108)


----------------------------------------------------------------------
Ran 1 test in 5.369s

FAILED (errors=1)

id 가 “idnewitem” 이라는 HTML 엘리먼트가 없다는 실패 결과를 내어준다.

이제 아래의 테스트 코드 주석을 만족시킬 구현 코드르 작성해야 한다.

        # 그녀는 바로 작업을 추가하기로 한다.
        inputbox = self.browser.find_element_by_id('id_new_item')
        self.assertEqual(
            inputbox.get_attribute('placeholder'), 
            '작업 아이템 입력'
            )    

        # "공작깃털 사기" 라고 텍스트 상자에 입력한다.
        # (에디스의 취미는 날치 잡이용 그물을 만드는 것이다)
        inputbox.send_keys('공작깃털 사기')

lists/templates/home.html

다시 기능 테스트를 실행해보자.

$ python functional_test.py
E
======================================================================
ERROR: test_can_start_a_list_and_retrieve_it_later (__main__.NewVisitorTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "functional_test.py", line 39, in test_can_start_a_list_and_retrieve_it_later
    table = self.browser.find_element_by_id('id_list_table')
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/selenium/webdriver/remote/webdriver.py", line 360, in find_element_by_id
    return self.find_element(by=By.ID, value=id_)
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/selenium/webdriver/remote/webdriver.py", line 978, in find_element
    'value': value})['value']
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/selenium/webdriver/remote/webdriver.py", line 321, in execute
    self.error_handler.check_response(response)
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/selenium/webdriver/remote/errorhandler.py", line 242, in check_response
    raise exception_class(message, screen, stacktrace)
selenium.common.exceptions.NoSuchElementException: Message: no such element: Unable to locate element: {"method":"css selector","selector":"[id="id_list_table"]"}
  (Session info: chrome=78.0.3904.108)


----------------------------------------------------------------------
Ran 1 test in 5.612s

FAILED (errors=1)

이번에는 id가 “idlisttable” 인 엘리먼트가 없다는 실패가 뜬다.

이제 아래의 테스트 코드 주석을 만족시킬 구현 코드르 작성해야 한다.

        # 엔터키를 치면 페이지가 갱신되고 작업 목록에
        # "1: 공작깃털 사기" 아이템이 추가된다
        inputbox.send_keys(Keys.ENTER)

        table = self.browser.find_element_by_id('id_list_table')
        rows = table.find_elements_by_tag_name('tr')
        self.assertTrue(any(row.text == '1: 공작깃털 사기' for row in rows))

또 다시 기능 테스트를 실행해보자.

$ python functional_test.py
F
======================================================================
FAIL: test_can_start_a_list_and_retrieve_it_later (__main__.NewVisitorTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "functional_test.py", line 41, in test_can_start_a_list_and_retrieve_it_later
    self.assertTrue(any(row.text == '1: 공작깃털 사기' for row in rows))
AssertionError: False is not true

----------------------------------------------------------------------
Ran 1 test in 4.534s

FAILED (failures=1)

실패 원인이 분명치 않은데 “functional_test.py”, line 41 을 따라가 보면 기능 테스트 함수에 자세한 실패 메시지가 필요하다.

functional_test.py - 추가 작성한 메시지

python functional_test.py
F
======================================================================
FAIL: test_can_start_a_list_and_retrieve_it_later (__main__.NewVisitorTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "functional_test.py", line 44, in test_can_start_a_list_and_retrieve_it_later
    '신규 작업이 테이블에 표시되지 않는다'
AssertionError: False is not true : 신규 작업이 테이블에 표시되지 않는다

----------------------------------------------------------------------
Ran 1 test in 5.785s

FAILED (failures=1)

이제 실패 메시지가 명확하게 표시된다. 남은 기능 테스트의 문제의 해결은 5장에서 다룬다.

정리 : TDD 프로세스

전체 TDD 프로세스

2장부터 4장까지 죽 위와 같은 흐름으로 해왔다.

어떤 테스트라도 저 프로세스에 맞게 작성하였고 1번 테스트에 1번씩 저 프로세스를 돌게 했었다.

Double-Loop TDD

이 흐름도는 단위 테스트와 기능 테스트가 같이 존재할 때 어떻게 TDD를 진행하는지 나타나는 예시다.

마치 이중 for 문을 돌 때처럼

inner for 문을 단위 테스트 프로세스
outer for 문을 기능 테스트 프로세스

로 이해하면 편할 듯 하다.

즉 1개의 기능 테스트에 n개의 단위 테스트가 존재하며,

1개의 기능 테스트 작성 후 실패
해당 기능테스트에 속한 단위 테스트를 하나하나 프로세스를 거침
1개 기능 테스트 성공

의 flow 를 거친다고 이해하면 편할 듯 하다.

그 동안 기능 테스트와 단위 테스트를 실제로 어떻게 적용하는지 감이 없었는데 이렇게 예제로 접하니깐 뭔가 적용할 만한거 같다.

파이썬을 이용한 클린 코드를 위한 테스트 주도 개발 - 3장 단위 테스트를 이용한 간단한 홈페이지 테스트

Mon, 23 Dec 2019 12:00:00 GMT

Intro

본격적인 To-Do 웹 에플리케이션 개발을 위해 단위 테스트를 만들어본다.

첫 Django 애플리케이션과 첫 단위 테스트(예제 : 03-01)

Django 는 1개 프로젝트에 n개 app으록 구성되어 있다.
이것은 다른 프로젝트에서도 동일한 앱을 사용가능하도록 app 단위로 재사용을 가능하게 하기 위한 것이다.
앱은 코드를 구조화하기위한 좋은 수단이다.

작업 목록 앱을 만들어 보자.

$ python manage.py startapp lists

실행하면 superlists/superlists 와 동일 위치에 spuerlists/lists 라는 폴더가 생성된다.

단위 테스트는 무엇이고, 기능 테스트와 어떤 차이가 있을까?

종류	단위 테스트	기능 테스트
관점	프로그래머 관점	사용자 관점
목표	애플리케이션 내부	애플리케이션 외부
레이어	하위 레벨	상위 레벨

테스트 작업 순서

기능 테스트 작성 : 사용자 관점의 새로운 기능성 정의
기능 테스트 실패 - 하위단의 어떤 기능을 작성해야 통과할지 고민/설계 2-1. 단위 테스트 작성 : 기능테스트에서의 고민은 테스트로 작성 2-2. 단위 테스트 실패 : 테스트를 통과할 정도로 최소한의 코드 작성. 과정 2-1/2-2를 하나의 기능 테스트 완성될 때까지 반복
기능 테스트 재실행하여 통과하는지 확인. 실패시 과정 2로 돌아가서 다시 작성. 통과시 한가지 기능 완성

즉 상위단(기능테스트) 를 먼저 작성후에 그 하위단(단위 테스트)을 잘게 쪼게서 테스트 함을 알수 있다. 번거로워 보일 수 있으나, 실질적인 설계와 이후에 검증할수 있는 자동화된 툴까지 만들어지기 때문에 합리적인 프로세스인거 같다.

Django에서의 단위 테스트(예제 : 03-02)

TDD 주기

선 실패 -> 테스트를 통과할 코드 작성 -> 후 통과 -> 새 테스트 코드 작성 -> 선 실패..(계속 반복)

django.test.TestCase 클래스

Django는 기본 TestCase class를 확장한 django.test.TestCase 클래스를 기본 단위 테스트로 사용하도록 권하고 있다. django 프로젝트에 맞는 여러 확장 기능들이 있다. 그 중에 manage.py 에서 test 커맨드로 전체 testcase를 실행하는 기능이 포함되어 있다. 고의적인 실패 테스트를 작성하여 이를 확인해 보자.

lists/tests.py

$ python manage.py test

Creating test database for alias 'default'...
System check identified no issues (0 silenced).
F
======================================================================
FAIL: test_bad_maths (lists.tests.SmokeTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "workspace/superlists/lists/tests.py", line 7, in test_bad_maths
    self.assertEqual(1 + 1, 3)
AssertionError: 2 != 3

----------------------------------------------------------------------
Ran 1 test in 0.001s

FAILED (failures=1)
Destroying test database for alias 'default'...

Django의 MVC, URL, 뷰 함수(예제 : 03-03)

Django는 대체로 MVC(Model-View-Cotroller) 패턴을 따름

이 MVC 패턴을 차용하여 Django는

MVC패턴	Django
Model(Data)	Model
View	Template
Controller	View

라고 표현하여 MTV(model-template-view)패턴이라고 명명함

HTTP 요청 Django 의 처리 흐름

저기 중에 http client - view 사이에서 일어나는 일을 좀더 자세히 설명하면 이렇다.

특정 URL에 대한 HTTP 요청 받음
특정 규칙을 이용해서 해당 요청에 어떤 뷰 함수를 실행할 지 결정
뷰 기능 요청을 처리하고 HTTP 응답을 반환

따라서 우리가 테스트 할 2가지

URL의 루트(”/“)를 해석해서 특정 뷰 기능에 매칭시킬 수 있는가?
이 뷰 기능이 특정 HTML을 반환하게 해서 기능 테스트를 통과하는가?

첫 번째 테스트 코드

$ python manage.py test
System check identified no issues (0 silenced).
E
======================================================================
ERROR: lists.tests (unittest.loader._FailedTest)
----------------------------------------------------------------------
ImportError: Failed to import test module: lists.tests
Traceback (most recent call last):
  File "/Users/pilhwankim/.pyenv/versions/3.7.1/lib/python3.7/unittest/loader.py", line 434, in _find_test_path
    module = self._get_module_from_name(name)
  File "/Users/pilhwankim/.pyenv/versions/3.7.1/lib/python3.7/unittest/loader.py", line 375, in _get_module_from_name
    __import__(name)
  File "/Users/pilhwankim/Github/books/test_driven_development_with_python/ch03_Testing_a_Simple_Home_Page_with_Unit_Tests/03-03/superlists/lists/tests.py", line 3, in <module>
    from lists.views import home_page
ImportError: cannot import name 'home_page' from 'lists.views' (/Users/pilhwankim/Github/books/test_driven_development_with_python/ch03_Testing_a_Simple_Home_Page_with_Unit_Tests/03-03/superlists/lists/views.py)


----------------------------------------------------------------------
Ran 1 test in 0.000s

FAILED (errors=1)

예상하던 대로 에러가 발생한다. 대략 에러의 내용은 veiws 의 home_page 라는 존재하지 않는 것을 임포트 하려고 했기 때문에 발생했다. 예측된 실패이고 TDD 관점으로는 거쳐가야 할 첫 과정이다.

마침내 실질적인 애플리케이션을 작성한다(예제 : 03-04)

실패 테스트를 해결해 보자. 한번에 하나씩! 일단 import 에러를 해결한다.

view 구현 코드

너무 단순하고 허무한 코드이기 한데, 저자의 의도는 이런거 같다.

한 번에 한 가지의 당면한 문제를 해결해라!

다음과 같이 구현하고 다시 테스트를 돌려보면 다른 에러가 발생한다.

python manage.py test
Creating test database for alias 'default'...
System check identified no issues (0 silenced).
E
======================================================================
ERROR: test_root_url_resolves_to_home_page_view (lists.tests.HomePageTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "/Users/pilhwankim/Github/books/test_driven_development_with_python/ch03_Testing_a_Simple_Home_Page_with_Unit_Tests/03-04/superlists/lists/tests.py", line 8, in test_root_url_resolves_to_home_page_view
    found = resolve('/')
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/django/urls/base.py", line 24, in resolve
    return get_resolver(urlconf).resolve(path)
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/django/urls/resolvers.py", line 567, in resolve
    raise Resolver404({'tried': tried, 'path': new_path})
django.urls.exceptions.Resolver404: {'tried': [[<URLResolver <URLPattern list> (admin:admin) 'admin/'>]], 'path': ''}

----------------------------------------------------------------------
Ran 1 test in 0.004s

FAILED (errors=1)
Destroying test database for alias 'default'...

URL과 뷰 함수 맵핑(예제 : 03-05)

Django 는 urls.py 에서 URL과 view 를 매핑할지 정의
superlists(project root)/superlists/urls.py - 전체 사이트 대상으로 하는 메인 urls.py

참고 사항) 2판 기준 책이 django 1.7 기준이다. 굳이 예전버전을 쓸 필요는 없으므로 최신의 2.2 버전으로 최대한 예제를 따라 진행한다. 크게 바뀐 내용은 3가지 정도 요약됨

django.conf.urls.url 로 매핑하던 내용이 django.urls.path 로 표준적인 설정이 바뀜(이전것도 사용가능하나. django 에서는 path를 기본으로 함)
따라서 url pattern 입력이 정규식 표현에서 path convert 방식으로 바뀜
문자열로 view 경로 설정 방식 제외. 직접 view 를 import 함

책의 내용과 비슷하게 아래와 같이 urls.py 를 변경해 진행해보면

from django.contrib import admin
from django.urls import path
from lists import views as home_views

urlpatterns = [
    # path('admin/', admin.site.urls),
    path('', home_views.home_page, name='home'),
]

$ python manage.py test
Creating test database for alias 'default'...
Destroying test database for alias 'default'...
Traceback (most recent call last):
(...생략...)
  File "/test_driven_development_with_python/ch03_Testing_a_Simple_Home_Page_with_Unit_Tests/03-05/superlists/superlists/urls.py", line 22, in <module>
    path('/', lists.views.home_page, name='home'),
  File "~/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/django/urls/conf.py", line 73, in _path
    raise TypeError('view must be a callable or a list/tuple in the case of include().')
TypeError: view must be a callable or a list/tuple in the case of include().

urls.py 에 view와 url 매핑은 했으나,아직 lists.views.home_page 가 None 값으로 아직 미구현 되어서 나타나는 에러이다.

다시 lists/views.py 로 돌아가서 실제 view 를 함수로 구현해보자.

view 구현 코드

테스트를 실행해보면

python manage.py test
Creating test database for alias 'default'...
System check identified no issues (0 silenced).
.
----------------------------------------------------------------------
Ran 1 test in 0.001s

OK
Destroying test database for alias 'default'...

첫 테스트가 성공했다! 사이트 루트(”/”) 요청을 django view 까지 연결하는 것이 성공했다는 의미이다.

뷰를 위한 단위 테스트(예제 : 03-06)

이제 사이트 루트 요청에 실제 HTML 응답값을 반환하는 내용도 추가해야 함
위의 내용을 검증하는 테스트 코드 추가가 먼저

tests 구현 코드

추가된 테스트는 요약하면 response body 텍스트가

<html>
<title>To-Do lists</title>
</html>

내용으로 오는지 검증하는 내용이다.

python manage.py test
======================================================================
ERROR: test_home_page_returns_correct_html (lists.tests.HomePageTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "/Users/pilhwankim/Github/books/test_driven_development_with_python/ch03_Testing_a_Simple_Home_Page_with_Unit_Tests/03-06/superlists/lists/tests.py", line 15, in test_home_page_returns_correct_html
    response = home_page(request)
TypeError: home_page() takes 0 positional arguments but 1 was given

----------------------------------------------------------------------
Ran 2 tests in 0.001s

FAILED (errors=1)

의도적으로 테스트를 돌려보면 실패한다. 이제 구현해야 한다.

단위 테스트-코드 주기

터미널에서 단위 테스트를 실행하여 어떻게 실패하는지 확인한다.
편집기 상에서 현재 실패 테스트를 수정하기 위한 최소한의 코드를 변경한다.

코드 품질을 높이고자 한다면 코드 변경은 최소화 한다. 즉 이 케이스에서는

home_page() takes 0 positional arguments but 1 was given

라고 했기 때문에 home_page 함수에 argument를 1개 추가하는 최소한의 코드를 변경하고 다시 테스트 해야한다.

코드 변경(request 추가)

def home_page(request):
    pass

테스트

======================================================================
ERROR: test_home_page_returns_correct_html (lists.tests.HomePageTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "/superlists/lists/tests.py", line 16, in test_home_page_returns_correct_html
    self.assertTrue(response.content.startswith(b'<html>'))
AttributeError: 'NoneType' object has no attribute 'content'

----------------------------------------------------------------------

home_page 에 리턴값 없이 None 으로 오기 때문이다. 그래서 코드 변경은?

코드 변경(return 에 django.http.HttpResponse 사용)

from django.http import HttpResponse

def home_page(request):
    return HttpResponse()

테스트

======================================================================
FAIL: test_home_page_returns_correct_html (lists.tests.HomePageTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "/superlists/lists/tests.py", line 16, in test_home_page_returns_correct_html
    self.assertTrue(response.content.startswith(b'<html>'))
AssertionError: False is not true

----------------------------------------------------------------------
Ran 2 tests in 0.007s

리턴값 객체는 맞게 왔으나 contents 가 없기 때문이다. contents를 채울 코드 변경은?

코드 변경(HttpResponse 에 html content 텍스트 넣기)

from django.http import HttpResponse


def home_page(request):
    return HttpResponse('<html><title>To-Do lists</title></html>')

테스트

python manage.py test
Creating test database for alias 'default'...
System check identified no issues (0 silenced).
..
----------------------------------------------------------------------
Ran 2 tests in 0.002s

OK
Destroying test database for alias 'default'...

드디어 하나의 단위 테스트가 완결되었다!

이전에 개발했었던 기능 테스트(functional_test.py)를 다시 실행해보자!

# shell을 2개 띄우고 한쪽에는 django 서버를 띄움 
$ python manage.py runserver

# 다른 한쪽에서 기능 테스트 실행
$ python functional_test.py
F
======================================================================
FAIL: test_can_start_a_list_and_retrieve_it_later (__main__.NewVisitorTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "functional_test.py", line 21, in test_can_start_a_list_and_retrieve_it_later
    self.fail('Finish the test!')
AssertionError: Finish the test!

----------------------------------------------------------------------
Ran 1 test in 2.256s

FAILED (failures=1)

unittest 결과는 실패로 나오지만 self.fail()가 실행되어 asserionError 가 난 것이므로 이전 test 는 통과한 것이다. 첫번째 기능 테스트도 성공이다!

느낀점

이 장에서 저자가 독자들이 깨닫기 원하는 핵심적인 내용은 단위 테스트-코드 주기 와 최소한의 코드 변경 이 아닌가 싶다. 사실 기능이나 코드 양으로 따지면 되게 적은 양인데 저렇게 까지 자주 테스트 해야하나? 라는 생각도 든다. 하지만 여기서 이렇게 세밀한 스텝을 언급하는 이유는 아마도 TDD가 어떤 것인지 실제 경험해 보기 위함이라는 생각이 든다. 한번에 한 가지씩! 한번에 아주 작은 스텝을 밟아나가기! 실제 TDD를 개발하는 방법이 이렇다는걸 잘 깨닫게 된 계기가 된 것 같다.

파이썬을 이용한 클린 코드를 위한 테스트 주도 개발 - 2장 unittest 모듈을 이용한 기능 테스트 확장

Mon, 23 Dec 2019 11:00:00 GMT

앞으로 나아갈 방향

To-Do 웹 에플리케이션 개발

왜 선택했는가?

최소한의 실현 가능한(MinimumViableProduct) 예제로 적합
어떤 형태로든 확장이 가능하다.(마감일, 알람, 공유 기능 등..)
웹 프로그래밍 전반적인 내용과 TDD 를 배울 수 있음

기능 테스트

기능 테스트란 무엇인가?

사용자 관점의 테스트
특정 기능을 사용자가 어떻게 사용하며 이때 애플리케이션이 어떻게 반응하는지 확인하는 방식
Functional Test == Acceptance Test == End to End Test
사람이 이해할수 있는 스토리를 가지고 있어야 함
테스트 코드에 스토리를 주석으로 기록하여 먼저 작성 가능하다.

맨 마지막의 스토리를 주석으로 먼저 작성하는 방식은 좀 신선하다.

스토리 주석이 추가된 기능 테스트 코드 보기

실제 실행시켜 보면

# 먼저 파이썬 서버를 실행
$ cd superlists
$ python manage.py runserver

# FT(Functional Test) 실행
$ python functional_test.py
Traceback (most recent call last):
  File "functional_test.py", line 10, in <module>
    assert 'To-Do' in browser.title
AssertionError

아직 브라우저 타이틀을 변경한 적이 없어서 실패한다.

unittest로 바꾸기

pure python 테스트 코드의 문제점

assert 조건이 맞지 않을시 발생하는 AssertionError 메시지가 명시적으로 우리 기능의 무엇이 문제인지 알려주지 않음(단순 Exception 메시지)
열려있는 크롬 브라우저 창을 테스트 종료시에 닫아주려면 try/finally 처리 필요하나 테스트마다 반복되는 코드가 발생함
고로 이 모든걸 제공하는 unittest가 필요하다

적용된 코드 보기

모든 테스트는 test_ 로 시작하는 명칭으로 된 메서드만 실행한다. 현재 코드는 testcanstartalistandretrieveitlater 가 테스트 메서드다
setUp/tearDown 메서드는 각 테스트 메서드의 시작전/후로 실행한다. 각 테스트에 공통된 전후처리를 할때 사용한다
assert 대신에 TestCase 의 self.assert* 메서드로 결과 검증을 한다.
self.fail 은 강제적으로 테스트 실패를 발생시켜 에러 메시지를 출력한다.
if name == ’main’: 은 다른 스크립트에 임포트되서 실행할 경우에는 실행되지 않는다. python 명령으로 실행될 시 실행된다. unittest.main() 은 테스트 실행자를 run 하는 코드이다. 또한 자동으로 파일내 test코드들을 찾아서 실행시켜 준다.

실행시 결과

$ python functional_test.py

F
======================================================================
FAIL: test_can_start_a_list_and_retrieve_it_later (__main__.NewVisitorTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "functional_test.py", line 19, in test_can_start_a_list_and_retrieve_it_later
    assert 'To-Do' in self.browser.title
AssertionError

----------------------------------------------------------------------
Ran 1 test in 4.884s

FAILED (failures=1)

파이썬을 이용한 클린 코드를 위한 테스트 주도 개발 - 1장 기능 테스트를 이용한 Django 설치

Mon, 23 Dec 2019 10:00:00 GMT

Testing Goat

염소가 소리친다. “테스트를 먼저 해! 테스트를 먼저 하라고!”
사실 개발할 때는 잠시 테스트가 생각이 나지만 귀차니즘 + 시간부족에 초조함 등의 복합적인 생각이 들어 실천하지 않는 경우가 많다.
먼저 테스트를 작성한 후 실행 -> 예상대로 실패하는지 확인 -> 실제 코드 작성 -> 테스트 작성 2 -> (무한 반복…)
염소는 1번에 1가지만 행동 함.

실전 - Django를 이용한 애플리케이션 개발

첫번째 예제 보기

첫 단계 : Django가 제대로 설치되었는지 확인
- Django 개발 서버 가동
- 서버에 있는 웹 페이지 로컬 PC상의 브라우저 접속(셀레늄 브라우저 자동화 툴)

실행하면 어떻게 될까?

$ python3 functional_test.py
Traceback (most recent call last):
  File "functional_test.py", line 1, in <module>
    from selenium import webdriver
ModuleNotFoundError: No module named 'selenium'

예상대로 안된다. 이제 이걸 되게 해야한다. selenium 파이썬 패키지가 안 깔려 있었다. 그래서 pip 로 추가했다.

pip install selenium

다시 실행하면 다음과 같은 에러가 뜬다

$ python3 functional_test.py

Traceback (most recent call last):
  File "functional_test.py", line 3, in <module>
    browser = webdriver.Firefox()
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/selenium/webdriver/firefox/webdriver.py", line 164, in __init__
    self.service.start()
  File "/Users/pilhwankim/.pyenv/versions/tdd-with-python-env/lib/python3.7/site-packages/selenium/webdriver/common/service.py", line 83, in start
    os.path.basename(self.path), self.start_error_message)
selenium.common.exceptions.WebDriverException: Message: 'geckodriver' executable needs to be in PATH.

두 가지 실행 되지 않는 문제를 예상해 볼 수 있는데

예제와 달리 내 PC에 크롬만 사용중이다.
특정 드라이버가 PATH에 존재해야 한다.

나는 파이어 폭스를 쓰긴(설치하긴) 싫으므로 예제를 변경했다.

변경한 테스트 예제

검색을 통해 드라이버를 인스톨하고 실행하는 법을 찾았다.

크롬은 실행이 잘 되었다. 다만 장고 웹서버가 띄워지지 않아서 웹 화면은 띄워지지 않았다.

$ python3 functional_test.py

Traceback (most recent call last):
  File "functional_test.py", line 6, in <module>
    assert 'Django' in browser.title
AssertionError

이제 Django 웹 서비스를 실제로 띄워 볼 차레이다. 이런 문제를 해결하는 과정 자체가 TDD라고 생각한다.

먼저 검증할 수 있는 수단(TestCase)을 먼저 만든다.
검증이 실패하는 것을 확인한다.
해결책을 찾아 적용한다.
테스트를 통해 검증해 본다. 실패하면 또 해결책을 찾아 적용한다.
테스트를 돌려봐서 성공하면 TDD 한 싸이클이 완성된다.

$ django-admin startproject superlists
# 장고 프로젝트가 생성된다.
$ cd superlists
# 장고 서버 실행 명령
$ python manage.py runserver
atching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).

You have 17 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.

November 26, 2019 - 22:20:42
Django version 2.2.7, using settings 'superlists.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

새로운 shell 을 실행시켜서 이전의 테스트 코드를 다시 돌려보자.

python functional_test.py

사실 직접 크롬을 띄우고 localhost:8000 을 입력한 것을 자동화 한 것 밖에는 없지만 저자가 이 장을 이렇게 장황하게 만든건 의미가 있다고 본다.

Testing Goat 를 설명하면서 TDD의 기본적인 전제를 확실히 익히려는 의도
TDD는 프로젝트 시작하는 순간부터 가능하다는 것을 보여주려는 의도

아무튼 첫번째 장을 마쳤다. 어떤 고급진 스킬이 있는 장은 아니지만 이 책의 저자에게는 바둑의 포석과 같은 1장이 아니었나 생각한다.

파이썬을 이용한 클린 코드를 위한 테스트 주도 개발

Mon, 23 Dec 2019 09:00:00 GMT

설치

pyenv-virtualenv, direnv 가 설치되어 있다는 가정하에 시작한다.

# python 3.7 설치
pyenv install 3.7.4

# virtualenv 환경 생성
pyenv virtualenv 3.7.4 tdd-with-python-env

# .envrc 등록
echo "source activate tdd-with-python-env" > .envrc

# 현재 디렉토리를 direnv 경로 등록
direnv allow

# pip 로 pypi 패키지 설치
pip install -r requirements.txt

참고 글

pyenv-virtualenv 설치 1 : https://www.44bits.io/ko/post/direnv_for_managing_directory_environment
pyenv-virtualenv 설치 2 : http://taewan.kim/post/python_virtual_env/

1부 TDD와 Django 개요

1장 기능 테스트를 이용한 Django 설치

2장 unittest 모듈을 이용한 기능 테스트 확장

3장 단위 테스트를 이용한 간단한 홈페이지 테스트

4장 왜 테스트를 하는 것인가(그리고 리펙토링)?

5장 사용자 입력 저장하기

2부 웹 개발 핵심편

3부 고급편

부록 테스트 고트님께 복종하라

about

Sun, 27 Jan 2019 16:21:13 GMT

Pilhwan Kim

About

Pilhwan Kim is a backend Developer at PeopleFund(https://peoplefund.co.kr). I have skills for python and java web programming. I have focused on verifiable and reliable backend development by TDD(Test-driven Development) and OOP(Object-Oriented Programming) principles.

I have various experiences in web development of information systems such as IoT(Internet of Things) monitoring solution, SNS, Fin-tech platform.

The fear of the LORD is the beginning of wisdom, and knowledge of the Holy One is understanding. - Proverbs 9:10

Specialties:

Web development experience of Django, Spring
HTTP and Rest API knowledge, design and implementation
RDB & NoSQL configuration and data modeling
Development in AWS cloud
CI experience (git, Jenkins, Confluence, AWS codebuild)

Skills:

Back-End
- Python
- Django
- Java
- Spring
- Apache
- Nginx
- RabbitMq
- Linux(Ubuntu, Centos)
- AWS
DB
- MySQL
- Redis
- Cassandra
Development Tool
- Pycharm
- Intellij
- Confluence
- Jira
- Git / Github
- Jenkins
- Slack