Skip to main content

fel_core/
lib.rs

1//! FEL parser, evaluator, and dependency analysis with base-10 decimal arithmetic.
2//!
3//! Uses `rust_decimal` for base-10 arithmetic per spec S3.4.1 (minimum 18 significant digits).
4//!
5//! ## Docs
6//!
7//! - Human overview: crate `README.md` (architecture, pipeline, module map).
8//! - API reference: `cargo doc --no-deps --open`.
9//! - Markdown API export: `docs/rustdoc-md/API.md` (see crate README).
10#![deny(missing_docs)]
11#![warn(clippy::missing_docs_in_private_items)]
12
13pub mod ast;
14pub(crate) mod context_json;
15pub mod convert;
16pub mod dependencies;
17pub mod environment;
18pub mod error;
19pub mod evaluator;
20pub mod extensions;
21pub(crate) mod interpolation;
22pub(crate) mod iso_duration;
23pub mod lexer;
24pub mod parser;
25pub mod prepare_host;
26pub mod printer;
27pub(crate) mod trace;
28pub mod types;
29pub(crate) mod wire_style;
30
31#[cfg(any(test, feature = "proptest-strategies"))]
32pub mod testing;
33
34// Re-export key types
35pub use ast::Expr;
36pub use context_json::formspec_environment_from_json_map;
37pub use convert::{
38    fel_to_json, fel_to_ui_json, fel_to_wire_json, field_map_from_json_str,
39    json_object_to_field_map, json_to_fel,
40};
41pub use dependencies::{
42    Dependencies, dependencies_to_json_value, dependencies_to_json_value_styled,
43    extract_dependencies,
44};
45pub use environment::{FormspecEnvironment, MipState, RepeatContext, resolve_value_path};
46pub use error::{
47    Diagnostic, DiagnosticKind, Error, MissingTimezoneContextError, MissingTimezoneContextReason,
48    ParseError, Severity, fel_diagnostics_to_json_value, fel_diagnostics_to_json_value_styled,
49    has_error_diagnostics, reject_undefined_functions, undefined_function_names_from_diagnostics,
50};
51pub use evaluator::{
52    BudgetExceededKind, ContextBinding, ContextBindingCatalog, ContextBindingKind, EmptyCatalog,
53    Environment, EvalBudget, EvalResult, Evaluator, EvaluatorOptions, MapEnvironment,
54    UNBOUND_CONTEXT_REF_CODE, eval_with_fields, evaluate, evaluate_with, evaluate_with_catalog,
55};
56pub use extensions::{
57    ExtensionCallOutcome, ExtensionError, ExtensionFn, ExtensionFunc, ExtensionFunctions,
58    ExtensionRegistry, Package, builtin_arity, builtin_function_catalog,
59    builtin_function_catalog_for, builtin_function_catalog_json_value,
60    builtin_function_catalog_json_value_for, call_extension, check_extension_name,
61};
62pub use indexmap::IndexMap;
63pub use interpolation::{expr_is_interpolation_static_literal, expr_references_instance_data};
64pub use iso_duration::{IsoDurationParse, parse_iso8601_duration, parse_iso8601_duration_ms};
65pub use lexer::{
66    PositionedToken, is_valid_fel_identifier, sanitize_fel_identifier, tokenize,
67    tokenize_to_json_value, tokenize_to_json_value_styled,
68};
69pub use parser::parse;
70pub use prepare_host::{
71    PrepareHostInput, PrepareHostOptions, RepeatAliases, host_options_from_json, prepare,
72    prepare_for_host, prepare_with_aliases,
73};
74pub use printer::print_expr;
75pub use trace::{Trace, TraceStep};
76pub use types::{
77    CurrencyCode, Date, Money, Value, parse_date_literal, parse_datetime_literal,
78    value_size_estimate,
79};
80pub use wire_style::JsonWireStyle;