업데이트(2019.02.19): 파일열기모드 관련 내용 추가

python에서 with문의 용도와 쓰임을 알아보자

소개

기본적으로 거의 모든 프로그래밍 언어가 파일 입출력을 지원하며(어찌보면 당연한 이야기인가?…) 그러한 파일 입출력을 할 때 해당 파일을 위해 open과 close를 해줘야한다.

그러한 부분이 python에도 존재하며 혹시나 우리가 했을 법한 실수인 close를 해주는 부분을 빼먹을 수도 있기에 하나의 with문으로 묶어서 사용 할 수 있다.

기본적인 사용법

• 기본적인 사용법은 with expression as target: suite의 형태로 사용하면 된다.

다음 아래와 같은 코드를

file_data = open('file.txt')
print(file_data.readline(), end="")
file_data.close()

아래처럼 바꿀 수 있다.

with open('file.txt') as file_data:
    # 기본적으로 사용하는 함수를  with문 안에 사용하면 되며
    # with문을 나올 때 close를 자동으로 불러줍니다.
    print(file_data.readline(), end="")

파일 열기 모드

• 파일열기모드: 파일열기모드란 파일을 Binary형태로 읽을지 아니면 인코딩단위로 읽을지, 파일을 읽을건지 쓸건지 아니면 동시에 할건지에 대한 부분을 정하는 지시자라고 볼 수 있습니다.

• r: 읽기 모드, 파일을 읽을 때 사용합니다.
• w: 쓰기 모드, 파일에 쓸 때 사용하며 파일이 이미 동일한 이름으로 존재한다면 덮어씁니다.
• a: 추가 모드, 존재하는 파일에 추가할 때 사용하며 파일이 없다면 생성합니다.
• r+, w+, a+: 읽기모드 + 쓰기모드, w+와 a+의 차이는 위와 같습니다.
• rb, wb, ab, rb+, wb+, ab+: 각각의 모드들은 위와 동일하나 Binary 포맷으로 읽거나 쓰는걸 진행합니다.

쓰기(Write)

with open('file.txt', 'w') as file_data:
    file_data.write("First\n")
    file_data.write("Second")

읽기(Read)

with open('file.txt', 'r') as file_data:
    for line in file_data:
        print(line)

추가(Append)

with open('file.txt', 'a') as file_data:
    file_data.write("Third\n")

참고자료

• https://wikidocs.net/26
• https://www.tutorialspoint.com/python/python_files_io.htm
• https://stackoverflow.com/questions/9644110/difference-between-parsing-a-text-file-in-r-and-rb-mode

pytest를 설치는 하였고 이제 Exception을 처리하는 방법에 대해서 알아보자

환경 및 선수조건

• pytest의 설치와 기본 간단한 사용법

기본적인 사용법

• Exception의 오류를 잡기 위해서 pytest에서는 pytest.raises([Exception])이라는 함수를 통해서 실행시킵니다. 바로 코드를 보도록 하겠습니다.
• 아주 간단한 코드로 with문을 참고하시면 ()안에 있는 Exception이 발생하는지를 확인하는 코드입니다. with문 안에 1/0의 코드를 통해서 해당 Exception을 발생시킵니다.

test_zero_division.py

import pytest


def test_zero_division():
    # with문 괄호에 있는 Exception이 해당 block에서 일어나는지 확인하는 코드
    with pytest.raises(ZeroDivisionError):
        1 / 0

이제 코드를 작성하였으니 실행시켜봅시다.

참고자료

• https://docs.pytest.org/en/latest/assert.html

pytest를 설치하고 간단하게나마 테스트하는 방법에 대해서 포스팅해보려 한다.

환경 및 선수조건

• Python 3.x만 설치되어있으면 가능합니다.
• (선택) pyenv, virtualenv의 사용경험 및 방법 숙지
• (선택) virtualenv의 이름은 “pytest_practice”로 하고 진행

설치

다음 아래와 같이 pip를 통해서 pytest를 설치합니다.

$ pip install pytest

기본적인 사용법

