Switch to uv in Dockerfile

Author: jonasrenault

README.md

@@ -3,7 +3,7 @@
 ![Tests](https://github.com/jonasrenault/fastapi-react-mongodb-docker/actions/workflows/test.yml/badge.svg)
 ![Build](https://github.com/jonasrenault/fastapi-react-mongodb-docker/actions/workflows/build.yml/badge.svg)
 [![License](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)
-![python_version](https://img.shields.io/badge/Python-%3E=3.10-blue)
+![python_version](https://img.shields.io/badge/Python-%3E=3.12-blue)
 
 This is a template application for a FARM stack. FARM stands for FastAPI, React, MongoDB.
 

backend/Dockerfile

@@ -1,19 +1,40 @@
-FROM python:3.12-slim
+FROM python:3.12-slim-bookworm
 
 ENV PYTHONUNBUFFERED=true
 
 WORKDIR /app
 
-### install poetry
-RUN pip install poetry && poetry config virtualenvs.in-project true
+# Install uv
+# Ref: https://docs.astral.sh/uv/guides/integration/docker/#installing-uv
+COPY --from=ghcr.io/astral-sh/uv:0.5.11 /uv /uvx /bin/
 
-### install dependencies and project
+# Place executables in the environment at the front of the path
+# Ref: https://docs.astral.sh/uv/guides/integration/docker/#using-the-environment
+ENV PATH="/app/.venv/bin:$PATH"
+
+# Compile bytecode
+# Ref: https://docs.astral.sh/uv/guides/integration/docker/#compiling-bytecode
+ENV UV_COMPILE_BYTECODE=1
+
+# uv Cache
+# Ref: https://docs.astral.sh/uv/guides/integration/docker/#caching
+ENV UV_LINK_MODE=copy
+
+# Install dependencies
+# Ref: https://docs.astral.sh/uv/guides/integration/docker/#intermediate-layers
+RUN --mount=type=cache,target=/root/.cache/uv \
+    --mount=type=bind,source=uv.lock,target=uv.lock \
+    --mount=type=bind,source=pyproject.toml,target=pyproject.toml \
+    uv sync --frozen --no-install-project
+
+# Copy the project into the image
 ADD pyproject.toml README.md ./
 ADD app /app/app
-RUN poetry install --no-interaction --no-ansi
 
-### add executables to path
-ENV PATH="/app/.venv/bin:$PATH"
+# Sync the project
+# Ref: https://docs.astral.sh/uv/guides/integration/docker/#intermediate-layers
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync
 
-### default cmd: run fastapi with 4 workers
+# default cmd: run fastapi with 4 workers
 CMD ["fastapi", "run", "--workers", "4", "app/main.py"]

backend/README.md

@@ -4,26 +4,22 @@ This directory contains the backend API app. It is built with [FastAPI](https://
 
 ## Requirements
 
-* [Poetry](https://python-poetry.org/) for Python package and environment management.
+* [uv](https://docs.astral.sh/uv/) for Python package and environment management.
 * A [MongoDB](https://www.mongodb.com/) database for persistence.
 
 ## Install
 
-The project uses poetry to manage dependencies and run the backend application. You can use an other tool to manage your virtual environment, such as `pip` or [uv](https://docs.astral.sh/uv/), but you'll need to extract the dependencies from the [pyproject.toml](./pyproject.toml) file.
-
-If using poetry, for convenience, run `poetry config virtualenvs.in-project true` before installing depencies. This will install the dependencies in the project directory and make it easier to manage in vscode.
-
-You can then install the dependencies with `poetry install --with dev`.
+The project uses [uv](https://docs.astral.sh/uv/) to manage dependencies and run the backend application. You can install the project and its dependencies with `uv sync`.
 
 ## Running the server
 
 To start a development server, run
 
 ```console
-poetry run fastapi dev app/main.py
+uv run fastapi dev app/main.py
 ```
 
-from the `backend` directory (remove the `poetry run` prefix if using another dependency management tool).
+from the `backend` directory (remove the `uv run` prefix if using another dependency management tool).
 
 This will start a server running on `http://127.0.0.1:8000`. The API will be available on the API's base prefix, which by default is `/api/v1`.
 
@@ -36,7 +32,7 @@ Navigate to `http://localhost:8000/redoc` to access the API's alternative doc bu
 Run
 
 ```console
-poetry run pytest
+uv run pytest
 ```
 
 to run the unit tests for the backend app.