Skip to content

gh-140281: update 3.14 previsions for the free-threaded build - #140566

Merged
colesbury merged 7 commits into
python:mainfrom
Krishna-web-hub:doc-fix-140281
Dec 2, 2025
Merged

gh-140281: update 3.14 previsions for the free-threaded build#140566
colesbury merged 7 commits into
python:mainfrom
Krishna-web-hub:doc-fix-140281

Conversation

@Krishna-web-hub

@Krishna-web-hubKrishna-web-hub commented Oct 24, 2025•
edited
Loading

Copy link
Copy Markdown
Contributor

gh-140281: Doc: Update free-threading how-to

Key changes:

  • Updates text on immortal objects from "expected to be addressed" to "Work to further reduce...".
  • Updates performance overhead text from "expected to be reduced" to "was reduced" and notes that further reduction "remains an active development goal".
  • A NEWS entry has been added.

@python-cla-bot

python-cla-botBot commented Oct 24, 2025•
edited
Loading

Copy link
Copy Markdown

All commit authors signed the Contributor License Agreement.

CLA signed

@bedevere-appbedevere-appBot added docs Documentation in the Doc dir awaiting review labels Oct 24, 2025
@picnixzpicnixz changed the title Updating the free-threading doc of python version 3.14 fix #140281gh-140281: update 3.14 previsions for the free-threaded buildOct 24, 2025
@bedevere-appbedevere-appBot mentioned this pull request Oct 24, 2025
Closed
ZeroIntensity
ZeroIntensity reviewed Oct 25, 2025
View reviewed changes

@ZeroIntensityZeroIntensity left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

@colesbury Did you want to keep the information from the old 3.13 FT build here?

Comment threadMisc/NEWS.d/next/Documentation/2025-10-25-00-49-43.gh-issue-140281.tuMQUe.rst Outdated
Comment threadDoc/howto/free-threading-python.rst Outdated
@colesbury

colesbury commented Oct 27, 2025

Copy link
Copy Markdown
Contributor

Thanks for bringing this up. I think this needs to be reworked a bit more and we should limit it to 3.14. I don't think we need to discuss 3.13.

  • Immortalization: It's just code constants: numeric and string literals and tuple literals of those constants. Plus sys.intern
  • Frame objects: Should no longer crash, but we should verify this
  • Iterators: Should no longer crash

@Krishna-web-hub
Krishna-web-hubforce-pushed the doc-fix-140281 branch 2 times, most recently from b28265c to 2614ffbCompareOctober 29, 2025 22:37
@Krishna-web-hub

Krishna-web-hub commented Oct 29, 2025

Copy link
Copy Markdown
ContributorAuthor

Hi @colesbury, thanks for the specific feedback.
I've just pushed a new, clean commit that addresses all your points:

  • The documentation has been refocused on 3.14, and the outdated 3.13 comparisons have been removed.

  • I've corrected the "Immortalization" section to match your clarification (limited to code constants, literals, and sys.intern).

  • The warnings about "Frame objects" and "Iterators" crashing have also been removed.

@Krishna-web-hub

Krishna-web-hub commented Nov 5, 2025

Copy link
Copy Markdown
ContributorAuthor

hello @colesbury ,
I have done the changes you said about you can see and if you need any more changes then please tell me.

@colesbury
colesbury self-requested a review November 17, 2025 14:09
@colesbury

colesbury commented Dec 1, 2025

Copy link
Copy Markdown
Contributor

Thanks @Krishna-web-hub. I'll make a few further edits before I merge.

ZeroIntensity
ZeroIntensity approved these changes Dec 2, 2025
View reviewed changes

@ZeroIntensityZeroIntensity left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I have two little nitpicks regarding clarity. I don't consider them blocking, so feel free to ignore them if you want to.

Comment threadDoc/howto/free-threading-python.rst Outdated
Comment threadDoc/howto/free-threading-python.rst Outdated
colesbury
colesbury reviewed Dec 2, 2025
View reviewed changes
Comment threadDoc/howto/free-threading-python.rst Outdated
colesbury
colesbury reviewed Dec 2, 2025
View reviewed changes
Comment threadDoc/howto/free-threading-python.rst Outdated
@colesbury
colesbury enabled auto-merge (squash) December 2, 2025 05:48
@colesburycolesbury added the needs backport to 3.14 bugs and security fixes label Dec 2, 2025
@colesbury
colesbury merged commit 2dc28eb into python:mainDec 2, 2025
30 checks passed
@github-project-automationgithub-project-automationBot moved this from Todo to Done in Docs PRsDec 2, 2025
@miss-islington-app

miss-islington-appBot commented Dec 2, 2025

Copy link
Copy Markdown

Thanks @Krishna-web-hub for the PR, and @colesbury for merging it 🌮🎉.. I'm working now to backport this PR to: 3.14.
🐍🍒⛏🤖

miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Dec 2, 2025
@Krishna-web-hub@colesbury@miss-islington
pythongh-140281: Update free threading Python HOWTO for 3.14 (pythong…
3dc469f
…h-140566)
(cherry picked from commit 2dc28eb)
Co-authored-by: Krishna-web-hub <masterkiran27@gmail.com>
Co-authored-by: Sam Gross <colesbury@gmail.com>
@bedevere-app

bedevere-appBot commented Dec 2, 2025

Copy link
Copy Markdown

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

@bedevere-appbedevere-appBot removed the needs backport to 3.14 bugs and security fixes label Dec 2, 2025
colesbury added a commit that referenced this pull request Dec 2, 2025
@miss-islington@Krishna-web-hub@colesbury
[3.14]gh-140281: Update free threading Python HOWTO for 3.14 (gh-140566
b053c2a
) (gh-142173)
(cherry picked from commit 2dc28eb)
Co-authored-by: Krishna-web-hub <masterkiran27@gmail.com>
Co-authored-by: Sam Gross <colesbury@gmail.com>
@Krishna-web-hub

Krishna-web-hub commented Dec 2, 2025

Copy link
Copy Markdown
ContributorAuthor

Thanks @colesbury and @ZeroIntensity for reviewing and merging this PR.
I really appreciate the guidance! Happy to continue contributing.

@Krishna-web-hub
Krishna-web-hub deleted the doc-fix-140281 branch December 2, 2025 06:23
@Rogdham

Rogdham commented Dec 2, 2025

Copy link
Copy Markdown
Contributor

Thank you @Krishna-web-hub! 🤗

StanFromIreland pushed a commit to StanFromIreland/cpython that referenced this pull request Dec 6, 2025
@Krishna-web-hub@colesbury@StanFromIreland
pythongh-140281: Update free threading Python HOWTO for 3.14 (pythong…
93198bd
…h-140566)
Co-authored-by: Sam Gross <colesbury@gmail.com>
@Krishna-web-hubKrishna-web-hub mentioned this pull request Dec 9, 2025
Merged
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@colesburycolesburycolesbury left review comments
@ZeroIntensityZeroIntensityZeroIntensity approved these changes

Assignees

No one assigned

Labels

docsDocumentation in the Doc dirskip newstopic-free-threading

Projects

Docs PRs
Status: Done

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@Krishna-web-hub@colesbury@Rogdham@ZeroIntensity@nazeerali4325-commits