Crates.io | anes |
lib.rs | anes |
version | 0.2.0 |
source | src |
created_at | 2019-10-25 14:54:21.963121 |
updated_at | 2023-11-27 12:11:51.194575 |
description | ANSI Escape Sequences provider & parser |
homepage | |
repository | https://github.com/qwandor/anes-rs |
max_upload_size | |
id | 175630 |
size | 131,042 |
A Rust library which provides an ANSI escape sequences (or codes, whatever you like more)
and a parser allowing you to parse data from the STDIN (or /dev/tty
) in the raw mode.
Not all ANSI escape sequences are supported by all terminals. You can use the interactive-test to test them. Checkout the repository and then:
$ cd anes-rs
$ cargo run --bin interactive-test
[dependencies]
anes = "0.1"
An example how to retrieve the ANSI escape sequence as a String
:
use anes::SaveCursorPosition;
fn main() {
let string = format!("{}", SaveCursorPosition);
assert_eq!(&string, "\x1B7");
}
An example how to use the ANSI escape sequence:
use std::io::{Result, Write};
use anes::execute;
fn main() -> Result<()> {
let mut stdout = std::io::stdout();
execute!(
&mut stdout,
anes::SaveCursorPosition,
anes::MoveCursorTo(10, 10),
anes::RestoreCursorPosition
)?;
Ok(())
}
You have to enable parser
feature in order to use the parser. It's disabled by default.
[dependencies]
anes = { version = "0.1", features = ["parser"] }
An example how to parse cursor position:
use anes::parser::{Parser, Sequence};
let mut parser = Parser::default();
parser.advance(b"\x1B[20;10R", false);
assert_eq!(Some(Sequence::CursorPosition(10, 20)), parser.next());
assert!(parser.next().is_none());
The ANES crate is dual-licensed under Apache 2.0 and MIT terms.
Copyrights in the ANES project are retained by their contributors. No copyright assignment is required to contribute to the ANES project.