Updates for Pyodide 0.28 release #2487

agriyakhetarpal · 2025-07-07T05:43:59Z

In account of the new Pyodide release, this PR adds a build identifier for Pyodide 0.28.0, updates the constraints, and updates the docs and tests.

Closes #2485

cc: @hoodmane @ryanking13

agriyakhetarpal · 2025-07-07T07:06:31Z

cibuildwheel/selector.py

+        # TODO: Re-enable this when we have Pyodide prereleases again (e.g., 0.29.0a1+)
+        # Python 3.13 support became stable in Pyodide 0.28.0, so it no longer needs a prerelease
+        # flag.
+        # Also update Pyodide tests in unit_test/build_selector_test.py accordingly.
+        # When re-enabling, update the pattern to match the experimental Python version in case
+        # it is bumped to Python 3.14 (likely cp314-pyodide_* but could remain as 3.13 as well).
+        # This depends on the CPython version being used in the Pyodide runtime at the time.
+        # if EnableGroup.PyodidePrerelease not in self.enable and fnmatch(
+        #     build_id, "cp313-pyodide_*"
+        # ):
+        #     return False


I'm not sure what the best way to handle this would be. We don't have a Pyodide 0.29.0 pre-release yet because it's too early to have one. We usually stay one year behind CPython version compatibility, allowing our packages to complete their upgrades. The cp313-pyodide_wasm32 identifier might stay for Pyodide 0.29, or it might not. The CPython version could even change between Pyodide 0.29 alphas (or 0.30 alphas, for that matter).

We currently say that "If there are pre-releases available for a newer Pyodide version, the pyodide-prerelease can be used to include pre-release versions." in the documentation.

We could document there that cibuildwheel can disable the pyodide-prerelease option when there are no pre-releases available?

I'm personally okay with the commenting approach above.

As for the other points, yeah, I can see that it might get a little awkward around alphas, but that's probably okay, that's what alphas are for :) @henryiii were discussing some ideas in #2448 about the possibility of being able to add new identifiers at runtime, which might help? Having said that, I think we're gonna continue to want the python version in the identifier to support the functionality of the requires-python feature.

Copilot

Pull Request Overview

Adds support for Pyodide 0.28.0 by bumping version pins, updating constraints and docs, and adjusting test logic.

Bumped default and test pyodide-version from 0.27.6 → 0.28.0 (and alpha a2 → a3)
Updated typing-extensions constraint to 4.14.1
Enabled CPython 3.13 in selector and updated related tests & CI

Reviewed Changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
unit_test/options_test.py	Updated expected Pyodide version to 0.28.0 in tests
unit_test/build_selector_test.py	Adjusted test to include cp313-pyodide_wasm32
docs/platforms.md	Clarified “Pyodide version” wording
docs/options.md	Updated examples to use 0.28.0/a3
cibuildwheel/selector.py	Commented out prerelease filter for cp313-pyodide
cibuildwheel/resources/constraints-*.txt	Bumped typing-extensions to 4.14.1
cibuildwheel/resources/build-platforms.toml	Set default_pyodide_version for cp313 to 0.28.0
.github/workflows/test.yml	Switched CI build to cp313* and bumped to 0.28.0a3

Comments suppressed due to low confidence (1)

.github/workflows/test.yml:249

The CI is pinning an alpha (0.28.0a3) even though the default stable version is 0.28.0. Update this to the stable 0.28.0 or clarify why an alpha is needed to keep CI in sync with the default release.

        CIBW_PYODIDE_VERSION: "0.28.0a3"

cibuildwheel/selector.py

.github/workflows/test.yml

hoodmane

Makes sense to me. Thanks @agriyakhetarpal!

joerick

Thank you :)

.github/workflows/test.yml

joerick · 2025-07-08T08:19:39Z

cibuildwheel/selector.py

+        # TODO: Re-enable this when we have Pyodide prereleases again (e.g., 0.29.0a1+)
+        # Python 3.13 support became stable in Pyodide 0.28.0, so it no longer needs a prerelease
+        # flag.
+        # Also update Pyodide tests in unit_test/build_selector_test.py accordingly.
+        # When re-enabling, update the pattern to match the experimental Python version in case
+        # it is bumped to Python 3.14 (likely cp314-pyodide_* but could remain as 3.13 as well).
+        # This depends on the CPython version being used in the Pyodide runtime at the time.
+        # if EnableGroup.PyodidePrerelease not in self.enable and fnmatch(
+        #     build_id, "cp313-pyodide_*"
+        # ):
+        #     return False


I'm personally okay with the commenting approach above.

As for the other points, yeah, I can see that it might get a little awkward around alphas, but that's probably okay, that's what alphas are for :) @henryiii were discussing some ideas in #2448 about the possibility of being able to add new identifiers at runtime, which might help? Having said that, I think we're gonna continue to want the python version in the identifier to support the functionality of the requires-python feature.

ryanking13

Looks like the test is failing because of the version numbers. Otherwise looks good to me

Suggested-by: Joe Rickerby <joerick@mac.com>

joerick · 2025-07-11T17:35:59Z

This test failure has me stumped-

ERROR: THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS FILE. If you have updated the package versions, please update the hashes. Otherwise, examine the package contents carefully; someone may have tampered with them.
numpy>=1.26.0 from https://cdn.jsdelivr.net/pyodide/v0.28.0/full/numpy-2.2.5-cp313-cp313-pyodide_2025_0_wasm32.whl#sha256=ebf03d021b8b89cbb2e2a8a31655e8051ee2580e2bc0729f17484066ecdc4ec7 (from spam):
Expected sha256 ebf03d021b8b89cbb2e2a8a31655e8051ee2580e2bc0729f17484066ecdc4ec7
Got 467a88e8c79f9e10c8e7052bcc32dd12d44d51098beb3b8f970e1cfc965c6757

