Triggered by this recent tweet advertising a new pytest plugin that can document itself, I want to briefly describe how you can get sphinx-autodoc to recognize and document the tests.
It is slightly more work since you have to tell Sphinx to auto-document each
individual module manually. At least, I haven't yet spent the time to os.walk
the test directory and document each one. Assuming the following project