gron Training Sessions

Master JSON structure discovery with gron. gron flattens JSON into greppable assignment statements — use it when you don’t know the shape of your data.

Training Philosophy

  1. gron is for discovery, jq is for extraction — different tools, complementary

  2. Real APIs - GitHub, infrastructure tools, real JSON

  3. Round-trip - gron → grep → ungron reconstructs filtered JSON

  4. Composition - gron finds the path, jq extracts the value

Sessions (Curriculum)

Session Focus Duration Status

01

Flatten, grep paths, ungron round-trip

30 min

[ ] Planned

02

API discovery — gh api + gron workflow

45 min

[ ] Planned

03

Multi-tool composition — gron + jq + yq pipelines

45 min

[ ] Planned

Drills (Practice)

Drill Focus Difficulty

01

Flatten, grep, ungron

Beginner

02

GitHub API exploration

Intermediate

03

Multi-tool pipelines

Advanced

Quick Start

# Run the drill menu
bash ~/atelier/_bibliotheca/domus-captures/docs/modules/ROOT/examples/gron-drills/00-run-drill.sh

# Or run a specific drill
bash ~/atelier/_bibliotheca/domus-captures/docs/modules/ROOT/examples/gron-drills/00-run-drill.sh 01

When to Use gron vs jq vs yq

Tool When to use

gron

You don’t know the structure yet. Flatten, grep, discover paths.

jq

You know the structure. Extract, reshape, filter, aggregate.

yq

Input is YAML. Convert to JSON with -o=json, then pipe to jq.

Related