9 releases

0.2.5 Aug 15, 2024
0.2.4 Mar 2, 2021
0.2.3 Feb 26, 2021
0.2.1 Sep 7, 2020
0.0.1 Aug 25, 2020

#256 in Command-line interface

Download history 16/week @ 2024-07-25 1/week @ 2024-08-01 114/week @ 2024-08-15 6/week @ 2024-09-12 23/week @ 2024-09-19 23/week @ 2024-09-26 9/week @ 2024-10-03

516 downloads per month

Zlib OR Apache-2.0 OR MIT

405KB
8K SLoC

C 7.5K SLoC // 0.3% comments Rust 741 SLoC // 0.1% comments Shell 16 SLoC

License:Zlib Minimum Rust Version crates.io docs.rs

yacurses

yet another curses lib


lib.rs:

Yet another curses library.

This crate binds to either the system ncurses on Unix (MIT-X11 license), or a bundled copy of pdcurses on Windows (public domain). It then exposes a somewhat rustified interface on top of curses.

The interface offered is fully safe, but does not expose every single part of the curses API. For example, this only supports a single window, and it does not support any of the functions that print via format-string.

The interface offered should be useful for the majority of cases.

Usage

This crate is accessed through a Curses handle (traditionally called "win", for "window"). Use the init method to start curses mode. Dropping the struct will automatically end curses mode.

Caution: Curses mode is a global effect, and attempting to double-initialize curses will panic. Also, if curses fails to initialize, the curses library itself will print a message and abort your process.

use yacurses::*;

fn main() {
  let mut win = Curses::init();
  win.move_cursor(Position { x: 3, y: 2 });
  win.print_str("demo message");
  win.poll_events(); // by default, this blocks until an event comes in.
}

Panic Hook

The default panic hook will print the panic message and then unwind. If this happens while curses mode is active, curses mode will just eat the message and you won't see what went wrong. To resolve this, yacurses installs a custom panic hook when you turn it on, and restores the previous panic hook when it closes down. This all happens automatically.

A side effect of this is that if you also wanted to have your own panic hook going on, then there can end up being conflicts. Sorry about that, not much can be done there.

No runtime deps