Add files

Author: agatan

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Naomichi Agata
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,42 @@
+## termfest
+
+termfest is a thread-safe TUI library that provides simple APIs to render texts in terminal, heavily inspired by nsf/termbox-go.
+Currently, termfest doesn't support windows because of my poor windows experience.
+
+termfest has internal buffer for efficient rendering.
+Applications can render everything to the buffer every time, and termfest flushes the buffer and renders only the difference between the terminal state and the buffer.
+
+```rust
+use termfest::{Termfest, Event};
+use termfest::attr::*;
+use termfest::key::*;
+
+// first, initialize termfest.
+let (fest, events) = Termfest::hold().unwrap();
+
+let mut y = 0;
+
+// events is a receiver of a channel that accepts terminal events like key input.
+for ev in events.iter() {
+    {
+        // lock the screen.
+        let mut screen = fest.lock_screen();
+        // clear the buffer. you can render everything every time.
+        // termfest can provide efficient rendering.
+        screen.clear();
+        // write to the buffer.
+        let attr = Attribute { fg: Color::Red, ..Attribute::default() };
+        screen.print(0, y, "Hello, world!", attr);
+        // when the screen lock is freed, the buffer is flushed.
+        // (you can flush the buffer with explicit `flush` call.)
+    }
+    match ev {
+        Event::Key(ESC) | Event::Char('q') => break,
+        Event::Key(ArrowUp) => if y > 0 { y -= 1; },
+        Event::Key(ArrowDown) => y += 1,
+        _ => {}
+    }
+}
+```
+
+See `examples` for more detail.