API doc generator.
Project description
pydoctor
========
.. image:: https://travis-ci.org/twisted/pydoctor.svg?branch=tox-travis-2
:target: https://travis-ci.org/twisted/pydoctor
.. image:: https://codecov.io/gh/twisted/pydoctor/branch/master/graph/badge.svg
:target: https://codecov.io/gh/twisted/pydoctor
This is 'pydoctor', an API documentation generator that works by
static analysis.
It was written primarily to replace epydoc for the purposes of the
Twisted project as epydoc has difficulties with zope.interface. If it
happens to work for your code too, that's a nice bonus :)
pydoctor puts a fair bit of effort into resolving imports and
computing inheritance hierarchies and, as it aims at documenting
Twisted, knows about zope.interface's declaration API and can present
information about which classes implement which interface, and vice
versa.
The default HTML generator requires Twisted.
There are some more notes in the doc/ subdirectory.
Tox development environment
---------------------------
Since Python 3 is not yet supported, you the case in which your default
tox runs with Python 3, call the tox as::
python2 -m tox -e pyflakes
Sphinx Integration
------------------
HTML generator will also generate a Sphinx objects inventory using the
following mapping:
* packages, modules -> py:mod:
* classes -> py:class:
* functions -> py:func:
* methods -> py:meth:
* attributes -> py:attr:
Configure Sphinx intersphinx extension:
intersphinx_mapping = {
'pydoctor': ('http://domain.tld/api', None),
}
Use external references::
:py:func:`External API <pydoctor:pydoctor.model.Documentable.reparent>`
:py:mod:`pydoctor:pydoctor`
:py:mod:`pydoctor:pydoctor.model`
:py:func:`pydoctor:pydoctor.driver.getparser`
:py:class:`pydoctor:pydoctor.model.Documentable`
:py:meth:`pydoctor:pydoctor.model.Documentable.reparent`
:py:attr:`pydoctor:pydoctor.model.Documentable.kind`
It can link to external API documentation using Sphinx objects inventory using
the following cumulative configuration option::
--intersphinx=http://sphinx-doc.org/objects.inv
Releasing a new package
-----------------------
Releasing a new version is done via Travis-CI.
First commit the version update to master and wait for tests to pass.
Create a tag on local branch and then push it::
git tag 1.2.3
git push --tags
========
.. image:: https://travis-ci.org/twisted/pydoctor.svg?branch=tox-travis-2
:target: https://travis-ci.org/twisted/pydoctor
.. image:: https://codecov.io/gh/twisted/pydoctor/branch/master/graph/badge.svg
:target: https://codecov.io/gh/twisted/pydoctor
This is 'pydoctor', an API documentation generator that works by
static analysis.
It was written primarily to replace epydoc for the purposes of the
Twisted project as epydoc has difficulties with zope.interface. If it
happens to work for your code too, that's a nice bonus :)
pydoctor puts a fair bit of effort into resolving imports and
computing inheritance hierarchies and, as it aims at documenting
Twisted, knows about zope.interface's declaration API and can present
information about which classes implement which interface, and vice
versa.
The default HTML generator requires Twisted.
There are some more notes in the doc/ subdirectory.
Tox development environment
---------------------------
Since Python 3 is not yet supported, you the case in which your default
tox runs with Python 3, call the tox as::
python2 -m tox -e pyflakes
Sphinx Integration
------------------
HTML generator will also generate a Sphinx objects inventory using the
following mapping:
* packages, modules -> py:mod:
* classes -> py:class:
* functions -> py:func:
* methods -> py:meth:
* attributes -> py:attr:
Configure Sphinx intersphinx extension:
intersphinx_mapping = {
'pydoctor': ('http://domain.tld/api', None),
}
Use external references::
:py:func:`External API <pydoctor:pydoctor.model.Documentable.reparent>`
:py:mod:`pydoctor:pydoctor`
:py:mod:`pydoctor:pydoctor.model`
:py:func:`pydoctor:pydoctor.driver.getparser`
:py:class:`pydoctor:pydoctor.model.Documentable`
:py:meth:`pydoctor:pydoctor.model.Documentable.reparent`
:py:attr:`pydoctor:pydoctor.model.Documentable.kind`
It can link to external API documentation using Sphinx objects inventory using
the following cumulative configuration option::
--intersphinx=http://sphinx-doc.org/objects.inv
Releasing a new package
-----------------------
Releasing a new version is done via Travis-CI.
First commit the version update to master and wait for tests to pass.
Create a tag on local branch and then push it::
git tag 1.2.3
git push --tags
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pydoctor-16.3.0.tar.gz
(94.8 kB
view details)
File details
Details for the file pydoctor-16.3.0.tar.gz.
File metadata
- Download URL: pydoctor-16.3.0.tar.gz
- Upload date:
- Size: 94.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | e1f400d95b4fbdfbc2e5837ef7d8b8d8461c1801b706b58858e38c954201953e |
|
| MD5 | 1e94e1dfc8fc6f76fedc847bf082a860 |
|
| BLAKE2b-256 | ca482d43d52b9ed3869ab62b98baefc2bd10e526f2e80a8d65ab44c56213560e |
