This is a proof of concept, currently under active work to become the best OpenAPI implementation for C++.
It allows compile time C++ code generation for an OpenAPI configuration.
Get a free tipi by registering to tipi.build
tipi build . -t linux-cxx20
Featured in the CppCon 2021 Talks : Our Adventures With REST API in C++ : Making it Easy.
- Slides available here : CppCon 2021 Talks : Our Adventures With REST API in C++ : Making it Easy
Add the content of the petstore openapi.json to a C++ constexpr variable prefixed by _cx_json
.
static constexpr auto openapi_json = R"x(
{
"openapi": "3.0.2",
"info": {
"title": "Swagger Petstore - OpenAPI 3.0",
"description": "This is a sample Pet Store Server.",
"termsOfService": "http://swagger.io/terms/",
"contact": {
"email": "[email protected]"
},
"license": {
"name": "Apache 2.0",
"url": "http://www.apache.org/licenses/LICENSE-2.0.html"
},
"version": "1.0.6"
}
...
...
...
...
})x"_cx_json
constexpr auto client = client_t<decltype(openapi_json)>{};
using pre::cx::key_value_pair;
auto reply = client.call_operation<"addPet">(std::make_tuple(
key_value_pair<"id" , int> {43},
key_value_pair<"name" , std::string> {"Haskell"s},
key_value_pair<"photoUrls" , std::vector<std::string>> { {"little_cat.png"s} }
));
mp11::mp_rename<poor_person_metaclass::all_operations, mp11::mp_inherit> print_code{};
This will print the code to #include <>
on a later build, that allows you then to use this syntax for the HTTP POST /Pet
remote call:
auto second_reply = addPet(Pet{{43}, {"Haskell junior"s}, {{"some_cat.png"}} });
`
- Boost.PFR : Struct to tuple transformation
- cpp-pre/json feature branche compile-time-key-value-pairs: Automagic JSON generation Compile time key value pairs
- constexpr_all_the_things fork with C++20 compile time strings
- nxxm/xxhr : HTTP requests client library