Improve tooling

Author: ivan-borovets

.dockerignore

@@ -1,31 +1,10 @@
-# Venv
-.venv/
-
-# Git
-.git/
-.gitignore
-.gitattributes
-
-# Python Cache
-__pycache__/
-*.py[cod]
-*$py.class
-.mypy_cache/
-.ruff_cache/
-
-# IDE Specific
-.idea/
-.vscode/
-
-# Test artifacts
-.coverage
-htmlcov/
-
-# Documentation and non-essential files
-docs/
-scripts/
-LICENSE
-logo.jpg
-
-# Local environment
-.env*
+# Ignore everything
+**
+
+# Except
+!pyproject.toml
+!uv.lock
+!README.md
+!config/**
+!src/**
+!alembic.ini

.github/workflows/ci.yaml

@@ -18,18 +18,18 @@ jobs:
         uses: astral-sh/setup-uv@v6
 
       - name: Install dependencies
-        run: uv pip install -e '.[dev,test]' --system
+        run: uv sync --locked --group dev
 
       - name: Check code
-        run: make code.check
+        run: uv run make code.check
 
       - name: Test Docker Compose setup
+        env:
+          APP_ENV: local
         run: |
-          export APP_ENV=local
-          python config/toml_config_manager.py
+          uv run config/toml_config_manager.py
           cd config/local
-          export COMPOSE_ENV_FILES=.env.local
-          docker compose up -d --build
+          docker compose --env-file .env.local up -d --build
 
       - name: Verify Application Health
         run: |

README.md

@@ -620,19 +620,28 @@ make env  # should print APP_ENV=local
 make dotenv  # should tell you where .env.local was generated
 ```
 
-4. Set up virtual environment
+4. Install `uv`
 
 ```shell
 # sudo apt update
 # sudo apt install pipx
 # pipx ensurepath
 # pipx install uv
-# uv python install 3.13
-uv v
-source .venv/bin/activate
-# .venv\Scripts\activate  # Windows
 # https://docs.astral.sh/uv/getting-started/installation/#shell-autocompletion
-uv pip install -e '.[dev,test]'
+# uv python install 3.13  # To install Python
+```
+
+5. Set up virtual environment
+
+```shell
+uv sync --group dev
+source .venv/bin/activate
+
+# Alternatively,
+# uv v
+# source .venv/bin/activate  # on Unix
+# .venv\Scripts\activate  # on Windows
+# uv pip install -e . --group dev
 ```
 
 Don't forget to tell your IDE where the interpreter is located.
@@ -644,7 +653,7 @@ Install pre-commit hooks:
 pre-commit install
 ```
 
-5. Launch
+6. Launch
 
 - To run only the database in Docker and use the app locally, use the following command:
 
@@ -670,7 +679,7 @@ pre-commit install
 
   In this case, migrations will be applied automatically at startup.
 
-6. Shutdown
+7. Shutdown
 
 - To stop the containers, use:
     ```shell

config/local/Dockerfile

@@ -2,23 +2,24 @@ FROM ghcr.io/astral-sh/uv:python3.13-bookworm-slim AS builder
 WORKDIR /app
 ENV UV_COMPILE_BYTECODE=1 \
     UV_LINK_MODE=copy
-COPY pyproject.toml README.md ./
-COPY src/ ./src/
+COPY pyproject.toml uv.lock ./
 RUN --mount=type=cache,target=/root/.cache/uv \
-    uv pip install --system --target /app/dependencies .
+    uv sync --locked --no-dev --no-install-project
 COPY . ./
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --locked --no-dev
 
 FROM python:3.13-slim-bookworm AS final
 ARG APP_UID=10001
 ARG APP_GID=10001
 RUN groupadd -g ${APP_GID} appgroup && \
     useradd -u ${APP_UID} -g ${APP_GID} -s /usr/sbin/nologin -M appuser
 WORKDIR /app
-ENV PYTHONDONTWRITEBYTECODE=1 \
-    PYTHONUNBUFFERED=1 \
-    PYTHONPATH="/app/dependencies" \
-    PATH="/app/dependencies/bin:$PATH"
+ENV VIRTUAL_ENV="/app/.venv" \
+    PATH="/app/.venv/bin:$PATH" \
+    PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1
 COPY --from=builder --chown=${APP_UID}:${APP_GID} /app/ ./
 USER appuser
 EXPOSE 8888
-CMD ["uvicorn", "app.run:make_app", "--host", "0.0.0.0", "--port", "8888", "--loop", "uvloop"]
+CMD ["uvicorn", "app.run:make_app", "--factory", "--host", "0.0.0.0", "--port", "8888", "--loop", "uvloop"]

config/local/docker-compose.yaml

@@ -38,7 +38,7 @@ services:
       echo 'Running alembic migrations...' &&
       alembic upgrade head &&
       echo 'Starting Uvicorn...' &&
-      uvicorn app.run:make_app --host ${UVICORN_HOST} --port ${UVICORN_PORT} --loop uvloop
+      uvicorn app.run:make_app --factory --host ${UVICORN_HOST} --port ${UVICORN_PORT} --loop uvloop
       "
 
 volumes:

pyproject.toml

@@ -34,12 +34,13 @@ dependencies = [
     "uvloop==0.21.0",
 ]
 
-[project.optional-dependencies]
+[dependency-groups]
 dev = [
     "mypy==1.17.0",
     "pre-commit==4.2.0",
     "ruff==0.12.5",
     "slotscheck==0.19.1",
+    { include-group = "test" },
 ]
 test = [
     "coverage==7.10.0",