django-unfold 0.47.0__tar.gz → 0.49.0__tar.gz

{django_unfold-0.47.0 → django_unfold-0.49.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: django-unfold
-Version: 0.47.0
+Version: 0.49.0
 Summary: Modern Django admin theme for seamless interface development
 License: MIT
 Keywords: django,admin,tailwind,theme

{django_unfold-0.47.0 → django_unfold-0.49.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "django-unfold"
-version = "0.47.0"
+version = "0.49.0"
 description = "Modern Django admin theme for seamless interface development"
 license = "MIT"
 readme = "README.md"

django_unfold-0.49.0/src/unfold/admin.py

@@ -0,0 +1,183 @@
+from functools import update_wrapper
+from typing import Optional
+
+from django import forms
+from django.contrib.admin import ModelAdmin as BaseModelAdmin
+from django.contrib.admin import StackedInline as BaseStackedInline
+from django.contrib.admin import TabularInline as BaseTabularInline
+from django.contrib.admin import display, helpers
+from django.db.models import BLANK_CHOICE_DASH, Model
+from django.http import HttpRequest, HttpResponse
+from django.shortcuts import redirect
+from django.urls import URLPattern, path
+from django.utils.safestring import mark_safe
+from django.utils.translation import gettext_lazy as _
+from django.views import View
+
+from unfold.checks import UnfoldModelAdminChecks
+from unfold.fields import UnfoldAdminField, UnfoldAdminReadonlyField
+from unfold.forms import ActionForm
+from unfold.mixins import ActionModelAdminMixin, BaseModelAdminMixin
+from unfold.overrides import FORMFIELD_OVERRIDES_INLINE
+from unfold.typing import FieldsetsType
+from unfold.widgets import UnfoldBooleanWidget
+
+checkbox = UnfoldBooleanWidget(
+    {
+        "class": "action-select",
+        "aria-label": _("Select record"),
+    },
+    lambda value: False,
+)
+
+helpers.AdminField = UnfoldAdminField
+
+helpers.AdminReadonlyField = UnfoldAdminReadonlyField
+
+
+class ModelAdmin(BaseModelAdminMixin, ActionModelAdminMixin, BaseModelAdmin):
+    action_form = ActionForm
+    custom_urls = ()
+    add_fieldsets = ()
+    list_horizontal_scrollbar_top = False
+    list_filter_submit = False
+    list_filter_sheet = True
+    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
+    change_form_outer_before_template = None
+    change_form_outer_after_template = None
+    compressed_fields = False
+    readonly_preprocess_fields = {}
+    warn_unsaved_form = False
+    checks_class = UnfoldModelAdminChecks
+
+    @property
+    def media(self):
+        media = super().media
+        additional_media = forms.Media()
+
+        for filter in self.list_filter:
+            if (
+                isinstance(filter, (tuple, list))
+                and hasattr(filter[1], "form_class")
+                and hasattr(filter[1].form_class, "Media")
+            ):
+                additional_media += forms.Media(filter[1].form_class.Media)
+            elif hasattr(filter, "form_class") and hasattr(filter.form_class, "Media"):
+                additional_media += forms.Media(filter.form_class.Media)
+
+        return media + additional_media
+
+    def get_fieldsets(self, request: HttpRequest, obj=None) -> FieldsetsType:
+        if not obj and self.add_fieldsets:
+            return self.add_fieldsets
+        return super().get_fieldsets(request, obj)
+
+    def get_custom_urls(self) -> tuple[tuple[str, str, View], ...]:
+        """
+        Method to get custom views for ModelAdmin with their urls
+
+        Format of custom_urls item:
+            ("path_to_view", "name_of_view", view_itself)
+        """
+        return () if self.custom_urls is None else self.custom_urls
+
+    def get_urls(self) -> list[URLPattern]:
+        urls = super().get_urls()
+
+        def wrap(view):
+            def wrapper(*args, **kwargs):
+                return self.admin_site.admin_view(view)(*args, **kwargs)
+
+            wrapper.model_admin = self
+            return update_wrapper(wrapper, view)
+
+        custom_urls = [
+            self._path_from_custom_url(custom_url)
+            for custom_url in self.get_custom_urls()
+        ]
+
+        actions_list_urls = [
+            path(
+                action.path,
+                wrap(action.method),
+                name=action.action_name,
+            )
+            for action in self._get_base_actions_list()
+        ]
+
+        action_detail_urls = [
+            path(
+                f"<path:object_id>/{action.path}/",
+                wrap(action.method),
+                name=action.action_name,
+            )
+            for action in self._get_base_actions_detail()
+        ]
+
+        action_row_urls = [
+            path(
+                f"<path:object_id>/{action.path}",
+                wrap(action.method),
+                name=action.action_name,
+            )
+            for action in self._get_base_actions_row()
+        ]
+
+        return (
+            custom_urls
+            + action_row_urls
+            + actions_list_urls
+            + action_detail_urls
+            + urls
+        )
+
+    def _path_from_custom_url(self, custom_url) -> URLPattern:
+        return path(
+            custom_url[0],
+            self.admin_site.admin_view(custom_url[2]),
+            {"model_admin": self},
+            name=custom_url[1],
+        )
+
+    def get_action_choices(
+        self, request: HttpRequest, default_choices=BLANK_CHOICE_DASH
+    ):
+        default_choices = [("", _("Select action"))]
+        return super().get_action_choices(request, default_choices)
+
+    @display(description=mark_safe(checkbox.render("action_toggle_all", 1)))
+    def action_checkbox(self, obj: Model):
+        return checkbox.render(helpers.ACTION_CHECKBOX_NAME, str(obj.pk))
+
+    def response_change(self, request: HttpRequest, obj: Model) -> HttpResponse:
+        res = super().response_change(request, obj)
+        if "next" in request.GET:
+            return redirect(request.GET["next"])
+        return res
+
+    def response_add(
+        self, request: HttpRequest, obj: Model, post_url_continue: Optional[str] = None
+    ) -> HttpResponse:
+        res = super().response_add(request, obj, post_url_continue)
+        if "next" in request.GET:
+            return redirect(request.GET["next"])
+        return res
+
+
+class TabularInline(BaseModelAdminMixin, BaseTabularInline):
+    formfield_overrides = FORMFIELD_OVERRIDES_INLINE
+    readonly_preprocess_fields = {}
+    ordering_field = None
+    hide_ordering_field = False
+
+
+class StackedInline(BaseModelAdminMixin, BaseStackedInline):
+    formfield_overrides = FORMFIELD_OVERRIDES_INLINE
+    readonly_preprocess_fields = {}
+    ordering_field = None
+    hide_ordering_field = False

{django_unfold-0.47.0 → django_unfold-0.49.0}/src/unfold/dataclasses.py

@@ -12,6 +12,7 @@ class UnfoldAction:
     path: str
     attrs: Optional[dict] = None
     object_id: Optional[Union[int, str]] = None
+    icon: Optional[str] = None
 
 
 @dataclass
@@ -20,3 +21,10 @@ class Favicon:
     rel: Optional[str] = None
     type: Optional[str] = None
     sizes: Optional[str] = None
+
+
+@dataclass
+class DropdownItem:
+    title: str
+    link: Union[str, Callable]
+    icon: Optional[str] = None

{django_unfold-0.47.0 → django_unfold-0.49.0}/src/unfold/decorators.py

@@ -17,6 +17,7 @@ def action(
     description: Optional[str] = None,
     url_path: Optional[str] = None,
     attrs: Optional[dict[str, Any]] = None,
+    icon: Optional[str] = None,
 ) -> ActionFunction:
     def decorator(func: Callable) -> ActionFunction:
         def inner(
@@ -33,8 +34,14 @@ def action(
                 # Permissions methods have following syntax: has_<some>_permission(self, request, obj=None):
                 # But obj is not examined by default in django admin and it would also require additional
                 # fetch from database, therefore it is not supported yet
-                if not any(
+                has_object_argument = (
+                    func.__name__ in model_admin.actions_detail
+                    or func.__name__ in model_admin.actions_submit_line
+                )
+                if not all(
                     has_permission(request, kwargs.get("object_id"))
+                    if has_object_argument
+                    else has_permission(request)
                     for has_permission in permission_checks
                 ):
                     raise PermissionDenied
@@ -42,10 +49,16 @@ def action(
 
         if permissions is not None:
             inner.allowed_permissions = permissions
+
         if description is not None:
             inner.short_description = description
+
         if url_path is not None:
             inner.url_path = url_path
+
+        if icon is not None:
+            inner.icon = icon
+
         inner.attrs = attrs or {}
         return inner
 

{django_unfold-0.47.0 → django_unfold-0.49.0}/src/unfold/fields.py

@@ -17,17 +17,18 @@ from django.utils.module_loading import import_string
 from django.utils.safestring import SafeText, mark_safe
 from django.utils.text import capfirst
 
-from .settings import get_config
-from .utils import display_for_field, prettify_json
-from .widgets import CHECKBOX_LABEL_CLASSES, LABEL_CLASSES
+from unfold.mixins import BaseModelAdminMixin
+from unfold.settings import get_config
+from unfold.utils import display_for_field, prettify_json
+from unfold.widgets import CHECKBOX_LABEL_CLASSES, LABEL_CLASSES
 
 
 class UnfoldAdminReadonlyField(helpers.AdminReadonlyField):
     def label_tag(self) -> SafeText:
-        from .admin import ModelAdmin, ModelAdminMixin
+        from .admin import ModelAdmin
 
         if not isinstance(self.model_admin, ModelAdmin) and not isinstance(
-            self.model_admin, ModelAdminMixin
+            self.model_admin, BaseModelAdminMixin
         ):
             return super().label_tag()
 

django_unfold-0.49.0/src/unfold/mixins/__init__.py

@@ -0,0 +1,4 @@
+from unfold.mixins.action_model_admin import ActionModelAdminMixin
+from unfold.mixins.base_model_admin import BaseModelAdminMixin
+
+__all__ = ["BaseModelAdminMixin", "ActionModelAdminMixin"]

django_unfold-0.49.0/src/unfold/mixins/action_model_admin.py

@@ -0,0 +1,329 @@
+from typing import Any, Callable, Optional, Union
+
+from django.db.models import Model
+from django.forms import Form
+from django.http import HttpRequest
+from django.template.response import TemplateResponse
+from django.urls import reverse
+
+from unfold.dataclasses import UnfoldAction
+from unfold.exceptions import UnfoldException
+
+
+class ActionModelAdminMixin:
+    """
+    Adds support for various ModelAdmin actions (list, detail, row, submit line)
+    """
+
+    actions_list = ()  # Displayed in changelist at the top
+    actions_row = ()  # Displayed in changelist for each row in the table
+    actions_detail = ()  # Displayed in changeform at the top
+    actions_submit_line = ()  # Displayed in changeform in the submit line (form buttons)
+
+    def changelist_view(
+        self, request: HttpRequest, extra_context: Optional[dict[str, str]] = None
+    ) -> TemplateResponse:
+        """
+        Changelist contains `actions_list` and `actions_row` custom actions. In case of `actions_row` they
+        are displayed in the each row of the table.
+        """
+        extra_context = extra_context or {}
+
+        actions_row = [
+            {
+                "title": action.description,
+                "icon": action.icon,
+                "attrs": action.method.attrs,
+                # This is just a path name as string and in template is used in {% url %} tag
+                # with custom instance pk value
+                "raw_path": f"{self.admin_site.name}:{action.action_name}",
+            }
+            for action in self.get_actions_row(request)
+        ]
+
+        # `actions_list` may contain custom structure with dropdowns so it is needed
+        # to use `_get_actions_navigation` to build the final structure for the template
+        actions_list = self._get_actions_navigation(
+            self.actions_list, self.get_actions_list(request)
+        )
+
+        extra_context.update(
+            {
+                "actions_list": actions_list,
+                "actions_row": actions_row,
+            }
+        )
+
+        return super().changelist_view(request, extra_context)
+
+    def changeform_view(
+        self,
+        request: HttpRequest,
+        object_id: Optional[str] = None,
+        form_url: str = "",
+        extra_context: Optional[dict[str, bool]] = None,
+    ) -> Any:
+        """
+        Changeform contains `actions_submit_line` and `actions_detail` custom actions.
+        """
+        extra_context = extra_context or {}
+
+        # `actions_submit_line` is a list of actions that are displayed in the submit line they
+        # are displayed as form buttons
+        actions_submit_line = self.get_actions_submit_line(request, object_id)
+
+        # `actions_detail` may contain custom structure with dropdowns so it is needed
+        # to use `_get_actions_navigation` to build the final structure for the template
+        actions_detail = self._get_actions_navigation(
+            self.actions_detail,
+            self.get_actions_detail(request, object_id),
+            object_id,
+        )
+
+        extra_context.update(
+            {
+                "actions_submit_line": actions_submit_line,
+                "actions_detail": actions_detail,
+            }
+        )
+
+        return super().changeform_view(request, object_id, form_url, extra_context)
+
+    def save_model(
+        self, request: HttpRequest, obj: Model, form: Form, change: Any
+    ) -> None:
+        """
+        When saving object, run all appropriate actions from `actions_submit_line`
+        """
+        super().save_model(request, obj, form, change)
+
+        # After saving object, check if any button from `actions_submit_line` was pressed
+        # and call the corresponding method
+        for action in self.get_actions_submit_line(request, obj.pk):
+            if action.action_name not in request.POST:
+                continue
+
+            action.method(request, obj)
+
+    def get_unfold_action(self, action: str) -> UnfoldAction:
+        """
+        Converts action name into UnfoldAction object.
+        """
+        method = self._get_instance_method(action)
+
+        return UnfoldAction(
+            action_name=f"{self.model._meta.app_label}_{self.model._meta.model_name}_{action}",
+            method=method,
+            description=self._get_action_description(method, action),
+            path=getattr(method, "url_path", action),
+            attrs=method.attrs if hasattr(method, "attrs") else None,
+            icon=method.icon if hasattr(method, "icon") else None,
+        )
+
+    def get_actions_list(self, request: HttpRequest) -> list[UnfoldAction]:
+        """
+        Filters `actions_list` by permissions and returns list of UnfoldAction objects.
+        """
+        return self._filter_unfold_actions_by_permissions(
+            request, self._get_base_actions_list()
+        )
+
+    def get_actions_detail(
+        self, request: HttpRequest, object_id: int
+    ) -> list[UnfoldAction]:
+        """
+        Filters `actions_detail` by permissions and returns list of UnfoldAction objects.
+        """
+        return self._filter_unfold_actions_by_permissions(
+            request, self._get_base_actions_detail(), object_id
+        )
+
+    def get_actions_row(self, request: HttpRequest) -> list[UnfoldAction]:
+        """
+        Filters `actions_row` by permissions and returns list of UnfoldAction objects.
+        """
+        return self._filter_unfold_actions_by_permissions(
+            request, self._get_base_actions_row()
+        )
+
+    def get_actions_submit_line(
+        self, request: HttpRequest, object_id: int
+    ) -> list[UnfoldAction]:
+        """
+        Filters `actions_submit_line` by permissions and returns list of UnfoldAction objects.
+        """
+        return self._filter_unfold_actions_by_permissions(
+            request, self._get_base_actions_submit_line(), object_id
+        )
+
+    def _extract_action_names(self, actions: list[Union[str, dict]]) -> list[str]:
+        """
+        Gets the list of only actions names from the actions structure provided in ModelAdmin
+        """
+        results = []
+
+        for action in actions or []:
+            if isinstance(action, dict) and "items" in action:
+                results.extend(action["items"])
+            else:
+                results.append(action)
+
+        return results
+
+    def _get_base_actions_list(self) -> list[UnfoldAction]:
+        """
+        Returns list of UnfoldAction objects for `actions_list`.
+        """
+        return [
+            self.get_unfold_action(action)
+            for action in self._extract_action_names(self.actions_list)
+        ]
+
+    def _get_base_actions_detail(self) -> list[UnfoldAction]:
+        """
+        Returns list of UnfoldAction objects for `actions_detail`.
+        """
+        return [
+            self.get_unfold_action(action)
+            for action in self._extract_action_names(self.actions_detail) or []
+        ]
+
+    def _get_base_actions_row(self) -> list[UnfoldAction]:
+        """
+        Returns list of UnfoldAction objects for `actions_row`.
+        """
+        return [
+            self.get_unfold_action(action)
+            for action in self._extract_action_names(self.actions_row) or []
+        ]
+
+    def _get_base_actions_submit_line(self) -> list[UnfoldAction]:
+        """
+        Returns list of UnfoldAction objects for `actions_submit_line`.
+        """
+        return [
+            self.get_unfold_action(action)
+            for action in self._extract_action_names(self.actions_submit_line) or []
+        ]
+
+    def _get_instance_method(self, method_name: str) -> Callable:
+        """
+        Searches for method on self instance based on method_name and returns it if it exists.
+        If it does not exist or is not callable, it raises UnfoldException
+        """
+        try:
+            method = getattr(self, method_name)
+        except AttributeError as e:
+            raise UnfoldException(
+                f"Method {method_name} specified does not exist on current object"
+            ) from e
+
+        if not callable(method):
+            raise UnfoldException(f"{method_name} is not callable")
+
+        return method
+
+    def _get_actions_navigation(
+        self,
+        provided_actions: list[Union[str, dict]],
+        allowed_actions: list[UnfoldAction],
+        object_id: Optional[str] = None,
+    ) -> list[Union[str, dict]]:
+        """
+        Builds navigation structure for the actions which is going to be provided to the template.
+        """
+        navigation = []
+
+        def get_action_by_name(name: str) -> UnfoldAction:
+            """
+            Searches for an action in allowed_actions by its name.
+            """
+            for action in allowed_actions:
+                full_action_name = (
+                    f"{self.model._meta.app_label}_{self.model._meta.model_name}_{name}"
+                )
+
+                if action.action_name == full_action_name:
+                    return action
+
+        def get_action_path(action: UnfoldAction) -> str:
+            """
+            Returns the URL path for an action.
+            """
+            path_name = f"{self.admin_site.name}:{action.action_name}"
+
+            if object_id:
+                return reverse(path_name, args=(object_id,))
+
+            return reverse(path_name)
+
+        def get_action_attrs(action: UnfoldAction) -> dict:
+            """
+            Returns the attributes for an action which will be used in the template.
+            """
+            return {
+                "title": action.description,
+                "icon": action.icon,
+                "attrs": action.method.attrs,
+                "path": get_action_path(action),
+            }
+
+        def build_dropdown(nav_item: dict) -> Optional[dict]:
+            """
+            Builds a dropdown structure for the action.
+            """
+            dropdown = {
+                "title": nav_item["title"],
+                "icon": nav_item.get("icon"),
+                "items": [],
+            }
+
+            for child in nav_item["items"]:
+                if action := get_action_by_name(child):
+                    dropdown["items"].append(get_action_attrs(action))
+
+            if len(dropdown["items"]) > 0:
+                return dropdown
+
+        for nav_item in provided_actions:
+            if isinstance(nav_item, str):
+                if action := get_action_by_name(nav_item):
+                    navigation.append(get_action_attrs(action))
+            elif isinstance(nav_item, dict):
+                if dropdown := build_dropdown(nav_item):
+                    navigation.append(dropdown)
+
+        return navigation
+
+    def _filter_unfold_actions_by_permissions(
+        self,
+        request: HttpRequest,
+        actions: list[UnfoldAction],
+        object_id: Optional[Union[int, str]] = None,
+    ) -> list[UnfoldAction]:
+        """
+        Filters out actions that the user doesn't have access to.
+        """
+        filtered_actions = []
+
+        for action in actions:
+            if not hasattr(action.method, "allowed_permissions"):
+                filtered_actions.append(action)
+                continue
+
+            permission_checks = (
+                getattr(self, f"has_{permission}_permission")
+                for permission in action.method.allowed_permissions
+            )
+
+            if object_id:
+                if all(
+                    has_permission(request, object_id)
+                    for has_permission in permission_checks
+                ):
+                    filtered_actions.append(action)
+            else:
+                if all(has_permission(request) for has_permission in permission_checks):
+                    filtered_actions.append(action)
+
+        return filtered_actions