compose-lens 0.1.16

Loss-aware parsing, processing, validation, and rendering of Compose projects
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

//! Source-aware raw service `extends` directive.

use crate::source::SourceSpan;

use super::{FieldReference, Located};

/// An authored service `extends` directive without referenced-service resolution.
#[derive(Debug, Clone, PartialEq, Eq)]
#[non_exhaustive]
pub enum Extends {
    /// A short raw service reference.
    Short(Located<String>),
    /// A long reference mapping.
    Long(ExtendsReference),
}

/// A long service `extends` reference mapping.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct ExtendsReference {
    span: SourceSpan,
    service: Option<Located<String>>,
    file: Option<Located<String>>,
    extension_fields: Vec<FieldReference>,
    unknown_fields: Vec<FieldReference>,
}

impl ExtendsReference {
    pub(crate) const fn new(span: SourceSpan) -> Self {
        Self {
            span,
            service: None,
            file: None,
            extension_fields: Vec::new(),
            unknown_fields: Vec::new(),
        }
    }

    pub(crate) fn set_service(&mut self, value: Located<String>) {
        self.service = Some(value);
    }

    pub(crate) fn set_file(&mut self, value: Located<String>) {
        self.file = Some(value);
    }

    pub(crate) fn push_extension(&mut self, field: FieldReference) {
        self.extension_fields.push(field);
    }

    pub(crate) fn push_unknown(&mut self, field: FieldReference) {
        self.unknown_fields.push(field);
    }

    /// Returns the complete authored long-form mapping span.
    #[must_use]
    pub const fn span(&self) -> SourceSpan {
        self.span
    }

    /// Returns the raw referenced service without resolution.
    #[must_use]
    pub const fn service(&self) -> Option<&Located<String>> {
        self.service.as_ref()
    }

    /// Returns the raw referenced file without path access.
    #[must_use]
    pub const fn file(&self) -> Option<&Located<String>> {
        self.file.as_ref()
    }

    /// Returns retained `x-*` members.
    #[must_use]
    pub fn extension_fields(&self) -> &[FieldReference] {
        &self.extension_fields
    }

    /// Returns retained unknown or malformed members.
    #[must_use]
    pub fn unknown_fields(&self) -> &[FieldReference] {
        &self.unknown_fields
    }
}