Python 3.x에서 문서 테스트를 위해 doctest 모듈을 사용하는 방법

Python 3.x에서 문서 테스트를 위해 doctest 모듈을 사용하는 방법

소개:
코드를 작성하는 과정에서 함수나 클래스의 사용법과 예상 출력을 설명하는 문서를 작성해야 하는 경우가 많습니다. 그러나 문서는 쉽게 오래되거나 부정확해질 수 있으며, 이로 인해 예상치 못한 결과나 잘못된 결과가 발생할 수 있습니다. 이 문제를 해결하기 위해 Python에서는 docstring에 예제 코드를 작성하고 실행 시 예상 결과를 충족하는지 확인할 수 있는 내장 모듈 doctest를 제공합니다.

1. doctest 모듈 소개
doctest 모듈은 코드 예제를 테스트하는 간단하고 안정적인 방법을 제공하는 Python 내장 모듈입니다. 이는 독스트링에 제공된 샘플 코드를 실행하고 해당 출력이 예상 출력과 일치하는지 확인함으로써 이를 수행합니다. doctest는 문서 작성과 테스트 작성을 하나로 결합하여 테스트 유지 관리를 더 쉽게 만듭니다.

2. doctest 작성 방법
doctest를 작성할 때 모듈, 함수 또는 메소드의 문서 문자열에 샘플 코드를 작성하고 를 사용해야 합니다. 샘플 코드와 예상 출력을 나타내기 위해 예상 결과 뒤에 태그를 추가합니다. 예를 들면 다음과 같습니다. 标记来表示示例代码和预期输出。比如以下的例子：

def add(a, b):
    """
    计算两个数的和
    
    示例：
    >>> add(2, 3)
    5
    
    >>> add(10, 5)
    15
    """
    return a + b

三、如何执行 doctest
我们可以使用 doctest 模块提供的 testmod() 函数来执行 doctest。这个函数会自动查找模块中的文档字符串并执行其中的示例代码，然后和预期输出进行比对。

import doctest

doctest.testmod()

四、运行结果
执行 doctest 后，如果所有示例代码的输出与预期输出相符，那么输出为空；如果有示例代码的输出与预期输出不符，那么会打印出错误信息。

下面是示例代码的运行结果：

**********************************************************************
File "example.py", line 5, in __main__.add
Failed example:
    add(2, 3)
Expected:
    5
Got:
    6
**********************************************************************
File "example.py", line 9, in __main__.add
Failed example:
    add(10, 5)
Expected:
    15
Got:
    16
**********************************************************************
1 items had failures:
   2 of   2 in __main__.add
***Test Failed*** 2 failures.

在这个例子中，我们可以看到有两个测试用例(add(2, 3) 和 add(10, 5))的结果与预期输出不符，因此 doctest 报告了两个失败。

五、如何扩展 doctest
除了简单的示例代码和预期输出之外，doctest 还支持更多高级的测试方式。比如，我们可以使用 ... 来表示多行输出，使用 # 来表示注释等。下面是一个更复杂的示例：

def average(numbers):
    """
    计算列表中数字的平均值
    
    示例：
    >>> average([1, 2, 3, 4, 5])
    3
    
    >>> average([10, 20, 30])
    20
    
    >>> average([])
    0
    
    >>> average([1, 2, 3, 4, 5, ...])
    3
    """
    if len(numbers) == 0:
        return 0
    return sum(numbers) / len(numbers)

这个示例使用了 ... 来表示多行输出，在最后一个示例中我们用 ...rrreee

doctest 모듈에서 제공하는 testmod() 함수를 사용하여 doctest를 실행할 수 있습니다. 이 함수는 자동으로 모듈에서 독스트링을 찾아 거기에서 샘플 코드를 실행한 다음 예상 출력과 비교합니다.
rrreee

doctest를 실행한 후 모든 샘플 코드의 출력이 예상 출력과 일치하면 출력이 비어 있고, 샘플 코드의 출력이 예상 출력과 일치하지 않으면 오류 메시지가 인쇄됩니다. .

위 내용은 Python 3.x에서 문서 테스트를 위해 doctest 모듈을 사용하는 방법의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!