semvec/pypi-packages huggingface dataset:
trait_documenter 1.1.0
Autodoc extention for documenting traits
License: BSD

Trait-Documenter
================

.. image:: https://travis-ci.org/enthought/trait-documenter.svg?branch=master
   :target: https://travis-ci.org/enthought/trait-documenter

.. image:: http://codecov.io/github/enthought/trait-documenter/coverage.svg?branch=master
   :target: http://codecov.io/github/enthought/trait-documenter?branch=master

.. image:: https://readthedocs.org/projects/trait-documenter/badge/?version=latest
   :target: https://readthedocs.org/projects/trait-documenter/?badge=master


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.