Jql

Use this skill when the user wants to query, filter, or transform JSON data using a simple query language, or extract specific values from JSON files.

javimosch 9fecf74 1.2 KB Updated

File contents

jql Plugin

JSON Query Language CLI — query and transform JSON with a simple query syntax.

Commands

Query

  • jql query run — Query JSON with a jql query

Validate

  • jql validate run — Validate JSON data

Usage Examples

  • "Extract a key from JSON"
  • "Get nested values from JSON"
  • "Query an array index"
  • "Validate JSON file"

Installation

cargo install jql
# or
brew install jql

Examples

# Query a key
echo '{"a":1}' | jql '"a"'

# Nested key
echo '{"a":{"b":2}}' | jql '"a""b"'

# Array index
echo '[1,2,3]' | jql '[0]'

# Array range
echo '[1,2,3]' | jql '[1:2]'

# Multiple keys
echo '{"a":1,"b":2}' | jql '"a","b"'

Query Syntax

Selectors

  • "key" — Key selector
  • {"key1","key2"} — Multi key selector
  • [0] — Array index
  • [0:2] — Array range
  • {0} — Object index

Operators

  • .. — Flatten operator
  • @ — Keys operator
  • |> — Pipe in (parallel)
  • <| — Pipe out
  • ! — Truncate operator

javimosch/supercli/tree/main/plugins/jql/skills/quickstart commit 9fecf74c2a

Frequently asked questions

npx skillmds@latest add javimosch/jql