django-cfg 1.0.3__tar.gz

django_cfg-1.0.3/.gitignore

@@ -0,0 +1,41 @@
+
+vercel
+*.log
+*.pyc
+__pycache__
+
+# Ignore SQLite database files
+db.sqlite3
+
+.DS_Store
+cache
+
+# Environments
+.env*
+.env.openrouter
+.venv
+env
+.env.openrouter
+venv
+ENV
+env.bak/
+venv.bak/
+
+node_modules
+yarn-error.log
+yarn.lock
+package-lock.json
+
+.pytest_cache
+
+# For pypi package
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+*.pyw
+*.pyz
+*.pywz
+*.pyzw
+*.egg-info/
+

django_cfg-1.0.3/@unfold/code/admin.py

@@ -0,0 +1,229 @@
+from functools import update_wrapper
+from typing import Any, 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.contrib.admin.options import InlineModelAdmin
+from django.contrib.contenttypes.admin import (
+    GenericStackedInline as BaseGenericStackedInline,
+)
+from django.contrib.contenttypes.admin import (
+    GenericTabularInline as BaseGenericTabularInline,
+)
+from django.db.models import BLANK_CHOICE_DASH, Model
+from django.http import HttpRequest, HttpResponse
+from django.shortcuts import redirect
+from django.template.response import TemplateResponse
+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.forms import (
+    ActionForm,
+    PaginationGenericInlineFormSet,
+    PaginationInlineFormSet,
+)
+from unfold.mixins import ActionModelAdminMixin, BaseModelAdminMixin
+from unfold.overrides import FORMFIELD_OVERRIDES_INLINE
+from unfold.typing import FieldsetsType
+from unfold.views import ChangeList
+from unfold.widgets import UnfoldBooleanWidget
+
+checkbox = UnfoldBooleanWidget(
+    {
+        "class": "action-select",
+        "aria-label": _("Select record"),
+    },
+    lambda value: False,
+)
+
+
+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
+
+    def changelist_view(
+        self, request: HttpRequest, extra_context: Optional[dict[str, str]] = None
+    ) -> TemplateResponse:
+        additional_media = forms.Media()
+
+        for filter in self.get_list_filter(request):
+            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)
+
+        if not extra_context:
+            extra_context = {}
+
+        extra_context.update(
+            {
+                "media": self.media + additional_media,
+            }
+        )
+
+        return super().changelist_view(request, extra_context)
+
+    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
+
+    def get_changelist(self, request, **kwargs):
+        return ChangeList
+
+    def get_formset_kwargs(
+        self, request: HttpRequest, obj: Model, inline: InlineModelAdmin, prefix: str
+    ) -> dict[str, Any]:
+        formset_kwargs = super().get_formset_kwargs(request, obj, inline, prefix)
+
+        if hasattr(inline, "per_page"):
+            formset_kwargs["request"] = request
+            formset_kwargs["per_page"] = inline.per_page
+
+        return formset_kwargs
+
+
+class BaseInlineMixin:
+    formfield_overrides = FORMFIELD_OVERRIDES_INLINE
+    readonly_preprocess_fields = {}
+    ordering_field = None
+    per_page = None
+    hide_ordering_field = False
+    collapsible = False
+
+
+class TabularInline(BaseInlineMixin, BaseModelAdminMixin, BaseTabularInline):
+    formset = PaginationInlineFormSet
+
+
+class StackedInline(BaseInlineMixin, BaseModelAdminMixin, BaseStackedInline):
+    formset = PaginationInlineFormSet
+
+
+class GenericStackedInline(
+    BaseInlineMixin, BaseModelAdminMixin, BaseGenericStackedInline
+):
+    formset = PaginationGenericInlineFormSet
+
+
+class GenericTabularInline(
+    BaseInlineMixin, BaseModelAdminMixin, BaseGenericTabularInline
+):
+    formset = PaginationGenericInlineFormSet

