polyadmin 0.1.0b1__tar.gz → 0.1.0b2__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: polyadmin
-Version: 0.1.0b1
+Version: 0.1.0b2
 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`
@@ -61,7 +61,7 @@ permissions) and you get:
   (never dumps the target model's full queryset into the page)
 - 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
@@ -82,8 +82,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 +92,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.0b2"
 ```
 
 For the latest unreleased code, install from Git:

{polyadmin-0.1.0b1 → polyadmin-0.1.0b2}/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`
@@ -31,7 +31,7 @@ permissions) and you get:
   (never dumps the target model's full queryset into the page)
 - 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
@@ -52,8 +52,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 +62,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.0b2"
 ```
 
 For the latest unreleased code, install from Git:

{polyadmin-0.1.0b1 → polyadmin-0.1.0b2}/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.0b2}/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.0b2}/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)

{polyadmin-0.1.0b1 → polyadmin-0.1.0b2}/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.0b2}/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.0b2}/polyadmin/core/field.py

@@ -20,8 +20,6 @@ _UNSET = object()
 
 
 class Field:
-    """Base class for all admin field types."""
-
     field_type: str = "field"
 
     def __init__(
@@ -52,7 +50,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
@@ -188,8 +185,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:

{polyadmin-0.1.0b1 → polyadmin-0.1.0b2}/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.0b2}/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] = ()
@@ -65,7 +66,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 +78,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 +107,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 +208,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 +272,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 +289,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 +333,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.0b2}/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)

{polyadmin-0.1.0b1 → polyadmin-0.1.0b2}/polyadmin/fastapi/csrf.py

@@ -28,8 +28,6 @@ from polyadmin.fastapi.errors import csrf_failure
 
 
 def make_csrf_route(admin, base_path: str) -> type[APIRoute]:
-    """Build the APIRoute subclass for one mounted admin."""
-
     class CSRFRoute(APIRoute):
         def get_route_handler(self) -> Callable:
             original = super().get_route_handler()

{polyadmin-0.1.0b1 → polyadmin-0.1.0b2}/polyadmin/templating.py

@@ -97,9 +97,9 @@ def decimal_display(value: Any) -> str:
     is what Field.parse_form_value hands back for the "decimal" field
     type -- see core/field.py), so it is shown with the shortest digit
     string that round-trips back to the same float, in fixed-point, with
-    no trailing ".0" -- the same contract as Go's decimalText
-    (fiber/render_helpers.go), which uses strconv.FormatFloat(f, 'f', -1,
-    64). Anything else (an int) falls back to plain str().
+    no trailing ".0" -- the same contract as Go's decimalText, which uses
+    strconv.FormatFloat(f, 'f', -1, 64). Anything else (an int) falls back
+    to plain str().
     """
     if isinstance(value, Decimal):
         return format(value, "f")

{polyadmin-0.1.0b1 → polyadmin-0.1.0b2}/polyadmin/ui.py

@@ -1,11 +1,11 @@
-"""shadcn/ui's variant lookups, resolved server-side.
+"""The reference design system's variant lookups, resolved server-side.
 
-`UI_REGISTRY` resolves shadcn's class-variance-authority (cva) lookups
-while the Jinja template renders, via the `ui` global::
+`UI_REGISTRY` resolves the reference design system's class-variance-authority
+(cva) lookups while the Jinja template renders, via the `ui` global::
 
     {{ ui("button", "outline", "size-sm") }}
 
-Each entry splits its class lists the way shadcn does:
+Each entry splits its class lists the way the reference design system does:
 ``base``/``variants``/``sizes`` are cva axes and compose;  ``parts`` are
 sub-components (CardTitle, TableHead) and *replace* the base.
 
@@ -17,8 +17,9 @@ which throws on a value containing a space.
 
 Colors are the CSS variables from ``admin/theme.html`` rather than a
 literal palette, which is what makes the admin themeable. Sizes are
-prefixed ``size-`` because shadcn has both a variant and a size named
-"default"; the prefix also tells the resolver which axis was given.
+prefixed ``size-`` because the reference design system has both a variant
+and a size named "default"; the prefix also tells the resolver which axis
+was given.
 """
 from __future__ import annotations
 
