# ---- test stage ----------------------------------------------------------
# Runs the suite inside the build, so a pipeline can gate the published image
# on it without needing Python on the runner:  docker build --target test .
#
# A plain `docker build .` does not build this stage, and nothing from here
# reaches the runtime image -- the tests are never copied into it.
FROM python:3.13-alpine AS test
WORKDIR /src
COPY app/ ./app/
COPY tests/ ./tests/
COPY tools/ ./tools/
# One test asserts that the shipped example configuration loads, so the suite
# needs it at the repository root, exactly as it sits in a working tree.
COPY config.example.json ./
ENV PYTHONDONTWRITEBYTECODE=1
# Deliberately not piped into `tail`: a pipeline reports the exit status of its
# last command, so the gate would pass even when the tests failed.
RUN python -m unittest discover -s tests -t .

# ---- runtime stage -------------------------------------------------------
# The whole server is the Python standard library, so the image needs no build
# toolchain, no wheels and no virtual environment -- just an interpreter, a trust
# store for upstream TLS, and the code.
FROM python:3.13-alpine

RUN apk add --no-cache ca-certificates \
    && adduser -D -u 10001 -h /srv app

ENV PYTHONUNBUFFERED=1 \
    PYTHONDONTWRITEBYTECODE=1 \
    CONFIG_PATH=/config/config.json

WORKDIR /srv
COPY app/ ./app/
COPY config.example.json ./

# Runs as an unprivileged user with no writable path: the server keeps nothing on
# disk, so the container can be run read-only (see docker-compose.yaml).
USER app
EXPOSE 8080

# The health endpoint answers without credentials and never calls upstream, so
# this checks the process, not the network.
HEALTHCHECK --interval=30s --timeout=5s --start-period=5s --retries=3 \
    CMD ["python", "-c", "import sys, urllib.request; sys.exit(0 if urllib.request.urlopen('http://127.0.0.1:8080/healthz', timeout=4).status == 200 else 1)"]

ENTRYPOINT ["python", "-m", "app"]
