How thepeilin/fakelisp works
fakeLisp is an embeddable C implementation of a Lisp interpreter. Its principal workflow is to read source, parse expressions, generate executable code, and run it in a virtual machine; the sampled parser supports the parsing stage, while the remaining links in that workflow are not verified in the excerpts. The product also includes compiler and bytecode tools, macro and grammar facilities, module support, a libuv binding, threading, and a debugger. Several connections are documented capabilities rather than inspected call sites.
Main entry points: vmrun.c Virtual Machine · fakeLisp.c Interpreter CLI · parser.c Source Reader · code_gen.c Code Generation
Components 20
Language Frontend
- Source Reader
src/parser.c - Grammar Parser
src/parser_grammer.c - Grammar Model
include/fakeLisp/grammer.h - Code Generation
src/code_gen.c - Code Optimizer
src/optimizer.c
Execution Runtime
- Virtual Machine
src/vmrun.c - VM Values
src/vmvalue.c - Memory Management
src/vmgc.c
Language Extensions
- Builtin Functions
src/builtin.c - Grammar Builtins
src/grammer/builtin.c - Module Support
src/fs/fs.c - libuv Binding
src/fuv/main.c - libuv Runtime
3rd/libuv/include/uv.h - Thread Support
src/sync/sync.c
Tools and Integrations
- Compiler CLI
main/fakeLispc.c - Bytecode Printer
main/fakeLispp.c - Interpreter CLI
main/fakeLisp.c - Debugger Module
src/bdb/main.c - Debugger Core
src/bdb/bdb.c
Other components
- Lisp Source User
Connections 20
- Lisp Source User → Interpreter CLI: runs source
README.md - Interpreter CLI → Source Reader: reads source
- Source Reader → Grammar Model: parses with
src/parser.c - Source Reader → Code Generation: supplies expressions
- Grammar Parser → Grammar Model: uses grammar
- Compiler CLI → Source Reader: reads source
- Compiler CLI → Code Generation: compiles
- Code Generation → Code Optimizer: optimizes code
- Interpreter CLI → Virtual Machine: runs program
- Virtual Machine → VM Values: operates on
- Virtual Machine → Memory Management: manages memory
- Virtual Machine → Builtin Functions: dispatches builtins
- Virtual Machine → Grammar Builtins: supports macros
- Interpreter CLI → Module Support: supports modules
- Virtual Machine → libuv Binding: loads binding
- libuv Binding → libuv Runtime: calls API
src/fuv/main.c - Virtual Machine → Thread Support: supports threads
- Interpreter CLI → Debugger Module: loads debugger
- Debugger Module → Debugger Core: uses core
src/bdb/main.c - Bytecode Printer → Virtual Machine: prints bytecode