terrazzo-terminal 0.2.7

A simple web-based terminal emulator built on Terrazzo.
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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134

#![cfg(feature = "terminal")]

use serde::Deserialize;
use serde::Serialize;

use crate::api::client_address::ClientAddress;
use crate::terminal_id::TerminalId;
use crate::tiles::id::TileId;

pub const STREAMING_WINDOW_SIZE: usize = 200 * 1000;

#[derive(Debug, Clone, Copy, Serialize, Deserialize)]
pub struct Size {
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "r"))]
    pub rows: i32,
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "c"))]
    pub cols: i32,
}

#[derive(Debug, Serialize, Deserialize)]
pub struct Chunk {
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "t"))]
    pub terminal_id: TerminalId,
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "d"))]
    pub data: Option<Vec<u8>>,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct TerminalAddress {
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "t"))]
    pub id: TerminalId,
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "a"))]
    pub via: ClientAddress,
}

mod display_terminal_address {
    use std::fmt::Display;

    impl Display for super::TerminalAddress {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
            write!(f, "{} via {}", self.id, self.via)
        }
    }
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct TerminalDefImpl<T> {
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "a"))]
    pub address: TerminalAddress,
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "t"))]
    pub title: T,
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "o"))]
    pub order: i32,
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "i"))]
    pub tile: TileId,
}

#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
pub struct TabTitle<T> {
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "t"))]
    pub shell_title: T,
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "o"))]
    pub override_title: Option<T>,
}

#[cfg(feature = "client")]
impl<T> TabTitle<T> {
    pub fn map<U>(self, f: impl Fn(T) -> U) -> TabTitle<U> {
        TabTitle {
            shell_title: f(self.shell_title),
            override_title: self.override_title.map(f),
        }
    }
}

pub type TerminalDef = TerminalDefImpl<TabTitle<String>>;

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct NewTerminalRequest {
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "a"))]
    pub address: ClientAddress,
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "i"))]
    pub tile: TileId,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct RegisterTerminalRequest {
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "m"))]
    pub mode: RegisterTerminalMode,
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "d"))]
    pub def: TerminalDef,
}

#[derive(Clone, Copy, Debug, Serialize, Deserialize, PartialEq, Eq)]
pub enum RegisterTerminalMode {
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "C"))]
    Create,
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "R"))]
    Reopen,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct WriteRequest<T = TerminalAddress> {
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "t"))]
    pub terminal: T,
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "d"))]
    pub data: String,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct ResizeRequest<T = TerminalAddress> {
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "t"))]
    pub terminal: T,
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "s"))]
    pub size: Size,
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "f"))]
    pub force: bool,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct SetTitleRequest<T = TerminalAddress> {
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "t"))]
    pub terminal: T,
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "v"))]
    pub title: TabTitle<String>,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct AckRequest<T = TerminalAddress> {
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "t"))]
    pub terminal: T,
    #[cfg_attr(not(feature = "diagnostics"), serde(rename = "d"))]
    pub ack: usize,
}