mab122
/
radicle-heartwood-lfs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

radicle/id: Introduce `PayloadUpsert` 

Instead of using triples, introduce a `struct` to carry upserts.
This commit is contained in:
Lorenz Leutgeb 2025-10-14 20:27:28 +02:00 committed by Lorenz Leutgeb
parent ec1d754308
commit d3ed4bb497
1 changed files with 41 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

68
crates/radicle/src/identity/doc/update.rs
View File

@ -139,40 +139,52 @@ where
}
}
/// [`Payload`]: super::Payload
/// A change (update or insertion) to particular `key` within a [`Payload`]
/// in a document.
#[derive(Clone, Debug, PartialEq, Eq)]
pub struct PayloadUpsert {
/// [`Payload`]: super::Payload
/// The identifier for the document [`Payload`].
pub id: PayloadId,
/// [`Payload`]: super::Payload
/// The key within the [`Payload`] that is being updated.
pub key: String,
/// [`Payload`]: super::Payload
/// The value to update within the [`Payload`].
pub value: json::Value,
}
// TODO(finto): I think this API would likely be much nicer if we use [JSON Patch][patch] and [JSON Merge Patch][merge]
//
// [patch]: https://datatracker.ietf.org/doc/html/rfc6902
// [merge]: https://datatracker.ietf.org/doc/html/rfc7396
/// Change the payload of the document, using the set of triples:
///
/// - [`PayloadId`]: the identifier for the document [`Payload`]
/// - [`String`]: the key within the [`Payload`] that is being updated
/// - [`json::Value`]: the value to update the [`Payload`]
/// [`Payload`]: super::Payload
/// Change (update or insert) a key in a [`Payload`] of the document,
/// using the provided `updates`.
///
/// # Errors
///
/// This fails if one of the [`PayloadId`]s does not point to a JSON object as
/// its value.
///
/// [`Payload`]: super::Payload
pub fn payload(
mut raw: RawDoc,
payload: Vec<(PayloadId, String, json::Value)>,
upserts: impl IntoIterator<Item = PayloadUpsert>,
) -> Result<RawDoc, error::PayloadError> {
for (id, key, val) in payload {
for PayloadUpsert { id, key, value } in upserts {
if let Some(ref mut payload) = raw.payload.get_mut(&id) {
if let Some(obj) = payload.as_object_mut() {
if val.is_null() {
if value.is_null() {
obj.remove(&key);
} else {
obj.insert(key, val);
obj.insert(key, value);
}
} else {
return Err(error::PayloadError::ExpectedObject { id });
}
} else {
raw.payload
.insert(id, serde_json::json!({ key: val }).into());
.insert(id, serde_json::json!({ key: value }).into());
}
}
Ok(raw)
@ -277,21 +289,23 @@ mod test {
test::arbitrary,
};
use super::PayloadUpsert;
#[test]
fn test_can_update_crefs() {
let raw = arbitrary::gen::<RawDoc>(1);
let raw = super::payload(
raw,
vec![(
PayloadId::canonical_refs(),
"rules".to_string(),
json!({
[PayloadUpsert {
id: PayloadId::canonical_refs(),
key: "rules".to_string(),
value: json!({
"refs/tags/*": {
"threshold": 1,
"allow": "delegates"
}
}),
)],
}],
)
.unwrap();
let verified = super::verify(raw);
@ -306,10 +320,10 @@ mod test {
));
let raw = super::payload(
raw,
vec![(
PayloadId::canonical_refs(),
"rules".to_string(),
json!({
[PayloadUpsert {
id: PayloadId::canonical_refs(),
key: "rules".to_string(),
value: json!({
"refs/tags/*": {
"threshold": 1,
"allow": "delegates"
@ -319,7 +333,7 @@ mod test {
"allow": "delegates",
}
}),
)],
}],
)
.unwrap();
assert!(
@ -339,16 +353,16 @@ mod test {
));
let raw = super::payload(
raw,
vec![(
PayloadId::canonical_refs(),
"rules".to_string(),
json!({
[PayloadUpsert {
id: PayloadId::canonical_refs(),
key: "rules".to_string(),
value: json!({
"refs/tags/*": {
"threshold": 1,
"allow": "delegates"
}
}),
)],
}],
)
.unwrap();
let verified = super::verify(raw).unwrap();