#pty #terminal #tty

ptyprocess

A library to work with PTY/TTY on Unix systems

13 releases

0.4.1 Mar 6, 2023
0.4.0 Mar 5, 2023
0.3.0 Dec 11, 2021
0.2.0 Oct 7, 2021
0.1.9 Jul 28, 2021

#452 in Command-line interface

Download history 2033/week @ 2024-11-16 2443/week @ 2024-11-23 2170/week @ 2024-11-30 2032/week @ 2024-12-07 1992/week @ 2024-12-14 1087/week @ 2024-12-21 1190/week @ 2024-12-28 2369/week @ 2025-01-04 2578/week @ 2025-01-11 3589/week @ 2025-01-18 3212/week @ 2025-01-25 2816/week @ 2025-02-01 2393/week @ 2025-02-08 2232/week @ 2025-02-15 3016/week @ 2025-02-22 3646/week @ 2025-03-01

11,708 downloads per month
Used in 24 crates (4 directly)

MIT license

29KB
519 lines

ptyprocess Build codecov Crate docs.rs license

A library provides an interface for a unix PTY/TTY.

It aims to work on all major Unix variants.

The library was developed as a backend for a https://github.com/zhiburt/expectrl. If you're interested in a high level operations may you'd better take a look at zhiburt/expectrl.

Usage

use ptyprocess::PtyProcess;
use std::io::{BufRead, BufReader, Result, Write};
use std::process::Command;

fn main() -> Result<()> {
    // spawn a cat process
    let mut process = PtyProcess::spawn(Command::new("cat"))?;

    // create a communication stream
    let mut stream = process.get_raw_handle()?;

    // send a message to process
    writeln!(stream, "Hello cat")?;

    // read a line from the stream
    let mut reader = BufReader::new(stream);
    let mut buf = String::new();
    reader.read_line(&mut buf)?;

    println!("line was entered {buf:?}");

    // stop the process
    assert!(process.exit(true)?);

    Ok(())
}

Dependencies

~1.5MB
~35K SLoC