Crate sophia_iri

This crate provides functions for validating IRIs and IRI references, as well as for resolving IRI references agains a given base IRI.

It is developed as a part of Sophia, an RDF and Linked Data toolkit in Rust, but can be used independantly.

Feature gates

• test_data exposes the test module, which contains arrays of good and bad IRIs, useful for testing purposes, possibly in other crates.

• examples exposes the [wrap_macro_examples] module, whose role is to exemplify the effect of the wrap macro.

Modules

resolve

Implementation of IRI resolution as per [RFC 3987].

Macros

wrap

This macro is used to create a read-only wrapper around a type T, usually for the purpose of guaranteeing that the wrapped value verifies some condition. This macro takes care of defining all the usual traits for the wrapper type.

Structs

InvalidIri

This error is raised when trying to parse an invalid IRI.

Iri

See Iri::new.

IriRef

See IriRef::new.

Traits

AsIri

Automatic trait for IsIri, providing cheap conversion to Iri.

AsIriRef

Automatic trait for IsIriRef, providing cheap conversion to IriRef.

IsIri

Marker trait guaranteeing that the underlying str is a valid IRI-reference (i.e. absolute, with an optional fragment identifier)

IsIriRef

Marker trait guaranteeing that the underlying str is a valid IRI (i.e. absolute or relative, with an optional fragment identifier)

Functions

is_absolute_iri_ref

Check whether txt is an absolute IRI reference.

is_relative_iri_ref

Check whether txt is a relative IRI reference.

is_valid_iri_ref

Check whether txt is a valid (absolute or relative) IRI reference.

is_valid_suffixed_iri_ref

Check whether ns and suffix concatenate into a valid (absolute or relative) IRI reference.

Type Aliases

Result

Type alias for Result with default error TermError.