Migrate from rye to uv (#11)

Key changes:

- Instead of a single top-level workspace, we go for one workspace per exercise
- All exercises now require Python 3.13+ and `maturin` 1.8+
- We use the `dev` profile when building Rust extensions

Author: LukeMathWalker

.python-version

@@ -2,11 +2,12 @@
 command = "cargo"
 args = ["test"]
 
-# Faster feedback than `rye build`
 [[verification]]
-command = "maturin"
-args = ["develop"]
+command = "uv"
+# We use `--all-packages` to avoid having to specify `pytest` as a dev
+# dependency in all packages.
+args = ["sync", "--all-packages"]
 
 [[verification]]
-command = "rye"
-args = ["test", "--pyproject", "sample/pyproject.toml"]
+command = "uv"
+args = ["run", "pytest"]

.wr.toml

@@ -1,5 +1,5 @@
 [workspace]
-members = ["exercises/*/*", "patcher"]
+members = ["exercises/*/*"]
 resolver = "2"
 
 [workspace.dependencies]

Cargo.lock

@@ -27,7 +27,7 @@ also find solutions to all exercises in the
 To follow this course, you must install:
 
 - [Rust](https://www.rust-lang.org/tools/install)
-- [`rye`](https://rye.astral.sh/), a Python package manager
+- [`uv`](https://docs.astral.sh/uv/), a Python package manager
 
 If Rust is already installed on your machine, make sure to update it to the latest version:
 
@@ -41,7 +41,7 @@ These commands should successfully run on your machine:
 
 ```bash
 cargo --version
-rye --version
+uv --version
 ```
 
 Don't start the course until you have these tools installed and working.

Cargo.toml

@@ -20,9 +20,17 @@ To invoke Rust code from Python we need to create a **Python extension module**.
 We'll use `maturin` to build, package and publish Python extensions written in Rust. Let's install it:
 
 ```bash
-rye install "maturin>=1.6"
+uv tool install "maturin>=1.8"
 ```
 
+Tools installed via `uv` should be available in your path. Run:
+
+```bash
+uv tool update-shell
+```
+
+to make sure that's the case.
+
 ## Exercise structure
 
 All exercises in this course will follow the same structure:
@@ -153,20 +161,20 @@ Before we move on, let's take a look at `pyproject.toml`, the Python "manifest"
 
 ```toml
 [build-system]
-requires = ["maturin>=1.6,<2.0"]
+requires = ["maturin>=1.8,<2.0"]
 build-backend = "maturin"
 
 [project]
 name = "setup"
 # [...]
-requires-python = ">=3.8"
-dynamic = ["version"]
+requires-python = ">=3.13"
+
 [tool.maturin]
 features = ["pyo3/extension-module"]
 ```
 
 It specifies the build system, the extension name and version, the required Python version, and the features to enable when building the extension module.
-This is what `rye` looks at when building the extension module, before delegating the build
+This is what `uv` looks at when building the extension module, before delegating the build
 process to `maturin`, which in turn invokes `cargo` to compile the Rust code.
 
 ## What do I need to do?
@@ -177,35 +185,6 @@ that you can build and test a Python extension module without issues.
 
 Things will get a lot more interesting over the coming sections, I promise!
 
-## Troubleshooting
-
-You may run into this error when using `rye` and `pyo3` together:
-
-```plaintext
-<compiler output>
-= note: ld: warning: search path '/install/lib' not found
-          ld: library 'python3.12' not found
-          clang: error: linker command failed with exit code 1
-```
-
-This seems to be a [bug in `rye`](https://github.com/astral-sh/rye/issues/1050#issuecomment-2079270180).\
-To work around the issue, run the following command in the root of the course repository:
-
-```bash
-cargo run -p "patcher"
-```
-
-`wr` should now be able to build the extension module without issues and run the tests. No linker errors
-should be surfaced.
-
-<div class="warning">
-
-The `patcher` tool is a temporary workaround for a bug in `rye`.\
-It hasn't been tested on Windows: please [open an issue](https://github.com/mainmatter/rust-python-interoperability/issues)
-if you encounter any problems.
-
-</div>
-
 ## References
 
 - [Linking artifacts together (Rust compiler documentation)](https://doc.rust-lang.org/reference/linkage.html)

book/src/01_intro/00_welcome.md

@@ -3,5 +3,5 @@ command = "cargo"
 args = ["test"]
 
 [[verification]]
-command = "rye"
+command = "uv"
 args = ["sync"]

book/src/01_intro/01_setup.md

@@ -29,15 +29,15 @@ mod tests {
     }
 
     #[test]
-    fn rye_is_installed_and_on_path() {
-        let output = std::process::Command::new("rye")
+    fn uv_is_installed_and_on_path() {
+        let output = std::process::Command::new("uv")
             .arg("--version")
             .output()
-            .expect("Failed to run rye");
+            .expect("Failed to run uv");
 
         assert!(
             output.status.success(),
-            "`rye --version` failed:\n{}",
+            "`uv --version` failed:\n{}",
             String::from_utf8_lossy(&output.stderr)
         );
     }

exercises/01_intro/00_welcome/.wr.toml

@@ -1,15 +1,29 @@
 [build-system]
-requires = ["maturin>=1.6,<2.0"]
+requires = ["maturin>=1.8,<2.0"]
 build-backend = "maturin"
 
 [project]
 name = "setup"
-requires-python = ">=3.8"
+requires-python = ">=3.11"
 classifiers = [
   "Programming Language :: Rust",
   "Programming Language :: Python :: Implementation :: CPython",
   "Programming Language :: Python :: Implementation :: PyPy",
 ]
-dynamic = ["version"]
+version = "0.1.0"
+
 [tool.maturin]
 features = ["pyo3/extension-module"]
+
+[tool.uv.config-settings]
+# Faster feedback on Rust builds
+build-args = "--profile=dev"
+
+[tool.uv]
+cache-keys = ["pyproject.toml", "Cargo.toml", "src/*.rs"]
+
+[tool.uv.sources]
+setup = { workspace = true }
+
+[tool.uv.workspace]
+members = ["sample"]

exercises/01_intro/00_welcome/src/lib.rs

@@ -1,17 +1,18 @@
 [project]
 name = "setup_sample"
 version = "0.1.0"
-dependencies = []
+dependencies = [
+  "setup",
+]
 readme = "README.md"
-requires-python = ">= 3.8"
+requires-python = ">=3.11"
 
 [build-system]
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
-[tool.rye]
-managed = true
-dev-dependencies = [
+[dependency-groups]
+dev = [
   "pytest>=8.2.2",
 ]