8 stable releases

1.3.1 Mar 29, 2021
1.3.0 Jan 16, 2021
1.2.0 Dec 22, 2020
1.1.1 Nov 10, 2020
1.1.0 Oct 28, 2020

#1548 in Parser implementations


Used in rhymuweb

Custom license

120KB
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

~2MB
~49K SLoC