rudof_lib 0.3.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

use crate::{Result, Rudof, api::query::QueryOperations, formats::ResultQueryFormat};
use std::io;

/// Builder for `serialize_query_results` operation.
///
/// Provides a fluent interface for configuring and executing query results
/// serialization operations with optional parameters.
pub struct SerializeQueryResultsBuilder<'a, W: io::Write> {
    rudof: &'a Rudof,
    writer: &'a mut W,
    result_query_format: Option<&'a ResultQueryFormat>,
}

impl<'a, W: io::Write> SerializeQueryResultsBuilder<'a, W> {
    /// Creates a new builder instance.
    ///
    /// This is called internally by `Rudof::serialize_query_results()` and should not
    /// be constructed directly.
    pub(crate) fn new(rudof: &'a Rudof, writer: &'a mut W) -> Self {
        Self {
            rudof,
            writer,
            result_query_format: None,
        }
    }

    /// Sets the output format for query results.
    ///
    /// # Arguments
    ///
    /// * `result_query_format` - The format to use when serializing the results
    pub fn with_result_query_format(mut self, result_query_format: &'a ResultQueryFormat) -> Self {
        self.result_query_format = Some(result_query_format);
        self
    }

    /// Executes the query results serialization operation with the configured parameters.
    ///
    /// # Errors
    ///
    /// Returns an error if no query results are available or serialization fails.
    pub fn execute(self) -> Result<()> {
        <Rudof as QueryOperations>::serialize_query_results(self.rudof, self.result_query_format, self.writer)
    }
}