Iyume.JsonPath 0.1.0

Iyume.JsonPath

JsonPath compile-time weaving for .NET 10 via C# 14 Interceptors and Incremental Source Generators. Zero runtime parsing overhead for literal paths — the source generator rewrites your JsonPath strings to hard-coded extension method chains at compile time.

Features

• Compile-time literal interception — JsonPath.Select(root, "$.store.book[*].title") is rewritten by the compiler into direct method calls, no parsing at runtime
• Partial method code-gen — [JsonPath(typeof(JsonNode), "$..author")] on a partial method generates the body
• Runtime interpreter — for paths from external input (config, user input, network)
• RFC 9535 compliant parser with full filter expression support
• Supports:
  • System.Text.Json.Nodes.JsonNode
  • System.Text.Json.JsonElement
  • Newtonsoft.Json.Linq.JToken (via optional Iyume.JsonPath.Newtonsoft package)

Installation

# Core package (System.Text.Json support)
dotnet add package Iyume.JsonPath

# Optional: Newtonsoft.Json support
dotnet add package Iyume.JsonPath.Newtonsoft

Interceptor setup

To use JsonPath.Select() with string literals, add the interceptor namespace to your .csproj:

<InterceptorsNamespaces>$(InterceptorsNamespaces);Iyume.JsonPath.Compiler.Generated</InterceptorsNamespaces>

Quick Start

1. Compile-time: Interceptor (JsonPath.Select)

using System.Text.Json.Nodes;
using Iyume.JsonPath.Compiler;

var root = JsonNode.Parse(jsonString);
// The string literal "$.store.book[*].title" is intercepted at compile time
// and replaced with generated extension method calls — zero parsing overhead.
var titles = JsonPath.Select(root, "$.store.book[*].title");

2. Compile-time: Partial Method ([JsonPath])

using System.Text.Json.Nodes;
using Iyume.JsonPath.Compiler;

[JsonPath(typeof(JsonNode), "$.store.book[?(@.price < 10)].title")]
public static partial IEnumerable<JsonNode?> GetCheapBookTitles(JsonNode root);

3. Runtime: Interpreter

using System.Text.Json.Nodes;
using Iyume.JsonPath.Interpreter;

var root = JsonNode.Parse(jsonString);
// For paths from external input — pre-parse once for repeated queries
var ast = JsonPathParser.Parse("$.store.book[*].author");
var authors = JsonPathInterpreter.Evaluate(root, ast);

Supported JsonPath Syntax

Build

# Build
dotnet build Iyume.JsonPath.slnx

# Run tests
dotnet test tests/Iyume.JsonPath.Tests.csproj

# Run benchmarks
dotnet run -c Release --project benchmarks/Iyume.JsonPath.Benchmarks/Iyume.JsonPath.Benchmarks.csproj

Requirements

• .NET 10 (net10.0)
• C# 14

License

MIT — see LICENSE.