JQL 1.0.0

JSON Query Language for humans

JQL helps you turn a JSON file into the JSON you actually need. Write one readable query, run it from the terminal, and get a new JSON result.

Your first query

Suppose customers.json contains:

[
  {"id": 1, "name": "Amina", "email": "amina@example.com", "city": "Berlin"},
  {"id": 2, "name": "Jon", "email": "jon@example.com", "city": "London"}
]

Ask for just the names and email addresses:

jql "select {name, email} from 'customers.json'"

JQL prints:

[
  {"name": "Amina", "email": "amina@example.com"},
  {"name": "Jon", "email": "jon@example.com"}
]

How the query reads

• select {name, email} describes the result.
• from 'customers.json' chooses the source file.
• Each object in the source becomes one object in the result.

tip

Start with the shape you want. JQL keeps the selected fields and leaves the rest out.

Where to go next

• Start with simple examples and learn one idea at a time.
• Use the language reference when you need the exact behavior of a feature.