sphinxcontrib-zopeext 0.4.0

Provides sphinxcontrib.zopeext.autointerface for documenting Zope interfaces.

Author:

Michael McNeil Forbes <[e-mail]>

This extension provides an autointerface directive for Zope interfaces.

Requirements

• Sphinx: pip install sphinx

• zope.interface: pip install zope.interface

• sphinxcontrib.zopeext: pip install sphinxcontrib-zopeext

Usage

In the build configuration file (the conf.py in your Sphinx documentation directory) add sphinxcontrib.zopeext.autointerface to your extensions list:

extensions = [..., 'sphinxcontrib.zopeext.autointerface', ...]

Then, in your documentation, use autointerface as you would use autoclass. You can refer to the interface with the :py:interface: role example.IMyInterface as you would use the :py:class: role to refer to the implementation example.MyImplementation:

.. automodule:: example
   :show-inheritance:
   :inherited-members:

One can also limit which members are displayed, just as you would with .. autoclass:

.. autointerface:: example.IMyInterface
   :members: x, equals
.. autoclass:: example.MyImplementation
   :members: x, equals