SiddiqSoft.SplitUri 1.3.0

SplitUri : Parse Uri Utility

Objective

Parse the Uri for HTTP resources with support for format and nlohmann.json.

While there are many, many libraries available, the goal of this implementation is to make usage easy along with a modern design.

Requirements

• C++20 compliant toolchain: We use <concepts>, <format>.
• The nlohmann.json library.
• The build and tests are for Visual Studio 2019 under x64.

Usage

• Use the nuget SiddiqSoft.SplitUri
• Copy paste..whatever works.

<hr/>

From Wikipedia we have the following structure of Uri.

		  userinfo       host      port
		  ┌──┴───┐ ┌──────┴──────┐ ┌┴┐
  https://john.doe@www.example.com:123/forum/questions/?tag=networking&order=newest#top
  └─┬─┘   └───────────┬──────────────┘└───────┬───────┘ └───────────┬─────────────┘ └┬┘
  scheme          authority                  path                 query           fragment

API

Current implementation only supports the http and https scheme.

template <class T = std::string, class Auth = AuthorityHttp<T>>
requires (std::same_as<std::string, T> || std::same_as<std::wstring, T>) && std::same_as<AuthorityHttp<T>, Auth>
struct Uri
{
    UriScheme  scheme;
    Auth       authority;
    vector<T>  path {};
    map<T, T>  query {};
    T          url {}; // contains the "balance" post Authority section

    operator T();

    NLOHMANN_DEFINE_TYPE_INTRUSIVE(Uri<T>, scheme, authority, url, path, query, fragment);
};

SplitUri()

template <class T = std::string, class Auth = AuthorityHttp<T>>
requires std::same_as<std::string, T> || std::same_as<std::wstring, T>
Uri<T, Auth> static SplitUri(const T& aEndpoint);

<hr/>

Roadmap

• Update to handle std::wstring.
• Support the other URI schemes.

<p align="right"> © 2021 Siddiq Software LLC. All rights reserved. </p>