Pre-release
This release is a pre-release and may not be stable for production use.
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.
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
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.
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
4 maintainers
Metadata
4 maintainers
Release files for pydoctor 0.6b2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pydoctor-0.6b2.tar.gz | 102.3 kB | Details |
Release files / pydoctor-0.6b2.tar.gz
| Download URL | pydoctor-0.6b2.tar.gz |
|---|---|
| Size | 102.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f36a89789561bf512b0dac466b85a2914bb1b6139e0ede9b57d535312a69fe5b
|
|
BLAKE2b-256 checksum How to use checksums |
eae5244389959adcb97ba3d5923a32f00cab2f0e1ba87a235837e6d56998613e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