django_cfg-1.0.3/@unfold/code/apps.py

@@ -0,0 +1,20 @@
+from django.apps import AppConfig
+from django.contrib import admin
+from django.contrib.admin import sites
+
+from .sites import UnfoldAdminSite
+
+
+class DefaultAppConfig(AppConfig):
+    name = "unfold"
+    default = True
+
+    def ready(self):
+        site = UnfoldAdminSite()
+
+        admin.site = site
+        sites.site = site
+
+
+class BasicAppConfig(AppConfig):
+    name = "unfold"

django_cfg-1.0.3/@unfold/code/checks.py

@@ -0,0 +1,64 @@
+from typing import Any
+
+from django.contrib.admin.checks import ModelAdminChecks
+from django.contrib.admin.options import BaseModelAdmin
+from django.contrib.auth.models import Permission
+from django.core import checks
+
+from unfold.dataclasses import UnfoldAction
+
+
+class UnfoldModelAdminChecks(ModelAdminChecks):
+    def check(self, admin_obj: BaseModelAdmin, **kwargs) -> list[checks.Error]:
+        return [
+            *super().check(admin_obj, **kwargs),
+            *self._check_unfold_action_permission_methods(admin_obj),
+        ]
+
+    def _check_unfold_action_permission_methods(self, obj: Any) -> list[checks.Error]:
+        """
+        Actions with an allowed_permission attribute require the ModelAdmin to
+        implement a has_<perm>_permission() method for each permission.
+        """
+        actions: list[UnfoldAction] = [
+            *obj._get_base_actions_list(),
+            *obj._get_base_actions_detail(),
+            *obj._get_base_actions_row(),
+            *obj._get_base_actions_submit_line(),
+        ]
+        errors = []
+        for action in actions:
+            if not hasattr(action.method, "allowed_permissions"):
+                continue
+
+            for permission in action.method.allowed_permissions:
+                # Check the existence of Django permission
+                if "." in permission:
+                    app_label, codename = permission.split(".")
+
+                    if not Permission.objects.filter(
+                        content_type__app_label=app_label,
+                        codename=codename,
+                    ).exists():
+                        errors.append(
+                            checks.Error(
+                                f"@action decorator on {action.method.original_function_name}() in class {obj.__class__.__name__} specifies permission {permission} which does not exists.",
+                                obj=obj.__class__,
+                                id="admin.E129",
+                            )
+                        )
+
+                    continue
+
+                # Check the permission method existence
+                method_name = f"has_{permission}_permission"
+                if not hasattr(obj, method_name):
+                    errors.append(
+                        checks.Error(
+                            f"{obj.__class__.__name__} must define a {method_name}() method for the {action.method.original_function_name}() action.",
+                            obj=obj.__class__,
+                            id="admin.E129",
+                        )
+                    )
+
+        return errors

django_cfg-1.0.3/@unfold/code/components.py

@@ -0,0 +1,47 @@
+from typing import Any, Optional
+
+from django.http import HttpRequest
+
+
+class ComponentRegistry:
+    _registry: dict[str, type] = {}
+
+    @classmethod
+    def register_class(cls, component_cls: type) -> None:
+        if not issubclass(component_cls, BaseComponent):
+            raise ValueError(
+                f"Class '{component_cls.__name__}' must inherit from BaseComponent."
+            )
+
+        class_name = component_cls.__name__
+
+        if class_name in cls._registry:
+            raise ValueError(f"Class '{class_name}' is already registered.")
+
+        cls._registry[class_name] = component_cls
+
+    @classmethod
+    def get_class(cls, class_name: str) -> Optional[type]:
+        return cls._registry.get(class_name)
+
+    @classmethod
+    def create_instance(cls, class_name: str, **kwargs: Any) -> Any:
+        component_cls = cls.get_class(class_name)
+
+        if component_cls is None:
+            raise ValueError(f"Class '{class_name}' is not registered.")
+
+        return component_cls(**kwargs)
+
+
+def register_component(cls: type) -> type:
+    ComponentRegistry.register_class(cls)
+    return cls
+
+
+class BaseComponent:
+    def __init__(self, request: HttpRequest):
+        self.request = request
+
+    def get_context_data(self, **kwargs):
+        return kwargs

