Struct ParsedExpression 

pub struct ParsedExpression { /* private fields */ }

A parsed expression ready for evaluation.

Implementations

impl ParsedExpression

pub fn expression(&self) -> &str

The trimmed expression string.

pub fn accessed_symbols(&self) -> &HashSet<String>

Symbol names accessed by this expression (e.g. Param.Name).

pub fn called_functions(&self) -> &HashSet<String>

Function names called by this expression (e.g. len, upper).

pub fn local_bindings(&self) -> &HashSet<String>

Loop variable names bound by list comprehensions in this expression.

impl ParsedExpression

Parse a Python expression, handling contextual keywords (Python keywords used as attribute names after ‘.’).

Matches the Python implementation’s approach:

1. Try to parse
2. On syntax error, find keyword after ‘.’ at error position
3. Replace with same-length identifier (preserves error positions)
4. Retry
5. After success, record renames so evaluator can map back

pub fn new(expr: &str) -> Result<ParsedExpression, ExpressionError>

Parse an expression using the “latest” profile (ExprProfile::latest): the current revision with every known extension enabled.

This constructor is intentionally unstable across crate versions. The set of accepted syntax, functions, and types grows as new extensions and revisions land. Use it for ad-hoc parsing, prototyping, or when the source of the expression is known to target the newest capabilities.

For stability across crate versions, build a profile with an explicit revision and extension set and use with_profile.

pub fn with_profile( expr: &str, profile: &ExprProfile, ) -> Result<ParsedExpression, ExpressionError>

Parse an expression under a caller-supplied profile.

The profile governs which syntax features the parser accepts (determined by its revision and enabled extensions) and — once expression-level extensions exist — which functions and types are in scope. An expression that parses successfully under one profile may fail to parse under another; conversely, a template that pinned a specific revision at decode time will continue to parse identically across crate upgrades if it is re-parsed against the same profile.

Examples

use openjd_expr::{ExprProfile, ParsedExpression};

// Stable: this call will parse the same expression the same way
// regardless of future crate versions.
let profile = ExprProfile::current();
let parsed = ParsedExpression::with_profile("1 + 2", &profile)
    .expect("parses");

pub fn evaluate( &self, values: &SymbolTable, ) -> Result<ExprValue, ExpressionError>

Evaluate this parsed expression against a single symbol table.

Convenience shortcut that returns just the value. See evaluate_with_metrics to also observe resource usage.

pub fn evaluate_with_metrics( &self, symtabs: &[&SymbolTable], ) -> Result<EvalResult, ExpressionError>

Evaluate this parsed expression and return the value alongside resource-usage metrics.

Convenience shortcut equivalent to parsed.with_*(default).evaluate_with_metrics(&symtabs) — call this when you don’t need any with_* configuration.

pub fn with_library<'a>( &'a self, library: &'a FunctionLibrary, ) -> EvalBuilder<'a>

Start a configured evaluation using the EvalBuilder.

pub fn with_memory_limit(&self, limit: usize) -> EvalBuilder<'_>

Start a configured evaluation with a memory limit.

pub fn with_operation_limit(&self, limit: usize) -> EvalBuilder<'_>

Start a configured evaluation with an operation limit.

pub fn with_path_format(&self, format: PathFormat) -> EvalBuilder<'_>

Start a configured evaluation with an explicit path format.

pub fn with_target_type<'a>( &'a self, target_type: &'a ExprType, ) -> EvalBuilder<'a>

Start a configured evaluation with a target type for coercion.

pub fn as_name_lookup(&self) -> Option<&str>

If this expression is a simple dotted name (e.g. Param.Name), return it as a string. Returns None for anything more complex (arithmetic, function calls, subscripts, etc.).

Trait Implementations

impl Clone for ParsedExpression

fn clone(&self) -> ParsedExpression

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParsedExpression

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.