Struct FunctionLibrary 

pub struct FunctionLibrary {
    pub host_context_enabled: bool,
    /* private fields */
}

Registry of functions available in expressions.

Fields

host_context_enabled: bool

Implementations

impl FunctionLibrary

pub fn for_profile(profile: &ExprProfile) -> Arc<FunctionLibrary>

Construct or retrieve a cached function library matching the given expression profile.

Libraries are cached keyed on the profile’s (revision, extensions, host-kind) triple. Profiles that differ only in the specific Arc<Vec<PathMappingRule>> they carry share a cached skeleton; the rules are applied as a cheap clone-and- register on top for each call.

Examples

use openjd_expr::{ExprProfile, FunctionLibrary, HostContext};

// Default library for template validation — host functions available
// as unresolved type-check stubs.
let profile = ExprProfile::current().with_host_context(HostContext::Unresolved);
let lib = FunctionLibrary::for_profile(&profile);
assert!(lib.host_context_enabled);

// Runtime library with real path mapping rules.
let profile = ExprProfile::current()
    .with_host_context(HostContext::with_rules(Vec::new()));
let lib = FunctionLibrary::for_profile(&profile);
assert!(lib.host_context_enabled);

impl FunctionLibrary

pub fn new() -> Self

pub fn register<F>( &mut self, name: &str, signature: ExprType, implementation: F, )

where F: Fn(&mut dyn EvalContext, &[ExprValue]) -> Result<ExprValue, ExpressionError> + Send + Sync + 'static,

Register a function overload with an ExprType::Signature.

Accepts either a bare fn pointer or a closure — anything implementing Fn(&mut dyn EvalContext, &[ExprValue]) -> Result<ExprValue, ExpressionError> with Send + Sync + 'static. Closures enable wrapping host state (e.g., AWS clients, config) without plumbing it through EvalContext.

pub fn register_sig<F>( &mut self, name: &str, sig_str: &str, implementation: F, ) -> Result<(), String>

where F: Fn(&mut dyn EvalContext, &[ExprValue]) -> Result<ExprValue, ExpressionError> + Send + Sync + 'static,

Register from spec notation: lib.register_sig("len", "(list[T1]) -> int", len_list)

Returns Err if sig_str cannot be parsed as a valid type signature. The function is not registered on failure.

pub fn get_signatures(&self, name: &str) -> &[FunctionEntry]

Get all entries for a function name.

pub fn merge(self, other: FunctionLibrary) -> Self

Merge another library’s registrations into this one.

pub fn function_names(&self) -> impl Iterator<Item = &str>

Get all registered function names.

pub fn call( &self, name: &str, args: &[ExprValue], ctx: &mut dyn EvalContext, ) -> Result<ExprValue, ExpressionError>

Dispatch a function call: exact → coerced → generic.

pub fn call_method( &self, name: &str, args: &[ExprValue], ctx: &mut dyn EvalContext, ) -> Result<ExprValue, ExpressionError>

Dispatch a method call (skip receiver coercion on first arg).

pub fn derive_return_type( &self, name: &str, arg_types: &[ExprType], ) -> Option<ExprType>

Derive the return type without evaluation (for static type checking). Accepts union types in arg_types and returns a union of all possible return types.

pub fn get_property_type( &self, base_type: &ExprType, property_name: &str, ) -> Option<ExprType>

Get the type of a property access.

Trait Implementations

impl Clone for FunctionLibrary

fn clone(&self) -> FunctionLibrary

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for FunctionLibrary

fn default() -> FunctionLibrary

Returns the “default value” for a type.