CI: Build wxPython .wgn for Python 3.12 and Python 3.13

...and use it to run all Python version jobs on Linux by default,
rather than Windows or macOS, since Linux CI runners are cheaper

Author: davidfstr

.github/workflows/ci.yaml

@@ -365,9 +365,14 @@ jobs:
           # NOTE: When adding new Linux versions, you may need
           #       to compile new wxPython .wgn files
           - ubuntu-22.04
-        # Test the earliest supported Python version only
+        # Test earliest to latest Python versions supported by Crystal,
+        # on at least one OS.
         python-version:
+          # NOTE: When adding new Python versions, you may need
+          #       to compile new wxPython .wgn files
           - "3.11.9"
+          - "3.12.9"
+          - "3.13.5"
       fail-fast: false
     runs-on: ${{ matrix.os }}
     timeout-minutes: 9  # 150% of normal time: 5 min, as of 2025-07-21
@@ -405,6 +410,11 @@ jobs:
       - name: Install wxPython dependencies
         run: sudo apt-get install -y libgtk-3-dev
 
+      # Install additional dependencies for Python 3.13 wxPython
+      - name: Install wxPython dependencies for Python 3.13
+        if: startsWith(matrix.python-version, '3.13.')
+        run: sudo apt-get install -y libnotify4
+
       # Install wxPython from precompiled wagon because installing
       # wxPython from source takes about 40 minutes on GitHub Actions
       # 
@@ -416,8 +426,22 @@ jobs:
           wget --no-verbose https://github.com/davidfstr/Crystal-Web-Archiver/releases/download/v1.4.0b/wxPython-4.2.3-py311-none-linux_x86_64.wgn
           poetry run wagon install wxPython-4.2.3-py311-none-linux_x86_64.wgn
 
+      - name: Install dependency wxPython from wagon (Python 3.12)
+        if: startsWith(matrix.python-version, '3.12.')
+        run: |
+          poetry run pip3 install wagon
+          wget --no-verbose https://github.com/davidfstr/Crystal-Web-Archiver/releases/download/v1.4.0b/wxPython-4.2.3-py312-none-linux_x86_64.wgn
+          poetry run wagon install wxPython-4.2.3-py312-none-linux_x86_64.wgn
+
+      - name: Install dependency wxPython from wagon (Python 3.13)
+        if: startsWith(matrix.python-version, '3.13.')
+        run: |
+          poetry run pip3 install wagon
+          wget --no-verbose https://github.com/davidfstr/Crystal-Web-Archiver/releases/download/v1.4.0b/wxPython-4.2.3-py313-none-linux_x86_64.wgn
+          poetry run wagon install wxPython-4.2.3-py313-none-linux_x86_64.wgn
+
       - name: Fail if wxPython wagon is not available for this Python version
-        if: ${{ !startsWith(matrix.python-version, '3.11.') }}
+        if: ${{ !startsWith(matrix.python-version, '3.11.') && !startsWith(matrix.python-version, '3.12.') && !startsWith(matrix.python-version, '3.13.') }}
         run: |
           echo "ERROR: No precompiled wxPython wagon is available for Python ${{ matrix.python-version }} on Linux."
           echo "You must build a .wgn for this Python version and update the workflow."
@@ -466,16 +490,7 @@ jobs:
           # NOTE: Earliest Windows supported by Crystal is Windows 11 (from the README)
           - windows-2025  # based on Windows 11 version 24H2 (Germanium)
         python-version:
-          # Test earliest to latest Python versions supported by Crystal,
-          # on at least one OS.
-          # 
-          # NOTE: Testing all Python versions on Linux would be faster
-          #       than on Windows because Linux runners are faster than 
-          #       every other OS. However Windows is the second fastest OS,
-          #       and doesn't require precompiled wxPython .wgn files.
           - "3.11.9"
-          - "3.12.9"
-          - "3.13.5"
       fail-fast: false
     runs-on: ${{ matrix.os }}
     timeout-minutes: 43  # 150% of normal time: 29 min, as of 2025-07-21

doc/how_to_make_wxpython_wagon.md

@@ -60,6 +60,45 @@ wget https://bootstrap.pypa.io/get-pip.py
 python3.11 get-pip.py
 ```
 
+* Install Python 3.12, if appropriate for this .wgn
+
+```bash
+# Install Python 3.12 (from source)
+apt-get update
+apt-get install -y build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libsqlite3-dev libreadline-dev libffi-dev curl libbz2-dev wget
+curl -O https://www.python.org/ftp/python/3.12.9/Python-3.12.9.tar.xz
+tar -xf Python-3.12.9.tar.xz
+cd Python-3.12.9
+time ./configure
+    # real  0m28.451s
+time make -j4
+    # real  1m11.544s
+make install
+python3.12 --version
+# Install pip for Python 3.12
+wget https://bootstrap.pypa.io/get-pip.py
+python3.12 get-pip.py
+```
+
+* Install Python 3.13, if appropriate for this .wgn
+
+```bash
+# Install Python 3.13.5 (from source)
+apt-get update
+apt-get install -y build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libsqlite3-dev libreadline-dev libffi-dev curl libbz2-dev wget
+curl -O https://www.python.org/ftp/python/3.13.5/Python-3.13.5.tar.xz
+tar -xf Python-3.13.5.tar.xz
+cd Python-3.13.5
+time ./configure
+    # real  9m55.020s
+time make -j4
+    # real  13m31.239s
+./python --version
+# Install pip for Python 3.13
+wget https://bootstrap.pypa.io/get-pip.py
+./python get-pip.py
+```
+
 * Install wxPython dependencies and wagon
 
 ```bash
@@ -79,7 +118,15 @@ python3 -m pip install wagon[dist]  # or: python3.x -m pip install wagon[dist]
 # Compile wagon
 cd /usr/src  # shared folder with Docker host
 time wagon create wxPython==4.2.3  # use version from pyproject.toml
-    # real  81m6.382s
+    # real  81m6.382s (Python 3.9)
+    # real  ~80m+ (Python 3.12.9)
+    # real  ~80m+ (Python 3.13.5)
+```
+
+If using a locally built Python from source:
+
+```bash
+time ./python -m wagon create wxPython==4.2.3  # use version from pyproject.toml
 ```
 
 * Upload the .wgn file as a release artifact to a release tag on GitHub,