spark run
The main command. Run tests locally or in the cloud.
spark run [path] [flags]
| Argument | Default | Description |
|---|---|---|
path | . | Directory to search for *.spark files, or a single file |
Flags
| Flag | Default | Description |
|---|---|---|
--tags <tags> | — | Run tests matching ANY of the specified tags (comma-separated) |
--filter <pattern> | — | Run tests matching name pattern (* wildcard, or substring without wildcard) |
Common combos:
--tags smoke for quick checks, --filter "login*" to focus on one area.| Flag | Default | Description |
|---|---|---|
--html <directory> | — | Write HTML reports to directory (dashboard + per-test reports) |
--junit <file> | — | Write JUnit XML report to file |
--artifacts <directory> | ../var/artifacts | Directory for test artifacts |
--teamcity | false | Output TeamCity service messages (for IDE integration) |
--verbose | false | Show detailed logs (all events) |
--debug | false | Show Docker commands (implies --verbose) |
| Flag | Default | Description |
|---|---|---|
--workers <n> | 0 | Parallel workers (0 = auto-detect from CPU count) |
--timeout <seconds> | 300 | Max time per test execution |
--cpu-threshold <float> | 0 | CPU load threshold (0.0-1.0), pauses execution when exceeded. 0 = disabled |
--regenerate-snapshots | false | Update snapshot files instead of comparing |
| Flag | Default | Description |
|---|---|---|
--configuration <file> | — | Path to spark.yaml config file (auto-discovered if not set) |
--path-mapping <mapping> | — | Path prefix mapping for artifacts (container=host) |
--cloud | false | Execute tests in Spark Cloud (requires SPARK_CLOUD_URL) |
When
--cloud is used, local-only flags are ignored: --html, --junit, --artifacts, --regenerate-snapshots, --verbose, --debug, --timeout, --workers.::