Name: beast
Owner: Boost.org
Description: HTTP and WebSocket built on Boost.Asio in C++11
Created: 2013-06-16 22:26:09.0
Updated: 2018-01-19 05:31:35.0
Pushed: 2018-01-12 20:28:55.0
Homepage: http://www.boost.org/libs/beast
Size: 8141
Language: C++
GitHub Committers
| User | Most Recent Commit | # Commits |
|---|
Other Committers
| User | Most Recent Commit | # Commits |
|---|
<img width=“880” height = “80” alt = “Boost.Beast Title”
src="https://raw.githubusercontent.com/boostorg/beast/master/doc/images/readme2.png">
Branch | Linux/OSX | Windows | Coverage | Documentation | Matrix
————|———–|———|———-|—————|——–
master | 
| |
| 
| 
develop | 
| |
| 
| 
Beast is a C++ header-only library serving as a foundation for writing interoperable networking libraries by providing low-level HTTP/1, WebSocket, and networking protocol vocabulary types and algorithms using the consistent asynchronous model of Boost.Asio.
This library is designed for:
Symmetry: Algorithms are role-agnostic; build clients, servers, or both.
Ease of Use: Boost.Asio users will immediately understand Beast.
Flexibility: Users make the important decisions such as buffer or thread management.
Performance: Build applications handling thousands of connections or more.
Basis for Further Abstraction. Components are well-suited for building upon.
| Bishop Fox 2018 |
| ———— |
| 
|
| CppCon 2017 | CppCast 2017 | CppCon 2016 |
| ———— | ———— | ———– |
| 
| 
|
This software is in its first official release. Interfaces may change in response to user feedback. For recent changes see the CHANGELOG.
This library is for programmers familiar with Boost.Asio. Users who wish to use asynchronous interfaces should already know how to create concurrent network programs using callbacks or coroutines.
When using Microsoft Visual C++, Visual Studio 2015 Update 3 or later is required.
One of these components is required in order to build the tests and examples:
The official repository contains the following branches:
master This holds the most recent snapshot with code that is known to be stable.
develop This holds the most recent snapshot. It may contain unstable code.
Each of these branches requires a corresponding Boost branch and all of its subprojects. For example, if you wish to use the master branch version of Beast, you should clone the Boost superproject, switch to the master branch in the superproject and acquire all the Boost libraries corresponding to that branch including Beast.
Or, to use the latest shipping version of Beast, simply use it from the corresponding distribution of Boost.
Beast is header-only. To use it just add the necessary #include line
to your source files, like this:
lude <boost/beast.hpp>
To build your program successfully, you'll need to add the Boost.System library to link with. If you use coroutines you'll also need to link with the Boost.Coroutine library. Please visit the Boost documentation for instructions on how to do this for your particular build system.
To build the documentation, examples, tests, and benchmarks it is necessary to first obtain the boost “superproject” along with all of the boost libraries. Instructions for doing so may be found on the Boost Wiki. These commamnds will build the programs and documentation that come with Beast (omit the cxxflags parameter when building using MSVC):
oost # The directory containing the boost superproject and libraries
ibs/beast/test cxxflags="-std=c++11" # bjam must be in your $PATH
ibs/beast/example cxxflags="-std=c++11"
ibs/beast/doc
On Windows platforms only, CMake may be used to generate a Visual Studio solution and a set of Visual Studio project files using these commands:
oost # The directory containing the boost superproject and libraries
ibs/beast
r bin
in
e .. # for 32-bit Windows builds, or
e -G"Visual Studio 14 2015 Win64" .. # for 64-bit Windows builds (VS2015), or
e -G"Visual Studio 15 2017 Win64" .. # for 64-bit Windows builds (VS2017)
The files in the repository are laid out thusly:
bin/ Create this to hold executables and project files
bin64/ Create this to hold 64-bit Windows executables and project files
doc/ Source code and scripts for the documentation
include/ Where the header files live
extras/ Additional APIs, may change
example/ Self contained example programs
meta/ Metadata for Boost integration
scripts/ Small scripts used with CI systems
test/ Unit tests
These examples are complete, self-contained programs that you can build
and run yourself (they are in the example directory).
http://www.boost.org/doc/libs/develop/libs/beast/doc/html/beast/quick_start.html
Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
Please report issues or questions here: https://github.com/boostorg/beast/issues
If you would like to contribute to Beast and help us maintain high quality, consider performing code reviews on active pull requests. Any feedback from users and stakeholders, even simple questions about how things work or why they were done a certain way, carries value and can be used to improve the library. Code review provides these benefits:
You can look through the Closed pull requests to get an idea of how reviews are performed. To give a code review just sign in with your GitHub account and then add comments to any open pull requests below, don't be shy!
https://github.com/boostorg/beast/pulls
Here are some resources to learn more about code reviews:
Beast thrives on code reviews and any sort of feedback from users and stakeholders about its interfaces. Even if you just have questions, asking them in the code review or in issues provides valuable information that can be used to improve the library - do not hesitate, no question is insignificant or unimportant!