carte 0.6.0

Runs your apps' processes on demand behind *.localhost hostnames, one stack per git worktree
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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

//! The daemon's side of `carte attach`: an upgraded connection that carries a
//! process's output to the client and the client's typing to the process.

use std::io;

use bytes::Bytes;
use carte_api::attach::{Attached, Frame, FrameReader};
use tokio::io::{AsyncRead, AsyncReadExt, AsyncWrite, AsyncWriteExt};
use tokio::sync::broadcast::error::{RecvError, TryRecvError};
use tokio::sync::mpsc;
use tokio_util::task::AbortOnDropHandle;

use crate::supervisor::terminal::Client;

enum Step {
    Read(io::Result<usize>),
    Output(Result<Bytes, RecvError>),
    Ended(String),
    WriterGone,
}

/// Runs one attached client until either side goes away or the process exits.
/// Input is written by its own task, which the session stops when it ends, so a
/// process that doesn't read its input never holds up the session.
pub async fn session<S: AsyncRead + AsyncWrite + Unpin>(
    io: S,
    attached: Attached,
    mut client: Client,
) {
    let (mut reader, mut writer) = tokio::io::split(io);
    let mut first = Frame::Attached(attached).encode();
    if !client.replay.is_empty() {
        first.extend(Frame::Output(std::mem::take(&mut client.replay)).encode());
    }
    if writer.write_all(&first).await.is_err() {
        return;
    }
    let (input, mut queued) = mpsc::channel::<Vec<u8>>(256);
    let pty = client.writer();
    let mut writing = AbortOnDropHandle::new(tokio::spawn(async move {
        while let Some(data) = queued.recv().await {
            if pty.write(&data).await.is_err() {
                return;
            }
        }
    }));
    let mut frames = FrameReader::default();
    let mut buf = vec![0u8; 16 * 1024];
    loop {
        let step = tokio::select! {
            read = reader.read(&mut buf) => Step::Read(read),
            data = client.output.recv() => Step::Output(data),
            ended = client.ended.wait_for(Option::is_some) => match ended {
                Ok(message) => Step::Ended(message.clone().unwrap_or_default()),
                Err(_) => return,
            },
            _ = &mut writing => Step::WriterGone,
        };
        match step {
            Step::Read(Ok(0) | Err(_)) | Step::WriterGone => return,
            Step::Read(Ok(n)) => {
                frames.feed(&buf[..n]);
                loop {
                    match frames.next_frame() {
                        Ok(Some(Frame::Input(data))) => {
                            if input.try_send(data).is_err() {
                                let notice = Frame::Output(
                                    b"\r\n[carte: input dropped; the process isn't reading]\r\n"
                                        .to_vec(),
                                );
                                if writer.write_all(&notice.encode()).await.is_err() {
                                    return;
                                }
                            }
                        }
                        Ok(Some(Frame::Resize(size))) => client.resize(size),
                        Ok(Some(_)) => {}
                        Ok(None) => break,
                        Err(_) => return,
                    }
                }
            }
            Step::Output(Ok(data)) => {
                if writer
                    .write_all(&Frame::Output(data.to_vec()).encode())
                    .await
                    .is_err()
                {
                    return;
                }
            }
            Step::Output(Err(RecvError::Lagged(_))) => {
                let notice = Frame::Output(b"\r\n[carte: some output was skipped]\r\n".to_vec());
                if writer.write_all(&notice.encode()).await.is_err() {
                    return;
                }
            }
            Step::Output(Err(RecvError::Closed)) => return,
            Step::Ended(message) => {
                let mut last = Vec::new();
                loop {
                    match client.output.try_recv() {
                        Ok(data) => last.extend(Frame::Output(data.to_vec()).encode()),
                        Err(TryRecvError::Lagged(_)) => {}
                        Err(TryRecvError::Empty | TryRecvError::Closed) => break,
                    }
                }
                last.extend(Frame::Ended(message).encode());
                let _ = writer.write_all(&last).await;
                let _ = writer.shutdown().await;
                return;
            }
        }
    }
}