Repository files navigation

Modern C++ network programming libraries.

Join us on Slack:http://slack.cpp-netlib.org/

Subscribe to the mailing list:https://groups.google.com/forum/#!forum/cpp-netlib

You can find official release packages of the library at:

http://github.com/cpp-netlib/cpp-netlib/downloads

If you want the latest code from the master branch of the project, you canfollow these instructions for cloning the project repository:

$ git clone https://github.com/cpp-netlib/cpp-netlib$ cd cpp-netlib$ git submodule init$ git submodule update

cpp-netlib is a collection of network-related routines/implementationsgeared towards providing a robust cross-platform networking library.cpp-netlib offers the following implementations:

• Common Message Type -- A generic message type which can be usedto encapsulate and store message-related information, used by allnetwork implementations as the primary means of data exchange.
• Network protocol message parsers -- A collection of parsers whichgenerate message objects from strings.
• Adapters and Wrappers -- A collection of Adapters and wrappers aimedtowards making the message type STL friendly.
• Network protocol client and server implementations -- A collectionof network protocol implementations that include embeddable clientand server types.

This library is released under the Boost Software License (please seehttp://boost.org/LICENSE_1_0.txt or the accompanying LICENSE_1_0.txt filefor the full text.

To build the libraries you will need to have CMake version 2.8 or higherinstalled appropriately in your system.

$ cmake --versioncmake version 2.8.1

It is recommended that you build cpp-netlib outside of the source directory, toavoid having issues with CMake generated files polluting the source directory:

$ mkdir ~/cpp-netlib-build$ cd ~/cpp-netlib-build$ cmake -DCMAKE_BUILD_TYPE=Debug     \>       -DCMAKE_C_COMPILER=clang     \>       -DCMAKE_CXX_COMPILER=clang++ \>       $HOME/cpp-netlib    # we're assuming this is where cpp-netlib is.

Once CMake is done with generating the Makefiles and configuring the project,you can now build the tests and run them:

$ cd ~/cpp-netlib-build$ make$ make test

You can also download and install cpp-netlib using the ` vcpkg`_ dependency manager:

$ git clonehttps://github.com/Microsoft/vcpkg.git$ cd vcpkg$ ./bootstrap-vcpkg.sh$ ./vcpkg integrate install$ vcpkg install cpp-netlib

The cpp-netlib port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please create an issue or pull request on the ` vcpkg`_ repository.

If for some reason some of the tests fail, you can send the files inTesting/Temporary/ as attachments to the cpp-netlibdevelopers mailinglist.

If you want to run the tests that come with cpp-netlib, there are a few thingsyou will need. These are:

• A compiler (GCC 4.x, Clang 3.6, MSVC 2008)
• A build tool (CMake is required)
• OpenSSL headers (optional)

cpp-netlib usesgit for tracking work and is hosted onGitHub.cpp-netlib is hosted onGitHub following the GitHub recommended practice offorking the repository and submitting pull requests to the source repository.You can read more about theforking process and submittingpull requests ifyou're not familiar with either process yet. cpp-netib follows the GitHub pullrequest model for accepting patches. You can read more about the process athttp://cpp-netlib.org/process.html#pull-requests.

Because cpp-netlib is released under theBoost Software License it isrecommended that any file you make changes to bear your copyright noticealongside the original authors' copyright notices on the file. Typically thecopyright notices are at the top of each file in the project.

You can read about the cpp-netlib style guide athttp://cpp-netlib.org/style-guide.html.

The main "upstream" repository is athttp://github.com/cpp-netlib/cpp-netlib.

In case you have any questions or would like to make feature requests, you cancontact the development team through thedevelopers mailing listor by filing issues athttp://github.com/cpp-netlib/cpp-netlib/issues.

Join us on Slack:http://slack.cpp-netlib.org/

You can reach the maintainers of the project through:

Dean Michael Berris (dberris@google.com)Glyn Matthews (glyn.matthews@gmail.com)