Command-Line Arguments

The wpt command-line application offers a number of features for interacting with WPT. The functionality is organized into “sub-commands”, and each accepts a different set of command-line arguments.

This page documents all of the available sub-commands and associated arguments.

usage: wpt [-h]
           {rev-list,tc-download,run,install,test-jobs,create,lint,serve,update-expectations,manifest,install-android-emulator,test-paths,tc-verify,make-hosts-file,manifest-download,files-changed,start-android-emulator,tests-affected,docker-run}
           ...

Sub-commands:

rev-list

wpt rev-list [-h] [--epoch EPOCH] [--max-count MAX_COUNT]

Named Arguments

--epoch

regular interval of time selected to get the tagged revisions. Valid values are digits followed by h/d/w (e.x. 9h, 9d, 9w …) where the mimimun selectable interval is one hour (1h)

Default: 1d

--max-count

maximum number of revisions to be returned by the command

Default: 1

tc-download

wpt tc-download [-h] [--ref REF] [--artifact-name ARTIFACT_NAME]
                [--repo-name REPO_NAME] [--token-file TOKEN_FILE]
                [--out-dir OUT_DIR]

Named Arguments

--ref

Branch (in the GitHub repository) or commit to fetch logs for

Default: “master”

--artifact-name
 

Log type to fetch

Default: “wpt_report.json.gz”

--repo-name

GitHub repo name in the format owner/repo. This must be the repo from which the Taskcluster run was scheduled (for PRs this is the repo into which the PR would merge)

Default: “web-platform-tests/wpt”

--token-file File containing GitHub token
--out-dir

Path to save the logfiles

Default: “.”

run

