django-admin-react 1.4.13__tar.gz → 1.5.0__tar.gz

{django_admin_react-1.4.13 → django_admin_react-1.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-admin-react
-Version: 1.4.13
+Version: 1.5.0
 Summary: A drop-in React single-page admin for Django, driven entirely by ModelAdmin.
 License: MIT
 License-File: LICENSE
@@ -10,6 +10,7 @@ Requires-Python: >=3.10,<4.0
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Web Environment
 Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
 Classifier: Framework :: Django :: 5.0
 Classifier: Framework :: Django :: 5.1
 Classifier: Framework :: Django :: 5.2
@@ -25,9 +26,9 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Dist: django (>=5.0,<7.0)
-Requires-Dist: django-admin-mcp-api (>=1.0.0,<2.0.0)
-Requires-Dist: django-admin-rest-api (>=1.0.6,<2.0.0)
+Requires-Dist: django (>=4.2,<7.0)
+Requires-Dist: django-admin-mcp-api (>=1.1.0,<2.0.0)
+Requires-Dist: django-admin-rest-api (>=1.1.0,<2.0.0)
 Project-URL: Documentation, https://github.com/MartinCastroAlvarez/django-admin-react#readme
 Project-URL: Homepage, https://github.com/MartinCastroAlvarez/django-admin-react
 Project-URL: Repository, https://github.com/MartinCastroAlvarez/django-admin-react
@@ -190,9 +191,12 @@ DJANGO_ADMIN_REACT = {
     "BRAND_LOGO_URL": None,     # str | None — favicon + sidebar logo;
                                 # falls back to AdminSite.site_logo. Absolute
                                 # URL or a path under your STATIC_URL.
-    "PRIMARY_COLOR": "#2563eb", # accent for primary buttons, links, and
-                                # active states. Hex only (validated);
-                                # injected as the --dar-primary CSS var, so
+    "PRIMARY_COLOR": None,      # accent for primary buttons, links, and
+                                # active states (#437 / #631). Hex only
+                                # (validated). None → reads
+                                # `site_primary_color` off your AdminSite;
+                                # fallback default is "#2563eb". Injected
+                                # as the --dar-primary CSS var, so
                                 # rebranding needs no React rebuild.
 
     # Auth + API mount
@@ -247,10 +251,39 @@ Both values are written into the SPA index template as standard
 reads them at boot, so the first paint already carries the consumer's
 brand. No flash of the package's defaults.
 
+#### Accent colour (`PRIMARY_COLOR` + `AdminSite.site_primary_color`)
+
+`PRIMARY_COLOR` defaults to `None` so a custom `AdminSite` subclass can
+own the brand colour the same way it owns `site_header` / `site_logo`
+(#631). Resolution order — explicit setting wins, AdminSite is the
+structural default, built-in fallback last:
+
+1. `DJANGO_ADMIN_REACT["PRIMARY_COLOR"]` — explicit per-deployment override.
+2. `<your AdminSite>.site_primary_color` — convention attribute on your
+   custom `AdminSite` subclass (Django has no such attribute by default;
+   add it as a constant alongside `site_header` / `site_logo`).
+3. `"#2563eb"` — the package's last-resort fallback.
+
+Every layer runs through a strict hex-colour regex (`#rgb` / `#rgba` /
+`#rrggbb` / `#rrggbbaa`) before being injected into the SPA's `<style>`
+block, so a non-hex value at any layer falls through to the next — CSS
+injection is impossible at any source.
+
+```python
+# myproject/admin.py
+from django.contrib.admin import AdminSite
+
+class AcmeAdminSite(AdminSite):
+    site_header = "Acme"
+    site_title = "Acme Admin"
+    site_logo = "/static/acme/logo.svg"
+    site_primary_color = "#10b981"   # emerald — used by legacy admin AND the SPA
+```
+
 ### Requirements
 
 - **Python**: 3.10+
-- **Django**: 5.0, 5.1, 5.2, 6.0 (and any later 6.x)
+- **Django**: 4.2 LTS, 5.0, 5.1, 5.2 LTS, 6.0 (and any later 6.x)
 - **Database**: anything Django supports — the package is ORM-only,
   no direct SQL.
 - **Auth**: Django's built-in session + CSRF. Works with custom

{django_admin_react-1.4.13 → django_admin_react-1.5.0}/README.md

@@ -155,9 +155,12 @@ DJANGO_ADMIN_REACT = {
     "BRAND_LOGO_URL": None,     # str | None — favicon + sidebar logo;
                                 # falls back to AdminSite.site_logo. Absolute
                                 # URL or a path under your STATIC_URL.
-    "PRIMARY_COLOR": "#2563eb", # accent for primary buttons, links, and
-                                # active states. Hex only (validated);
-                                # injected as the --dar-primary CSS var, so
+    "PRIMARY_COLOR": None,      # accent for primary buttons, links, and
+                                # active states (#437 / #631). Hex only
+                                # (validated). None → reads
+                                # `site_primary_color` off your AdminSite;
+                                # fallback default is "#2563eb". Injected
+                                # as the --dar-primary CSS var, so
                                 # rebranding needs no React rebuild.
 
     # Auth + API mount
@@ -212,10 +215,39 @@ Both values are written into the SPA index template as standard
 reads them at boot, so the first paint already carries the consumer's
 brand. No flash of the package's defaults.
 
+#### Accent colour (`PRIMARY_COLOR` + `AdminSite.site_primary_color`)
+
+`PRIMARY_COLOR` defaults to `None` so a custom `AdminSite` subclass can
+own the brand colour the same way it owns `site_header` / `site_logo`
+(#631). Resolution order — explicit setting wins, AdminSite is the
+structural default, built-in fallback last:
+
+1. `DJANGO_ADMIN_REACT["PRIMARY_COLOR"]` — explicit per-deployment override.
+2. `<your AdminSite>.site_primary_color` — convention attribute on your
+   custom `AdminSite` subclass (Django has no such attribute by default;
+   add it as a constant alongside `site_header` / `site_logo`).
+3. `"#2563eb"` — the package's last-resort fallback.
+
+Every layer runs through a strict hex-colour regex (`#rgb` / `#rgba` /
+`#rrggbb` / `#rrggbbaa`) before being injected into the SPA's `<style>`
+block, so a non-hex value at any layer falls through to the next — CSS
+injection is impossible at any source.
+
+```python
+# myproject/admin.py
+from django.contrib.admin import AdminSite
+
+class AcmeAdminSite(AdminSite):
+    site_header = "Acme"
+    site_title = "Acme Admin"
+    site_logo = "/static/acme/logo.svg"
+    site_primary_color = "#10b981"   # emerald — used by legacy admin AND the SPA
+```
+
 ### Requirements
 
 - **Python**: 3.10+
-- **Django**: 5.0, 5.1, 5.2, 6.0 (and any later 6.x)
+- **Django**: 4.2 LTS, 5.0, 5.1, 5.2 LTS, 6.0 (and any later 6.x)
 - **Database**: anything Django supports — the package is ORM-only,
   no direct SQL.
 - **Auth**: Django's built-in session + CSRF. Works with custom

{django_admin_react-1.4.13 → django_admin_react-1.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "django-admin-react"
-version = "1.4.13"
+version = "1.5.0"
 description = "A drop-in React single-page admin for Django, driven entirely by ModelAdmin."
 authors = ["django-admin-react contributors"]
 license = "MIT"
@@ -13,6 +13,7 @@ classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Environment :: Web Environment",
     "Framework :: Django",
+    "Framework :: Django :: 4.2",
     "Framework :: Django :: 5.0",
     "Framework :: Django :: 5.1",
     "Framework :: Django :: 5.2",
@@ -39,9 +40,11 @@ include = [
 
 [tool.poetry.dependencies]
 python = "^3.10"
-# Django 5.0 → 5.2 LTS → 6.x. Bump the upper bound when 7.0 ships and
-# we've verified the package still passes its test matrix on it.
-django = ">=5.0,<7.0"
+# Django 4.2 LTS → 5.2 LTS → 6.x (#622). Bump the upper bound when 7.0
+# ships and we've verified the package still passes its test matrix on
+# it. The dependent ``django-admin-rest-api`` package also supports 4.2
+# (since its 1.1.0).
+django = ">=4.2,<7.0"
 # The JSON REST API surface (every list / detail / create / update /
 # delete / action / history / autocomplete endpoint) lives in this
 # sibling package — same `ModelAdmin` source of truth, same permissions,
@@ -49,16 +52,16 @@ django = ">=5.0,<7.0"
 # React SPA super-layer over `django-admin-rest-api`. The package's URLs
 # are included by `django_admin_react.urls`, and consumers add
 # `"django_admin_rest_api"` to `INSTALLED_APPS` alongside this package.
-django-admin-rest-api = "^1.0.6"
+django-admin-rest-api = "^1.1.0"
 # `django-admin-mcp-api` — MCP-protocol adapter over the same REST API
 # so agents reach the SAME `ModelAdmin`-driven surface. Wire-protocol-only
 # layer; adds NO new functionality, permissions, or validation.
 # Constraint widened in v1.4.4 (#605) from the original `^0.1.0a0`
-# (which caps at `<0.2.0`) to `>=1.0.0,<2.0.0` so consumers can pin
-# the stable `1.x` mcp line. The wire contract is unchanged across
-# the 0.1.0a0 → 1.x bump; the version bump is a stability signal,
-# not an API break.
-django-admin-mcp-api = ">=1.0.0,<2.0.0"
+# to `>=1.0.0,<2.0.0`; raised again in v1.5.0 (#622) to `>=1.1.0,<2.0.0`
+# so a consumer on Django 4.2 actually gets a Django-4.2-compatible MCP
+# (the 1.0.x line pins ``django>=5.0``, which would refuse to install
+# alongside Django 4.2).
+django-admin-mcp-api = ">=1.1.0,<2.0.0"
 
 [tool.poetry.group.dev.dependencies]
 # Dependabot #5: pytest's tmpdir handled symlinks unsafely