Oat++ is a modern Web Framework for C++. It's fully loaded and contains all necessary components for effective production level development. It's also light and has a small memory footprint.

1403 Commit

7 Rami (Branch)

17 Rilasci

Leonid Stryzhevskyi 97d7597112 Update 1.3.0.md		2 anni fa
changelog	97d7597112 Update 1.3.0.md	2 anni fa
cmake	47b34ef74c Make MSVC runtime setting available for all projects	2 anni fa
fuzzers	e65a686982 Fix fuzzers build	2 anni fa
src	c2b026f87a BufferBody: check buffer for nullptr.	2 anni fa
test	ce7a3316d8 QUERY: fix default value type (#411). QueryParams/Headers: use unordered_multimap (#402)	2 anni fa
utility	cc90da292c better cmake scripts	5 anni fa
.gitignore	8a5ad5c88b memory pools: Remove std::call_once.	3 anni fa
CMakeLists.txt	47b34ef74c Make MSVC runtime setting available for all projects	2 anni fa
CODE_OF_CONDUCT.md	19fae6a0bf Create CODE_OF_CONDUCT.md	5 anni fa
CONTRIBUTING.md	89980778ea Fix typos	5 anni fa
LICENSE	8914b7d695 Initial commit	6 anni fa
README.md	4fabd8a87a Update README.md	2 anni fa
azure-pipelines.yml	243fa57119 Update azure-pipelines.yml	2 anni fa
lgtm.yml	6d6af2c0c3 fixing lgtm.yml	5 anni fa

Oat++

News

Hey, the new oatpp version 1.3.0 is now in the master branch :tada: and soon will receive its release tag.
Follow changelog for details, and prepare for migration.
See project build status for update progress.

Oat++ is a modern Web Framework for C++. It's fully loaded and contains all necessary components for effective production level development. It's also light and has a small memory footprint.

Start

About

Join Our Community

Gitter - Talk to Oat++ developers and to other Oat++ users.
Twitter - Follow Oat++ on Twitter.
Reddit - Follow Oat++ subreddit.
StackOverflow (new) - Post a Question.

Quick Overview

Shortcuts:

Oat++ High Level Overview - Get a quick overview of Oat++ features.
Example Project - A complete example of a "CRUD" service (UserService) built with Oat++. REST + Swagger-UI + SQLite.

Build Powerful API And Document It With Swagger-UI

See ApiController for more details.

ENDPOINT_INFO(getUserById) {
  info->summary = "Get one User by userId";

  info->addResponse<Object<UserDto>>(Status::CODE_200, "application/json");
  info->addResponse<Object<StatusDto>>(Status::CODE_404, "application/json");
  info->addResponse<Object<StatusDto>>(Status::CODE_500, "application/json");

  info->pathParams["userId"].description = "User Identifier";
}
ENDPOINT("GET", "users/{userId}", getUserById,
         PATH(Int32, userId))
{
  return createDtoResponse(Status::CODE_200, m_userService.getUserById(userId));
}

Access Databases And Keep Your Data Consistent

See Oat++ ORM for more details.

QUERY(createUser,
      "INSERT INTO users (username, email, role) VALUES (:username, :email, :role);",
      PARAM(oatpp::String, username), 
      PARAM(oatpp::String, email), 
      PARAM(oatpp::Enum<UserRoles>::AsString, role))

Frequently Asked Questions

Q: "Oat++" name?

"Oat" is something light, organic, and green. It can be easily cooked and consumed with no effort.
"++" gives a hint that it is "something" for C++.

Q: What is the main area of Oat++ application?

Oat++ is used for many different purposes, from building REST APIs that run on embedded devices to building microservices and highly-loaded cloud applications.

But the majority of use cases appears to be in IoT and Robotics.

Q: How portable is Oat++?

Theoretically, Oat++ can be easily ported everywhere where you have threads and network stack. With an additional comparably small effort, it can be ported almost everywhere depending on how much you strip it and what would be the final binary size.

See supported platforms for additional info.

Q: What is the size of a minimal Oat++ application?

About 1Mb, depending on C/C++ std-lib and oatpp version.

Q: Which Oat++ API to choose, Simple or Async?

Always choose Simple API wherever possible. Simple API is more developed and makes the code cleaner.

Async API is designed for small, specific tasks that run at high concurrency levels ex.:

Serving file downloads to a large number of concurrent users (1K users and more).
Streaming to a large number of clients (1K or more).
Websocket Chat servers.

For all other purposes use simple API.

Examples

REST-API

REST Service - A complete example of a "CRUD" service (UserService) built with Oat++. REST + Swagger-UI + SQLite.
REST Client - Example project of how-to use Retrofit-like client wrapper (ApiClient) and how it works.

WebSocket

Can Chat - Feature-complete rooms-based chat for tens of thousands users. Client plus Server.
WebSocket - Collection of oatpp WebSocket examples.
YUV Websocket Stream - Example project how-to create a YUV image stream from a V4L device (i.E. Webcam) using websockets.

Databases

SQLite - A complete example of a "CRUD" service. REST + Swagger-UI + SQLite.
PostgreSQL - Example of a production-grade entity service storing information in PostgreSQL. With Swagger-UI and configuration profiles.
MongoDB - Example project how to work with MongoDB using oatpp-mongo mondule. Project is a web-service with basic CRUD and Swagger-UI.

IoT

Example-IoT-Hue - Example project how-to create an Philips Hue compatible REST-API that is discovered and controllable by Hue compatible Smart-Home devices like Amazon Alexa or Google Echo.

Streaming

HTTP Live Streaming Server - Example project on how to build an HLS-streaming server using Oat++ asynchronous API.
YUV Websocket Stream - Example project how-to create a YUV image stream from a V4L device (i.E. Webcam) using websockets.

TLS

TLS With Libressl - Example project how-to setup secure connection and serve via HTTPS.

Microservices

Consul Integration - Example project on how to use oatpp::consul::Client. Consul integration.
Microservices - Example project on how to build microservices with Oat++, and example on how to consolidate those microservices using monolithization technique.

Asynchronous API

Async Service - Example project on how to use asynchronous API to handle a large number of simultaneous connections.

README.md