hold-your-shell 0.1.4

Preview and confirm scripts before executing them.

hold-your-shell

hold-your-shell is a command line program (TUI) that previews shell scripts (or any shebang script) in a pager, and asks the user to confirm execution.

This single file program is written for Python 3.x and only uses the stdlib.

Install

Pip install:

pip install hold-your-shell

Manual install:

HY_BIN=~/.local/bin/hold-your-shell
mkdir -p $(dirname ${HY_BIN})

wget -O ${HY_BIN} https://raw.githubusercontent.com/EnigmaCurry/hold-your-shell/refs/heads/master/hold_your_shell/hold_your_shell.py

chmod +x ${HY_BIN}

Usage

• Pipe any script to the stdin of hold-your-shell.
• The script will be previewed on the first tab shown: Script Preview.
• Press TAB to cycle through the other tabs, including Env Vars.
• Use the up and down arrow keys (or j and k) to scroll the text.
• After reviewing the script and env vars, choose whether or not you you want to run the script. Using the left or right arrows, select Yes or No. Press Enter to confirm your selection.

Examples

Read from stdin

echo "whoami" | hold-your-shell

echo -e '#!/bin/python\nprint("Hello from Python!")' | hold-your-shell

cat <<'EOF' | hold-your-shell
echo "What is your name?"
read NAME
echo "Hello $NAME"
EOF

curl https://get.docker.com/ | hold-your-shell

Read from file

cat <<EOF > test.txt
#!/bin/env python
print("Hello from Python!")
EOF

hold-your-shell --consume test.txt

--consume will delete the input file immediately after it reads it.

Linger

echo whoami | hold-your-shell --linger

--linger will have the program remain running after completion of the script until a key is pressed.

Development

See DEVELOPMENT.md