Skip to content

demo: advance on Enter key instead of fixed PAUSE #8

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
trouze merged 1 commit into from
Apr 24, 2026
Merged

demo: advance on Enter key instead of fixed PAUSE #8

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -147,7 +147,7 @@ An end-to-end walkthrough you can record or run locally:
./scripts/demo.sh
```

Drives every subcommand (`analyze`, `analyze --show-path`, `replay`, `replay --warehouse-size L/XL`, `--credits-per-hour` for non-Snowflake, JSON + `jq`) against a synthetic 24-model baseball-analytics DAG in `tests/fixtures/demo_project/`. Set `PAUSE=0` to dry-run without narration beats.
Drives every subcommand (`analyze`, `analyze --show-path`, `replay`, `replay --warehouse-size L/XL`, `--credits-per-hour` for non-Snowflake, JSON + `jq`) against a synthetic 24-model baseball-analytics DAG in `tests/fixtures/demo_project/`. Press **Enter** to advance each step. Set `AUTO=1 PAUSE=0` for a hands-free dry-run.

## Development

Expand Down
24 changes: 16 additions & 8 deletions scripts/demo.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,15 +6,14 @@
# shared bottleneck (int_game_events) sitting on three of the top longest paths.
#
# Usage:
# ./scripts/demo.sh
#
# Each command is echoed in bold before it runs, with a narration hint above.
# Pause between commands by setting PAUSE=2 (default) or call with PAUSE=0 to
# rush through for a dry-run.
# ./scripts/demo.sh # interactive: Enter advances each step
# AUTO=1 PAUSE=2 ./scripts/demo.sh # non-interactive: 2s sleep per step
# AUTO=1 PAUSE=0 ./scripts/demo.sh # rapid dry-run (CI smoke)

set -euo pipefail

PAUSE="${PAUSE:-2}"
AUTO="${AUTO:-0}"
PAUSE="${PAUSE:-0.5}"
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
MANIFEST="$ROOT/tests/fixtures/demo_project/manifest.json"
RUN_RESULTS="$ROOT/tests/fixtures/demo_project/run_results.json"
Expand All @@ -26,12 +25,21 @@ section() {
printf "\033[1;36m▌ %s\033[0m\n" "$*"
echo
}
wait_step() {
if [ "$AUTO" = "1" ]; then
sleep "$PAUSE"
return
fi
# Dim hint, then clear the line after Enter so the recording stays clean.
printf "\033[2m ↵ \033[0m"
read -r _
printf "\033[1A\033[2K"
}
run() {
bold "\$ $*"
sleep "$PAUSE"
wait_step
eval "$@"
echo
sleep "$PAUSE"
}

section "1 · Which paths through the DAG are actually slow?"
Expand Down
Loading