#io #tty #process #terminal #readable #writable #write

terminal-trx

Provides a handle to the terminal of the current process

5 releases

0.2.3 Aug 22, 2024
0.2.2 Jul 31, 2024
0.2.1 Jun 7, 2024
0.2.0 Feb 2, 2024
0.1.0 Jan 20, 2024

#190 in Command-line interface

Download history 525/week @ 2024-07-03 713/week @ 2024-07-10 604/week @ 2024-07-17 584/week @ 2024-07-24 1486/week @ 2024-07-31 820/week @ 2024-08-07 1588/week @ 2024-08-14 1674/week @ 2024-08-21 999/week @ 2024-08-28 1129/week @ 2024-09-04 974/week @ 2024-09-11 623/week @ 2024-09-18 838/week @ 2024-09-25 1101/week @ 2024-10-02 631/week @ 2024-10-09 488/week @ 2024-10-16

3,166 downloads per month
Used in 2 crates (via terminal-colorsaurus)

MIT/Apache

43KB
905 lines

terminal-trx

Docs Crate Version

Pronounced: Terminal T-Rex 🦖

Provides a handle to the terminal of the current process that is both readable and writable.

Example

use terminal_trx::terminal;
use std::io::{BufReader, BufRead as _, Write as _};

let mut terminal = terminal().unwrap();

write!(terminal, "hello world").unwrap();

let mut reader = BufReader::new(&mut terminal);
let mut line = String::new();
reader.read_line(&mut line).unwrap();

Docs

Wishlist

These are some features that I would like to include in this crate, but have not yet had the time to implement. Anyone is welcome to create a PR :)

  • Add integration tests.
  • Share the Terminal instance (like stdout, stderr, stdin in the standard library do). (Is this a good idea?)
  • Support enabling raw mode on MSYS/Cygwin.

Inspiration

This crate draws inspiration from many great resources, such as:

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions

Dependencies

~0–8.5MB
~64K SLoC