udb 0.4.21

Universal Data Broker — a Rust gRPC broker over multiple databases (Postgres, MySQL, SQLite, MongoDB, ClickHouse, Cassandra, MSSQL, Redis, Qdrant, S3, Neo4j, …) with per-tenant RLS, 2PC, sagas, and CDC.
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

#![allow(unexpected_cfgs)]

use crate::tui::{TuiError, TuiResult};

/// RAII guard for raw mode and alternate-screen terminal state.
///
/// The enabled implementation owns the Ratatui terminal and restores the
/// original terminal state in `Drop`, including panic and early-return paths.
#[cfg(feature = "tui")]
pub struct TerminalSession {
    terminal: ratatui::Terminal<ratatui::backend::CrosstermBackend<std::io::Stdout>>,
}

#[cfg(feature = "tui")]
impl TerminalSession {
    /// Enter raw mode and switch to the alternate screen.
    pub fn enter() -> TuiResult<Self> {
        use crossterm::{
            execute,
            terminal::{EnterAlternateScreen, enable_raw_mode},
        };

        enable_raw_mode().map_err(|error| TuiError::Terminal(error.to_string()))?;

        let mut stdout = std::io::stdout();
        if let Err(error) = execute!(stdout, EnterAlternateScreen) {
            let _ = crossterm::terminal::disable_raw_mode();
            return Err(TuiError::Terminal(error.to_string()));
        }

        let backend = ratatui::backend::CrosstermBackend::new(stdout);
        let terminal = ratatui::Terminal::new(backend)
            .map_err(|error| TuiError::Terminal(error.to_string()))?;

        Ok(Self { terminal })
    }

    /// Access the underlying Ratatui terminal for drawing.
    pub fn terminal(
        &mut self,
    ) -> &mut ratatui::Terminal<ratatui::backend::CrosstermBackend<std::io::Stdout>> {
        &mut self.terminal
    }
}

#[cfg(feature = "tui")]
impl Drop for TerminalSession {
    fn drop(&mut self) {
        use crossterm::{
            execute,
            terminal::{LeaveAlternateScreen, disable_raw_mode},
        };

        let _ = disable_raw_mode();
        let _ = execute!(self.terminal.backend_mut(), LeaveAlternateScreen);
        let _ = self.terminal.show_cursor();
    }
}

/// Stub guard used when the `tui` feature is absent.
#[cfg(not(feature = "tui"))]
#[derive(Debug, Default)]
pub struct TerminalSession;

#[cfg(not(feature = "tui"))]
impl TerminalSession {
    /// Return a clear error instead of touching terminal state.
    pub fn enter() -> TuiResult<Self> {
        Err(TuiError::FeatureDisabled("tui"))
    }
}