How bencagri/amel works
AMEL is a typed DSL for evaluating expressions against JSON payloads and compiling expressions to SQL or MongoDB queries. The primary workflow is expression text through lexing, parsing, optional optimization, and evaluation against a payload; function calls extend evaluation with built-ins or sandboxed JavaScript. Compilation is a separate path from an AST to a target query. README capabilities include JSONPath access, regex, lambdas and array operations, and explainable evaluation. The graph follows shown calls and documented capabilities; unsampled implementation details are not inferred.
Main entry points: engine.go Engine API · evaluator.go Evaluator · ast.go Expression AST · parser.go Parser
Components 16
DSL Front End
- Lexer
pkg/lexer/lexer.go - Token Types
pkg/lexer/token.go - Parser
pkg/parser/parser.go - Expression AST
pkg/ast/ast.go - AST Optimizer
pkg/optimizer/optimizer.go
Evaluation Runtime
- Engine API
pkg/engine/engine.go - Evaluator
pkg/eval/evaluator.go - Typed Values
pkg/types/types.go
Function System
- Function Registry
pkg/functions/registry.go - Built-ins
pkg/functions/builtin.go - JS Sandbox
pkg/functions/sandbox.go
Query Compilation
- SQL Compiler
pkg/compiler/sql.go - MongoDB Compiler
pkg/compiler/mongodb.go
Other components
- Application
- JSON Payload
- Evaluation Result
Connections 19
- Application → Engine API: submits expression
README.md - Engine API → Parser: parses expression
pkg/engine/engine.go - Parser → Lexer: creates lexer
pkg/parser/parser.go - Lexer → Token Types: produces tokens
- Parser → Expression AST: builds AST
pkg/parser/parser.go - Engine API → AST Optimizer: optimizes AST
pkg/engine/engine.go - Engine API → Evaluator: evaluates AST
pkg/engine/engine.go - Engine API → Expression AST: retains source AST
pkg/engine/engine.go - JSON Payload → Engine API: supplies data
README.md - Evaluator → Typed Values: creates typed values
pkg/eval/evaluator.go - Evaluator → Function Registry: dispatches calls
pkg/eval/evaluator.go - Function Registry → Built-ins: registers built-ins
pkg/functions/builtin.go - Evaluator → JS Sandbox: invokes JS
pkg/eval/evaluator.go - Engine API → Function Registry: registers functions
pkg/engine/engine.go - Evaluator → Evaluation Result: returns value
README.md - Application → SQL Compiler: requests SQL compilation
README.md - Application → MongoDB Compiler: requests MongoDB compilation
README.md - SQL Compiler → Expression AST: compiles expression
pkg/compiler/sql.go - MongoDB Compiler → Expression AST: compiles expression
pkg/compiler/mongodb.go