Skip to main content

Crate fel_core

Crate fel_core 

Source
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§

IndexMap
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§

IsoDurationParse
Outcome of parsing an ISO 8601 duration for FEL.
JsonWireStyle
JSON object key style for WASM (camelCase) vs Python (snake_case) bindings.
TraceStep
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 FormspecEnvironment from a JSON object (e.g. WASM evalFELWithContext payload).
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.