Skip to content

gh-119180: Updates to PEP 649/749 docs #134640

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 3 commits into from
May 26, 2025

Conversation

JelleZijlstra
Copy link
Member

@JelleZijlstra JelleZijlstra commented May 24, 2025

  • Mention (again) that type.__annotations__ is unsafe. It is now safe
    when using only classes defined under PEP 649 semantics, but not with
    classes defined using from __future__ import annotations.
  • Mention that annotations on instances no longer work. There was already
    an issue about this.
  • Mention the general changes in the "Porting to Python 3.14" section.
  • annotationlib was proposed by PEP-749, not PEP-649.

📚 Documentation preview 📚: https://cpython-previews--134640.org.readthedocs.build/

- Mention (again) that `type.__annotations__` is unsafe. It is now safe
  when using only classes defined under PEP 649 semantics, but not with
  classes defined using `from __future__ import annotations`.
- Mention that annotations on instances no longer work. There was already
  an issue about this.
- Mention the general changes in the "Porting to Python 3.14" section.
- `annotationlib` was proposed by PEP-749, not PEP-649.
Copy link
Member

@emmatyping emmatyping left a comment

Choose a reason for hiding this comment

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

One minor suggestion which you can take or leave, but otherwise looks good.

Copy link
Contributor

@willingc willingc left a comment

Choose a reason for hiding this comment

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

Thanks @JelleZijlstra. I made a small suggestion for readability.

@JelleZijlstra JelleZijlstra added the needs backport to 3.14 bugs and security fixes label May 26, 2025
@JelleZijlstra JelleZijlstra merged commit 7291eab into python:main May 26, 2025
26 checks passed
@github-project-automation github-project-automation bot moved this from Todo to Done in Docs PRs May 26, 2025
@miss-islington-app
Copy link

Thanks @JelleZijlstra for the PR 🌮🎉.. I'm working now to backport this PR to: 3.14.
🐍🍒⛏🤖

@JelleZijlstra JelleZijlstra deleted the 649-749-docs branch May 26, 2025 15:35
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request May 26, 2025
- Mention (again) that `type.__annotations__` is unsafe. It is now safe
  when using only classes defined under PEP 649 semantics, but not with
  classes defined using `from __future__ import annotations`.
- Mention that annotations on instances no longer work. There was already
  an issue about this.
- Mention the general changes in the "Porting to Python 3.14" section.
- `annotationlib` was proposed by PEP-749, not PEP-649.
(cherry picked from commit 7291eab)

Co-authored-by: Jelle Zijlstra <[email protected]>
Co-authored-by: Emma Smith <[email protected]>
Co-authored-by: Carol Willing <[email protected]>
@bedevere-app
Copy link

bedevere-app bot commented May 26, 2025

GH-134731 is a backport of this pull request to the 3.14 branch.

@bedevere-app bedevere-app bot removed the needs backport to 3.14 bugs and security fixes label May 26, 2025
JelleZijlstra added a commit that referenced this pull request May 26, 2025
gh-119180: Updates to PEP 649/749 docs (GH-134640)

- Mention (again) that `type.__annotations__` is unsafe. It is now safe
  when using only classes defined under PEP 649 semantics, but not with
  classes defined using `from __future__ import annotations`.
- Mention that annotations on instances no longer work. There was already
  an issue about this.
- Mention the general changes in the "Porting to Python 3.14" section.
- `annotationlib` was proposed by PEP-749, not PEP-649.
(cherry picked from commit 7291eab)

Co-authored-by: Jelle Zijlstra <[email protected]>
Co-authored-by: Emma Smith <[email protected]>
Co-authored-by: Carol Willing <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Documentation in the Doc dir skip news
Projects
Status: Done
Development

Successfully merging this pull request may close these issues.

3 participants