@@ -32,14 +33,16 @@ UI_REGISTRY: dict[str, dict[str, object]] = {
         # note on why a base must not fight its own axes.
         "base": "inline-flex items-center justify-center gap-1.5 whitespace-nowrap rounded-md text-sm font-medium tracking-wide transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background disabled:pointer-events-none disabled:opacity-50",
         "variants": {
-            # shadcn's six stock button variants, verbatim in intent.
+            # The reference design system's six stock button variants,
+            # verbatim in intent.
             "default": "bg-primary text-primary-foreground hover:bg-primary/90",
             "destructive": "bg-destructive text-destructive-foreground hover:bg-destructive/90",
             "outline": "border border-input bg-background text-foreground hover:bg-accent hover:text-accent-foreground",
             "secondary": "bg-secondary text-secondary-foreground hover:bg-secondary/80",
             "ghost": "text-foreground hover:bg-accent hover:text-accent-foreground",
             "link": "text-primary underline-offset-4 hover:underline",
-            # shadcn ships no destructive counterpart to `outline`. A
+            # The reference design system ships no destructive
+            # counterpart to `outline`. A
             # detail page's Delete must match the weight of the outline
             # Edit beside it (solid `destructive` is reserved for the
             # confirmation page's submit), and a row's icon-only Delete
@@ -81,10 +84,11 @@ UI_REGISTRY: dict[str, dict[str, object]] = {
         "sizes": {"size-default": "min-h-[80px] px-3 py-2"},
     },
 
-    # A native <select>, not shadcn's Radix-backed SelectTrigger: a
-    # custom listbox does not post its value with a plain form submit,
-    # and the admin's forms have to keep working without JS. Styled to
-    # match the shadcn trigger (same height, border, ring).
+    # A native <select>, not the reference design system's Radix-backed
+    # SelectTrigger: a custom listbox does not post its value with a
+    # plain form submit, and the admin's forms have to keep working
+    # without JS. Styled to match the reference trigger (same height,
+    # border, ring).
     "select": {
         "base": "flex w-full items-center rounded-md border border-input bg-background text-sm text-foreground ring-offset-background focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50",
         "sizes": {
@@ -154,11 +158,11 @@ UI_REGISTRY: dict[str, dict[str, object]] = {
         },
     },
 
-    # shadcn's login-04 block. Its social buttons, "Sign up" and "Forgot
-    # your password?" are deliberately absent: the framework has no route
-    # behind any of them. login-04 fills the right column with a
-    # photograph, which a framework cannot ship, so "aside" styles a
-    # typographic panel instead.
+    # The reference login block. Its social buttons, "Sign up" and
+    # "Forgot your password?" are deliberately absent: the framework has
+    # no route behind any of them. That block fills the right column
+    # with a photograph, which a framework cannot ship, so "aside"
+    # styles a typographic panel instead.
     "login": {
         "parts": {
             "page": "flex min-h-svh flex-col items-center justify-center bg-muted p-6 md:p-10",
@@ -289,8 +293,9 @@ UI_REGISTRY: dict[str, dict[str, object]] = {
         },
     },
 
-    # Sonner, the toaster shadcn/ui ships. Its geometry is kept as it
-    # ships: a 356px column in the viewport's corner, 14px between toasts,
+    # Sonner, the toaster the reference design system ships. Its
+    # geometry is kept as it ships: a 356px column in the viewport's
+    # corner, 14px between toasts,
     # 16px of padding, 13px text, and a close button parked half outside
     # the top-left corner. What is dropped is Sonner's collapsed
     # peek-stack, which is choreography for an app raising toasts
@@ -344,7 +349,7 @@ UI_REGISTRY: dict[str, dict[str, object]] = {
     },
 
 
-    # shadcn's sidebar-07 block, at its exact widths (16rem open, 3rem
+    # The reference sidebar block, at its exact widths (16rem open, 3rem
     # collapsed, 18rem mobile sheet). Its --sidebar-* colour scale is
     # deliberately not reproduced: the Zinc values are within a hair of
     # card/accent/border, and restyling the admin must mean editing
@@ -438,8 +443,8 @@ UI_REGISTRY: dict[str, dict[str, object]] = {
         },
     },
 
-    # Toolbar + footer of the list table, from shadcn's Tasks example:
-    # search and filters left, page actions right; below, the
+    # Toolbar + footer of the list table, from the reference data-table
+    # example: search and filters left, page actions right; below, the
     # DataTablePagination row.
     #
     # Stacked until lg, a row from lg up. lg, not sm, because the sidebar
@@ -507,9 +512,10 @@ UI_REGISTRY: dict[str, dict[str, object]] = {
             "selection": "flex-1 text-sm text-muted-foreground",
             "controls": "flex items-center gap-4 lg:gap-8",
             "rows-per-page": "flex items-center gap-2 text-sm font-medium",
-            # shadcn fixes this at w-[100px]; a translated "Page 1 of 8"
-            # is wider than that in most languages, so the width is a
-            # floor and the label never wraps to a second line.
+            # The reference implementation fixes this at w-[100px]; a
+            # translated "Page 1 of 8" is wider than that in most
+            # languages, so the width is a floor and the label never
+            # wraps to a second line.
             "page-indicator": (
                 "flex min-w-[100px] items-center justify-center whitespace-nowrap "
                 "text-sm font-medium"
@@ -535,10 +541,10 @@ UI_REGISTRY: dict[str, dict[str, object]] = {
             "head": "[&_tr]:border-b [&_tr]:border-border",
             "th": "px-4 py-2.5 text-left align-middle font-medium whitespace-nowrap text-muted-foreground",
             "body": "divide-y divide-border",
-            # data-[state=selected], from shadcn/ui's own TableRow: a
-            # checked row-checkbox (list_content.html) tints the whole
-            # row, the same as a hover, so a selection reads at a glance
-            # instead of only through the toolbar's "N of M selected"
+            # data-[state=selected], from the reference design system's
+            # own TableRow: a checked row-checkbox (list_content.html)
+            # tints the whole row, the same as a hover, so a selection
+            # reads at a glance instead of only through the toolbar's "N of M selected"
             # count.
             "row": "text-foreground transition-colors hover:bg-muted/50 has-[.row-checkbox:checked]:bg-muted",
             "cell": "px-4 py-2.5 align-middle text-sm whitespace-nowrap",
@@ -551,8 +557,8 @@ UI_REGISTRY: dict[str, dict[str, object]] = {
     },
 
 
-    # The label + control + description + error unit. shadcn calls this
-    # FormItem/FormLabel/FormDescription/FormMessage; here it is what
+    # The label + control + description + error unit. The reference
+    # design system calls this FormItem/FormLabel/FormDescription/FormMessage; here it is what
     # wraps every generated form input.
     "field": {
         "base": "mb-4",
@@ -595,10 +601,10 @@ UI_REGISTRY: dict[str, dict[str, object]] = {
         },
     },
 
-    # The many-to-many control: shadcn's Combobox/Command idiom over the
-    # relation's options, selection shown as removable chips. Django's
-    # filter_horizontal without the two-pane layout, which needs width
-    # this form column doesn't have.
+    # The many-to-many control: the reference design system's
+    # Combobox/Command idiom over the relation's options, selection
+    # shown as removable chips. Not a two-pane layout, which would need
+    # width this form column doesn't have.
     "multi-select": {
         "parts": {
             # min-h matches the single Select's h-10 so a field with
@@ -667,8 +673,8 @@ UI_REGISTRY: dict[str, dict[str, object]] = {
         },
     },
 
-    # Form fieldset (Django's `fieldsets`): a titled, collapsible group
-    # of fields inside the record form. A group with no title renders
+    # Form fieldset: a titled, collapsible group of fields inside the
+    # record form. A group with no title renders
     # bare -- no header, no border -- so the default single-group case
     # looks exactly like the flat form it replaces.
     "fieldset": {

{polyadmin-0.1.0b1 → polyadmin-0.1.0b2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "polyadmin"
-version = "0.1.0b1"
+version = "0.1.0b2"
 description = "PolyAdmin: cross-language server-rendered admin framework (Python core)"
 readme = "README.md"
 license = { text = "MIT" }

{polyadmin-0.1.0b1 → polyadmin-0.1.0b2}/tests/core/test_action_decorator.py

@@ -1,5 +1,6 @@
 """@action: declaring actions as ModelAdmin methods."""
 
+import asyncio
 from collections.abc import Sequence
 
 import pytest
@@ -168,6 +169,6 @@ def test_overriding_delete_selected_replaces_the_deletion_and_keeps_the_rest():
 def test_delete_selected_deletes_through_the_delete_hook():
     model_admin = InMemoryUserAdmin()
     user = model_admin.create({"email": "a@example.com"})
-    message = model_admin.delete_selected([user], None)
+    message = asyncio.run(model_admin.delete_selected([user], None))
     assert model_admin.get_object(user.id) is None
     assert "1" in message

{polyadmin-0.1.0b1 → polyadmin-0.1.0b2}/tests/core/test_delete_selected_i18n.py

@@ -1,5 +1,7 @@
 """delete_selected's failure message reads in the request's language."""
 
+import asyncio
+
 import pytest
 
 from polyadmin.i18n import GettextTranslator, use_locale
@@ -19,6 +21,6 @@ def test_failure_message_is_translated(locale, expected):
     model_admin = FailingUserAdmin()
     user = model_admin.create({"email": "a@example.com"})
     with use_locale(locale, GettextTranslator()), pytest.raises(RuntimeError) as caught:
-        model_admin.delete_selected([user], None)
+        asyncio.run(model_admin.delete_selected([user], None))
     assert expected in str(caught.value)
     assert "disk full" in str(caught.value)

{polyadmin-0.1.0b1 → polyadmin-0.1.0b2}/tests/core/test_parity.py

@@ -45,9 +45,6 @@ def titles(objects):
     return [o.title for o in objects]
 
 
-# --- slugify ---------------------------------------------------------
-
-
 @pytest.mark.parametrize(
     ("value", "want"),
     [
@@ -77,9 +74,6 @@ def test_slugify_unicode_keeps_its_letters(value, want):
     assert slugify_unicode(value) == want
 
 
-# --- the date filter -------------------------------------------------
-
-
 class DatedPostAdmin(PostAdmin):
     filters = [DateFilter("created")]
 
@@ -129,9 +123,6 @@ def test_date_filter_is_declared_like_any_other():
     assert [f.name for f in admin.filters] == ["created"]
 
 
-# --- sortable_by -----------------------------------------------------
-
-
 def test_unset_sortable_by_leaves_every_column_sortable():
     admin = PostAdmin()
     assert all(is_sortable(admin, name) for name in ("id", "title", "created"))
@@ -169,9 +160,6 @@ def test_the_model_admins_own_default_ordering_is_exempt_from_the_restriction():
     assert apply_defaults(Restricted(), ListRequest()).ordering == "-created"
 
 
-# --- list_display_links ----------------------------------------------
-
-
 def test_unset_list_display_links_links_the_first_column_only():
     admin = PostAdmin()
     assert links_to_record(admin, "id") and not links_to_record(admin, "title")
@@ -189,9 +177,6 @@ def test_list_display_links_chooses_and_empty_means_no_links():
     assert not any(links_to_record(Unlinked(), name) for name in ("id", "title", "created"))
 
 
-# --- the other options' defaults -------------------------------------
-
-
 def test_preserve_filters_is_on_and_save_as_is_off_by_default():
     admin = PostAdmin()
     assert admin.preserve_filters is True

{polyadmin-0.1.0b1 → polyadmin-0.1.0b2}/tests/fastapi/test_async_model_admin.py

@@ -75,6 +75,19 @@ def test_delete_post_awaits_async_get_object_and_async_delete():
     assert asyncio.run(user_admin.get_object(user.id)) is None
 
 
+def test_delete_selected_awaits_async_delete():
+    client, user_admin = async_client()
+    user = asyncio.run(user_admin.create({"email": "gone@example.com"}))
+    response = client.post(
+        "/admin/users/actions/delete_selected",
+        data={"pks": [str(user.id)]},
+        headers=csrf(client),
+        follow_redirects=False,
+    )
+    assert response.status_code in (302, 303)
+    assert asyncio.run(user_admin.get_object(user.id)) is None
+
+
 class AsyncListPageUserAdmin(InMemoryUserAdmin):
     async def list_page(self, list_request):
         await asyncio.sleep(0)