polywrap_core 0.1.11

Core types of Polywrap client
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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

use crate::{error::Error, package::WrapPackage, wrapper::Wrapper};
use std::{collections::HashMap, sync::Arc, vec};

use crate::uri::Uri;

/// Struct that defines a URI, a package or a wrap
#[derive(Clone, Debug)]
pub enum UriPackageOrWrapper {
    Uri(Uri),
    Wrapper(Uri, Arc<dyn Wrapper>),
    Package(Uri, Arc<dyn WrapPackage>),
}

impl UriPackageOrWrapper {
    pub fn uri(&self) -> Uri {
        match self {
            UriPackageOrWrapper::Uri(uri) => uri.clone(),
            UriPackageOrWrapper::Wrapper(uri, _) => uri.clone(),
            UriPackageOrWrapper::Package(uri, _) => uri.clone(),
        }
    }
}

/// A single step in the URI resolution process
#[derive(Clone)]
pub struct UriResolutionStep {
    pub source_uri: Uri,
    pub result: Result<UriPackageOrWrapper, Error>,
    pub description: Option<String>,
    pub sub_history: Option<Vec<UriResolutionStep>>,
}

/// A URI resolution context, containing the full URI resolution history
#[derive(Default, Clone)]
pub struct UriResolutionContext {
    resolving_uri_map: HashMap<String, bool>,
    resolution_path: Vec<String>,
    history: Vec<UriResolutionStep>,
}

impl UriResolutionContext {
    pub fn new() -> Self {
        UriResolutionContext::default()
    }

    pub fn resolution_path(&mut self, resolution_path: Vec<String>) -> &Self {
        self.resolution_path = resolution_path;
        self
    }

    pub fn history(&mut self, history: Vec<UriResolutionStep>) -> &Self {
        self.history = history;
        self
    }

    pub fn resolving_uri_map(&mut self, resolving_uri_map: HashMap<String, bool>) -> &Self {
        self.resolving_uri_map = resolving_uri_map;
        self
    }

    pub fn is_resolving(&self, uri: &Uri) -> bool {
        self.resolving_uri_map.contains_key(&uri.to_string())
    }

    pub fn start_resolving(&mut self, uri: &Uri) {
        self.resolving_uri_map.insert(uri.to_string(), true);
        self.resolution_path.push(uri.to_string());
    }

    pub fn stop_resolving(&mut self, uri: &Uri) {
        self.resolving_uri_map.remove(&uri.to_string());
    }

    pub fn track_step(&mut self, step: UriResolutionStep) {
        self.history.push(step);
    }

    pub fn get_history(&self) -> &Vec<UriResolutionStep> {
        &self.history
    }

    pub fn get_resolution_path(&self) -> Vec<Uri> {
        self.resolution_path
            .iter()
            .map(|uri| uri.to_owned().parse().unwrap())
            .collect()
    }

    pub fn create_sub_history_context(&self) -> UriResolutionContext {
        UriResolutionContext {
            resolving_uri_map: self.resolving_uri_map.clone(),
            resolution_path: self.resolution_path.clone(),
            history: vec![],
        }
    }

    pub fn create_sub_context(&self) -> UriResolutionContext {
        UriResolutionContext {
            resolving_uri_map: self.resolving_uri_map.clone(),
            resolution_path: vec![],
            history: vec![],
        }
    }
}