django-dynamic-template 0.1.0__tar.gz

django_dynamic_template-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Octolo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

django_dynamic_template-0.1.0/PKG-INFO

@@ -0,0 +1,110 @@
+Metadata-Version: 2.4
+Name: django-dynamic-template
+Version: 0.1.0
+Summary: Django app for content-type–scoped dynamic templates with NamedID slugs
+Author-email: Octolo <dev@octolo.tech>
+License-Expression: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: Django
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django>=3.2
+Requires-Dist: django-namedid>=0.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.3; extra == "dev"
+Requires-Dist: pytest-django>=4.5; extra == "dev"
+Requires-Dist: django-virtualqueryset>=0.1.1; extra == "dev"
+Requires-Dist: django-boosted>=1.0.0; extra == "dev"
+Requires-Dist: django-richtextfield>=1.6; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: django-stubs>=5.0.0; extra == "dev"
+Dynamic: license-file
+
+# django-dynamic-template
+
+Django app for **content-type–scoped dynamic templates**: store DTL fragments in the database, address them with a **`named_id`** slug ([django-namedid](https://github.com/octolo/django-namedid)), inject optional **related querysets** and a structured **`object`** dict into each fragment.
+
+## Requirements
+
+- Python ≥ 3.10  
+- Django ≥ 3.2  
+- **django-namedid** ≥ 0.1.0 (installed automatically via `pyproject.toml`)
+
+## Installation
+
+From the repository root (editable install recommended for local work):
+
+```bash
+pip install -e .
+```
+
+Add the app and dependencies you need:
+
+```python
+INSTALLED_APPS = [
+    # ...
+    "dynamic_template",
+]
+```
+
+Optional: **django-boosted** (admin preview), **django-richtextfield** (TinyMCE-style widget) — see `pyproject.toml` `[project.optional-dependencies]` **dev**.
+
+## Concepts
+
+| Piece | Role |
+|--------|------|
+| **`DynamicTemplate`** | `label`, `content_type`, `named_id`, `template` (richtext), plus `model_fields`, `annotate_fields`, `fields` shaping **`object`** in the fragment |
+| **`DynamicRelationContext`** | Related queryset (manager + filters), same three JSON fields per **row**; rows are **tuples of dicts** in the fragment |
+| **`{% dyntpl %}`** | Loads a template by `named_id`, merges context, evaluates relation contexts, then replaces **`object`** with a plain **dict** |
+
+- **`model_fields`**: ORM column names (empty → all concrete fields on the model).  
+- **`annotate_fields`**: list of annotation **aliases** already on the queryset / instance — this app does **not** call `.annotate()`; your manager or view must provide them.  
+- **`fields`**: extra Python names resolved with **`getattr`** (`@property`, class attributes, methods).
+
+Filters on relations: **`filter_spec`** (resolved from **`object`** + template context) and **`filter_literal`** (static ORM kwargs). See **`docs/purpose.md`** for full detail.
+
+## Template tag
+
+```django
+{% load dyntpl %}
+
+{% dyntpl "my-block-named-id" %}
+{% dyntpl tpl_id obj=article %}
+{% dyntpl tpl_id ctype=Product obj=product %}
+```
+
+- **`obj=`**: must match the template’s `content_type`.  
+- **`ctype=`**: disambiguates when the same `named_id` exists for several models.  
+- Other keyword arguments are merged into the **inner** fragment context.
+
+In the fragment, use **`{{ object.name }}`**, **`{% for row in article %}{{ row.title }}{% endfor %}`**, **`{{ rows|length }}`** (not `.count` on querysets).
+
+## Settings (optional)
+
+```python
+# Import path to a widget class for the template field in admin
+DYNAMIC_TEMPLATE_RICHTEXT_WIDGET = "djrichtextfield.widgets.RichTextWidget"
+```
+
+## Development
+
+```bash
+pytest
+```
+
+`pyproject.toml` sets `DJANGO_SETTINGS_MODULE=tests.settings` and `pythonpath=["src"]`.
+
+Apply migrations for the bundled test project:
+
+```bash
+PYTHONPATH=src DJANGO_SETTINGS_MODULE=tests.settings python manage.py migrate
+```
+
+More detail: **`docs/`** (`purpose.md`, `structure.md`, `development.md`).
+
+## License
+
+MIT

django_dynamic_template-0.1.0/README.md

@@ -0,0 +1,85 @@
+# django-dynamic-template
+
+Django app for **content-type–scoped dynamic templates**: store DTL fragments in the database, address them with a **`named_id`** slug ([django-namedid](https://github.com/octolo/django-namedid)), inject optional **related querysets** and a structured **`object`** dict into each fragment.
+
+## Requirements
+
+- Python ≥ 3.10  
+- Django ≥ 3.2  
+- **django-namedid** ≥ 0.1.0 (installed automatically via `pyproject.toml`)
+
+## Installation
+
+From the repository root (editable install recommended for local work):
+
+```bash
+pip install -e .
+```
+
+Add the app and dependencies you need:
+
+```python
+INSTALLED_APPS = [
+    # ...
+    "dynamic_template",
+]
+```
+
+Optional: **django-boosted** (admin preview), **django-richtextfield** (TinyMCE-style widget) — see `pyproject.toml` `[project.optional-dependencies]` **dev**.
+
+## Concepts
+
+| Piece | Role |
+|--------|------|
+| **`DynamicTemplate`** | `label`, `content_type`, `named_id`, `template` (richtext), plus `model_fields`, `annotate_fields`, `fields` shaping **`object`** in the fragment |
+| **`DynamicRelationContext`** | Related queryset (manager + filters), same three JSON fields per **row**; rows are **tuples of dicts** in the fragment |
+| **`{% dyntpl %}`** | Loads a template by `named_id`, merges context, evaluates relation contexts, then replaces **`object`** with a plain **dict** |
+
+- **`model_fields`**: ORM column names (empty → all concrete fields on the model).  
+- **`annotate_fields`**: list of annotation **aliases** already on the queryset / instance — this app does **not** call `.annotate()`; your manager or view must provide them.  
+- **`fields`**: extra Python names resolved with **`getattr`** (`@property`, class attributes, methods).
+
+Filters on relations: **`filter_spec`** (resolved from **`object`** + template context) and **`filter_literal`** (static ORM kwargs). See **`docs/purpose.md`** for full detail.
+
+## Template tag
+
+```django
+{% load dyntpl %}
+
+{% dyntpl "my-block-named-id" %}
+{% dyntpl tpl_id obj=article %}
+{% dyntpl tpl_id ctype=Product obj=product %}
+```
+
+- **`obj=`**: must match the template’s `content_type`.  
+- **`ctype=`**: disambiguates when the same `named_id` exists for several models.  
+- Other keyword arguments are merged into the **inner** fragment context.
+
+In the fragment, use **`{{ object.name }}`**, **`{% for row in article %}{{ row.title }}{% endfor %}`**, **`{{ rows|length }}`** (not `.count` on querysets).
+
+## Settings (optional)
+
+```python
+# Import path to a widget class for the template field in admin
+DYNAMIC_TEMPLATE_RICHTEXT_WIDGET = "djrichtextfield.widgets.RichTextWidget"
+```
+
+## Development
+
+```bash
+pytest
+```
+
+`pyproject.toml` sets `DJANGO_SETTINGS_MODULE=tests.settings` and `pythonpath=["src"]`.
+
+Apply migrations for the bundled test project:
+
+```bash
+PYTHONPATH=src DJANGO_SETTINGS_MODULE=tests.settings python manage.py migrate
+```
+
+More detail: **`docs/`** (`purpose.md`, `structure.md`, `development.md`).
+
+## License
+
+MIT

django_dynamic_template-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "django-dynamic-template"
+version = "0.1.0"
+description = "Django app for content-type–scoped dynamic templates with NamedID slugs"
+readme = "README.md"
+authors = [{ name = "Octolo", email = "dev@octolo.tech" }]
+license = "MIT"
+requires-python = ">=3.10"
+dependencies = [
+    "Django>=3.2",
+    "django-namedid>=0.1.0",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Framework :: Django",
+    "Programming Language :: Python :: 3",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.3",
+    "pytest-django>=4.5",
+    "django-virtualqueryset>=0.1.1",
+    "django-boosted>=1.0.0",
+    "django-richtextfield>=1.6",
+    "ruff>=0.5",
+    "mypy>=1.0",
+    "django-stubs>=5.0.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["dynamic_template*"]
+
+[tool.pytest.ini_options]
+DJANGO_SETTINGS_MODULE = "tests.settings"
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+plugins = ["mypy_django_plugin.main"]
+mypy_path = "src"
+
+[tool.django-stubs]
+django_settings_module = "tests.settings"
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"

django_dynamic_template-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

django_dynamic_template-0.1.0/src/django_dynamic_template.egg-info/PKG-INFO

@@ -0,0 +1,110 @@
+Metadata-Version: 2.4
+Name: django-dynamic-template
+Version: 0.1.0
+Summary: Django app for content-type–scoped dynamic templates with NamedID slugs
+Author-email: Octolo <dev@octolo.tech>
+License-Expression: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: Django
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django>=3.2
+Requires-Dist: django-namedid>=0.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.3; extra == "dev"
+Requires-Dist: pytest-django>=4.5; extra == "dev"
+Requires-Dist: django-virtualqueryset>=0.1.1; extra == "dev"
+Requires-Dist: django-boosted>=1.0.0; extra == "dev"
+Requires-Dist: django-richtextfield>=1.6; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: django-stubs>=5.0.0; extra == "dev"
+Dynamic: license-file
+
+# django-dynamic-template
+
+Django app for **content-type–scoped dynamic templates**: store DTL fragments in the database, address them with a **`named_id`** slug ([django-namedid](https://github.com/octolo/django-namedid)), inject optional **related querysets** and a structured **`object`** dict into each fragment.
+
+## Requirements
+
+- Python ≥ 3.10  
+- Django ≥ 3.2  
+- **django-namedid** ≥ 0.1.0 (installed automatically via `pyproject.toml`)
+
+## Installation
+
+From the repository root (editable install recommended for local work):
+
+```bash
+pip install -e .
+```
+
+Add the app and dependencies you need:
+
+```python
+INSTALLED_APPS = [
+    # ...
+    "dynamic_template",
+]
+```
+
+Optional: **django-boosted** (admin preview), **django-richtextfield** (TinyMCE-style widget) — see `pyproject.toml` `[project.optional-dependencies]` **dev**.
+
+## Concepts
+
+| Piece | Role |
+|--------|------|
+| **`DynamicTemplate`** | `label`, `content_type`, `named_id`, `template` (richtext), plus `model_fields`, `annotate_fields`, `fields` shaping **`object`** in the fragment |
+| **`DynamicRelationContext`** | Related queryset (manager + filters), same three JSON fields per **row**; rows are **tuples of dicts** in the fragment |
+| **`{% dyntpl %}`** | Loads a template by `named_id`, merges context, evaluates relation contexts, then replaces **`object`** with a plain **dict** |
+
+- **`model_fields`**: ORM column names (empty → all concrete fields on the model).  
+- **`annotate_fields`**: list of annotation **aliases** already on the queryset / instance — this app does **not** call `.annotate()`; your manager or view must provide them.  
+- **`fields`**: extra Python names resolved with **`getattr`** (`@property`, class attributes, methods).
+
+Filters on relations: **`filter_spec`** (resolved from **`object`** + template context) and **`filter_literal`** (static ORM kwargs). See **`docs/purpose.md`** for full detail.
+
+## Template tag
+
+```django
+{% load dyntpl %}
+
+{% dyntpl "my-block-named-id" %}
+{% dyntpl tpl_id obj=article %}
+{% dyntpl tpl_id ctype=Product obj=product %}
+```
+
+- **`obj=`**: must match the template’s `content_type`.  
+- **`ctype=`**: disambiguates when the same `named_id` exists for several models.  
+- Other keyword arguments are merged into the **inner** fragment context.
+
+In the fragment, use **`{{ object.name }}`**, **`{% for row in article %}{{ row.title }}{% endfor %}`**, **`{{ rows|length }}`** (not `.count` on querysets).
+
+## Settings (optional)
+
+```python
+# Import path to a widget class for the template field in admin
+DYNAMIC_TEMPLATE_RICHTEXT_WIDGET = "djrichtextfield.widgets.RichTextWidget"
+```
+
+## Development
+
+```bash
+pytest
+```
+
+`pyproject.toml` sets `DJANGO_SETTINGS_MODULE=tests.settings` and `pythonpath=["src"]`.
+
+Apply migrations for the bundled test project:
+
+```bash
+PYTHONPATH=src DJANGO_SETTINGS_MODULE=tests.settings python manage.py migrate
+```
+
+More detail: **`docs/`** (`purpose.md`, `structure.md`, `development.md`).
+
+## License
+
+MIT

django_dynamic_template-0.1.0/src/django_dynamic_template.egg-info/SOURCES.txt

@@ -0,0 +1,28 @@
+LICENSE
+README.md
+pyproject.toml
+src/django_dynamic_template.egg-info/PKG-INFO
+src/django_dynamic_template.egg-info/SOURCES.txt
+src/django_dynamic_template.egg-info/dependency_links.txt
+src/django_dynamic_template.egg-info/requires.txt
+src/django_dynamic_template.egg-info/top_level.txt
+src/dynamic_template/__init__.py
+src/dynamic_template/apps.py
+src/dynamic_template/fields.py
+src/dynamic_template/io.py
+src/dynamic_template/rendering.py
+src/dynamic_template/resolve.py
+src/dynamic_template/admin/__init__.py
+src/dynamic_template/admin/relation_context.py
+src/dynamic_template/admin/template.py
+src/dynamic_template/migrations/0001_initial.py
+src/dynamic_template/migrations/__init__.py
+src/dynamic_template/models/__init__.py
+src/dynamic_template/models/_helpers.py
+src/dynamic_template/models/relation_context.py
+src/dynamic_template/models/template.py
+src/dynamic_template/templatetags/__init__.py
+src/dynamic_template/templatetags/dyntpl.py
+tests/test_dynamic_relation_context.py
+tests/test_dyntpl.py
+tests/test_io.py

django_dynamic_template-0.1.0/src/django_dynamic_template.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

django_dynamic_template-0.1.0/src/django_dynamic_template.egg-info/requires.txt

@@ -0,0 +1,12 @@
+Django>=3.2
+django-namedid>=0.1.0
+
+[dev]
+pytest>=8.3
+pytest-django>=4.5
+django-virtualqueryset>=0.1.1
+django-boosted>=1.0.0
+django-richtextfield>=1.6
+ruff>=0.5
+mypy>=1.0
+django-stubs>=5.0.0

django_dynamic_template-0.1.0/src/django_dynamic_template.egg-info/top_level.txt

@@ -0,0 +1 @@
+dynamic_template

django_dynamic_template-0.1.0/src/dynamic_template/__init__.py

@@ -0,0 +1 @@
+"""Django app: dynamic DB-backed templates keyed by NamedID and ContentType."""

django_dynamic_template-0.1.0/src/dynamic_template/admin/__init__.py

@@ -0,0 +1,5 @@
+"""Django admin for dynamic_template (import submodules for @admin.register side effects)."""
+
+from __future__ import annotations
+
+from . import template  # noqa: F401

django_dynamic_template-0.1.0/src/dynamic_template/admin/relation_context.py

@@ -0,0 +1,8 @@
+from django.contrib import admin
+
+from dynamic_template.models import DynamicRelationContext
+
+
+class DynamicRelationContextInline(admin.TabularInline):
+    model = DynamicRelationContext
+    extra = 0

django_dynamic_template-0.1.0/src/dynamic_template/admin/template.py

@@ -0,0 +1,216 @@
+import json
+
+from django import forms
+from django.contrib import admin, messages
+from django.core.exceptions import PermissionDenied
+from django.urls import reverse
+from django.utils.translation import gettext_lazy as _
+from django_boosted import AdminBoostModel, admin_boost_view
+from django_boosted.decorators import AdminBoostViewConfig
+
+from .relation_context import DynamicRelationContextInline
+from dynamic_template.io import import_payload, json_attachment_response, serialize_export
+from dynamic_template.models import DynamicTemplate
+from dynamic_template.rendering import render_dynamic_template_fragment
+
+
+def _preview_form_for_template(obj: DynamicTemplate) -> type[forms.Form]:
+    Model = obj.content_type.model_class()
+    model_label = Model._meta.label if Model else "?"
+
+    class DynamicTemplatePreviewForm(forms.Form):
+        object_id = forms.CharField(
+            label=_("Object primary key"),
+            required=False,
+            help_text=_(
+                "Primary key of a %(model)s instance for relation filters and for `object` in the fragment "
+                "(after relation contexts, `object` is a dict from model_fields / annotate_fields / fields). "
+                "Leave empty if the fragment does not use `object`."
+            )
+            % {"model": model_label},
+        )
+
+    return DynamicTemplatePreviewForm
+
+
+class DynamicTemplateImportForm(forms.Form):
+    file = forms.FileField(label=_("JSON file"), required=False)
+    payload = forms.CharField(
+        label=_("Or paste JSON"),
+        widget=forms.Textarea(attrs={"rows": 24, "cols": 100, "class": "vLargeTextField"}),
+        required=False,
+    )
+    replace = forms.BooleanField(
+        label=_("Replace existing templates (same content type + label)"),
+        required=False,
+        initial=True,
+    )
+
+    def clean(self):
+        cleaned = super().clean()
+        file = cleaned.get("file")
+        text = (cleaned.get("payload") or "").strip()
+        raw: str | None = None
+        if file:
+            data = file.read()
+            raw = data.decode("utf-8") if isinstance(data, bytes) else str(data)
+        elif text:
+            raw = text
+        if not raw:
+            raise forms.ValidationError(_("Provide a JSON file or paste JSON."))
+        try:
+            parsed = json.loads(raw)
+        except json.JSONDecodeError as exc:
+            raise forms.ValidationError(str(exc)) from exc
+        if not isinstance(parsed, dict):
+            raise forms.ValidationError(_("Root JSON value must be an object."))
+        cleaned["parsed"] = parsed
+        return cleaned
+
+
+@admin.register(DynamicTemplate)
+class DynamicTemplateAdmin(AdminBoostModel):
+    list_display = ("label", "named_id", "content_type", "relation_context_count_display")
+    list_filter = ("content_type",)
+    search_fields = ("label", "named_id", "template")
+    readonly_fields = ("named_id",)
+    fieldsets = (
+        (
+            None,
+            {
+                "fields": (
+                    "label",
+                    "named_id",
+                    "content_type",
+                    "model_fields",
+                    "annotate_fields",
+                    "fields",
+                    "raw_object",
+                    "context_object",
+                    "template",
+                ),
+            },
+        ),
+    )
+    inlines = (DynamicRelationContextInline,)
+
+    def get_queryset(self, request):
+        return super().get_queryset(request).with_relation_context_count()
+
+    @admin.display(
+        ordering="relation_context_count",
+        description=_("Relation contexts"),
+    )
+    def relation_context_count_display(self, obj):
+        return getattr(obj, "relation_context_count", 0)
+
+    @admin_boost_view(
+        "adminform",
+        _("Import JSON"),
+        config=AdminBoostViewConfig(
+            path_fragment="import-json",
+            requires_object=False,
+            permission="change",
+        ),
+    )
+    def admin_import_json(self, request, form=None):
+        if not self.has_change_permission(request):
+            raise PermissionDenied
+        if form is None:
+            return {"form": DynamicTemplateImportForm()}
+        result = import_payload(
+            form.cleaned_data["parsed"],
+            replace=form.cleaned_data.get("replace", True),
+        )
+        messages.success(
+            request,
+            _("Import finished: %(c)d created, %(u)d updated.")
+            % {"c": result["created"], "u": result["updated"]},
+        )
+        for err in result["errors"][:25]:
+            messages.warning(request, err)
+        url = reverse(
+            f"admin:{self.model._meta.app_label}_{self.model._meta.model_name}_changelist",
+            current_app=self.admin_site.name,
+        )
+        return {"redirect_url": url}
+
+    @admin_boost_view(
+        "json",
+        _("Export JSON (all)"),
+        config=AdminBoostViewConfig(
+            path_fragment="export-json-bulk",
+            requires_object=False,
+            permission="view",
+        ),
+    )
+    def admin_export_json_bulk(self, request):
+        qs = self.get_queryset(request).prefetch_related("relation_contexts")
+        return json_attachment_response("dynamic-templates.json", serialize_export(qs))
+
+    @admin_boost_view(
+        "json",
+        _("Export JSON"),
+        config=AdminBoostViewConfig(
+            path_fragment="export-json",
+            requires_object=True,
+            permission="view",
+        ),
+    )
+    def admin_export_json_single(self, request, obj):
+        payload = serialize_export(
+            DynamicTemplate.objects.filter(pk=obj.pk).prefetch_related("relation_contexts"),
+        )
+        safe = "".join(c if c.isalnum() or c in "-_" else "-" for c in obj.named_id)[:80]
+        return json_attachment_response(
+            f"dynamic-template-{obj.pk}-{safe}.json",
+            payload,
+        )
+
+    @admin_boost_view(
+        "adminform",
+        _("Preview fragment"),
+        config=AdminBoostViewConfig(
+            template_name="dynamic_template/admin/preview_render.html",
+            path_fragment="preview-render",
+            permission="change",
+        ),
+    )
+    def admin_preview_render(self, request, obj, form=None):
+        PreviewForm = _preview_form_for_template(obj)
+        Model = obj.content_type.model_class()
+
+        if form is None:
+            return {"form": PreviewForm()}
+
+        bound = None
+        oid = (form.cleaned_data.get("object_id") or "").strip()
+        if oid:
+            if Model is None:
+                form.add_error("object_id", _("Unknown content type."))
+            else:
+                try:
+                    bound = Model.objects.get(pk=oid)
+                except (Model.DoesNotExist, ValueError, TypeError):
+                    form.add_error(
+                        "object_id",
+                        _("No %(model)s found with this primary key.")
+                        % {"model": Model._meta.verbose_name},
+                    )
+
+        if form.errors:
+            return {"form": form}
+
+        try:
+            html = render_dynamic_template_fragment(
+                obj,
+                request=request,
+                bound=bound,
+                base_context={},
+                extra={},
+            )
+        except ValueError as exc:
+            form.add_error(None, str(exc))
+            return {"form": form}
+
+        return {"form": form, "rendered_preview": html}

django_dynamic_template-0.1.0/src/dynamic_template/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class DynamicTemplateConfig(AppConfig):
+    name = "dynamic_template"
+    default_auto_field = "django.db.models.BigAutoField"