drift 0.1.3

Library for comparing the compatibility of OpenAPI documents
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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

// Copyright 2025 Oxide Computer Company

use std::borrow::Cow;

use anyhow::anyhow;
use openapiv3::ReferenceOr;
use serde::{Deserialize, de::DeserializeOwned};

use crate::context::Context;

pub trait ReferenceOrResolver<'a, 'context, T>
where
    T: Clone,
{
    fn resolve(
        &'a self,
        context: &Context<'context>,
    ) -> anyhow::Result<(Cow<'a, T>, Context<'context>)>;
}

impl<'a, 'context, T> ReferenceOrResolver<'a, 'context, T> for ReferenceOr<T>
where
    T: DeserializeOwned + Clone,
{
    fn resolve(
        &'a self,
        context: &Context<'context>,
    ) -> anyhow::Result<(Cow<'a, T>, Context<'context>)> {
        let mut context = context.clone();
        let mut target = match self {
            ReferenceOr::Item(item) => return Ok((Cow::Borrowed(item), context)),
            ReferenceOr::Reference { reference } => Cow::Borrowed(reference),
        };

        loop {
            assert!(target.starts_with("#/"));
            context = context.push(target.as_ref());

            let subtree = context
                .raw_openapi
                .pointer(&target.as_str()[1..])
                .ok_or(anyhow!("invalid reference {target}"))?;

            let item_or_reference = ReferenceOr::<T>::deserialize(subtree)?;

            match item_or_reference {
                ReferenceOr::Item(item) => return Ok((Cow::Owned(item), context)),

                ReferenceOr::Reference { reference } => {
                    target = Cow::Owned(reference);
                }
            }
        }
    }
}