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.
If you came here looking for an utility tool, this functionality has been dropped during the porting from python 2 to 3. Instead, you should look (and we suggest to use) https://github.com/BOOMfinity-Developers/GoThink
RethinkDB's Python Client can be installed by running pip install rethinkdb and it requires
Python 3.7.0+ 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 contibuting guideline. This guideline will walk you through how can you successfully contribute to RethinkDB Python client.
For development you will need poetry, pre-commit and shellcheck. After poetry installed, simply run poetry install -E all. This command will both create the virtualenv and install all development dependencies for you.
| Command | Description |
|---|---|
| help | show help message and exit |
| clean | remove all build, test, coverage and Python artifacts |
| clean-build | remove build artifacts |
| clean-mypy | remove mypy related artifacts |
| clean-pyc | remove Python file artifacts |
| clean-test | remove test and coverage artifacts |
| docs | generate Sphinx HTML documentation, including API docs |
| format | run formatters on the package |
| generate-init-pyi | generate __init__.pyi file |
| lint | run linters against the package |
| protobuf | download and convert protobuf file |
| test | run all tests and generate coverage |
| test-integration | run unit tests and generate coverage |
| test-unit | run unit tests and generate coverage |
