Quibble CLI usage

Quibble: the MediaWiki test runner

usage: quibble [-h] [--packages-source {composer,vendor}] [--skip-zuul]
               [--resolve-requires] [--fail-on-extra-requires] [--skip-deps]
               [--skip-install] [--db {sqlite,mysql,postgres}]
               [--db-dir DB_DIR] [--dump-db-postrun] [--git-cache GIT_CACHE]
               [--git-parallel GIT_PARALLEL] [--branch BRANCH]
               [--project-branch PROJECT=BRANCH] [--workspace WORKSPACE]
               [--log-dir LOG_DIR] [--color] [--no-color]
               [--run STAGE[,STAGE ...]] [--skip STAGE[,STAGE ...]]
               [-c COMMAND | --commands [COMMAND [COMMAND ...]]]
               [--phpunit-testsuite pattern]
               [projects [projects ...]]

Positional Arguments

projects

MediaWiki extensions and skins to clone. Always clone mediawiki/core and mediawiki/skins/Vector. If $ZUUL_PROJECT is set, it will be cloned as well.

Named Arguments

--packages-source

Possible choices: composer, vendor

Source to install PHP dependencies from. Default: vendor

--skip-zuul

Do not clone/checkout in workspace

--resolve-requires

Whether to process extension.json/skin.json and clone extra extensions/skins mentioned in the “requires” statement. This is done recursively.

--fail-on-extra-requires

When –resolve-requires caused Quibble to clone extra requirements not in the list of projects: fail.Can be used to enforce extensions and skins to declare their requirements via the extension registry.

--skip-deps

Do not run composer/npm

--skip-install

Do not install MediaWiki

--db

Possible choices: sqlite, mysql, postgres

Database backend to use. Default: mysql

--db-dir

Base directory holding database files. A sub directory prefixed with “quibble-” will be created and deleted on completion. If set and relative, relatively to workspace. Default: /tmp

--dump-db-postrun

Dump the db before shutting down the server (mysql only)

--git-cache

Path to bare git repositories to speed up git cloneoperation. Passed to zuul-cloner as –cache-dir. In Docker: “/srv/git”, else “ref”

--git-parallel

Number of workers to clone repositories. Default: 4

--branch

Branch to checkout instead of Zuul selected branch, for example to specify an alternate branch to test client library compatibility.

--project-branch

project-specific branch to checkout which takes precedence over –branch if it is provided; may be specified multiple times.

--workspace

Base path to work from. In Docker: “/workspace”, else current working directory

--log-dir

Where logs and artifacts will be written to. Default: “log” relatively to workspace

--color

Enable colorful output.

--no-color

Disable colorful output.

--phpunit-testsuite

PHPUnit: filter which testsuite to run

stages

Quibble runs all test commands (stages) by default. Use the –run or –skip options to further refine which commands will be run. Available stages are: phpunit-unit, phpunit, npm-test, composer-test, qunit, selenium, api-testing

--run

Possible choices: phpunit-unit, phpunit, npm-test, composer-test, qunit, selenium, api-testing, all

Tests to run. Comma separated. (default: all).

--skip

Possible choices: phpunit-unit, phpunit, npm-test, composer-test, qunit, selenium, api-testing, all

Stages to skip. Comma separated. Set to “all” to skip all stages. (default: none).

-c, --command

Run given command instead of built-in stages. Each command is executed relatively to MediaWiki installation path.

--commands

DEPRECATED: use -c COMMAND -c COMMAND