pwc-p (orchestration)

Currents orchestration pwc-p command-line executable documentation

pwc-p is a command-line executable that implements Currents Orchestration for Playwright. See Orchestration Setup and Playwright Parallelization for detailed guides.

Orchestration is a two-step process: first run pwc-p discover to build a test list, then run pwc-p run to execute tests in parallel with load balancing.

Subcommands

• pwc-p discover — Runs Playwright test discovery and writes the test list to a file. Accepts Playwright filter flags (--grep, --last-failed, --project, spec paths, and similar).

• pwc-p run — Starts orchestration and executes tests with load balancing. Accepts Configuration options and supported Playwright runtime flags (-j, --timeout, and similar).

Both commands accept Currents configuration via CLI flags or currents.config.ts. See Configuration Sources for recommended setup.

Basic Workflow

Full suite (no filters):

npx pwc-p run --key <record-key> --project-id <project-id> --ci-build-id <ci-build-id>

Filtered tests (with discovery):

# Step 1: Discover tests with optional filters
npx pwc-p discover --pwc-discovery-file tests.txt --grep @smoke

# Step 2: Run orchestrated execution using the discovery file
npx pwc-p run \
  --key <record-key> \
  --project-id <project-id> \
  --ci-build-id <ci-build-id> \
  --pwc-discovery-file tests.txt

Or use environment variables to avoid repeating the discovery file path:

export CURRENTS_DISCOVERY_FILE=tests.txt
npx pwc-p discover --grep @smoke
npx pwc-p run --key <record-key> --project-id <project-id> --ci-build-id <ci-build-id>

Reference:

• pwc-p discover — test discovery and filtering options

• pwc-p run — orchestration execution and runtime options