Message 364399 - Python tracker

➜

This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author	McSinyx
Recipients	McSinyx, docs@python
Date	2020-03-17.09:21:34
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<[email protected]>
In-reply-to

Content
With PEP 563, it is legal to annotate a function as follows def foo(bar: 'int') -> 'bool': pass Currently, help(foo) would print the exact signature in foo.__annotations__ and it's not really pretty. My proposal is to use the type hints from typing.get_type_hints to make documentations more readable from the user's perspective. I might not be aware of all use cases and disadvantages of this proposal however.

With PEP 563, it is legal to annotate a function as follows

def foo(bar: 'int') -> 'bool': pass

Currently, help(foo) would print the exact signature in foo.__annotations__ and it's not really pretty.  My proposal is to use the type hints from typing.get_type_hints to make documentations more readable from the user's perspective.  I might not be aware of all use cases and disadvantages of this proposal however.

History
Date	User	Action	Args
2020-03-17 09:21:34	McSinyx	set	recipients: + McSinyx, docs@python
2020-03-17 09:21:34	McSinyx	set	messageid: <[email protected]>
2020-03-17 09:21:34	McSinyx	link	issue39990 messages
2020-03-17 09:21:34	McSinyx	create