How romanr92/adaptive_json5 works
Adaptive_JSON5 is an embedded-oriented C++ JSON5/strict-JSON parser with explicit result-based failures, caller-provided storage, and configurable resource limits. The documented workflow is to pass input to the hosted parse API, receive a document or error, then inspect values through the document interface. The map includes lexical and primitive parsing, document/value access, resource accounting, and diagnostic formatting. Internal links are limited to relationships visible in the README or SOURCE INDEX; unsampled implementation details are not inferred.
Main entry points: value_storage.cpp Document values · parser_engine.cpp Parser engine · parse.cpp Hosted parse · value_view.cpp Value access
Components 18
API and parsing
- Hosted parse
core/src/hosted/parse.cpp - Parser engine
core/src/parser/parser_engine.cpp - Primitive parser
core/src/parser/primitive_parser.cpp - Input view
includes/adaptive_json5/input.hpp - Result and errors
includes/adaptive_json5/result.hpp
Lexical analysis
- Scalar lexer
core/includes/lexer/scalar_lexer.hpp - JSON5 lexer
core/src/lexer
Documents and values
- Document values
core/src/value/value_storage.cpp - Value access
core/src/value/value_view.cpp - Value iteration
core/src/value/value_iterator.cpp - Value index
includes/adaptive_json5/value/value_index.hpp
Memory and limits
- Accounted storage
core/src/memory/accounted_storage.cpp - Owned blocks
includes/adaptive_json5/memory/owned_block.hpp - Buffer storage
core/src/memory/buffer_document_storage.cpp - Work budget
core/includes/memory/work_budget.hpp
Diagnostics and numbers
- Number conversion
core/src/value/numeric_conversion.cpp - Diagnostic formatting
core/src/diagnostics/diagnostic_format.cpp
Other components
- Application
Connections 19
- Application → Hosted parse: parses input
README.md - Hosted parse → Input view: accepts input
- Hosted parse → Document values: returns document
README.md - Hosted parse → Result and errors: returns result
- Application → Value access: reads values
README.md - Parser engine → Input view: reads input
core/src/parser/parser_engine.cpp - Parser engine → Accounted storage: uses accounting
core/src/parser/parser_engine.cpp - Parser engine → Work budget: uses budget
core/src/parser/parser_engine.cpp - Parser engine → Document values: builds values
core/src/parser/parser_engine.cpp - Primitive parser → Scalar lexer: uses tokens
core/src/parser/primitive_parser.cpp - Primitive parser → Input view: scans input
core/src/parser/primitive_parser.cpp - Primitive parser → Document values: constructs values
core/src/parser/primitive_parser.cpp - Document values → Value index: issues indices
core/src/value/value_storage.cpp - Accounted storage → Owned blocks: allocates blocks
core/src/memory/accounted_storage.cpp - Buffer storage → Accounted storage: uses accounting
core/src/memory/buffer_document_storage.cpp - Document values → Value access: provides views
- Value access → Value iteration: iterates values
- Value access → Number conversion: converts numbers
- Application → Diagnostic formatting: formats errors
README.md