wip

Author: rsundqvist

.github/workflows/release.yml

@@ -5,9 +5,6 @@ on:
     tags:
       - 'v*'
 
-env:
-  POETRY_VERSION: 2.2.1
-
 jobs:
   release:
     runs-on: ubuntu-latest
@@ -16,19 +13,14 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
-      - name: Set up Python 3.11
-        uses: actions/setup-python@v6
+      - name: Set up Python 3.14 with uv
+        uses: astral-sh/setup-uv@v7
         with:
-          python-version: 3.11
-
-      - name: Install system deps
-        shell: bash
-        run: |
-          pip install poetry==$POETRY_VERSION poetry-plugin-export
+          python-version: '3.14'
 
       - name: Build package
         run: |
-          poetry build --ansi
+          uv build --ansi
 
       - name: Publish package on PyPI
         uses: pypa/gh-action-pypi-publish@v1.13.0

.github/workflows/tests.yml

@@ -14,27 +14,20 @@ on:
   pull_request:
     branches:
 
-env:
-  POETRY_VERSION: 2.2.1
-  POLARS_SKIP_CPU_CHECK: true
-
 jobs:
   linting:
     name: Linting
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
 
-      - name: Set up Python 3.11
-        uses: actions/setup-python@v6
+      - name: Set up Python 3.11 with uv
+        uses: astral-sh/setup-uv@v7
         with:
-          python-version: 3.11
+          python-version: '3.11'
 
       - name: Linting
-        run: |
-          pip install poetry==$POETRY_VERSION poetry-plugin-export
-          poetry install --only=main,devops
-          poetry run inv lint
+        run: uv run inv lint
 
   tests:
     needs: linting
@@ -44,30 +37,24 @@ jobs:
     strategy:
       fail-fast: true
       matrix:
-        os: [ Ubuntu, MacOS, Windows ]
+        os: [ 'Ubuntu', 'MacOS', 'Windows' ]
         python-version: [ '3.11', '3.12', '3.13', '3.14' ]
         experimental: [ false ]
     steps:
       - uses: actions/checkout@v6
 
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v6
+      - name: Set up Python ${{ matrix.python-version }} with uv
+        uses: astral-sh/setup-uv@v7
         with:
           python-version: ${{ matrix.python-version }}
 
-      - name: Install system deps
-        shell: bash
-        run: |
-          pip install nox
-          pip install poetry==$POETRY_VERSION poetry-plugin-export
-
       - name: Run mypy with nox
         shell: bash
-        run: nox --force-color -s mypy-${{ matrix.python-version }}
+        run: uv run nox --force-color -s mypy-${{ matrix.python-version }}
 
       - name: Run tests with nox
         shell: bash
-        run: nox --force-color -s tests-${{ matrix.python-version }}
+        run: uv run nox --force-color -s tests-${{ matrix.python-version }}
 
       - name: Run safety check
         if: matrix.python-version == '3.11' && matrix.os == 'Ubuntu'
@@ -88,16 +75,10 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
-      - name: Set up Python 3.11
-        uses: actions/setup-python@v6
+      - name: Set up Python 3.14 with uv
+        uses: astral-sh/setup-uv@v7
         with:
-          python-version: 3.11
-
-      - name: Install system deps
-        shell: bash
-        run: |
-          pip install nox
-          pip install poetry==$POETRY_VERSION poetry-plugin-export
+          python-version: '3.14'
 
       - name: Download coverage data
         uses: actions/download-artifact@v8
@@ -107,8 +88,7 @@ jobs:
 
       - name: Create coverage report
         shell: bash
-        run: |
-          nox --force-color --session=coverage -- --fmt xml
+        run: uv run nox --force-color --session=coverage -- --fmt xml
 
       - name: Upload coverage report
         uses: codecov/codecov-action@v5.5.2

.readthedocs.yml

@@ -10,17 +10,16 @@ build:
     post_create_environment:
       # Installing doesn't work; the wrong target is used even with 'virtualenvs.create false'. There is a GitHub issue
       # which may be a better solution in the future: https://github.com/python-poetry/poetry/issues/1937
