sbom-tools 0.1.22

Semantic SBOM diff and analysis tool
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
33

//! SBOM serialization and transformation.
//!
//! Two complementary strategies live here:
//! - [`enricher`]/[`merger`]/[`pruner`] patch the *original* raw JSON in place,
//!   preserving the source format's structure exactly.
//! - [`emit`] *synthesizes* a fresh document from the canonical model, enabling
//!   cross-format conversion (e.g. SPDX → CycloneDX).

pub mod emit;
mod enricher;
mod merger;
mod pruner;

pub use emit::{
    EmitError, EmitTarget, FidelityReport, emit, emit_cyclonedx, emit_spdx, preserve_source_json,
};
pub use enricher::enrich_sbom_json;
pub use merger::{DeduplicationStrategy, MergeConfig, MergeError, merge_sbom_json};
pub use pruner::{TailorConfig, tailor_sbom_json};

use serde_json::Value;

/// Extension trait for convenient JSON field access.
pub(crate) trait ValueExt {
    /// Get a string field or return `""` if missing/not a string.
    fn str_field(&self, key: &str) -> &str;
}

impl ValueExt for Value {
    fn str_field(&self, key: &str) -> &str {
        self.get(key).and_then(Value::as_str).unwrap_or("")
    }
}