Update platform tiers (#1448)

* Change platform tiers

* Add release notes explaining platform tier changes

* Minor grammar correction

* Apply suggestions from code review

Co-authored-by: Matthew Treinish <[email protected]>

* Adding all aarch64 tests

---------

Co-authored-by: Matthew Treinish <[email protected]>

Author: IvanIsCoding

.github/workflows/main.yml

@@ -66,15 +66,16 @@ jobs:
           { os: "macOS-13", python-architecture: "x64", rust-target: "x86_64-apple-darwin" },
           { os: "macOS-14", python-architecture: "arm64", rust-target: "aarch64-apple-darwin" },
           { os: "ubuntu-latest", python-architecture: "x64", rust-target: "x86_64-unknown-linux-gnu" },
+          { os: "ubuntu-24.04-arm", python-architecture: "arm64", rust-target: "aarch64-unknown-linux-gnu" },
           { os: "windows-latest", python-architecture: "x64", rust-target: "x86_64-pc-windows-msvc" },
         ]
         include:
-          # Test minimal supported Rust version
+          # Test ARM + minimal supported Rust version
           - rust: 1.79.0
             python-version: "3.10"
             platform: { os: "ubuntu-latest", python-architecture: "x64", rust-target: "x86_64-unknown-linux-gnu" }
             msrv: "MSRV"
-          # Test future versions of Rust and Python
+          # Test ARM + future versions of Rust and Python
           - rust: beta
             python-version: "3.13" # upgrade to 3.14-dev when the release candidate is available
             platform: { os: "ubuntu-latest", python-architecture: "x64", rust-target: "x86_64-unknown-linux-gnu" }

docs/source/install.rst

@@ -74,28 +74,28 @@ source.
      - :ref:`tier-1`
      - Distributions compatible with the `manylinux 2014`_ packaging specification
    * - Linux
-     - i686 
-     - :ref:`tier-2` (Python < 3.10), :ref:`tier-3` (Python >= 3.10)
+     - aarch64
+     - :ref:`tier-1`
      - Distributions compatible with the `manylinux 2014`_ packaging specification
    * - Linux
-     - aarch64
-     - :ref:`tier-2`
+     - i686 
+     - :ref:`tier-4`
      - Distributions compatible with the `manylinux 2014`_ packaging specification
    * - Linux
      - pp64le
-     - :ref:`tier-3`
+     - :ref:`tier-4`
      - Distributions compatible with the `manylinux 2014`_ packaging specification
    * - Linux
      - s390x
      - :ref:`tier-4`
      - Distributions compatible with the `manylinux 2014`_ packaging specification
    * - Linux (musl)
      - x86_64
-     - :ref:`tier-3`
+     - :ref:`tier-2`
      -
    * - Linux (musl)
      - aarch64
-     - :ref:`tier-4`
+     - :ref:`tier-2`
      - 
    * - macOS (10.12 or newer)
      - x86_64
@@ -111,7 +111,7 @@ source.
      -
    * - Windows 32bit 
      - i686 or x86_64
-     - :ref:`tier-2` (Python < 3.10), :ref:`tier-3` (Python >= 3.10)
+     - :ref:`tier-4`
      -
 
 

pyproject.toml

@@ -138,7 +138,7 @@ skip = "pp* cp36-* cp37-* cp38-* *win32 *musllinux*i686"
 test-requires = "networkx"
 test-command = "python -m unittest discover {project}/tests"
 before-build = "pip install -U setuptools-rust"
-test-skip = "*linux_s390x *ppc64le *musllinux*aarch64"
+test-skip = "*linux_s390x *ppc64le *i686 *win32"
 
 [tool.cibuildwheel.linux]
 before-all = "yum install -y wget && {package}/tools/install_rust.sh"
@@ -149,10 +149,6 @@ repair-wheel-command = "auditwheel repair -w {dest_dir} {wheel} && pipx run abi3
 select = "*-musllinux*"
 before-all = "apk add --no-cache curl gcc && curl https://sh.rustup.rs -sSf | sh -s -- -y && source $HOME/.cargo/env && rustup install stable && rustup default stable"
 
-[[tool.cibuildwheel.overrides]]
-select = "*i686"
-before-test = 'python -m pip install numpy --config-settings=setup-args="-Dallow-noblas=true"'
-
 [tool.cibuildwheel.macos]
 environment = "MACOSX_DEPLOYMENT_TARGET=10.12"
 repair-wheel-command = "brew install pipx && pipx ensurepath && pipx run --spec delocate==0.11.0  delocate-wheel --require-archs {delocate_archs} -w {dest_dir} -v {wheel} && pipx run abi3audit==0.0.9 --strict --report {wheel}"

releasenotes/notes/tier-changes-4843ec0d3cd63acb.yaml

@@ -0,0 +1,22 @@
+---
+upgrade:
+  - |
+    There have been changes to the support tiers for some platforms. These changes
+    reflect the current state of supporting each of the underlying platforms.
+
+    * Linux for aarch64 has been upgraded to tier 1, and will now be built and tested
+       as part of upstream development on every commit.
+    * Linux for x86_64 (musl) and aarch64 (musl) have been upgraded to tier 2, and
+       will be built and tested as part of the release process. NumPy also provides
+       wheels for these platforms, so we expect most users to install from PyPI with
+       little effort.
+    * Linux for ppc64le has been downgraded to tier 4. We will still publish wheels for
+       this platform, but they will not be tested. This is due to limitations in the CI infrastructure available and
+       our inability to reliably test the platform.
+    * Linux for i686 has been downgraded to tier 4. We will still publish wheels for this
+       platform, but they will not be tested as NumPy no longer provides i686 wheels. Users
+       will need a C/C++ compiler to install rustworkx on these platforms due to our dependency
+       on NumPy.
+    * Windows 32-bits has been downgraded to tier 4. Although NumPy publishes win32 wheels,
+       the support of `rust-numpy <https://github.com/PyO3/rust-numpy>`__ for win32 is precarious and might be dropped at any time.
+       If possible, we recommend using the 64-bit version of Python on Windows where we have tier 1 support.