Add shell script to run admin dev environment

core/admin/.gitignore

@@ -2,3 +2,4 @@
 lib64
 .vscode
 tags
+dev

core/admin/mailu/__init__.py

@@ -44,8 +44,10 @@ def create_app_from_config(config):
     # Initialize debugging tools
     if app.config.get("DEBUG"):
         debug.toolbar.init_app(app)
-        # TODO: add a specific configuration variable for profiling
-        # debug.profiler.init_app(app)
+    if app.config.get("DEBUG_PROFILER"):
+        debug.profiler.init_app(app)
+    if assets := app.config.get('DEBUG_ASSETS'):
+        app.static_folder = assets
 
     # Inject the default variables in the Jinja parser
     # TODO: move this to blueprints when needed

core/admin/mailu/configuration.py

@@ -13,6 +13,8 @@ DEFAULT_CONFIG = {
     'RATELIMIT_STORAGE_URL': '',
     'QUOTA_STORAGE_URL': '',
     'DEBUG': False,
+    'DEBUG_PROFILER': False,
+    'DEBUG_ASSETS': '',
     'DOMAIN_REGISTRATION': False,
     'TEMPLATES_AUTO_RELOAD': True,
     'MEMORY_SESSIONS': False,

core/admin/run_dev.sh

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+
+set -euxo pipefail
+
+### CONFIG
+
+DEV_PORT="${DEV_PORT:-8080}"
+DEV_NAME="${DEV_NAME:-mailu-dev}"
+DEV_PROFILE="${DEV_PROFILE:-false}"
+
+
+### MAIN
+
+here="$(realpath "$(pwd)/${0%/*}")"
+cd "${here}"
+
+docker="$(command -v podman || command -v docker || echo echo docker)"
+
+[[ -d dev ]] && rm -rf dev
+mkdir -p dev/data || exit 1
+
+# base
+cp ../base/requirements-* dev/
+cp -r ../base/libs dev/
+sed -E '/^#/d;s:^FROM system$:FROM system AS base:' ../base/Dockerfile > dev/Dockerfile
+
+# assets
+cp -r assets/content dev/
+sed -E '/^#/d;s:^(FROM [^ ]+$):\1 AS assets:' assets/Dockerfile >> dev/Dockerfile
+
+cat >> dev/Dockerfile <<EOF
+RUN set -euxo pipefail \
+  ; rm -f /work/static/*.gz
+EOF
+
+# admin
+sed -E '/^#/d;/^(COPY|EXPOSE|HEALTHCHECK|VOLUME|CMD) /d; s:^(.* )[^ ]*pybabel[^\\]*(.*):\1true \2:' Dockerfile >> dev/Dockerfile
+
+cat >> dev/Dockerfile <<EOF
+COPY --from=assets /work/static/ ./static/
+
+RUN set -euxo pipefail \
+  ; ln -s /app/audit.py / \
+  ; ln -s /app/start.py /
+
+ENV FLASK_ENV=development
+ENV MEMORY_SESSIONS=true
+
+ENV DEBUG=true
+ENV DEBUG_PROFILE=${DEV_PROFILE}
+ENV DEBUG_ASSETS=/app/static
+ENV DEBUG_TB_ENABLED=true
+
+ENV IMAP_ADDRESS="127.0.0.1"
+ENV POP3_ADDRESS="127.0.0.1"
+ENV AUTHSMTP_ADDRESS="127.0.0.1"
+ENV SMTP_ADDRESS="127.0.0.1"
+ENV REDIS_ADDRESS="127.0.0.1"
+ENV WEBMAIL_ADDRESS="127.0.0.1"
+
+CMD ["/bin/bash", "-c", "flask db upgrade && flask run --host=0.0.0.0 --port=8080"]
+EOF
+
+# TODO: re-compile assets on change?
+# TODO: re-run babel on change?
+
+# build
+${docker} build --tag "${DEV_NAME}:latest" dev/
+
+# run
+args=( --rm -it --name "${DEV_NAME}" --publish "${DEV_PORT}:8080" --volume "${here}/dev/data/:/data/" )
+for vol in audit.py start.py mailu/ migrations/; do
+	args+=( --volume "${here}/${vol}:/app/${vol}" )
+done
+
+for file in "${here}"/assets/content/assets/*; do
+	[[ "${file}" == */vendor.js ]] && continue
+	args+=( --volume "${file}:/app/static/${file/*\//}" )
+done
+
+${docker} run "${args[@]}" "${DEV_NAME}"
+
+# TODO: remove dev folder?