This package contains a pure-Python rqlite client library.
- Python -- one of the following:
- CPython_ >= 2.7 or >= 3.3
- rqlite Server
The last stable release is available on github and can be installed with pip
:
$ pip install git+https://github.com/rqlite/pyrqlite.git
You can also just clone the repo and install it from source:
$ git clone https://github.com/rqlite/pyrqlite.git $ cd pyrqlite $ python setup.py install
Finally (e.g. if pip
is not available), a tarball can be downloaded
from GitHub and installed with Setuptools:
$ # X.Y.Z is the desired pyrqlite version (e.g. 2.2.1). $ curl -L https://github.com/rqlite/pyrqlite/archive/refs/tags/vX.Y.Z.tar.gz | tar xz $ cd pyrqlite* $ python setup.py install $ # The folder pyrqlite* can be safely removed now.
You mean need to run the installation process with root
privileges.
To run all the tests, execute the script setup.py
:
$ python setup.py test
pytest (https://pytest.org/) and pytest-cov are required to run the test
suite. They can both be installed with pip
The following code creates a connection and executes some statements:
import pyrqlite.dbapi2 as dbapi2
# Connect to the database
connection = dbapi2.connect(
host='localhost',
port=4001,
)
try:
with connection.cursor() as cursor:
cursor.execute('CREATE TABLE foo (id integer not null primary key, name text)')
cursor.executemany('INSERT INTO foo(name) VALUES(?)', seq_of_parameters=(('a',), ('b',)))
with connection.cursor() as cursor:
# Read a single record with qmark parameter style
sql = "SELECT `id`, `name` FROM `foo` WHERE `name`=?"
cursor.execute(sql, ('a',))
result = cursor.fetchone()
print(result)
# Read a single record with named parameter style
sql = "SELECT `id`, `name` FROM `foo` WHERE `name`=:name"
cursor.execute(sql, {'name': 'b'})
result = cursor.fetchone()
print(result)
finally:
connection.close()
This example will print:
(1, 'a') (2, 'b')
Only qmark and named paramstyles (as defined in PEP 249) are supported.
Transactions are not supported.
DB-API 2.0: http://www.python.org/dev/peps/pep-0249
pyrqlite is released under the MIT License. See LICENSE for more information.