cli-exec

@percy/cli-exec

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

Commands

• percy exec
• percy exec:start
• percy exec:stop
• percy exec:ping

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
  -l, --labels <string>              Associates labels to the build (ex: --labels=dev,prod )
  --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
  -l, --labels <string>              Associates labels to the build (ex: --labels=dev,prod )
  --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
  -l, --labels <string>  Associates labels to the build (ex: --labels=dev,prod )
  -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
  -l, --labels <string>  Associates labels to the build (ex: --labels=dev,prod )
  -h, --help             Display command help