rudof_lib 0.3.29

RDF and Knowledge Graphs processing tool
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
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173

use thiserror::Error;

/// Errors that can occur during data handling operations in Rudof.
#[derive(Error, Debug)]
pub enum DataError {
    /// Error applying RDF data configuration.
    #[error("Error applying RDF data configuration: {error}")]
    RdfDataConfig { error: String },

    /// Attempted to use a non-RDF format in an RDF-only context.
    #[error("Non-RDF format: {format}")]
    NonRdfFormat { format: String },

    /// Attempted to use a non-image visualization format in an image-only context.
    #[error("Non-image visualization format: {format}")]
    NonImageVisualizationFormat { format: String },

    /// The data format specified is not supported by Rudof.
    #[error(
        "Unsupported data format: '{format}'. Valid formats are: 'turtle', 'ntriples', 'rdfxml', 'trig', 'n3', 'nquads', 'jsonld', 'pg'"
    )]
    UnsupportedDataFormat { format: String },

    /// The data reader mode specified is not supported by Rudof.
    #[error("Unsupported reader mode: '{mode}'. Valid modes are 'strict' or 'lax'")]
    UnsupportedReaderMode { mode: String },

    /// Errors related to specifying the data source (e.g. both or neither data and endpoint provided).
    #[error("Data source specification error: {message}")]
    DataSourceSpec { message: String },

    /// The result data format specified is not supported by Rudof.
    #[error(
        "Unsupported result data format: '{format}'. Valid formats are: 'turtle', 'ntriples', 'rdfxml', 'trig', 'n3', 'nquads', 'compact', 'json', 'plantuml', 'svg', 'png'"
    )]
    UnsupportedResultDataFormat { format: String },

    /// Failed to create a SPARQL endpoint from the given IRI.
    #[error("Invalid endpoint '{endpoint}': {error}")]
    InvalidEndpoint { endpoint: String, error: String },

    /// Failed to parse RDF data.
    #[error(
        "Failed to parse RDF data from '{source_name}' with format '{format}', base '{base}', reader mode '{reader_mode}': {error}"
    )]
    FailedParsingRdfData {
        source_name: String,
        format: String,
        base: String,
        reader_mode: String,
        error: String,
    },

    /// Failed to parse Property Graph data.
    #[error("Failed to parse PG data from '{source_name}': {error}")]
    FailedParsingPgData { source_name: String, error: String },

    /// Failed to parse Service Description data.
    #[error(
        "Failed to parse Service Description data from '{source_name}' with format '{format}', base '{base}', reader mode '{reader_mode}': {error}"
    )]
    FailedParsingServiceDescriptionData {
        source_name: String,
        format: String,
        base: String,
        reader_mode: String,
        error: String,
    },

    /// Failed to serialize Service Description.
    #[error("Failed to serialize Service Description with format '{result_service_format}': {error}")]
    FailedSerializingServiceDescription {
        result_service_format: String,
        error: String,
    },

    /// Failed to serialize Rdf Data.
    #[error("Failed to serialize Rdf Data with format '{result_data_format}': {error}")]
    FailedSerializingRdfData { result_data_format: String, error: String },

    /// Failed to serialize Property Graph Data.
    #[error("Failed to serialize Property Graph Data with format '{result_pg_format}': {error}")]
    FailedSerializingPgData { result_pg_format: String, error: String },

    /// No Service Description loaded.
    #[error("No Service Description loaded")]
    NoServiceDescription,

    /// No RDF data loaded.
    #[error("No RDF data loaded")]
    NoRdfDataLoaded,

    /// No Pg data loaded.
    #[error("No PG data loaded")]
    NoPgDataLoaded,

    /// No data loaded.
    #[error("No data loaded")]
    NoDataLoaded,

    /// Failed to serialize data to the specified format.
    #[error("Failed to serialize data to {format}: {error}")]
    FailedSerializingData { format: String, error: String },

    /// Failed to parse a node selector.
    #[error("Failed parsing node selector '{node}': {error}")]
    FailedNodeSelectorParse { node: String, error: String },

    /// Failed to parse an IRI reference.
    #[error("Failed parsing Iri ref '{iri}': {error}")]
    FailedIriRefParse { iri: String, error: String },

    /// Failed to resolve a prefix in a prefixed IRI reference.
    #[error("Failed resolving prefix '{prefix}': {error}")]
    FailedPrefixResolution { prefix: String, error: String },

    /// Failed to resolve the IRIs a term given as text contains: its own, its datatype,
    /// or those of a triple pattern, against the base IRI and the prefix map.
    #[error("Failed resolving the IRIs of '{term}': {error}")]
    FailedTermResolution { term: String, error: String },

    /// Failed to retrieve arcs for a node.
    #[error("Failed retrieving arcs for node: {error}")]
    FailedArcRetrieval { error: String },

    /// A term was expected, but the text denotes a set of nodes of the data.
    #[error(
        "'{term}' is not a term: a term is an IRI ('<http://example.org/alice>', 'ex:alice'), a blank node ('_:b1') or a literal ('\"Alice\"', '\"Alice\"@en', '23'), not a triple pattern or a SPARQL query"
    )]
    NotATerm { term: String },

    /// A literal was given where a subject is required.
    #[error("'{term}' cannot be the subject of a triple: a subject is an IRI or a blank node, not a literal")]
    NotASubject { term: String },

    /// The loaded RDF data cannot be modified.
    #[error("The loaded RDF data cannot be modified: {reason}")]
    ReadOnlyData { reason: String },

    /// Failed to add or remove a triple.
    #[error("Failed to {operation} the triple: {error}")]
    FailedTripleUpdate { operation: String, error: String },

    /// Failed to retrieve the triples matching a pattern.
    #[error("Failed retrieving triples: {error}")]
    FailedTripleRetrieval { error: String },

    /// Failed to qualify a node or term for display.
    #[error("Failed qualifying node or term: {error}")]
    FailedQualification { error: String },

    /// Failed to write node info to an output stream.
    #[error("Failed I/O operation while writing node info: {error}")]
    FailedIoOperation { error: String },

    /// Failed to dereference a URI over HTTP (network failure, TLS error, etc).
    #[error("Failed to dereference '{uri}': {error}")]
    DereferenceError { uri: String, error: String },

    /// Dereferencing a URI returned a non-success HTTP status.
    #[error("Dereferencing '{uri}' failed with HTTP status {status}")]
    DereferenceHttpStatus { uri: String, status: String },

    /// A staging frame was closed, or asked about, while none was open.
    #[error("No staging frame is open: {operation} needs a matching begin_staging")]
    NoStagingFrame { operation: String },

    /// A staging frame could not be rolled back, leaving the data part-way.
    #[error(
        "Failed to roll back a staging frame: {error}. The loaded data may be left inconsistent; reset_data and load it again"
    )]
    FailedStagingRollback { error: String },
}