cubic 0.14.0

Cubic is a lightweight command line manager for virtual machines. It has a simple, daemon-less and rootless design. All Cubic virtual machines run isolated in the user context. Cubic is built on top of QEMU, KVM and cloud-init. Show all supported images: $ cubic images Create a new virtual machine instance: $ cubic create mymachine --image ubuntu:noble List all virtual machine instances: $ cubic instances Start an instance: $ cubic start <instance name> Stop an instance: $ cubic stop <instance name> Open a shell in the instance: $ cubic ssh <machine name> Copy a file from the host to the instance: $ cubic scp <path/to/host/file> <machine>:<path/to/guest/file> Copy a file from the instance to the hots: $ cubic scp <machine>:<path/to/guest/file> <path/to/host/file> 
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

use crate::commands::{self, InstanceCloneCommand, InstanceModifyCommand, InstanceRenameCommand};
use crate::env::EnvironmentFactory;
use crate::error::Error;
use crate::image::ImageDao;
use crate::instance::InstanceDao;
use crate::view::Console;
use clap::{Parser, Subcommand};

#[derive(Subcommand)]
pub enum Commands {
    Run(commands::InstanceRunCommand),
    #[clap(alias = "add")]
    Create(commands::CreateInstanceCommand),
    #[clap(alias = "ls", alias = "list")]
    Instances(commands::ListInstanceCommand),
    Images(commands::ListImageCommand),
    Ports(commands::ListPortCommand),
    #[clap(alias = "info")]
    Show(commands::ShowCommand),
    #[clap(alias = "config")]
    Modify(InstanceModifyCommand),
    Console(commands::InstanceConsoleCommand),
    Ssh(commands::InstanceSshCommand),
    Scp(commands::InstanceScpCommand),
    Start(commands::InstanceStartCommand),
    Stop(commands::InstanceStopCommand),
    Restart(commands::InstanceRestartCommand),
    Rename(InstanceRenameCommand),
    Clone(InstanceCloneCommand),
    #[clap(alias = "rm", alias = "del")]
    Delete(commands::DeleteInstanceCommand),
    Prune(commands::PruneCommand),

    /// Image subcommands (Deprecated)
    #[command(subcommand, hide = true)]
    Image(commands::ImageCommands),
    /// Network subcommands (Deprecated)
    #[command(subcommand, hide = true)]
    Net(commands::NetworkCommands),
}

#[derive(Parser, Default)]
pub struct GlobalOptions {
    /// Increase logging output
    #[clap(short, long, action, global = true)]
    verbose: bool,
    /// Reduce logging output
    #[clap(short, long, action, global = true)]
    quiet: bool,
}

#[derive(Parser)]
#[command(author, version, about, long_about = None, arg_required_else_help = true)]
pub struct CommandDispatcher {
    #[command(subcommand)]
    pub command: Commands,

    #[clap(flatten)]
    global: GlobalOptions,
}

impl CommandDispatcher {
    pub fn dispatch(self, console: &mut dyn Console) -> Result<(), Error> {
        let verbosity = commands::Verbosity::new(self.global.verbose, self.global.quiet);
        console.set_verbosity(verbosity);
        let env = EnvironmentFactory::create_env()?;
        let image_dao = ImageDao::new(&env)?;
        let instance_dao = InstanceDao::new(&env)?;

        match self.command {
            Commands::Run(cmd) => cmd.run(console, &image_dao, &instance_dao, verbosity),
            Commands::Instances(cmd) => cmd.run(console, &instance_dao),
            Commands::Images(cmd) => cmd.run(console, &env),
            Commands::Ports(cmd) => cmd.run(console, &instance_dao),
            Commands::Create(cmd) => cmd.run(console, &image_dao, &instance_dao),
            Commands::Modify(cmd) => cmd.run(&instance_dao),
            Commands::Clone(cmd) => cmd.run(&instance_dao),
            Commands::Rename(cmd) => cmd.run(&instance_dao),
            Commands::Show(cmd) => cmd.run(console, &env, &instance_dao, &image_dao),
            Commands::Start(cmd) => cmd.run(&instance_dao, verbosity),
            Commands::Stop(cmd) => cmd.run(&instance_dao, verbosity),
            Commands::Restart(cmd) => cmd.run(&instance_dao, verbosity),
            Commands::Console(cmd) => cmd.run(&instance_dao, verbosity),
            Commands::Ssh(cmd) => cmd.run(console, &instance_dao, verbosity),
            Commands::Scp(cmd) => cmd.run(&instance_dao, verbosity),
            Commands::Delete(cmd) => cmd.run(&instance_dao, verbosity),
            Commands::Image(command) => command.dispatch(console, &image_dao),
            Commands::Prune(cmd) => cmd.run(&image_dao),
            Commands::Net(command) => command.dispatch(console, &instance_dao),
        }
    }
}