./textproc/py-doctor, Python API document generator

[ CVSweb ] [ Homepage ] [ RSS ] [ Required by ] [ Add to tracker ]


Branch: CURRENT, Version: 24.3.3, Package name: py312-doctor-24.3.3, Maintainer: kamelderouiche

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 at this stage :)

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.


Required to run:
[net/py-twisted] [devel/py-setuptools] [devel/epydoc] [lang/python27]

Required to build:
[pkgtools/cwrappers]

Master sites:

Filesize: 914.544 KB

Version history: (Expand)


CVS history: (Expand)


   2024-11-11 08:29:31 by Thomas Klausner | Files touched by this commit (862)
Log message:
py-*: remove unused tool dependency

py-setuptools includes the py-wheel functionality nowadays
   2024-10-14 08:46:10 by Thomas Klausner | Files touched by this commit (325)
Log message:
*: clean-up after python38 removal
   2024-06-11 18:03:28 by Adam Ciarcinski | Files touched by this commit (2) | Package updated
Log message:
py-doctor: updated to 24.3.3

pydoctor 24.3.3

Fix release pipeline.

pydoctor 24.3.0

This is the last major release to support Python 3.7.

Drop support for Python 3.6.
Add support for Python 3.12.
Astor is no longer a requirement starting at Python 3.9.
ExtRegistrar.register_post_processor() now supports a priority argument that is \ 
an int. Highest priority callables will be called first during post-processing.
Fix too noisy --verbose mode (suppres some ambiguous annotations warnings).
Fix type processing inside restructuredtext consolidated fields.
Add options --cls-member-order and --mod-member-order to customize the \ 
presentation order of class members and module/package members, the supported \ 
values are "alphabetical" or "source". The default behavior \ 
is to sort all members alphabetically.
Make sure the line number coming from ast analysis has precedence over the line \ 
of a ivar field.
Ensure that all docutils generated css classes have the rst- prefix, the base \ 
theme have been updated accordingly.
Fix compatibility issue with docutils 0.21.x
Transform annotations to use python 3.10 style: typing.Union[x, y] -> x | y; \ 
typing.Optional[x] -> x | None; typing.List[x] -> list[x].
Do not output useless parenthesis when colourizing subscripts.
   2023-12-04 07:08:54 by Adam Ciarcinski | Files touched by this commit (1)
Log message:
py-doctor: add TOOL_DEPENDS
   2023-12-04 07:07:50 by Adam Ciarcinski | Files touched by this commit (4) | Package updated
Log message:
py-doctor: updated to 23.9.1

pydoctor 23.9.1

Fix regression in link not found warnings' line numbers.

pydoctor 23.9.0

This is the last major release to support Python 3.6.

Do not show **kwargs when keywords are specifically documented with the keyword \ 
field and no specific documentation is given for the **kwargs entry.
Fix annotation resolution edge cases: names are resolved in the context of the \ 
module scope when possible, when impossible, the theoretical runtime scopes are \ 
used. A warning can be reported when an annotation name is ambiguous (can be \ 
resolved to different names depending on the scope context) with option -v.
Ensure that explicit annotation are honored when there are multiple declarations \ 
of the same name.
Use stricter verification before marking an attribute as constant:
instance variables are never marked as constant
a variable that has several definitions will not be marked as constant
a variable declaration under any kind of control flow block will not be marked \ 
as constant
Do not trigger warnings when pydoctor cannot make sense of a potential constant \ 
attribute (pydoctor is not a static checker).
Fix presentation of type aliases in string form.
Improve the AST colorizer to output less parenthesis when it's not required.
Fix colorization of dictionary unpacking.
Improve the class hierarchy such that it links top level names with intersphinx \ 
when possible.
Add highlighting when clicking on "View In Hierarchy" link from class page.
Recognize variadic generics type variables (PEP 646).
Fix support for introspection of cython3 generated modules.
Instance variables are marked as such across subclasses.
   2023-08-12 02:31:02 by David H. Gutteridge | Files touched by this commit (1)
Log message:
py-doctor: restore not for Python 3.8 setting (fix bulk builds)

This is marked not for 3.8 because py-lunr is, which in turn is because
py-nltk is, which is in turn evidently because py-numpy is (though,
there it is only a TEST_DEPENDS).
   2023-08-11 15:01:29 by Adam Ciarcinski | Files touched by this commit (3) | Package updated
Log message:
py-doctor: updated to 23.4.1

pydoctor 23.4.1

Pin urllib3 version to keep compatibility with cachecontrol and python3.6.

pydoctor 23.4.0

Add support for Python 3.11
Add support for the @overload decorator.
Show type annotations in function's signatures.
If none of a function's parameters have documentation, do not render the \ 
parameter table.
Themes have been adjusted to render annotations more concisely.
Fix a rare crash in the type inference. Invalid python code like a set of lists \ 
would raise a uncaught TypeError in the evaluation.
Support when source path lies outside base directory (--project-base-dir). Since \ 
pydoctor support generating docs for multiple packages, it is not certain that \ 
all of the source is even viewable below a single URL. We now allow to add \ 
arbitrary paths to the system, but only the objects inside a module wich path is \ 
relative to the base directory can have a source control link generated.
Cache the default docutils settings on docutils>=0.19 to improve performance.
Improve the search bar user experience by automatically appending wildcard to \ 
each query terms when no terms already contain a wildcard.
Link recognized constructors in class page.
An invalid epytext docstring will be rederered as plaintext, just like invalid \ 
restructuredtext docstrings (finally).
   2023-07-30 17:32:50 by Adam Ciarcinski | Files touched by this commit (19)
Log message:
Remove dependencies for Python 3.7