PyPI - plain.admin - Versions diffs - 0.14.1__py3-none-any.whl - Mend

plain.admin 0.14.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (80) hide show

plain/admin/README.md +260 -0
plain/admin/__init__.py +5 -0
plain/admin/assets/admin/admin.css +108 -0
plain/admin/assets/admin/admin.js +79 -0
plain/admin/assets/admin/chart.js +19 -0
plain/admin/assets/admin/jquery-3.6.1.slim.min.js +2 -0
plain/admin/assets/admin/list.js +57 -0
plain/admin/assets/admin/popper.min.js +5 -0
plain/admin/assets/admin/tippy-bundle.umd.min.js +1 -0
plain/admin/assets/toolbar/toolbar.js +51 -0
plain/admin/cards/__init__.py +10 -0
plain/admin/cards/base.py +86 -0
plain/admin/cards/charts.py +153 -0
plain/admin/cards/tables.py +26 -0
plain/admin/config.py +21 -0
plain/admin/dates.py +254 -0
plain/admin/default_settings.py +4 -0
plain/admin/impersonate/README.md +44 -0
plain/admin/impersonate/__init__.py +3 -0
plain/admin/impersonate/middleware.py +38 -0
plain/admin/impersonate/models.py +0 -0
plain/admin/impersonate/permissions.py +16 -0
plain/admin/impersonate/settings.py +8 -0
plain/admin/impersonate/urls.py +10 -0
plain/admin/impersonate/views.py +23 -0
plain/admin/middleware.py +12 -0
plain/admin/querystats/README.md +191 -0
plain/admin/querystats/__init__.py +3 -0
plain/admin/querystats/core.py +153 -0
plain/admin/querystats/middleware.py +99 -0
plain/admin/querystats/urls.py +9 -0
plain/admin/querystats/views.py +27 -0
plain/admin/templates/admin/base.html +160 -0
plain/admin/templates/admin/cards/base.html +30 -0
plain/admin/templates/admin/cards/card.html +17 -0
plain/admin/templates/admin/cards/chart.html +25 -0
plain/admin/templates/admin/cards/table.html +35 -0
plain/admin/templates/admin/delete.html +17 -0
plain/admin/templates/admin/detail.html +24 -0
plain/admin/templates/admin/form.html +13 -0
plain/admin/templates/admin/index.html +5 -0
plain/admin/templates/admin/list.html +194 -0
plain/admin/templates/admin/page.html +3 -0
plain/admin/templates/admin/search.html +27 -0
plain/admin/templates/admin/values/UUID.html +1 -0
plain/admin/templates/admin/values/bool.html +9 -0
plain/admin/templates/admin/values/datetime.html +1 -0
plain/admin/templates/admin/values/default.html +5 -0
plain/admin/templates/admin/values/dict.html +1 -0
plain/admin/templates/admin/values/get_display.html +1 -0
plain/admin/templates/admin/values/img.html +4 -0
plain/admin/templates/admin/values/list.html +1 -0
plain/admin/templates/admin/values/model.html +15 -0
plain/admin/templates/admin/values/queryset.html +7 -0
plain/admin/templates/elements/admin/Checkbox.html +8 -0
plain/admin/templates/elements/admin/CheckboxField.html +7 -0
plain/admin/templates/elements/admin/FieldErrors.html +5 -0
plain/admin/templates/elements/admin/Input.html +9 -0
plain/admin/templates/elements/admin/InputField.html +5 -0
plain/admin/templates/elements/admin/Label.html +3 -0
plain/admin/templates/elements/admin/Select.html +11 -0
plain/admin/templates/elements/admin/SelectField.html +5 -0
plain/admin/templates/elements/admin/Submit.html +6 -0
plain/admin/templates/querystats/querystats.html +78 -0
plain/admin/templates/querystats/toolbar.html +79 -0
plain/admin/templates/toolbar/toolbar.html +91 -0
plain/admin/templates.py +25 -0
plain/admin/toolbar.py +36 -0
plain/admin/urls.py +45 -0
plain/admin/views/__init__.py +41 -0
plain/admin/views/base.py +140 -0
plain/admin/views/models.py +254 -0
plain/admin/views/objects.py +399 -0
plain/admin/views/registry.py +117 -0
plain/admin/views/types.py +6 -0
plain/admin/views/viewsets.py +54 -0
plain_admin-0.14.1.dist-info/METADATA +275 -0
plain_admin-0.14.1.dist-info/RECORD +80 -0
plain_admin-0.14.1.dist-info/WHEEL +4 -0
plain_admin-0.14.1.dist-info/licenses/LICENSE +28 -0

