Trait-Documenter
Trait-Documenter is an autodoc extension to allow trait definitions to be properly rendered in sphinx.
Installation
Development versions can be found at https://github.com/enthought/trait-documenter.
The package requires a recent version of sphinx, traits and astor to function properly.
Usage
Add the trait-documenter to the extensions variable in your conf.py:
extensions.append('trait_documenter')
Warning
Using the TraitDocumenter in conjunction with the TraitsDoc package is not advised.
Example
A class trait with a docstring:
from traits.api import HasTraits, Float class MyClass(HasTraits): #: A float number. number = Float(2.0)
Will be rendered as:
.. py:attribute:: number :annotation: = Float(2.0) A float number.