Function lift_ref

atomic-canonical/src/lift.rs:287–309

Lift a `:::ref{to= edge=}` leaf into a typed reference edge. Both `to` and `edge` are required (a ref with no target or no edge type is a lift error), and `edge` must be a known *ref* edge: a dependency edge (`depends`/ `blockedBy`) or a remediation edge (`remediates`). Edges like `verifiedBy`/`about` are rejected even though they are valid edges elsewhere.

(d: &Directive)

/// `blockedBy`) or a remediation edge (`remediates`). Edges like
/// `verifiedBy`/`about` are rejected even though they are valid edges elsewhere.
fn lift_ref(d: &Directive) -> Result<Ref> {
    let to = d
        .attr("to")
        .ok_or_else(|| CanonicalError::Lift("':::ref' is missing required 'to'".into()))?
        .to_string();
    let edge = d
        .attr("edge")
        .ok_or_else(|| CanonicalError::Lift("':::ref' is missing required 'edge'".into()))?
        .to_string();
    if !vocab::is_known_ref_edge(&edge) {
        return Err(CanonicalError::Lift(format!(
            "':::ref' edge '{edge}' is not a valid ref edge (dependency {:?} or remediation {:?})",
            vocab::DEPENDENCY_EDGES,
            vocab::REMEDIATION_EDGES
        )));
    }
    Ok(Ref {
        type_: d.id.as_ref().map(|_| NodeType::Ref.as_str().to_string()),
        id: d.id.as_ref().map(|id| as_urn("ref", id)),
        to,
        edge,
    })
}

/// Wrap a local id into `urn:atomic:<kind>:<local>` unless already a urn.
fn as_urn(kind: &str, local: &str) -> String {