podcell 0.2.0

A simple Podman-based development environment manager.
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

//
// Copyright (c) 2025-present, Alessandro Gario
// All rights reserved.
//
// This source code is licensed in accordance with the terms specified in
// the LICENSE file found in the root directory of this source tree.
//

use crate::utils::podman::{Podman, PodmanContainerState, PodmanError};

use {clap::Args, thiserror::Error};

use std::path::PathBuf;

/// Errors produced by the `send` command.
#[derive(Debug, Error)]
pub enum SendError {
    #[error(transparent)]
    Podman(#[from] PodmanError),

    #[error("source path '{path}' does not exist")]
    SourceMissing { path: PathBuf },

    #[error(
        "container '{name}' is in state '{state}', not 'running'; run `podcell start {name}` first"
    )]
    NotRunning {
        name: String,
        state: PodmanContainerState,
    },
}

/// Path, inside the container, of the folder where sent items are placed.
const INBOX_PATH: &str = "/inbox";

/// Send a file or directory into a running container's /inbox.
#[derive(Args)]
pub struct Arguments {
    /// The name of the container to send to.
    #[arg()]
    name: String,

    /// Path to the file or directory to send.
    #[arg()]
    source: PathBuf,
}

/// Creates the inbox folder when it is missing and sets its mode to `0777`.
fn create_inbox(podman: &Podman, container_id: &str) -> Result<(), PodmanError> {
    podman.exec(
        container_id,
        &[
            "sh",
            "-c",
            &format!("mkdir -p {INBOX_PATH} && chmod 0777 {INBOX_PATH}"),
        ],
    )
}

/// Gives the inbox and its contents to the container's primary user.
///
/// `podman cp` preserves the numeric owner of the source, and `--userns=keep-id` maps the host
/// uid to uid 0 inside the container: copied items arrive owned by root.
fn chown_inbox(podman: &Podman, container_id: &str) -> Result<(), PodmanError> {
    podman.exec(
        container_id,
        &[
            "sh",
            "-c",
            &format!("chown -R \"$USER_ID:$GROUP_ID\" {INBOX_PATH}"),
        ],
    )
}

/// Handler for the "send" command.
pub fn run(args: Arguments) -> Result<(), SendError> {
    if !args.source.exists() {
        return Err(SendError::SourceMissing { path: args.source });
    }

    let podman = Podman::new();
    let container = podman.find_by_name(&args.name)?;

    if container.state != PodmanContainerState::Running {
        return Err(SendError::NotRunning {
            name: args.name,
            state: container.state,
        });
    }

    println!("Sending '{}' to /inbox...", args.source.display());
    create_inbox(&podman, &container.id)?;

    podman.cp(&container.id, &args.source, &format!("{INBOX_PATH}/"))?;
    chown_inbox(&podman, &container.id)?;

    Ok(())
}