AGENTS.md

1# JSON Utilities
2 
3This directory contains a JSON parser and writer.
4 
5## Overarching Purpose
6 
7This directory provides a set of tools for working with JSON data. It is used throughout the gRPC core to parse and generate JSON for things like service configs and load balancing policies.
8 
9## Files
10 
11- **`json.h`**: The main header file for the JSON library.
12- **`json_reader.h` / `json_reader.cc`**: A JSON parser.
13- **`json_writer.h` / `json_writer.cc`**: A JSON writer.
14- **`json_object_loader.h` / `json_object_loader.cc`**: A helper for loading C++ objects from a JSON representation.
15- **`json_util.h` / `json_util.cc`**: Miscellaneous JSON utilities.
16 
17## Notes
18 
19- This is a C++-native JSON library, with no external dependencies.
20- It is designed to be efficient and to avoid unnecessary memory allocations.
21- The `JsonObjectLoader` is a particularly useful tool for converting JSON data into C++ objects in a safe and structured way.
22