cubic 0.17.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
93
94
95

use crate::image::Arch;
use regex::Regex;
use std::fmt;
use std::str::FromStr;

#[cfg(target_arch = "aarch64")]
pub fn get_default_arch() -> Arch {
    Arch::ARM64
}

#[cfg(not(target_arch = "aarch64"))]
pub fn get_default_arch() -> Arch {
    Arch::AMD64
}

#[derive(Clone)]
pub struct ImageName {
    vendor: String,
    name: String,
    arch: Arch,
}

impl ImageName {
    pub fn get_vendor(&self) -> &str {
        &self.vendor
    }

    pub fn get_name(&self) -> &str {
        &self.name
    }

    pub fn get_arch(&self) -> Arch {
        self.arch
    }
}

impl FromStr for ImageName {
    type Err = String;

    fn from_str(name: &str) -> Result<Self, Self::Err> {
        if Regex::new("^(\\w+):([\\w\\.]+)(:(amd64|arm64))?$")
            .unwrap()
            .is_match(name)
        {
            let mut tokens = name.split(':');
            let vendor = tokens.next().unwrap().to_string();
            let name = tokens.next().unwrap().to_string();
            let arch = tokens
                .next()
                .map(|x| Arch::from_str(x).unwrap())
                .unwrap_or(get_default_arch());

            Ok(Self { vendor, name, arch })
        } else {
            Err(
                "Image name must have the format: vendor:name[:arch] (e.g. debian:bookworm, debian:buster:amd64)"
                    .to_string(),
            )
        }
    }
}

impl fmt::Display for ImageName {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> Result<(), fmt::Error> {
        write!(f, "{}", self.name)
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_debian_bookworm() {
        let image = ImageName::from_str("debian:bookworm").unwrap();
        assert_eq!(image.get_vendor(), "debian");
        assert_eq!(image.get_name(), "bookworm");
    }

    #[test]
    fn test_debian_bookworm_amd64() {
        let image = ImageName::from_str("debian:buster:amd64").unwrap();
        assert_eq!(image.get_vendor(), "debian");
        assert_eq!(image.get_name(), "buster");
        assert_eq!(image.get_arch(), Arch::AMD64);
    }

    #[test]
    fn test_debian_bookworm_arm64() {
        let image = ImageName::from_str("debian:bookworm:arm64").unwrap();
        assert_eq!(image.get_vendor(), "debian");
        assert_eq!(image.get_name(), "bookworm");
        assert_eq!(image.get_arch(), Arch::ARM64);
    }
}