Rustbox is a Rust implementation of termbox.
Currently, this is just a wrapper of the C library by nsf, though my plan is to convert it to be a pure Rust implementation and remove the requirement on the C library.
The original implementation of this was inspired by Aaron Pribadi, so big props to him for the original work.
NOTE This is under development, and the APIs may change as I figure out more how Rust works and as the language itself changes
The best way to use Rustbox is in your Cargo config file. You are using Cargo, right? ;)
In your Cargo.toml
add the following:
[dependencies]
rustbox = "0.1.0"
You can also use the current git version by instead adding:
[dependencies.rustbox]
git = "https://github.com/gchp/rustbox.git"
Then, in your src/example.rs
:
extern crate rustbox;
use std::char;
use std::io::stdio;
use std::error::Error;
use rustbox::{Color, RustBox, InitOption};
fn main() {
let options = [
if stdio::stderr_raw().isatty() { Some(InitOption::BufferStderr) } else { None },
];
let rustbox = RustBox::init(&options).unwrap();
rustbox.print(1, 1, rustbox::RB_BOLD, Color::White, Color::Black, "Hello, world!");
rustbox.print(1, 3, rustbox::RB_BOLD, Color::White, Color::Black,
"Press 'q' to quit.");
rustbox.present();
loop {
match rustbox.poll_event() {
Ok(rustbox::Event::KeyEvent(_, _, ch)) => {
match char::from_u32(ch) {
Some('q') => { break; },
_ => {}
}
},
Err(e) => panic!("{}", e.description()),
_ => { }
}
}
}