-      - curl -sSL https://install.python-poetry.org | POETRY_VERSION=2.2.1 python -
-      - $HOME/.local/bin/poetry self add poetry-plugin-export
-      - $HOME/.local/bin/poetry export --only=docs,manual-extras --without-hashes --output=requirements-from-poetry.txt
-      - cat requirements-from-poetry.txt
+      - curl -LsSf https://astral.sh/uv/install.sh | UV_VERSION=0.9.26 sh
+      - $HOME/.local/bin/uv export --only=docs,manual-extras --no-hashes --output=requirements-from-poetry.txt
+      - cat requirements.txt
 
     # pre_build:
     #   - python -m sphinx -b linkcheck docs/ _build/linkcheck  # Fails for valid GitHub links?
 
 python:
   install:
-    - requirements: requirements-from-poetry.txt
+    - requirements: requirements.txt
     - method: pip
       path: .
       extra_requirements:

CONTRIBUTING.md

@@ -14,11 +14,11 @@ which demonstrates the (desired) usage.
 ## Getting started
 Follow these steps to begin local development.
 
-1. **Installing [Poetry](https://python-poetry.org/docs/)**
+1. **Installing [uv](https://docs.astral.sh/uv/getting-started/installation/)**
 
-   See [poetry.lock](https://github.com/rsundqvist/rics/blob/master/poetry.lock) for the version used.
+   See [uv.lock](https://github.com/rsundqvist/rics/blob/master/uv.lock) for the version used.
    ```bash
-   curl -sSL https://install.python-poetry.org/ | python -
+   curl -LsSf https://astral.sh/uv/install.sh | sh
    ```
 
 2. **Installing the project**
@@ -28,7 +28,7 @@ Follow these steps to begin local development.
    ```bash
    git clone --recurse-submodules git@github.com:rsundqvist/rics.git
    cd rics
-   poetry install --all-extras
+   uv install --all-extras
    ```
 
    Generating documentation has a few dependencies which may need to be installed

docs/documentation/cookbook/uv.md

@@ -0,0 +1,12 @@
+# uv
+
+## MyPy `--install-types` without `pip`
+The `--install-types` flag requires `pip`. To add manually without version constraints:
+
+```bash
+cat .mypy_cache/missing_stubs  # show what will be added
+uv add -r .mypy_cache/missing_stubs --group=types --raw-sources
+```
+
+Where `--raw-sources` avoids locking specific versions. This is a hack. No official solution exists yet;
+see https://github.com/python/mypy/issues/10600.

mypy.ini

@@ -1,6 +1,4 @@
 [mypy]
-install_types = true
-non_interactive = true
 show_error_codes = true
 warn_unused_configs = true
 warn_unused_ignores = true

noxfile.py

@@ -7,19 +7,13 @@
 import nox
 from nox.sessions import Session
 
+nox.options.default_venv_backend = "uv"
 nox.options.sessions = ["tests", "mypy"]
 python_versions = ["3.11", "3.12", "3.13", "3.14"]
 
 
 def install_with_constraints(session: Session, *args: str, **kwargs: Any) -> None:
-    """Install packages constrained by Poetry's lock file.
-
-    This function is a wrapper for nox.sessions.Session.install. It
-    invokes pip to install packages inside of the session's virtualenv.
-    Additionally, pip is passed a constraints file generated from
-    Poetry's lock file, to ensure that the packages are pinned to the
-    versions specified in poetry.lock. This allows you to manage the
-    packages as Poetry development dependencies.
+    """Install packages constrained by `uv.lock`.
 
     Args:
         session: The Session object.
@@ -29,18 +23,18 @@ def install_with_constraints(session: Session, *args: str, **kwargs: Any) -> Non
     """
     with tempfile.NamedTemporaryFile(delete=False) as requirements:
         session.run(
-            "poetry",
+            "uv",
             "export",
-            "--without-hashes",
-            f"--output={requirements.name}",
+            "--no-hashes",
+            f"--output-file={requirements.name}",
             external=True,
         )
         session.install("-r", requirements.name, *args, **kwargs)
 
 
 def install_with_project_extras(session: Session) -> None:
-    """Install the project using poetry."""
-    session.run_always("poetry", "install", "--no-interaction", "--all-extras", external=True)
+    """Install the project using uv."""
+    session.run_always("uv", "sync", "--active", "--all-extras", external=True)
     session.install(".")