[New-bugs-announce] [issue44925] Confusing deprecation notice for typing.IO

[Jesse Rittner]

New submission from Jesse Rittner <rittneje at gmail.com>:

The docs for typing.IO, typing.TextIO, and typing.BinaryIO include a confusing deprecation notice. https://docs.python.org/3/library/typing.html#typing.IO

> Deprecated since version 3.8, will be removed in version 3.12: These types are also in the typing.io namespace, which was never supported by type checkers and will be removed.

As per the discussion on https://github.com/python/typing/issues/834, this deprecation notice only refers to the typing.io package, which is confusing. It would be helpful to rephrase it for clarity.

----------
components: Library (Lib)
messages: 399655
nosy: rittneje
priority: normal
severity: normal
status: open
title: Confusing deprecation notice for typing.IO
type: enhancement
versions: Python 3.10, Python 3.11, Python 3.8, Python 3.9

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue44925>
_______________________________________