@lafferty-lounge/json

The json-ll utility lets you easily inspect, merge, modify, and export JSON and yaml

Installation

npm install -g @lafferty-lounge/json

Usage

json-ll [object path] (--options, ...)

Examples

Read from stdin

echo '{"foo": ["bar"]}' | json-ll foo # -> ["bar"]
echo '{"foo": ["bar"]}' | json-ll foo[0] # -> bar

Read from inline

json-ll foo -f '{"foo": ["bar"]}' # -> ["bar"]
json-ll foo[0] -f '{"foo": ["bar"]}' # -> bar

Read from file

foo.yaml

foo:
  - bar

json-ll foo -f foo.yaml # -> ["bar"]
json-ll foo[0] -f foo.yaml # -> bar

Merging values

json-ll -f '{"foo": {"bar": "baz"}}' --fs foo.bar -t '{"bar": "qux"}' --ts bar # -> '{"foo": {"bar": "qux"}}'

Flags

| Arguments | Shorthand | Input | Default | Description | |-----------------|-----------|-----------------------------------------|---------|-------------------------------------------------------------------------------------------------------------------------------| | --to | -t | - , /filepath, '{ "inline" : "json" }' | - | The source of 'to' JSON/yaml when merging. Read from stdin (-), a file (/filepath), or parse the raw --to argument ('{}'). | | --from | -f | -, /filepath, '{ "inline" : "json" }' | - | The source of 'from' JSON/yaml when merging. Read from stdin (-), a file (/filepath), or parse the raw --from argument ('{}') | | --to-selector | --ts | object.path.[0].syntax | | The object/property path to set in the 'to' JSON | | --from-selector | --fs | object.path[0].syntax | | The object/property path to take from the 'from' JSON | | --value | -v | -, '{ "inline" : "json" }' | | The value to use in place of the 'from' JSON content. | | --selector | -s | object.path.[0].syntax | | The object path to use when no merging is taking place. | | --output-file | --of | /filepath | | The file to write the output of the command to if specified. Content is printed to stdout by default. | | --keys | -k | | false | List only the keys for an object path | | --newline | -n | | false | When set the newline that normally appears at the end of the output is ignored. (Don't write newline) | | --spaces | | [-1,0,1,2,...] | 3 | When outputting in the JSON format the --spaces flag tells how many spaces to use for indentation. -1 for no indentation. | | --output | -o | raw, pretty, json, yaml | pretty | What format to output the data in |

Quirks

• You can't escape . yet so you can't use keys with literal dots.