wpt run [--affected AFFECTED] [--yes] [--install-browser]
        [--channel {nightly,beta,experimental,stable,release,canary,preview,dev}]
        [-h] [--manifest-update] [--no-manifest-update] [--manifest-download]
        [--no-manifest-download] [--timeout-multiplier TIMEOUT_MULTIPLIER]
        [--run-by-dir [RUN_BY_DIR]] [--processes PROCESSES]
        [--no-capture-stdio] [--no-fail-on-unexpected] [--list-test-groups]
        [--list-disabled] [--list-tests] [--verify] [--verify-log-full]
        [--verify-repeat-loop VERIFY_REPEAT_LOOP]
        [--verify-repeat-restart VERIFY_REPEAT_RESTART]
        [--verify-no-chaos-mode | --verify-chaos-mode]
        [--verify-max-time VERIFY_MAX_TIME]
        [--verify-no-output-results | --verify-output-results]
        [--test-types [{reftest,wdspec,testharness} [{reftest,wdspec,testharness} ...]]]
        [--include INCLUDE] [--exclude EXCLUDE]
        [--include-manifest INCLUDE_MANIFEST] [--skip-timeout] [--tag TAGS]
        [--default-exclude] [--debugger [DEBUGGER]]
        [--debugger-args DEBUGGER_ARGS] [--rerun RERUN] [--repeat REPEAT]
        [--repeat-until-unexpected] [--pause-after-test]
        [--no-pause-after-test] [--pause-on-unexpected]
        [--no-restart-on-unexpected] [--symbols-path SYMBOLS_PATH]
        [--stackwalk-binary STACKWALK_BINARY] [--pdb] [--binary BINARY]
        [--binary-arg BINARY_ARGS] [--webdriver-binary BINARY]
        [--webdriver-arg WEBDRIVER_ARGS] [--package-name PACKAGE_NAME]
        [--device-serial DEVICE_SERIAL] [--metadata METADATA_ROOT]
        [--tests TESTS_ROOT] [--manifest MANIFEST_PATH] [--run-info RUN_INFO]
        [--product {android_webview,chrome,chrome_android,chrome_ios,edgechromium,edge,edge_webdriver,firefox,firefox_android,ie,safari,sauce,servo,servodriver,opera,webkit,webkitgtk_minibrowser,epiphany}]
        [--browser-version BROWSER_VERSION]
        [--browser-channel BROWSER_CHANNEL] [--config CONFIG]
        [--install-fonts] [--font-dir FONT_DIR] [--headless] [--no-headless]
        [--debug-build | --release-build] [--total-chunks TOTAL_CHUNKS]
        [--this-chunk THIS_CHUNK] [--chunk-type {none,hash,dir_hash}]
        [--ssl-type {openssl,pregenerated,none}]
        [--openssl-binary OPENSSL_BINARY] [--certutil-binary CERTUTIL_BINARY]
        [--ca-cert-path CA_CERT_PATH] [--host-key-path HOST_KEY_PATH]
        [--host-cert-path HOST_CERT_PATH] [--prefs-root PREFS_ROOT]
        [--disable-e10s] [--enable-webrender] [--no-enable-webrender]
        [--stackfix-dir STACKFIX_DIR] [--setpref PREF=VALUE] [--leak-check]
        [--no-leak-check] [--stylo-threads STYLO_THREADS] [--reftest-internal]
        [--reftest-external] [--reftest-screenshot {always,fail,unexpected}]
        [--chaos [CHAOS_MODE_FLAGS]] [--user-stylesheet USER_STYLESHEETS]
        [--sauce-browser SAUCE_BROWSER] [--sauce-platform SAUCE_PLATFORM]
        [--sauce-version SAUCE_VERSION] [--sauce-build SAUCE_BUILD]
        [--sauce-tags [SAUCE_TAGS [SAUCE_TAGS ...]]]
        [--sauce-tunnel-id SAUCE_TUNNEL_ID] [--sauce-user SAUCE_USER]
        [--sauce-key SAUCE_KEY] [--sauce-connect-binary SAUCE_CONNECT_BINARY]
        [--sauce-init-timeout SAUCE_INIT_TIMEOUT]
        [--sauce-connect-arg SAUCE_CONNECT_ARGS] [--webkit-port WEBKIT_PORT]
        [--log-unittest LOG_UNITTEST] [--log-wptreport LOG_WPTREPORT]
        [--log-raw LOG_RAW] [--log-wptscreenshot LOG_WPTSCREENSHOT]
        [--log-chromium LOG_CHROMIUM] [--log-mach LOG_MACH]
        [--log-grouped LOG_GROUPED] [--log-html LOG_HTML]
        [--log-tbpl LOG_TBPL] [--log-xunit LOG_XUNIT]
        [--log-raw-level LOG_RAW_LEVEL]
        [--log-wptscreenshot-api LOG_WPTSCREENSHOT_API] [--log-mach-verbose]
        [--log-mach-screenshot] [--log-mach-level LOG_MACH_LEVEL]
        [--log-mach-buffer LOG_MACH_BUFFER] [--log-mach-no-screenshot]
        [--log-tbpl-compact] [--log-tbpl-level LOG_TBPL_LEVEL]
        [--log-tbpl-buffer LOG_TBPL_BUFFER]
        product [test_list [test_list ...]]

Positional Arguments

product Browser to run tests in
test_list List of URLs for tests to run, or paths including tests to run. (equivalent to –include)

Named Arguments

--affected Run affected tests since revish
--yes, -y

Don’t prompt before installing components

Default: True

--install-browser
 

Install the browser from the release channel specified by –channel (or the nightly channel by default).

Default: False

--channel

Possible choices: nightly, beta, experimental, stable, release, canary, preview, dev

Name of browser release channel. “stable” and “release” are synonyms for the latest browser stable release, “nightly”, “dev”, “experimental”, and “preview” are all synonyms for the latest available development release. (For WebDriver installs, we attempt to select an appropriate, compatible version for the latest browser release on the selected channel.) This flag overrides –browser-channel.

--manifest-update
 Regenerate the test manifest.
--no-manifest-update
 

Prevent regeneration of the test manifest.

Default: True

--manifest-download
 Attempt to download a preexisting manifest when updating.
--no-manifest-download
 

Prevent download of the test manifest.

Default: True

--timeout-multiplier
 Multiplier relative to standard test timeout to use
--run-by-dir

Split run into groups by directories. With a parameter,limit the depth of splits e.g. –run-by-dir=1 to split by top-leveldirectory

Default: False

--processes Number of simultaneous processes to use
--no-capture-stdio
 

Don’t capture stdio and write to logging

Default: False

--no-fail-on-unexpected
 

