polyadmin 0.1.0b2__tar.gz → 0.1.0b3__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: polyadmin
-Version: 0.1.0b2
+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
@@ -59,6 +59,7 @@ 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, directly within the parent workflow
@@ -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
@@ -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.0b2"
+pip install "polyadmin[fastapi]==0.1.0b3"
 ```
 
 For the latest unreleased code, install from Git:

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

@@ -29,6 +29,7 @@ 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, directly within the parent workflow
@@ -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
@@ -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.0b2"
+pip install "polyadmin[fastapi]==0.1.0b3"
 ```
 
 For the latest unreleased code, install from Git:

{polyadmin-0.1.0b2 → 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.0b2 → polyadmin-0.1.0b3}/examples/fastapi/models.py

@@ -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.0b2 → 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.0b2 → 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.0b2 → 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.0b2 → 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.0b2 → 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.0b2 → 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
@@ -87,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:
@@ -138,6 +139,10 @@ class URLField(Field):
     field_type = "url"
 
 
+class ImageField(Field):
+    field_type = "image"
+
+
 class UUIDField(Field):
     field_type = "uuid"
 
@@ -192,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.0b2 → 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.0b2 → polyadmin-0.1.0b3}/polyadmin/core/model_admin.py

@@ -49,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]] = ()