파일생성 및 기본 테스트 예제

다음 아래과 같이 기본적인 샘플 코드를 만들고 프로젝트 폴더 안에 추가를 합니다.

simple_test.py

def test_simple_test():
  assert 1

아주 기본적인 테스트로 “assert 1”이 있기때문에 테스트를 통과하게 됩니다. 이제 다음으로 터미널에서 테스트를 진행해보도록 하겠습니다. 아래의 명령문을 입력해주면 simple_test.py에 있는 코드에서 test로 시작되는 함수들을 찾아서 테스트를 진행합니다.

$ pytest simple_test.py

다음 아래는 그 테스트 결과입니다.

테스트 오류 확인 예제

다음으로는 이제 테스트 오류가 어떻게 나는지 확인하기 위해서 아래와 같은 새로운 파일을 또 추가해 보겠습니다.

simple_another_test.py

def test_simple_another_test():
    assert 1

def test_simple_another_test_fail():
    assert 0

자 이제 그러면 테스트를 또 돌려봅시다. 이제는 2개의 파일이 있기 때문에 pytest만 명령어 창에 입력하도록 합시다.

$ pytest

그러면 다음과 같이 테스트 결과가 나오게 됩니다.

테스트 결과만 확인

다음과 같이 -q 옵션을 명령어에 추가해서 최종적인 테스트 결과만 확인도 가능합니다.

$ pytest -q

아래는 실행해본 결과입니다.

pytest를 썼을 때의 장점을 http://halfcooked.com/presentations/pyconau2013/why_I_use_pytest.html 의 링크에서 번역해 간단하게나마 정리를 해보았다.

Unit Testing이란?

• Unit Testing이란 어플리케이션이나 모듈의 각각 유닛들이 작성한대로 작성하는지 확인하는 반복적인 작업이다.

• Unit Testing의 핵심은 각각 테스트들이 서로 분리되어 있으며, 실행은 자동화되고, 테스트들은 당신이 만든 어플리케이션의 일부와 같은 부분을 실행한다는 것이다.

Unit Test를 왜 해야 할까?

다른 이유보다 앞서서 하는 이유는 “내 코드가 잘 작동하는지 확인하기 위해서”라는 것은 모두다 알고 계실겁니다.

Unit Test는 우리가 “어떻게” 코드를 작성할지 생각하는데 도움을 주게되며 나아가 테스트를 추가함을 통해서 당신의 코드를 줄일 수 있게되고 이러한 점들은 당신이 이해하고 테스트하는데 다시 또 도움을 주게 됩니다.

많은 작업을 하는 코드를 테스트 하는것은 어려우며 또한 디버깅하기도 어렵다. 이 문제의 해결은 코드가 많은 작업을 하지 않도록 하게 하는 것이며 그렇기에 함수 하나는 하나의 기능만 하도록 하고 이를 테스트 하게 하는것이다.

“그리고”라는 말을 표현해서 코드를 설명해야 한다면 그 코드는 줄일 수 있어야 한다.(하나의 함수는 하나의 기능만을 구현해야 하기 때문에)

Unit Test의 다른 장점로는 문제를 찾기 쉽다는 점, 변화를 가능하게 한다는 점, 디자인을 개선시키고 통합을 단순화 할 수 있다는 점들이 있다.

Unit Test 라이브러리들

테스트 라이브러이에는 대표적으로 unittest(파이썬 기본 내장 모듈)와 pytest가 있는데 저 본문에는 pytest를 선호한다고 나와있다.

그 이유는 코드를 비교적 더 간단하게 만들 수 있고 필요할 떄 더 많은 기능들을 강력하게 제공해주기 때문이라고 한다.

아래와 같은 코드를

from parse_conn import parse_connection
import unittest

class InvalidInputs(unittest.TestCase):
    def testNoAt(self):
        """parse_connection should raise an exception for an invalid connection string"""
        self.assertRaises(ValueError, parse_connection, 'invalid uri')

if __name__ == "__main__":
    unittest.main()

다음과 같이 바꿀 수 있다고 한다.

