RustyLine

RustyLine 是基于 Antirez' Linenoise 的 Readline 实现

支持的平台

• Unix（在 FreeBSD、Linux 和 macOS 上进行了测试）
• Windows
  • cmd.exe
  • Powershell

注意:

• Powershell ISE 不受支持，请参阅 问题 #56
• Mintty（Cygwin/MinGW）不受支持
• 在 Windows < Windows 10 上不支持高亮显示/颜色，除非使用 ConEmu 和 ColorMode::Forced。

示例

use rustyline::error::ReadlineError;
use rustyline::{DefaultEditor, Result};

fn main() -> Result<()> {
    // `()` can be used when no completer is required
    let mut rl = DefaultEditor::new()?;
    #[cfg(feature = "with-file-history")]
    if rl.load_history("history.txt").is_err() {
        println!("No previous history.");
    }
    loop {
        let readline = rl.readline(">> ");
        match readline {
            Ok(line) => {
                rl.add_history_entry(line.as_str());
                println!("Line: {}", line);
            },
            Err(ReadlineError::Interrupted) => {
                println!("CTRL-C");
                break
            },
            Err(ReadlineError::Eof) => {
                println!("CTRL-D");
                break
            },
            Err(err) => {
                println!("Error: {:?}", err);
                break
            }
        }
    }
    #[cfg(feature = "with-file-history")]
    rl.save_history("history.txt");
    Ok(())
}

crates.io

您可以通过在您的 Cargo.toml 中添加以下内容来在项目中使用此包

[dependencies]
rustyline = "14.0.0"

特性

• Unicode（UTF-8）（linenoise 仅支持 ASCII）
• 单词完成（linenoise 仅支持行完成）
• 文件名完成
• 历史搜索（在历史中搜索命令）
• 删除环（删除命令）
• 多行支持（换行）
• 单词命令
• 提示

操作

对所有模式

Emacs模式（默认模式）

Readline Emacs编辑模式速查表

vi命令模式

vi插入模式

Readline vi编辑模式速查表

终端代码（ANSI/VT100）

Wine

$ cargo run --example example --target 'x86_64-pc-windows-gnu'
...
Error: Io(Error { repr: Os { code: 6, message: "Invalid handle." } })
$ wineconsole --backend=curses target/x86_64-pc-windows-gnu/debug/examples/example.exe
...

终端检查

$ # current settings of all terminal attributes:
$ stty -a
$ # key bindings:
$ bind -p
$ # print out a terminfo description:
$ infocmp

类似的项目

多行支持

这是一个非常简单的功能，它只会在当前终端宽度超出行长时，将行显示在下一视觉行，而不是在输入更多字符时水平滚动。目前，此功能始终启用，没有配置选项可以禁用它。

此功能不允许最终用户按下特殊键序列并进入一种模式，在该模式下，按下回车键将在输入缓冲区中添加一个实际的换行符。

实现多行编辑的方法是实现Validator特质。