Backends

.dockerignore

@@ -22,4 +22,3 @@
 **/obj
 **/secrets.dev.yaml
 **/values.dev.yaml
-README.md

.python-version

@@ -0,0 +1 @@
+3.12

.vscode/launch.json

@@ -2,7 +2,7 @@
     "configurations": [
         {
             "name": "Python: Current file",
-            "type": "python",
+            "type": "debugpy",
             "request": "launch",
             "program": "${file}",
             "console": "integratedTerminal"

.vscode/tasks.json

@@ -14,7 +14,7 @@
 		},
 		{
 			// WSLg https://github.com/microsoft/wslg
-			// Needs `wsl_distro` to be specified in `settings.json`!!
+			// https://github.com/microsoft/wslg/blob/main/samples/container/Containers.md
 			"type": "docker-run",
 			"label": "docker-run: debug",
 			"dependsOn": [
@@ -28,25 +28,30 @@
 				// https://code.visualstudio.com/docs/containers/reference#_dockerrun-object-properties
 				"volumes": [
 					{
-						"localPath": "\\\\wsl.localhost\\${config:wsl_distro}\\mnt\\wslg",
+						"localPath": "/run/desktop/mnt/host/wslg",
 						"containerPath": "/mnt/wslg"
 					},
 					{
 						// https://unix.stackexchange.com/questions/196677/what-is-tmp-x11-unix
-						"localPath": "\\\\wsl.localhost\\${config:wsl_distro}\\tmp\\.X11-unix",
+						"localPath": "/run/desktop/mnt/host/wslg/.X11-unix",
 						"containerPath": "/tmp/.X11-unix"
 					},
 					{
-						"localPath": "\\\\wsl.localhost\\${config:wsl_distro}\\usr\\lib\\wsl",
+						"localPath": "/usr/lib/wsl",
 						"containerPath": "/usr/lib/wsl"
+					},
+					{
+						"localPath": "${workspaceFolder}",
+						"containerPath": "/app"
 					}
 				],
 				"env": {
 					"DISPLAY": ":0",
 					"WAYLAND_DISPLAY": "wayland-0",
 					"XDG_RUNTIME_DIR": "/mnt/wslg/runtime-dir",
 					"PULSE_SERVER": "/mnt/wslg/PulseServer",
-					"LD_LIBRARY_PATH": "/usr/lib/wsl/lib"
+					"LD_LIBRARY_PATH": "/usr/lib/wsl/lib",
+					// "QT_DEBUG_PLUGINS": "1",
 				}
 				// https://github.com/microsoft/vscode-docker/issues/3200
 				// , "remove": false
@@ -64,6 +69,12 @@
 				"file": "docker_import.py"
 			},
 			"dockerRun": {
+				"volumes": [
+					{
+						"localPath": "${workspaceFolder}",
+						"containerPath": "/app"
+					}
+				],
 				"env": {
 					"DISPLAY": "host.docker.internal:0.0"
 				}

Dockerfile

@@ -1,35 +1,74 @@
+FROM ghcr.io/astral-sh/uv:0.6.2 AS uv
+COPY pyproject.toml uv.lock /
+
 # For more information, please refer to https://aka.ms/vscode-docker-python
 # FROM python:slim
-FROM python:3.9-slim
+FROM python:3.12-slim
 
 # Keeps Python from generating .pyc files in the container
 ENV PYTHONDONTWRITEBYTECODE=1
 
 # Turns off buffering for easier container logging
 ENV PYTHONUNBUFFERED=1
 
-# Install pip requirements
-COPY requirements.txt .
-RUN python -m pip install -r requirements.txt
-
 ###############################################################################
-# https://doc.qt.io/qt-5/linux-requirements.html
-# export QT_DEBUG_PLUGINS=1
-RUN apt update && apt install -y libxrender1 libxcb-render0 libxcb-render-util0 \
-    libxcb-shape0 libxcb-randr0 libxcb-xfixes0 libxcb-sync1 libxcb-shm0 \
-    libxcb-icccm4 libxcb-keysyms1 libxcb-image0 libxkbcommon0 \
-    libxkbcommon-x11-0 libfontconfig1 libfreetype6 libxext6 libx11-6 libxcb1 \
-    libx11-xcb1 libsm6 libice6 libglibd-2.0-0
-# Additional requirements
-RUN apt install -y libgl1 libxcb-xinerama0 libdbus-1-3
+# Requirements: https://doc.qt.io/qt-5/linux-requirements.html | https://doc.qt.io/qt-6/linux-requirements.html
+# Additional libraries for Qt5: libxcb-xinerama0 libxcursor1
+# Check module load: ldd $(python -c "from PySide6 import QtWidgets as m; print(m.__file__)")
+# Check Qt plugins load: QT_DEBUG_PLUGINS=1
+# Check all libs: find /usr/local/lib/python3.12/site-packages/PySide6 -type f -executable ! -name "*.py" ! -path "*/scripts/*" | xargs -I {} sh -c 'echo {}; ldd "{}" | grep "not found"'
+# Force Wayland or XCB: QT_QPA_PLATFORM=wayland | wayland-egl | xcb
+RUN apt update && apt install -y \
+  libgl1 \
+  libxkbcommon0 \
+  libegl1 \
+  libfontconfig1 \
+  libglib2.0-0 \
+  libdbus-1-3 \
+  libxcb-cursor0 \
+  libxkbcommon-x11-0 \
+  libxcb-icccm4 \
+  libxcb-keysyms1 \
+  libxcb-shape0 \
+  libwayland-cursor0 \
+  libatomic1 \
+  libwayland-egl1 \
+  libxrender1 \
+  libice6 \
+  libsm6 \
+  && rm -rf /var/lib/apt/lists/*
+
 ###############################################################################
 
 WORKDIR /app
-COPY . /app
 
 # Creates a non-root user with an explicit UID and adds permission to access the /app folder
 # For more info, please refer to https://aka.ms/vscode-docker-python-configure-containers
-RUN adduser -u 5678 --disabled-password --gecos "" appuser && chown -R appuser /app
+#
+# Wayland requires $XDG_RUNTIME_DIR to be accessible for current user, so create
+# user with uid 1000 because /run/desktop/mnt/host/wslg/runtime-dir ($XDG_RUNTIME_DIR)
+# is mounted with that uid, see also https://github.com/microsoft/WSL/issues/9689
+RUN adduser -u 1000 --disabled-password --gecos "" appuser && chown -R appuser /app
+
+# Install project dependencies
+# https://docs.astral.sh/uv/concepts/python-versions/#disabling-automatic-python-downloads
+ENV UV_PYTHON_DOWNLOADS=never
+# for uv sync https://docs.astral.sh/uv/concepts/projects/config/#project-environment-path
+ENV UV_PROJECT_ENVIRONMENT=/usr/local
+# Do not buffer stdout/stderr https://stackoverflow.com/a/59812588
+ENV PYTHONUNBUFFERED=1 PYTHONDONTWRITEBYTECODE=1
+RUN --mount=from=uv,source=/uv,target=/bin/uv \
+    --mount=from=uv,source=/pyproject.toml,target=/app/pyproject.toml \
+    --mount=from=uv,source=/uv.lock,target=/app/uv.lock \
+  # Install dependencies from an existing uv.lock: uv sync --frozen
+  uv sync --frozen --no-cache --no-install-project
+
+# Install project in a separate layer for faster rebuilds
+RUN --mount=from=uv,source=/uv,target=/bin/uv \
+    --mount=target=/app,type=bind,source=. \
+  cd /app && \
+  uv sync --frozen --no-cache
+
 USER appuser
 
 # During debugging, this entry point will be overridden. For more information, please refer to https://aka.ms/vscode-docker-python-debug