tomnomnom/gron
Gron
Gron is a command line utility that transforms nested JSON data into a flat list of path-value assignments. This process converts hierarchical structures into line-based statements, mapping every leaf value to its absolute path to make the data compatible with standard text-processing tools.
The tool allows for the bidirectional transformation of data, enabling the reconstruction of original nested JSON objects from flattened path assignments. It can ingest JSON from local files, standard input, or remote URLs, with the ability to route network traffic through proxy servers.
The utility supports stream-based processing to handle large inputs and can export flattened data as a continuous stream of JSON objects. It also includes validation to ensure property keys conform to JavaScript naming rules during data transformation.
Features
- Text-Processing Reformatting - Transforms nested JSON into a flat line-based format that preserves paths for efficient text searching.
- Greppable Data Formats - Formats JSON as a series of discrete assignments to make it compatible with standard grep tools.
- Flattening Converters - Transforms structured JSON data into line-based statements and reverts them back to original JSON objects.
- JSON Processing Utilities - Provides a terminal-based tool for fetching, flattening, and processing JSON data from various sources.
- JSON Result Flattening - Converts nested JSON structures into a flat list of absolute path-to-value assignments.
- Flattening Converters - Flattens nested JSON into line-based assignments for grep searching and restores the original structure.
- Structural Reconstruction - Provides the ability to reconstruct original nested JSON objects from flattened path assignments.
- JSON Structure Restoration - Implements the ability to reconstruct nested JSON objects from flattened path-value assignments.
- JSON Command Line Workflows - Enables converting complex JSON objects into greppable paths for easier debugging and auditing in the terminal.
- Data Ingestion Sources - Reads JSON data from diverse locations including local files, remote URLs, and standard input.
- JSON Search Indices - Transforms nested JSON into a flat list of assignments that preserve full paths for grep discovery.
- Memory-Efficient Streaming - Employs memory-efficient streaming to process large JSON inputs without loading entire files into memory.
- Newline-Delimited JSON Streams - Processes input by reading one JSON object per line to handle large datasets efficiently.
- API Inspection Tools - Fetches and flattens JSON responses from web endpoints to quickly locate data points within API payloads.
- JSON API Clients - Provides a terminal-based interface to retrieve JSON data from remote URLs via HTTP.
- Path-Value Mapping - Maps leaf values to their absolute paths to enable text-based filtering of deeply nested data.
- Text Processing Utilities - Formats data as discrete single-line entries for use with Unix text-processing utilities.
- Remote Data Fetching - Retrieves JSON payloads from remote URLs using HTTP requests with proxy and timeout support.
- Data Manipulation - Make JSON greppable.
- JSON and Tree Data - Convert JSON to flat, greppable path-value lists.
- Command Line Tools - Listed in the “Command Line Tools” section of the The Book Of Secret Knowledge awesome list.
- Miscellaneous Tools - Tool to make JSON greppable.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
