polyadmin 0.1.0b1__tar.gz → 0.1.0b3__tar.gz

{polyadmin-0.1.0b1 → polyadmin-0.1.0b3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: polyadmin
-Version: 0.1.0b1
+Version: 0.1.0b3
 Summary: PolyAdmin: cross-language server-rendered admin framework (Python core)
 Project-URL: Documentation, https://magicrodri.github.io/polyadmin-docs/
 Project-URL: Source, https://github.com/MagicRodri/polyadmin
@@ -35,9 +35,9 @@ Description-Content-Type: text/markdown
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
 [![GitHub Repo stars](https://img.shields.io/github/stars/MagicRodri/polyadmin?style=flat-square)](https://github.com/MagicRodri/polyadmin)
 
-A Django-admin-style, server-rendered admin framework for
-[FastAPI](https://fastapi.tiangolo.com). See [`docs/`](docs/) for
-reference documentation, or visit the [PolyAdmin documentation site](https://magicrodri.github.io/polyadmin-docs/)
+A server-rendered operations workspace for Python applications, with a
+FastAPI adapter. See [`docs/`](docs/) for reference documentation, or visit
+the [PolyAdmin documentation site](https://magicrodri.github.io/polyadmin-docs/)
 for the shared Python and Go guides.
 
 ## What you get from declaring a `ModelAdmin`
@@ -59,9 +59,10 @@ permissions) and you get:
 - Relation fields rendered as links, or as a searchable shadcn/ui
   Command-style autocomplete backed by a server-side `/lookup` route
   (never dumps the target model's full queryset into the page)
+- Image fields with upload handling and preview rendering
 - Inline related records (`StackedInline`/`TabularInline`) — a
   parent's create/detail/edit pages can show and manage a child's
-  records that point back at it, Django-admin style
+  records that point back at it, directly within the parent workflow
 - Record and bulk Actions, with a shadcn/ui Dialog confirmation step for
   destructive ones
 - Delete previews: the confirmation page says what else a delete takes
@@ -73,6 +74,7 @@ permissions) and you get:
 - CSV and XLSX export
 - Internationalisation: per-request locale, language switcher, French
   and Russian
+- Built-in favicon support for the admin shell
 - Toast notifications for every create/update/delete/action
 - Per-resource (and per-widget) template overrides, so an application
   can replace one view's markup without forking the framework
@@ -82,8 +84,8 @@ Alpine.js + Tailwind — its CSS-variable token system and component
 markup, without React or Radix. That gives the admin **dark mode and
 themability**: every color resolves through a CSS variable, so restyling
 the whole thing is a change to one template. The layout is mobile-first
-with a collapsible sidebar (a Sheet below `md`), a Django-admin-style
-right-hand filter panel on wider screens, and breadcrumbs as the page
+with a collapsible sidebar (a Sheet below `md`), a right-hand filter panel
+for focused workflows on wider screens, and breadcrumbs as the page
 title. Tailwind/Alpine/HTMX are all CDN-loaded — no frontend build step.
 See [`docs/components.md`](docs/components.md).
 
@@ -92,7 +94,7 @@ See [`docs/components.md`](docs/components.md).
 The first beta release is available on PyPI:
 
 ```bash
-pip install "polyadmin[fastapi]==0.1.0b1"
+pip install "polyadmin[fastapi]==0.1.0b3"
 ```
 
 For the latest unreleased code, install from Git:

{polyadmin-0.1.0b1 → polyadmin-0.1.0b3}/README.md

@@ -5,9 +5,9 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
 [![GitHub Repo stars](https://img.shields.io/github/stars/MagicRodri/polyadmin?style=flat-square)](https://github.com/MagicRodri/polyadmin)
 
-A Django-admin-style, server-rendered admin framework for
-[FastAPI](https://fastapi.tiangolo.com). See [`docs/`](docs/) for
-reference documentation, or visit the [PolyAdmin documentation site](https://magicrodri.github.io/polyadmin-docs/)
+A server-rendered operations workspace for Python applications, with a
+FastAPI adapter. See [`docs/`](docs/) for reference documentation, or visit
+the [PolyAdmin documentation site](https://magicrodri.github.io/polyadmin-docs/)
 for the shared Python and Go guides.
 
 ## What you get from declaring a `ModelAdmin`
@@ -29,9 +29,10 @@ permissions) and you get:
 - Relation fields rendered as links, or as a searchable shadcn/ui
   Command-style autocomplete backed by a server-side `/lookup` route
   (never dumps the target model's full queryset into the page)
+- Image fields with upload handling and preview rendering
 - Inline related records (`StackedInline`/`TabularInline`) — a
   parent's create/detail/edit pages can show and manage a child's
-  records that point back at it, Django-admin style
+  records that point back at it, directly within the parent workflow
 - Record and bulk Actions, with a shadcn/ui Dialog confirmation step for
   destructive ones
 - Delete previews: the confirmation page says what else a delete takes
@@ -43,6 +44,7 @@ permissions) and you get:
 - CSV and XLSX export
 - Internationalisation: per-request locale, language switcher, French
   and Russian
+- Built-in favicon support for the admin shell
 - Toast notifications for every create/update/delete/action
 - Per-resource (and per-widget) template overrides, so an application
   can replace one view's markup without forking the framework
@@ -52,8 +54,8 @@ Alpine.js + Tailwind — its CSS-variable token system and component
 markup, without React or Radix. That gives the admin **dark mode and
 themability**: every color resolves through a CSS variable, so restyling
 the whole thing is a change to one template. The layout is mobile-first
-with a collapsible sidebar (a Sheet below `md`), a Django-admin-style
-right-hand filter panel on wider screens, and breadcrumbs as the page
+with a collapsible sidebar (a Sheet below `md`), a right-hand filter panel
+for focused workflows on wider screens, and breadcrumbs as the page
 title. Tailwind/Alpine/HTMX are all CDN-loaded — no frontend build step.
 See [`docs/components.md`](docs/components.md).
 
@@ -62,7 +64,7 @@ See [`docs/components.md`](docs/components.md).
 The first beta release is available on PyPI:
 
 ```bash
-pip install "polyadmin[fastapi]==0.1.0b1"
+pip install "polyadmin[fastapi]==0.1.0b3"
 ```
 
 For the latest unreleased code, install from Git:

{polyadmin-0.1.0b1 → polyadmin-0.1.0b3}/docs/architecture.md

@@ -1,7 +1,7 @@
 # Architecture
 
-PolyAdmin is a Django-admin-style admin framework for
-[FastAPI](https://fastapi.tiangolo.com). It owns presentation —
+PolyAdmin is a server-rendered operations framework for Python applications.
+The current [FastAPI](https://fastapi.tiangolo.com) adapter owns presentation —
 routes, forms, tables, permissions checks, HTML — and owns no storage:
 your `ModelAdmin` implements the lifecycle hooks against whatever
 database or service you already have. This document explains how the

{polyadmin-0.1.0b1 → polyadmin-0.1.0b3}/docs/deletes.md

@@ -39,6 +39,10 @@ class DeletePreviewer(Protocol):
     def delete_preview(self, objects: list[Any]) -> DeletePreview: ...
 ```
 
+It may be a coroutine function — the same optional-async shape as
+`get_object`/`create`/`update`/`delete` — for a ModelAdmin backed by an
+async client that needs to look up the cascade over the network.
+
 `objects` is always a list — one record from the delete page, the whole
 selection from `delete_selected` — so one implementation serves both,
 and a bulk delete costs one query per relation rather than one per row:

{polyadmin-0.1.0b1 → polyadmin-0.1.0b3}/docs/python/index.md

@@ -1,6 +1,7 @@
-# Python / FastAPI
+# Python
 
-The Python implementation mounts PolyAdmin into a FastAPI application.
+The Python implementation provides the core admin experience for Python
+applications. The current web adapter mounts PolyAdmin into FastAPI.
 
 ## Install from Git
 

{polyadmin-0.1.0b1 → polyadmin-0.1.0b3}/examples/fastapi/models.py

@@ -55,9 +55,8 @@ class OrganizationRepository:
 class Role:
     """The many-to-many target: a user holds any number of these.
 
-    Modelled after the permissions list Django's admin is known for, and
-    what the searchable multi-select on the user form is there to make
-    bearable once the list is long.
+    A permissions-style list, long enough that the searchable multi-select
+    on the user form is there to make it bearable.
     """
 
     id: int
@@ -90,9 +89,10 @@ class User:
     email: str
     is_active: bool = True
     # A plain choice field, so the reference app exercises ui/select
-    # (the shadcn Select port). Every other choice-shaped field here is
-    # a relation, which renders one of the two combobox widgets
-    # instead -- without this, ui/select appeared nowhere in the app.
+    # (the reference design system's Select port). Every other
+    # choice-shaped field here is a relation, which renders one of the
+    # two combobox widgets instead -- without this, ui/select appeared
+    # nowhere in the app.
     plan: str = "Free"
     organization: Organization | None = None
     roles: list[Role] = field(default_factory=list)
@@ -163,9 +163,8 @@ def seed(
     organizations: OrganizationRepository,
     roles: RoleRepository,
 ) -> None:
-    # Founded in the same month for every organization: Task 15's browser
-    # test checks that this date renders with a French month name under
-    # the fr locale, and it doesn't matter which organization it looks at.
+    # A browser test checks that this date renders with a French month name
+    # under the fr locale, regardless of which organization it looks at.
     # Acme keeps March 2019: a browser test pins "Mar 1, 2019" as a data
     # value and checks the same date renders "mars" under fr. The others
     # spread out, so the date drill-down has years and months to walk.

{polyadmin-0.1.0b1 → polyadmin-0.1.0b3}/examples/fastapi/session.py

@@ -40,6 +40,7 @@ class DemoAccount:
     """One row of what would be a users table."""
 
     email: str
+    username: str
     # Salt and hash, never the password. Derived at import time only
     # because a runnable demo has to document its own credentials; a real
     # table stores these and has never seen the plaintext.
@@ -55,9 +56,9 @@ class DemoAccount:
 # whose preferred locale the host resolver -- not the switcher cookie or
 # Accept-Language -- decides.
 DEMO_CREDENTIALS = [
-    ("admin@example.com", "polyadmin", "Demo Admin", True, ""),
-    ("viewer@example.com", "polyadmin", "Demo Viewer", False, ""),
-    ("amelie@example.com", "polyadmin", "Amélie", True, "fr"),
+    ("admin@example.com", "admin", "polyadmin", "Demo Admin", True, ""),
+    ("viewer@example.com", "viewer", "polyadmin", "Demo Viewer", False, ""),
+    ("amelie@example.com", "amelie", "polyadmin", "Amélie", True, "fr"),
 ]
 
 
@@ -114,16 +115,21 @@ class CookieSessionBackend:
     def __init__(self) -> None:
         self._secret = _session_secret()
         self._accounts: dict[str, DemoAccount] = {}
-        for email, password, display_name, is_superuser, locale in DEMO_CREDENTIALS:
+        for email, username, password, display_name, is_superuser, locale in DEMO_CREDENTIALS:
             salt = secrets.token_bytes(16)
-            self._accounts[email] = DemoAccount(
+            account = DemoAccount(
                 email=email,
+                username=username,
                 salt=salt,
                 hash=_derive(password, salt),
                 display_name=display_name,
                 is_superuser=is_superuser,
                 locale=locale,
             )
+            # Indexed under both so the login page's "username or email"
+            # field resolves either one to the same account.
+            self._accounts[email] = account
+            self._accounts[username] = account
 
     def verify_credentials(self, request: Any, identifier: str, password: str) -> Principal | None:
         """Answers "are these good?" and does not touch the response. Establishing

{polyadmin-0.1.0b1 → polyadmin-0.1.0b3}/examples/fastapi/tests/test_app.py

@@ -130,7 +130,7 @@ def test_create_organization_persists_founded_and_balance():
     location = response.headers["location"]
     detail = client.get(location)
     assert detail.status_code == 200
-    # Rendered as the markup contract (Task 12): a <time datetime="...">
+    # Rendered as the markup contract: a <time datetime="...">
     # for the date and a data-value carrying the exact posted precision.
     # This exercises the real create() pipeline end to end -- Field.parse_
     # form_value (float for "decimal", raw string for "date"), the example

{polyadmin-0.1.0b1 → polyadmin-0.1.0b3}/examples/fastapi/user_admin.py

@@ -32,9 +32,8 @@ ROLES_RELATION = Relation(
 class PlanFilter(Filter):
     """A filter this application wrote itself: it subclasses the published
     base and implements the two methods, borrowing nothing from the
-    framework's own filter types. This is the hook Django calls a
-    SimpleListFilter -- the admin supplies both the options and the
-    constraint.
+    framework's own filter types. This hook lets the admin supply both
+    the options and the constraint itself.
 
     It exists in the example so the extension point is exercised by the
     browser suite rather than only described in docs/lists.md.
@@ -62,8 +61,7 @@ class UserAdmin(ModelAdmin):
     list_display = ["id", "email", "is_active", "plan", "organization"]
     detail_fields = ["id", "email", "is_active", "plan", "organization", "roles"]
     # roles is on the form but not in list_display: a many-to-many
-    # column costs a lookup per row and reads as noise in a table, which
-    # is why Django keeps it off list_display too.
+    # column costs a lookup per row and reads as noise in a table.
     # Grouped rather than flat, to exercise fieldsets -- the other
     # admins in this app stay flat, so both paths have example coverage.
     # Declaring these replaces form_fields: the groups are the form's

{polyadmin-0.1.0b1 → polyadmin-0.1.0b3}/examples/fastapi/uv.lock

@@ -339,7 +339,7 @@ wheels = [
 
 [[package]]
 name = "polyadmin"
-version = "0.1.0"
+version = "0.1.0b2"
 source = { editable = "../../" }
 dependencies = [
     { name = "jinja2" },

{polyadmin-0.1.0b1 → polyadmin-0.1.0b3}/polyadmin/__init__.py

@@ -13,6 +13,7 @@ from polyadmin.core.field import (
     EmailField,
     EnumField,
     Field,
+    ImageField,
     IntegerField,
     JSONField,
     PasswordField,
@@ -36,6 +37,7 @@ __all__ = [
     "EmailField",
     "EnumField",
     "Field",
+    "ImageField",
     "IntegerField",
     "JSONField",
     "ModelAdmin",

{polyadmin-0.1.0b1 → polyadmin-0.1.0b3}/polyadmin/core/admin.py

@@ -28,6 +28,7 @@ class Admin:
         authorizer: Any | None = None,
         site_title: str = "PolyAdmin",
         site_logo_url: str | None = None,
+        site_favicon_url: str | None = None,
         disable_csrf: bool = False,
         audit_logger: Any | None = None,
         login_backend: Any | None = None,
@@ -45,6 +46,7 @@ class Admin:
         self.authorizer = authorizer
         self.site_title = site_title
         self.site_logo_url = site_logo_url
+        self.site_favicon_url = site_favicon_url
         # Opt-out, never opt-in: a security control that defaults to off
         # is one nobody turns on. The token cookie is still minted when
         # this is set, so templates and custom pages behave identically.

{polyadmin-0.1.0b1 → polyadmin-0.1.0b3}/polyadmin/core/delete.py

@@ -6,10 +6,11 @@ that makes a host's answer safe to show one principal.
 from __future__ import annotations
 
 import hashlib
-from collections.abc import Sequence
+from collections.abc import Awaitable, Sequence
 from dataclasses import dataclass, field
 from typing import Any, Protocol
 
+from polyadmin.core._async import maybe_await
 from polyadmin.core.authorization import resource_permission
 
 # How many records of a group are listed; the rest are counted.
@@ -46,9 +47,12 @@ class DeletePreviewer(Protocol):
     `objects` is always a list -- one record from the delete page, the whole
     selection from delete_selected -- so an implementation over SQL can
     answer a bulk delete with one count and one sample query per relation.
+
+    May be a coroutine function; resolve_delete_preview awaits it when it is
+    one, the same optional-async shape as get_object/create/update/delete.
     """
 
-    def delete_preview(self, objects: list[Any]) -> DeletePreview: ...
+    def delete_preview(self, objects: list[Any]) -> DeletePreview | Awaitable[DeletePreview]: ...
 
 
 @dataclass
@@ -74,14 +78,14 @@ def previews_deletes(model_admin: Any) -> bool:
     return callable(getattr(model_admin, "delete_preview", None))
 
 
-def resolve_delete_preview(admin: Any, model_admin: Any, principal: Any, objects: Sequence[Any]) -> ResolvedDeletePreview:
+async def resolve_delete_preview(admin: Any, model_admin: Any, principal: Any, objects: Sequence[Any]) -> ResolvedDeletePreview:
     """Ask model_admin what deleting objects takes with it and filter the answer
     for principal. Without the capability: an empty, non-blocking result, and
     nothing is called.
     """
     if not previews_deletes(model_admin):
         return ResolvedDeletePreview()
-    preview = model_admin.delete_preview(list(objects))
+    preview = await maybe_await(model_admin.delete_preview(list(objects)))
     out = ResolvedDeletePreview()
     for group in preview.cascades:
         resolved = _resolve_group(admin, principal, group)

{polyadmin-0.1.0b1 → polyadmin-0.1.0b3}/polyadmin/core/field.py

@@ -1,9 +1,8 @@
 """Field abstraction.
 
 A Field represents a model property plus its admin presentation, not
-merely an HTML input. Context-aware rendering (list/detail/form/filter)
-is added in Phase 2; this module defines the data-level contract that
-rendering will build on.
+merely an HTML input. This module defines the data-level contract that
+context-aware rendering (list/detail/form/filter) builds on.
 """
 
 from __future__ import annotations
@@ -20,8 +19,6 @@ _UNSET = object()
 
 
 class Field:
-    """Base class for all admin field types."""
-
     field_type: str = "field"
 
     def __init__(
@@ -52,7 +49,6 @@ class Field:
         return self.default is not _UNSET
 
     def get_value(self, obj: Any) -> Any:
-        """Read this field's value off a model instance."""
         value = getattr(obj, self.name, _UNSET)
         if value is _UNSET:
             return self.default if self.has_default else None
@@ -90,7 +86,9 @@ class Field:
         """Run configured validators, returning a list of error messages."""
         errors: list[str] = []
         if self.required and (value is None or value == ""):
-            errors.append(gettext("%(label)s is required.") % {"label": gettext(self.label)})
+            errors.append(
+                gettext("%(label)s is required.") % {"label": gettext(self.label)}
+            )
             return errors
         for validator in self.validators:
             try:
@@ -141,6 +139,10 @@ class URLField(Field):
     field_type = "url"
 
 
+class ImageField(Field):
+    field_type = "image"
+
+
 class UUIDField(Field):
     field_type = "uuid"
 
@@ -188,8 +190,6 @@ class OneToOneField(ForeignKeyField):
 
 
 class ManyToManyField(Field):
-    """A collection of related objects."""
-
     field_type = "manytomany"
 
     def __init__(self, name: str, *, relation: Relation, **kwargs: Any) -> None:
@@ -197,5 +197,9 @@ class ManyToManyField(Field):
         self.relation = relation
 
     def get_value(self, obj: Any) -> Any:
-        value = self.relation.get_related(obj) if self.relation.get_related is not None else super().get_value(obj)
+        value = (
+            self.relation.get_related(obj)
+            if self.relation.get_related is not None
+            else super().get_value(obj)
+        )
         return value if value is not None else []

{polyadmin-0.1.0b1 → polyadmin-0.1.0b3}/polyadmin/core/filter.py

@@ -299,7 +299,6 @@ class RelationFilter(Filter):
             if not many:
                 if self._pk(related) == raw_value:
                     kept.append(obj)
-            # A `many` relation matches when any member does.
             elif any(self._pk(member) == raw_value for member in related):
                 kept.append(obj)
         return kept

{polyadmin-0.1.0b1 → polyadmin-0.1.0b3}/polyadmin/core/inline.py

@@ -1,12 +1,11 @@
 """Inline: a reverse-relation admin declaration -- lets a parent
 ModelAdmin manage/display a child ModelAdmin's records that point back
-at it via one FK/OneToOne field, Django-admin TabularInline/StackedInline
-style. See docs/inlines.md.
+at it via one FK/OneToOne field. See docs/inlines.md.
 
 `layout` is presentation-only, not behavioral, so there is one Inline
 type with a layout discriminator, not two structurally different
 classes -- StackedInline/TabularInline are just layout-preset
-subclasses, for a Django-familiar spelling.
+subclasses.
 """
 
 from __future__ import annotations
@@ -17,10 +16,6 @@ from polyadmin.core._async import maybe_await
 from polyadmin.core.query import ListRequest, alist_objects
 
 if TYPE_CHECKING:
-    # Only needed for type hints -- inline.py must not import
-    # model_admin.py at runtime, since model_admin.py imports Inline
-    # (a real ClassVar default, not just a hint) from here. Guarding
-    # only this side is enough to avoid a circular import.
     from polyadmin.core.model_admin import ModelAdmin
 
 STACKED = "stacked"

{polyadmin-0.1.0b1 → polyadmin-0.1.0b3}/polyadmin/core/model_admin.py

@@ -11,6 +11,7 @@ from collections.abc import Sequence
 from dataclasses import dataclass
 from typing import Any, ClassVar
 
+from polyadmin.core._async import maybe_await
 from polyadmin.core.action import DELETE_SELECTED_NAME, Action, action, collect_actions
 from polyadmin.core.auth import Principal
 from polyadmin.core.field import Field
@@ -21,10 +22,10 @@ from polyadmin.i18n import N_, gettext, ngettext
 
 @dataclass
 class Fieldset:
-    """One titled group of form fields -- Django's `fieldsets`. A title of None
-    renders the group with no header, which is how the undeclared default
-    renders as a plain flat form. `collapsed` only seeds the initial state; the
-    group can always be opened.
+    """One titled group of form fields. A title of None renders the group
+    with no header, which is how the undeclared default renders as a plain
+    flat form. `collapsed` only seeds the initial state; the group can
+    always be opened.
     """
 
     fields: Sequence[str] = ()
@@ -48,6 +49,9 @@ class ModelAdmin:
     # Sidebar icon name (see components/icons.html), shown flat or nested
     # inside a category's accordion alike.
     icon: ClassVar[str] = "collection"
+    # Browser-tab icon shown while viewing this ModelAdmin's pages. ""
+    # falls back to Admin.site_favicon_url.
+    favicon_url: ClassVar[str] = ""
 
     list_display: ClassVar[Sequence[str]] = ()
     form_fields: ClassVar[Sequence[str]] = ()
@@ -65,7 +69,6 @@ class ModelAdmin:
     # stable between requests.
     ordering: ClassVar[str | None] = None
     # How many rows a list page holds; None means DEFAULT_PAGE_SIZE.
-    # Django's list_per_page.
     list_per_page: ClassVar[int | None] = None
     # What a read-only view shows for a None or blank value; None means
     # DEFAULT_EMPTY_VALUE.
@@ -78,8 +81,7 @@ class ModelAdmin:
     # action whose `where` includes the detail page; a list overrides `where`
     # (so a "list" action can be named here), and [] offers none.
     detail_actions: ClassVar[Sequence[str] | None] = None
-    # Removes the built-in bulk delete. Opt-out, so the default keeps it,
-    # as Django does.
+    # Removes the built-in bulk delete. Opt-out, so the default keeps it.
     disable_delete_selected: ClassVar[bool] = False
     # Child ModelAdmins whose records point back at this one, managed
     # inline on its create/detail/edit pages. See docs/inlines.md.
@@ -108,7 +110,7 @@ class ModelAdmin:
     # transliterated to ASCII -- see polyadmin.core.slug.
     prepopulated_unicode: ClassVar[Sequence[str]] = ()
     # Adds "Save as new" to the edit form, which saves the submitted values
-    # as a new record and leaves the original alone. Opt-in, as Django's is.
+    # as a new record and leaves the original alone. Opt-in.
     save_as: ClassVar[bool] = False
     # Whether the list hands its search, filters, sort and page to the pages
     # reached from it, so they lead back into the list as it was left.
@@ -209,11 +211,9 @@ class ModelAdmin:
         return self.empty_value_display or DEFAULT_EMPTY_VALUE
 
     def get_default_ordering(self) -> str | None:
-        """The sort to use when the request names none."""
         return self.ordering
 
     def is_readonly(self, name: str, obj: Any = None) -> bool:
-        """The question every call site actually asks."""
         return name in self.get_readonly_fields(obj)
 
     def get_fieldsets(self) -> list[Fieldset]:
@@ -275,14 +275,14 @@ class ModelAdmin:
         permission="delete",
         where="list",
     )
-    def delete_selected(self, objects: Sequence[Any], principal: Principal | None) -> str | None:
+    async def delete_selected(self, objects: Sequence[Any], principal: Principal | None) -> str | None:
         """The bulk delete every admin gets for free.
 
-        Django ships the same one, and it is the single most common action
-        anyone would otherwise write by hand. It is expressed entirely in terms
-        of this ModelAdmin's own `delete` hook, so it works against whatever
-        storage the application has and honours whatever that hook already
-        does (cascades, soft deletes, hooks of its own).
+        This is the single most common action anyone would otherwise write
+        by hand. It is expressed entirely in terms of this ModelAdmin's own
+        `delete` hook, so it works against whatever storage the application
+        has and honours whatever that hook already does (cascades, soft
+        deletes, hooks of its own).
 
         permission="delete", not the resource's bare "view": the action route
         checks it on top, so a principal who may look at a list but not destroy
@@ -292,7 +292,7 @@ class ModelAdmin:
         deleted = 0
         for obj in objects:
             try:
-                self.delete(obj)
+                await maybe_await(self.delete(obj))
             except Exception as exc:
                 # Stop at the first failure and report how far it got:
                 # silently continuing would leave the user unable to
@@ -336,7 +336,6 @@ class ModelAdmin:
         raise NotImplementedError(f"{type(self).__name__} must implement update().")
 
     def delete(self, obj: Any) -> None:
-        """Delete an existing record."""
         raise NotImplementedError(f"{type(self).__name__} must implement delete().")
 
     def validate(self, data: dict[str, Any]) -> dict[str, list[str]]:

{polyadmin-0.1.0b1 → polyadmin-0.1.0b3}/polyadmin/core/query.py

@@ -90,8 +90,8 @@ def is_sortable(model_admin: Any, name: str) -> bool:
 
 def links_to_record(model_admin: Any, name: str) -> bool:
     """Whether a list cell links to the record. An unset list_display_links
-    links the first column, as Django does; an empty one links nothing and
-    leaves the row menu as the way in."""
+    links the first column; an empty one links nothing and leaves the
+    row menu as the way in."""
     linked = model_admin.list_display_links
     if linked is None:
         display = list(model_admin.list_display)