ThorsAnvil

A set of modern C++20 libraries for writing interactive Web-Services.

This project provides the following libraries:

1. Mug
   A simple configurable C++ NissaServer that dynamically loads shared libraries that install NisseHTTP handlers.

2. Nisse

   • NisseServer
     Provides a server object that handles socket events and non-blocking async IO operations.
   • NisseHTTP
     Provides HTTP request/response objects exposing the body as an async std::iostream. This allows C++ objects to be streamed directly via a REST interface with no serialization code.

3. API Supported:

   • ThorsSlack
     Type-safe API to send REST messages to/from Slack.
     Supports REST Slack API and Slack webhooks via NissaHTTP.
     Use C++ objects, no serialization code required.
   • ThorsMongo
     Type-safe interface for inserting/updating/finding objects in a collection.
     Sends and receives MongoDB wire protocol messages.
     Directly send C++ objects to a Mongo collection with no serialization code.

4. ThorsSerializer
   Automatically converts C++ objects into JSON / BSON / YAML

5. ThorsSocket
   Async IO library for Files/Pipes/Sockets/Secure Sockets that exposes all of them via std::iostream interface.

6. ThorsCrypto
   C++ wrapper around platform-specific libraries to support base64 Encoding, CRC Checksum, Hashing, HMAC, SCRAM, MD5, SHA-1, SHA-256.

7. ThorsIOUtil

8. ThorsLogging

The main goal of these projects is to remove the need to write boilerplate code. Using a declarative style, an engineer can define the C++ classes and members that need to be serialized.

Write-Ups

Detailed explanations of these projects can be found at:

LokiAstari.com

Installing

Easy: Using Brew

Can be installed via brew on Mac and Linux

> brew install thors-anvil

• Mac: https://formulae.brew.sh/formula/thors-anvil
• Linux: https://formulae.brew.sh/formula-linux/thors-anvil

Building Manually

> git clone git@github.com:Loki-Astari/ThorsAnvil.git
> cd ThorsAnvil
> ./configure
> make

Note: The configure script will tell you about any missing dependencies and how to install them.

Building Conan

If you have Conan installed, the Conan build processes should work.

> git clone git@github.com:Loki-Astari/ThorsAnvil.git
> cd ThorsAnvil
> conan build -s compiler.cppstd=20 conanfile.py

Header Only

To install the header-only version

> git clone --single-branch --branch header-only https://github.com/Loki-Astari/ThorsAnvil.git

Some dependencies you will need to install manually for header-only builds.

Magic Enum: https://github.com/Neargye/magic_enum
libYaml     https://github.com/yaml/libyaml
libSnappy   https://github.com/google/snappy
libZ        https://www.zlib.net/

Note: The header-only version does not include Mug

Building With Visual Studio

To build on Windows, you will need to add the flag: /Zc:preprocessor. These libraries make heavy use of VAR_ARG macros to generate code for you, so they require a conforming pre-processor. See Macro Expansion of VA_ARGS Bug in Visual Studio? for details.