Exit with status code 0 when test expectations are violated

Default: True

--verify

Run a stability check on the selected tests

Default: False

--verify-no-chaos-mode
 

Disable chaos mode when running on Firefox

Default: True

--verify-chaos-mode
 

Enable chaos mode when running on Firefox

Default: True

--verify-no-output-results
 

Prints individuals test results and messages

Default: True

--verify-output-results
 

Disable printing individuals test results and messages

Default: True

--debug-build Build is a debug build (overrides any mozinfo file)
--release-build
 Build is a release (overrides any mozinfo file)

Mode

--list-test-groups
 

List the top level directories containing tests that will run.

Default: False

--list-disabled
 

List the tests that are disabled on the current platform

Default: False

--list-tests

List all tests that will run

Default: False

--verify-log-full
 

Output per-iteration test results when running verify

Default: False

--verify-repeat-loop
 

Number of iterations for a run that reloads each test without restart.

Default: 10

--verify-repeat-restart
 

Number of iterations, for a run that restarts the runner between each iteration

Default: 5

--verify-max-time
 The maximum number of minutes for the job to run

Test Selection

--test-types

Possible choices: reftest, wdspec, testharness

Test types to run

Default: set([‘reftest’, ‘wdspec’, ‘testharness’])

--include URL prefix to include
--exclude URL prefix to exclude
--include-manifest
 Path to manifest listing tests to include
--skip-timeout

Skip tests that are expected to time out

Default: False

--tag Labels applied to tests to include in the run. Labels starting dir: are equivalent to top-level directories.
--default-exclude
 

Only run the tests explicitly given in arguments. No tests will run if the list is empty, and the program will exit with status code 0.

Default: False

Debugging

--debugger run under a debugger, e.g. gdb or valgrind
--debugger-args
 arguments to the debugger
--rerun

Number of times to re run each test without restarts

Default: 1

--repeat

Number of times to run the tests, restarting between each run

Default: 1

--repeat-until-unexpected
 Run tests in a loop until one returns an unexpected result
--pause-after-test
 Halt the test runner after each test (this happens by default if only a single test is run)
--no-pause-after-test
 

Don’t halt the test runner irrespective of the number of tests run

Default: True

--pause-on-unexpected
 

Halt the test runner when an unexpected result is encountered

Default: False

--no-restart-on-unexpected
 

Don’t restart on an unexpected result

Default: True

--symbols-path Path or url to symbols file used to analyse crash minidumps.
--stackwalk-binary
 Path to stackwalker program used to analyse minidumps.
--pdb

Drop into pdb on python exception

Default: False

Configuration

--binary Desktop binary to run tests against
--binary-arg

Extra argument for the binary

Default: []

--webdriver-binary
 WebDriver server binary to use
--webdriver-arg
 

Extra argument for the WebDriver binary

Default: []

--package-name Android package name to run tests against
--device-serial
 Running Android instance to connect to, if not emulator-5554
--metadata Path to root directory containing test metadata
--tests Path to root directory containing test files
--manifest Path to test manifest (default is ${metadata_root}/MANIFEST.json)
--run-info Path to directory containing extra json files to add to run info
--product

Possible choices: android_webview, chrome, chrome_android, chrome_ios, edgechromium, edge, edge_webdriver, firefox, firefox_android, ie, safari, sauce, servo, servodriver, opera, webkit, webkitgtk_minibrowser, epiphany

Browser against which to run tests

--browser-version
 Informative string detailing the browser release version. This is included in the run_info data.
--browser-channel
 Informative string detailing the browser release channel. This is included in the run_info data.
--config Path to config file
--install-fonts
 Allow the wptrunner to install fonts on your system
--font-dir Path to local font installation directory
--headless Run browser in headless mode
--no-headless

Don’t run browser in headless mode

Default: True

Test Chunking

--total-chunks

Total number of chunks to use

Default: 1

--this-chunk

Chunk number to run

Default: 1

--chunk-type

Possible choices: none, hash, dir_hash

Chunking type to use

SSL/TLS

--ssl-type

Possible choices: openssl, pregenerated, none

Type of ssl support to enable (running without ssl may lead to spurious errors)

--openssl-binary
 

Path to openssl binary

