Publish CPython 3.14 wheels and document Windows/WSL installation (#118)

.github/workflows/build_wheels.yml

@@ -40,10 +40,13 @@ jobs:
             brew install gfortran
           fi
 
+      # cibuildwheel >= 3.0 is needed for CPython 3.14.  Without a cp314
+      # wheel, pip on Python 3.14 silently falls back to compiling pyALPS and
+      # Boost from the sdist, which is what killed the WSL install in #118.
       - name: Build wheels
-        uses: pypa/cibuildwheel@v2.22.0
+        uses: pypa/cibuildwheel@v4.2.0
         env:
-          CIBW_BUILD: cp39-* cp310-* cp311-* cp312-* cp313-*
+          CIBW_BUILD: cp39-* cp310-* cp311-* cp312-* cp313-* cp314-*
           CIBW_ARCHS: ${{ matrix.plat.arch }}
           CIBW_ARCHS_MACOS: ${{ matrix.plat.arch }}
 

README-py.md

@@ -6,13 +6,34 @@ This is python packages for `Algorithms and Libraries for Physics Simulations` p
 
 ### Installation instruction from binaries
 
-1. pyALPS can be installed on most Linux and MacOS mcachines from prebuilt biniaries available on [PyPi](https://pypi.org/project/pyalps).
+1. pyALPS can be installed on most Linux and MacOS machines from prebuilt binaries available on [PyPI](https://pypi.org/project/pyalps).
 pyALPS can be installed using `pip` Python package manager:
 
 ```
 pip install pyalps
 ```
 
+Wheels are published for CPython on x86_64 Linux (manylinux) and Apple-silicon macOS; the Python versions covered by a release are listed under "Download files" on PyPI. If no wheel matches your interpreter, `pip` silently falls back to compiling pyALPS **and Boost** from the source distribution, which takes an hour or more and several gigabytes of memory. To make `pip` stop with a clear message instead, install with
+
+```
+pip install --only-binary=:all: pyalps
+```
+
+### Installation on Windows
+
+pyALPS has no native Windows build. Use the [Windows Subsystem for Linux](https://learn.microsoft.com/windows/wsl/install) (WSL 2) with a Linux distribution such as Ubuntu, create a virtual environment inside WSL with a Python version for which a Linux wheel exists (see above), and run the `pip install` command there.
+
+If the installation is killed while "Building wheel for pyalps", `pip` found no wheel and started a source build that ran out of memory; WSL becoming unresponsive at the same time is the usual symptom. Switch to a supported Python version or, if you do want to build from source inside WSL, first give the VM enough memory by creating `%USERPROFILE%\.wslconfig` on the Windows side:
+
+```
+[wsl2]
+memory=12GB
+swap=32GB
+processors=4
+```
+
+Run `wsl --shutdown` from PowerShell, reopen the WSL terminal, and follow the source-build instructions below. Note that the pyalps 2.3.3 source distribution on PyPI does not build with scikit-build-core 0.10 or newer (`ERROR: Use build.verbose instead of cmake.verbose`); build from a Git checkout as described below instead.
+
 ### Installation instruction from sources
 
 1. Prerequisites

pyproject.toml

@@ -50,6 +50,7 @@ classifiers = [
     'Programming Language :: Python :: 3.11',
     'Programming Language :: Python :: 3.12',
     'Programming Language :: Python :: 3.13',
+    'Programming Language :: Python :: 3.14',
     'Programming Language :: Python :: 3 :: Only',
     'Programming Language :: Python :: Implementation :: CPython',
     "Operating System :: POSIX",