Maybe use ReST include directives

[deeplook]

... if there's no policy of having everything in the ReST files. If not, includes would minimise the risk of code files and doc files being out of sync. And the ReST include directive has many options to pick only what you want, if you don't want to shoe the entire file. In the simplest case an include looks like this:

.. include:: code/anatomy.py
    :code: python

See http://docutils.sourceforge.net/docs/ref/rst/directives.html#including-an-external-document-fragment

[rougier]

I agree this is problematic, but it would need more work to split source code properly and get rid of copyright headers, some comments, etc.