HTTP library

A header-only HTTP client library based on boost::beast and nlohmann::json.

Features

• GET, PUT, POST, PATCH and DELETE resources from/to a REST service
• HTTP/HTTPS
• Basic and Bearer token authentication
• Post FormData
• Asynchronous response wrapped into future
• Upload/Download files

Dependencies

• OpenSSL (through openssl-cmake)
• Boost::beast
• Boost::uuid
• nlohmann::json
• fmtlib::fmt

All dependencies are pulled and compiled thanks to CPM.cmake

For Windows platform, you'll need to have NASM installed and your PATH pointing at it to build OpenSSL correctly.

Build

Use cmake to configure, build and install:

cmake -B build -DCMAKE_INSTALL_PREFIX=<your_install_dir>cmake --build build --target install

Include directly into your project

Use CPM.cmake to include directly into your project:

cmake_minimum_required(VERSION3.16)
project(your_project
LANGUAGESCXX
)
# download CPM.cmakefile(
DOWNLOADhttps://github.com/cpm-cmake/CPM.cmake/releases/download/v0.40.2/CPM.cmake${CMAKE_CURRENT_BINARY_DIR}/cmake/CPM.cmakeEXPECTED_HASHSHA256=c8cdc32c03816538ce22781ed72964dc864b2a34a310d3b7104812a5ca2d835d
)
include(${CMAKE_CURRENT_BINARY_DIR}/cmake/CPM.cmake)
CPMAddPackage("gh:jfayot/Http@1.0.0")
add_executable(your_target${CMAKE_CURRENT_LIST_DIR}/main.cpp)
target_link_libraries(your_targetPRIVATEHttp::client)

Minimal example

#include"Http/HttpTypes.hpp"structPerson
{
std::string name;
int age;
NLOHMANN_DEFINE_TYPE_INTRUSIVE(Person, name, age)
};
intmain()
{
Person person{ "captain", 42 };
Http::Client client{ "http://127.0.0.1:8080" };
Http::Request request = client.post("/persons").body(person);
std::shared_future<Http::Response> future = request.send();
// Do whatever needed// ...
Http::Response res = future.get();
if (true == res.ok())
{
Person content = res.body().get<Person>();
}
return0;
}