Add Jinja2 binding for django_simple_nav

Author: HiPhish

src/django_simple_nav/jinja2/__init__.py

@@ -0,0 +1,27 @@
+from typing import cast
+from jinja2 import pass_context, Template, TemplateRuntimeError
+from jinja2.runtime import Context
+from django.utils.module_loading import import_string
+from django_simple_nav.nav import Nav
+
+
+@pass_context
+def django_simple_nav(context: Context, nav: str | Nav,
+                      template_name: str | None = None) -> str:
+    """Jinja binding for `django_simple_nav`"""
+    if (loader := context.environment.loader) is None:
+        raise TemplateRuntimeError('No template loader in Jinja2 environment')
+
+    if type(nav) is str:
+        try:
+            nav = import_string(nav)()
+        except ImportError as err:
+            raise TemplateRuntimeError(f'Variable does not exist: {err}')
+
+    if template_name is None:
+        template_name = cast(Nav, nav).template_name
+    if template_name is None:
+        raise TemplateRuntimeError('Navigation object has no template')
+
+    template: Template = loader.load(context.environment, template_name)
+    return template.render(items=cast(Nav, nav).items)

src/django_simple_nav/jinja2/django_simple_nav.py

@@ -0,0 +1,9 @@
+"""Sets up a reasonably minimal Jinja2 environment for testing"""
+from jinja2 import Environment, FileSystemLoader
+from django_simple_nav.jinja2.django_simple_nav import django_simple_nav
+
+
+environment = Environment(
+    loader=FileSystemLoader('tests/templates/tests/jinja2/')
+)
+environment.globals.update({'django_simple_nav': django_simple_nav})

tests/jinja2/environment.py

@@ -1,9 +1,11 @@
 <ul>
-  {% for item in items %}
+  {% for item in items recursive %}
     <li>
       <a href="{{ item.url }}">{{ item.title }}</a>
       {% if item.items %}
-        {% include "tests/dummy_nav.html" %}
+        <ul>
+          {{ loop(item.items) }}
+        </ul>
       {% endif %}
     </li>
   {% endfor %}

tests/templates/tests/jinja2/dummy_nav.html

@@ -0,0 +1,8 @@
+from .jinja2.environment import environment
+
+
+def test_derp():
+    """Render the template"""
+    template = environment.from_string('<p>{{ django_simple_nav("tests.navs.DummyNav", "dummy_nav.html") }}</p>')
+    print(template.render(some_var=[1, 2, 3]))
+    assert True