How sxijyoti/lexicon works
Lexicon is a Go interpreter for Sprout. Users enter expressions in the REPL or run Sprout files; the interpreter tokenizes source, parses it into an AST, evaluates it in an environment, and prints results or errors. The REPL also exposes environment inspection and trace controls. The main execution path is supported by the REPL and parser excerpts; the file-runner path is documented but its implementation was not sampled, so its links are documented rather than source-verified.
Main entry points: main.go Interactive REPL · evaluator.go Evaluator · lexer.go Lexer · parser.go Parser
Components 11
User Interfaces
- Interactive REPL
cmd/repl/main.go - File Runner
cmd/demo
Language Front End
- Lexer
src/lexer/lexer.go - Token Definitions
src/token/token.go - Parser
src/parser/parser.go - AST Nodes
src/ast/ast.go
Interpreter Runtime
- Evaluator
src/evaluator/evaluator.go - Variable Environment
src/evaluator/environment.go - Runtime Values
src/evaluator/object.go
Diagnostics
- Trace Logger
src/logger/logger.go
Other components
- Sprout User
Connections 15
- Sprout User → Interactive REPL: enters expressions
README.md - Sprout User → File Runner: runs source files
README.md - Interactive REPL → Variable Environment: creates environment
cmd/repl/main.go - Interactive REPL → Lexer: tokenizes input
cmd/repl/main.go - Interactive REPL → Parser: parses tokens
cmd/repl/main.go - Interactive REPL → Evaluator: evaluates program
cmd/repl/main.go - Interactive REPL → Trace Logger: toggles tracing
cmd/repl/main.go - Lexer → Token Definitions: emits tokens
src/lexer/lexer.go - Parser → Lexer: reads tokens
src/parser/parser.go - Parser → AST Nodes: builds syntax tree
src/parser/parser.go - Evaluator → AST Nodes: evaluates nodes
src/evaluator/evaluator.go - Evaluator → Variable Environment: reads and writes
src/evaluator/evaluator.go - Evaluator → Runtime Values: creates values
src/evaluator/evaluator.go - Evaluator → Trace Logger: emits trace
src/evaluator/evaluator.go - File Runner → Lexer: starts interpreter pipeline
README.md