Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rpclib/rpclib
rpclib is a modern C++ msgpack-RPC server and client library
https://github.com/rpclib/rpclib
cplusplus cplusplus-14 cpp cpp14 msgpack rpc
Last synced: 24 days ago
JSON representation
rpclib is a modern C++ msgpack-RPC server and client library
- Host: GitHub
- URL: https://github.com/rpclib/rpclib
- Owner: rpclib
- License: other
- Created: 2015-11-23T19:46:04.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2024-04-09T11:29:25.000Z (7 months ago)
- Last Synced: 2024-05-02T14:43:41.575Z (6 months ago)
- Topics: cplusplus, cplusplus-14, cpp, cpp14, msgpack, rpc
- Language: C++
- Homepage: http://rpclib.net
- Size: 3.28 MB
- Stars: 1,645
- Watchers: 72
- Forks: 378
- Open Issues: 106
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
- AwesomeCppGameDev - rpclib - RPC server and client library (Networking)
README
# rpclib  [](https://travis-ci.org/rpclib/rpclib) [](https://ci.appveyor.com/project/sztomi/callme) [](https://img.shields.io/codecov/c/github/rpclib/rpclib/dev.svg)  [](https://gitter.im/rpclib/Lobby)
## Status
**[rpclib is looking for maintainers](https://github.com/rpclib/rpclib/issues/273)**
If you're looking for a similar library with support for JSON-RPC and async operations, check out **[packio](https://github.com/qchateau/packio)**.
## Overview
`rpclib` is a RPC library for C++, providing both a client and server implementation. It is built using modern C++14, and as such, requires a recent compiler. Main highlights:
* Expose functions of your program to be called via RPC (from any language
implementing msgpack-rpc)
* Call functions through RPC (of programs written in any language)
* No IDL to learn
* No code generation step to integrate in your build, just C++
# Look&feel
## Server
```cpp
#include
#include "rpc/server.h"
void foo() {
std::cout << "foo was called!" << std::endl;
}
int main(int argc, char *argv[]) {
// Creating a server that listens on port 8080
rpc::server srv(8080);
// Binding the name "foo" to free function foo.
// note: the signature is automatically captured
srv.bind("foo", &foo);
// Binding a lambda function to the name "add".
srv.bind("add", [](int a, int b) {
return a + b;
});
// Run the server loop.
srv.run();
return 0;
}
```
When `srv.run()` is called, `rpclib` starts the server loop which listens to incoming connections
and tries to dispatch calls to the bound functions. The functions are called from the thread where
`run` was called from. There is also `async_run` that spawns worker threads and returns
immediately.
## Client
```cpp
#include
#include "rpc/client.h"
int main() {
// Creating a client that connects to the localhost on port 8080
rpc::client client("127.0.0.1", 8080);
// Calling a function with paramters and converting the result to int
auto result = client.call("add", 2, 3).as();
std::cout << "The result is: " << result << std::endl;
return 0;
}
```
# Status
All planned 1.0.0 features are done and tested; the current state is production-ready.
# Who uses rpclib?
This list is updated as I learn about more people using the library; let me
know if you don't want your project listed here.
* [Microsoft AirSim](https://github.com/Microsoft/AirSim)
# Thanks
`rpclib` builds on the efforts of fantastic C++ projects. In no particular order:
* [MessagePack implementation for C and C++](https://github.com/msgpack/msgpack-c) by Takatoshi Kondo ([website](http://msgpack.org/))
* [asio](https://github.com/chriskohlhoff/asio) by Christopher Kohlhoff ([website](http://think-async.com/Asio))
* [cppformat](https://github.com/fmtlib/fmt) (now renamed `fmtlib`, by Victor Zverovich ([website](http://fmtlib.net))
* [googletest](https://github.com/google/googletest) by Google
* [wheels](https://github.com/rmartinho/wheels) by Martinho Fernandes
Shoutouts to
* [Appveyor](https://www.appveyor.com/)
* [Travis CI](https://travis-ci.org)
* [Coveralls.io](https://coveralls.io/)
* [Coverity](http://www.coverity.com)
* [ASan & TSan](https://github.com/google/sanitizers) helped spotting and resolving many bugs.