Metadata-Version: 2.1
Name: ydb-dbapi
Version: 0.0.1b5
Summary: YDB Python DBAPI which complies with PEP 249
Author: Yandex LLC
Author-email: ydb@yandex-team.ru
Requires-Python: >=3.9,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: ydb (>=3.18.8,<4.0.0)
Description-Content-Type: text/markdown

# YDB Python DBAPI

## Introduction

Python DBAPI to `YDB`, which provides both sync and async drivers and complies with [PEP249](https://www.python.org/dev/peps/pep-0249/).

## Installation

**TBD after first release**

## Usage

To establish a new DBAPI connection you should provide `host`, `port` and `database`:

    ```python
    import ydb_dbapi

    connection = ydb_dbapi.connect(
        host="localhost", port="2136", database="/local"
    ) # sync connection

    async_connection = await ydb_dbapi.async_connect(
        host="localhost", port="2136", database="/local"
    ) # async connection
    ```

Usage of connection:

    ```python
    with connection.cursor() as cursor:
        cursor.execute("SELECT id, val FROM table")

        row = cursor.fetchone()
        rows = cursor.fetchmany(size=5)
        rows = cursor.fetchall()
    ```

Usage of async connection:

    ```python
    async with async_connection.cursor() as cursor:
        await cursor.execute("SELECT id, val FROM table")

        row = await cursor.fetchone()
        rows = await cursor.fetchmany(size=5)
        rows = await cursor.fetchall()
    ```

