An open API service indexing awesome lists of open source software.

https://github.com/andrefs/lax-oxiri

Lax development version of oxigraph/oxiri
https://github.com/andrefs/lax-oxiri

Last synced: 10 months ago
JSON representation

Lax development version of oxigraph/oxiri

Awesome Lists containing this project

README

          

OxIRI
=====

[![actions status](https://github.com/oxigraph/oxiri/workflows/build/badge.svg)](https://github.com/oxigraph/oxiri/actions)
[![Latest Version](https://img.shields.io/crates/v/oxiri.svg)](https://crates.io/crates/oxiri)
[![Released API docs](https://docs.rs/oxiri/badge.svg)](https://docs.rs/oxiri)

OxIRI is a simple and fast implementation of IRIs based on [RFC 3987](https://www.ietf.org/rfc/rfc3987.html).

It allows zero stack allocation IRI validation and resolution.

Example:
```rust
use oxiri::Iri;

// Parse and validate base IRI
let base_iri = Iri::parse("http://foo.com/bar/baz").unwrap();

// Validate and resolve relative IRI
let iri = base_iri.resolve("bat#foo").unwrap();
assert_eq!("http://foo.com/bar/bat#foo", iri.as_str());

// Extract IRI components
assert_eq!(iri.scheme(), "http");
assert_eq!(iri.authority(), Some("foo.com"));
assert_eq!(iri.path(), "/bar/bat");
assert_eq!(iri.query(), None);
assert_eq!(iri.fragment(), Some("foo"));
```

If [`serde`](https://serde.rs/) is available, `Iri` and `IriRef` implement the `Serialize` and `Deserialize` traits and encode the IRI as a string.

## License

This project is licensed under either of

* Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or
``)
* MIT license ([LICENSE-MIT](LICENSE-MIT) or
``)

at your option.

### Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in OxIRI by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.