#json #serde-json #patch #merge #rfc #document

json-patch

RFC 6902, JavaScript Object Notation (JSON) Patch

16 releases (6 stable)

3.0.1 Oct 7, 2024
2.0.0 May 6, 2024
1.4.0 May 6, 2024
1.2.0 Oct 9, 2023
0.2.1 Nov 3, 2017

#172 in Encoding

Download history 285229/week @ 2024-08-20 279221/week @ 2024-08-27 296857/week @ 2024-09-03 300682/week @ 2024-09-10 292592/week @ 2024-09-17 336303/week @ 2024-09-24 348795/week @ 2024-10-01 356990/week @ 2024-10-08 380364/week @ 2024-10-15 405469/week @ 2024-10-22 386645/week @ 2024-10-29 398812/week @ 2024-11-05 388757/week @ 2024-11-12 337461/week @ 2024-11-19 253311/week @ 2024-11-26 244622/week @ 2024-12-03

1,293,660 downloads per month
Used in 389 crates (54 directly)

MIT/Apache

39KB
686 lines

crates.io crates.io Build Codecov

json-patch

A JSON Patch (RFC 6902) and JSON Merge Patch (RFC 7396) implementation for Rust.

Usage

Add this to your Cargo.toml:

[dependencies]
json-patch = "*"

Examples

Create and patch document using JSON Patch:

#[macro_use]
use json_patch::{Patch, patch};
use serde_json::{from_value, json};

let mut doc = json!([
    { "name": "Andrew" },
    { "name": "Maxim" }
]);

let p: Patch = from_value(json!([
  { "op": "test", "path": "/0/name", "value": "Andrew" },
  { "op": "add", "path": "/0/happy", "value": true }
])).unwrap();

patch(&mut doc, &p).unwrap();
assert_eq!(doc, json!([
  { "name": "Andrew", "happy": true },
  { "name": "Maxim" }
]));

Create and patch document using JSON Merge Patch:

#[macro_use]
use json_patch::merge;
use serde_json::json;

let mut doc = json!({
  "title": "Goodbye!",
  "author" : {
    "givenName" : "John",
    "familyName" : "Doe"
  },
  "tags":[ "example", "sample" ],
  "content": "This will be unchanged"
});

let patch = json!({
  "title": "Hello!",
  "phoneNumber": "+01-123-456-7890",
  "author": {
    "familyName": null
  },
  "tags": [ "example" ]
});

merge(&mut doc, &patch);
assert_eq!(doc, json!({
  "title": "Hello!",
  "author" : {
    "givenName" : "John"
  },
  "tags": [ "example" ],
  "content": "This will be unchanged",
  "phoneNumber": "+01-123-456-7890"
}));

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~0.9–2MB
~41K SLoC