Skip to content

Docs: added information about deprecated pep 563 #18915

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Apr 12, 2025

Conversation

ApostolFet
Copy link
Contributor

Replaced a comment in the documentation that the behavior described in pep 563 might be the default behavior with actual information about what will be declared deprecated in python 3.14

@ApostolFet
Copy link
Contributor Author

@sobolevn can please take a look)

* Use of string literal types or type comments
* Use of ``typing.TYPE_CHECKING``
* Use of ``from __future__ import annotations`` (:pep:`563`)
(This directive has been declared deprecated since Python 3.14, and is expected to be removed in a future version of Python)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe mention PEP 649 or PEP 749 explicitly here? There were quite a few discussions regarding deferred annotations, I suspect some documentation users may struggle to find the final outcome:)

But also, given that 3.14 is a pre-release, maybe it's better to wait until we actually have 3.14.0 released. While extremely unlikely, things may still change, and this deprecation may get deferred again.

* Use of string literal types or type comments
* Use of ``typing.TYPE_CHECKING``
* Use of ``from __future__ import annotations`` (:pep:`563`)
(This directive has been declared deprecated since Python 3.14, and is expected to be removed in a future version of Python)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's just remove this phrase completely.

Co-authored-by: sobolevn <mail@sobolevn.me>
@sobolevn
Copy link
Member

In the future we will add notes here about __annotate__ and more future plans.

@sobolevn sobolevn merged commit 616e186 into python:master Apr 12, 2025
2 checks passed
@ApostolFet ApostolFet deleted the fix-deprecated-pep-563 branch April 12, 2025 16:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants