Alexa Amundson
78fbe80f2a
bin/ 230 CLI tools (ask-*, br-*, agent-*, roadid, carpool) scripts/ 99 automation scripts fleet/ Node configs and deployment workers/ Cloudflare Worker sources (roadpay, road-search, squad webhooks) roadc/ RoadC programming language roadnet/ Mesh network (5 APs, WireGuard) operator/ Memory system scripts config/ System configs dotfiles/ Shell configs docs/ Documentation BlackRoad OS — Pave Tomorrow. RoadChain-SHA2048: d1a24f55318d338b RoadChain-Identity: alexa@sovereign RoadChain-Full: d1a24f55318d338b24b60bad7be39286379c76ae5470817482100cb0ddbbcb97e147d07ac7243da0a9f0363e4e5c833d612b9c0df3a3cd20802465420278ef74875a5b77f55af6fe42a931b8b635b3d0d0b6bde9abf33dc42eea52bc03c951406d8cbe49f1a3d29b26a94dade05e9477f34a7d4d4c6ec4005c3c2ac54e73a68440c512c8e83fd9b1fe234750b898ef8f4032c23db173961fe225e67a0432b5293a9714f76c5c57ed5fdf35b9fb40fd73c03ebf88b7253c6a0575f5afb6a6b49b3bda310602fb1ef676859962dad2aebbb2875814b30eee0a8ba195e482d4cbc91d8819e7f38f6db53e8063401649c77bb994371473cabfb917fb53e8cbe73d60
104 lines
3.1 KiB
Markdown
104 lines
3.1 KiB
Markdown
# RoadC
|
|
|
|
[](https://github.com/blackboxprogramming/roadc/actions/workflows/ci.yml)
|
|
[](https://python.org)
|
|
[](https://en.wikipedia.org/wiki/C99)
|
|
[](LICENSE)
|
|
|
|
A programming language with Python-style indentation, built from scratch. Two implementations: a tree-walking interpreter in Python, and a zero-dependency C99 compiler.
|
|
|
|
## What Works Today
|
|
|
|
The Python interpreter supports:
|
|
|
|
- **Variables**: `let`, `var`, `const` with optional type annotations
|
|
- **Functions**: `fun` keyword, parameters, `return`, recursion, closures
|
|
- **Control flow**: `if`/`elif`/`else`, `while`, `for`/`in`, `break`, `continue`
|
|
- **Types**: integers, floats, strings (with `{var}` interpolation), booleans, colors (`#FF1D6C`)
|
|
- **Collections**: lists, dicts, sets, tuples, ranges
|
|
- **Operators**: arithmetic, comparison, logical, bitwise, compound assignment
|
|
- **Builtins**: `print`, `len`, `range`, `str`, `int`, `abs`, `min`, `max`, `sorted`, `input`, and more
|
|
- **Member access**: string/list/dict methods (`.upper()`, `.append()`, `.keys()`)
|
|
|
|
```road
|
|
fun fibonacci(n):
|
|
if n <= 1:
|
|
return n
|
|
return fibonacci(n - 1) + fibonacci(n - 2)
|
|
|
|
let result = fibonacci(10)
|
|
print(result) # 55
|
|
```
|
|
|
|
```road
|
|
let name = "world"
|
|
let msg = "hello {name}"
|
|
print(msg) # hello world
|
|
|
|
let xs = [1, 2, 3, 4, 5]
|
|
let total = 0
|
|
for x in xs:
|
|
total += x
|
|
print(total) # 15
|
|
```
|
|
|
|
## Architecture
|
|
|
|
```
|
|
source.road
|
|
|
|
|
v
|
|
Lexer (lexer.py, 462 LOC)
|
|
| Tokens: keywords, literals, operators, INDENT/DEDENT
|
|
v
|
|
Parser (parser.py, 826 LOC)
|
|
| AST nodes defined in ast_nodes.py (462 LOC)
|
|
v
|
|
Interpreter (interpreter.py, 320 LOC)
|
|
Tree-walking execution with Environment chain
|
|
```
|
|
|
|
The C compiler (`roadc.c`, 618 LOC) is a separate implementation that compiles `.road` files to native executables. Zero external dependencies — just a C99 compiler.
|
|
|
|
```bash
|
|
gcc -std=c99 -O2 -o roadc roadc.c
|
|
./roadc program.road
|
|
```
|
|
|
|
## Development
|
|
|
|
```bash
|
|
# Run a .road file
|
|
python roadc.py examples/fibonacci.road
|
|
|
|
# Run tests (30+ tests)
|
|
pytest tests/ -v
|
|
|
|
# Build C compiler
|
|
gcc -std=c99 -O2 -o roadc roadc.c
|
|
|
|
# Start REPL
|
|
python roadc.py
|
|
```
|
|
|
|
## Roadmap
|
|
|
|
- [ ] Type checker (static analysis pass between parser and interpreter)
|
|
- [ ] Bytecode VM (replace tree-walking for performance)
|
|
- [ ] Standard library (file I/O, math, networking)
|
|
- [ ] 3D scene graph (`space`, `cube`, `sphere` keywords — lexer ready, runtime not yet)
|
|
- [ ] Package manager
|
|
- [ ] Self-hosting compiler
|
|
|
|
## License
|
|
|
|
Proprietary — BlackRoad OS, Inc.
|
|
|
|
## Related Projects
|
|
|
|
| Project | Description |
|
|
|---------|-------------|
|
|
| [RoadC Playground](https://github.com/blackboxprogramming/roadc-playground) | Interactive browser IDE for RoadC |
|
|
| [Universal Computer](https://github.com/blackboxprogramming/universal-computer) | Turing machine simulator |
|
|
| [Quantum Math Lab](https://github.com/blackboxprogramming/quantum-math-lab) | Mathematical computation toolkit |
|