rhymuri

Crates.iorhymuri
lib.rsrhymuri
version1.3.1
sourcesrc
created_at2020-10-15 07:10:28.49931
updated_at2021-03-29 18:22:25.023693
descriptionImplementation of IETF RFC 3986, Uniform Resource Identifier (URI)
homepage
repositoryhttps://github.com/rhymu8354/Uri.git
max_upload_size
id299913
size121,845
Richard Walters (rhymu8354)

documentation

README

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.

Commit count: 159

cargo fmt