feat: migrate from poetry to uv (#377)

Author: mishraomp

.github/workflows/analysis.yml

@@ -102,29 +102,23 @@ jobs:
         with:
           python-version: "3.13"
 
-      - name: cache poetry install
-        uses: actions/cache@v4
-        with:
-          path: ~/.local
-          key: poetry-${{ hashFiles('**/pyproject.toml') }}
+      - name: Install UV
+        run: curl -LsSf https://astral.sh/uv/install.sh | sh
 
-      - uses: snok/install-poetry@76e04a911780d5b312d89783f7b1cd627778900a # v1.4.1
-        with:
-          version: 1.2.2
-          virtualenvs-create: true
-          virtualenvs-in-project: true
-          installer-parallel: true
+      - name: Add UV to PATH
+        run: echo "$HOME/.local/bin" >> $GITHUB_PATH
 
-      - id: cache-deps
+      - name: Cache UV dependencies
         uses: actions/cache@v4
         with:
           path: .venv
-          key: pydeps-${{ hashFiles('**/poetry.lock') }}
+          key: uv-${{ hashFiles('**/uv.lock') }}
 
-      - run: poetry install --no-interaction --no-root
-        if: steps.cache-deps.outputs.cache-hit != 'true'
+      - name: Install dependencies
+        run: uv sync --group dev
 
-      - run: poetry run pytest
+      - name: Run tests
+        run: uv run pytest
 
   results:
     name: Analysis Results

backend-py/Dockerfile

@@ -1,37 +1,59 @@
-FROM python:3.13.7 AS build
+# Use the official Python image with UV pre-installed
+FROM ghcr.io/astral-sh/uv:python3.13-bookworm-slim AS build
 
-# Disable cache dir, disable upgrade message, create .venv in project dir
-ARG PIP_NO_CACHE_DIR=off \
-    PIP_DISABLE_PIP_VERSION_CHECK=on \
-    POETRY_VIRTUALENVS_IN_PROJECT=1
+# Set environment variables for UV
+ENV UV_COMPILE_BYTECODE=1 \
+    UV_LINK_MODE=copy \
+    UV_PYTHON_DOWNLOADS=never
 
-# Install poetry, then dependencies
+# Install system dependencies
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends libpq-dev && \
+    rm -rf /var/lib/apt/lists/*
+
+# Set working directory
 WORKDIR /app
-COPY pyproject.toml poetry.lock ./
-RUN pip install poetry==1.6.1
-RUN poetry install --no-root -vvv --without dev --sync
 
-# Deploy
-FROM python:3.13.7-slim AS deploy
+# Copy dependency files
+COPY pyproject.toml uv.lock ./
+
+# Install dependencies
+RUN uv sync --frozen --no-install-project --no-dev
+
+# Copy source code
+COPY src ./src
 
-# Output to stdout/stderr, don't create .pyc files, etc.
+# Install the project
+RUN uv sync --frozen --no-dev
+
+# Production stage
+FROM python:3.13.7-slim-bookworm AS deploy
+
+# Set environment variables
 ENV PYTHONUNBUFFERED=1 \
     PYTHONDONTWRITEBYTECODE=1 \
     PATH="/app/.venv/bin:$PATH" \
-    PORT=3000
+    PORT=3000 \
+    LOG_LEVEL=INFO \
+    ENVIRONMENT=production
 
-# Packages
-RUN apt update && \
-    apt install -y --no-install-recommends libpq-dev
+# Install runtime dependencies
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends libpq-dev && \
+    rm -rf /var/lib/apt/lists/*
 
-# Dependencies, config and app
+# Copy virtual environment and application
 COPY --from=build /app/.venv /app/.venv
-COPY logger.conf ./
-COPY ./src ./src
+COPY --from=build /app/src ./src
+COPY start-server.sh ./
+
+# Make the script executable
+RUN chmod +x start-server.sh
 
+# Health check
 HEALTHCHECK --interval=300s --timeout=10s CMD timeout 10s sh -c 'true > http://localhost:${PORT} || exit 1'
 
-# Start with non-privileged user
+# Run as non-privileged user
 USER 1001
 SHELL ["/bin/bash", "-c"]
-ENTRYPOINT uvicorn src.main:app --host 0.0.0.0 --port ${PORT} --workers 1 --server-header --date-header --limit-concurrency 1000 --log-config ./logger.conf
+CMD ["./start-server.sh"]

backend-py/README.md

@@ -2,7 +2,7 @@
 ### Features
 - [x] FastAPI
 - [x] SQLAlchemy
-- [x] Poetry
+- [x] UV Package Manager
 - [x] Ruff
 - [x] Flyway
 - [x] Docker

backend-py/generate-models.sh

@@ -4,17 +4,18 @@ set -eu
 # Change to script dir
 cd $(dirname ${BASH_SOURCE[0]})
 
-# setup
-python3 -m venv venv-py
-source venv-py/bin/activate
-pip install --upgrade pip
-pip install sqlalchemy sqlacodegen psycopg2-binary sqlacodegen[citext]
+# Install UV if not available
+if ! command -v uv &> /dev/null; then
+    curl -LsSf https://astral.sh/uv/install.sh | sh
+    export PATH="$HOME/.local/bin:$PATH"
+fi
 
+# Use uvx to run sqlacodegen with temporary environment
 # Envars
 POSTGRES_HOST=${POSTGRES_HOST:-database}
 POSTGRES_USER=${POSTGRES_USER:-postgres}
 POSTGRES_PASSWORD=${POSTGRES_PASSWORD:-default}
 POSTGRES_DATABASE=${POSTGRES_DATABASE:-postgres}
 
-# Generate
-sqlacodegen --schema py_api postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@${POSTGRES_HOST}:5432/postgres > ./models/model.py
+# Generate using uvx (UV's tool runner)
+uvx --from sqlacodegen --with psycopg2-binary --with "sqlacodegen[citext]" sqlacodegen --schema py_api postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@${POSTGRES_HOST}:5432/postgres > ./models/model.py