feat: expose renderer as a standalone plugin

beet/contrib/render.py

@@ -0,0 +1,45 @@
+"""Plugin that invokes the built-in template renderer."""
+
+
+__all__ = [
+    "render",
+]
+
+
+from typing import Dict, List, Optional
+
+from beet import Context, Plugin
+from beet.core.utils import JsonDict
+
+
+def beet_default(ctx: Context):
+    config = ctx.meta.get("render", {})
+
+    resource_pack = config.get("resource_pack")
+    data_pack = config.get("data_pack")
+
+    ctx.require(render(resource_pack, data_pack))
+
+
+def render(
+    resource_pack: Optional[Dict[str, List[str]]] = None,
+    data_pack: Optional[Dict[str, List[str]]] = None,
+) -> Plugin:
+    """Return a plugin that processes the data pack and the resource pack with Jinja."""
+
+    def plugin(ctx: Context):
+        for groups, pack in zip([resource_pack or {}, data_pack or {}], ctx.packs):
+            for group, patterns in groups.items():
+                try:
+                    proxy = getattr(pack, group)
+                    file_paths = proxy.match(*patterns)
+                except:
+                    raise ValueError(f"Invalid pattern group {group!r}.") from None
+                else:
+                    for path in file_paths:
+                        ctx.template.render_file(
+                            proxy[path],
+                            __render__={"path": path, "group": group},
+                        )
+
+    return plugin

beet/toolchain/project.py

@@ -11,6 +11,7 @@
 from pathlib import Path
 from typing import Iterable, Iterator, List, Optional, Sequence
 
+from beet.contrib.render import render
 from beet.core.cache import MultiCache
 from beet.core.utils import FileSystemPath, intersperse
 from beet.core.watch import DirectoryWatcher, FileChanges
@@ -237,20 +238,12 @@ def bootstrap(self, ctx: Context):
             for path in config.load:
                 pack.load(path)
 
-        for config, pack in zip(pack_configs, ctx.packs):
-            for group, patterns in config.render.items():
-                try:
-                    proxy = getattr(pack, group)
-                    file_paths = proxy.match(*patterns)
-                except:
-                    message = f"Invalid pattern group {group!r} in configuration."
-                    raise ErrorMessage(message) from None
-                else:
-                    for path in file_paths:
-                        ctx.template.render_file(
-                            proxy[path],
-                            __render__={"path": path, "group": group},
-                        )
+        ctx.require(
+            render(
+                resource_pack=self.config.resource_pack.render,
+                data_pack=self.config.data_pack.render,
+            )
+        )
 
         yield
 

tests/examples/code_render_plugin/beet.json

@@ -0,0 +1,6 @@
+{
+  "pipeline": ["demo"],
+  "meta": {
+    "message": "foo"
+  }
+}

tests/examples/code_render_plugin/demo.py

@@ -0,0 +1,8 @@
+from beet import Context, Function
+from beet.contrib.render import render
+
+
+def beet_default(ctx: Context):
+    ctx.data["demo:foo"] = Function(["say {{ ctx.meta.message }}"])
+
+    ctx.require(render(data_pack={"functions": ["*"]}))

tests/examples/code_sandbox_render/beet.json

@@ -0,0 +1,6 @@
+{
+  "pipeline": ["demo"],
+  "meta": {
+    "message": "foo"
+  }
+}

tests/examples/code_sandbox_render/demo.py

@@ -0,0 +1,18 @@
+from beet import Context, Function, sandbox
+from beet.contrib.render import render
+
+
+def beet_default(ctx: Context):
+    ctx.data["demo:foo"] = Function(["say {{ ctx.meta.message }}"])
+    ctx.require(render_functions)
+
+    ctx.data["demo:bar"] = Function(["say {{ ctx.meta.message }}"])
+    ctx.require(sandbox(add_function, render_functions))
+
+
+def add_function(ctx: Context):
+    ctx.data["demo:isolated"] = Function(["say isolated {{ ctx.meta.message }}"])
+
+
+def render_functions(ctx: Context):
+    ctx.require(render(data_pack={"functions": ["*"]}))

