The doctest module provides us with a way to validate documentation strings. In addition to docstrings in the code, any document with a Python REPL-style response can be tested via doctest. This will combine the documentation for modules, classes, functions, and test cases into one tidy package.
doctest cases are written into docstrings. A doctest case shows us the interactive Python prompt, >>>; statements; and the expected responses. The doctest module contains an application that looks for these examples in docstrings. It runs the given examples and compares the expected results shown in the docstrings with the actual outputs.
With the careful design of an API, we can create a class that can be used interactively. If it can be used interactively, then a doctest example can be built to show the expected results of the interaction.
...