17 releases (5 breaking)

0.5.2 Jun 17, 2016
0.5.0 May 25, 2016
0.4.1 Dec 27, 2015
0.1.2 Jul 29, 2015
0.0.4 Mar 26, 2015

#142 in Command-line interface

Download history 35/week @ 2019-11-28 19/week @ 2019-12-05 371/week @ 2019-12-12 17/week @ 2019-12-26 1/week @ 2020-01-02 25/week @ 2020-01-09 87/week @ 2020-01-16 2/week @ 2020-01-23 4/week @ 2020-01-30 6/week @ 2020-02-06 20/week @ 2020-02-13 42/week @ 2020-02-20 37/week @ 2020-02-27 35/week @ 2020-03-05 22/week @ 2020-03-12

264 downloads per month
Used in 5 crates (3 directly)

GPL license

2.5MB
28K SLoC

BrightScript 24K SLoC // 0.2% comments Razor 4K SLoC // 0.5% comments

readline-sys

Version

Crates.io Build Status

Native bindings to libreadline.

Features

  • thin wrappers around readline and add_history
  • write history line to file: add_history_persist
  • load history from file: preload_history
  • library version: version

API Documentation

Rustdocs

Usage

Add rl-sys as a dependency in Cargo.toml

[dependencies]
rl-sys = "~0.5.2"

A simple implementation of cat using rl_sys::readline

extern crate rl_sys;

use rl_sys::readline;
use rl_sys::history::listmgmt;

fn main() {
    loop {
        let input: String = match readline::readline("") {
            Ok(Some(s)) => s,
            Ok(None) => break,  // user entered ctrl-d
            Err(e) => {
                println!("{}", e);
                continue;
            }
        };
        println!("{}", input);

        // Enables up/down arrow scrolling through history
        listmgmt::add(&input).unwrap();
    }
}

Check out the more comprehensive shell example in the examples directory.

Development

To work on this crate, remember to git clone --recursive or git submodule init && git submodule update.

License

Distributed under the GNU General Public License.

Dependencies