arthexis 0.1.9__py3-none-any.whl → 0.1.26__py3-none-any.whl

core/admin_history.py

@@ -1,50 +1,50 @@
-import json
-from django.contrib.admin.options import ModelAdmin
-from django.contrib.admin.models import LogEntry
-from django.utils.encoding import smart_str
-
-
-def patch_admin_history():
-    if getattr(ModelAdmin, "_history_patched", False):
-        return
-
-    def construct_change_message(self, request, form, formsets, add=False):
-        fields = []
-        if add:
-            for name, value in form.cleaned_data.items():
-                fields.append({"field": name, "old": None, "new": smart_str(value)})
-            if not fields:
-                return ""
-            return json.dumps({"added": fields})
-        for name in form.changed_data:
-            fields.append(
-                {
-                    "field": name,
-                    "old": smart_str(form.initial.get(name)),
-                    "new": smart_str(form.cleaned_data.get(name)),
-                }
-            )
-        if not fields:
-            return ""
-        return json.dumps({"changed": fields})
-
-    def get_change_message(self):
-        try:
-            data = json.loads(self.change_message)
-        except Exception:
-            return self.change_message
-        if isinstance(data, dict):
-            if "added" in data:
-                parts = [f"{d['field']}='{d['new']}'" for d in data["added"]]
-                return "Added " + ", ".join(parts)
-            if "changed" in data:
-                parts = [
-                    f"{d['field']}: '{d['old']}' -> '{d['new']}'"
-                    for d in data["changed"]
-                ]
-                return "Changed " + ", ".join(parts)
-        return self.change_message
-
-    ModelAdmin.construct_change_message = construct_change_message
-    LogEntry.get_change_message = get_change_message
-    ModelAdmin._history_patched = True
+import json
+from django.contrib.admin.options import ModelAdmin
+from django.contrib.admin.models import LogEntry
+from django.utils.encoding import smart_str
+
+
+def patch_admin_history():
+    if getattr(ModelAdmin, "_history_patched", False):
+        return
+
+    def construct_change_message(self, request, form, formsets, add=False):
+        fields = []
+        if add:
+            for name, value in form.cleaned_data.items():
+                fields.append({"field": name, "old": None, "new": smart_str(value)})
+            if not fields:
+                return ""
+            return json.dumps({"added": fields})
+        for name in form.changed_data:
+            fields.append(
+                {
+                    "field": name,
+                    "old": smart_str(form.initial.get(name)),
+                    "new": smart_str(form.cleaned_data.get(name)),
+                }
+            )
+        if not fields:
+            return ""
+        return json.dumps({"changed": fields})
+
+    def get_change_message(self):
+        try:
+            data = json.loads(self.change_message)
+        except Exception:
+            return self.change_message
+        if isinstance(data, dict):
+            if "added" in data:
+                parts = [f"{d['field']}='{d['new']}'" for d in data["added"]]
+                return "Added " + ", ".join(parts)
+            if "changed" in data:
+                parts = [
+                    f"{d['field']}: '{d['old']}' -> '{d['new']}'"
+                    for d in data["changed"]
+                ]
+                return "Changed " + ", ".join(parts)
+        return self.change_message
+
+    ModelAdmin.construct_change_message = construct_change_message
+    LogEntry.get_change_message = get_change_message
+    ModelAdmin._history_patched = True

core/admindocs.py