plain/admin/querystats/README.md ADDED Viewed

@@ -0,0 +1,191 @@
+# plain.querystats
+On-page database query stats in development and production.
+On each page, the query stats will display how many database queries were performed and how long they took.
+[Watch on YouTube](https://www.youtube.com/watch?v=NX8VXxVJm08)
+Clicking the stats in the toolbar will show the full SQL query log with tracebacks and timings.
+This is even designed to work in production,
+making it much easier to discover and debug performance issues on production data!
+![Django query stats](https://user-images.githubusercontent.com/649496/213781593-54197bb6-36a8-4c9d-8294-5b43bd86a4c9.png)
+It will also point out duplicate queries,
+which can typically be removed by using `select_related`,
+`prefetch_related`, or otherwise refactoring your code.
+## Installation
+```python
+# settings.py
+INSTALLED_PACKAGES = [
+    # ...
+    "plain.admin.querystats",
+]
+MIDDLEWARE = [
+    "plain.sessions.middleware.SessionMiddleware",
+    "plain.auth.middleware.AuthenticationMiddleware",
+    "plain.admin.querystats.QueryStatsMiddleware",
+    # Put additional middleware below querystats
+    # ...
+]
+```
+We strongly recommend using the plain-toolbar along with this,
+but if you aren't,
+you can add the querystats to your frontend templates with this include:
+```html
+{% include "querystats/button.html" %}
+```
+*Note that you will likely want to surround this with an if `DEBUG` or `is_admin` check.*
+To view querystats you need to send a POST request to `?querystats=store` (i.e. via a `<form>`),
+and the template include is the easiest way to do that.
+## Tailwind CSS
+This package is styled with [Tailwind CSS](https://tailwindcss.com/),
+and pairs well with [`plain-tailwind`](https://github.com/plainpackages/plain-tailwind).
+If you are using your own Tailwind implementation,
+you can modify the "content" in your Tailwind config to include any Plain packages:
+```js
+// tailwind.config.js
+module.exports = {
+  content: [
+    // ...
+    ".venv/lib/python*/site-packages/plain*/**/*.{html,js}",
+  ],
+  // ...
+}
+```
+If you aren't using Tailwind, and don't intend to, open an issue to discuss other options.
+# plain.toolbar
+The admin toolbar is enabled for every user who `is_admin`.
+![Plain admin toolbar](https://user-images.githubusercontent.com/649496/213781915-a2094f54-99b8-4a05-a36e-dee107405229.png)
+## Installation
+Add `plaintoolbar` to your `INSTALLED_PACKAGES`,
+and the `{% toolbar %}` to your base template:
+```python
+# settings.py
+INSTALLED_PACKAGES += [
+    "plaintoolbar",
+]
+```
+```html
+<!-- base.template.html -->
+{% load toolbar %}
+<!doctype html>
+<html lang="en">
+  <head>
+    ...
+  </head>
+  <body>
+    {% toolbar %}
+    ...
+  </body>
+```
+More specific settings can be found below.
+## Tailwind CSS
+This package is styled with [Tailwind CSS](https://tailwindcss.com/),
+and pairs well with [`plain-tailwind`](https://github.com/plainpackages/plain-tailwind).
+If you are using your own Tailwind implementation,
+you can modify the "content" in your Tailwind config to include any Plain packages:
+```js
+// tailwind.config.js
+module.exports = {
+  content: [
+    // ...
+    ".venv/lib/python*/site-packages/plain*/**/*.{html,js}",
+  ],
+  // ...
+}
+```
+If you aren't using Tailwind, and don't intend to, open an issue to discuss other options.
+# plain.requestlog
+The request log stores a local history of HTTP requests and responses during `plain work` (Django runserver).
+The request history will make it easy to see redirects,
+400 and 500 level errors,
+form submissions,
+API calls,
+webhooks,
+and more.
+[Watch on YouTube](https://www.youtube.com/watch?v=AwI7Pt5oZnM)
+Requests can be re-submitted by clicking the "replay" button.
+[![Django request log](https://user-images.githubusercontent.com/649496/213781414-417ad043-de67-4836-9ef1-2b91404336c3.png)](https://user-images.githubusercontent.com/649496/213781414-417ad043-de67-4836-9ef1-2b91404336c3.png)
+## Installation
+```python
+# settings.py
+INSTALLED_PACKAGES += [
+    "plainrequestlog",
+]
+MIDDLEWARE = MIDDLEWARE + [
+    # ...
+    "plainrequestlog.RequestLogMiddleware",
+]
+```
+The default settings can be customized if needed:
+```python
+# settings.py
+DEV_REQUESTS_IGNORE_PATHS = [
+    "/sw.js",
+    "/favicon.ico",
+    "/admin/jsi18n/",
+]
+DEV_REQUESTS_MAX = 50
+```
+## Tailwind CSS
+This package is styled with [Tailwind CSS](https://tailwindcss.com/),
+and pairs well with [`plain-tailwind`](https://github.com/plainpackages/plain-tailwind).
+If you are using your own Tailwind implementation,
+you can modify the "content" in your Tailwind config to include any Plain packages:
+```js
+// tailwind.config.js
+module.exports = {
+  content: [
+    // ...
+    ".venv/lib/python*/site-packages/plain*/**/*.{html,js}",
+  ],
+  // ...
+}
+```
+If you aren't using Tailwind, and don't intend to, open an issue to discuss other options.

plain/admin/querystats/__init__.py ADDED Viewed

@@ -0,0 +1,3 @@
+from .middleware import QueryStatsMiddleware
+__all__ = ["QueryStatsMiddleware"]

plain/admin/querystats/core.py ADDED Viewed

@@ -0,0 +1,153 @@
+import time
+import traceback
+from collections import Counter
+import sqlparse
+from plain.utils.functional import cached_property
+IGNORE_STACK_FILES = [
+    "threading",
+    "socketserver",
+    "wsgiref",
+    "gunicorn",
+    "whitenoise",
+    "sentry_sdk",
+    "querystats/core",
+    "plain/template/base",
+    "plain/utils/decorators",
+    "plain/utils/deprecation",
+    "plain/db",
+    "plain/utils/functional",
+    "plain/core/servers",
+    "plain/core/handlers",
+]
+def pretty_print_sql(sql):
+    return sqlparse.format(sql, reindent=True, keyword_case="upper")
+def get_stack():
+    return "".join(tidy_stack(traceback.format_stack()))
+def tidy_stack(stack):
+    lines = []
+    skip_next = False
+    for line in stack:
+        if skip_next:
+            skip_next = False
+            continue
+        if line.startswith('  File "') and any(
+            ignore in line for ignore in IGNORE_STACK_FILES
+        ):
+            skip_next = True
+            continue
+        lines.append(line)
+    return lines
+class QueryStats:
+    def __init__(self, include_tracebacks):
+        self.queries = []
+        self.include_tracebacks = include_tracebacks
+    def __str__(self):
+        s = f"{self.num_queries} queries in {self.total_time_display}"
+        if self.duplicate_queries:
+            s += f" ({self.num_duplicate_queries} duplicates)"
+        return s
+    def __call__(self, execute, sql, params, many, context):
+        current_query = {"sql": sql, "params": params, "many": many}
+        start = time.monotonic()
+        result = execute(sql, params, many, context)
+        if self.include_tracebacks:
+            current_query["tb"] = get_stack()
+        # if many, then X times is len(params)
+        current_query["result"] = result
+        current_query["duration"] = time.monotonic() - start
+        self.queries.append(current_query)
+        return result
+    @cached_property
+    def total_time(self):
+        return sum(q["duration"] for q in self.queries)
+    @staticmethod
+    def get_time_display(seconds):
+        if seconds < 0.01:
+            return f"{seconds * 1000:.0f} ms"
+        return f"{seconds:.2f} seconds"
+    @cached_property
+    def total_time_display(self):
+        return self.get_time_display(self.total_time)
+    @cached_property
+    def num_queries(self):
+        return len(self.queries)
+    # @cached_property
+    # def models(self):
+    #     # parse table names from self.queries sql
+    #     table_names = [x for x in [q['sql'].split(' ')[2] for q in self.queries] if x]
+    #     models = connection.introspection.installed_models(table_names)
+    #     return models
+    @cached_property
+    def duplicate_queries(self):
+        sqls = [q["sql"] for q in self.queries]
+        duplicates = {k: v for k, v in Counter(sqls).items() if v > 1}
+        return duplicates
+    @cached_property
+    def num_duplicate_queries(self):
+        # Count the number of "excess" queries by getting how many there
+        # are minus the initial one (and potentially only one required)
+        return sum(self.duplicate_queries.values()) - len(self.duplicate_queries)
+    def as_summary_dict(self):
+        return {
+            "summary": str(self),
+            "total_time": self.total_time,
+            "num_queries": self.num_queries,
+            "num_duplicate_queries": self.num_duplicate_queries,
+        }
+    def as_context_dict(self):
+        # If we don't create a dict, the instance of this class
+        # is lost before we can use it in the template
+        for query in self.queries:
+            # Add some useful display info
+            query["duration_display"] = self.get_time_display(query["duration"])
+            query["sql_display"] = pretty_print_sql(query["sql"])
+            duplicates = self.duplicate_queries.get(query["sql"], 0)
+            if duplicates:
+                query["duplicate_count"] = duplicates
+        summary = self.as_summary_dict()
+        return {
+            **summary,
+            "total_time_display": self.total_time_display,
+            "queries": self.queries,
+        }
+    def as_server_timing(self):
+        duration = self.total_time * 1000  # put in ms
+        duration = round(duration, 2)
+        description = str(self)
+        return f'querystats;dur={duration};desc="{description}"'

plain/admin/querystats/middleware.py ADDED Viewed

@@ -0,0 +1,99 @@
+import json
+import logging
+import re
+import threading
+from plain.http import ResponseRedirect
+from plain.json import PlainJSONEncoder
+from plain.models import connection
+from plain.runtime import settings
+from plain.urls import reverse
+from .core import QueryStats
+try:
+    try:
+        import psycopg
+    except ImportError:
+        import psycopg2 as psycopg
+except ImportError:
+    psycopg = None
+logger = logging.getLogger(__name__)
+_local = threading.local()
+class QueryStatsJSONEncoder(PlainJSONEncoder):
+    def default(self, obj):
+        try:
+            return super().default(obj)
+        except TypeError:
+            if psycopg and isinstance(obj, psycopg._json.Json):
+                return obj.adapted
+            else:
+                raise
+class QueryStatsMiddleware:
+    def __init__(self, get_response):
+        self.get_response = get_response
+        self.ignore_url_patterns = [
+            re.compile(url) for url in settings.QUERYSTATS_IGNORE_URLS
+        ]
+    def should_ignore_request(self, request):
+        for url in self.ignore_url_patterns:
+            if url.match(request.path):
+                return True
+        return False
+    def __call__(self, request):
+        if request.GET.get("querystats") == "disable":
+            return self.get_response(request)
+        querystats = QueryStats(
+            # Only want these if we're getting ready to show it
+            include_tracebacks=request.GET.get("querystats") == "store"
+        )
+        with connection.execute_wrapper(querystats):
+            # Have to wrap this first call so it is included in the querystats,
+            # but we don't have to wrap everything else unless we are admin or debug
+            is_admin = self.is_admin_request(request)
+        if (settings.DEBUG or is_admin) and not self.should_ignore_request(request):
+            # Persist it on the thread
+            _local.querystats = querystats
+            with connection.execute_wrapper(_local.querystats):
+                response = self.get_response(request)
+            if settings.DEBUG:
+                # TODO logging settings
+                logger.debug("Querystats: %s", _local.querystats)
+            # Make current querystats available on the current page
+            # by using the server timing API which can be parsed client-side
+            response.headers["Server-Timing"] = _local.querystats.as_server_timing()
+            if request.GET.get("querystats") == "store":
+                request.session["querystats"] = json.dumps(
+                    _local.querystats.as_context_dict(), cls=QueryStatsJSONEncoder
+                )
+                return ResponseRedirect(reverse("querystats:querystats"))
+            del _local.querystats
+            return response
+        else:
+            return self.get_response(request)
+    @staticmethod
+    def is_admin_request(request):
+        if getattr(request, "impersonator", None):
+            # Support for impersonation (still want the real admin user to see the querystats)
+            return request.impersonator and request.impersonator.is_admin
+        return hasattr(request, "user") and request.user and request.user.is_admin

plain/admin/querystats/urls.py ADDED Viewed

@@ -0,0 +1,9 @@
+from plain.urls import path
+from . import views
+default_namespace = "querystats"
+urlpatterns = [
+    path("", views.QuerystatsView, name="querystats"),
+]

plain/admin/querystats/views.py ADDED Viewed

@@ -0,0 +1,27 @@
+import json
+from plain.auth.views import AuthViewMixin
+from plain.views import TemplateView
+class QuerystatsView(AuthViewMixin, TemplateView):
+    template_name = "querystats/querystats.html"
+    admin_required = True  # allow impersonator?
+    def get_template_context(self):
+        context = super().get_template_context()
+        stored_querystats = self.request.session.get(
+            "querystats"
+        )  # Not popping so page can be reloaded
+        if stored_querystats:
+            # dates won't come back as Python dates...
+            stored_querystats = json.loads(stored_querystats)
+            context["querystats"] = stored_querystats
+        return context
+    def get_querystats(self):
+        from .middleware import _local
+        return _local.querystats

plain/admin/templates/admin/base.html ADDED Viewed

@@ -0,0 +1,160 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>
+        {%- if title|default('') -%}
+            {{ title }} - Plain Admin
+        {%- else -%}
+            Plain Admin
+        {%- endif -%}
+    </title>
+    {% tailwind_css %}
+    {% htmx_js %}
+    <link href="{{ asset('admin/admin.css') }}" rel="stylesheet">
+    <script src="{{ asset('admin/jquery-3.6.1.slim.min.js') }}"></script>
+    <script src="{{ asset('admin/chart.js') }}" defer></script>
+    <script src="{{ asset('admin/admin.js') }}" defer></script>
+    <script src="{{ asset('admin/popper.min.js') }}" defer></script>
+    <script src="{{ asset('admin/tippy-bundle.umd.min.js') }}" defer></script>
+    {% block header_scripts %}{% endblock %}
+</head>
+<body class="flex min-h-screen bg-stone-950">
+    <nav class="fixed top-0 left-0 right-0 h-14 px-4 py-2 flex items-center justify-evenly text-sm text-white/70">
+        <div class="flex items-center space-x-2">
+            <button type="button" data-toggle="#admin-sidebar,#admin-content" class="mr-1 lg:hidden">
+                <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="w-5 h-5 bi bi-list" viewBox="0 0 16 16">
+                    <path fill-rule="evenodd" d="M2.5 12a.5.5 0 0 1 .5-.5h10a.5.5 0 0 1 0 1H3a.5.5 0 0 1-.5-.5m0-4a.5.5 0 0 1 .5-.5h10a.5.5 0 0 1 0 1H3a.5.5 0 0 1-.5-.5m0-4a.5.5 0 0 1 .5-.5h10a.5.5 0 0 1 0 1H3a.5.5 0 0 1-.5-.5"/>
+                </svg>
+                <span class="sr-only">Toggle menu</span>
+            </button>
+            <a class="inline-flex items-center text-stone-300" href="{{ url('admin:index') }}">
+                <svg class="w-5 h-5 mr-2" width="160" height="125" viewBox="0 0 160 125" fill="none" xmlns="http://www.w3.org/2000/svg">
+                    <rect x="4.78467" y="4.79785" width="150.978" height="115.404" rx="5" stroke="#ffffff" stroke-width="8"/>
+                    <path d="M151.762 60.3705C99.2596 39.3233 80.202 66.8232 8.78467 60.3705V116.2H151.762V60.3705Z" fill="#ffffff"/>
+                    <path d="M51.104 8.08887H108.179V10.7668C108.179 12.6998 106.612 14.2668 104.679 14.2668H54.604C52.671 14.2668 51.104 12.6998 51.104 10.7668V8.08887Z" fill="#ffffff" stroke="#ffffff"/>
+                </svg>
+                <span class="text-stone-400">Admin</span>
+            </a>
+            {#
+            {% for parent in parent_view_classes %}
+            <span class="text-stone-400">/</span>
+            <a class="text-stone-500" href="{{ parent.get_view_url() }}">{{ parent.get_nav_title() }}</a>
+            {% endfor %}
+            <span class="text-stone-400">/</span>
+            <a class="text-stone-600" href="{{ request.path }}">{{ title }}</a>
+            #}
+        </div>
+        <form method="GET" action="{{ url('admin:search') }}" class="flex flex-1 justify-center">
+            <div class="relative max-w-xs">
+                <label for="query" class="sr-only">Search</label>
+                <input
+                    type="text"
+                    name="query"
+                    id="query"
+                    class="block w-full pr-10 pl-10 placeholder:text-center text-sm border-gray-200/10 text-white rounded-md focus:border-blue-500 focus:ring-blue-500 bg-white/5 py-1"
+                    placeholder="Search everything"
+                    value="{{ global_search_query|default('') }}"
+                    >
+                <div class="absolute inset-y-0 left-0 flex items-center pl-4 pointer-events-none">
+                    <svg class="h-3.5 w-3.5 text-gray-400" xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" viewBox="0 0 16 16">
+                        <path d="M11.742 10.344a6.5 6.5 0 1 0-1.397 1.398h-.001c.03.04.062.078.098.115l3.85 3.85a1 1 0 0 0 1.415-1.414l-3.85-3.85a1.007 1.007 0 0 0-.115-.1zM12 6.5a5.5 5.5 0 1 1-11 0 5.5 5.5 0 0 1 11 0z"></path>
+                    </svg>
+                </div>
+            </div>
+        </form>
+        <div class="">
+            <a href="/" class="">Back to app</a>
+        </div>
+    </nav>
+    <div class="fixed top-14 bottom-2 left-2 right-2">
+        <aside id="admin-sidebar" data-toggle-class="hidden" class="flex-col bg-stone-950 z-50 border-r border-white/10 lg:border-none justify-between flex-shrink-0 hidden w-52 pl-3.5 pr-5 pt-2 overflow-auto lg:flex absolute top-0 bottom-0">
+            <div class="flex-grow">
+                <div>
+                    {% for section, views in admin_registry.get_nav_sections().items() %}
+                    <div class="mt-4 text-xs tracking-wide uppercase text-stone-300/90">{{ section }}</div>
+                    {% for view in views %}
+                    {% set url = view.get_view_url() %}
+                    <a
+                        {% if url == request.path %}data-active{% endif %}
+                        class="data-[active]:bg-white/20 data-[active]:text-white flex items-center px-2 py-1 mt-px -mx-2 text-sm rounded hover:text-stone-300 text-stone-400/80 hover:bg-white/5"
+                        href="{{ url }}">
+                        {{ view.get_nav_title() }}
+                    </a>
+                    {% endfor %}
+                    {% endfor %}
+                </div>
+                <!-- <div class="mt-6">
+                    <div class="text-xs tracking-wide text-stone-500">Pinned</div>
+                </div>
+                <div class="mt-6">
+                    <div class="text-xs tracking-wide text-stone-500">Recent</div>
+                </div> -->
+            </div>
+            <div class="flex items-center justify-between mt-8 text-sm pb-3 pt-3 text-stone-400 sticky bottom-0 bg-stone-950">
+                <div class="flex items-center truncate">
+                    <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="w-6 h-6 mr-1.5 bi bi-person-circle" viewBox="0 0 16 16">
+                        <path d="M11 6a3 3 0 1 1-6 0 3 3 0 0 1 6 0z"/>
+                        <path fill-rule="evenodd" d="M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8zm8-7a7 7 0 0 0-5.468 11.37C3.242 11.226 4.805 10 8 10s4.757 1.225 5.468 2.37A7 7 0 0 0 8 1z"/>
+                    </svg>
+                    <span class="truncate">
+                        {{ request.user }}
+                    </span>
+                </div>
+                <a class="ml-2 hover:text-white hover:underline flex-shrink-0" href="{{ url('logout') }}">Log out</a>
+            </div>
+        </aside>
+        <div id="admin-content" data-toggle-class="x" class="absolute top-0 bottom-0 right-0 left-0 lg:left-52 bg-stone-900 border border-white/5 text-white rounded-lg overflow-auto">
+            <div class="flex items-center justify-between px-4 lg:px-8 sticky z-10 top-0 bg-stone-900 border-b border-white/10 py-2 lg:py-3">
+                <div>
+                {% block header %}
+                    <div class="flex items-center">
+                        {% block image %}
+                            {% if image %}
+                            <img src="{{ image.src }}" alt="{{ image.alt }}" class="h-20 rounded mr-3">
+                            {% endif %}
+                        {% endblock %}
+                        <div class="max-w-prose break-all">
+                            <h1 class="text-xl text-white/90">
+                                {% block title %}{{ title }}{% endblock %}
+                            </h1>
+                            {% if description %}<p class="mt-1 text-sm text-gray-500">{{ description }}</p>{% endif %}
+                        </div>
+                    </div>
+                {% endblock %}
+                </div>
+                <div class="flex space-x-2 text-sm actions">
+                    {% block actions %}{% endblock %}
+                    {% for link, url in links.items() %}
+                    <a href="{{ url }}">{{ link }}</a>
+                    {% endfor %}
+                </div>
+            </div>
+            {% if cards %}
+            <div class="px-4 mt-5 lg:px-8">
+                <div class="grid grid-cols-1 gap-6 mt-4 sm:grid-cols-2 lg:grid-cols-4">
+                    {% for card in cards %}
+                        {{ render_card(card)|safe }}
+                    {% endfor %}
+                </div>
+            </div>
+            {% endif %}
+            <main class="px-4 py-6 lg:px-8 text-white/70">{% block content %}{% endblock %}</main>
+        </div>
+    </div>
+    {% toolbar %}
+</body>
+</html>

plain/admin/templates/admin/cards/base.html ADDED Viewed

@@ -0,0 +1,30 @@
+<section
+    id="card-{{ slug }}"
+    hx-target="this"
+    hx-select="#card-{{ slug }}"
+    hx-swap="outerHTML"
+    class="col-span-{{ size.value }}">
+    {% block header %}
+    <header class="flex justify-between items-center">
+        <div>
+            <h2 class="text-sm font-semibold">{{ title }}</h2>
+            {% if description %}<p class="mt-1 text-xs text-gray-500">{{ description }}</p>{% endif %}
+        </div>
+        {% if displays %}
+        <select
+            hx-get
+            name="{{ slug }}.display"
+            class="text-sm border-gray-200 rounded-md">
+            <option value="">(Reset to default)</option>
+            {% for display in displays %}
+            <option {% if display == current_display %}selected{% endif %}>{{ display }}</option>
+            {% endfor %}
+        </select>
+        {% endif %}
+    </header>
+    {% endblock %}
+    <div>
+    {% block content %}{% endblock %}
+</section>