How project-terra-lang/terra works
Terra is a small language compiler and runtime: users write Terra programs, which are transpiled to Erlang and executed on the BEAM. The documented language surface includes module imports/exports, checked Erlang FFI, process primitives, and a small standard library. The README establishes these capabilities and relationships, but no source excerpts were provided, so internal call flow and the exact compiler entry point are left unspecified.
Main entry points: transpiler.erl Erlang FFI · program.erl Module Imports · std_collection.terra Collections · std_string.terra Strings
Components 20
Compiler
- Tokenizer
src/tokenizer.erl - Transpiler
src/transpiler.erl - Program Handling
src/program.erl - Diagnostics
src/diagnostics.erl
Language Features
- Core Language
src/datatypes.erl - Variables
src/variables.erl - Module Imports
src/program.erl - Erlang FFI
src/transpiler.erl
Standard Library
- Collections
std/std_collection.terra - Strings
std/std_string.terra - Binary
std/std_binary.terra - Filesystem
std/std_fs.terra - Random
std/std_random.terra - Time
std/std_time.terra - Assertions
std/std_test.terra
BEAM Runtime
- Erlang Functions
- BEAM Runtime
- Generated Launcher
Other components
- Terra Author
- Terra Program
Connections 15
- Terra Author → Terra Program: writes
README.md - Terra Program → Transpiler: transpiles
README.md - Transpiler → BEAM Runtime: emits Erlang
README.md - BEAM Runtime → Generated Launcher: runs program
README.md - Generated Launcher → Terra Program: invokes Main
README.md - Terra Program → Module Imports: imports modules
README.md - Module Imports → Collections: resolves std_ imports
README.md - Terra Program → Erlang FFI: declares externs
README.md - Erlang FFI → Erlang Functions: calls declared functions
README.md - Collections → Erlang FFI: uses checked wrappers
README.md - Strings → Erlang FFI: uses checked wrappers
README.md - Binary → Erlang FFI: uses checked wrappers
README.md - Filesystem → Erlang FFI: uses checked wrappers
README.md - Random → Erlang FFI: uses checked wrappers
README.md - Time → Erlang FFI: uses checked wrappers
README.md