Skip to content

[#962] Pin wxPython to 4.2.5, fix Linux AppImage/Flatpak build failure - #963

Merged
eoyilmaz merged 2 commits into
developfrom
962-nightly-appimage-build-fails-wxpython-4-3-0-no-linux-wheels
Jul 28, 2026
Merged

[#962] Pin wxPython to 4.2.5, fix Linux AppImage/Flatpak build failure#963
eoyilmaz merged 2 commits into
developfrom
962-nightly-appimage-build-fails-wxpython-4-3-0-no-linux-wheels

Conversation

@eoyilmaz

@eoyilmaz eoyilmaz commented Jul 28, 2026

Copy link
Copy Markdown
Owner

Summary

  • Nightly and release Linux AppImage builds were failing: wxPython 4.3.0 was just published to PyPI with no Linux wheels (macOS/Windows only), so pip picked it as the newest match for requirements.txt's unbounded wxPython >= 4.2.2, found no wheel anywhere for Linux, and fell back to building wxWidgets from source, which fails since the AppImage job only installs runtime GTK/X11 libraries, not the gtk+-3.0/libcurl dev headers a source build needs.
  • Pins wxPython==4.2.5 in requirements.txt (matching what pytest.yml already pins independently) and in the Flatpak manifest's python-wxPython module, since wxPython is being phased out for Qt anyway and doesn't need to track every upstream release.
  • Adds --only-binary wxpython to build-appimage.sh and the Flatpak module so a future version drift fails fast with a clear pip error instead of silently attempting a doomed multi-minute source build.
  • Documents (in the Flatpak manifest) why the python-wxPython module deliberately stays on the ubuntu-22.04 extras.wxpython.org wheel rather than ubuntu-24.04, even though the CI runner itself is 24.04: flatpak-builder builds that module sandboxed inside org.freedesktop.Platform//25.08, not the raw host, and the 22.04 wheel's ABI is what the hand-built libjpeg8/libtiff5/libjbig0/libdeflate0 shim modules (issue Is there any plan for flatpak or appImage version? #232) are matched to.

Fixes #962.

Test plan

  • Nightly AppImage build workflow run succeeds
  • Nightly Flatpak build workflow run succeeds
  • Release AppImage/Flatpak build workflow run succeeds (shares build-appimage.sh and the same Flatpak manifest)

eoyilmaz added 2 commits July 28, 2026 19:24
…from source

wxPython 4.3.0 was just published to PyPI with no Linux wheels at all
(macOS/Windows only). requirements.txt pinned wxPython with no upper
bound, so pip picked 4.3.0 as the newest match, found no wheel on
extras.wxpython.org (which still tops out at 4.2.5 there) or PyPI, and
fell back to building wxWidgets from source in the AppImage job, which
only installs runtime GTK/X11 libraries and fails without the
gtk+-3.0/libcurl dev headers a source build needs.

Since wxPython is being phased out in favour of Qt and is only needed
by the not-yet-ported legacy wx_* modules, pin it to 4.2.5 (already
the version pytest.yml pins independently) instead of chasing
extras.wxpython.org's build lag on every future release. Also add
--only-binary wxpython to build-appimage.sh and the Flatpak
python-wxPython module so a future drift fails fast with a clear pip
error instead of silently attempting a doomed source build.
Anticipates the reasonable-looking but wrong fix of matching the wheel
to the CI runner's Ubuntu version: flatpak-builder builds this module
sandboxed inside org.freedesktop.Platform//25.08, not the raw host, so
the runner's own Ubuntu version is irrelevant to the wheel's ABI. The
ubuntu-22.04 pin is tied to hand-extracted libjpeg8/libtiff5/libjbig0/
libdeflate0 shim modules from issue #232; swapping wheel versions needs
those shims reworked and re-verified on real hardware, not just a URL
edit.
@eoyilmaz eoyilmaz linked an issue Jul 28, 2026 that may be closed by this pull request
@eoyilmaz
eoyilmaz merged commit d672b80 into develop Jul 28, 2026
34 of 37 checks passed
@eoyilmaz
eoyilmaz deleted the 962-nightly-appimage-build-fails-wxpython-4-3-0-no-linux-wheels branch July 28, 2026 19:01
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.

Nightly AppImage build fails: wxPython 4.3.0 has no Linux wheels

1 participant