The confusing bit is that numpy isn't referenced by this test.

agriyakhetarpal · 2025-07-11T18:10:13Z

I think the lockfile for 0.28.0 might be wrong... perhaps @hoodmane or @ryanking13 might know more? (Sorry, I'm crawling my way back to relevance after not having worked on Pyodide for a week).

hoodmane · 2025-07-11T18:14:03Z

Yes we're aware =)

hoodmane · 2025-07-11T18:16:09Z

We'll have to make a 0.28.1 with the fix. It's fixed by pyodide/pyodide#5749

ryanking13 · 2025-07-12T09:24:05Z

I patched the xbuildenv file in the GitHub releases manually. I think it will work now. Could you retrigger the CI? If the xbuilenv is cached, purging cache might be needed.

agriyakhetarpal · 2025-07-12T16:50:32Z

Thanks, @ryanking13!

agriyakhetarpal added 6 commits July 7, 2025 11:07

Bump testing version to 0.28.0

cdae9e2

Bump Pyodide constraints

58c8c04

Add Pyodide 0.28.0 identifier

39282c8

Override to a different, alpha version for testing

381dbd5

Update docs for Pyodide versions everywhere

3ebe89e

Add comment on using older Pyodide alpha version

5f32950

agriyakhetarpal mentioned this pull request Jul 7, 2025

Pyodide 0.28.0 is now stable #2485

Closed

agriyakhetarpal added 7 commits July 7, 2025 11:17

Bump to "cp313*" for compatibility

7ac9967

Drop identifier for Pyodide 0.28.0a3

3eb8d73

Add back Pyodide 0.28.0a3 identifier

e616c3f

Add helpful comment about pyodide-prerelease option

5ee499b

Fix test and add a comment about it

6bf8027

Keep one Pyodide version per Python version

7e909d7

Fix docs for pyodide-prerelease; Python ➡️ Pyodide

bda44b8

agriyakhetarpal commented Jul 7, 2025

View reviewed changes

agriyakhetarpal requested review from joerick, henryiii and Copilot July 7, 2025 07:06

Copilot AI reviewed Jul 7, 2025

View reviewed changes

cibuildwheel/selector.py Show resolved Hide resolved

agriyakhetarpal marked this pull request as ready for review July 7, 2025 07:08

hoodmane reviewed Jul 7, 2025

View reviewed changes

.github/workflows/test.yml Outdated Show resolved Hide resolved

hoodmane approved these changes Jul 7, 2025

View reviewed changes

joerick approved these changes Jul 8, 2025

View reviewed changes

ryanking13 approved these changes Jul 8, 2025

View reviewed changes

henryiii and others added 3 commits July 9, 2025 22:15

Merge branch 'main' into bump/cibuildwheel-pyodide-0.28

70b35d0

Update utils.py

095176b

Drop CI test step for overridden Pyodide version

b19e9dd

Suggested-by: Joe Rickerby <joerick@mac.com>

henryiii approved these changes Jul 12, 2025

View reviewed changes

henryiii merged commit cd9b48c into pypa:main Jul 13, 2025
44 of 45 checks passed

agriyakhetarpal deleted the bump/cibuildwheel-pyodide-0.28 branch July 13, 2025 02:11

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Updates for Pyodide 0.28 release #2487

Updates for Pyodide 0.28 release #2487

Uh oh!

agriyakhetarpal commented Jul 7, 2025 •

edited

Loading

Uh oh!

agriyakhetarpal Jul 7, 2025

Uh oh!

joerick Jul 8, 2025

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

hoodmane left a comment

Uh oh!

joerick left a comment

Uh oh!

Uh oh!

joerick Jul 8, 2025

Uh oh!

ryanking13 left a comment

Uh oh!

joerick commented Jul 11, 2025

Uh oh!

agriyakhetarpal commented Jul 11, 2025

Uh oh!

hoodmane commented Jul 11, 2025 •

edited

Loading

Uh oh!

hoodmane commented Jul 11, 2025

Uh oh!

ryanking13 commented Jul 12, 2025

Uh oh!

agriyakhetarpal commented Jul 12, 2025

Uh oh!

Uh oh!

Uh oh!

Updates for Pyodide 0.28 release #2487

Updates for Pyodide 0.28 release #2487

Uh oh!

Conversation

agriyakhetarpal commented Jul 7, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

agriyakhetarpal Jul 7, 2025

Choose a reason for hiding this comment

Uh oh!

joerick Jul 8, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Uh oh!

Uh oh!

hoodmane left a comment

Choose a reason for hiding this comment

Uh oh!

joerick left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

joerick Jul 8, 2025

Choose a reason for hiding this comment

Uh oh!

ryanking13 left a comment

Choose a reason for hiding this comment

Uh oh!

joerick commented Jul 11, 2025

Uh oh!

agriyakhetarpal commented Jul 11, 2025

Uh oh!

hoodmane commented Jul 11, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

hoodmane commented Jul 11, 2025

Uh oh!

ryanking13 commented Jul 12, 2025

Uh oh!

agriyakhetarpal commented Jul 12, 2025

Uh oh!

Uh oh!

Uh oh!

agriyakhetarpal commented Jul 7, 2025 •

edited

Loading

hoodmane commented Jul 11, 2025 •

edited

Loading