tests/examples/load_subpipelines_render/beet.json

@@ -0,0 +1,24 @@
+{
+  "pipeline": [
+    {
+      "data_pack": {
+        "load": ["pack1"]
+      }
+    },
+    {
+      "data_pack": {
+        "load": ["pack2"]
+      }
+    },
+    "beet.contrib.render"
+  ],
+  "meta": {
+    "pack1_message": "foo",
+    "pack2_message": "bar",
+    "render": {
+      "data_pack": {
+        "functions": ["demo:*"]
+      }
+    }
+  }
+}

tests/examples/load_subpipelines_render/pack1/data/demo/functions/foo.mcfunction

@@ -0,0 +1 @@
+say {{ ctx.meta.pack1_message }}

tests/examples/load_subpipelines_render/pack2/data/demo/functions/bar.mcfunction

@@ -0,0 +1 @@
+say {{ ctx.meta.pack2_message }}

tests/snapshots/examples__build_code_render_plugin__0.data_pack/code_render_plugin_data_pack/data/demo/functions/foo.mcfunction

@@ -0,0 +1 @@
+say foo

tests/snapshots/examples__build_code_render_plugin__0.data_pack/code_render_plugin_data_pack/pack.mcmeta

@@ -0,0 +1,6 @@
+{
+  "pack": {
+    "pack_format": 6,
+    "description": ""
+  }
+}

tests/snapshots/examples__build_code_render_plugin__1.resource_pack/code_render_plugin_resource_pack/pack.mcmeta

@@ -0,0 +1,6 @@
+{
+  "pack": {
+    "pack_format": 6,
+    "description": ""
+  }
+}

tests/snapshots/examples__build_code_sandbox_render__0.data_pack/code_sandbox_render_data_pack/data/demo/functions/bar.mcfunction

@@ -0,0 +1 @@
+say {{ ctx.meta.message }}

tests/snapshots/examples__build_code_sandbox_render__0.data_pack/code_sandbox_render_data_pack/data/demo/functions/foo.mcfunction

@@ -0,0 +1 @@
+say foo

tests/snapshots/examples__build_code_sandbox_render__0.data_pack/code_sandbox_render_data_pack/data/demo/functions/isolated.mcfunction

@@ -0,0 +1 @@
+say isolated 

tests/snapshots/examples__build_code_sandbox_render__0.data_pack/code_sandbox_render_data_pack/pack.mcmeta

@@ -0,0 +1,6 @@
+{
+  "pack": {
+    "pack_format": 6,
+    "description": ""
+  }
+}

tests/snapshots/examples__build_code_sandbox_render__1.resource_pack/code_sandbox_render_resource_pack/pack.mcmeta

@@ -0,0 +1,6 @@
+{
+  "pack": {
+    "pack_format": 6,
+    "description": ""
+  }
+}

tests/snapshots/examples__build_load_subpipelines_render__0.data_pack/load_subpipelines_render_data_pack/data/demo/functions/bar.mcfunction

@@ -0,0 +1 @@
+say bar

tests/snapshots/examples__build_load_subpipelines_render__0.data_pack/load_subpipelines_render_data_pack/data/demo/functions/foo.mcfunction

@@ -0,0 +1 @@
+say foo

tests/snapshots/examples__build_load_subpipelines_render__0.data_pack/load_subpipelines_render_data_pack/pack.mcmeta

@@ -0,0 +1,6 @@
+{
+  "pack": {
+    "pack_format": 6,
+    "description": ""
+  }
+}

tests/snapshots/examples__build_load_subpipelines_render__1.resource_pack/load_subpipelines_render_resource_pack/pack.mcmeta

@@ -0,0 +1,6 @@
+{
+  "pack": {
+    "pack_format": 6,
+    "description": ""
+  }
+}