@ -1,8 +1,7 @@
use crate ::blank_node ::BlankNode ;
use crate ::cast_error ::TripleConstructionError ;
use crate ::literal ::Literal ;
use crate ::named_node ::NamedNode ;
use crate ::{ BlankNodeRef , LiteralRef , NamedNodeRef , TryFromTermError } ;
use crate ::{ BlankNodeRef , LiteralRef , NamedNodeRef } ;
use std ::fmt ;
/// The owned union of [IRIs](https://www.w3.org/TR/rdf11-concepts/#dfn-iri) and [blank nodes](https://www.w3.org/TR/rdf11-concepts/#dfn-blank-node).
@ -224,24 +223,6 @@ impl From<BlankNodeRef<'_>> for Subject {
}
}
impl TryFrom < Term > for Subject {
type Error = TryFromTermError ;
#[ inline ]
fn try_from ( term : Term ) -> Result < Self , Self ::Error > {
match term {
Term ::NamedNode ( node ) = > Ok ( Subject ::NamedNode ( node ) ) ,
Term ::BlankNode ( node ) = > Ok ( Subject ::BlankNode ( node ) ) ,
#[ cfg(feature = " rdf-star " ) ]
Term ::Triple ( triple ) = > Ok ( Subject ::Triple ( triple ) ) ,
Term ::Literal ( _ ) = > Err ( TryFromTermError {
term ,
target : "Subject" ,
} ) ,
}
}
}
#[ cfg(feature = " rdf-star " ) ]
impl From < Triple > for Subject {
#[ inline ]
@ -553,6 +534,72 @@ impl From<SubjectRef<'_>> for Term {
}
}
impl TryFrom < Term > for NamedNode {
type Error = TryFromTermError ;
#[ inline ]
fn try_from ( term : Term ) -> Result < Self , Self ::Error > {
if let Term ::NamedNode ( node ) = term {
Ok ( node )
} else {
Err ( TryFromTermError {
term ,
target : "NamedNode" ,
} )
}
}
}
impl TryFrom < Term > for BlankNode {
type Error = TryFromTermError ;
#[ inline ]
fn try_from ( term : Term ) -> Result < Self , Self ::Error > {
if let Term ::BlankNode ( node ) = term {
Ok ( node )
} else {
Err ( TryFromTermError {
term ,
target : "BlankNode" ,
} )
}
}
}
impl TryFrom < Term > for Literal {
type Error = TryFromTermError ;
#[ inline ]
fn try_from ( term : Term ) -> Result < Self , Self ::Error > {
if let Term ::Literal ( node ) = term {
Ok ( node )
} else {
Err ( TryFromTermError {
term ,
target : "Literal" ,
} )
}
}
}
impl TryFrom < Term > for Subject {
type Error = TryFromTermError ;
#[ inline ]
fn try_from ( term : Term ) -> Result < Self , Self ::Error > {
match term {
Term ::NamedNode ( term ) = > Ok ( Self ::NamedNode ( term ) ) ,
Term ::BlankNode ( term ) = > Ok ( Self ::BlankNode ( term ) ) ,
#[ cfg(feature = " rdf-star " ) ]
Term ::Triple ( term ) = > Ok ( Self ::Triple ( term ) ) ,
Term ::Literal ( _ ) = > Err ( TryFromTermError {
term ,
target : "Subject" ,
} ) ,
}
}
}
/// A borrowed RDF [term](https://www.w3.org/TR/rdf11-concepts/#dfn-rdf-term)
/// It is the union of [IRIs](https://www.w3.org/TR/rdf11-concepts/#dfn-iri), [blank nodes](https://www.w3.org/TR/rdf11-concepts/#dfn-blank-node), [literals](https://www.w3.org/TR/rdf11-concepts/#dfn-literal) and [triples](https://www.w3.org/TR/rdf11-concepts/#dfn-rdf-triple) (if the `rdf-star` feature is enabled).
#[ derive(Eq, PartialEq, Debug, Clone, Copy, Hash) ]
@ -757,28 +804,20 @@ impl Triple {
}
}
/// Builds an RDF [triple](https://www.w3.org/TR/rdf11-concepts/#dfn-rdf-triple).
/// Builds an RDF [triple](https://www.w3.org/TR/rdf11-concepts/#dfn-rdf-triple) from [`Term`]s.
///
/// Returns a [`TryFromTermError`] error if the generated triple would be ill-formed.
#[ inline ]
pub fn new_from_terms (
pub fn from_terms (
subject : impl Into < Term > ,
predicate : impl Into < Term > ,
object : impl Into < Term > ,
) -> Result < Self , TripleConstructionError > {
let subject : Result < Subject , TryFromTermError > = subject . into ( ) . try_into ( ) ;
let predicate : Result < NamedNode , TryFromTermError > = predicate . into ( ) . try_into ( ) ;
if let ( Ok ( subject ) , Ok ( predicate ) ) = ( subject . clone ( ) , predicate . clone ( ) ) {
Ok ( Self {
subject ,
predicate ,
object : object . into ( ) ,
} )
} else {
Err ( TripleConstructionError {
subject ,
predicate ,
object : object . into ( ) ,
} )
}
) -> Result < Self , TryFromTermError > {
Ok ( Self {
subject : subject . into ( ) . try_into ( ) ? ,
predicate : predicate . into ( ) . try_into ( ) ? ,
object : object . into ( ) ,
} )
}
/// Encodes that this triple is in an [RDF dataset](https://www.w3.org/TR/rdf11-concepts/#dfn-rdf-dataset).
@ -809,23 +848,6 @@ impl fmt::Display for Triple {
}
}
#[ cfg(feature = " rdf-star " ) ]
impl TryFrom < Term > for Box < Triple > {
type Error = TryFromTermError ;
#[ inline ]
fn try_from ( term : Term ) -> Result < Self , Self ::Error > {
if let Term ::Triple ( node ) = term {
Ok ( node )
} else {
Err ( TryFromTermError {
term ,
target : "Box<Triple>" ,
} )
}
}
}
/// A borrowed [RDF triple](https://www.w3.org/TR/rdf11-concepts/#dfn-rdf-triple).
///
/// The default string formatter is returning an N-Triples, Turtle, and SPARQL compatible representation:
@ -1285,7 +1307,22 @@ impl<'a> From<QuadRef<'a>> for Quad {
}
}
#[ cfg(feature = " rdf-star " ) ]
/// An error return by some [`TryFrom<Term>`](TryFrom) implementations.
#[ derive(Debug, Clone, thiserror::Error) ]
#[ error( " {term} can not be converted to a {target} " ) ]
pub struct TryFromTermError {
pub ( crate ) term : Term ,
pub ( crate ) target : & ' static str ,
}
impl TryFromTermError {
/// The term that can't be converted
#[ inline ]
pub fn into_term ( self ) -> Term {
self . term
}
}
#[ cfg(test) ]
mod tests {
#![ allow(clippy::panic_in_result_fn) ]
@ -1293,228 +1330,39 @@ mod tests {
use super ::* ;
#[ test ]
fn casting_triple ( ) {
let triple = Triple {
subject : NamedNode ::new ( "http://example.org/s" ) . unwrap ( ) . into ( ) ,
predicate : NamedNode ::new ( "http://example.org/p" ) . unwrap ( ) ,
object : NamedNode ::new ( "http://example.org/o" ) . unwrap ( ) . into ( ) ,
} ;
let triple_box = Box ::new ( triple ) ;
let t : Result < Box < Triple > , TryFromTermError > = Term ::Triple ( triple_box . clone ( ) ) . try_into ( ) ;
assert_eq! ( t . unwrap ( ) , triple_box . clone ( ) ) ;
let literal : Result < Box < Triple > , TryFromTermError > =
Term ::Literal ( Literal ::new_simple_literal ( "Hello World!" ) ) . try_into ( ) ;
let literal_err = literal . unwrap_err ( ) ;
assert_eq! (
literal_err . term ,
Term ::Literal ( Literal ::new_simple_literal ( "Hello World!" ) )
) ;
assert_eq! ( literal_err . target , "Box<Triple>" ) ;
assert_eq! (
literal_err . to_string ( ) ,
"\"Hello World!\" can not be converted to a Box<Triple>"
) ;
assert_eq! (
Term ::from ( literal_err ) ,
Term ::Literal ( Literal ::new_simple_literal ( "Hello World!" ) )
) ;
let bnode : Result < Box < Triple > , TryFromTermError > =
Term ::BlankNode ( BlankNode ::new_from_unique_id ( 0x42 ) ) . try_into ( ) ;
let bnode_err = bnode . unwrap_err ( ) ;
assert_eq! (
bnode_err . term ,
Term ::BlankNode ( BlankNode ::new_from_unique_id ( 0x42 ) )
) ;
assert_eq! ( bnode_err . target , "Box<Triple>" ) ;
assert_eq! (
bnode_err . to_string ( ) ,
"_:42 can not be converted to a Box<Triple>"
) ;
assert_eq! (
Term ::from ( bnode_err ) ,
Term ::BlankNode ( BlankNode ::new_from_unique_id ( 0x42 ) )
) ;
let named_node : Result < Box < Triple > , TryFromTermError > =
Term ::NamedNode ( NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) ) . try_into ( ) ;
let named_node_err = named_node . unwrap_err ( ) ;
assert_eq! (
named_node_err . term ,
Term ::NamedNode ( NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) )
) ;
assert_eq! ( named_node_err . target , "Box<Triple>" ) ;
fn triple_from_terms ( ) -> Result < ( ) , TryFromTermError > {
assert_eq! (
named_node_err . to_string ( ) ,
"<http://example.org/test> can not be converted to a Box<Triple>"
) ;
assert_eq! (
Term ::from ( named_node_err ) ,
Term ::NamedNode ( NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) )
) ;
}
#[ test ]
fn constructing_triple ( ) {
use super ::* ;
let optional_triple = Triple ::new_from_terms (
Term ::NamedNode ( NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) ) ,
Term ::NamedNode ( NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) ) ,
Term ::NamedNode ( NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) ) ,
) ;
let optional_triple_2 = Triple ::new_from_terms (
NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) ,
NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) ,
NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) ,
) ;
let bad_triple : Result < Triple , TripleConstructionError > = Triple ::new_from_terms (
Term ::Literal ( Literal ::new_simple_literal ( "abc123" ) ) ,
Term ::NamedNode ( NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) ) ,
Term ::NamedNode ( NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) ) ,
) ;
let bad_triple_2 = Triple ::new_from_terms (
Term ::Literal ( Literal ::new_simple_literal ( "abc123" ) ) ,
NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) ,
NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) ,
) ;
let bad_triple_3 = Triple ::new_from_terms (
Term ::Literal ( Literal ::new_simple_literal ( "abc123" ) ) ,
BlankNode ::new_from_unique_id ( 0x42 ) ,
NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) ,
) ;
let triple : Triple = Triple ::new (
Subject ::NamedNode ( NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) ) ,
NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) ,
Term ::NamedNode ( NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) ) ,
) ;
let triple_2 : Triple = Triple ::new (
NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) ,
NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) ,
NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) ,
) ;
let unwrapped = optional_triple . unwrap ( ) ;
assert_eq! ( unwrapped , triple ) ;
assert_eq! ( unwrapped , triple_2 . clone ( ) ) ;
assert_eq! ( optional_triple_2 . unwrap ( ) , triple_2 ) ;
let bad_triple_err = bad_triple . unwrap_err ( ) ;
assert_eq! (
bad_triple_err . to_string ( ) ,
"subject: [\"abc123\" can not be converted to a Subject]"
) ;
assert_eq! (
bad_triple_err . subject . clone ( ) . unwrap_err ( ) . clone ( ) . term ,
Term ::Literal ( Literal ::new_simple_literal ( "abc123" ) )
) ;
assert_eq! (
bad_triple_err . subject . clone ( ) . unwrap_err ( ) . clone ( ) . target ,
"Subject"
) ;
assert_eq! (
bad_triple_err . subject . unwrap_err ( ) . clone ( ) . to_string ( ) ,
"\"abc123\" can not be converted to a Subject"
) ;
assert_eq! ( bad_triple_2 . is_err ( ) , true ) ;
let bad_triple_2_err = bad_triple_2 . unwrap_err ( ) ;
assert_eq! (
bad_triple_2_err . to_string ( ) ,
"subject: [\"abc123\" can not be converted to a Subject]"
) ;
assert_eq! (
bad_triple_2_err . subject . clone ( ) . unwrap_err ( ) . clone ( ) . term ,
Term ::Literal ( Literal ::new_simple_literal ( "abc123" ) )
) ;
assert_eq! (
bad_triple_2_err . subject . clone ( ) . unwrap_err ( ) . clone ( ) . target ,
"Subject"
) ;
assert_eq! (
bad_triple_2_err . subject . unwrap_err ( ) . clone ( ) . to_string ( ) ,
"\"abc123\" can not be converted to a Subject"
) ;
assert_eq! (
bad_triple_2_err . predicate . unwrap ( ) ,
NamedNode ::new ( "http://example.org/test" ) . unwrap ( )
) ;
assert_eq! (
bad_triple_2_err . object ,
Term ::NamedNode ( NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) )
) ;
assert_eq! ( bad_triple_3 . is_err ( ) , true ) ;
let bad_triple_3_err = bad_triple_3 . unwrap_err ( ) ;
assert_eq! ( bad_triple_3_err . to_string ( ) , "subject: [\"abc123\" can not be converted to a Subject], predicate: [_:42 can not be converted to a NamedNode]" ) ;
assert_eq! (
bad_triple_3_err . subject . clone ( ) . unwrap_err ( ) . clone ( ) . term ,
Term ::Literal ( Literal ::new_simple_literal ( "abc123" ) )
) ;
assert_eq! (
bad_triple_3_err . subject . clone ( ) . unwrap_err ( ) . clone ( ) . target ,
"Subject"
) ;
assert_eq! (
bad_triple_3_err . subject . unwrap_err ( ) . clone ( ) . to_string ( ) ,
"\"abc123\" can not be converted to a Subject"
) ;
assert_eq! (
bad_triple_3_err . predicate . clone ( ) . unwrap_err ( ) . clone ( ) . term ,
Term ::BlankNode ( BlankNode ::new_from_unique_id ( 0x42 ) )
) ;
assert_eq! (
bad_triple_3_err
. predicate
. clone ( )
. unwrap_err ( )
. clone ( )
. target ,
"NamedNode"
) ;
assert_eq! (
bad_triple_3_err . predicate . unwrap_err ( ) . clone ( ) . to_string ( ) ,
"_:42 can not be converted to a NamedNode"
Triple ::from_terms (
NamedNode ::new_unchecked ( "http://example.com/s" ) ,
NamedNode ::new_unchecked ( "http://example.com/p" ) ,
NamedNode ::new_unchecked ( "http://example.com/o" ) ,
) ? ,
Triple ::new (
NamedNode ::new_unchecked ( "http://example.com/s" ) ,
NamedNode ::new_unchecked ( "http://example.com/p" ) ,
NamedNode ::new_unchecked ( "http://example.com/o" ) ,
)
) ;
}
#[ test ]
fn casting_subject ( ) {
let triple = Triple {
subject : NamedNode ::new ( "http://example.org/s" ) . unwrap ( ) . into ( ) ,
predicate : NamedNode ::new ( "http://example.org/p" ) . unwrap ( ) ,
object : NamedNode ::new ( "http://example.org/o" ) . unwrap ( ) . into ( ) ,
} ;
let triple_box = Box ::new ( triple ) ;
let t : Result < Subject , TryFromTermError > = Term ::Triple ( triple_box . clone ( ) ) . try_into ( ) ;
assert_eq! ( t . unwrap ( ) , Subject ::Triple ( triple_box . clone ( ) ) ) ;
let literal : Result < Subject , TryFromTermError > =
Term ::Literal ( Literal ::new_simple_literal ( "Hello World!" ) ) . try_into ( ) ;
assert_eq! ( literal . is_err ( ) , true ) ;
assert_eq! ( literal . is_err ( ) , true ) ;
let bnode : Result < Subject , TryFromTermError > =
Term ::BlankNode ( BlankNode ::new_from_unique_id ( 0x42 ) ) . try_into ( ) ;
assert_eq! (
bnode . unwrap ( ) ,
Subject ::BlankNode ( BlankNode ::new_from_unique_id ( 0x42 ) )
Triple ::from_terms (
Literal ::new_simple_literal ( "foo" ) ,
NamedNode ::new_unchecked ( "http://example.com/p" ) ,
NamedNode ::new_unchecked ( "http://example.com/o" ) ,
)
. unwrap_err ( )
. into_term ( ) ,
Term ::from ( Literal ::new_simple_literal ( "foo" ) )
) ;
let named_node : Result < Subject , TryFromTermError > =
Term ::NamedNode ( NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) ) . try_into ( ) ;
assert_eq! (
named_node . unwrap ( ) ,
Subject ::NamedNode ( NamedNode ::new ( "http://example.org/test" ) . unwrap ( ) )
Triple ::from_terms (
NamedNode ::new_unchecked ( "http://example.com/s" ) ,
Literal ::new_simple_literal ( "foo" ) ,
NamedNode ::new_unchecked ( "http://example.com/o" ) ,
)
. unwrap_err ( )
. into_term ( ) ,
Term ::from ( Literal ::new_simple_literal ( "foo" ) )
) ;
Ok ( ( ) )
}
}