ferritin-common 0.5.0

library for rustdoc navigation and search
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

//! Conversion from rustdoc-types format version 55 to 56
//!
//! Changes in v56:
//! - Added `ItemKind::Attribute` enum variant
//!
//! Strategy: Parse as v55, serialize to JSON, deserialize as v56
//! Since this is just an enum addition, no JSON patching is needed.

use anyhow::{Context, Result};
use rustdoc_types_55 as v55;
use rustdoc_types_56 as v56;
use sonic_rs::JsonValueMutTrait;

/// Convert a v55 Crate to v56
///
/// This works by round-tripping through sonic_rs::Value.
/// Since v56 only adds a new enum variant that won't exist in v55 data,
/// we only need to update the format_version field.
pub fn convert_crate(crate_55: v55::Crate) -> Result<v56::Crate> {
    let mut json_value =
        sonic_rs::value::to_value(&crate_55).context("Failed to serialize v55 crate to JSON")?;

    // Update format_version in JSON before deserializing
    if let Some(obj) = json_value.as_object_mut() {
        obj.insert("format_version", sonic_rs::json!(56));
    }

    let crate_56: v56::Crate =
        sonic_rs::value::from_value(&json_value).context("Failed to deserialize as v56 crate")?;

    Ok(crate_56)
}