[python] doctest 모듈은 어떻게 사용되나요?

doctest 모듈은 Python에서 코드의 예제를 포함하고 테스트하는 데 사용되는 내장 모듈입니다. 주석 안에 인터프리터 세션과 그 결과를 작성하는 방식으로 작성된 코드 예제를 실행하고 결과를 확인하여 코드가 제대로 작동하는지 확인할 수 있습니다. doctest 모듈은 테스트 주도 개발(Test-Driven Development) 접근 방식에 적합하며, 호출하려는 함수 또는 메소드에 예제와 예상 결과를 포함시킬 수 있습니다.

doctest 모듈을 사용하는 방법은 다음과 같습니다:

import doctest

def sum(x, y):
    """
    두 수를 더하는 함수입니다.

    >>> sum(2, 2)
    4
    >>> sum(5, 10)
    15
    >>> sum(-3, 7)
    4
    """

    return x + y

if __name__ == '__main__':
    doctest.testmod()

위의 예제에서는 sum 함수의 예제와 예상 결과를 주석으로 작성하였습니다. doctest.testmod() 함수를 호출하여 해당 모듈을 테스트할 수 있습니다. 실행 결과로 성공한 테스트의 개수와 실패한 테스트의 개수가 출력됩니다.

여기에서는 간단한 함수의 예시를 보여주었지만, doctest 모듈은 더 복잡한 코드와 클래스에도 적용될 수 있습니다. doctest의 세부적인 사용법과 API에 대해서는 Python 공식 문서 (https://docs.python.org/3/library/doctest.html)를 참조하십시오.