- Emit a warning instead of crashing when an unresolvable forward reference is encountered in type annotations
- Fixed escape characters in parameter default values getting lost during signature processing
- Replaced use of the
config-inited
event (which inadvertently required Sphinx 1.8) with thebuilder-inited
event
- The setting of the
typing.TYPECHECKING
flag is now configurable using theset_type_checking_flag
option
- The extension now sets
typing.TYPECHECKING
toTrue
during setup to include conditional imports which may be used in type annotations - Fixed parameters with trailing underscores (PR by Daniel Knell)
- Fixed KeyError with private methods (PR by Benito Palacios Sánchez)
- Fixed deprecation warning about the use of formatargspec (PR by Y. Somda)
- The minimum Sphinx version is now v1.7.0
- Fixed rendering of generic types outside the typing module (thanks to Tim Poterba for the PR)
- Fixed crash when processing docstrings from nested classes (thanks to dilyanpalauzov for the fix)
- Added support for Python 3.7
- Dropped support for Python 3.5.0 and 3.5.1
- Ensured that
:rtype:
doesn't get joined with a paragraph of text (thanks to Bruce Merry for the PR)
- Removed support for
backports.typing
as it has been removed from the PyPI - Fixed first parameter being cut out from class methods and static methods (thanks to Josiah Wolf Oberholtzer for the PR)
- Fixed process_signature() clobbering any explicitly overridden signatures from the docstring
- Explicitly prefix
:class:
,:mod:
et al with:py:
, in casepy
is not the default domain of the project (thanks Monty Taylor)
- Fixed ValueError when getargspec() encounters a built-in function
- Fixed AttributeError when Any is combined with another type in a Union (thanks Davis Kirkendall)
- Fixed compatibility with Python 3.6 and 3.5.3
- Fixed
NameError
when processing signatures of wrapped functions with type hints - Fixed handling of slotted classes with no
__init__()
method - Fixed Sphinx warning about parallel reads
- Fixed return type being added to class docstring from its
__init__()
method (thanks to Manuel Krebber for the patch) - Fixed return type hints of
@property
methods being omitted (thanks to pknight for the patch) - Added a test suite (thanks Manuel Krebber)
- Added proper support for
typing.Tuple
(pull request by Manuel Krebber)
- Fixed wrong placement of
:rtype:
if a multi-line:param:
or a:returns:
is used
- Fixed coroutine functions' signatures not being processed when using sphinxcontrib-asyncio
- Fixed compatibility with Sphinx 1.4
- Fixed "self" parameter not being removed from exception class constructor signatures
- Fixed process_signature() erroneously removing the first argument of a static method
- Fixed exception classes not being processed like normal classes
- Fixed errors caused by forward references not being looked up with the right globals
- Initial release