Skip to content

Latest commit

 

History

History
46 lines (26 loc) · 1.31 KB

readme.md

File metadata and controls

46 lines (26 loc) · 1.31 KB

Coeus - JQ-compatible JSON Queries in .NET

Coeus NUGET Package NuGet

Simply put, Coeus implements JQ-compatible queries for JSON.NET. Query and update JToken, JObject, JArray, JValue and friends.

JQ is more powerful than JSON Path/Patch and is a widely-adopted pseudo-standard from the Linux command line.

Goals

  • Simple extension methods for System.String to query against JToken

  • No CLI (yet)

  • 100% JQ compatibility may not be realistic, though we'll strive to include most operators and functions

Usage

var json = new JObject
{
    ["foo"] = new JArray { 1, 2, 3 }
};

var query = "{ \"bar\": .foo[2] }";

var output = query.EvalToToken(json);

// output --> { 'bar': 3 }

Console.WriteLine(output["bar"].Value<int>());  // 3

Background and Resources

  • The JQ manual is a wealth of information about query syntax and behavior

  • Coeus is implemented using the excellent Sprache parser combinator library

  • More on parser combinators here. Your head will hurt, until it doesn't :-)