❤
npm
Sign UpSign In

percy-hydration
TypeScript icon, indicating that this package has built-in type declarations

1.0.2 • Public • Published

Percival Hydration and JSON Comparison Command Line Utilities

Prerequisites

  • Node.js 10.15.x
  • Npm 6

Installation

npm install percy-hydration

Or install commands globally

npm install -g percy-hydration

Usage In Command Line

compare-json

Script for comparing two json files and outputting their differences to stdout

compare-json <path/to/file.json> <path/to/file.json>

# Example
compare-json test/data/.percyrc test/data/modified.percyrc

# To generate HTML report
compare-json test/data/.percyrc test/data/modified.percyrc --out ./test/data/out/diff.html

# to turn off/on the console color  pass --consoleColor false/true respectively
compare-json test/data/.percyrc test/data/modified.percyrc --colorConsole=false

hydrate

Script for processing YAML configuration files and converting it to environment specific JSON configuration

hydrate < --root | --app | --file > <path/to/input> --out <path/to/output> It provides three options

  • --root -r for processing all apps in a root directory
  • --app -a for processing a single app directory
  • --file -f for processing a single file You should specify one of these three options.
# Examples

# Process all apps
hydrate -r test/data/apps --out test/data/out/dist

# Process single app
hydrate -a test/data/apps/shop --out test/data/out/dist/shop

# Process single file
hydrate -f test/data/apps/shop/app.config.yaml --out test/data/out/dist/shop

# to turn off/on the console color  pass --consoleColor false/true respectively
hydrate -r test/data/apps --out test/data/out/dist --colorConsole=false

NOTE: if you are not installing globally, used the scripts like below instead:

node_modules/.bin/hydrate -r test/data/apps --out test/data/out/dist
node_modules/.bin/compare-json test/data/.percyrc test/data/modified.percyrc --out ./test/data/out/diff.html

Configuration

Main configuration file can be found at config/default.js

Variable Description
PERCY_LOG_LEVEL
PERCY_ENVIRONMENT_FILE_NAME Name of the environment file (default value: environments.yaml)
PERCY_CONFIG_FILE_NAME Name of the percy configuration file (default value: .percyrc)
PERCY_ENV_VARIABLE_NAME The YAML environment variable name (default value: env)
PERCY_ENV_IGNORE_PREFIX The prefix of env not to generate the config files (default value: _)
PERCY_ENV_IGNORE_SUFFIX The suffix of env not to generate the config files (default value: _)
PERCY_DEFAULT_VARIABLE_PREFIX The YAML variable substitute prefix (default value: _{)
PERCY_DEFAULT_VARIABLE_SUFFIX The YAML variable substitute suffix (default value: }_)
PERCY_DEFAULT_VARIABLE_NAME_PREFIX The YAML variable name prefix (default value: $)
PERCY_CONSOLE_COLORS The flag whether to colorize the console output or not

The app folder can contain optional .percyrc files, which provide repository-specific or application-specific configuration. The following properties are supported now:

Property Description
variablePrefix The YAML variable substitute prefix
variableSuffix The YAML variable substitute suffix
variableNamePrefix The YAML variable name prefix

If it's in the apps folder, the configuration applies to all applications, and if it's in the specific application folder, it only applies to the corresponding application. When provided, the default properties from the config/default.js will be overridden.

Here is an example of .percyrc file:

{
  "variablePrefix": "{{",
  "variableSuffix": "}}",
  "variableNamePrefix": "_"
}

Installation

# Install dependencies
npm install -g lerna
lerna bootstrap --hoist

# Lint code
lerna run --scope=percy-hydration --stream lint

# Run unit tests with coverage
lerna run --scope=percy-hydration --stream test

Usage inside the lib

compare-json

Script for comparing two json files and outputting their differences to stdout

npm run compare-json <path/to/file.json> <path/to/file.json>

or using lerna:

lerna run --scope=percy-hydration --stream compare-json -- <path/to/file.json> <path/to/file.json>

# Example
npm run compare-json test/data/.percyrc test/data/modified.percyrc

lerna run --scope=percy-hydration --stream compare-json -- test/data/.percyrc test/data/modified.percyrc

# To generate HTML report
npm run compare-json test/data/.percyrc test/data/modified.percyrc -- --out ./test/data/out/diff.html

lerna run --scope=percy-hydration --stream compare-json -- test/data/.percyrc test/data/modified.percyrc -- --out ./test/data/out/diff.html

hydrate

Script for processing YAML configuration files and converting it to environment specific JSON configuration

npm run hydrate -- < --root | --app | --file > <path/to/input> --out <path/to/output>

or using lerna:

lerna run --scope=percy-hydration --stream hydrate -- -- < --root | --app | --file > <path/to/input> --out <path/to/output>

It provides three options

  • --root -r for processing all apps in a root directory
  • --app -a for processing a single app directory
  • --file -f for processing a single file You should specify one of these three options.
# Examples

# Process all apps
npm run hydrate -- -r ../test/data/apps --out ../test/data/out/dist

lerna run --scope=percy-hydration --stream hydrate -- -- -r ../test/data/apps --out ../test/data/out/dist

# Process single app
npm run hydrate -- -a ../test/data/apps/shop --out ../test/data/out/dist/shop

lerna run --scope=percy-hydration --stream hydrate -- -- -a ../test/data/apps/shop --out ../test/data/out/dist/shop

# Process single file
npm run hydrate -- -f ../test/data/apps/shop/app.config.yaml --out ../test/data/out/dist/shop

lerna run --scope=percy-hydration --stream hydrate -- -- -f ../test/data/apps/shop/app.config.yaml --out ../test/data/out/dist/shop

Run with compiled JS (better performance)

You can compiled the ts files to js, by running:

lerna run --scope=percy-hydration --stream tsc

then run the js files using these script:

# hydrate Examples

# Process all apps
npm run hydrate.js -- -r ../test/data/apps --out ../test/data/out/dist

lerna run --scope=percy-hydration --stream hydrate.js -- -- -r ../test/data/apps --out ../test/data/out/dist

# Process single app
npm run hydrate.js -- -a ../test/data/apps/shop --out ../test/data/out/dist/shop

lerna run --scope=percy-hydration --stream hydrate.js -- -- -a ../test/data/apps/shop --out ../test/data/out/dist/shop

# Process single file
npm run hydrate.js -- -f ../test/data/apps/shop/app.config.yaml --out ../test/data/out/dist/shop

lerna run --scope=percy-hydration --stream hydrate.js -- -- -f ../test/data/apps/shop/app.config.yaml --out ../test/data/out/dist/shop

# compare-json Example
npm run compare-json.js test/data/.percyrc test/data/modified.percyrc

lerna run --scope=percy-hydration --stream compare-json.js -- test/data/.percyrc test/data/modified.percyrc

Documentation

Documentations are auto generated and can be accessed from docs folder. In order to generate docs again you can call lerna run --scope=percy-hydration --stream docs command.

Publish

To publish this library, run:

lerna run --scope=percy-hydration --stream tsc
npm publish

Readme

Keywords

none

Package Sidebar

Install

npm i percy-hydration

Repository

github.com/tmobile/percy

Homepage

github.com/tmobile/percy#readme

Weekly Downloads

0

Version

1.0.2

License

Apache-2.0

Unpacked Size

195 kB

Total Files

102

Last publish

Collaborators

  • kpburson
Try on RunKit
Report malware