reustmann 0.1.0

Reustmann is a Von Neumann architecture
Documentation

Reustmann - a Von Neumann architecture

Build Status

Reustmann is a Von Neumann architecture in Rust. All rights goes to the dave miller Iota machine.

I just recreate it in Rust.

The Reustmann Documentation

How to

The hello_world.rm program

Gp..OOOOOOOOOOOOHTFello World!

First create a program, from a file for example

extern crate reustmann;

use std::fs::File;
use reustmann::Program;

let ignore_last_newline = true;
let file = File::open("./hello_world.rm").unwrap();

// it accept anything implementing the `std::io::Read` trait
let program = Program::new(file, ignore_last_newline).unwrap();

Then use this program to fill the interpreter memory

use reustmann::Interpreter;

let arch_length = 50; // memory length
let arch_width = 8; // word size

let mut interpreter = Interpreter::new(arch_length, arch_width).unwrap();
interpreter.copy_program_and_reset(&program).unwrap();

Launch it, launch it now !!!

use reustmann::Statement;
use reustmann::instruction::op_codes;
use std::io::{empty, stdout};
// use std::io::sink; // for no output

let mut input = empty(); // no input data needed
let mut output = stdout(); // output on the standard

loop {
    // each interpreter step return a statement
    // while no `HALT` statement is found, we continue
    match interpreter.step(&mut input, &mut output) {
        Statement(op_codes::HALT, _) => break,
        _ => ()
    }
}

You can have debug informations at any moment

// put this in the previous match, at the good place ;)
println!("{:?}", interpreter.debug_infos());

TODO

  • make interpreter unit tests for each instruction (add coveralls.io)
  • add launch options to executable (--input, --output...)
  • change interpreter command names in the debugger, make them more clear
  • format! correctly pc_side and sp_side on the debugger
  • add rustyline autocompletion for commands, command options...