ree-cli 0.1.0

A fast terminal reset for macOS and Linux
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

use rustix::{process, termios};

use crate::{Error, display, tty};

/// Repair the kernel TTY state and reset the attached terminal emulator.
///
/// # Errors
///
/// Returns [`Error`] when no terminal is available, the process is a background
/// job, terminal state cannot be changed, or the terminfo entry cannot be read.
///
/// # Examples
///
/// ```no_run
/// ree::reset()?;
/// # Ok::<(), ree::Error>(())
/// ```
pub fn reset() -> Result<(), Error> {
    let terminal = tty::find().ok_or(Error::NoTerminal)?;
    let foreground = tty::retry_on_interrupt(|| termios::tcgetpgrp(&terminal))
        .map_err(Error::GetForegroundProcess)?;
    if foreground != process::getpgrp() {
        return Err(Error::NotForegroundProcess);
    }

    tty::retry_on_interrupt(|| termios::tcflow(&terminal, termios::Action::OOn))
        .map_err(Error::ResumeOutput)?;

    let mut mode = tty::retry_on_interrupt(|| termios::tcgetattr(&terminal))
        .map_err(Error::GetTerminalState)?;
    tty::repair_terminal_mode(&mut mode);
    tty::retry_on_interrupt(|| {
        termios::tcsetattr(&terminal, termios::OptionalActions::Flush, &mode)
    })
    .map_err(Error::SetTerminalState)?;

    display::reset(&terminal)
}