qodalis-cli-server-plugin-admin 1.0.0b7__tar.gz → 1.0.0b8__tar.gz

{qodalis_cli_server_plugin_admin-1.0.0b7 → qodalis_cli_server_plugin_admin-1.0.0b8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: qodalis-cli-server-plugin-admin
-Version: 1.0.0b7
+Version: 1.0.0b8
 Summary: Admin dashboard plugin for Qodalis CLI servers
 Project-URL: Homepage, https://github.com/qodalis-solutions/cli-server-python
 Project-URL: Repository, https://github.com/qodalis-solutions/cli-server-python

{qodalis_cli_server_plugin_admin-1.0.0b7 → qodalis_cli_server_plugin_admin-1.0.0b8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "qodalis-cli-server-plugin-admin"
-version = "1.0.0b7"
+version = "1.0.0b8"
 description = "Admin dashboard plugin for Qodalis CLI servers"
 readme = { text = "", content-type = "text/plain" }
 license = "MIT"

{qodalis_cli_server_plugin_admin-1.0.0b7 → qodalis_cli_server_plugin_admin-1.0.0b8}/qodalis_cli_admin/__init__.py

@@ -6,10 +6,19 @@ from .auth.auth_middleware import create_auth_dependency
 from .auth.auth_controller import create_auth_router
 from .dashboard_resolver import resolve_dashboard_dir
 from .services.admin_config import AdminConfig
+from .services.admin_theme import (
+    ADMIN_THEME_MODES,
+    ADMIN_THEME_TOKENS,
+    admin_theme_json,
+    is_theme_color,
+    validate_admin_theme,
+)
 from .services.log_ring_buffer import LogRingBuffer
 from .services.module_registry import ModuleRegistry
 
 __all__ = [
+    "ADMIN_THEME_MODES",
+    "ADMIN_THEME_TOKENS",
     "AdminBuildDeps",
     "AdminConfig",
     "BroadcastFn",
@@ -18,7 +27,10 @@ __all__ = [
     "JwtService",
     "LogRingBuffer",
     "ModuleRegistry",
+    "admin_theme_json",
     "create_auth_dependency",
     "create_auth_router",
+    "is_theme_color",
     "resolve_dashboard_dir",
+    "validate_admin_theme",
 ]

{qodalis_cli_server_plugin_admin-1.0.0b7 → qodalis_cli_server_plugin_admin-1.0.0b8}/qodalis_cli_admin/cli_admin_builder.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import os
 import time
 from dataclasses import dataclass
+from collections.abc import Mapping
 from typing import Any, Callable, Awaitable
 
 from fastapi import APIRouter
@@ -19,6 +20,7 @@ from .controllers.config_controller import create_config_router
 from .controllers.logs_controller import create_logs_router
 from .controllers.ws_clients_controller import create_ws_clients_router
 from .services.admin_config import AdminConfig
+from .services.admin_theme import admin_theme_json
 from .services.log_ring_buffer import LogRingBuffer
 from .services.module_registry import ModuleRegistry
 from .dashboard_resolver import resolve_dashboard_dir
@@ -64,6 +66,7 @@ class CliAdminBuilder:
         self._dashboard_path: str | None = None
         self._trust_proxy = False
         self._users_plugin: Any = None
+        self._theme_json: bytes = admin_theme_json(None)
 
     def set_credentials(self, username: str, password: str) -> CliAdminBuilder:
         """Set admin login credentials (overrides env vars)."""
@@ -91,6 +94,27 @@ class CliAdminBuilder:
         self._trust_proxy = trust
         return self
 
+    def set_theme(self, theme: Mapping[str, Any]) -> CliAdminBuilder:
+        """Set the dashboard's color scheme.
+
+        ``{"mode": "dark" | "light" | "system", "dark": {...}, "light": {...}}``
+        with color overrides per scheme; tokens left out keep the dashboard
+        defaults. Token keys are camelCase (``primaryHover``) or snake_case
+        (``primary_hover``). Values must be plain CSS colors (hex,
+        ``rgb()``/``hsl()``/``oklch()``... or a named color); anything else
+        raises :class:`ValueError` here.
+
+        Example::
+
+            builder.set_theme({
+                "mode": "system",
+                "light": {"primary": "#2a6bba", "background": "#f1f6fa"},
+                "dark": {"primary": "#4f9be0", "background": "#0d1823"},
+            })
+        """
+        self._theme_json = admin_theme_json(theme)
+        return self
+
     def set_users_plugin(self, users_plugin: Any) -> CliAdminBuilder:
         """Authenticate the dashboard through the users plugin."""
         self._users_plugin = users_plugin
@@ -164,7 +188,9 @@ class CliAdminBuilder:
         dashboard_app = None
 
         if dashboard_dir:
-            dashboard_app = SPAStaticFiles(directory=dashboard_dir, html=True)
+            dashboard_app = SPAStaticFiles(
+                directory=dashboard_dir, html=True, theme_json=self._theme_json,
+            )
 
         return CliAdminPlugin(
             prefix="/api/v1/qcli",