O'Reilly logo

Mastering Object-oriented Python by Steven Lott

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

Better output via the RST markup

Our documentation can be much nicer if we use a more sophisticated toolset. There are several things that we'd like to be able to do, such as the following:

  • Fine-tune the presentation to include emphasis such as bold, italic, or color.
  • Provide the semantic markup for the parameters, return values, exceptions, and cross-references among Python objects.
  • Provide a link to view the source code.
  • Filter the code that's included or rejected. We can fine-tune this filtering to include or exclude a number of components and members: standard library modules, private members with a leading __, system members with a leading __, or superclass members.
  • Adjust the CSS to provide a different style for the resulting HTML pages.

We can ...

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required