buger/jsonparser
Jsonparser
jsonparser is a Go library for parsing, extracting, and modifying JSON data by key path without requiring predefined structs or type schemas. It uses a deterministic state machine to parse JSON directly from byte slices, enabling zero-copy traversal and lazy typed value extraction.
The library provides key-path-based navigation to retrieve raw bytes and typed values from nested JSON structures, supporting extraction of strings, integers, floats, and booleans. It also enables in-place value modification and deletion at specified key paths, as well as iteration over arrays and objects using callback functions. A single-pass multi-key extraction feature scans a JSON payload once to collect values at several specified paths, minimizing parsing overhead.
The documentation covers installation via standard Go tooling and provides examples for field extraction, value modification, key removal, and iteration patterns.
Features
- JSON Parsers - Parses JSON without requiring a schema, offering fast field extraction and modification by key path.
- Schema-Free Parsers - Parses JSON directly from byte slices using a deterministic state machine without requiring predefined structs or type schemas.
- Typed JSON Coercers - Coerces a JSON value into a Go string, integer, float, or boolean and reports an error on type mismatch.
- JSON Value Access Interfaces - Inserts, updates, or removes values at specific key paths within an existing JSON byte slice without full deserialization.
- JSON Value Modifiers - Provides in-place insertion, update, and deletion of values at specified key paths within JSON byte slices.
- JSON Key Path Lookups - Navigate a JSON structure by a sequence of keys and return the raw bytes and type of the matched value.
- Single-Pass Multi-Key Extractors - Extracting several distinct fields from a JSON payload in a single scan to minimize parsing overhead.
- Lazy Extraction - Defers type coercion and value conversion until the caller explicitly requests a typed result.
- Runtime Structure Inferrers - Infers JSON structure and value types at runtime without requiring a predefined Go struct or schema.
- Zero-Copy Parsing - Parses JSON directly from the input byte slice without allocating intermediate strings or objects.
- JSON Byte Range Modifiers - Modifies JSON by locating a value's byte range and overwriting it directly in the source slice.
- JSON Path Navigation - Navigates nested JSON objects and arrays by a dot-separated key path to retrieve raw values or typed data.
- JSON Key Path Extractors - Retrieves values from JSON by dot-separated key paths, returning raw bytes and type information.
- Path-Based Value Inserters - Inserts or updates a value at a given key path inside an existing JSON byte slice.
- JSON Token Scanners - Provides a deterministic state machine that walks JSON tokens to track nesting depth and structural boundaries.
- Path-Based Tree Traversers - Navigates nested JSON by following a dot-separated key path through the parsed token stream.
- Spatial Key-Value Extraction - Extracts several key paths from a JSON payload in a single scan, calling a callback for each found value.
- JSON Array Iteration - Walks each element of a JSON array sequentially, invoking a callback with the element's raw value and detected type.
- JSON Object Iteration - Walks each key-value pair of a JSON object and calls a function with the key, value, and type.
- Callback-Driven Iterators - Walks through JSON arrays or objects element by element, processing each value or key-value pair with a callback function.
- JSON Key Removals - Delete a value at a specified key path from an existing JSON byte slice.
- Multi-Key Extractors - Ships a single-pass multi-key extraction feature that scans a JSON payload once to collect values at several specified paths.
- معالجة JSON - Fast JSON parser.
