RethinkDB is the first open-source scalable database built for realtime applications. It exposes a new database access model -- instead of polling for changes, the developer can tell the database to continuously push updated query results to applications in realtime. RethinkDB allows developers to build scalable realtime apps in a fraction of the time with less effort.
RethinkDB Python Client provides a set of utility scripts to help you manage your RethinkDB database.
- rethinkdb dump / rethinkdb-dump - Dump a database to a file
- rethinkdb export / rethinkdb-export - Export a table to a file
- rethinkdb import / rethinkdb-import - Import a table from a file
- rethinkdb index-rebuild / rethinkdb-index-rebuild - Rebuild all indexes
- rethinkdb repl / rethinkdb-repl - Start a REPL session
- rethinkdb restore / rethinkdb-restore - Restore a database from a file
RethinkDB's Python Client can be installed by running pip install rethinkdb and it requires
Python 3.12+ to run. This is the preferred method to install RethinkDB Python client, as it will
always install the most recent stable release. If you don't have pip installed, this
Python installation guide can guide you through the process.
RethinkDB's Python Client tries to be as tiny as its possible, hence some functionalities are requiring extra dependencies to be installed.
To install rethinkdb with an extra package run pip install rethinkdb[<EXTRA>],
where <EXTRA> is the name of the extra option. To install multiple extra packages
list the extra names separated by comma as described in pip's examples section point
number six.
| Extra | Description |
|---|---|
| all | alias to install all the extras available |
TODO
Hurray, You reached this section, which means you are ready to contribute.
Please read our contributing guideline. This guideline will walk you through how can you successfully contribute to RethinkDB Python client.
Install mise, then install the pinned toolchain and project dependencies:
$ mise install $ mise run setup
mise run setup creates .venv and installs the package, extras, and development tools with uv.
| Command | Description |
|---|---|
| setup | create the virtualenv and install extras and dev tools |
| format | format Python sources with Ruff |
| lint | run Ruff and mypy |
| test | run unit and integration tests and report coverage |
| test-unit | run unit tests |
| test-integration | run integration tests |
| docs | build the Sphinx HTML documentation |
| protobuf | download and convert the protobuf file |
| generate-init-pyi | regenerate rethinkdb/__init__.pyi |
| clean | remove build, test, coverage, and cache artifacts |
Run a task with mise run <task>. mise tasks lists them.