bpo-38291: Remove mention of typing.io and typing.re again

[srittau]

They were originally removed in GH-10173 per bpo-35089, but then
readded in GH-21574. Cf. bpo-38291 for decision to remove. This PR
only partly addresses this bug, as the modules should be deprecated as
well (as they were never properly supported.)

https://bugs.python.org/issue38291

[JelleZijlstra]

Wouldn't it be better to say these namespaces are deprecated? The feature was promised in PEP 484 and previously mentioned in the typing docs, so we can't just hide it completely.

Here's a possible proposal:

• In the docs for 3.10 and earlier versions, say something like "This feature was never properly supported by most type checkers and will be deprecated in the future"
• In 3.11 (main), edit typing.py to emit DeprecationWarning in __getattr__ for the io and re pseudo-modules. (I think they're actually implemented as classes.) In the docs, say that they are deprecated.
• In 3.12 or 3.13, remove them.

[srittau]

Sounds good. I will modify this text tomorrow to a deprecation notice.

[gvanrossum]

Maybe the docs should actually list these as deprecated? (That would presumably be a "deprecated" note for the entire typing module.)

[Fidget-Spinner]

Wouldn't it be better to say these namespaces are deprecated? The feature was promised in PEP 484 and previously mentioned in the typing docs, so we can't just hide it completely.

Here's a possible proposal:

• In the docs for 3.10 and earlier versions, say something like "This feature was never properly supported by most type checkers and will be deprecated in the future"
• In 3.11 (main), edit typing.py to emit DeprecationWarning in __getattr__ for the io and re pseudo-modules. (I think they're actually implemented as classes.) In the docs, say that they are deprecated.
• In 3.12 or 3.13, remove them.

+1 to this proposal and for removing them in 3.13 (3.12 might be too early since thats only 1 version of warnings).

[srittau]

I have now added a deprecation notice instead of removing mentioning them completely. I marked them as deprecated as of 3.8 (since that was the version where they were removed first from the docs according to the NEWS entry). I also used a removal version of 3.12 for now. Since they were never supported, I'd be surprised if removing them has much of an impact. Also, the fix is very easy and works with all typing versions.

[JelleZijlstra]

Looks like you may not have pushed your changes.

[srittau]

Looks like you may not have pushed your changes.

Oops. Done now.

[github-actions]

This PR is stale because it has been open for 30 days with no activity.

[gvanrossum]

I feel this needs a NEWS entry. If you add one I will merge it. I'll also mark it for backporting.

[srittau]

@gvanrossum Done.

[miss-islington]

Thanks @srittau for the PR, and @gvanrossum for merging it 🌮🎉.. I'm working now to backport this PR to: 3.10, 3.9.
🐍🍒⛏🤖

[bedevere-bot]

GH-26720 is a backport of this pull request to the 3.10 branch.

[bedevere-bot]

GH-26721 is a backport of this pull request to the 3.9 branch.