Build
BeastQuest currently only supports Linux and OS X. This will change as I figure out some linking issues on Windows.
CMake Build
This project uses CMake, so it is as simple as cloning the repo, adding a new subdirectory to your CMake project, and using the provided variables:
# This will download and configure needed dependencies
set(BeastQuest_BUILDS_DEPS ON)
add_subdirectory(beastquest)
include_directories(${BeastQuest_INCLUDEDIR})
target_link_libraries(your_target_here ${BeastQuest_LIBRARIES})
The BeastQuest_BUILD_DEPS variable will build both Boost and OpenSSL and
handle their include files and libraries. You can also specify which
dependency to handle with BeastQuest_BUILD_BOOST or
BeastQuest_BUILD_OPENSSL. When BeastQuest handles dependencies, static linking
is the default for OpenSSL on Windows and Mac OS X, and for Boost on all
platforms. You can change this default by setting Boost_USE_STATIC_LIBS and
OPENSSL_USE_STATIC_LIBS to OFF.
If depedencies are not handled, CMake will search default locations for an installed version of Boost or OpenSSL and link dynamically by default.
Tests
Tests use Google Test, which can be downloaded by running the following:
git submodule update --init
Tests can be built by setting the CMake option BeastQuest_BUILD_TESTS to ON
either on the command line or in your CMakeLists.txt.
If you wish to use a local httpbin server
for tests, you can set the BeastQuest_LOCAL_HTTPBIN CMake variable. Note
that SSL tests will not be run in this case.
You can generate code coverage by setting the BeastQuest_TEST_COVERAGE CMake variable.
Example Project
You can find an example project here that builds and links against BeastQuest. It should be a good start in testing out the library and its build process. Feel free to fork it and mess around with it!