feat(jinja): add Jinja rendering support

Author: m-xim

pyproject.toml

@@ -9,6 +9,7 @@ authors = [
 ]
 requires-python = ">=3.10"
 dependencies = [
+    "jinja2>=3.1.6",
     "magic-filter>=1.0.12",
 ]
 keywords = [
@@ -60,4 +61,4 @@ match = "main"
 
 [tool.semantic_release.branches.dev]
 match = "dev"
-prerelease = true
+prerelease = true

textcompose/container/__init__.py

@@ -1,3 +1,3 @@
-from textcompose.container.group import Group
+__all__ = ["Group"]
 
-__all__ = [Group]
+from textcompose.container.group import Group

textcompose/content/__init__.py

@@ -1,5 +1,5 @@
+__all__ = ["Format", "Jinja", "Text"]
+
 from textcompose.content.format import Format
+from textcompose.content.jinja import Jinja
 from textcompose.content.text import Text
-
-
-__all__ = [Format, Text]

textcompose/content/content.py

@@ -3,8 +3,8 @@
 
 from magic_filter import MagicFilter
 
-Value = Union[None, MagicFilter, str, Callable[[dict[str, Any]], str | None], "BaseContent"]
-Condition = Union[None, MagicFilter, Callable[[dict[str, Any]], bool], bool, "BaseContent"]
+Value = Union[MagicFilter, str, Callable[[dict[str, Any]], str | None], "BaseContent"]
+Condition = Union[MagicFilter, Callable[[dict[str, Any]], bool], bool, "BaseContent"]
 
 
 class BaseContent(ABC):

textcompose/content/jinja.py

@@ -0,0 +1,39 @@
+from jinja2 import Environment, BaseLoader, select_autoescape
+from textcompose.content.content import BaseContent, Value, Condition
+
+TEXTCOMPOSE_JINJA_ENV_FIELD = "textcompose_jinja_env"
+
+
+class Jinja(BaseContent):
+    def __init__(self, template: Value, when: Condition | None = None):
+        self.template = template
+        super().__init__(when=when)
+
+    def render(self, data: dict, **kwargs) -> str:
+        if TEXTCOMPOSE_JINJA_ENV_FIELD in kwargs:
+            env = kwargs[TEXTCOMPOSE_JINJA_ENV_FIELD]
+        else:
+            kwargs[TEXTCOMPOSE_JINJA_ENV_FIELD] = default_env
+            env = default_env
+
+        template = env.get_template(self.template)
+
+        return template.render(data)
+
+
+class StubLoader(BaseLoader):
+    def get_source(self, environment, template):
+        del environment  # unused
+        return template, template, lambda: True
+
+
+def _create_env(*args, filters=None, **kwargs) -> Environment:
+    env = Environment(loader=StubLoader(), autoescape=select_autoescape(["html", "xml"]), *args, **kwargs)
+
+    if filters:
+        env.filters.update(filters)
+
+    return env
+
+
+default_env = _create_env()

textcompose/logic/__init__.py

@@ -1,4 +1,3 @@
-from textcompose.logic.if_then_else import If
-
+__all__ = ["If"]
 
-__all__ = [If]
+from textcompose.logic.if_then_else import If