CLI (Command Line Interface)

LoadDensity ships a subcommand-style CLI. Run python -m je_load_density --help for the full surface.

Subcommands

Subcommand	Purpose
run FILE	Execute one action JSON file.
run-dir DIR	Execute every .json in a directory.
run-str JSON	Execute an inline JSON string (Windows double-encoding handled transparently).
init PATH	Scaffold a new project skeleton.
serve	Start the hardened TCP control socket server.

run

python -m je_load_density run smoke.json

Where smoke.json is:

{"load_density": [
  ["LD_start_test", {
    "user_detail_dict": {"user": "fast_http_user"},
    "user_count": 20, "spawn_rate": 10, "test_time": 30,
    "tasks": [{"method": "get", "request_url": "https://httpbin.org/get"}]
  }],
  ["LD_generate_summary_report", {"report_name": "smoke"}]
]}

run-dir

Run every .json action file in a directory tree:

python -m je_load_density run-dir ./scenarios

run-str

Inline JSON (handy for CI scripts):

python -m je_load_density run-str '{"load_density":[["LD_summary",{}]]}'

init

Scaffold a project at PATH:

python -m je_load_density init ./my_load_test

serve

Start the control socket server. See TCP Control Socket Server for protocol details.

python -m je_load_density serve \
    --host 0.0.0.0 --port 9940 \
    --framed --token "$LOAD_DENSITY_SOCKET_TOKEN" \
    --tls-cert /etc/loaddensity/server.crt \
    --tls-key /etc/loaddensity/server.key

Legacy flags

The flat -e/-d/-c/--execute_str flags from previous releases are still accepted (suppressed in --help) for backwards compatibility with tools such as PyBreeze. New scripts should use the subcommands.