@@ -1,151 +1,192 @@
-import argparse
-import inspect
-from types import SimpleNamespace
-
-from django.apps import apps
-from django.contrib import admin
-from django.core.management import get_commands, load_command_class
-from django.contrib.admindocs.views import (
-    BaseAdminDocsView,
-    user_has_model_view_permission,
-)
-from django.urls import NoReverseMatch, reverse
-
-
-class CommandsView(BaseAdminDocsView):
-    template_name = "admin_doc/commands.html"
-
-    def get_context_data(self, **kwargs):
-        commands = []
-        for name, app_name in sorted(get_commands().items()):
-            try:
-                cmd = load_command_class(app_name, name)
-                parser = cmd.create_parser("manage.py", name)
-            except Exception:  # pragma: no cover - command import issues
-                continue
-            args = []
-            options = []
-            for action in parser._actions:
-                if isinstance(action, argparse._HelpAction):
-                    continue
-                if action.option_strings:
-                    options.append(
-                        {
-                            "opts": ", ".join(action.option_strings),
-                            "help": action.help or "",
-                        }
-                    )
-                else:
-                    args.append(
-                        {
-                            "name": action.metavar or action.dest,
-                            "help": action.help or "",
-                        }
-                    )
-            commands.append(
-                {
-                    "name": name,
-                    "help": getattr(cmd, "help", ""),
-                    "args": args,
-                    "options": options,
-                }
-            )
-        return super().get_context_data(**{**kwargs, "commands": commands})
-
-
-class OrderedModelIndexView(BaseAdminDocsView):
-    template_name = "admin_doc/model_index.html"
-
-    GROUP_OVERRIDES = {
-        "ocpp.location": "core",
-        "core.rfid": "ocpp",
-        "core.package": "teams",
-        "core.packagerelease": "teams",
-    }
-
-    def _get_docs_app_config(self, meta):
-        override_label = self.GROUP_OVERRIDES.get(meta.label_lower)
-        if override_label:
-            return apps.get_app_config(override_label)
-        return meta.app_config
-
-    def get_context_data(self, **kwargs):
-        models = []
-        for m in apps.get_models():
-            if user_has_model_view_permission(self.request.user, m._meta):
-                meta = m._meta
-                meta.docstring = inspect.getdoc(m) or ""
-                app_config = self._get_docs_app_config(meta)
-                models.append(
-                    SimpleNamespace(
-                        app_label=meta.app_label,
-                        model_name=meta.model_name,
-                        object_name=meta.object_name,
-                        docstring=meta.docstring,
-                        app_config=app_config,
-                    )
-                )
-        models.sort(key=lambda m: str(m.app_config.verbose_name))
-        return super().get_context_data(**{**kwargs, "models": models})
-
-
-class ModelGraphIndexView(BaseAdminDocsView):
-    template_name = "admin_doc/model_graphs.html"
-
-    def get_context_data(self, **kwargs):
-        sections = {}
-        user = self.request.user
-
-        for model in admin.site._registry:
-            meta = model._meta
-            if not user_has_model_view_permission(user, meta):
-                continue
-
-            app_config = apps.get_app_config(meta.app_label)
-            section = sections.setdefault(
-                app_config.label,
-                {
-                    "app_label": app_config.label,
-                    "verbose_name": str(app_config.verbose_name),
-                    "models": [],
-                },
-            )
-
-            section["models"].append(
-                {
-                    "object_name": meta.object_name,
-                    "verbose_name": str(meta.verbose_name),
-                    "doc_url": reverse(
-                        "django-admindocs-models-detail",
-                        kwargs={
-                            "app_label": meta.app_label,
-                            "model_name": meta.model_name,
-                        },
-                    ),
-                }
-            )
-
-        graph_sections = []
-        for section in sections.values():
-            section_models = section["models"]
-            section_models.sort(key=lambda model: model["verbose_name"])
-
-            try:
-                app_list_url = reverse("admin:app_list", args=[section["app_label"]])
-            except NoReverseMatch:
-                app_list_url = ""
-
-            graph_sections.append(
-                {
-                    **section,
-                    "graph_url": reverse(
-                        "admin-model-graph", args=[section["app_label"]]
-                    ),
-                    "app_list_url": app_list_url,
-                    "model_count": len(section_models),
-                }
-            )
-
-        graph_sections.sort(key=lambda section: section["verbose_name"])
-
-        return super().get_context_data(**{**kwargs, "sections": graph_sections})
+import argparse
+import inspect
+from types import SimpleNamespace
+
+from django.apps import apps
+from django.contrib import admin
+from django.core.management import get_commands, load_command_class
+from django.contrib.admindocs.views import (
+    BaseAdminDocsView,
+    user_has_model_view_permission,
+)
+from django.shortcuts import render
+from django.template import loader
+from django.urls import NoReverseMatch, reverse
+from django.utils.translation import gettext_lazy as _
+from django.test import signals as test_signals
+
+
+class CommandsView(BaseAdminDocsView):
+    template_name = "admin_doc/commands.html"
+
+    def get_context_data(self, **kwargs):
+        commands = []
+        for name, app_name in sorted(get_commands().items()):
+            try:
+                cmd = load_command_class(app_name, name)
+                parser = cmd.create_parser("manage.py", name)
+            except Exception:  # pragma: no cover - command import issues
+                continue
+            args = []
+            options = []
+            for action in parser._actions:
+                if isinstance(action, argparse._HelpAction):
+                    continue
+                if action.option_strings:
+                    options.append(
+                        {
+                            "opts": ", ".join(action.option_strings),
+                            "help": action.help or "",
+                        }
+                    )
+                else:
+                    args.append(
+                        {
+                            "name": action.metavar or action.dest,
+                            "help": action.help or "",
+                        }
+                    )
+            commands.append(
+                {
+                    "name": name,
+                    "help": getattr(cmd, "help", ""),
+                    "args": args,
+                    "options": options,
+                }
+            )
+        return super().get_context_data(**{**kwargs, "commands": commands})
+
+
+class OrderedModelIndexView(BaseAdminDocsView):
+    template_name = "admin_doc/model_index.html"
+
+    USER_MANUALS_APP = SimpleNamespace(
+        label="manuals",
+        name="manuals",
+        verbose_name=_("User Manuals"),
+    )
+
+    GROUP_OVERRIDES = {
+        "ocpp.location": "core",
+        "core.rfid": "ocpp",
+        "core.package": "teams",
+        "core.packagerelease": "teams",
+        "core.todo": "teams",
+        "pages.usermanual": USER_MANUALS_APP,
+    }
+
+    def _get_docs_app_config(self, meta):
+        override = self.GROUP_OVERRIDES.get(meta.label_lower)
+        if override:
+            if isinstance(override, str):
+                return apps.get_app_config(override)
+            return override
+        return meta.app_config
+
+    def get_context_data(self, **kwargs):
+        models = []
+        for m in apps.get_models():
+            if user_has_model_view_permission(self.request.user, m._meta):
+                meta = m._meta
+                meta.docstring = inspect.getdoc(m) or ""
+                app_config = self._get_docs_app_config(meta)
+                models.append(
+                    SimpleNamespace(
+                        app_label=meta.app_label,
+                        model_name=meta.model_name,
+                        object_name=meta.object_name,
+                        docstring=meta.docstring,
+                        app_config=app_config,
+                    )
+                )
+        models.sort(key=lambda m: str(m.app_config.verbose_name))
+        return super().get_context_data(**{**kwargs, "models": models})
+
+
+class ModelGraphIndexView(BaseAdminDocsView):
+    template_name = "admin_doc/model_graphs.html"
+
+    def render_to_response(self, context, **response_kwargs):
+        template_name = response_kwargs.pop("template_name", None)
+        if template_name is None:
+            template_name = self.get_template_names()
+        response = render(
+            self.request,
+            template_name,
+            context,
+            **response_kwargs,
+        )
+        if getattr(response, "context", None) is None:
+            response.context = context
+        if test_signals.template_rendered.receivers:
+            if isinstance(template_name, (list, tuple)):
+                template = loader.select_template(template_name)
+            else:
+                template = loader.get_template(template_name)
+            signal_context = context
+            if self.request is not None and "request" not in signal_context:
+                signal_context = {**context, "request": self.request}
+            test_signals.template_rendered.send(
+                sender=template.__class__,
+                template=template,
+                context=signal_context,
+            )
+        return response
+
+    def get_context_data(self, **kwargs):
+        sections = {}
+        user = self.request.user
+
+        for model in admin.site._registry:
+            meta = model._meta
+            if not user_has_model_view_permission(user, meta):
+                continue
+
+            app_config = apps.get_app_config(meta.app_label)
+            section = sections.setdefault(
+                app_config.label,
+                {
+                    "app_label": app_config.label,
+                    "verbose_name": str(app_config.verbose_name),
+                    "models": [],
+                },
+            )
+
+            section["models"].append(
+                {
+                    "object_name": meta.object_name,
+                    "verbose_name": str(meta.verbose_name),
+                    "doc_url": reverse(
+                        "django-admindocs-models-detail",
+                        kwargs={
+                            "app_label": meta.app_label,
+                            "model_name": meta.model_name,
+                        },
+                    ),
+                }
+            )
+
+        graph_sections = []
+        for section in sections.values():
+            section_models = section["models"]
+            section_models.sort(key=lambda model: model["verbose_name"])
+
+            try:
+                app_list_url = reverse("admin:app_list", args=[section["app_label"]])
+            except NoReverseMatch:
+                app_list_url = ""
+
+            graph_sections.append(
+                {
+                    **section,
+                    "graph_url": reverse(
+                        "admin-model-graph", args=[section["app_label"]]
+                    ),
+                    "app_list_url": app_list_url,
+                    "model_count": len(section_models),
+                }
+            )
+
+        graph_sections.sort(key=lambda section: section["verbose_name"])
+
+        return super().get_context_data(**{**kwargs, "sections": graph_sections})