Skip to content

Latest commit

 

History

History

cli-exec

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 

@percy/cli-exec

Percy CLI commands for running a local snapshot server using @percy/core.

Commands

percy exec

Start and stop Percy around a supplied command

Usage:
  $ percy exec [options] -- <command>

Subcommands:
  exec:start [options]               Starts a locally running Percy process
  exec:stop [options]                Stops a locally running Percy process
  exec:ping [options]                Pings a locally running Percy process
  help [command]                     Display command help

Options:
  --parallel                         Marks the build as one of many parallel builds
  --partial                          Marks the build as a partial build

Percy options:
  -c, --config <file>                Config file path
  -d, --dry-run                      Print snapshot names only
  -P, --port [number]                Local CLI server port (default: 5338)
  -h, --allowed-hostname <hostname>  Allowed hostnames to capture in asset discovery
  --disallowed-hostname <hostname>   Disallowed hostnames to abort in asset discovery
  -t, --network-idle-timeout <ms>    Asset discovery network idle timeout
  --disable-cache                    Disable asset discovery caches
  --debug                            Debug asset discovery and do not upload snapshots

Global options:
  -v, --verbose                      Log everything
  -q, --quiet                        Log errors only
  -s, --silent                       Log nothing
  --help                             Display command help

Examples:
  $ percy exec -- echo "percy is running around this echo command"
  $ percy exec -- yarn test

percy exec:start

Starts a locally running Percy process

Usage:
  $ percy exec:start [options]

Percy options:
  -c, --config <file>                Config file path
  -d, --dry-run                      Print snapshot names only
  -P, --port [number]                Local CLI server port (default: 5338)
  -h, --allowed-hostname <hostname>  Allowed hostnames to capture in asset discovery
  --disallowed-hostname <hostname>   Disallowed hostnames to abort in asset discovery
  -t, --network-idle-timeout <ms>    Asset discovery network idle timeout
  --disable-cache                    Disable asset discovery caches
  --debug                            Debug asset discovery and do not upload snapshots

Global options:
  -v, --verbose                      Log everything
  -q, --quiet                        Log errors only
  -s, --silent                       Log nothing
  --help                             Display command help

Examples:
  $ percy exec:start &> percy.log

percy exec:stop

Stops a locally running Percy process

Usage:
  $ percy exec:stop [options]

Percy options:
  -P, --port [number]  Local CLI server port (default: 5338)

Global options:
  -v, --verbose        Log everything
  -q, --quiet          Log errors only
  -s, --silent         Log nothing
  -h, --help           Display command help

percy exec:ping

Pings a locally running Percy process

Usage:
  $ percy exec:ping [options]

Percy options:
  -P, --port [number]  Local CLI server port (default: 5338)

Global options:
  -v, --verbose        Log everything
  -q, --quiet          Log errors only
  -s, --silent         Log nothing
  -h, --help           Display command help