Prefer flat namespace over using typing.io and typing.re

[srittau]

The conclusion of python/typeshed#1652 says that importing from typing instead of typing.io and typing.re should be encouraged. That requires changes to PEP 484 as well the standard library documentation.

[srittau]

Opened https://bugs.python.org/issue35089 for the documentation issue, python/cpython#10173 for the corresponding PR.

[srittau]

I think this is done now.

[gvanrossum]

The io and re namespaces still exist for backward compatibility, right? Could we ever start deprecating those?

[srittau]

It seems that typeshed never included those namespaces, so I guess using them in type checkers has never worked. That seems like a indication that deprecating them should not be too disrupting.

[gvanrossum]

Ah cool.