django-unfold 0.38.0__tar.gz → 0.40.0__tar.gz

django_unfold-0.40.0/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.1
+Name: django-unfold
+Version: 0.40.0
+Summary: Modern Django admin theme for seamless interface development
+Home-page: https://unfoldadmin.com
+License: MIT
+Keywords: django,admin,tailwind,theme
+Requires-Python: >=3.8
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: django (>=3.2)
+Project-URL: Repository, https://github.com/unfoldadmin/django-unfold
+Description-Content-Type: text/markdown
+
+![screenshot](https://github.com/user-attachments/assets/b5ec09b6-c8c7-454a-85af-1bba97593632)
+
+## Unfold Django Admin Theme
+
+[![PyPI - Version](https://img.shields.io/pypi/v/django-unfold.svg?style=for-the-badge)](https://pypi.org/project/django-unfold/)
+[![Build](https://img.shields.io/github/actions/workflow/status/unfoldadmin/django-unfold/release.yml?style=for-the-badge)](https://github.com/unfoldadmin/django-unfold/actions?query=workflow%3Arelease)
+![Pre Commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=for-the-badge)
+![Code Style - Ruff](https://img.shields.io/badge/code%20style-ruff-30173D.svg?style=for-the-badge)
+
+Unfold is a theme for Django admin that incorporates common best practices for building full-fledged admin areas. It is designed to work on top of the default administration provided by Django.
+
+- **Documentation:** Full docs are available at [unfoldadmin.com](https://unfoldadmin.com?utm_medium=github&utm_source=unfold).
+- **Unfold:** Demo site is available at [unfoldadmin.com](https://unfoldadmin.com?utm_medium=github&utm_source=unfold).
+- **Formula:** Repository with demo implementation at [github.com/unfoldadmin/formula](https://github.com/unfoldadmin/formula?utm_medium=github&utm_source=unfold).
+- **Turbo:** Django & Next.js boilerplate implementing Unfold at [github.com/unfoldadmin/turbo](https://github.com/unfoldadmin/turbo?utm_medium=github&utm_source=unfold).
+
+## Are you using Unfold and need help?
+
+Have you decided to start using Unfold but don’t have time to make the switch from the native Django admin? [Get in touch with us](https://unfoldadmin.com/consulting?utm_medium=github&utm_source=unfold) and let’s supercharge your development with our expertise.
+
+## Features
+
+- **Visual**: Provides a new user interface based on the Tailwind CSS framework.
+- **Sidebar:** Simplifies the creation of sidebar navigation with icons, collapsibles, and more.
+- **Dark mode:** Supports both light and dark mode versions.
+- **Actions:** Offers multiple ways to define actions within different parts of the admin interface.
+- **Filters:** Custom dropdowns, numeric, datetime, and text fields.
+- **Dashboard:** Includes helpers for creating custom dashboard pages.
+- **Components:** Reusable UI components such as cards, buttons, and charts.
+- **WYSIWYG widget:** Built-in support for WYSIWYG (Trix).
+- **Array widget:** Built-in widget for `django.contrib.postgres.fields.ArrayField`.
+- **Inline tabs:** Groups inlines into tab navigation in the change form.
+- **Model tabs:** Allows defining custom tab navigation for models.
+- **Fieldset tabs:** Merges multiple fieldsets into tabs in the change form.
+- **Environment label**: Distinguishes between environments by displaying a label.
+- **Nonrelated inlines**: Displays nonrelated models as inlines in the change form.
+- **Favicons**: Built-in support for configuring various site favicons.
+- **Colors:** Allows customization of the default color scheme.
+- **Changeform modes:** Displays fields in compressed mode in the change form.
+- **Parallel admin**: Supports [running the default admin](https://unfoldadmin.com/blog/migrating-django-admin-unfold/?utm_medium=github&utm_source=unfold) alongside Unfold.
+- **Third party packages:** Default support for multiple popular applications.
+- **Configuration:** Most basic options can be changed in `settings.py`.
+- **Dependencies:** Fully based on `django.contrib.admin`.
+- **VS Code**: Project configuration and development container included.
+

django_unfold-0.40.0/README.md

@@ -0,0 +1,44 @@
+![screenshot](https://github.com/user-attachments/assets/b5ec09b6-c8c7-454a-85af-1bba97593632)
+
+## Unfold Django Admin Theme
+
+[![PyPI - Version](https://img.shields.io/pypi/v/django-unfold.svg?style=for-the-badge)](https://pypi.org/project/django-unfold/)
+[![Build](https://img.shields.io/github/actions/workflow/status/unfoldadmin/django-unfold/release.yml?style=for-the-badge)](https://github.com/unfoldadmin/django-unfold/actions?query=workflow%3Arelease)
+![Pre Commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=for-the-badge)
+![Code Style - Ruff](https://img.shields.io/badge/code%20style-ruff-30173D.svg?style=for-the-badge)
+
+Unfold is a theme for Django admin that incorporates common best practices for building full-fledged admin areas. It is designed to work on top of the default administration provided by Django.
+
+- **Documentation:** Full docs are available at [unfoldadmin.com](https://unfoldadmin.com?utm_medium=github&utm_source=unfold).
+- **Unfold:** Demo site is available at [unfoldadmin.com](https://unfoldadmin.com?utm_medium=github&utm_source=unfold).
+- **Formula:** Repository with demo implementation at [github.com/unfoldadmin/formula](https://github.com/unfoldadmin/formula?utm_medium=github&utm_source=unfold).
+- **Turbo:** Django & Next.js boilerplate implementing Unfold at [github.com/unfoldadmin/turbo](https://github.com/unfoldadmin/turbo?utm_medium=github&utm_source=unfold).
+
+## Are you using Unfold and need help?
+
+Have you decided to start using Unfold but don’t have time to make the switch from the native Django admin? [Get in touch with us](https://unfoldadmin.com/consulting?utm_medium=github&utm_source=unfold) and let’s supercharge your development with our expertise.
+
+## Features
+
+- **Visual**: Provides a new user interface based on the Tailwind CSS framework.
+- **Sidebar:** Simplifies the creation of sidebar navigation with icons, collapsibles, and more.
+- **Dark mode:** Supports both light and dark mode versions.
+- **Actions:** Offers multiple ways to define actions within different parts of the admin interface.
+- **Filters:** Custom dropdowns, numeric, datetime, and text fields.
+- **Dashboard:** Includes helpers for creating custom dashboard pages.
+- **Components:** Reusable UI components such as cards, buttons, and charts.
+- **WYSIWYG widget:** Built-in support for WYSIWYG (Trix).
+- **Array widget:** Built-in widget for `django.contrib.postgres.fields.ArrayField`.
+- **Inline tabs:** Groups inlines into tab navigation in the change form.
+- **Model tabs:** Allows defining custom tab navigation for models.
+- **Fieldset tabs:** Merges multiple fieldsets into tabs in the change form.
+- **Environment label**: Distinguishes between environments by displaying a label.
+- **Nonrelated inlines**: Displays nonrelated models as inlines in the change form.
+- **Favicons**: Built-in support for configuring various site favicons.
+- **Colors:** Allows customization of the default color scheme.
+- **Changeform modes:** Displays fields in compressed mode in the change form.
+- **Parallel admin**: Supports [running the default admin](https://unfoldadmin.com/blog/migrating-django-admin-unfold/?utm_medium=github&utm_source=unfold) alongside Unfold.
+- **Third party packages:** Default support for multiple popular applications.
+- **Configuration:** Most basic options can be changed in `settings.py`.
+- **Dependencies:** Fully based on `django.contrib.admin`.
+- **VS Code**: Project configuration and development container included.

{django_unfold-0.38.0 → django_unfold-0.40.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "django-unfold"
-version = "0.38.0"
+version = "0.40.0"
 description = "Modern Django admin theme for seamless interface development"
 license = "MIT"
 readme = "README.md"
@@ -27,13 +27,13 @@ python = ">=3.8"
 django = ">=3.2"
 
 [tool.poetry.group.test.dependencies]
-pytest = "^7.3.1"
-pytest-django = "^4.5.2"
-tox = "^4.5.2"
+pytest = "^8.3"
+pytest-django = "^4.9"
+tox = "^4.21"
 
 
 [tool.poetry.group.dev.dependencies]
-python-semantic-release = "^8.7.0"
+python-semantic-release = "^8.7"
 
 [tool.ruff]
 fix = true

{django_unfold-0.38.0 → django_unfold-0.40.0}/src/unfold/admin.py

@@ -235,6 +235,10 @@ class ModelAdmin(ModelAdminMixin, BaseModelAdmin):
     list_filter_submit = False
     list_fullwidth = False
     list_disable_select_all = False
+    list_before_template = None
+    list_after_template = None
+    change_form_before_template = None
+    change_form_after_template = None
     compressed_fields = False
     readonly_preprocess_fields = {}
     warn_unsaved_form = False

{django_unfold-0.38.0 → django_unfold-0.40.0}/src/unfold/contrib/guardian/templates/unfold/guardian/user_form.html

@@ -38,10 +38,10 @@
 
                         {% for perm in model_perms %}
                             <td class="align-middle flex border-t border-gray-200 font-normal px-3 py-2 text-left  before:flex before:capitalize before:content-[attr(data-label)] before:items-center before:mr-auto  first:border-t-0  lg:before:hidden lg:first:border-t lg:py-3 lg:table-cell dark:border-gray-800" data-label="{{ perm.name }}">
-                                {% if perm.codename in group_perms %}
-                                    {% include "unfold/helpers/boolean.html" with value=False %}
-                                {% else %}
+                                {% if perm.codename in user_perms %}
                                     {% include "unfold/helpers/boolean.html" with value=True %}
+                                {% else %}
+                                    {% include "unfold/helpers/boolean.html" with value=False %}
                                 {% endif %}
                             </td>
                         {% endfor %}

{django_unfold-0.38.0 → django_unfold-0.40.0}/src/unfold/forms.py

@@ -10,9 +10,14 @@ from django.contrib.admin.forms import (
 from django.contrib.auth.forms import (
     AdminPasswordChangeForm as BaseAdminPasswordChangeForm,
 )
+from django.contrib.auth.models import User
+
+try:
+    from django.contrib.auth.forms import AdminUserCreationForm as BaseUserCreationForm
+except ImportError:
+    from django.contrib.auth.forms import UserCreationForm as BaseUserCreationForm
 from django.contrib.auth.forms import ReadOnlyPasswordHashWidget
 from django.contrib.auth.forms import UserChangeForm as BaseUserChangeForm
-from django.contrib.auth.forms import UserCreationForm as BaseUserCreationForm
 from django.http import HttpRequest
 from django.utils.safestring import mark_safe
 from django.utils.translation import gettext_lazy as _
@@ -66,11 +71,10 @@ class AuthenticationForm(AdminAuthenticationForm):
 class UserCreationForm(BaseUserCreationForm):
     def __init__(
         self,
-        request: Optional[HttpRequest] = None,
         *args,
         **kwargs,
     ) -> None:
-        super().__init__(request, *args, **kwargs)
+        super().__init__(*args, **kwargs)
 
         self.fields["password1"].widget = UnfoldAdminPasswordInput(
             attrs={"autocomplete": "new-password"}
@@ -88,11 +92,10 @@ class UserCreationForm(BaseUserCreationForm):
 class UserChangeForm(BaseUserChangeForm):
     def __init__(
         self,
-        request: Optional[HttpRequest] = None,
         *args,
         **kwargs,
     ) -> None:
-        super().__init__(request, *args, **kwargs)
+        super().__init__(*args, **kwargs)
         self.fields["password"].widget = UnfoldReadOnlyPasswordHashWidget()
 
         self.fields["password"].help_text = _(
@@ -109,19 +112,19 @@ class UserChangeForm(BaseUserChangeForm):
 class AdminPasswordChangeForm(BaseAdminPasswordChangeForm):
     def __init__(
         self,
-        request: Optional[HttpRequest] = None,
+        user: User,
         *args,
         **kwargs,
     ) -> None:
-        super().__init__(request, *args, **kwargs)
+        super().__init__(user, *args, **kwargs)
 
         self.fields["password1"].widget.attrs["class"] = " ".join(INPUT_CLASSES)
         self.fields["password2"].widget.attrs["class"] = " ".join(INPUT_CLASSES)
 
 
 class AdminOwnPasswordChangeForm(BaseAdminOwnPasswordChangeForm):
-    def __init__(self, *args, **kwargs) -> None:
-        super().__init__(kwargs.pop("user"), *args, **kwargs)
+    def __init__(self, user: User, *args, **kwargs) -> None:
+        super().__init__(user, *args, **kwargs)
 
         self.fields["old_password"].widget.attrs["class"] = " ".join(INPUT_CLASSES)
         self.fields["new_password1"].widget.attrs["class"] = " ".join(INPUT_CLASSES)

{django_unfold-0.38.0 → django_unfold-0.40.0}/src/unfold/sites.py

@@ -7,8 +7,18 @@ from django.core.validators import EMPTY_VALUES
 from django.http import HttpRequest, HttpResponse
 from django.template.response import TemplateResponse
 from django.urls import URLPattern, path, reverse, reverse_lazy
+from django.utils.decorators import method_decorator
 from django.utils.functional import lazy
 from django.utils.module_loading import import_string
+from django.views.decorators.cache import never_cache
+
+try:
+    from django.contrib.auth.decorators import login_not_required
+except ImportError:
+
+    def login_not_required(func: Callable) -> Callable:
+        return func
+
 
 from .dataclasses import Favicon
 from .settings import get_config
@@ -178,6 +188,8 @@ class UnfoldAdminSite(AdminSite):
             },
         )
 
+    @method_decorator(never_cache)
+    @login_not_required
     def login(
         self, request: HttpRequest, extra_context: Optional[Dict[str, Any]] = None
     ) -> HttpResponse:

django_unfold-0.40.0/src/unfold/static/admin/js/admin/RelatedObjectLookups.js

@@ -0,0 +1,295 @@
+/*global SelectBox, interpolate*/
+// Handles related-objects functionality: lookup link for raw_id_fields
+// and Add Another links.
+"use strict";
+{
+  const $ = django.jQuery;
+  let popupIndex = 0;
+  const relatedWindows = [];
+
+  function dismissChildPopups() {
+    relatedWindows.forEach(function (win) {
+      if (!win.closed) {
+        win.dismissChildPopups();
+        win.close();
+      }
+    });
+  }
+
+  function setPopupIndex() {
+    if (document.getElementsByName("_popup").length > 0) {
+      const index = window.name.lastIndexOf("__") + 2;
+      popupIndex = parseInt(window.name.substring(index));
+    } else {
+      popupIndex = 0;
+    }
+  }
+
+  function addPopupIndex(name) {
+    return name + "__" + (popupIndex + 1);
+  }
+
+  function removePopupIndex(name) {
+    return name.replace(new RegExp("__" + (popupIndex + 1) + "$"), "");
+  }
+
+  function showAdminPopup(triggeringLink, name_regexp, add_popup) {
+    const name = addPopupIndex(triggeringLink.id.replace(name_regexp, ""));
+    const href = new URL(triggeringLink.href);
+    if (add_popup) {
+      href.searchParams.set("_popup", 1);
+    }
+    const win = window.open(
+      href,
+      name,
+      "height=768,width=1024,resizable=yes,scrollbars=yes"
+    );
+    relatedWindows.push(win);
+    win.focus();
+    return false;
+  }
+
+  function showRelatedObjectLookupPopup(triggeringLink) {
+    return showAdminPopup(triggeringLink, /^lookup_/, true);
+  }
+
+  function dismissRelatedLookupPopup(win, chosenId) {
+    const name = removePopupIndex(win.name);
+    const elem = document.getElementById(name);
+    if (elem.classList.contains("vManyToManyRawIdAdminField") && elem.value) {
+      elem.value += "," + chosenId;
+    } else {
+      document.getElementById(name).value = chosenId;
+    }
+    const index = relatedWindows.indexOf(win);
+    if (index > -1) {
+      relatedWindows.splice(index, 1);
+    }
+    win.close();
+  }
+
+  function showRelatedObjectPopup(triggeringLink) {
+    return showAdminPopup(triggeringLink, /^(change|add|delete)_/, false);
+  }
+
+  function updateRelatedObjectLinks(triggeringLink) {
+    const $this = $(triggeringLink);
+    const siblings = $this.nextAll(
+      ".view-related, .change-related, .delete-related"
+    );
+    if (!siblings.length) {
+      return;
+    }
+    const value = $this.val();
+    if (value) {
+      siblings.each(function () {
+        const elm = $(this);
+        elm.attr(
+          "href",
+          elm.attr("data-href-template").replace("__fk__", value)
+        );
+        elm.removeAttr("aria-disabled");
+      });
+    } else {
+      siblings.removeAttr("href");
+      siblings.attr("aria-disabled", true);
+    }
+  }
+
+  function updateRelatedSelectsOptions(
+    currentSelect,
+    win,
+    objId,
+    newRepr,
+    newId,
+    skipIds = []
+  ) {
+    // After create/edit a model from the options next to the current
+    // select (+ or :pencil:) update ForeignKey PK of the rest of selects
+    // in the page.
+
+    const path = win.location.pathname;
+    // Extract the model from the popup url '.../<model>/add/' or
+    // '.../<model>/<id>/change/' depending the action (add or change).
+    const modelName = path.split("/")[path.split("/").length - (objId ? 4 : 3)];
+    // Select elements with a specific model reference and context of "available-source".
+    const selectsRelated = document.querySelectorAll(
+      `[data-model-ref="${modelName}"] [data-context="available-source"]`
+    );
+
+    selectsRelated.forEach(function (select) {
+      if (
+        currentSelect === select ||
+        (skipIds && skipIds.includes(select.id))
+      ) {
+        return;
+      }
+
+      let option = select.querySelector(`option[value="${objId}"]`);
+
+      if (!option) {
+        option = new Option(newRepr, newId);
+        select.options.add(option);
+        // Update SelectBox cache for related fields.
+        if (
+          window.SelectBox !== undefined &&
+          !SelectBox.cache[currentSelect.id]
+        ) {
+          SelectBox.add_to_cache(select.id, option);
+          SelectBox.redisplay(select.id);
+        }
+        return;
+      }
+
+      option.textContent = newRepr;
+      option.value = newId;
+    });
+  }
+
+  function dismissAddRelatedObjectPopup(win, newId, newRepr) {
+    const name = removePopupIndex(win.name);
+    const elem = document.getElementById(name);
+    if (elem) {
+      const elemName = elem.nodeName.toUpperCase();
+      if (elemName === "SELECT") {
+        elem.options[elem.options.length] = new Option(
+          newRepr,
+          newId,
+          true,
+          true
+        );
+        updateRelatedSelectsOptions(elem, win, null, newRepr, newId);
+      } else if (elemName === "INPUT") {
+        if (
+          elem.classList.contains("vManyToManyRawIdAdminField") &&
+          elem.value
+        ) {
+          elem.value += "," + newId;
+        } else {
+          elem.value = newId;
+        }
+      }
+      // Trigger a change event to update related links if required.
+      $(elem).trigger("change");
+    } else {
+      const toId = name + "_to";
+      const toElem = document.getElementById(toId);
+      const o = new Option(newRepr, newId);
+      SelectBox.add_to_cache(toId, o);
+      SelectBox.redisplay(toId);
+      if (toElem && toElem.nodeName.toUpperCase() === "SELECT") {
+        const skipIds = [name + "_from"];
+        updateRelatedSelectsOptions(toElem, win, null, newRepr, newId, skipIds);
+      }
+    }
+    const index = relatedWindows.indexOf(win);
+    if (index > -1) {
+      relatedWindows.splice(index, 1);
+    }
+    win.close();
+  }
+
+  function dismissChangeRelatedObjectPopup(win, objId, newRepr, newId) {
+    const id = removePopupIndex(win.name.replace(/^edit_/, ""));
+    const selectsSelector = interpolate("#%s, #%s_from, #%s_to", [id, id, id]);
+    const selects = $(selectsSelector);
+    selects
+      .find("option")
+      .each(function () {
+        if (this.value === objId) {
+          this.textContent = newRepr;
+          this.value = newId;
+        }
+      })
+      .trigger("change");
+    updateRelatedSelectsOptions(selects[0], win, objId, newRepr, newId);
+    selects
+      .next()
+      .find(".select2-selection__rendered")
+      .each(function () {
+        // The element can have a clear button as a child.
+        // Use the lastChild to modify only the displayed value.
+        this.lastChild.textContent = newRepr;
+        this.title = newRepr;
+      });
+    const index = relatedWindows.indexOf(win);
+    if (index > -1) {
+      relatedWindows.splice(index, 1);
+    }
+    win.close();
+  }
+
+  function dismissDeleteRelatedObjectPopup(win, objId) {
+    const id = removePopupIndex(win.name.replace(/^delete_/, ""));
+    const selectsSelector = interpolate("#%s, #%s_from, #%s_to", [id, id, id]);
+    const selects = $(selectsSelector);
+    selects
+      .find("option")
+      .each(function () {
+        if (this.value === objId) {
+          $(this).remove();
+        }
+      })
+      .trigger("change");
+    const index = relatedWindows.indexOf(win);
+    if (index > -1) {
+      relatedWindows.splice(index, 1);
+    }
+    win.close();
+  }
+
+  window.showRelatedObjectLookupPopup = showRelatedObjectLookupPopup;
+  window.dismissRelatedLookupPopup = dismissRelatedLookupPopup;
+  window.showRelatedObjectPopup = showRelatedObjectPopup;
+  window.updateRelatedObjectLinks = updateRelatedObjectLinks;
+  window.dismissAddRelatedObjectPopup = dismissAddRelatedObjectPopup;
+  window.dismissChangeRelatedObjectPopup = dismissChangeRelatedObjectPopup;
+  window.dismissDeleteRelatedObjectPopup = dismissDeleteRelatedObjectPopup;
+  window.dismissChildPopups = dismissChildPopups;
+
+  // Kept for backward compatibility
+  window.showAddAnotherPopup = showRelatedObjectPopup;
+  window.dismissAddAnotherPopup = dismissAddRelatedObjectPopup;
+
+  window.addEventListener("unload", function (evt) {
+    window.dismissChildPopups();
+  });
+
+  $(document).ready(function () {
+    setPopupIndex();
+    $("a[data-popup-opener]").on("click", function (event) {
+      event.preventDefault();
+      opener.dismissRelatedLookupPopup(window, $(this).data("popup-opener"));
+    });
+    $("body").on(
+      "click",
+      '.related-widget-wrapper-link[data-popup="yes"]',
+      function (e) {
+        e.preventDefault();
+        if (this.href) {
+          const event = $.Event("django:show-related", { href: this.href });
+          $(this).trigger(event);
+          if (!event.isDefaultPrevented()) {
+            showRelatedObjectPopup(this);
+          }
+        }
+      }
+    );
+    $("body").on("change", ".related-widget-wrapper select", function (e) {
+      const event = $.Event("django:update-related");
+      $(this).trigger(event);
+      if (!event.isDefaultPrevented()) {
+        updateRelatedObjectLinks(this);
+      }
+    });
+    $(".related-widget-wrapper select").trigger("change");
+    $("body").on("click", ".related-lookup", function (e) {
+      e.preventDefault();
+      const event = $.Event("django:lookup-related");
+      $(this).trigger(event);
+      if (!event.isDefaultPrevented()) {
+        showRelatedObjectLookupPopup(this);
+      }
+    });
+  });
+}