diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst index 9861da8d7073a5..f6d67d1ff9c5a4 100644 --- a/Doc/library/typing.rst +++ b/Doc/library/typing.rst @@ -779,32 +779,25 @@ The module defines the following classes, functions and decorators: .. versionadded:: 3.5.2 -.. class:: io +.. class:: IO + TextIO + BinaryIO - Wrapper namespace for I/O stream types. - - This defines the generic type ``IO[AnyStr]`` and subclasses ``TextIO`` - and ``BinaryIO``, deriving from ``IO[str]`` and ``IO[bytes]``, - respectively. These represent the types of I/O streams such as returned by + Generic type ``IO[AnyStr]`` and its subclasses ``TextIO(IO[str])`` + and ``BinaryIO(IO[bytes])`` + represent the types of I/O streams such as returned by :func:`open`. - These types are also accessible directly as ``typing.IO``, - ``typing.TextIO``, and ``typing.BinaryIO``. - -.. class:: re +.. class:: Pattern + Match - Wrapper namespace for regular expression matching types. - - This defines the type aliases ``Pattern`` and ``Match`` which + These type aliases correspond to the return types from :func:`re.compile` and :func:`re.match`. These types (and the corresponding functions) are generic in ``AnyStr`` and can be made specific by writing ``Pattern[str]``, ``Pattern[bytes]``, ``Match[str]``, or ``Match[bytes]``. - These types are also accessible directly as ``typing.Pattern`` - and ``typing.Match``. - .. class:: NamedTuple Typed version of namedtuple. diff --git a/Misc/NEWS.d/next/Documentation/2018-10-28-16-51-31.bpo-35089._stCpS.rst b/Misc/NEWS.d/next/Documentation/2018-10-28-16-51-31.bpo-35089._stCpS.rst new file mode 100644 index 00000000000000..4a469290ad733a --- /dev/null +++ b/Misc/NEWS.d/next/Documentation/2018-10-28-16-51-31.bpo-35089._stCpS.rst @@ -0,0 +1,2 @@ +Remove mention of ``typing.io`` and ``typing.re``. Their types should be +imported from ``typing`` directly.