chore: switch from poetry to uv

Author: smarlhens

.github/workflows/ci.yml

@@ -5,13 +5,18 @@ on:
     branches:
       - main
 
+env:
+  UV_VERSION: "0.4.0"
+
 concurrency:
   group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
   cancel-in-progress: true
 
 jobs:
   build:
-    runs-on: ubuntu-22.04
+    env:
+      UV_CACHE_DIR: /tmp/.uv-cache
+    runs-on: ubuntu-24.04
     steps:
       - name: Checkout source code
         uses: actions/checkout@v4
@@ -20,30 +25,27 @@ jobs:
         uses: actions/setup-python@v5
         with:
           python-version-file: ".python-version"
-      - name: Install Poetry
-        uses: snok/[email protected]
-        with:
-          version: 1.8.3
-          virtualenvs-create: true
-          virtualenvs-in-project: true
-      - name: Load cached venv
-        id: cached-poetry-dependencies
+      - name: Set up uv
+        run: curl -LsSf https://astral.sh/uv/${{ env.UV_VERSION }}/install.sh | sh
+      - name: Restore uv cache
         uses: actions/cache@v4
         with:
-          path: .venv
-          key: venv-${{ runner.os }}-${{ steps.setup-python.outputs.python-version }}-${{ hashFiles('**/poetry.lock') }}
+          path: /tmp/.uv-cache
+          key: uv-${{ runner.os }}-${{ hashFiles('uv.lock') }}
+          restore-keys: |
+            uv-${{ runner.os }}-${{ hashFiles('uv.lock') }}
+            uv-${{ runner.os }}
       - name: Install dependencies
-        if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
-        run: poetry install --no-interaction --no-root
-      - name: Install library
-        run: poetry install --no-interaction
+        run: uv sync --all-extras --dev --frozen
       - name: Run application
-        run: poetry run myapplication
+        run: uv run myapplication
       - name: Test with pytest
-        run: poetry run pytest tests --cov=src
+        run: uv run pytest tests --cov=src
+      - name: Minimize uv cache
+        run: uv cache prune --ci
 
   build-image:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
 
     steps:
       - name: Checkout source code

.github/workflows/codeql.yml

@@ -9,7 +9,7 @@ on:
 jobs:
   analyze:
     name: Analyze
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     permissions:
       actions: read
       contents: read

.github/workflows/pr.yml

@@ -11,12 +11,13 @@ concurrency:
 
 jobs:
   build:
-    runs-on: ubuntu-22.04
+    env:
+      UV_CACHE_DIR: /tmp/.uv-cache
+    runs-on: ubuntu-24.04
     strategy:
       matrix:
-        python-version: ["3.12.0", "3.12.x"]
-        poetry-version:
-          ["1.2.2", "1.3.2", "1.4.2", "1.5.1", "1.6.1", "1.7.1", "1.8.3"]
+        python-version: ["3.12.3", "3.12.x"]
+        uv-version: ["0.3.5", "0.4.0"]
       fail-fast: false
 
     steps:
@@ -28,30 +29,27 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
           architecture: x64
-      - name: Install Poetry
-        uses: snok/[email protected]
-        with:
-          version: ${{ matrix.poetry-version }}
-          virtualenvs-create: true
-          virtualenvs-in-project: true
-      - name: Load cached venv
-        id: cached-poetry-dependencies
+      - name: Set up uv
+        run: curl -LsSf https://astral.sh/uv/${{ matrix.uv-version }}/install.sh | sh
+      - name: Restore uv cache
         uses: actions/cache@v4
         with:
-          path: .venv
-          key: venv-${{ runner.os }}-${{ steps.setup-python.outputs.python-version }}-${{ matrix.poetry-version }}-${{ hashFiles('**/poetry.lock') }}
+          path: /tmp/.uv-cache
+          key: uv-${{ runner.os }}-${{ hashFiles('uv.lock') }}
+          restore-keys: |
+            uv-${{ runner.os }}-${{ hashFiles('uv.lock') }}
+            uv-${{ runner.os }}
       - name: Install dependencies
-        if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
-        run: poetry install --no-interaction --no-root
-      - name: Install library
-        run: poetry install --no-interaction
+        run: uv sync --all-extras --dev --frozen
       - name: Run application
-        run: poetry run myapplication
+        run: uv run myapplication
       - name: Test with pytest
-        run: poetry run pytest tests --cov=src
+        run: uv run pytest tests --cov=src
+      - name: Minimize uv cache
+        run: uv cache prune --ci
 
   build-image:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
 
     steps:
       - name: Checkout source code

