How marcobambini/gravity works
Gravity is an embeddable, dynamically typed scripting language. A user supplies source to the CLI or a host application; the compiler parses and transforms it into a closure/bytecode, and the VM executes it and exposes a result. The graph also preserves the documented optional modules and runtime capabilities. Source-index references and README workflows support the principal connections; unsampled implementation details are not asserted.
Main entry points: gravity_vm.c Virtual machine · optionals Optional modules · gravity.c Gravity CLI · exec_c.c Embedding API
Components 22
Entry points
- Gravity CLI
src/cli/gravity.c - Embedding API
api/exec_c.c
Compilation
- Lexer
src/compiler/gravity_lexer.c - Parser and AST
src/compiler/gravity_parser.c - Semantic analysis
src/compiler/gravity_semacheck2.c - Optimizer
src/compiler/gravity_optimizer.c - Code generation
src/compiler/gravity_codegen.c - Compiler API
src/compiler/gravity_compiler.h
Runtime
- Virtual machine
src/runtime/gravity_vm.c - Core classes
src/runtime/gravity_core.c
Runtime foundation
- Values and objects
src/shared/gravity_value.c - Memory and GC
src/shared/gravity_memory.c - Hash tables
src/shared/gravity_hash.c - JSON support
src/utils/gravity_json.c - I/O and utilities
src/utils/gravity_utils.c
Optional modules
- Optional modules
src/optionals - Math module
src/optionals/gravity_opt_math.c - File module
src/optionals/gravity_opt_file.c - JSON module
src/optionals/gravity_opt_json.c - Environment module
src/optionals/gravity_opt_env.c
Other components
- Script author
- Embedding host
Connections 24
- Script author → Gravity CLI: runs script
- Embedding host → Embedding API: embeds language
- Gravity CLI → Compiler API: compiles source
src/cli/gravity.c - Gravity CLI → Virtual machine: executes bytecode
src/cli/gravity.c - Embedding API → Compiler API: compiles source
api/exec_c.c - Embedding API → Virtual machine: runs closure
api/exec_c.c - Compiler API → Parser and AST: compiles source
- Parser and AST → Lexer: requests tokens
src/compiler/gravity_parser.c - Parser and AST → Semantic analysis: checks AST
- Semantic analysis → Optimizer: validates before optimization
- Optimizer → Code generation: optimizes for codegen
- Code generation → Virtual machine: produces bytecode
- Virtual machine → Core classes: uses core classes
src/runtime/gravity_vm.c - Virtual machine → Optional modules: loads optional modules
src/runtime/gravity_vm.c - Optional modules → Math module: exposes module
src/optionals/gravity_optionals.h - Optional modules → File module: exposes module
src/optionals/gravity_optionals.h - Optional modules → JSON module: exposes module
src/optionals/gravity_optionals.h - Optional modules → Environment module: exposes module
src/optionals/gravity_optionals.h - Virtual machine → Values and objects: executes values
src/runtime/gravity_vm.c - Virtual machine → Memory and GC: uses allocation and GC
src/runtime/gravity_vm.c - Core classes → Values and objects: defines built-in types
src/runtime/gravity_core.c - Core classes → Hash tables: uses hash tables
src/runtime/gravity_core.c - JSON module → JSON support: uses serializer
src/optionals/gravity_opt_json.c - File module → I/O and utilities: uses file utilities
src/optionals/gravity_opt_file.c