class

KrikriJinja::Context

Inherits Reference < Object

Constructors

new(globals : Hash(String, AnyValue) = {} of String => AnyValue, loader : Loader | Nil = nil, autoescape : Bool = false, undefined : Undefined = Undefined.new, filters : Hash(String, FilterFn) = BUILTIN_FILTERS.dup, tests : Hash(String, TestFn) = BUILTIN_TESTS.dup, rwlock : Sync::RWLock | Nil = nil)

Instance methods

[](name : String) : AnyValue

[]=(name : String, value : AnyValue)

[]?(name : String) : AnyValue | Nil

autoescape

autoescape=(autoescape : Bool)

blocks

blocks=(blocks : Hash(String, Array(Nodes::BlockNode)))

delete(name : String)

filter(name : String) : FilterFn | Nil

A fully-qualified collection name (ansible.builtin.ternary, namespace.collection.name) resolves to the filter or test registered under its trailing segment, the way Ansible resolves | ansible.builtin.ternary(...) to ternary. A single dot is not a collection name (x | first.to_s stays unknown, as in jinja).

filters

globals

has_key?(name : String) : Bool

hide_from

hide_from=(hide_from : Int32)

hide_locals

hide_locals=(hide_locals : Bool)

hide_loop_var

hide_loop_var=(hide_loop_var : Bool)

hide_super

hide_super=(hide_super : Bool)

host_context

Opaque caller-supplied context handed to registered filters, tests, and functions, for hosts that need controller-side state (variable scope, role paths, plugin runners) that the engine cannot know about.

host_context=(host_context : HostContext | Nil)

Opaque caller-supplied context handed to registered filters, tests, and functions, for hosts that need controller-side state (variable scope, role paths, plugin runners) that the engine cannot know about.

loader

loop_is_local

loop_is_local=(loop_is_local : Bool)

missing_attribute(obj : AnyValue, name : String) : AnyValue

An undefined for an attribute or key name that obj lacks, with Jinja's own message ("'dict object' has no attribute 'x'").

pop_scope

push_scope(local = false)

register_block(name : String, node : Nodes::BlockNode)

resolver

Lazy variable source consulted after every scope and before globals.

resolver=(resolver : VariableResolver | Nil)

Lazy variable source consulted after every scope and before globals.

rwlock

Shared with the owning Engine (see Engine#rwlock): @globals/@filters/ @tests below are the same Hash instances the engine mutates via register_*, so reads here must take the same lock the engine's writes take, not a private one.

scopes

test(name : String) : TestFn | Nil

tests

undefined

undefined=(undefined : Undefined)

undefined_any

Pre-boxed shared undefined for this context, reused on name misses.

undefined_named(name : String, hint : String | Nil = nil) : AnyValue

The engine's shared Undefined instance carries no name; a lookup miss hands out a copy tagged with the variable that was missing so error messages can name it the way real Jinja2 does. Hintless misses for the same name are memoized: repeated misses (optional vars, defined checks, loop.parent) would otherwise allocate on every lookup.