django_cfg-1.0.3/@unfold/code/contrib/constance/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class ConstanceConfig(AppConfig):
+    name = "unfold.contrib.constance"
+    label = "unfold_constance"

django_cfg-1.0.3/@unfold/code/contrib/constance/settings.py

@@ -0,0 +1,32 @@
+UNFOLD_CONSTANCE_ADDITIONAL_FIELDS = {
+    str: [
+        "django.forms.CharField",
+        {
+            "widget": "unfold.widgets.UnfoldAdminTextInputWidget",
+        },
+    ],
+    int: [
+        "django.forms.IntegerField",
+        {
+            "widget": "unfold.widgets.UnfoldAdminIntegerFieldWidget",
+        },
+    ],
+    bool: [
+        "django.forms.BooleanField",
+        {
+            "widget": "unfold.widgets.UnfoldBooleanSwitchWidget",
+        },
+    ],
+    "file_field": [
+        "django.forms.fields.FileField",
+        {
+            "widget": "unfold.widgets.UnfoldAdminFileFieldWidget",
+        },
+    ],
+    "image_field": [
+        "django.forms.fields.ImageField",
+        {
+            "widget": "unfold.widgets.UnfoldAdminImageFieldWidget",
+        },
+    ],
+}

django_cfg-1.0.3/@unfold/code/contrib/constance/templates/admin/constance/change_list.html

@@ -0,0 +1,70 @@
+{% extends "admin/base_site.html" %}
+
+{% load admin_list static i18n %}
+
+{% block extrahead %}
+    {% url 'admin:jsi18n' as jsi18nurl %}
+    <script type="text/javascript" src="{{ jsi18nurl|default:'../../jsi18n/' }}"></script>
+    {{ block.super }}
+    {{ media.js }}
+    <script type="text/javascript" src="{% static 'admin/js/constance.js' %}"></script>
+{% endblock %}
+
+{% block breadcrumbs %}
+    <div class="px-4">
+        <div class="container mb-6 mx-auto -my-3 lg:mb-12">
+            <ul class="flex flex-wrap">
+                {% url 'admin:index' as link %}
+                {% trans 'Home' as name %}
+                {% include 'unfold/helpers/breadcrumb_item.html' with link=link name=name %}
+
+                {% url 'admin:app_list' app_label=opts.app_label as link %}
+                {% include 'unfold/helpers/breadcrumb_item.html' with link=link name=opts.app_config.verbose_name %}
+
+                {% include 'unfold/helpers/breadcrumb_item.html' with link='' name=opts.verbose_name_plural|capfirst %}
+            </ul>
+        </div>
+    </div>
+{% endblock %}
+
+
+{% block content %}
+    <div id="content-main" class="constance">
+        <div id="changelist" class="flex flex-col gap-8 w-full">
+            <form id="changelist-form" action="" method="post" enctype="multipart/form-data" novalidate class="flex flex-col gap-8 w-full">
+                {% csrf_token %}
+
+                {% include "unfold/helpers/form_errors.html" with errors=form.non_field_errors %}
+
+                {% for field in form.hidden_fields %}
+                    {{ field }}
+                {% endfor %}
+
+                {% if fieldsets %}
+                    <div class="border border-base-200 rounded-default overflow-x-auto simplebar-horizontal-scrollbar-top dark:border-base-800" data-simplebar data-simplebar-auto-hide="false">
+                        <table class="w-full border-collapse">
+                            {% for fieldset in fieldsets %}
+                                {% with config_values=fieldset.config_values %}
+                                    {% include "admin/constance/includes/results_list.html" %}
+                                {% endwith %}
+                            {% endfor %}
+
+                            <tfoot>
+                                <tr>
+                                    <td class="border-t border-base-200 px-3 py-2 dark:border-base-800" colspan="100%">
+                                        <div class="flex justify-end">
+                                            {% trans "Save" as title %}
+                                            {% include "unfold/helpers/submit.html" with title=title %}
+                                        </div>
+                                    </td>
+                                </tr>
+                            </tfoot>
+                        </table>
+                    </div>
+                {% else %}
+                    {% include "admin/constance/includes/results_list.html" %}
+                {% endif %}
+            </form>
+        </div>
+    </div>
+{% endblock %}

