Hyperbee.Json 3.0.1

dotnet add package Hyperbee.Json --version 3.0.1                
NuGet\Install-Package Hyperbee.Json -Version 3.0.1                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Hyperbee.Json" Version="3.0.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Hyperbee.Json --version 3.0.1                
#r "nuget: Hyperbee.Json, 3.0.1"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Hyperbee.Json as a Cake Addin
#addin nuget:?package=Hyperbee.Json&version=3.0.1

// Install Hyperbee.Json as a Cake Tool
#tool nuget:?package=Hyperbee.Json&version=3.0.1                

Welcome to Hyperbee Json

Hyperbee Json is a high-performance JSON library for .NET, providing robust support for JSONPath, JsonPointer, JsonPatch, and JsonDiff. This library is optimized for speed and low memory allocations, and it adheres to relevant RFCs to ensure reliable and predictable behavior.

Unlike other libraries that support only JsonElement or JsonNode, Hyperbee.Json supports both types, and can be easily extended to support additional document types and functions.

Features

  • High Performance: Optimized for performance and efficiency.
  • Low Memory Allocations: Designed to minimize memory usage.
  • Comprehensive JSON Support: Supports JSONPath, JsonPointer, JsonPatch, and JsonDiff.
  • Conformance: Adheres to the JSONPath Specification RFC 9535, JSONPointer RFC 6901, and JsonPatch RFC 6902.
  • Supports both JsonElement and JsonNode: Works seamlessly with both JSON document types.

JSONPath

JSONPath is a query language for JSON, allowing you to navigate and extract data from JSON documents using a set of path expressions. Hyperbee.Json's JSONPath implementation is designed for optimal performance, ensuring low memory allocations and fast query execution. It fully conforms to RFC 9535.

Read more about JsonPath

JSONPointer

JSONPointer is a syntax for identifying a specific value within a JSON document. It is simple and easy to use, making it an excellent choice for pinpointing exact values. Hyperbee.Json's JsonPointer implementation adheres to RFC 6901.

Read more about JsonPointer

JSONPatch

JSONPatch is a format for describing changes to a JSON document. It allows you to apply partial modifications to JSON data efficiently. Hyperbee.Json supports JsonPatch as defined in RFC 6902.

Read more about JsonPatch

JSONDiff

JSONDiff allows you to compute the difference between two JSON documents, which is useful for versioning and synchronization. Hyperbee.Json's implementation is optimized for performance and low memory usage, adhering to the standards set in RFC 6902.

Read more about JsonDiff

Getting Started

To get started with Hyperbee.Json, refer to the documentation for detailed instructions and examples.

You can intall the library via NuGet:

dotnet add package Hyperbee.Json

Benchmarks

Here is a performance comparison of various JSONPath queries on the standard book store document.

{
  "store": {
    "book": [
      {
        "category": "reference",
        "author": "Nigel Rees",
        "title": "Sayings of the Century",
        "price": 8.95
      },
      {
        "category": "fiction",
        "author": "Evelyn Waugh",
        "title": "Sword of Honour",
        "price": 12.99
      },
      {
        "category": "fiction",
        "author": "Herman Melville",
        "title": "Moby Dick",
        "isbn": "0-553-21311-3",
        "price": 8.99
      },
      {
        "category": "fiction",
        "author": "J. R. R. Tolkien",
        "title": "The Lord of the Rings",
        "isbn": "0-395-19395-8",
        "price": 22.99
      }
    ],
    "bicycle": {
      "color": "red",
      "price": 19.95
    }
  }
}
Method Mean Error StdDev Allocated
$..* First()
Hyperbee_JsonElement 2.874 μs 1.6256 μs 0.0891 μs 3.52 KB
Hyperbee_JsonNode 3.173 μs 0.7979 μs 0.0437 μs 3.09 KB
JsonEverything_JsonNode 3.199 μs 2.4697 μs 0.1354 μs 3.53 KB
JsonCons_JsonElement 5.976 μs 8.4042 μs 0.4607 μs 8.48 KB
Newtonsoft_JObject 9.219 μs 2.9245 μs 0.1603 μs 14.22 KB
$..*
JsonCons_JsonElement 5.674 μs 3.8650 μs 0.2119 μs 8.45 KB
Hyperbee_JsonElement 7.934 μs 3.5907 μs 0.1968 μs 9.13 KB
Hyperbee_JsonNode 10.457 μs 7.7120 μs 0.4227 μs 10.91 KB
Newtonsoft_JObject 10.722 μs 4.1310 μs 0.2264 μs 14.86 KB
JsonEverything_JsonNode 23.096 μs 10.8629 μs 0.5954 μs 36.81 KB
$..price
Hyperbee_JsonElement 4.428 μs 4.6731 μs 0.2561 μs 4.2 KB
JsonCons_JsonElement 5.355 μs 1.1624 μs 0.0637 μs 5.65 KB
Hyperbee_JsonNode 7.931 μs 0.6970 μs 0.0382 μs 7.48 KB
Newtonsoft_JObject 10.334 μs 8.2331 μs 0.4513 μs 14.4 KB
JsonEverything_JsonNode 17.000 μs 14.9812 μs 0.8212 μs 27.63 KB
$.store.book[?(@.price == 8.99)]
Hyperbee_JsonElement 4.153 μs 3.6089 μs 0.1978 μs 5.24 KB
JsonCons_JsonElement 4.873 μs 1.0395 μs 0.0570 μs 5.05 KB
Hyperbee_JsonNode 6.980 μs 5.1007 μs 0.2796 μs 8 KB
Newtonsoft_JObject 10.629 μs 3.9096 μs 0.2143 μs 15.84 KB
JsonEverything_JsonNode 11.133 μs 7.2544 μs 0.3976 μs 15.85 KB
$.store.book[0]
Hyperbee_JsonElement 2.677 μs 2.2733 μs 0.1246 μs 2.27 KB
Hyperbee_JsonNode 3.126 μs 3.5345 μs 0.1937 μs 2.77 KB
JsonCons_JsonElement 3.229 μs 0.0681 μs 0.0037 μs 3.21 KB
JsonEverything_JsonNode 4.612 μs 2.0037 μs 0.1098 μs 5.96 KB
Newtonsoft_JObject 9.627 μs 1.1498 μs 0.0630 μs 14.56 KB

Credits

Hyperbee.Json is built upon the great work of several open-source projects. Special thanks to:

Contributing

We welcome contributions! Please see our Contributing Guide for more details.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net8.0

    • No dependencies.
  • net9.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
3.0.1 73 12/4/2024
3.0.0 81 11/20/2024
3.0.0-develop.241120190203 38 11/20/2024
2.0.1 120 8/2/2024
2.0.0 95 8/1/2024
2.0.0-develop.240801174802 50 8/1/2024
1.4.0 134 7/22/2024
1.4.0-develop.240722203604 64 7/22/2024
1.3.0 110 7/12/2024
1.3.0-develop.240712213246 50 7/12/2024
1.2.1 121 7/2/2024
1.2.1-develop.240702141343 53 7/2/2024
1.2.1-develop.240625212527 56 6/25/2024
1.2.1-develop.240621185513 53 6/21/2024
1.2.1-develop.240620151810 61 6/20/2024
1.2.0-develop.240619213520 64 6/19/2024
1.1.0 125 6/14/2024
1.1.0-develop.240614155707 51 6/14/2024
1.0.0 130 4/8/2024