C++11 Lightweight Redis client: async, thread-safe, no dependency, pipelining, multi-platform.
C++ CMake
Clone or download
Permalink
Failed to load latest commit information.
assets/images cpp_redis logger example image Oct 7, 2016
docs fix issues #126 #135 #137: fix behavior of set_nb_workers, fix bug wh… Nov 26, 2017
examples fix issues #126 #135 #137: fix behavior of set_nb_workers, fix bug wh… Nov 26, 2017
includes/cpp_redis add move ctor & move operator= for reply (#189) Jul 23, 2018
msvc15 Resolve Compiler Warnings for Windows Build (#129) Nov 3, 2017
sources Fix redundant copy of caught exception (#195) Aug 15, 2018
tacopie @ 8714fce bump tacopie Mar 13, 2018
tests Use uniform CMake spacing and capitalization (#127) Oct 31, 2017
.appveyor.yml Create Windows build job with AppVeyor (#124) Oct 21, 2017
.clang-format provide clang-format configuration & apply it. Oct 13, 2016
.doxygen remove private/protected/static members from documentation Sep 25, 2017
.gitignore Generate pkg-config File (#33) Jan 15, 2017
.gitmodules Change the network module of cpp-redis (#39) Jan 29, 2017
.travis.yml remove g++4.8 from travis on macos as the installation is broken and … Dec 3, 2017
CHANGELOG.md [4.3.1] changelog Feb 1, 2018
CMakeLists.txt Fix for building without tacopie (#185) Jul 11, 2018
CONTRIBUTING.md Enable ctest (#122) Oct 21, 2017
LICENSE update LICENCE & insert licence headers in source files. Jan 20, 2017
README.md fixing .README errors (#175) Apr 10, 2018
clang_format.sh provide clang-format configuration & apply it. Oct 13, 2016
cpp_redis.pc.in Generate pkg-config File (#33) Jan 15, 2017

README.md

cpp_redis Build Status Build status

cpp_redis is a C++11 Asynchronous Multi-Platform Lightweight Redis Client, with support for synchronous operations, pipelining, sentinels and high availability.

Requirement

cpp_redis has no dependency. Its only requirement is C++11.

It comes with no network module, so you are free to configure your own, or to use the default one (tacopie)

Example

cpp_redis::client

cpp_redis::client client;

client.connect();

client.set("hello", "42");
client.get("hello", [](cpp_redis::reply& reply) {
  std::cout << reply << std::endl;
});
//! also support std::future
//! std::future<cpp_redis::reply> get_reply = client.get("hello");

client.sync_commit();
//! or client.commit(); for asynchronous call

cpp_redis::client full documentation and detailed example. More about cpp_redis::reply.

cpp_redis::subscriber

cpp_redis::subscriber sub;

sub.connect();

sub.subscribe("some_chan", [](const std::string& chan, const std::string& msg) {
  std::cout << "MESSAGE " << chan << ": " << msg << std::endl;
});
sub.psubscribe("*", [](const std::string& chan, const std::string& msg) {
  std::cout << "PMESSAGE " << chan << ": " << msg << std::endl;
});

sub.commit();

cpp_redis::subscriber full documentation and detailed example.

Wiki

A Wiki is available and provides full documentation for the library as well as installation explanations.

Doxygen

A Doxygen documentation is available and provides full API documentation for the library.

License

cpp_redis is under MIT License.

Contributing

Please refer to CONTRIBUTING.md.

Special Thanks

Mike Moening for his unexpected and incredible great work aiming to port cpp_redis on Windows, provides sentinel support and high availability support!

Author

Simon Ninon