Dockerfile

@@ -2,42 +2,33 @@ FROM python:3.12.5-slim-bookworm as python-base
 
 ENV PYTHONUNBUFFERED=1 \
     PYTHONDONTWRITEBYTECODE=1 \
-    POETRY_HOME="/opt/poetry" \
-    POETRY_VIRTUALENVS_IN_PROJECT=true \
-    POETRY_NO_INTERACTION=1 \
     PYSETUP_PATH="/opt/pysetup" \
     VENV_PATH="/opt/pysetup/.venv"
 
-ENV PATH="$POETRY_HOME/bin:$VENV_PATH/bin:$PATH"
+ENV PATH="$VENV_PATH/bin:$PATH"
 
 FROM python-base as builder-base
-RUN apt-get update \
-    && apt-get install --no-install-recommends -y \
-        curl \
-        build-essential
 
-ENV POETRY_VERSION=1.8.3
-RUN curl -sSL https://install.python-poetry.org | python
+COPY --from=ghcr.io/astral-sh/uv:0.4.0 /uv /bin/uv
 
 WORKDIR $PYSETUP_PATH
-COPY ./poetry.lock ./pyproject.toml ./
-RUN poetry install --no-root --no-dev
-
-FROM builder-base as development
-
-RUN poetry install --no-root
 
 COPY . .
 
-RUN poetry install
+RUN uv sync --frozen
+
+FROM builder-base as development
 
 CMD ["python","-m", "myapplication.main"]
 
 FROM python-base as production
 
 COPY --from=builder-base $VENV_PATH $VENV_PATH
+
 WORKDIR $PYSETUP_PATH
+
 COPY ./src/ ./
+
 USER 10000
 
 CMD ["python","-m", "myapplication.main"]

README.md

@@ -31,9 +31,9 @@
 
 ## Prerequisites
 
-- [Python](https://www.python.org/downloads/) **>=3.12 <3.13** (_tested with 3.12.5_)
+- [Python](https://www.python.org/downloads/) **>=3.12.3 <3.13** (_tested with 3.12.5_)
 - [pre-commit](https://pre-commit.com/#install)
-- [poetry](https://python-poetry.org/docs/#installation) **>=1.2.2 <1.9** (_tested with 1.8.3_)
+- [uv](https://python-poetry.org/docs/#installation) **>=0.3.3** (_tested with 0.4.0_)
 - [docker](https://docs.docker.com/get-docker/) (_optional_)
 
 ---
@@ -68,16 +68,15 @@
 
 ## What's in the box ?
 
-### Poetry
+### uv
 
-[Poetry](https://python-poetry.org/) is a tool for dependency management and packaging in Python. It allows you to
-declare the libraries your project depends on and it will manage (install/update) them for you.
+[uv](https://github.com/astral-sh/uv) is an extremely fast Python package and project manager, written in Rust.
 
 **pyproject.toml file** ([`pyproject.toml`](pyproject.toml)): orchestrate your project and its dependencies
-**poetry.lock file** ([`poetry.lock`](poetry.lock)): ensure that the package versions are consistent for everyone
+**uv.lock file** ([`uv.lock`](uv.lock)): ensure that the package versions are consistent for everyone
 working on your project
 
-For more configuration options and details, see the [configuration docs](https://python-poetry.org/docs/).
+For more configuration options and details, see the [configuration docs](https://docs.astral.sh/uv/).
 
 ### pre-commit
 
@@ -90,11 +89,11 @@ For more configuration options and details, see the [configuration docs](https:/
 
 ### ruff
 
-[ruff](https://github.com/charliermarsh/ruff) is an extremely fast Python linter, written in Rust.
+[ruff](https://github.com/astral-sh/ruff) is an extremely fast Python linter, written in Rust.
 
 Rules are defined in the [`pyproject.toml`](pyproject.toml).
 
-For more configuration options and details, see the [configuration docs](https://github.com/charliermarsh/ruff#configuration).
+For more configuration options and details, see the [configuration docs](https://github.com/astral-sh/ruff#configuration).
 
 ### mypy
 
@@ -129,7 +128,7 @@ We are using [pytest](https://docs.pytest.org/) & [pytest-cov](https://github.co
 To run tests:
 
 ```bash
-poetry run pytest tests
+uv run pytest tests
 ```
 
 <details>
@@ -147,7 +146,7 @@ tests/test_myapplication.py::test_hello_world PASSED
 To run tests with coverage:
 
 ```bash
-poetry run pytest tests --cov=src
+uv run pytest tests --cov=src
 ```
 
 <details>