Repository files navigation

This package is a pure-python client library forTarantool.

Documentation |Downloads |PyPI |GitHub |Issue tracker

The recommended way to install thetarantool package is usingpip.

$ pip3 install tarantool

You can installpython3-tarantool RPM package if you use Fedora (34, 35, 36).

Add the repository

$ curl -L https://tarantool.io/OtKysgx/release/2/installer.sh| bash

and then install the package

$ dnf install -y python3-tarantool

You can installpython3-tarantool deb package if you useDebian (10, 11) or Ubuntu (20.04, 22.04).

Add the repository

$ curl -L https://tarantool.io/OtKysgx/release/2/installer.sh| bash

and then install the package

$ apt install -y python3-tarantool

You can also download zip archive, unpack it and run:

$ make install

You can also install the development version of the package usingpip.

$ pip3 install git+https://github.com/tarantool/tarantool-python.git@master

Tarantool is an in-memory computing platform originally designed byVK and released under the terms ofBSD license.

• ANSI SQL, including views, joins, referential and check constraints
• Lua packages for non-blocking I/O, fibers, and HTTP
• MessagePack data format and MessagePack-based client-server protocol
• Two data engines:
  • memtx – in-memory storage engine with optional persistence
  • vinyl – on-disk storage engine to use with larger data sets
• Secondary key and index iterator support (can be non-unique and composite)
• Multiple index types: HASH, BITSET, TREE, RTREE
• Asynchronous master-master replication
• Authentication and access control

• Tarantool homepage
• Tarantool on GitHub
• Tarantool documentation
• Client-server protocol specification

This driver is synchronous, so connection mustn't be shared between threads/processes.

If you're looking for an asynchronous Python driver based onasyncio,consider usingasynctnt . See also thefeature comparison table.

On Linux:

$ maketest

On Windows:

• Setup a Linux machine with Tarantool installed.This machine will be referred to asremote in this instruction.
• (Onremote) Copytest/suites/lib/tarantool_python_ci.lua to/etc/tarantool/instances.available.
• (Onremote) Runtarantoolctl start tarantool_python_ci.
• Set the following environment variables:*REMOTE_TARANTOOL_HOST=...,*REMOTE_TARANTOOL_CONSOLE_PORT=3302.
• Runmake test.

To build documentation, first you must install its build requirements:

$ pip3 install -r docs/requirements.txt

Then run

$ make docs

You may host local documentation server with

$ python3 -m http.server --directory build/sphinx/html

Openlocalhost:8000 in your browser to read the docs.

BSD-2-Clause. See theLICENSE file.