chore: switch to uv and nox

.config/.readthedocs.yaml

@@ -10,15 +10,14 @@ build:
   tools:
     rust: latest
     python: latest
-
-mkdocs:
-  configuration: docs/mkdocs.yml
-
-
-# Optionally declare the Python requirements required to build your docs
-
-python:
-  install:
-    - requirements: docs/requirements.txt
-    - method: pip
-      path: docs/
+  jobs:
+    pre_create_environment:
+      - >-
+        UV_INSTALL_DIR="${HOME}/.local/bin" &&
+        curl -LsSf https://astral.sh/uv/install.sh | sh
+    build:
+      html:
+        - ${HOME}/.local/bin/uvx nox -s docs-build
+    post_build:
+      - mkdir -p $READTHEDOCS_OUTPUT/html/
+      - mv docs/site/* $READTHEDOCS_OUTPUT/html

.github/dependabot.yml

@@ -13,12 +13,12 @@ updates:
       actions:
         patterns:
           - "*"
-  - package-ecosystem: pip
+  - package-ecosystem: uv
     directory: /
     schedule:
       interval: "weekly"
     groups:
-      pip:
+      uv-pip:
         patterns:
           - "*"
   - package-ecosystem: cargo

.github/workflows/build-docs.yml

@@ -48,18 +48,13 @@ jobs:
         with:
           path: ~/.cargo
           key: ${{ runner.os }}-docs-cargo-${{ hashFiles('Cargo.lock') }}
-      - uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
         with:
-          python-version: 3.x
-          cache: 'pip'
-          cache-dependency-path: docs/requirements.txt
-      - name: Install workflow deps
-        run: |
-          pip install -r docs/requirements.txt
-          pip install --force-reinstall -v docs/
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
       - name: Build docs
-        working-directory: docs
-        run: mkdocs build
+        run: uvx nox -s docs-build
       - name: Upload docs build as artifact
         uses: actions/upload-artifact@v4
         with:
@@ -84,11 +79,9 @@ jobs:
         with:
           path: ~/.cargo
           key: ${{ runner.os }}-docs-cargo-${{ hashFiles('Cargo.lock') }}
-      - name: Install just
-        uses: taiki-e/install-action@v2
-        with:
-          tool: just
-      - run: just docs-rs
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+      - run: uvx nox -s docs-rs
       - name: upload rustdoc build as artifact
         uses: actions/upload-artifact@v4
         with:

.github/workflows/bump-n-release.yml

@@ -12,6 +12,7 @@ on:
   workflow_dispatch:
     inputs:
       component:
+        description: The version component to increase
         type: choice
         required: true
         default: patch

.github/workflows/run-dev-tests.yml

@@ -31,6 +31,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
+      - run: rustup update --no-self-update
       - run: rustup component add llvm-tools-preview
 
       # https://docs.rs/openssl/latest/openssl/#automatic
@@ -56,8 +57,11 @@ jobs:
         with:
           python-version: 3.x
 
-      - name: Install workflow deps
-        run: python3 -m pip install meson
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
 
       # # https://github.com/ninja-build/ninja/wiki/Pre-built-Ninja-packages
       - name: Install ninja (Linux)
@@ -78,18 +82,6 @@ jobs:
       - if: runner.os == 'Linux'
         run: sudo apt-get update
 
-      - name: Install clang v7
-        if: runner.os == 'Linux'
-        uses: ./.github/install-clang-action
-        with:
-          version: '7'
-
-      - name: Collect Coverage for clang v7
-        if: runner.os == 'Linux'
-        env:
-          CLANG_VERSION: '7'
-        run: just test ci
-
       - name: Install clang v8
         if: runner.os == 'Linux'
         uses: ./.github/install-clang-action
@@ -100,7 +92,7 @@ jobs:
         if: runner.os == 'Linux'
         env:
           CLANG_VERSION: '8'
-        run: just test ci
+        run: uvx nox -s test -- --profile ci
 
       - name: Install clang v9
         uses: ./.github/install-clang-action
@@ -110,7 +102,7 @@ jobs:
       - name: Collect Coverage for clang v9
         env:
           CLANG_VERSION: '9'
-        run: just test ci
+        run: uvx nox -s test -- --profile ci
 
       - name: Install clang v10
         uses: ./.github/install-clang-action
@@ -120,7 +112,7 @@ jobs:
       - name: Collect Coverage for clang v10
         env:
           CLANG_VERSION: '10'
-        run: just test ci
+        run: uvx nox -s test -- --profile ci
 
       - name: Install clang 11
         uses: ./.github/install-clang-action
@@ -130,7 +122,7 @@ jobs:
       - name: Collect Coverage for clang v11
         env:
           CLANG_VERSION: '11'
-        run: just test ci
+        run: uvx nox -s test -- --profile ci
 
       - name: Install clang 12
         uses: ./.github/install-clang-action
@@ -140,7 +132,7 @@ jobs:
       - name: Collect Coverage for clang v12
         env:
           CLANG_VERSION: '12'
-        run: just test ci
+        run: uvx nox -s test -- --profile ci
 
       - name: Install clang 13
         uses: ./.github/install-clang-action
@@ -150,7 +142,7 @@ jobs:
       - name: Collect Coverage for clang v13
         env:
           CLANG_VERSION: '13'
-        run: just test ci
+        run: uvx nox -s test -- --profile ci
 
       - name: Install clang 14
         uses: ./.github/install-clang-action
@@ -160,7 +152,7 @@ jobs:
       - name: Collect Coverage for clang v14
         env:
           CLANG_VERSION: '14'
-        run: just test ci
+        run: uvx nox -s test -- --profile ci
 
       - name: Install clang 15
         uses: ./.github/install-clang-action
@@ -170,7 +162,7 @@ jobs:
       - name: Collect Coverage for clang v15
         env:
           CLANG_VERSION: '15'
-        run: just test ci
+        run: uvx nox -s test -- --profile ci
 
       - name: Install clang 16
         uses: ./.github/install-clang-action
@@ -180,7 +172,7 @@ jobs:
       - name: Collect Coverage for clang v16
         env:
           CLANG_VERSION: '16'
-        run: just test ci
+        run: uvx nox -s test -- --profile ci
 
       - name: Install clang 17
         uses: ./.github/install-clang-action
@@ -190,7 +182,7 @@ jobs:
       - name: Collect Coverage for clang v17
         env:
           CLANG_VERSION: '17'
-        run: just test ci
+        run: uvx nox -s test -- --profile ci
 
       - name: Install clang 18
         uses: ./.github/install-clang-action
@@ -200,10 +192,10 @@ jobs:
       - name: Collect Coverage for clang v18
         env:
           CLANG_VERSION: '18'
-        run: just test all
+        run: uvx nox -s test -- --profile all
 
       - name: Generate Coverage HTML report
-        run: just pretty-cov
+        run: uvx nox -s pretty-cov
 
       - name: Upload coverage data
         uses: actions/upload-artifact@v4
@@ -214,7 +206,7 @@ jobs:
       - name: Generate Coverage lcov report
         run: |
           rm coverage.json
-          just lcov
+          uvx nox -s lcov
 
       - uses: codecov/codecov-action@v5
         with:

CONTRIBUTING.md

@@ -0,0 +1,78 @@
+# Contributing
+
+This project requires the following tools installed:
+
+- :simple-rust: [rust](https://rustup.rs/)
+- :simple-uv: [`uv` (Python Project management tool)](https://docs.astral.sh/uv/)
+
+## Getting started
+
+After checking out the repo locally, use
+
+```sh
+uv sync
+```
+
+This creates a venv at ".venv/" in repo root (if it doesn't exist).
+It also installs dev dependencies like `pre-commit`, `nox`, `ruff`, and `mypy`.
+
+See [`uv sync` docs](https://docs.astral.sh/uv/reference/cli/#uv-sync)
+for more detailed usage.
+
+> [!TIP]
+> To register the pre-commit hooks, use:
+>
+> ```shell
+> uv run pre-commit install
+> ```
+
+## Running tests
+
+First ensure that the following cargo-managed binaries are installed:
+
+- [`cargo-llvm-cov`](https://github.com/taiki-e/cargo-llvm-cov)
+- [`cargo-nextest`](https://nexte.st/docs/installation/pre-built-binaries/)
+- [`llvm-cov-pretty`](https://crates.io/crates/llvm-cov-pretty) is used only for the optional `nox -s pretty-cov` task. Without this installed, `nox -s llvm-cov` will suffice.
+
+Use nox to run tests:
+
+```sh
+uv run nox -s test
+```
+
+Different test profiles are still defined in .config/nextest.toml.
+The above command uses the "default" profile, but to mimic the CI, use:
+
+```sh
+uv run nox -s test -- --profile ci
+```
+
+To generate a coverage report:
+
+```sh
+uv run nox -s llvm-cov -- --open
+```
+
+The `-- --open` part is optional. It opens the built coverage report in your default browser.
+
+The uploaded codecov report is generated with
+
+```sh
+uv run nox -s lcov
+```
+
+## Generating docs
+
+To view the docs locally, use
+
+```sh
+uv run nox -s docs -- --open
+```
+
+The `-- --open` part is optional. It opens the built docs in your default browser.
+
+In CI, docs are built using
+
+```sh
+uv run nox -s docs-build
+```