Crate sophia_iri 

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

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

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.

• uri exposes similar traits and types for dealing with URIs (RFC 3986), which are basically the subset of IRIs using only ASCII characters.

Modules

relativize

Implement relativization of an IRI against a base IRI.

resolve

Implementation of IRI resolution as per [RFC 3987].

test

Test module for sophia_iri.

uri

Traits and types to handle URIs (RFC 3986).

wrap_macro_examples

This module provides examples of what the wrap macro generates.

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.

Statics

IRELATIVE_REF_REGEX_SRC

Match a relative IRI reference.

IRI_REGEX_SRC

Match an absolute IRI reference.

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 InvalidIri.