mirrors/cpython
0
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2024-12-16 13:25:18 +08:00
Code Issues Packages Projects Releases Wiki Activity

bpo-34336: Don't promote possibility to leave out typing.Optional (#8677)

Browse Source
This commit is contained in:
Ville Skyttä 2018-08-05 19:38:04 +03:00 committed by Ivan Levkivskyi
parent 87e59ac11e
commit 336c945858
1 changed files with 12 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
Doc/library/typing.rst
View File

@ -990,10 +990,18 @@ The module defines the following classes, functions and decorators:
Note that this is not the same concept as an optional argument,
which is one that has a default. An optional argument with a
default needn't use the ``Optional`` qualifier on its type
annotation (although it is inferred if the default is ``None``).
A mandatory argument may still have an ``Optional`` type if an
explicit value of ``None`` is allowed.
default does not require the ``Optional`` qualifier on its type
annotation just because it is optional. For example::
def foo(arg: int = 0) -> None:
...
On the other hand, if an explicit value of ``None`` is allowed, the
use of ``Optional`` is appropriate, whether the argument is optional
or not. For example::
def foo(arg: Optional[int] = None) -> None:
...
.. data:: Tuple