django_cfg-1.0.3/@unfold/code/contrib/constance/templates/admin/constance/includes/results_list.html

@@ -0,0 +1,71 @@
+{% load admin_list static i18n %}
+
+<tbody {% if fieldset.collapse %} x-data="{ rowsOpen: false }" {% endif %}>
+    <tr {% if fieldset.collapse %} x-on:click="rowsOpen = !rowsOpen" {% endif %} class="{% if fieldset.collapse %}cursor-pointer{% endif %}">
+        <th class="bg-base-50 border-t border-base-200 font-semibold px-3 py-2 text-left text-font-important-light dark:text-font-important-dark dark:border-base-800 dark:bg-white/[.04] {% if forloop.first %}border-t-0{% endif %}" colspan="100%">
+            {{ fieldset.title }}
+
+            {% if fieldset.collapse %}
+                <span class="material-symbols-outlined float-right select-none transition-all" title="{% trans "Collapse" %}" x-bind:class="rowsOpen ? 'rotate-180' : ''">
+                    expand_more
+                </span>
+            {% endif %}
+        </th>
+    </tr>
+
+    <tr class="border-t border-base-200 dark:border-base-800 *:font-semibold *:px-3 *:py-2 *:text-left *:text-font-important-light dark:*:text-font-important-dark" {% if fieldset.collapse %}x-show="rowsOpen"{% endif %}>
+        <th>{% trans "Name" %}</th>
+        <th>{% trans "Value" %}</th>
+        <th>{% trans "Default" %}</th>
+        <th>{% trans "Code" %}</th>
+        <th>{% trans "Modified" %}</th>
+        <th></th>
+    </tr>
+
+    {% for item in config_values %}
+        <tr class="border-t border-base-200 h-[55px] *:px-3 *:py-2 *:align-middle dark:border-base-800" {% if fieldset.collapse %}x-show="rowsOpen"{% endif %}>
+            <th class="font-normal text-left">
+                {{ item.help_text|linebreaksbr }}
+            </th>
+
+            <td class="{% if item.form_field.errors %}group errors{% endif %}">
+                {{ item.form_field }}
+
+                {% include "unfold/helpers/form_errors.html" with errors=item.form_field.errors %}
+            </td>
+
+            <td>
+                {% if item.default %}
+                    {% include "unfold/helpers/label.html" with text=item.default %}
+                {% else %}
+                    -
+                {% endif %}
+            </td>
+
+            <td>
+                <a class="item-name item-anchor" href="#{{ item.name|slugify }}" tabindex="-1" id="{{ item.name|slugify }}" title="Link to this setting">
+                    {% include "unfold/helpers/label.html" with text=item.name type="info" %}
+                </a>
+            </td>
+
+            <td>
+                {% include "unfold/helpers/boolean.html" with value=item.modified %}
+            </td>
+
+            <td class="w-px">
+                {% if not item.is_file %}
+                    <a href="#"
+                       tabindex="-1"
+                       class="flex items-center gap-1 reset-link whitespace-nowrap"
+                       data-default="{% spaceless %}{% if item.is_checkbox %}{% if item.raw_default %} true {% else %} false {% endif %}{% elif item.is_date %}{{ item.raw_default|date:"U" }}{% elif item.is_datetime %}{{ item.raw_default|date:"U" }}{% else %}{{ item.default }}{% endif %}{% endspaceless %}"
+                       data-field-type="{% spaceless %}{% if item.is_checkbox %}checkbox{% elif item.is_datetime %}datetime{% elif item.is_date %}date{% endif %}{% endspaceless %}"
+                       data-field-id="{{ item.form_field.auto_id }}">
+                        <span class="material-symbols-outlined text-base-400 hover:text-base-700  dark:border-base-700 dark:text-base-500 dark:hover:text-base-200" title="{% trans "Reset to default" %}">
+                            refresh
+                        </span>
+                    </a>
+                {% endif %}
+            </td>
+        </tr>
+    {% endfor %}
+</tbody>

