⭐ dict.recurse( .. )

[arlimus]

Recurse through an arbitrary dict (JSON/YAML/...) structure and find entries that match a search criteria.

For example, you can set up a data structure like this:

{
  "users": [
    {"name": "bob"}
  ],
  "owners": {
    "admins": [
      {"name": "joy", "isOwner": true}
    ]
  }
}

Finding any user in this list is difficult with traditional mechanisms, since you'd have to understand the data structure and where to search.

With recurse it is made much easier:

jdata.recurse( name != empty )

[
  0: {
    name: "bob"
  }
  1: {
    isOwner: true
    name: "joy"
  }
]

You could then just grab the names and continue:

jdata.recurse( name != empty ).map(name)

[
  0: "bob"
  1: "joy"
]

Full JSON example with cnquery

Let's create a file t.json:

{
  "users": [
    {"name": "bob"}
  ],
  "owners": {
    "admins": [
      {"name": "joy", "isOwner": true}
    ]
  }
}

Then open a shell in the same folder:

> cnquery shell

We can now access the JSON file and recurse into it

cnquery> parse.json("t.json").params.recurse(name != empty).map(name)
parse.json.params.recurse.map: [
  0: "bob"
  1: "joy"
]

[scottford-io]

This worked well for me @arlimus. ⭐

[chris-rock]

Works like a charm! Great addition @arlimus