tis-100-rs

An emulator for the TIS-100 written in Rust.

NOTE: This project targets the rust-nightly channel.

Binaries

This project includes two binaries: sandbox, which implements the TIS-100 Simple Sandbox puzzle, and puzzle, which can execute arbitrary puzzles given a spec file and a save file.

TIS-100 Sandbox Emulator

Usage:
    sandbox <save.txt>

TIS-100 Puzzle Emulator

Usage:
    puzzle <spec.lua> <save.txt>

Library

If you want to embed a TIS-100 emulator in your Rust project, simply add the following dependency to your Cargo.toml:

[dependencies]
tis-100 = "0.2.0"

Example:

extern crate tis_100;

use tis_100::save::parse_save;
use tis_100::machine::Sandbox;

// This program reads the value from the console and simply passes it to the console output.
let src = "@1\nMOV UP DOWN\n@5\nMOV UP DOWN\n@9\nMOV UP RIGHT\n@10\nMOV LEFT DOWN\n";

let save = parse_save(src).unwrap();
let mut sandbox = Sandbox::from_save(&save);

sandbox.write_console(42);

for _ in 0..5 {
    sandbox.step();
}

assert_eq!(sandbox.read_console(), Some(42));