Expand description
FEL parser, evaluator, and dependency analysis with base-10 decimal arithmetic.
Uses rust_decimal for base-10 arithmetic per spec S3.4.1 (minimum 18 significant digits).
§Docs
- Human overview: crate
README.md(architecture, pipeline, module map). - API reference:
cargo doc --no-deps --open. - Markdown API export:
docs/rustdoc-md/API.md(see crate README).
Re-exports§
pub use ast::Expr;pub use convert::fel_to_json;pub use convert::fel_to_ui_json;pub use convert::fel_to_wire_json;pub use convert::field_map_from_json_str;pub use convert::json_object_to_field_map;pub use convert::json_to_fel;pub use dependencies::Dependencies;pub use dependencies::dependencies_to_json_value;pub use dependencies::dependencies_to_json_value_styled;pub use dependencies::extract_dependencies;pub use environment::FormspecEnvironment;pub use environment::MipState;pub use environment::RepeatContext;pub use environment::resolve_value_path;pub use error::Diagnostic;pub use error::DiagnosticKind;pub use error::Error;pub use error::MissingTimezoneContextError;pub use error::MissingTimezoneContextReason;pub use error::ParseError;pub use error::Severity;pub use error::fel_diagnostics_to_json_value;pub use error::fel_diagnostics_to_json_value_styled;pub use error::has_error_diagnostics;pub use error::reject_undefined_functions;pub use error::undefined_function_names_from_diagnostics;pub use evaluator::BudgetExceededKind;pub use evaluator::ContextBinding;pub use evaluator::ContextBindingCatalog;pub use evaluator::ContextBindingKind;pub use evaluator::EmptyCatalog;pub use evaluator::Environment;pub use evaluator::EvalBudget;pub use evaluator::EvalResult;pub use evaluator::Evaluator;pub use evaluator::EvaluatorOptions;pub use evaluator::MapEnvironment;pub use evaluator::UNBOUND_CONTEXT_REF_CODE;pub use evaluator::eval_with_fields;pub use evaluator::evaluate;pub use evaluator::evaluate_with;pub use evaluator::evaluate_with_catalog;pub use extensions::ExtensionCallOutcome;pub use extensions::ExtensionError;pub use extensions::ExtensionFn;pub use extensions::ExtensionFunc;pub use extensions::ExtensionFunctions;pub use extensions::ExtensionRegistry;pub use extensions::Package;pub use extensions::builtin_arity;pub use extensions::builtin_function_catalog;pub use extensions::builtin_function_catalog_for;pub use extensions::builtin_function_catalog_json_value;pub use extensions::builtin_function_catalog_json_value_for;pub use extensions::call_extension;pub use extensions::check_extension_name;pub use lexer::PositionedToken;pub use lexer::is_valid_fel_identifier;pub use lexer::sanitize_fel_identifier;pub use lexer::tokenize;pub use lexer::tokenize_to_json_value;pub use lexer::tokenize_to_json_value_styled;pub use parser::parse;pub use prepare_host::PrepareHostInput;pub use prepare_host::PrepareHostOptions;pub use prepare_host::RepeatAliases;pub use prepare_host::host_options_from_json;pub use prepare_host::prepare;pub use prepare_host::prepare_for_host;pub use prepare_host::prepare_with_aliases;pub use printer::print_expr;pub use types::CurrencyCode;pub use types::Date;pub use types::Money;pub use types::Value;pub use types::parse_date_literal;pub use types::parse_datetime_literal;pub use types::value_size_estimate;
Modules§
- ast
- FEL abstract syntax tree node definitions and operators.
- convert
- Canonical conversion between serde_json::Value and TypeValue.
- dependencies
- Static dependency extraction — field refs, context refs, and MIP dependencies.
- environment
- FEL evaluation environment with field resolution, repeats, MIP state, and instances.
- error
- FEL error types and diagnostic messages.
- evaluator
- FEL tree-walking evaluator with base-10 decimal arithmetic and null propagation.
- extensions
- FEL extension function registry with null propagation and conflict detection.
- lexer
- FEL hand-rolled lexer — tokenization with spans and decimal numbers.
- parser
- FEL hand-rolled recursive descent parser with operator precedence.
- prepare_
host - FEL source normalization before host evaluation (parity with TS
normalizeExpressionForWasmEvaluation). - printer
- FEL AST to string serializer for expression rewriting and debugging.
- types
- FEL runtime value types with base-10 decimal arithmetic.
Structs§
- Index
Map - A hash table where the iteration order of the key-value pairs is independent of the hash values of the keys.
- Trace
- An ordered record of everything the evaluator emitted during one run.
Enums§
- IsoDuration
Parse - Outcome of parsing an ISO 8601 duration for FEL.
- Json
Wire Style - JSON object key style for WASM (
camelCase) vs Python (snake_case) bindings. - Trace
Step - A single recorded event during FEL evaluation.
Functions§
- expr_
is_ interpolation_ static_ literal - True when the AST is only literals and unary
not/!/-on such (locale §3.3.1). - expr_
references_ instance_ data - True when the AST reads instance data: a
$field, an@context, or a repeat navigation call (locale §3.3.1 rule 3a). - formspec_
environment_ from_ json_ map - Populate a
FormspecEnvironmentfrom a JSON object (e.g. WASMevalFELWithContextpayload). - parse_
iso8601_ duration - Parse an ISO 8601 duration; distinguishes invalid input from out-of-range totals.
- parse_
iso8601_ duration_ ms - Parse an ISO 8601 duration to whole milliseconds.