envx-tui 0.6.2

Terminal user interface for envx environment variable manager
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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

mod app;
mod ui;

pub use app::App;

use color_eyre::Result;
use ratatui::{
    Terminal,
    backend::CrosstermBackend,
    crossterm::event::{self, Event},
};
use std::{
    io,
    time::{Duration, Instant},
};

/// Run the TUI application
///
/// # Errors
///
/// Returns an error if:
/// - Terminal setup fails
/// - App initialization fails
/// - Terminal operations fail during execution
/// - Cleanup operations fail
pub fn run() -> Result<()> {
    // Setup terminal
    let backend = CrosstermBackend::new(io::stdout());
    let mut terminal = Terminal::new(backend)?;

    // Create app
    let mut app = App::new()?;

    // Setup panic hook
    let panic_hook = std::panic::take_hook();
    std::panic::set_hook(Box::new(move |panic_info| {
        crossterm::execute!(io::stdout(), crossterm::terminal::LeaveAlternateScreen).ok();
        crossterm::terminal::disable_raw_mode().ok();
        panic_hook(panic_info);
    }));

    // Enter alternate screen and enable raw mode
    crossterm::terminal::enable_raw_mode()?;
    crossterm::execute!(
        io::stdout(),
        crossterm::terminal::EnterAlternateScreen,
        crossterm::event::EnableMouseCapture
    )?;

    terminal.clear()?;

    // Simple event loop with debouncing
    let mut last_key_time: Option<Instant> = None;

    loop {
        // Draw UI
        terminal.draw(|f| ui::draw(f, &mut app))?;

        // Handle events with timeout
        if event::poll(Duration::from_millis(50))? {
            if let Ok(Event::Key(key)) = event::read() {
                // Only handle key press events, ignore key release
                if key.kind == event::KeyEventKind::Press {
                    let now = Instant::now();

                    // Debounce: ignore if key pressed within 100ms
                    if let Some(last_time) = last_key_time {
                        if now.duration_since(last_time) < Duration::from_millis(50) {
                            continue;
                        }
                    }

                    last_key_time = Some(now);

                    if app.handle_key_event(key)? {
                        break;
                    }
                }
            }
        }

        // Tick for status message timeout
        app.tick();
    }

    // Cleanup
    crossterm::terminal::disable_raw_mode()?;
    crossterm::execute!(
        io::stdout(),
        crossterm::terminal::LeaveAlternateScreen,
        crossterm::event::DisableMouseCapture
    )?;

    terminal.show_cursor()?;

    Ok(())
}