Python

Use Python to access CovenantSQL

Developers could use PyCovenantSQL to access CovenantSQL through Adapter.

Compatibility

Python SDK requires Python 3.4+.

Installation and quick start

Before using Python SDK, an adapter deployment is required, please see Deploy Adapter Service.

Install PyCovenantSQL using pip:

$ python3 -m pip install PyCovenantSQL 

Example

Replace adapter_host with adapter listen host, adapter_port with adapter listen port, dsn with database dsn.

import pycovenantsql

# Connect to the database
connection = pycovenantsql.connect(host='<adapter_host>',
                             port=<adapter_port>,
                             database='<dsn>'
                             )

try:
    with connection.cursor() as cursor:
        # Create a new record
        sql = "INSERT INTO `users` (`email`, `password`) VALUES (%s, %s)"
        cursor.execute(sql, ('[email protected]', 'very-secret'))

    # connection is autocommit. No need to commit in any case.
    # connection.commit()

    with connection.cursor() as cursor:
        # Read a single record
        sql = "SELECT `id`, `password` FROM `users` WHERE `email`=%s"
        cursor.execute(sql, ('[email protected]',))
        result = cursor.fetchone()
        print(result)
finally:
    connection.close()