Skip to main content

Sphinx extension: auto-generates API docs from Zope interfaces

Project description

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 easy_install:

$ bin/easy_install repoze.sphinx.autointerface

or any other means which gets the package on your PYTHONPATH.

Registering the Extension

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

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

Using the Extension

At appropriate points in your document, call out the interface autodocs via:

.. autointerface:: yourpackage.interfaces.IFoo

Output from the directive includes

  • the fully-qualified interface name

  • any base interfaces

  • the doctstring from the interface, rendered as reSTX.

  • 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 reSTX).

repoze.sphinx.autointerface Changelog

0.6.2 (2011-02-13)

  • Fix TypeError: 'NoneType' object is not iterable error when generating a rendering of an interface under Python 2.7.

0.6.1 (2011-01-28)

  • Fix ‘:member-order: bysource’ handling.

0.6 (2011-01-28)

  • Correctly handle ‘:members:’ values explicitly set in the directive.

0.5 (2011-01-18)

  • Added support for the ‘:member-order:’ flag, which can take one of the three stock values, “alphabetical”, “groupwise”, or “bysource”. By default, members are documented in “hash” order.

0.4 (2010-07-26)

  • Fixed compatibility with Sphinx 1.0

  • Un-break PyPI ReST/HTML-rendering again.

0.3 (2009-10-25)

  • Refactor sphinx integration. There are now separate autointerface and interface directives.

0.2.1 (2009-08-20)

  • Fix add_directive arguments to work with Sphinx 0.6.1, now required.

0.1.3 (2009-01-14)

  • Coerce unicode path elements to str in _resolve_dotted_name. Note that non-ASCII path elements won’t work: this fix just deals with the case where the path was of type unicode.

  • Fixed spelling of directive in README.txt.

  • Added dependency on zope.interface.

0.1.2 (2008-10-03)

  • Packaging change: improved description in README.txt.

0.1.1 (2008-10-03)

  • Packaging bug: the long_description was not rendering properly to HTML on PyPI.

0.1 (2008-10-02)

  • Initial release.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

repoze.sphinx.autointerface-0.6.2.tar.gz (9.2 kB view details)

Uploaded Source

File details

Details for the file repoze.sphinx.autointerface-0.6.2.tar.gz.

File metadata

File hashes

Hashes for repoze.sphinx.autointerface-0.6.2.tar.gz
Algorithm Hash digest
SHA256 f2294cc4b5c59171d097003772670bc4a46498fa36ec510712cb0cc2d9b43d19
MD5 d0fc61d58ec19034b1c5a91789d07bdc
BLAKE2b-256 66df80202506cd6c3e2b9d074584762ec07f6c2fd1d99f3ff61651a4dc864bf0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page