README.md

RethinkDB driver for C++

This driver is compatible with RethinkDB 2.0. It is based on the official RethinkDB Python driver.

• RethinkDB server
• RethinkDB API docs

Example

#include <memory>
#include <cstdio>
#include <rethinkdb.h>

namespace R = RethinkDB;

int main() {
  std::unique_ptr<R::Connection> conn = R::connect("localhost", 28015);
  R::Cursor cursor = R::table("users").filter(R::row["age"] > 14).run(*conn);
  for (R::Datum& user : cursor) {
      printf("%s\n", user.as_json().c_str());
  }
}

Build

Requires a modern C++ compiler. to build and install, run:

make
make install

Will build include/rethinkdb.h, librethinkdb++.a and librethinkdb++.so into the build/ directory.

To include documentation from the Python driver in the header file, pass the following argument to make.

make INCLUDE_PYTHON_DOCS=yes

To build in debug mode:

make DEBUG=yes

To install to a specific location:

make install prefix=/usr/local DESTDIR=

Status

Still in early stages of development.

Tests

This driver is tested against the upstream ReQL tests from the RethinkDB repo, which are programmatically translated from Python to C++. As of 34dc13c, all tests pass:

$ make test
...
SUCCESS: 2053 tests passed