Promote uv usage

Author: MeirKriheli

.github/workflows/CI.yml

@@ -239,16 +239,20 @@ jobs:
           echo "ready=${ready}" >> "$GITHUB_OUTPUT"
       - uses: dtolnay/rust-toolchain@stable
         if: steps.ft_py.outputs.ready == 'true'
-      - name: Install dependencies and build
+      - uses: astral-sh/setup-uv@v5
         if: steps.ft_py.outputs.ready == 'true'
-        run: |
-          python -m venv .venv
-          ./.venv/bin/python -m pip install --upgrade pip
-          ./.venv/bin/python -m pip install maturin pytest
-          ./.venv/bin/python -m maturin develop --release
-      - name: Run tests
+      - name: Install dependencies (uv) and run tests
         if: steps.ft_py.outputs.ready == 'true'
-        run: ./.venv/bin/python -m pytest tests/
+        shell: bash
+        run: |
+          set -euo pipefail
+          if [[ '${{ steps.py314t.outcome }}' == 'success' ]]; then
+            export UV_PYTHON='${{ steps.py314t.outputs.python-path }}'
+          else
+            export UV_PYTHON='${{ steps.py313t.outputs.python-path }}'
+          fi
+          uv sync --extra dev --locked
+          uv run pytest tests/
       - name: Free-threaded Python unavailable
         if: steps.ft_py.outputs.ready != 'true'
         run: |

CONTRIBUTING.rst

@@ -57,38 +57,43 @@ Get Started!
 
 Ready to contribute? Here's how to set up `python-bidi` for local development.
 
-1. Fork the `python-bidi` repo on GitHub.
+1. Fork the ``python-bidi`` repo on GitHub.
 2. Clone your fork locally::
 
     $ git clone git@github.com:your_name_here/python-bidi.git
 
-3. Install your local copy into a virtualenv. Assuming you have virtualenvwrapper installed, this is how you set up your fork for local development::
+3. Install prerequisites:
+
+   * `Rust <https://www.rust-lang.org/tools/install>`_ (the extension is built with PyO3 / maturin).
+   * `uv <https://docs.astral.sh/uv/installation/>`_ (Python envs, dependency lockfile, and nox’s ``venv_backend="uv"``).
+
+4. In the repo, sync the dev environment and run tests::
 
-    $ mkvirtualenv python-bidi
     $ cd python-bidi/
-    $ python setup.py develop
+    $ uv sync --extra dev
+    $ uv run pytest
 
-4. Create a branch for local development::
+   This uses ``uv.lock`` when present for reproducible installs. To match CI-style checks via nox (also using uv under the hood)::
 
-    $ git switch -c name-of-your-bugfix-or-feature
+    $ uv run nox
 
-   Now you can make your changes locally.
+   Alternatively, install nox globally (``uv tool install nox``, ``pipx install nox``, etc.) and run ``nox`` from the repo root.
 
-5. When you're done making changes, check that your changes pass flake8 and the tests::
+5. Create a branch for local development::
 
-    $ flake8 python-bidi tests
-    $ python setup.py test
-    $ nox
+    $ git switch -c name-of-your-bugfix-or-feature
+
+   Now you can make your changes locally.
 
-   To get ``flake8`` and ``nox``, just pip install them into your virtualenv.
+6. When you're ready, ensure tests still pass (see step 4).
 
-6. Commit your changes and push your branch to GitHub::
+7. Commit your changes and push your branch to GitHub::
 
     $ git add .
     $ git commit -m "Your detailed description of your changes."
     $ git push origin name-of-your-bugfix-or-feature
 
-7. Submit a pull request through the GitHub website.
+8. Submit a pull request through the GitHub website.
 
 Pull Request Guidelines
 -----------------------

README.rst

@@ -114,15 +114,25 @@ Examples::
 Installation
 -------------
 
-At the command line (assuming you're using some virtualenv)::
+From PyPI::
 
     pip install python-bidi
 
+Or with uv::
 
-Running tests
---------------
+    uv pip install python-bidi
 
-To run the tests::
 
-    pip install nox
+Development / running tests
+-----------------------------
+
+You need Rust (for ``maturin``), `uv <https://docs.astral.sh/uv/>`_, and a ``nox`` session backend of ``uv`` (nox reads this from ``noxfile.py``).
+
+From a clone, create the environment and run the test suite::
+
+    uv sync --extra dev
+    uv run pytest
+
+Or use nox (after ``uv sync --extra dev``, or install nox with ``uv tool install nox`` / ``pipx install nox``)::
+
     nox

pyproject.toml

@@ -5,6 +5,7 @@ build-backend = "maturin"
 [project]
 name = "python-bidi"
 version = "0.6.8"
+requires-python = ">=3.9"
 readme = "README.rst"
 keywords = ["bidi", "unicode", "layout"]
 description = "Python Bidi layout wrapping the Rust crate unicode-bidi"
@@ -35,4 +36,4 @@ Changelog = "https://github.com/MeirKriheli/python-bidi/blob/master/CHANGELOG.rs
 pybidi = "bidi:main"
 
 [project.optional-dependencies]
-dev = ["pytest"]
+dev = ["nox", "pytest"]