django_cfg-1.0.3/@unfold/code/contrib/filters/admin/__init__.py

@@ -0,0 +1,60 @@
+from unfold.contrib.filters.admin.autocomplete_filters import (
+    AutocompleteSelectFilter,
+    AutocompleteSelectMultipleFilter,
+)
+from unfold.contrib.filters.admin.choice_filters import (
+    AllValuesCheckboxFilter,
+    BooleanRadioFilter,
+    CheckboxFilter,
+    ChoicesCheckboxFilter,
+    ChoicesRadioFilter,
+    RadioFilter,
+    RelatedCheckboxFilter,
+)
+from unfold.contrib.filters.admin.datetime_filters import (
+    RangeDateFilter,
+    RangeDateTimeFilter,
+)
+from unfold.contrib.filters.admin.dropdown_filters import (
+    ChoicesDropdownFilter,
+    DropdownFilter,
+    MultipleChoicesDropdownFilter,
+    MultipleDropdownFilter,
+    MultipleRelatedDropdownFilter,
+    RelatedDropdownFilter,
+)
+from unfold.contrib.filters.admin.numeric_filters import (
+    RangeNumericFilter,
+    RangeNumericListFilter,
+    SingleNumericFilter,
+    SliderNumericFilter,
+)
+from unfold.contrib.filters.admin.text_filters import FieldTextFilter, TextFilter
+
+__all__ = [
+    "AllValuesCheckboxFilter",
+    "BooleanRadioFilter",
+    "CheckboxFilter",
+    "ChoicesCheckboxFilter",
+    "ChoicesRadioFilter",
+    "MultipleRelatedCheckboxFilter",
+    "RadioFilter",
+    "ChoicesDropdownFilter",
+    "MultipleChoicesDropdownFilter",
+    "DropdownFilter",
+    "RelatedDropdownFilter",
+    "MultipleDropdownFilter",
+    "MultipleRelatedDropdownFilter",
+    "RelatedCheckboxFilter",
+    "FieldTextFilter",
+    "TextFilter",
+    "RangeDateFilter",
+    "RangeDateFilter",
+    "RangeDateTimeFilter",
+    "SingleNumericFilter",
+    "RangeNumericFilter",
+    "RangeNumericListFilter",
+    "SliderNumericFilter",
+    "AutocompleteSelectFilter",
+    "AutocompleteSelectMultipleFilter",
+]

django_cfg-1.0.3/@unfold/code/contrib/filters/admin/autocomplete_filters.py

@@ -0,0 +1,16 @@
+from unfold.contrib.filters.admin.dropdown_filters import (
+    MultipleRelatedDropdownFilter,
+    RelatedDropdownFilter,
+)
+from unfold.contrib.filters.admin.mixins import AutocompleteMixin
+from unfold.contrib.filters.forms import AutocompleteDropdownForm
+
+
+class AutocompleteSelectFilter(AutocompleteMixin, RelatedDropdownFilter):
+    form_class = AutocompleteDropdownForm
+
+
+class AutocompleteSelectMultipleFilter(
+    AutocompleteMixin, MultipleRelatedDropdownFilter
+):
+    form_class = AutocompleteDropdownForm