Crate libaki_json_pick

source ·
Expand description

The json pick out command.

§Features

  • the json pick out command.
  • minimum support rustc 1.58.1 (db9d1b20b 2022-01-20)

§Command help

aki-json-pick --help

Usage:
  aki-json-pick [options]

The json pick out command.

Options:
      --color <when>        json colored output.
  -s, --select <selector>   pick out json value by <selector>.
  -p, --pretty              pretty output.
  -r, --raw-output          raw string output without JSON double-quote.

  -H, --help        display this help and exit
  -V, --version     display version information and exit
  -X <x-options>    x options. try -X help

Option Parameters:
  <when>        'always', 'never', or 'auto'
  <selector>    json selector

Examples:
  pick out some.property value:
    echo -e '{ "some": { "property": "yay!" } }' | aki-json-pick -s '"some"."property"'

§Examples

§Example 1: root selection

command line:

cat fixtures/01.json | aki-json-pick -s '.'

result output:

"This is a valid JSON text with one value"

§Example 2: child selection

command line:

cat fixtures/01.json | aki-json-pick -s '"some"."property"'

result output:

"yay!"

§Example 3: index selection

command line:

cat fixtures/01.json | aki-json-pick -s '"primes".[0]'

result output:

7

command line:

cat fixtures/01.json | aki-json-pick -s '"primes"[0]"'

result output:

7

command line:

cat fixtures/01.json | aki-json-pick -s '"primes".[2,0]'

result output:

[13,7]

§Reference

This crate use jql. The selector is comatible.

§Library example

See fn execute() for this library examples.

Functions§