yom 2.2.5

A modern, easy to install competitor to the dash shell, built solely to execute files.
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
116
117
118
119
120
121
122
123
124
125

// Copyright (C) 2026 The YOM Contributors
//
// This program is free software; you can redistribute it and/or modify
// it under the terms of the GNU General Public License Version 2 as
// published by the Free Software Foundation.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License Version 2 for more details.
//
// You should have received a copy of the GNU General Public License
// Version 2 along with this program. If not, see
// <https://www.gnu.org/licenses/old-licenses/gpl-2.0.html#SEC1>.

//! ██████ ███  ██ ██████ █████▄  ██  ██
//! ██▄▄   ██ ▀▄██   ██   ██▄▄██▄  ▀██▀  
//! ██▄▄▄▄ ██   ██   ██   ██   ██   ██   
//! The entrypoint for all the funtions for calling external programs in `yom`,
//! nothing more to say.

use std::process::Command;
use std::process::Stdio;

/// ██     ██ ▄████▄ ██ ██████ ██████ ▄████▄ █████▄  
/// ██ ▄█▄ ██ ██▄▄██ ██   ██   ██▄▄   ██  ██ ██▄▄██▄
///  ▀██▀██▀  ██  ██ ██   ██   ██     ▀████▀ ██   ██  
/// This function executes the path given
/// and waits for the child created to
/// complete it's task, it takes the
/// entire line.
pub fn waitfor(path: &str) {
    let split = shell_words::split(path).expect("Invalid command syntax");
    let program = &split[0];
    let args = &split[1..];
    if program.starts_with("$") {
        let program = program.strip_prefix("$").unwrap();

        let mut child = Command::new(std::env::var_os(program).unwrap())
            .args(args)
            .stdin(Stdio::inherit())
            .stdout(Stdio::inherit())
            .stderr(Stdio::inherit())
            .spawn()
            .expect("Failed to start");

        child.wait().unwrap();
    } else {
        let mut child = Command::new(program)
            .args(args)
            .stdin(Stdio::inherit())
            .stdout(Stdio::inherit())
            .stderr(Stdio::inherit())
            .spawn()
            .expect("Failed to start");

        child.wait().unwrap();
    }
}

/// █████▄ ▄████▄ ▄█████ ██ ▄█▀  ▄████  █████▄  ▄████▄ ██  ██ ███  ██ ████▄  
/// ██▄▄██ ██▄▄██ ██     ████   ██  ▄▄▄ ██▄▄██▄ ██  ██ ██  ██ ██ ▀▄██ ██  ██
/// ██▄▄█▀ ██  ██ ▀█████ ██ ▀█▄  ▀███▀  ██   ██ ▀████▀ ▀████▀ ██   ██ ████▀  
/// This function needs the end cleaned,
/// it does not wait for the child
/// created to finish; in the main
/// function, it ignores the returned
/// Child, use it for ephermal scripts
/// mainly instead of using it for
/// eternal scripts.
#[inline]
pub fn background(command: &str) {
    let split = shell_words::split(command).expect("Invalid command syntax");
    let program = &split[0];
    let args = &split[1..];
    if program.starts_with('$') {
        let program = program.strip_prefix('$').unwrap();

        let _ = Command::new(std::env::var_os(program).unwrap())
            .args(args)
            .stdin(Stdio::inherit())
            .stdout(Stdio::inherit())
            .stderr(Stdio::inherit())
            .spawn()
            .expect("Failed to start");
    } else {
        let _ = Command::new(program)
            .args(args)
            .stdin(Stdio::inherit())
            .stdout(Stdio::inherit())
            .stderr(Stdio::inherit())
            .spawn()
            .expect("Failed to start");
    }
}

/// ██████ ██  ██ ██████ ▄█████
/// ██▄▄    ████  ██▄▄   ██     
/// ██▄▄▄▄ ██  ██ ██▄▄▄▄ ▀█████
/// This function is the standard
/// shell `exec`, it replaces the
/// process (yom) with the path
/// given. It takes the whole line.
#[inline]
pub fn exec(command: &str) {
    let path = command.strip_prefix("exec ").unwrap();

    use std::os::unix::process::CommandExt;
    use std::process::Command;

    let split = shell_words::split(path).expect("Invalid command syntax");
    let program = &split[0];
    if program.starts_with("$") {
        let program = program.strip_prefix("$").unwrap();
        let args = &split[1..];

        let _ = Command::new(std::env::var_os(program).unwrap())
            .args(args)
            .exec();
    } else {
        let args = &split[1..];

        let _ = Command::new(program).args(args).exec();
    }
}