https://github.com/sourcemeta/jsontoolkit

JSON Toolkit is a swiss-army knife library for expressive JSON programming in modern C++
https://github.com/sourcemeta/jsontoolkit

cpp cxx json json-pointer json-schema jsonpointer jsonschema

Last synced: 22 days ago
JSON representation

JSON Toolkit is a swiss-army knife library for expressive JSON programming in modern C++

• Host: GitHub
• URL: https://github.com/sourcemeta/jsontoolkit
• Owner: sourcemeta
• License: agpl-3.0
• Created: 2022-12-08T00:21:56.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-04-13T00:11:59.000Z (7 months ago)
• Last Synced: 2024-04-13T16:36:03.797Z (7 months ago)
• Topics: cpp, cxx, json, json-pointer, json-schema, jsonpointer, jsonschema
• Language: C++
• Homepage: https://jsontoolkit.sourcemeta.com/
• Size: 1.63 MB
• Stars: 10
• Watchers: 1
• Forks: 0
• Open Issues: 8
• Metadata Files:
  • Readme: README.markdown
  • Changelog: CHANGELOG.markdown
  • License: LICENSE

Awesome Lists containing this project

README

        
![JSON Toolkit](./assets/banner.png)

![Supported Dialects](https://img.shields.io/endpoint?url=https%3A%2F%2Fbowtie.report%2Fbadges%2Fc%2B%2B-jsontoolkit%2Fsupported_versions.json)

![Draft 2020-12](https://img.shields.io/endpoint?url=https%3A%2F%2Fbowtie.report%2Fbadges%2Fc%2B%2B-jsontoolkit%2Fcompliance%2Fdraft2020-12.json)

![Draft 2019-09](https://img.shields.io/endpoint?url=https%3A%2F%2Fbowtie.report%2Fbadges%2Fc%2B%2B-jsontoolkit%2Fcompliance%2Fdraft2019-09.json)

![Draft 7](https://img.shields.io/endpoint?url=https%3A%2F%2Fbowtie.report%2Fbadges%2Fc%2B%2B-jsontoolkit%2Fcompliance%2Fdraft7.json)

![Draft 6](https://img.shields.io/endpoint?url=https%3A%2F%2Fbowtie.report%2Fbadges%2Fc%2B%2B-jsontoolkit%2Fcompliance%2Fdraft6.json)

![Draft 4](https://img.shields.io/endpoint?url=https%3A%2F%2Fbowtie.report%2Fbadges%2Fc%2B%2B-jsontoolkit%2Fcompliance%2Fdraft4.json)

JSON Toolkit is a high-performance [JSON Schema](http://json-schema.org)

evaluator and related JSON utilities for modern C++. It comes with a built-in

parser and growing support for standards such [JSON

Pointer](https://www.rfc-editor.org/rfc/rfc6901),

[JSONL](https://jsonlines.org), and more. For example:

```cpp

#include 

#include 

#include 

#include 

#include 

#include 

auto main() -> int {

  // Parsing a JSON document from a string

  auto document{sourcemeta::jsontoolkit::parse(R"JSON({

    "name": "John Doe",

    "age": 20,

    "address": "14 Manchester Road, Coventry CV77 1XN"

  })JSON")};

  // Updating a property using JSON Pointer

  const sourcemeta::jsontoolkit::Pointer pointer{"name"};

  sourcemeta::jsontoolkit::JSON new_value{"Jane Doe"};

  sourcemeta::jsontoolkit::set(document, pointer, std::move(new_value));

  // Pretty-print result

  sourcemeta::jsontoolkit::prettify(document, std::cout);

  std::cout << "\n";

  // Create a JSON Schema

  const auto schema{sourcemeta::jsontoolkit::parse(R"JSON({

    "$schema": "https://json-schema.org/draft/2020-12/schema",

    "type": "object",

    "properties": {

      "name": { "type": "string" },

      "age": { "type": "integer" },

      "address": { "type": "string" }

    }

  })JSON")};

  // Compile the JSON Schema

  const auto compiled_schema{sourcemeta::jsontoolkit::compile(

      schema, sourcemeta::jsontoolkit::default_schema_walker,

      sourcemeta::jsontoolkit::official_resolver,

      sourcemeta::jsontoolkit::default_schema_compiler)};

  // Evaluate the compiled JSON Schema

  if (!sourcemeta::jsontoolkit::evaluate(compiled_schema, document)) {

    std::cerr << "JSON Schema validation failed\n";

    return EXIT_FAILURE;

  }

  return EXIT_SUCCESS;

}

```

Documentation

-------------

Refer to the project website for documentation:

[https://jsontoolkit.sourcemeta.com](https://jsontoolkit.sourcemeta.com).

Commercial Use

--------------

This project is governed by the [AGPL-3.0](./LICENSE) copyleft license and our

[Contribution

Agreement](https://github.com/sourcemeta/.github/blob/main/CONTRIBUTING.md). To

ensure the sustainability of the project, you can freely make use of this

software as long the outcome is distributed under the same license. Otherwise,

you must obtain a [commercial license](./LICENSE-COMMERCIAL) that removes such

restrictions. Read more about our licensing approach

[here](https://www.sourcemeta.com/licensing/).