Skip to content

repoze/repoze.sphinx.autointerface

Repository files navigation

repoze.sphinx.autointerface README

Overview

Thie package defines an extension for the Sphinx documentation system. The extension allows generation of API documentation by introspection of zope.interface instances in code.

Installation

Install via pip:

pip install repoze.sphinx.autointerface

Registering the Extension

Add repoze.sphinx.autointerface to the extensions list in the conf.py of the Sphinx documentation for your product.

extensions = [
    "sphinx.ext.autodoc",
    "sphinx.ext.doctest",
    "repoze.sphinx.autointerface",
]

Using the Extension

At appropriate points in your document, call out the autodoc interface.

.. autointerface:: yourpackage.interfaces.IFoo

Output from the directive includes

  • the fully-qualified interface name
  • any base interfaces
  • the docstring from the interface, rendered as reStructuredText
  • the members of the interface (methods and attributes)
    • For each attribute, the output includes the attribute name and its description.
    • For each method, the output includes the method name, its signature, and its docstring (also rendered as reStructuredText).