viswiz

The VisWiz.io CLI

Usage no npm install needed!

<script type="module">
  import viswiz from 'https://cdn.skypack.dev/viswiz';
</script>

README

VisWiz.io CLI

The official VisWiz.io CLI.

Travis branch NPM version Dependencies Install size

Welcome to the VisWiz.io CLI documentation.

The CLI allows you to query and create new projects, builds or images within the VisWiz.io service.

Installation

Install the module using yarn:

$ yarn add -D viswiz

Or using npm:

$ npm install -D viswiz

Alternatively, you can download a prepackaged binary for your OS from the Releases page.

Configuration

The following environment keys are used when their corresponding flags are missing:

  • VISWIZ_API_KEY - for the api-key flag
  • VISWIZ_PROJECT_ID - for the project flag

CI environment variables for popular CI services are also used for the branch, message and revision flags.

Usage

On popular CI services, assuming VISWIZ_API_KEY and VISWIZ_PROJECT_ID values are configured in the CI environment:

$ viswiz build --image-dir ./path/to/images/directory

Commands

build

$ viswiz build --help

Usage: viswiz build [options]

Creates a new build on VisWiz.io and sends images for regression testing.

Options:
  -i, --image-dir <path>           The path to a directory (scanned recursively) with images used for the build.
  -b, --branch [branch name]       The branch name for the build. Auto-detected on popular CIs.
  -m, --message [commit message]   The commit message for the build. Auto-detected on popular CIs.
  -r, --revision [rev]             The revision for the build. Auto-detected on popular CIs.
  -c, --concurrency [number]       Determines how many images are uploaded in parallel (defaults to 4).
  -w, --wait-for-result [timeout]  Whether to wait for the result of the build comparison (disabled by default). Waits for a maximum number of seconds (defaults to 600).
  -h, --help                       output usage information

build-result

$ viswiz build-result --help

Usage: viswiz build-result [options]

Gets or waits for a build result

Options:
  -b, --build [buildID]            The build ID to get results for. If not sent, then the most recent build for the project is used.
  -w, --wait-for-result [timeout]  Whether to wait for the result of the build comparison (disabled by default). Waits for a maximum number of seconds (defaults to 600).
  -h, --help                       output usage information

--help

$ viswiz --help

Usage: viswiz [options] [command]

Options:
  -V, --version              output the version number
  -k, --api-key [apiKey]     The API key of a VisWiz account to use. Defaults to VISWIZ_API_KEY env.
  -p, --project [projectID]  The ID of a VisWiz project to use. Defaults to VISWIZ_PROJECT_ID env.
  -h, --help                 output usage information

Commands:
  build [options]            Creates a new build on VisWiz.io and sends images for regression testing.

Changelog

The changelog can be found here: CHANGELOG.md.

Authors and license

Author: VisWiz.io.

MIT License, see the included LICENSE.md file.