from parse_conn import parse_connection
import py.test

def test_not_at():
    py.test.raises(ValueError, parse_connection, 'invalid uri')

한눈에 봐도 비교적 코드가 많이 간결해졌음을 알 수 있다.

그러면 Unit Testing을 어떻게 시작해야할까?

테스팅을 할 수 있는 가장 쉬운 방법은 버그를 수정하는 방법이다.

첫번째로, 버그를 발견하고 그다음에 버그를 고칠 수 있는 최소한의 코드를 작성하고 마지막으로 테스트를 다 통과 할 때까지 코드를 수정하는 것이다.

앞서 말한것처럼 해서 테스팅을 시작 할 수 있고 이제 새로 작동해야하는 기능을 추가 할 때 최소한의 테스트를 만들고 그 테스트를 통과하는 코드들을 완성하는 방향으로 시작하면 된다.

참고자료

• http://halfcooked.com/presentations/pyconau2013/why_I_use_pytest.html

업데이트(2018.12.26): 2018년 3월에 작성한 자료로 현재의 Android Studio 버전과 다를 수도 있습니다.

Android Studio에 JUnit을 붙이고 간단한 테스트를 진행해 보기로 한다.

환경 및 선수조건

• Android Studio

app/build.gradle에 코드 추가

• JUnit과 Espresso 그리고 그 둘을 위한 annotations과 test:runner를 gradle에 아래처럼 추가합니다.
  

build.gradle

...
dependencies {
    ...
    testCompile 'junit:junit:4.12'
    androidTestCompile 'com.android.support:support-annotations:25.1.0'
    androidTestCompile 'com.android.support.test.espresso:espresso-core:2.2.2'
    androidTestCompile 'com.android.support.test:runner:0.5'
    ...
}
...

java 테스트 폴더 생성하기

• JUnit으로 테스트를 하려면 src폴더 안에 test 폴더를 만들고 그 안에 또 java라는 폴더를 생성합니다.
• 즉, src/test/java라는 폴더 생성
• SampleTest파일은 아래에 설명하겠지만 추후에 폴더를 생성하고 추가해주시면 됩니다.

SampleTest 작성하기

아래와 같이 테스트를 하기 위한 간단한 테스트샘플 클래스를 생성해보도록 합시다.

Annotation(@RunWith와 @Test) 주의해서 작성해주세요!

SampleTest.java

import org.junit.Test;
import org.junit.runner.RunWith;
import org.junit.runners.JUnit4;

import static org.junit.Assert.assertTrue;

@RunWith(JUnit4.class)
public class SampleTest {

   @Test
   public void TestSample() {
       assertTrue(true);
   }

}

• Annotation에서 @RunWith(JUnit4.class)를 명시해주셔야만 합니다!
• 아주 간단한 테스트로 assertTrue()함수에서 내부의 결과가 true인지를 확인하는 코드입니다. JUnit을 어떻게 사용하는지에 대한 간략한 설명이기에 테스트 코드는 간략하게 작성하였습니다:)

Android Studio에서 JUnit 테스트 돌려보기

이제 작성한 코드를 돌려보도록 합시다. src/java폴더에서 우클릭을 하시면 다음과 같이 Run 'Tests in 'java''가 뜨는데 눌러주도록 합시다,

테스트 결과

위에 Test를 돌리면 아래처럼 테스트가 돌아가는것을 Android Studio에서 확인이 가능합니다.

Circle CI에서 테스트 하도록 circle.yml 수정하기

Circle CI에서도 테스트를 진행하도록 하기 위해서 다음과 같이 circle.yml에 추가를 하도록 합니다. 자동적으로 ./gradlew test를 진행하긴 하지만… 다음에 포스팅 할 Espresso와 함께 테스팅 하려면 수동으로 설정을 해줘야 하니 미리 해주었습니다:)

circle.yml

...
dependencies:
  override:
     - chmod +x gradlew

test:
  override:
    - ./gradlew test
...

참고자료

• https://circleci.com/docs/language-java/