What Is "Beast-CppCon2018-vs-RESTinio"?
Vinnie Falco, the main author of Boost.Beast, gives a talk on CppCon-2018: Get Rich Quick! Using Boost.Beast WebSockets and Networking TS. This talk is about modern C++, upcoming Networking TS and Boost.Beast library.
A simple example was prepared by Vinnie Falco for that talk. Source code of that example can be found on GitHub.
Despite the fact that Boost.Beast is a great library and is bright example of C++ masterpiece, we think that usage of Boost.Beast for simple tasks is an overkill. Simple things must be done much simpler than approach proposed by Boost.Beast.
To prove our point of view we have created a reimplementation of Vinnie's example using OpenSource RESTinio library from stiffstream. This repository contains the source code of our version of that simple application.
Some Notes To Readers
We do not have a goal to create a side-by-side comparison between Beast-based and RESTinio-based solutions. This comparison is left as an exercise for a reader :)
Seriously speaking the best way to feel the difference is to study Beast-based solution and then compare it with RESTinio-based one. Look to the code. For example, look at the most important part of main() function in Vinnie's code. And then to the same part in our code.
What Do We Think?
We think that Boost.Beast is a great library. But it is too low-level.
Because of that we see only two niches appropriate for Boost.Beast:
- High-performant systems where you need a full control on everything. You can rely on Boost.Beast functionality and customization abilities to get maximum performance.
- More high-level and user-friendly libraries for working with HTTP in C++ code. Boost.Beast can be used as basis for that libraries. And you can hide Beast's complexity under your high-level API.
Obtaining And Building
A C++ compiler with C++14 support is required.
hg clone command to download example's sources.
hg clone https://bitbucket.org/sobjectizerteam/beast-cppcon2018-vs-restinio
You can also download a tarball with example's sources from a Downloads section. That tarball already contains all necessary dependencies.
There are three approaches for building Shrimp:
- by using Docker;
- by using CMake;
- by using Mxx_ru.
The simplest one is Docker-build because all necessary dependencies are downloaded and built automatically during docker build command.
You need Docker installed.
Enter into example's folder and run docker build command:
cd beast-cppcon-2018-vs-restinio docker build -t websocket_chat .
All necessary dependencies will be downloaded, configured and built inside Docker's image.
Then you can start Docker's image:
docker run -p 8080:8080 websocket_chat
Build with CMake
CMake version 3.8.0 or above is required.
The full source code of the example with all necessary dependencies must be downloaded as tarball from Downloads section. Then (XYZ is a precise version of tarball):
tar xaf beast-cppcon2018-vs-restinio-XYZ.tar.bz2 cd beast-cppcon2018-vs-restinio/dev mkdir cmake_build cd cmake_build cmake -DCMAKE_INSTALL_PREFIX=target .. cmake --build . --config Release cmake --build . --config Release --target install
websocket_chat_app will be copied to
Build with Mxx_ru
To build the example from repository you need to install Mxx_ru 220.127.116.11 or above:
apt-get install ruby gem install Mxx_ru
Mxx_ru helps to download necessary dependencies and used as a build tool.
Clone repo and download dependencies:
hg clone https://bitbucket.org/sobjectizerteam/beast-cppcon-2018-vs-restinio cd beast-cppcon-2018-vs-restinio mxxruexternals
Once you get example's sources and its dependencies you can build it.
# Start with repository root directory cd dev # Build. ruby build.rb --mxx-cpp-release # See websocket_chat_app in 'target/release' directory.
Or you can download a tarball with all dependencies from from Downloads section. Then (XYZ is a precise version of tarball):
tar xaf beast-cppcon2018-vs-restinio-XYZ.tar.bz2 cd beast-cppcon2018-vs-restinio/dev ruby build.rb --mxx-cpp-release
websocket_chat_app will be in
The example is distributed under BSD-3-CLAUSE license.
For the license of RESTinio library see LICENSE file in RESTinio distributive.
For the license of asio library see COPYING file in asio distributive.
For the license of nodejs/http-parser library see LICENSE file in nodejs/http-parser distributive.
For the license of fmtlib see LICENSE file in fmtlib distributive.