[Twisted-Python] pydoctor 20.7.0

Maarten ter Huurne maarten at treewalker.org
Fri Jul 3 09:01:27 MDT 2020


Hi all,

I'm happy to announce that a new release of pydoctor, the documentation 
extractor used by Twisted, is available on PyPI.

https://pypi.org/project/pydoctor/

Thanks to everyone who contributed with patches and reviews!


Major changes in this release:

- Python 3 support
- Type annotations on attributes are supported when running on Python 3
- Type comments on attributes are supported when running on Python 3.8+
- Type annotations on function definitions are not supported yet
- Undocumented attributes are now included in the output
- Attribute docstrings: a module, class or instance variable can be 
documented by a following it up with a docstring
- Improved error reporting: more errors are reported, error messages 
include file name and line number
- Dropped support for implicit relative imports
- Explicit relative imports (using "from") no longer cause warnings
- Dropped support for index terms in epytext ("X{}"); this was never 
supported in any meaningful capacity, but now the tag is gone

This will be the last release to support Python 2.7 and 3.5: future 
releases will require Python 3.6 or later.

Bye,
		Maarten





More information about the Twisted-Python mailing list