7 stable releases

1.3.1 Nov 10, 2020
1.3.0 Oct 28, 2020
1.2.0 Oct 21, 2020
1.1.0 Oct 20, 2020
1.0.2 Oct 19, 2020

#1436 in Parser implementations


Used in rhymuweb

Custom license

80KB
1.5K SLoC

MessageHeaders (rhymessage)

This is a library which implements RFC 5322, "Internet Message Format".

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 a MessageHeaders type which can be used to parse the header portion of e-mail or web server/client messages from strings, render them as strings, and get or set the individual headers.

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)

Building

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
~45K SLoC