Bolt Anchors

Name resource locations and build nested paths in bolt.

Bolt anchors let you bind a resource declaration to an identifier with the as clause. The anchor can then be used as a value or extended with / to build nested resource locations.

Installation

pip install bolt-anchors

Configuration

Add the plugin to your beet.yml/beet.json after bolt.

pipeline:
  - mecha

require:
  - bolt
  - bolt_anchors

Usage

Bind an anchor when declaring any resource. The anchor holds the fully resolved resource location of the declaration.

append function ~/foo as foo:
    print(foo)
    function foo / "bar":
        say foo bar

foo resolves to namespace:foo/foo (relative to the current file and the enclosing declarations) and foo / "bar" extends it into a nested resource location. Anchors work for any resource type and any path depth.

loot_table ./technical/loot as LOOT {}
print(LOOT)

Anchors can be used as values, interpolated into strings, and reused when declaring or calling other resources.

function ~/utils as utils:
    function utils / "math" / "add":
        scoreboard players add @s points 1

advancement ./tech/root as ROOT {}
predicate ROOT / "check" {}
say f"prefix is {utils}"
function utils / "math" / "add"

Moving the path scope

The anchor command changes the current path scope without creating a resource. Nested locations and anchors inside its block resolve against the new location.

anchor demo:foo as foo:
    function ~/bar as bar:
        print(bar) # demo:foo/bar
    function foo / "baz" as baz:
        print(baz) # demo:foo/baz

The block itself emits no file. Commands and statements inside an anchor block are treated like regular top-level code and are inlined into the current file, while any resource declarations create files relative to the new scope.

Development

uv sync --dev
uv run pytest
uv run ruff check