CLI¶

The rampa CLI runs load tests from the terminal and produces structured output for scripts and CI.

With uvx run installed:

$ uvx rampa --help

Then run it from the terminal:

$ uvx rampa run load_test.py

$ uvx rampa run load_test.py --vus 10 --duration 30s

$ uvx rampa check load_test.py

With uvx run installed:

$ uvx --exclude-newer P7D --exclude-newer-package rampa=2099-01-01 rampa --help

Then run it from the terminal:

$ uvx --exclude-newer P7D --exclude-newer-package rampa=2099-01-01 rampa run load_test.py

$ uvx --exclude-newer P7D --exclude-newer-package rampa=2099-01-01 rampa run load_test.py --vus 10 --duration 30s

$ uvx --exclude-newer P7D --exclude-newer-package rampa=2099-01-01 rampa check load_test.py

With uvx run installed:

$ uvx --no-config rampa --help

Then run it from the terminal:

$ uvx --no-config rampa run load_test.py

$ uvx --no-config rampa run load_test.py --vus 10 --duration 30s

$ uvx --no-config rampa check load_test.py

With pipx run installed:

$ pipx run rampa --help

Then run it from the terminal:

$ pipx run rampa run load_test.py

$ pipx run rampa run load_test.py --vus 10 --duration 30s

$ pipx run rampa check load_test.py

With pipx run installed:

$ pipx run rampa --help

Then run it from the terminal:

$ pipx run rampa run load_test.py

$ pipx run rampa run load_test.py --vus 10 --duration 30s

$ pipx run rampa check load_test.py

pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the `uvx run` or `uv add` tab — they apply the cooldown to transitive deps via `--exclude-newer` while exempting rampa itself via `--exclude-newer-package`.

With pipx run installed:

$ pipx run rampa --help

Then run it from the terminal:

$ pipx run rampa run load_test.py

$ pipx run rampa run load_test.py --vus 10 --duration 30s

$ pipx run rampa check load_test.py

With uv add installed:

$ uv add rampa

Then run it from the terminal:

$ uv run rampa run load_test.py

$ uv run rampa run load_test.py --vus 10 --duration 30s

$ uv run rampa check load_test.py

With uv add installed:

$ uv add --exclude-newer P7D --exclude-newer-package rampa=2099-01-01 rampa

Then run it from the terminal:

$ uv run rampa run load_test.py

$ uv run rampa run load_test.py --vus 10 --duration 30s

$ uv run rampa check load_test.py

With uv add installed:

$ uv add --no-config rampa

Then run it from the terminal:

$ uv run rampa run load_test.py

$ uv run rampa run load_test.py --vus 10 --duration 30s

$ uv run rampa check load_test.py

$ pip install --user --upgrade rampa

Then run it from the terminal:

$ rampa run load_test.py

$ rampa run load_test.py --vus 10 --duration 30s

$ rampa check load_test.py

$ pip install --user --upgrade rampa

Then run it from the terminal:

$ rampa run load_test.py

$ rampa run load_test.py --vus 10 --duration 30s

$ rampa check load_test.py

$ pip install --user --upgrade rampa

Then run it from the terminal:

$ rampa run load_test.py

$ rampa run load_test.py --vus 10 --duration 30s

$ rampa check load_test.py

rampa run

Execute a load test script with metric output and exit codes.

rampa run

rampa check

Validate a script without running it.

rampa check

rampa doctor

Report environment and dependency status.

rampa doctor

CLI Reference

Auto-generated reference for all commands and options.

CLI Reference