#uri #parser

rhymuri

Implementation of IETF RFC 3986, Uniform Resource Identifier (URI)

3 stable releases

1.0.2 Oct 16, 2020
1.0.1 Oct 15, 2020

#214 in Parser implementations

Custom license

115KB
2.5K SLoC

Uri (rhymuri)

This is a library which implements IETF RFC 3986, "Uniform Resource Identifier (URI): Generic Syntax".

Crates.io Documentation

More information about the Rust implementation of this library can be found in the crate documentation.

A URI is a compact sequence of characters that identifies an abstract or physical resource. One common form of URI is the Uniform Resource Locator (URL), used to reference web resources:

http://www.example.com/foo?bar#baz

Another kind of URI is the path reference:

/usr/bin/zip

The purpose of this library is to provide a Uri type to represent a URI, with functions to parse URIs from their string representations, as well as assemble URIs from their various components.

This is a multi-language library containing independent implementations for the following programming languages:

  • C++
  • Rust

Building the C++ Implementation

A portable library is built which depends only on the C++11 compiler and standard library, so it should be supported on almost any platform. The following are recommended toolchains for popular platforms.

  • Windows -- Visual Studio (Microsoft Visual C++)
  • Linux -- clang or gcc
  • MacOS -- Xcode (clang)

This library is not intended to stand alone. It is intended to be included in a larger solution which uses CMake to generate the build system and build applications which will link with the library.

There are two distinct steps in the build process:

  1. Generation of the build system, using CMake
  2. Compiling, linking, etc., using CMake-compatible toolchain

Prerequisites

  • CMake version 3.8 or newer
  • C++11 toolchain compatible with CMake for your development platform (e.g. Visual Studio on Windows)

Build system generation

Generate the build system using CMake from the solution root. For example:

mkdir build
cd build
cmake -G "Visual Studio 15 2017" -A "x64" ..

Compiling, linking, et cetera

Either use CMake or your toolchain's IDE to build. For CMake:

cd build
cmake --build . --config Release

License

Licensed under the MIT license.

Dependencies

~0.5–0.9MB
~21K SLoC