WIP: serveradmin_extras setup

Author: kofrezo

.docker/web/entrypoint.sh

@@ -2,8 +2,19 @@
 
 source .env
 
-# Install or update dependencies on every start in case something changed
-uv sync
+# Install or update dependencies on every start in case something changed.
+# --inexact keeps packages that were added to the environment out-of-band (e.g.
+# an editable overlay installed via $SERVERADMIN_EXTRA_INSTALL below) instead of
+# pruning them.
+uv sync --inexact
+
+# Optional local overlay: install an additional editable package (e.g. a private
+# bundle of serveradmin_* apps) into the same environment. Set via a git-ignored
+# docker-compose.override.yml so the open source setup is unaffected.
+if [ -n "$SERVERADMIN_EXTRA_INSTALL" ]; then
+  echo "Installing extra package from $SERVERADMIN_EXTRA_INSTALL"
+  uv pip install -e "$SERVERADMIN_EXTRA_INSTALL"
+fi
 
 # Some users prefer to develop on their host rather than containers and have adjusted .env
 if [ $POSTGRES_HOST == "localhost" ]; then

.gitignore

@@ -49,3 +49,6 @@ __pycache__/
 # The settings file
 /packages/serveradmin/serveradmin/local_settings.py
 
+# Local docker-compose overlay (e.g. to mount/install a private app bundle)
+/docker-compose.override.yml
+

packages/serveradmin/serveradmin/settings.py

@@ -75,6 +75,23 @@
     'compressor',
 ]
 
+# Automatically register optional serveradmin_* Django apps that happen to be
+# installed in the environment (for example the private serveradmin-extras
+# bundle). This follows the same naming convention already used to auto-wire
+# their URLs in urls.py and their servershell plugins in servershell/utils.py,
+# so simply installing such a package is enough to activate it - no manual
+# INSTALLED_APPS editing required. Open source setups without any such package
+# installed are unaffected.
+import pkgutil
+
+INSTALLED_APPS += sorted(
+    name
+    for _, name, is_package in pkgutil.iter_modules()
+    if is_package
+    and name.startswith('serveradmin_')
+    and name not in INSTALLED_APPS
+)
+
 MENU_TEMPLATES = [
     'servershell/menu.html',
     'resources/menu.html',