Lib.rs

	文档	示例	变更日志	教程

Termion 是一个纯Rust，无绑定库，用于低级处理、操作和读取有关终端的信息。它为Termbox提供了一个功能齐全的替代方案。

Termion旨在简单且富有表达力。它是无绑定的，这意味着它不是其他库（例如ncurses或termbox）的前端，而是一个直接与TTY通信的独立库。

Termion非常方便，因为它全面覆盖了基本的TTY功能，提供了一致的API。Termion相当低级，只包含与幕后实际发生的事情相匹配的抽象。对于更高级的应用，请参阅inquirer-rs，它使用Termion作为后端。

Termion为用户生成转义和API调用。这使得使用转义变得更加简洁。

支持Redox、Mac OS X、BSD和Linux（或一般而言，ANSI终端）。

关于稳定性的说明

此crate是稳定的。

Cargo.toml

[dependencies]
termion = "*"

0.1.0到1.0.0指南

以下示例表提供了如何将Termion转换为新主要版本的思路。

功能

• 原始模式。
• 真彩色。
• 256色模式。
• 光标移动。
• 文本格式化。
• 控制台大小。
• 仅TTY流。
• 控制序列。
• Termios控制。
• 密码输入。
• Redox支持。
• 安全的 isatty 包装器。
• 无恐慌错误处理。
• 特殊键事件（修饰符，特殊键等）。
• 无分配。
• 异步键盘事件。
• 鼠标输入。
• 经过仔细测试。
• 每个项目都有详细文档。

等等。

示例

样式和颜色。

extern crate termion;

use termion::{color, style};

use std::io;

fn main() {
    println!("{}Red", color::Fg(color::Red));
    println!("{}Blue", color::Fg(color::Blue));
    println!("{}Blue'n'Bold{}", style::Bold, style::Reset);
    println!("{}Just plain italic", style::Italic);
}

移动光标

extern crate termion;

fn main() {
    print!("{}{}Stuff", termion::clear::All, termion::cursor::Goto(1, 1));
}

鼠标

extern crate termion;

use termion::event::{Key, Event, MouseEvent};
use termion::input::{TermRead, MouseTerminal};
use termion::raw::IntoRawMode;
use std::io::{Write, stdout, stdin};

fn main() {
    let stdin = stdin();
    let mut stdout = MouseTerminal::from(stdout().into_raw_mode().unwrap());

    write!(stdout, "{}{}q to exit. Click, click, click!", termion::clear::All, termion::cursor::Goto(1, 1)).unwrap();
    stdout.flush().unwrap();

    for c in stdin.events() {
        let evt = c.unwrap();
        match evt {
            Event::Key(Key::Char('q')) => break,
            Event::Mouse(me) => {
                match me {
                    MouseEvent::Press(_, x, y) => {
                        write!(stdout, "{}x", termion::cursor::Goto(x, y)).unwrap();
                    },
                    _ => (),
                }
            }
            _ => {}
        }
        stdout.flush().unwrap();
    }
}

读取密码

extern crate termion;

use termion::input::TermRead;
use std::io::{Write, stdout, stdin};

fn main() {
    let stdout = stdout();
    let mut stdout = stdout.lock();
    let stdin = stdin();
    let mut stdin = stdin.lock();

    stdout.write_all(b"password: ").unwrap();
    stdout.flush().unwrap();

    let pass = stdin.read_passwd(&mut stdout);

    if let Ok(Some(pass)) = pass {
        stdout.write_all(pass.as_bytes()).unwrap();
        stdout.write_all(b"\n").unwrap();
    } else {
        stdout.write_all(b"Error\n").unwrap();
    }
}

用法

请参阅 examples/ 和文档，这些文档可以使用 cargo doc 渲染。

要查看更完整的示例，请参阅我在Redox中使用termion制作的扫雷实现。

许可协议

MIT/X11。