cursive/Readme.md

30 lines
1.3 KiB
Markdown
Raw Normal View History

2015-05-09 19:28:21 +00:00
Cursive
=======
Cursive is a ncurses-based TUI (Text User Interface) library for rust. It is based on jeaye's [ncurses-rs](https://github.com/jeaye/ncurses-rs).
2015-05-19 17:01:54 +00:00
It is designed to be safe and easy to use:
2015-05-09 19:28:21 +00:00
```rust
extern crate cursive;
2015-05-19 18:01:16 +00:00
use cursive::{Cursive,Dialog,TextView};
2015-05-09 19:28:21 +00:00
fn main() {
2015-05-19 18:01:16 +00:00
let mut siv = Cursive::new();
2015-05-09 19:28:21 +00:00
2015-05-19 18:01:16 +00:00
// Create a popup window with a "Ok" button that quits the application
siv.add_layer(Dialog::new(TextView::new("Hello world!"))
.button("Quit", |s, _| s.quit()));
2015-05-09 19:28:21 +00:00
2015-05-19 18:01:16 +00:00
// Starts the event loop.
siv.run();
2015-05-09 19:28:21 +00:00
}
```
2015-05-19 17:01:54 +00:00
A few notes :
* The main focus point is _not_ performance. This is a simple layout library, guys, not [compiz](https://www.google.com/search?q=compiz&tbm=isch) piped into [libcaca](https://www.google.com/search?q=libcaca&tbm=isch). Unless you are running it on your microwave's microcontroller, it's not going to be slow.
* The library is single-threaded. Thus, callback methods are blocking - careful what you're doing in there! Feel free to use threads on your side, though.
2015-05-19 18:10:35 +00:00
* This goal is _not_ to have an equivalent to every ncurses function. You _can_ access the underlying ncurses window when creating your own custom views, so you can do what you want with that, but the main library will probably only use a subset of the ncurses features.