Summary
In this chapter, you took a look at Python's doctest module. You saw how it helps you embed examples within docstrings. You looked at different ways to write doctests including method and package docstrings. You also looked at moving package level doctests into a separate file and running them. Maintaining doctests is important, and you looked at ways to maintain doctests better, using setup and teardown and including them in the regular test suite. Finally, you looked at some limitations and how you can use directives to overcome some of the limitations.
In the next chapter, you will get your first introduction to third-party tools with a look at the nose2 package.
