shell-cell 1.6.3

Shell-Cell. CLI app to spawn and manage containerized shell environments
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

//! Command Line Interface implementation

mod cleanup;
mod init;
mod ls;
mod run;
mod stop;
mod terminal;

use std::{path::PathBuf, time::Duration};

use clap::{Parser, Subcommand};
use color_eyre::Section;

use crate::{crate_info, error::UserError, scell::types::name::TargetName};

// 60 frames per second
const MIN_FPS: Duration = Duration::from_millis(1000 / 60);

#[derive(Parser)]
#[clap(version = crate_info::version())]
#[clap(about = crate_info::description())]
pub struct Cli {
    /// Path to the directory with 'scell.cue' file (optional),
    #[clap(value_name = "FILE", default_value = ".")]
    scell_path: PathBuf,

    /// Entry point target name to execute, instead of 'main' (optional)
    #[clap(short, long)]
    target: Option<TargetName>,

    /// Run the container without attaching to the shell session
    #[clap(short, long)]
    detach: bool,

    /// Suppress Docker build logs
    #[clap(short, long)]
    quiet: bool,

    #[clap(subcommand)]
    command: Option<Commands>,
}

#[derive(Subcommand)]
pub enum Commands {
    /// Create a minimal `scell.cue` blueprint in the target directory
    Init {
        /// Directory to create the blueprint in (defaults to current directory)
        #[clap(value_name = "PATH", default_value = ".")]
        path: PathBuf,
    },
    /// List all existing Shell-Cell containers
    Ls,
    /// Stop all running Shell-Cell containers
    Stop,
    /// Clean up all orphan Shell-Cell containers with their corresponding images and just
    /// single images (those no longer associated with any existing Shell-Cell
    /// blueprint files).
    Cleanup {
        /// Remove ALL Shell-Cell containers and images, not only orphaned ones
        #[clap(long)]
        all: bool,
    },
}

impl Cli {
    pub async fn exec(self) -> color_eyre::Result<()> {
        const SUGGESTION: &str = "If you've got a second, please toss a full backtrace into your ticket—it helps us squash the bug way faster! You can grab it by running the app with `RUST_BACKTRACE=1`.";

        self.exec_inner().await.map_err(|e| {
            if e.is::<UserError>() {
                e
            } else {
                e.note(format!(
                    "Internal bug, please report it `{}/issues/new`",
                    crate_info::repository()
                ))
                .suggestion(SUGGESTION)
            }
        })?;

        Ok(())
    }

    pub async fn exec_inner(self) -> color_eyre::Result<()> {
        match self.command {
            None => run::run(self.scell_path, self.target, self.detach, self.quiet).await?,
            Some(Commands::Init { path }) => init::init(path)?,
            Some(Commands::Ls) => ls::ls().await?,
            Some(Commands::Stop) => stop::stop().await?,
            Some(Commands::Cleanup { all }) => cleanup::cleanup(all).await?,
        }
        Ok(())
    }
}