Default: “openssl”

--certutil-binary
 Path to certutil binary for use with Firefox + ssl
--ca-cert-path Path to ca certificate when using pregenerated ssl certificates
--host-key-path
 Path to host private key when using pregenerated ssl certificates
--host-cert-path
 Path to host certificate when using pregenerated ssl certificates

Gecko-specific

--prefs-root Path to the folder containing browser prefs
--disable-e10s

Run tests without electrolysis preferences

Default: True

--enable-webrender
 Enable the WebRender compositor in Gecko (defaults to disabled).
--no-enable-webrender
 

Disable the WebRender compositor in Gecko.

Default: True

--stackfix-dir Path to directory containing assertion stack fixing scripts
--setpref

Defines an extra user preference (overrides those in prefs_root)

Default: []

--leak-check Enable leak checking (enabled by default for debug builds, silently ignored for opt, mobile)
--no-leak-check
 Disable leak checking
--stylo-threads
 

Number of parallel threads to use for stylo

Default: 1

--reftest-internal
 Enable reftest runner implemented inside Marionette
--reftest-external
 

Disable reftest runner implemented inside Marionette

Default: True

--reftest-screenshot
 

Possible choices: always, fail, unexpected

With –reftest-internal, when to take a screenshot

--chaos Enable chaos mode with the specified feature flag (see http://searchfox.org/mozilla-central/source/mfbt/ChaosMode.h for details). If no value is supplied, all features are activated

Servo-specific

--user-stylesheet
 

Inject a user CSS stylesheet into every test.

Default: []

Sauce Labs-specific

--sauce-browser
 Sauce Labs browser name
--sauce-platform
 Sauce Labs OS platform
--sauce-version
 Sauce Labs browser version
--sauce-build Sauce Labs build identifier
--sauce-tags

Sauce Labs identifying tag

Default: []

--sauce-tunnel-id
 Sauce Connect tunnel identifier
--sauce-user Sauce Labs user name
--sauce-key Sauce Labs access key
--sauce-connect-binary
 Path to Sauce Connect binary
--sauce-init-timeout
 

Number of seconds to wait for Sauce Connect tunnel to be available before aborting

Default: 30

--sauce-connect-arg
 

Command-line argument to forward to the Sauce Connect binary (repeatable)

Default: []

WebKit-specific

--webkit-port WebKit port

Output Logging

Each option represents a possible logging format and takes a filename to write that format to, or ‘-‘ to write to stdout. Some options are provided by the mozlog utility; see https://firefox-source-docs.mozilla.org/mozbase/mozlog.html for extended documentation.

--log-unittest Unittest style output (provided by mozlog)
--log-wptreport
 wptreport format
--log-raw Raw structured log messages (provided by mozlog)
--log-wptscreenshot
 wpt.fyi screenshots
--log-chromium Chromium Layout Tests format
--log-mach Human-readable output (provided by mozlog)
--log-grouped Grouped summary of test results (provided by mozlog)
--log-html HTML report (provided by mozlog)
--log-tbpl TBPL style log format (provided by mozlog)
--log-xunit xUnit compatible XML (povided by mozlog)
--log-raw-level
 A least log level to subscribe to for the given formatter (debug, info, error, etc.)
--log-wptscreenshot-api
 Cache API (default: https://wpt.fyi/api/screenshots/hashes)
--log-mach-verbose
 Enables verbose mode for the given formatter.
--log-mach-screenshot
 Enable logging reftest-analyzer compatible screenshot data.
--log-mach-level
 A least log level to subscribe to for the given formatter (debug, info, error, etc.)
--log-mach-buffer
 If specified, enables message buffering at the given buffer size limit.
--log-mach-no-screenshot
 Disable logging reftest-analyzer compatible screenshot data.
--log-tbpl-compact
 Enables compact mode for the given formatter.
--log-tbpl-level
 A least log level to subscribe to for the given formatter (debug, info, error, etc.)
--log-tbpl-buffer
 If specified, enables message buffering at the given buffer size limit.

install

wpt install [-h]
            [--channel {nightly,beta,experimental,stable,release,canary,preview,dev}]
            [-d DESTINATION]
            {firefox,chrome,servo} {browser,webdriver}

Positional Arguments

browser

Possible choices: firefox, chrome, servo

name of web browser product

component

Possible choices: browser, webdriver

name of component

Named Arguments

--channel

Possible choices: nightly, beta, experimental, stable, release, canary, preview, dev

Name of browser release channel. “stable” and “release” are synonyms for the latest browser stable release,”nightly”, “dev”, “experimental”, and “preview” are all synonyms for the latest available development release. For WebDriver installs, we attempt to select an appropriate, compatible, version for the latest browser release on the selected channel.

Default: “nightly”

-d, --destination
 filesystem directory to place the component

test-jobs

wpt test-jobs [-h] [--all] [--includes [INCLUDES [INCLUDES ...]]] [revish]

Positional Arguments

revish Commits to consider. Defaults to the commits on the current branch

Named Arguments

--all

List all jobs unconditionally.

Default: False

--includes Jobs to check for. Return code is 0 if all jobs are found, otherwise 1

create

wpt create [-h] [--no-editor] [-e EDITOR] [--long-timeout] [--overwrite] [-r]
           [-m REF] [--mismatch] [--wait] [--tests-root TESTS_ROOT]
           path

Positional Arguments

path Path to the test file

Named Arguments

--no-editor

Don’t try to open the test in an editor

Default: False

-e, --editor Editor to use
--long-timeout

Test should be given a long timeout (typically 60s rather than 10s, but varies depending on environment)

Default: False

--overwrite

Allow overwriting an existing test file

Default: False

-r, --reftest

Create a reftest rather than a testharness (js) test

Default: False

-m, --reference
 Path to the reference file
--mismatch

Create a mismatch reftest

Default: False

--wait

Create a reftest that waits until takeScreenshot() is called

Default: False

--tests-root

Path to the root of the wpt directory

Default: “/github/workspace/tools/wpt/../..”

lint

wpt lint [-h] [--json] [--markdown] [--repo-root REPO_ROOT] [--all]
         [paths [paths ...]]

Positional Arguments

paths

Named Arguments

--json Default: False
--markdown Default: False
--repo-root
--all Default: False

serve

wpt serve [-h] [--latency LATENCY] [--config CONFIG_PATH]
          [--doc_root DOC_ROOT] [--ws_doc_root WS_DOC_ROOT]
          [--alias_file ALIAS_FILE] [--h2]

Named Arguments

--latency Artificial latency to add before sending http responses, in ms
--config Path to external config file
--doc_root Path to document root. Overrides config.
--ws_doc_root Path to WebSockets document root. Overrides config.
--alias_file File with entries for aliases/multiple doc roots. In form of /ALIAS_NAME/, DOC_ROOTn
--h2

Flag for enabling the HTTP/2.0 server

Default: False

update-expectations

wpt update-expectations [-h]
                        [--product {android_webview,chrome,chrome_android,chrome_ios,edgechromium,edge,edge_webdriver,firefox,firefox_android,ie,safari,sauce,servo,servodriver,opera,webkit,webkitgtk_minibrowser,epiphany}]
                        [--config CONFIG] [--metadata METADATA_ROOT]
                        [--tests TESTS_ROOT] [--manifest MANIFEST_PATH]
                        [--sync-path SYNC_PATH] [--remote_url REMOTE_URL]
                        [--branch BRANCH] [--rev REV] [--patch] [--no-patch]
                        [--sync] [--full]
                        [--disable-intermittent [DISABLE_INTERMITTENT]]
                        [--update-intermittent] [--remove-intermittent]
                        [--no-remove-obsolete] [--no-store-state] [--continue]
                        [--abort] [--exclude [EXCLUDE [EXCLUDE ...]]]
                        [--include [INCLUDE [INCLUDE ...]]]
                        [--extra-property EXTRA_PROPERTY]
                        [--log-unittest LOG_UNITTEST]
                        [--log-wptreport LOG_WPTREPORT] [--log-raw LOG_RAW]
                        [--log-wptscreenshot LOG_WPTSCREENSHOT]
                        [--log-chromium LOG_CHROMIUM] [--log-mach LOG_MACH]
                        [--log-grouped LOG_GROUPED] [--log-html LOG_HTML]
                        [--log-tbpl LOG_TBPL] [--log-xunit LOG_XUNIT]
                        [--log-raw-level LOG_RAW_LEVEL]
                        [--log-wptscreenshot-api LOG_WPTSCREENSHOT_API]
                        [--log-mach-verbose] [--log-mach-screenshot]
                        [--log-mach-level LOG_MACH_LEVEL]
                        [--log-mach-buffer LOG_MACH_BUFFER]
                        [--log-mach-no-screenshot] [--log-tbpl-compact]
                        [--log-tbpl-level LOG_TBPL_LEVEL]
                        [--log-tbpl-buffer LOG_TBPL_BUFFER]
                        [run_log [run_log ...]]

Positional Arguments

run_log Log file from run of tests

Named Arguments

--product

Possible choices: android_webview, chrome, chrome_android, chrome_ios, edgechromium, edge, edge_webdriver, firefox, firefox_android, ie, safari, sauce, servo, servodriver, opera, webkit, webkitgtk_minibrowser, epiphany

Browser for which metadata is being updated

--config Path to config file
--metadata Path to the folder containing test metadata
--tests Path to web-platform-tests
--manifest Path to test manifest (default is ${metadata_root}/MANIFEST.json)
--sync-path Path to store git checkout of web-platform-tests during update
--remote_url URL of web-platfrom-tests repository to sync against
--branch Remote branch to sync against
--rev Revision to sync to
--patch Create a VCS commit containing the changes.
--no-patch

Don’t create a VCS commit containing the changes.

Default: True

--sync

Sync the tests with the latest from upstream (implies –patch)

Default: False

--full

For all tests that are updated, remove any existing conditions and missing subtests

Default: False

--disable-intermittent
 Reason for disabling tests. When updating test results, disable tests that have inconsistent results across many runs with the given reason.
--update-intermittent
 

Update test metadata with expected intermittent statuses.

Default: False

--remove-intermittent
 

Remove obsolete intermittent statuses from expected statuses.

Default: False

--no-remove-obsolete
 

Don’t remove metadata files that no longer correspond to a test file

Default: True

--no-store-state
 

Store state so that steps can be resumed after failure

Default: True

--continue

Continue a previously started run of the update script

Default: False

--abort

Clear state from a previous incomplete run of the update script

Default: False

--exclude List of glob-style paths to exclude when syncing tests
--include List of glob-style paths to include which would otherwise be excluded when syncing tests
--extra-property
 

Extra property from run_info.json to use in metadata update

Default: []

Output Logging

Each option represents a possible logging format and takes a filename to write that format to, or ‘-‘ to write to stdout. Some options are provided by the mozlog utility; see https://firefox-source-docs.mozilla.org/mozbase/mozlog.html for extended documentation.

--log-unittest Unittest style output (provided by mozlog)
--log-wptreport
 wptreport format
--log-raw Raw structured log messages (provided by mozlog)
--log-wptscreenshot
 wpt.fyi screenshots
--log-chromium Chromium Layout Tests format
--log-mach Human-readable output (provided by mozlog)
--log-grouped Grouped summary of test results (provided by mozlog)
--log-html HTML report (provided by mozlog)
--log-tbpl TBPL style log format (provided by mozlog)
--log-xunit xUnit compatible XML (povided by mozlog)
--log-raw-level
 A least log level to subscribe to for the given formatter (debug, info, error, etc.)
--log-wptscreenshot-api
 Cache API (default: https://wpt.fyi/api/screenshots/hashes)
--log-mach-verbose
 Enables verbose mode for the given formatter.
--log-mach-screenshot
 Enable logging reftest-analyzer compatible screenshot data.
--log-mach-level
 A least log level to subscribe to for the given formatter (debug, info, error, etc.)
--log-mach-buffer
 If specified, enables message buffering at the given buffer size limit.
--log-mach-no-screenshot
 Disable logging reftest-analyzer compatible screenshot data.
--log-tbpl-compact
 Enables compact mode for the given formatter.
--log-tbpl-level
 A least log level to subscribe to for the given formatter (debug, info, error, etc.)
--log-tbpl-buffer
 If specified, enables message buffering at the given buffer size limit.

manifest

wpt manifest [-h] [-p PATH] [--tests-root TESTS_ROOT] [-r]
             [--url-base URL_BASE] [--no-download] [--cache-root CACHE_ROOT]

Named Arguments

-p, --path Path to manifest file.
--tests-root

Path to root of tests.

Default: /github/workspace

-r, --rebuild

Force a full rebuild of the manifest.

Default: False

--url-base

Base url to use as the mount point for tests in this manifest.

Default: “/”

--no-download

Never attempt to download the manifest.

Default: True

--cache-root

Path in which to store any caches (default <tests_root>/.wptcache/)

Default: “/github/workspace/.wptcache”

install-android-emulator

wpt install-android-emulator [-h] [--reinstall]

Named Arguments

--reinstall

Force reinstall even if the emulator already exists

Default: False

test-paths

wpt test-paths [-h] [-p PATH] [--tests-root TESTS_ROOT] [--no-update] [-r]
               [--url-base URL_BASE] [--cache-root CACHE_ROOT] [--json]
               test_ids [test_ids ...]

Positional Arguments

test_ids Test ids for which to get paths

Named Arguments

-p, --path Path to manifest file.
--tests-root

Path to root of tests.

Default: /github/workspace

--no-update

Don’t update manifest before continuing

Default: True

-r, --rebuild

Force a full rebuild of the manifest.

Default: False

--url-base

Base url to use as the mount point for tests in this manifest.

Default: “/”

--cache-root

Path in which to store any caches (default <tests_root>/.wptcache/)

Default: “/github/workspace/.wptcache”

--json

Output as JSON

Default: False

tc-verify

wpt tc-verify [-h]

make-hosts-file

wpt make-hosts-file [-h] [address]

Positional Arguments

address

Address that hosts should point at

Default: “127.0.0.1”

manifest-download

wpt manifest-download [-h] [-p PATH] [--tests-root TESTS_ROOT] [--force]

Named Arguments

-p, --path Path to manifest file.
--tests-root

Path to root of tests.

Default: /github/workspace

--force

Always download, even if the existing manifest is recent

Default: False

files-changed

wpt files-changed [-h] [--ignore-rules [IGNORE_RULES [IGNORE_RULES ...]]]
                  [--modified] [--new] [--show-type] [--null]
                  [revish]

Positional Arguments

revish Commits to consider. Defaults to the commits on the current branch

Named Arguments

--ignore-rules

Rules for paths to exclude from lists of changes. Rules are paths relative to the test root, with * before a separator or the end matching anything other than a path separator and ** in that position matching anything

Default: set([‘resources/testharness*’])

--modified

Include files under version control that have been modified or staged

Default: False

--new

Include files in the worktree that are not in version control

Default: False

--show-type

Print the test type along with each affected test

Default: False

--null

Separate items with a null byte

Default: False

start-android-emulator

wpt start-android-emulator [-h] [--reinstall]

Named Arguments

--reinstall

Force reinstall even if the emulator already exists

Default: False

tests-affected

wpt tests-affected [-h] [--ignore-rules [IGNORE_RULES [IGNORE_RULES ...]]]
                   [--modified] [--new] [--show-type] [--null]
                   [--metadata METADATA_ROOT]
                   [revish]

Positional Arguments

revish Commits to consider. Defaults to the commits on the current branch

Named Arguments

--ignore-rules

Rules for paths to exclude from lists of changes. Rules are paths relative to the test root, with * before a separator or the end matching anything other than a path separator and ** in that position matching anything

Default: set([‘resources/testharness*’])

--modified

Include files under version control that have been modified or staged

Default: False

--new

Include files in the worktree that are not in version control

Default: False

--show-type

Print the test type along with each affected test

Default: False

--null

Separate items with a null byte

Default: False

--metadata

Directory that will contain MANIFEST.json

Default: “/github/workspace”

docker-run

wpt docker-run [-h] [--rebuild] [--checkout CHECKOUT] [--privileged]

Named Arguments

--rebuild

Force rebuild of image

Default: False

--checkout Revision to checkout in the image. If this is not supplied we mount the wpt checkout on the host as /home/test/web-platform-tests/
--privileged

Run the image in priviledged mode (required for emulators)

Default: False