plain.admin 0.22.1__py3-none-any.whl → 0.25.1__py3-none-any.whl

plain/admin/README.md

@@ -1,261 +1,163 @@
-# Admin
+# plain.admin
 
-An admin interface for admin users.
+**Manage your app with a backend interface.**
 
-The Plain Admin is a new package built from the ground up.
-It leverages class-based views and standard URLs and templates to provide a flexible admin where
-you can quickly create your own pages and cards,
-in addition to models.
+The Plain Admin provides a combination of built-in views and the flexibility to create your own. You can use it to quickly get visibility into your app's data and to manage it.
 
-- cards
-- dashboards
-- diy forms
-- detached from login (do your own login (oauth, passkeys, etc))
+![Plain Admin user example](https://assets.plainframework.com/docs/plain-pageviews-user.png)
 
 ## Installation
 
-- install plain.admin and plain.htmx, add plain.admin.admin and plain.htmx to installed packages
-- add url
+Install the `plain.admin` package and its dependencies.
 
-## Models in the admin
-
-## Dashboards
-
-<!-- # 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)
+```console
+uv add plain.admin
+```
 
-It will also point out duplicate queries,
-which can typically be removed by using `select_related`,
-`prefetch_related`, or otherwise refactoring your code.
-
-## Installation
+The admin uses a combination of other Plain packages, most of which you will already have installed. Ultimately, your settings will look something like this:
 
 ```python
-# settings.py
+# app/settings.py
 INSTALLED_PACKAGES = [
-    # ...
-    "plain.admin.querystats",
+    "plain.models",
+    "plain.tailwind",
+    "plain.auth",
+    "plain.sessions",
+    "plain.htmx",
+    "plain.admin",
+    "plain.elements",
+    # other packages...
 ]
 
+AUTH_USER_MODEL = "users.User"
+AUTH_LOGIN_URL = "login"
+
 MIDDLEWARE = [
     "plain.sessions.middleware.SessionMiddleware",
     "plain.auth.middleware.AuthenticationMiddleware",
-
-    "plain.admin.querystats.QueryStatsMiddleware",
-    # Put additional middleware below querystats
-    # ...
+    "plain.admin.AdminMiddleware",
 ]
 ```
 
-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.
+Your User model is expected to have an `is_admin` field (or attribute) for checking who has permission to access the admin.
 
-## Tailwind CSS
-
-This package is styled with [Tailwind CSS](https://tailwindcss.com/),
-and pairs well with [`plain-tailwind`](https://github.com/plainpackages/plain-tailwind).
+```python
+# app/users/models.py
+from plain import models
 
-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}",
-  ],
-  // ...
-}
+@models.register_model
+class User(models.Model):
+    is_admin = models.BooleanField(default=False)
+    # other fields...
 ```
 
-If you aren't using Tailwind, and don't intend to, open an issue to discuss other options.
-
+To make the admin accessible, add the `AdminRouter` to your root URLs.
 
-# plain.toolbar
+```python
+# app/urls.py
+from plain.admin.urls import AdminRouter
+from plain.urls import Router, include, path
 
-The admin toolbar is enabled for every user who `is_admin`.
+from . import views
 
-![Plain Admin toolbar](https://user-images.githubusercontent.com/649496/213781915-a2094f54-99b8-4a05-a36e-dee107405229.png)
 
-## Installation
+class AppRouter(Router):
+    namespace = ""
+    urls = [
+        include("admin/", AdminRouter),
+        path("login/", views.LoginView, name="login"),
+        path("logout/", LogoutView, name="logout"),
+        # other urls...
+    ]
 
-Add `plaintoolbar` to your `INSTALLED_PACKAGES`,
-and the `{% toolbar %}` to your base template:
-
-```python
-# settings.py
-INSTALLED_PACKAGES += [
-    "plaintoolbar",
-]
 ```
 
-```html
-<!-- base.template.html -->
+Optionally, you can add the admin toolbar to your base template. The toolbar will appear when `settings.DEBUG` or when `request.user.is_admin` (including in production!).
 
-{% load toolbar %}
-
-<!doctype html>
+```html
+<!-- app/templates/base.html -->
+<!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:
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>{{ html_title|default("My App") }}</title>
+    {% tailwind_css %}
+</head>
+<body>
+    {% block content required %}{% endblock %}
 
-```js
-// tailwind.config.js
-module.exports = {
-  content: [
-    // ...
-    ".venv/lib/python*/site-packages/plain*/**/*.{html,js}",
-  ],
-  // ...
-}
+    {% toolbar %}
+</body>
+</html>
 ```
 
-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)
+## Admin viewsets
 
-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
+The most common use of the admin is to display and manage your `plain.models`. To do this, create a viewset with a set of inner views.
 
 ```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
+# app/users/admin.py
+from plain.admin.views import (
+    AdminModelDetailView,
+    AdminModelListView,
+    AdminModelUpdateView,
+    AdminViewset,
+    register_viewset,
+)
+from plain.models.forms import ModelForm
+
+from .models import User
+
+
+class UserForm(ModelForm):
+    class Meta:
+        model = User
+        fields = ["email"]
+
+
+@register_viewset
+class UserAdmin(AdminViewset):
+    class ListView(AdminModelListView):
+        model = User
+        fields = [
+            "id",
+            "email",
+            "created_at__date",
+        ]
+        queryset_order = ["-created_at"]
+        search_fields = [
+            "email",
+        ]
+
+    class DetailView(AdminModelDetailView):
+        model = User
+
+    class UpdateView(AdminModelUpdateView):
+        template_name = "admin/users/user_form.html"
+        model = User
+        form_class = UserForm
 ```
 
-## Tailwind CSS
+The [`AdminViewset`](./views/viewsets.py) will automatically recognize inner views named `ListView`, `CreateView`, `DetailView`, `UpdateView`, and `DeleteView`. It will interlink these views automatically in the UI and form success URLs. You can define additional views too, but you will need to implement a couple methods to hook them up.
 
-This package is styled with [Tailwind CSS](https://tailwindcss.com/),
-and pairs well with [`plain-tailwind`](https://github.com/plainpackages/plain-tailwind).
+## Admin cards
 
-If you are using your own Tailwind implementation,
-you can modify the "content" in your Tailwind config to include any Plain packages:
+TODO
 
-```js
-// tailwind.config.js
-module.exports = {
-  content: [
-    // ...
-    ".venv/lib/python*/site-packages/plain*/**/*.{html,js}",
-  ],
-  // ...
-}
-```
+## Admin forms
 
-If you aren't using Tailwind, and don't intend to, open an issue to discuss other options.
+TODO
 
-# plain.impersonate
+## Toolbar
 
-See what your users see.
+TODO
 
-A key feature for providing customer support is to be able to view the site through their account.
-With `impersonate` installed, you can impersonate a user by finding them in the Django admin and clicking the "Impersonate" button.
-
-![](/docs/img/impersonate-admin.png)
-
-Then with the [admin toolbar](/docs/plain-toolbar/) enabled, you'll get a notice of the impersonation and a button to exit:
-
-![](/docs/img/impersonate-bar.png)
-
-## Installation
-
-To impersonate users, you need the app, middleware, and URLs:
-
-```python
-# settings.py
-INSTALLED_PACKAGES = INSTALLED_PACKAGES + [
-  "plain.admin.impersonate",
-]
-
-MIDDLEWARE = MIDDLEWARE + [
-  "plain.admin.impersonate.ImpersonateMiddleware",
-]
-```
-
-```python
-# urls.py
-urlpatterns = [
-    # ...
-    path("impersonate/", include("plain.admin.impersonate.urls")),
-]
-```
+## Impersonate
 
-## Settings
+TODO
 
-By default, all admin users can impersonate other users.
+## Querystats
 
-````python
-# settings.py
-IMPERSONATE_ALLOWED = lambda user: user.is_admin
-``` -->
-````
+TODO

plain/admin/assets/admin/admin.js

@@ -58,8 +58,13 @@ jQuery(function($) {
                 // Column already has a link, so don't add another
                 return;
             }
+            var autolinkUrl = $this.data("column-autolink");
+            if (!autolinkUrl) {
+                // No URL, so don't add a link
+                return;
+            }
             var $link = $(document.createElement("a"));
-            $link.attr("href", $this.data("column-autolink"));
+            $link.attr("href", autolinkUrl);
             $link.addClass("flex p-2 -m-2 text-white/80 hover:no-underline");
             $(this).wrapInner($link);
         })

plain/admin/config.py

@@ -6,7 +6,7 @@ from plain.packages import PackageConfig, packages_registry, register_config
 
 @register_config
 class Config(PackageConfig):
-    label = "plainadmin"
+    package_label = "plainadmin"
 
     def ready(self):
         def _import_if_exists(module_name):

plain/admin/views/models.py

@@ -162,17 +162,6 @@ class AdminModelDetailView(AdminDetailView):
     def get_object(self):
         return self.model.objects.get(pk=self.url_kwargs["pk"])
 
-    def get_template_names(self) -> list[str]:
-        template_names = super().get_template_names()
-
-        if not self.template_name and isinstance(self.object, models.Model):
-            object_meta = self.object._meta
-            template_names = [
-                f"admin/{object_meta.package_label}/{object_meta.model_name}{self.template_name_suffix}.html"
-            ] + template_names
-
-        return template_names
-
 
 class AdminModelCreateView(AdminCreateView):
     model: "models.Model"
@@ -191,17 +180,6 @@ class AdminModelCreateView(AdminCreateView):
 
         return f"{cls.model._meta.model_name}/create/"
 
-    def get_template_names(self):
-        template_names = super().get_template_names()
-
-        if not self.template_name and issubclass(self.model, models.Model):
-            model_meta = self.model._meta
-            template_names = [
-                f"admin/{model_meta.package_label}/{model_meta.model_name}{self.template_name_suffix}.html"
-            ] + template_names
-
-        return template_names
-
 
 class AdminModelUpdateView(AdminUpdateView):
     model: "models.Model"
@@ -224,17 +202,6 @@ class AdminModelUpdateView(AdminUpdateView):
     def get_object(self):
         return self.model.objects.get(pk=self.url_kwargs["pk"])
 
-    def get_template_names(self):
-        template_names = super().get_template_names()
-
-        if not self.template_name and isinstance(self.object, models.Model):
-            object_meta = self.object._meta
-            template_names = [
-                f"admin/{object_meta.package_label}/{object_meta.model_name}{self.template_name_suffix}.html"
-            ] + template_names
-
-        return template_names
-
 
 class AdminModelDeleteView(AdminDeleteView):
     model: "models.Model"

plain/admin/views/objects.py

@@ -72,7 +72,7 @@ class AdminListView(HTMXViewMixin, AdminView):
 
         if self.is_htmx_request() and not hx_from_this_page and not self._page:
             # Don't render anything
-            return Response(status=204)
+            return Response(status_code=204)
 
         return response
 
@@ -144,29 +144,29 @@ class AdminListView(HTMXViewMixin, AdminView):
             "admin/values/default.html",
         ]
 
-    def get_list_url(self) -> str | None:
-        return None
+    def get_list_url(self) -> str:
+        return ""
 
-    def get_create_url(self) -> str | None:
-        return None
+    def get_create_url(self) -> str:
+        return ""
 
-    def get_detail_url(self, obj) -> str | None:
-        return None
+    def get_detail_url(self, obj) -> str:
+        return ""
 
-    def get_update_url(self, obj) -> str | None:
-        return None
+    def get_update_url(self, obj) -> str:
+        return ""
 
-    def get_delete_url(self, obj) -> str | None:
-        return None
+    def get_delete_url(self, obj) -> str:
+        return ""
 
-    def get_object_url(self, obj) -> str | None:
+    def get_object_url(self, obj) -> str:
         if url := self.get_detail_url(obj):
             return url
         if url := self.get_update_url(obj):
             return url
         if url := self.get_delete_url(obj):
             return url
-        return None
+        return ""
 
     def get_object_links(self, obj) -> dict[str]:
         links = {}
@@ -191,20 +191,20 @@ class AdminListView(HTMXViewMixin, AdminView):
 class AdminCreateView(AdminView, CreateView):
     template_name = None
 
-    def get_list_url(self) -> str | None:
-        return None
+    def get_list_url(self) -> str:
+        return ""
 
-    def get_create_url(self) -> str | None:
-        return None
+    def get_create_url(self) -> str:
+        return ""
 
-    def get_detail_url(self, obj) -> str | None:
-        return None
+    def get_detail_url(self, obj) -> str:
+        return ""
 
-    def get_update_url(self, obj) -> str | None:
-        return None
+    def get_update_url(self, obj) -> str:
+        return ""
 
-    def get_delete_url(self, obj) -> str | None:
-        return None
+    def get_delete_url(self, obj) -> str:
+        return ""
 
     def get_success_url(self, form):
         if list_url := self.get_list_url():
@@ -227,7 +227,7 @@ class AdminDetailView(AdminView, DetailView):
 
     def get_template_names(self) -> list[str]:
         return super().get_template_names() + [
-            "admin/detail.html",
+            "admin/detail.html",  # A generic detail view for rendering any object
         ]
 
     def get_description(self):
@@ -274,20 +274,20 @@ class AdminDetailView(AdminView, DetailView):
 
         return templates
 
-    def get_list_url(self) -> str | None:
-        return None
+    def get_list_url(self) -> str:
+        return ""
 
-    def get_create_url(self) -> str | None:
-        return None
+    def get_create_url(self) -> str:
+        return ""
 
-    def get_detail_url(self, obj) -> str | None:
-        return None
+    def get_detail_url(self, obj) -> str:
+        return ""
 
-    def get_update_url(self, obj) -> str | None:
-        return None
+    def get_update_url(self, obj) -> str:
+        return ""
 
-    def get_delete_url(self, obj) -> str | None:
-        return None
+    def get_delete_url(self, obj) -> str:
+        return ""
 
     def get_fields(self):
         return self.fields.copy()  # Avoid mutating the class attribute itself
@@ -311,20 +311,20 @@ class AdminUpdateView(AdminView, UpdateView):
     template_name = None
     nav_section = ""
 
-    def get_list_url(self) -> str | None:
-        return None
+    def get_list_url(self) -> str:
+        return ""
 
-    def get_create_url(self) -> str | None:
-        return None
+    def get_create_url(self) -> str:
+        return ""
 
-    def get_detail_url(self, obj) -> str | None:
-        return None
+    def get_detail_url(self, obj) -> str:
+        return ""
 
-    def get_update_url(self, obj) -> str | None:
-        return None
+    def get_update_url(self, obj) -> str:
+        return ""
 
-    def get_delete_url(self, obj) -> str | None:
-        return None
+    def get_delete_url(self, obj) -> str:
+        return ""
 
     def get_description(self):
         return repr(self.object)
@@ -363,20 +363,20 @@ class AdminDeleteView(AdminView, DeleteView):
     def get_description(self):
         return repr(self.object)
 
-    def get_list_url(self) -> str | None:
-        return None
+    def get_list_url(self) -> str:
+        return ""
 
-    def get_create_url(self) -> str | None:
-        return None
+    def get_create_url(self) -> str:
+        return ""
 
-    def get_detail_url(self, obj) -> str | None:
-        return None
+    def get_detail_url(self, obj) -> str:
+        return ""
 
-    def get_update_url(self, obj) -> str | None:
-        return None
+    def get_update_url(self, obj) -> str:
+        return ""
 
-    def get_delete_url(self, obj) -> str | None:
-        return None
+    def get_delete_url(self, obj) -> str:
+        return ""
 
     def get_links(self):
         links = super().get_links()

plain_admin-0.25.1.dist-info/METADATA

@@ -0,0 +1,178 @@
+Metadata-Version: 2.4
+Name: plain.admin
+Version: 0.25.1
+Summary: Admin dashboard and tools for Plain.
+Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: plain-auth<1.0.0
+Requires-Dist: plain-htmx<1.0.0
+Requires-Dist: plain-tailwind<1.0.0
+Requires-Dist: plain<1.0.0
+Requires-Dist: sqlparse>=0.2.2
+Description-Content-Type: text/markdown
+
+# plain.admin
+
+**Manage your app with a backend interface.**
+
+The Plain Admin provides a combination of built-in views and the flexibility to create your own. You can use it to quickly get visibility into your app's data and to manage it.
+
+![Plain Admin user example](https://assets.plainframework.com/docs/plain-pageviews-user.png)
+
+## Installation
+
+Install the `plain.admin` package and its dependencies.
+
+```console
+uv add plain.admin
+```
+
+The admin uses a combination of other Plain packages, most of which you will already have installed. Ultimately, your settings will look something like this:
+
+```python
+# app/settings.py
+INSTALLED_PACKAGES = [
+    "plain.models",
+    "plain.tailwind",
+    "plain.auth",
+    "plain.sessions",
+    "plain.htmx",
+    "plain.admin",
+    "plain.elements",
+    # other packages...
+]
+
+AUTH_USER_MODEL = "users.User"
+AUTH_LOGIN_URL = "login"
+
+MIDDLEWARE = [
+    "plain.sessions.middleware.SessionMiddleware",
+    "plain.auth.middleware.AuthenticationMiddleware",
+    "plain.admin.AdminMiddleware",
+]
+```
+
+Your User model is expected to have an `is_admin` field (or attribute) for checking who has permission to access the admin.
+
+```python
+# app/users/models.py
+from plain import models
+
+
+@models.register_model
+class User(models.Model):
+    is_admin = models.BooleanField(default=False)
+    # other fields...
+```
+
+To make the admin accessible, add the `AdminRouter` to your root URLs.
+
+```python
+# app/urls.py
+from plain.admin.urls import AdminRouter
+from plain.urls import Router, include, path
+
+from . import views
+
+
+class AppRouter(Router):
+    namespace = ""
+    urls = [
+        include("admin/", AdminRouter),
+        path("login/", views.LoginView, name="login"),
+        path("logout/", LogoutView, name="logout"),
+        # other urls...
+    ]
+
+```
+
+Optionally, you can add the admin toolbar to your base template. The toolbar will appear when `settings.DEBUG` or when `request.user.is_admin` (including in production!).
+
+```html
+<!-- app/templates/base.html -->
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>{{ html_title|default("My App") }}</title>
+    {% tailwind_css %}
+</head>
+<body>
+    {% block content required %}{% endblock %}
+
+    {% toolbar %}
+</body>
+</html>
+```
+
+## Admin viewsets
+
+The most common use of the admin is to display and manage your `plain.models`. To do this, create a viewset with a set of inner views.
+
+```python
+# app/users/admin.py
+from plain.admin.views import (
+    AdminModelDetailView,
+    AdminModelListView,
+    AdminModelUpdateView,
+    AdminViewset,
+    register_viewset,
+)
+from plain.models.forms import ModelForm
+
+from .models import User
+
+
+class UserForm(ModelForm):
+    class Meta:
+        model = User
+        fields = ["email"]
+
+
+@register_viewset
+class UserAdmin(AdminViewset):
+    class ListView(AdminModelListView):
+        model = User
+        fields = [
+            "id",
+            "email",
+            "created_at__date",
+        ]
+        queryset_order = ["-created_at"]
+        search_fields = [
+            "email",
+        ]
+
+    class DetailView(AdminModelDetailView):
+        model = User
+
+    class UpdateView(AdminModelUpdateView):
+        template_name = "admin/users/user_form.html"
+        model = User
+        form_class = UserForm
+```
+
+The [`AdminViewset`](./views/viewsets.py) will automatically recognize inner views named `ListView`, `CreateView`, `DetailView`, `UpdateView`, and `DeleteView`. It will interlink these views automatically in the UI and form success URLs. You can define additional views too, but you will need to implement a couple methods to hook them up.
+
+## Admin cards
+
+TODO
+
+## Admin forms
+
+TODO
+
+## Toolbar
+
+TODO
+
+## Impersonate
+
+TODO
+
+## Querystats
+
+TODO

{plain_admin-0.22.1.dist-info → plain_admin-0.25.1.dist-info}/RECORD

@@ -1,6 +1,6 @@
-plain/admin/README.md,sha256=GB0gTgSeMDt6jbQ9oH58xJNBJMP3iSPiVdF6KyX7vjQ,6390
+plain/admin/README.md,sha256=Ro2YkrKS-RXsmFBFN0QUpLh4OHIDvMkVgDIE6Wu4PMQ,3800
 plain/admin/__init__.py,sha256=bPv9iftT8aLqBH6dDy-HTVXW66dQUhfIiEZ-LIUMC0Y,78
-plain/admin/config.py,sha256=FpuOFmMin5WM1jxxM8-cFLCzgcaWHU6_UaD3k0euLhc,668
+plain/admin/config.py,sha256=TDYmJe4UYmKw4bz0x5s9PkDa-X4V-9JoJlka162-J7M,676
 plain/admin/dates.py,sha256=EEhcQhHt3-k6kE9yvPdH5X6EecmUQ259xywbDBec3Dg,10253
 plain/admin/default_settings.py,sha256=j7RdgGqksCmCgPO7zCcFiVV9f8yW-EULvqDcFOhQap8,127
 plain/admin/middleware.py,sha256=k3yP1o3CzvLiZZSoxqq-DvAZlp4sICRauaT-kD3FJKM,398
@@ -8,7 +8,7 @@ plain/admin/templates.py,sha256=jLhJkuvqnPMBQTP-kzojFaqmFi50GZHvrVzuZCLc3rk,836
 plain/admin/toolbar.py,sha256=dsZa_I-tTbaeOluCbvHGEqy4_Suw6Q_JSrKl8Eu08qY,973
 plain/admin/urls.py,sha256=HtYsTDyV6s-k6ClT2H2oZqUDIANLq-PACpZfrR538js,1292
 plain/admin/assets/admin/admin.css,sha256=-KdI7geASBsSbTve26VeJ-wCrdHWyD3EdjDZ9o393Yc,2653
-plain/admin/assets/admin/admin.js,sha256=AWD6UqPxGqJFaUhYTDWe4niTgk0thzU4gRl7qK41KNc,2759
+plain/admin/assets/admin/admin.js,sha256=8R4VestYByRd2THe5gg8I35Zu3rokm6TQTkEf2mEB1c,2919
 plain/admin/assets/admin/chart.js,sha256=GZiCYXjL6SmyuSCGE0Df80QvOUkw6H2YD-zsVID05lo,205089
 plain/admin/assets/admin/jquery-3.6.1.slim.min.js,sha256=W2eb4M1jdKpuZ_-_KnDgqI9X9SwGLrXtO0dknpNPJyE,72534
 plain/admin/assets/admin/list.js,sha256=_DPneRvk3VSzjVzfEaxyif4vLD75sCWz7bkHYp89uL8,1826
@@ -71,12 +71,12 @@ plain/admin/templates/querystats/toolbar.html,sha256=dePs614akVWUD8IlgzvQ0TREThv
 plain/admin/templates/toolbar/toolbar.html,sha256=KcGAG6kRmx60wfqEsdD5C4nDMilH-JvPjHoU6EktfaY,5985
 plain/admin/views/__init__.py,sha256=nF6AENZ3Xxyi08OTRrF6e-HYBkZSFj7XBK2mVzMYqN4,846
 plain/admin/views/base.py,sha256=S1oaMUXnMOwRozbn2K-tk9tL4BMimemfMagZD9QxrJw,3512
-plain/admin/views/models.py,sha256=gos3KBPvOovULG8xZYKOO4ENrQlUIGrlIkRPO99wkDw,7196
-plain/admin/views/objects.py,sha256=Wcw7_k4BDz4h49e4BGtq6g-3jo5-T0fJU9CfMcvMQK4,11319
+plain/admin/views/models.py,sha256=mq_c13bdTs7WQ_MShVvTo3uCy09FOlBCrGIrGeK0sEo,5946
+plain/admin/views/objects.py,sha256=7BXrDpHbdZ0vpzTHoLbSNdXO-rYSRw5YOBTiTK12E1U,11140
 plain/admin/views/registry.py,sha256=Lxib4YSQCMHb_zACnLKymJakV8jCZPWYll7J8-aV9Xw,3712
 plain/admin/views/types.py,sha256=ONMMdUoapgMoUVYgSIe-4YCdfvaVMQ4jgPWYiMo0pDk,178
 plain/admin/views/viewsets.py,sha256=dqMlQ6kLn9iqd9BwBWAZT1S271wH1FdfM5HXbOgBMEw,1655
-plain_admin-0.22.1.dist-info/METADATA,sha256=OAsH8LlM_w0hE43s9cssSh4MoJvoUGPHU8GK-izJDjU,6827
-plain_admin-0.22.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-plain_admin-0.22.1.dist-info/licenses/LICENSE,sha256=cvKM3OlqHx3ijD6e34zsSUkPvzl-ya3Dd63A6EHL94U,1500
-plain_admin-0.22.1.dist-info/RECORD,,
+plain_admin-0.25.1.dist-info/METADATA,sha256=rCe1mK18fufoT3Xr5JSFSNe98TS5O75JYmxtBFZ3oqM,4237
+plain_admin-0.25.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+plain_admin-0.25.1.dist-info/licenses/LICENSE,sha256=cvKM3OlqHx3ijD6e34zsSUkPvzl-ya3Dd63A6EHL94U,1500
+plain_admin-0.25.1.dist-info/RECORD,,

plain_admin-0.22.1.dist-info/METADATA

@@ -1,276 +0,0 @@
-Metadata-Version: 2.4
-Name: plain.admin
-Version: 0.22.1
-Summary: Admin dashboard and tools for Plain.
-Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
-License-Expression: BSD-3-Clause
-License-File: LICENSE
-Requires-Python: >=3.11
-Requires-Dist: plain-auth<1.0.0
-Requires-Dist: plain-htmx<1.0.0
-Requires-Dist: plain-tailwind<1.0.0
-Requires-Dist: plain<1.0.0
-Requires-Dist: sqlparse>=0.2.2
-Description-Content-Type: text/markdown
-
-# Admin
-
-An admin interface for admin users.
-
-The Plain Admin is a new package built from the ground up.
-It leverages class-based views and standard URLs and templates to provide a flexible admin where
-you can quickly create your own pages and cards,
-in addition to models.
-
-- cards
-- dashboards
-- diy forms
-- detached from login (do your own login (oauth, passkeys, etc))
-
-## Installation
-
-- install plain.admin and plain.htmx, add plain.admin.admin and plain.htmx to installed packages
-- add url
-
-## Models in the admin
-
-## Dashboards
-
-<!-- # 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.impersonate
-
-See what your users see.
-
-A key feature for providing customer support is to be able to view the site through their account.
-With `impersonate` installed, you can impersonate a user by finding them in the Django admin and clicking the "Impersonate" button.
-
-![](/docs/img/impersonate-admin.png)
-
-Then with the [admin toolbar](/docs/plain-toolbar/) enabled, you'll get a notice of the impersonation and a button to exit:
-
-![](/docs/img/impersonate-bar.png)
-
-## Installation
-
-To impersonate users, you need the app, middleware, and URLs:
-
-```python
-# settings.py
-INSTALLED_PACKAGES = INSTALLED_PACKAGES + [
-  "plain.admin.impersonate",
-]
-
-MIDDLEWARE = MIDDLEWARE + [
-  "plain.admin.impersonate.ImpersonateMiddleware",
-]
-```
-
-```python
-# urls.py
-urlpatterns = [
-    # ...
-    path("impersonate/", include("plain.admin.impersonate.urls")),
-]
-```
-
-## Settings
-
-By default, all admin users can impersonate other users.
-
-````python
-# settings.py
-IMPERSONATE_ALLOWED = lambda user: user.is_admin
-``` -->
-````