rudof_lib 0.2.20-rc.1

RDF data shapes implementation in Rust
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

use crate::{
    Result, Rudof,
    api::data::DataOperations,
    formats::{DataFormat, DataReaderMode, InputSpec},
};

/// Builder for `load_service_description` operation.
///
/// Provides a fluent interface for configuring and executing service description
/// loading operations with optional parameters.
pub struct LoadServiceDescriptionBuilder<'a> {
    rudof: &'a mut Rudof,
    service: &'a InputSpec,
    data_format: Option<&'a DataFormat>,
    reader_mode: Option<&'a DataReaderMode>,
    base: Option<&'a str>,
}

impl<'a> LoadServiceDescriptionBuilder<'a> {
    /// Creates a new builder instance.
    ///
    /// This is called internally by `Rudof::load_service_description()` and should not
    /// be constructed directly.
    pub(crate) fn new(rudof: &'a mut Rudof, service: &'a InputSpec) -> Self {
        Self {
            rudof,
            service,
            data_format: None,
            reader_mode: None,
            base: None,
        }
    }

    /// Sets the service description format.
    ///
    /// # Arguments
    ///
    /// * `data_format` - The format to use when loading the service description
    pub fn with_data_format(mut self, data_format: &'a DataFormat) -> Self {
        self.data_format = Some(data_format);
        self
    }

    /// Sets the reader mode for service description loading.
    ///
    /// # Arguments
    ///
    /// * `reader_mode` - The reading mode to apply during service description loading
    pub fn with_reader_mode(mut self, reader_mode: &'a DataReaderMode) -> Self {
        self.reader_mode = Some(reader_mode);
        self
    }

    /// Sets the base URI for resolving relative IRIs in the service description.
    ///
    /// # Arguments
    ///
    /// * `base` - The base URI to use for resolving relative IRIs in the service description
    pub fn with_base(mut self, base: &'a str) -> Self {
        self.base = Some(base);
        self
    }

    /// Executes the service description loading operation with the configured parameters.
    pub fn execute(self) -> Result<()> {
        <Rudof as DataOperations>::load_service_description(
            self.rudof,
            self.service,
            self.data_format,
            self.reader_mode,
            self.base,
        )
    }
}