From c8a8d6b347d5a6899feb7c810d28f22f3cb151b8 Mon Sep 17 00:00:00 2001 From: Sebastian Rittau Date: Sun, 28 Oct 2018 17:03:29 +0100 Subject: bpo-35089: Don't mention typing.io and typing.re (GH-10173) https://bugs.python.org/issue35089 --- Doc/library/typing.rst | 25 ++++++++-------------- .../2018-10-28-16-51-31.bpo-35089._stCpS.rst | 2 ++ 2 files changed, 11 insertions(+), 16 deletions(-) create mode 100644 Misc/NEWS.d/next/Documentation/2018-10-28-16-51-31.bpo-35089._stCpS.rst diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst index 06c1b85..4469e88 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 0000000..4a46929 --- /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. -- cgit v0.12