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
1,293,660 downloads per month
Used in 389 crates
(54 directly)
39KB
686 lines
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
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
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