2026-01-23 15:15:05 +00:00

27 lines
778 B
Markdown

# PROMETEU Test Cartridges
This directory contains example cartridges and test suites to validate the behavior of the PROMETEU runtime and development tools.
## Available Cartridges
### 🟩 [color-square-ts](color-square-ts)
A simple cartridge that demonstrates:
- System initialization.
- Rendering a colored square in the framebuffer.
- Basic execution loop.
## Cartridge Structure
A PROMETEU cartridge (in its unpacked form) generally consists of:
- `manifest.json`: Application metadata (ID, title, version, mode).
- `program.pbc`: Compiled bytecode for the PROMETEU VM.
- `assets/`: Resources such as tiles, sprites, and audio samples.
## How to use
You can run any of these cartridges using the main CLI:
```bash
prometeu run test-cartridges/<cartridge_name>
```