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 ```

``` TIS-100 Puzzle Emulator

Usage: puzzle ```

Library

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

toml [dependencies] tis-100 = "0.2.0"

Example:

```rust extern crate tis_100;

use tis100::save::parsesave; 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 = parsesave(src).unwrap(); let mut sandbox = Sandbox::fromsave(&save);

sandbox.write_console(42);

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

asserteq!(sandbox.readconsole(), Some(42)); ```