#http #parser

rhymuweb

Common types for the Hypertext Transfer Protocol (HTTP)

4 stable releases

1.2.1 Mar 29, 2021
1.2.0 Jan 16, 2021
1.1.0 Dec 22, 2020
1.0.0 Nov 10, 2020

#380 in Parser implementations

MIT license

120KB
2.5K SLoC

Http (rhymuweb)

This is a library which implements common types for the RFC 7230, "Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing".

Crates.io Documentation

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

The purpose of this library is to provide Request and Response types which can be used parse and generate Hypertext Transfer Protocol (HTTP) requests and responses.

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 on the C++11 compiler, the C++ standard library, and non-standard dependencies listed below. 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)
  • MessageHeaders - a library which can parse and generate e-mail or web message headers
  • StringExtensions - a library containing C++ string-oriented libraries, many of which ought to be in the standard library, but aren't.
  • SystemAbstractions - a cross-platform adapter library for system services whose APIs vary from one operating system to another
  • Timekeeping - a library of classes and interfaces dealing with tracking time and scheduling work
  • Uri - a library that can parse and generate Uniform Resource Identifiers (URIs)
  • zlib - Foundational compression library

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

Dependencies

~4.5MB
~150K SLoC

1b`