Picogron

small code, small memory footprint, small runtime.

Port of gron

The main reason for picogron's existence is to have preserved order for json keys, where gron's keys are either sorted or random.

testdata is copied from gron at 13561bd

Features

• gron and ungron
• preserved order for json keys
• json stream (line-delimited) input
• minimal parsing. A tree of json values is not produced, instead tokens are handled as they are parsed.
• streaming parsing. Instead of reading an entire input at once, the parser pulls data incrementally.
• low memory overhead. A result of minimal and streaming parsing, as well as careful usage of allocators only where needed.

Usage

Transform JSON (from a file or stdin) into discrete assignments to make it greppable

Usage:
  picogron [OPTIONS] [FILE]

positional arguments:
  FILE           file name (stdin if no filename provided)

options:
  -h, --help     show this help message and exit
  -s, --stream   enable stream mode for json input (line delimited)
  -u, --ungron   ungron: convert gron output back to JSON

Features not planned

• sort
• color
• read directly from url
• values only
• json stream output format
• preserving array indices by inserting null during ungron

Development

You'll need zig nightly 2024-04-07 or later to compile picogron. You can download, or use the nix flake in this repo with nix develop (or direnv allow if you use nix-direnv).