JsonCons.Net

JsonCons.Utilities	JsonCons.JsonPath	JsonCons.JmesPath

The JsonCons.Net libraries include classes that complement the functionality of the System.Text.Json namespace. The libraries target .Net Standard 2.1.

The JsonCons.Net libraries offer support for:

JSON Pointer as defined in RFC 6901
JSON Patch as defined in RFC 6902
JSON Merge Patch as defined in RFC 7396
JSONPath as defined in JsonCons JsonPath
JMESPath as defined in JMESPath Specification

JSONPath and JMESPath

JSONPath allows you to select from a JsonDocument a list of JsonElement instances that belong to it. JMESPath allows you to transform a JsonDocument into another JsonDocument.

For example, consider the JSON data

string jsonString = @"
{
    ""Data"":[
        {
            ""KeyOfInterest"":true,
            ""AnotherKey"":true
        },
        {
            ""KeyOfInterest"":false,
            ""AnotherKey"":true
        },
        {
            ""KeyOfInterest"":true,
            ""AnotherKey"":true
        }
    ]
}
        ";

using JsonDocument doc = JsonDocument.Parse(jsonString);

JSONPath allows you to select the KeyOfInterest values like this:

string path = "$.Data[*].KeyOfInterest";
IList<JsonElement> results = JsonSelector.Select(doc.RootElement, path);

and the union of KeyOfInterest and AnotherKey values like this:

string path = "$.Data[*]['KeyOfInterest', 'AnotherKey']";
IList<JsonElement> results = JsonSelector.Select(doc.RootElement, path);

The first query produces

[true,false,true]

and the second

[true,true,false,true,true,true]

Note that each element in the result - true, false, true - corresponds to an element at a specific location in the original JSON document. This is a feature of JSONPath.

JMESPath allows you to select the KeyOfInterest values like this:

string expr = Data[*].KeyOfInterest;
JsonDocument result = JsonTransformer.Transform(doc.RootElement, expr);

and a multiselect hash of KeyOfInterest and AnotherKey values like this:

string expr = "Data[*].{\"Key of Interest\" : KeyOfInterest, \"Another Key\": AnotherKey}";
JsonDocument result = JsonTransformer.Transform(doc.RootElement, expr);

The first query produces

[true,false,true]

and the second

[
  {
    "Key of Interest": true,
    "Another Key": true
  },
  {
    "Key of Interest": false,
    "Another Key": true
  },
  {
    "Key of Interest": true,
    "Another Key": true
  }
]