doctest는 Python의 내장된 테스트 프레임워크로, 함수/모듈의 동작을 확인하기 위해 인터페이스 예제를 사용합니다. 이를 활용하여 HTML 렌더링 테스트를 수행할 수도 있습니다.

아래는 HTML을 렌더링하는 함수를 예시로 사용하여 doctest를 작성하는 방법입니다.

우선, 다음과 같이 HTML을 렌더링하는 함수를 작성합니다:

def render_html(html):
    """
    주어진 HTML 문자열을 렌더링하여 결과를 반환합니다.

    >>> render_html("<h1>Title</h1>")
    '<h1>Title</h1>'
    >>> render_html("<p>Paragraph</p>")
    '<p>Paragraph</p>'
    >>> render_html("<div><h1>Title</h1><p>Paragraph</p></div>")
    '<div><h1>Title</h1><p>Paragraph</p></div>'
    """
    return html

위 예제에서는 주어진 HTML을 그대로 반환하는 함수를 작성했습니다. 이제 doctest 블록을 작성하여 함수 동작을 확인할 수 있습니다. doctest 블록은 함수 docstring 내부에 작성되며, 예제와 예상되는 결과 값을 작성합니다.

예를 들어 render_html("<h1>Title</h1>")를 호출했을 때 기대하는 결과 값은 '<h1>Title</h1>'입니다.

만약 doctest가 실패한 경우, 즉 예상된 결과 값과 실제 결과 값이 일치하지 않는 경우 실제 결과 값과 예상 값을 비교하여 오류 메시지를 생성합니다.

위 예제에서는 모든 doctest가 통과되도록 작성되었습니다. 만약 doctest가 실패하는 경우에는 오류 메시지와 함께 렌더링된 HTML 결과를 확인하여 문제를 해결할 수 있습니다.

doctest를 실행하려면 doctest 모듈을 import하고, doctest.testmod() 함수를 호출하면 됩니다:

import doctest

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

위와 같이 실행하면 doctest가 실행되며, 모든 테스트가 통과하는지 여부를 확인할 수 있습니다.

이제 위 예제를 참고하여 HTML 렌더링 함수의 doctest를 작성할 수 있습니다. 이를 통해 함수의 동작을 검증하고, 수정/개선하는 데 도움이 될 수 있습니다.