feat: asset module

bolt/module.py

@@ -1,5 +1,6 @@
 __all__ = [
     "Module",
+    "AssetModule",
     "CompiledModule",
     "ModuleManager",
     "ModuleCacheBackend",
@@ -85,6 +86,13 @@ class Module(TextFile):
     extension: ClassVar[str] = ".bolt"
 
 
+class AssetModule(TextFile):
+    """Class representing a bolt module in a resource pack."""
+
+    scope: ClassVar[Tuple[str, ...]] = ("modules",)
+    extension: ClassVar[str] = ".bolt"
+
+
 MacroLibrary = Dict[str, Dict[Tuple[str, AstMacro], Optional[Tuple[str, str]]]]
 
 

bolt/runtime.py

@@ -19,6 +19,7 @@
     CommandSpec,
     CommandTree,
     CompilationDatabase,
+    CompilationUnitProvider,
     Diagnostic,
     FileTypeCompilationUnitProvider,
     Mecha,
@@ -36,7 +37,13 @@
 from .helpers import get_bolt_helpers
 from .loop_info import loop_info
 from .memo import MemoHandler, MemoRegistry
-from .module import CompiledModule, Module, ModuleCacheBackend, ModuleManager
+from .module import (
+    AssetModule,
+    CompiledModule,
+    Module,
+    ModuleCacheBackend,
+    ModuleManager,
+)
 from .parse import get_bolt_parsers
 from .utils import internal
 
@@ -54,6 +61,7 @@ class Runtime(CommandEmitter):
     evaluate: "Evaluator"
 
     spec: CommandSpec
+    module_provider: CompilationUnitProvider
 
     def __init__(self, ctx: Union[Context, Mecha]):
         super().__init__()
@@ -74,6 +82,7 @@ def __init__(self, ctx: Union[Context, Mecha]):
             )
 
             ctx.data.extend_namespace.append(Module)
+            ctx.assets.extend_namespace.append(AssetModule)
 
             self.globals["ctx"] = ctx
 
@@ -126,7 +135,8 @@ def __init__(self, ctx: Union[Context, Mecha]):
 
         self.spec = mc.spec
 
-        mc.providers.append(FileTypeCompilationUnitProvider([Module]))
+        self.module_provider = FileTypeCompilationUnitProvider([Module, AssetModule])
+        mc.providers.append(self.module_provider)
 
         commands_json = files("bolt.resources").joinpath("commands.json").read_text()
         command_tree = CommandTree.parse_raw(commands_json)
@@ -207,6 +217,8 @@ def finalize(self, ctx: Context):
         finally:
             for pack in [ctx.data, *ctx.data.overlays.values()]:
                 pack[Module].clear()
+            for pack in [ctx.assets, *ctx.assets.overlays.values()]:
+                pack[AssetModule].clear()
             self.memo.finalize()
 
 
@@ -237,7 +249,7 @@ def root(self, node: AstRoot) -> Optional[AstRoot]:
         compilation_unit, module = self.modules.match_ast(node)
 
         if (
-            isinstance(self.modules.database.current, Module)
+            isinstance(self.modules.database.current, (Module, AssetModule))
             and not module.executed
             and module.resource_location
             and not self.entrypoint_spec.match_file(module.resource_location)

examples/bolt_assets/beet.yml

@@ -0,0 +1,9 @@
+require:
+  - bolt
+resource_pack:
+  load: "src"
+pipeline:
+  - mecha
+meta:
+  bolt:
+    entrypoint: "*"

examples/bolt_assets/src/assets/demo/modules/foo.bolt

@@ -0,0 +1 @@
+model minecraft:block/stone {"parent": "block/cube"}

pyproject.toml

@@ -24,7 +24,7 @@ include = ["bolt/py.typed"]
 [tool.poetry.dependencies]
 python = "^3.10"
 beet = ">=0.97.0"
-mecha = ">=0.81.1"
+mecha = ">=0.83.0"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^7.4.2"

tests/snapshots/examples__build_bolt_assets__0.pack.md

@@ -0,0 +1,24 @@
+# Lectern snapshot
+
+## Resource pack
+
+`@resource_pack pack.mcmeta`
+
+```json
+{
+  "pack": {
+    "pack_format": 18,
+    "description": ""
+  }
+}
+```
+
+### minecraft
+
+`@model minecraft:block/stone`
+
+```json
+{
+  "parent": "block/cube"
+}
+```