Migrate from setuptools-rust to maturin

.github/workflows/main.yml

@@ -146,7 +146,14 @@ jobs:
       - name: Build rustworkx
         run: pip install .
         env:
-          SETUPTOOLS_RUST_CARGO_PROFILE: "dev"
+          CARGO_PROFILE_RELEASE_OPT_LEVEL: "0"
+          CARGO_PROFILE_RELEASE_DEBUG: "true"
+          CARGO_PROFILE_RELEASE_DEBUG_ASSERTIONS: "true"
+          CARGO_PROFILE_RELEASE_OVERFLOW_CHECKS: "true"
+          CARGO_PROFILE_RELEASE_LTO: "false"
+          CARGO_PROFILE_RELEASE_PANIC: "unwind"
+          CARGO_PROFILE_RELEASE_INCREMENTAL: "true"
+          CARGO_PROFILE_RELEASE_CODEGEN_UNITS: "16"
           CARGO_INCREMENTAL: 0
           RUSTFLAGS: "-Cinstrument-coverage"
           LLVM_PROFILE_FILE: "rustworkx-%p-%m.profraw"
@@ -158,7 +165,7 @@ jobs:
         run: |
           set -e
           mv tests/rustworkx*profraw .
-          ./grcov . --binary-path ./target/debug/ -s . -t lcov --branch --ignore-not-existing --ignore "/*" -o ./coveralls.lcov
+          ./grcov . --binary-path ./target/release/ -s . -t lcov --branch --ignore-not-existing --ignore "/*" -o ./coveralls.lcov
       - uses: actions/upload-artifact@v4
         with:
           name: coverage

README.md

@@ -77,10 +77,10 @@ it just as it would if there was a prebuilt binary available.
 > [!NOTE]  
 > To build from source you will need to ensure you have pip >=19.0.0
 installed, which supports PEP-517, or that you have manually installed
-`setuptools-rust>=1.9` prior to running `pip install rustworkx`. If you receive an
-error about `setuptools-rust` not being found you should upgrade pip with
-`pip install -U pip` or manually install `setuptools-rust` with
-`pip install -U setuptools-rust` and try again.
+`maturin>=1.9` prior to running `pip install rustworkx`. If you receive an
+error about `maturin` not being found you should upgrade pip with
+`pip install -U pip` or manually install `maturin` with
+`pip install -U maturin>=1.9` and try again.
 
 ### Optional dependencies
 
@@ -134,7 +134,7 @@ git clone https://github.com/Qiskit/rustworkx.git
 ```
 
 rustworkx uses [PyO3](https://github.com/pyo3/pyo3) and
-[setuptools-rust](https://github.com/PyO3/setuptools-rust) to build the
+[maturin](https://github.com/PyO3/maturin) to build the
 python interface, which enables using standard python tooling to work. So,
 assuming you have rust installed, you can easily install rustworkx into your
 python environment using `pip`. Once you have a local clone of the repo, change
@@ -166,8 +166,8 @@ changes reflected in your python environment.
 ### Develop Mode
 
 If you'd like to build rustworkx in debug mode and use an interactive debugger
-while working on a change you can set `SETUPTOOLS_RUST_CARGO_PROFILE="dev"`
-as an environment variable to build and install rustworkx in develop mode.
+while working on a change you can run `maturin build --profile dev` to build rustworkx
+and then install the wheel with `pip`.
 This will build rustworkx without optimizations and include debuginfo
 when running `pip install`. That can be handy for debugging.
 

noxfile.py

@@ -44,7 +44,9 @@ def docs(session):
     session.env["UV_PROJECT_ENVIRONMENT"] = session.virtualenv.location
     session.env["UV_FROZEN"] = "1"
     # faster build as generating docs already takes some time and we discard the env
-    session.env["SETUPTOOLS_RUST_CARGO_PROFILE"] = "dev"
+    session.env["CARGO_PROFILE_RELEASE_OPT_LEVEL"] = "1"
+    session.env["CARGO_PROFILE_RELEASE_CODEGEN_UNITS"] = "16"
+    session.env["CARGO_PROFILE_RELEASE_LTO"] = "thin"
     session.run("uv", "sync", "--only-group", "docs")
     session.install(".")
     session.run(

pyproject.toml

@@ -24,17 +24,11 @@ classifiers=[
 ]
 keywords = ["Networks", "Network", "Graph", "Graph Theory", "DAG"]
 
-[tool.setuptools]
-packages = ["rustworkx", "rustworkx.visualization"]
-include-package-data = true
+[tool.maturin]
+features = ["pyo3/extension-module"]
+locked = true
+bindings = "pyo3"
 
-[tool.distutils.bdist_wheel]
-py-limited-api = "cp310"
-
-[[tool.setuptools-rust.ext-modules]]
-target = "rustworkx.rustworkx"
-path = "Cargo.toml"
-binding = "PyO3"
 
 [project.optional-dependencies]
 mpl = ["matplotlib>=3.0"]
@@ -61,23 +55,23 @@ name = "Ivan Carvalho"
 email = "ivancarvalho@gatech.edu"
 
 [build-system]
-requires = ["setuptools>=77.0.0", "setuptools-rust>=1.9"]
-build-backend = "setuptools.build_meta"
+requires = ["maturin>=1.9,<2.0"]
+build-backend = "maturin"
 
 [dependency-groups]
 testinfra = [
     "nox==2025.10.16",
     "uv==0.11.2",
 ]
 test = [
-  "setuptools-rust",
+  "maturin>=1.9.0,<2.0",
   "testtools>=2.5.0",
   "networkx>=3.2",
   "stestr>=4.1",
 ]
 lint = [
     "ruff==0.15.7",
-    "setuptools-rust",
+    "maturin>=1.9.0,<2.0",
     "typos~=1.39",
 ]
 stubs = [
@@ -139,7 +133,7 @@ manylinux-i686-image = "manylinux2014"
 skip = "pp* cp314t* *win32 *musllinux*i686"
 test-requires = "networkx"
 test-command = "python -m unittest discover {project}/tests"
-before-build = "pip install -U setuptools-rust"
+before-build = "pip install -U maturin>=1.9.0,<2.0"
 test-skip = "*linux_s390x *ppc64le *i686 *win32"
 
 [tool.cibuildwheel.linux]