zfish 0.1.10

Ultra-light, zero-dependency Rust CLI framework for building beautiful command-line applications
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
39

//! Terminal manipulation utilities.

use std::io::{self, Write};

/// Terminal utilities for cursor manipulation and screen clearing.
#[derive(Debug)]
pub struct Terminal;

impl Terminal {
    /// Clear the entire screen.
    pub fn clear_screen() -> io::Result<()> {
        let stdout = io::stdout();
        let mut handle = stdout.lock();
        handle.write_all(b"\x1b[2J")?;
        handle.flush()
    }

    /// Move the cursor to the specified position (1-based coordinates).
    pub fn move_cursor(row: u16, col: u16) -> io::Result<()> {
        let stdout = io::stdout();
        let mut handle = stdout.lock();
        write!(handle, "\x1b[{};{}H", row, col)?;
        handle.flush()
    }

    /// Get the terminal size (width, height) if available.
    pub fn size() -> Option<(u16, u16)> {
        crate::os::get_terminal_size()
    }

    /// Print text at the specified position.
    pub fn print_at(row: u16, col: u16, text: &str) -> io::Result<()> {
        Self::move_cursor(row, col)?;
        let stdout = io::stdout();
        let mut handle = stdout.lock();
        handle.write_all(text.as_bytes())?;
        handle.flush()
    }
}