Bash Script Structure & Strict Mode (set -euo pipefail)

In Plain English

A robust Bash script follows a clean structural blueprint: a shebang header, strict error mode (`set -euo pipefail`), global constants, cleanup traps (`trap`), helper functions, and a structured `main "$@"` entry point.

The Mental Model

"Writing a bash script without strict mode is like driving a car without brakes or seatbelts: the car keeps driving forward even when a wheel falls off."

Deep Dive: How It Works

Strict Mode flags: `set -e` (exit immediately on error), `set -u` (treat unset variables as fatal errors), `set -o pipefail` (catch errors in piped command chains).

Trap Cleanup: `trap "rm -rf $TMP_DIR" EXIT` guarantees temporary files are deleted even if the script crashes.

Entry Point Architecture: Encapsulating logic inside `main() { ... }` ensures the script is fully downloaded and parsed before execution begins.

Syntax Blueprint

#!/bin/bash
set -euo pipefail
IFS=$'\n\t'

trap cleanup EXIT
cleanup() { rm -rf "${TMP_DIR:-}"; }

main() { echo "Starting..."; }
main "$@"

Always start production scripts with set -euo pipefail and cleanup traps.

Core Rules to Remember

set -e Fail Fast: Halts script execution on the very first command returning a non-zero exit code.

set -u No Unset Vars: Prevents catastrophic disasters like `rm -rf "$UNSET_VAR/"` becoming `rm -rf /`.

pipefail Support: Catches failures even when piped into other tools (e.g. `bad_cmd | grep "foo"`).

Common Beginner Traps & How to Fix Them

Mistake:Assuming a script stops when a command fails by default.

Why it happens: Bash continues executing subsequent lines after errors by default unless `set -e` is specified.

How to fix: Always include `set -euo pipefail` at the top of your scripts.

Pro Tip: Use `set -x` or run with `bash -x script.sh` to enable print-tracing for instant step-by-step debugging.

Live Interactive Example

Hit Run Code to see it live

Production Bash Script Architecture with Strict Mode

Git 2.45 / CLI

Output Console

Click "Run Code" to view the rendered output.

How it works: The script executed main and automatically triggered the EXIT cleanup trap.

Your Turn: Micro Challenge

No pressure! Edit the starter code below and test your solution with instant feedback.

Micro Exercise

Write a Script with Strict Mode

Write a script with `set -euo pipefail` that echoes "Strict mode enabled".

Sandbox Output

Click "Run & Check" to test your solution.

Finished reading and practicing?

Mark this lesson as completed to update your course progress.