diff --git a/docs/connect/drivers.md b/docs/connect/drivers.md index 531276fc..8d7c0b0e 100644 --- a/docs/connect/drivers.md +++ b/docs/connect/drivers.md @@ -175,7 +175,8 @@ designed with fibers and concurrency in mind. [aiopg](https://github.com/aio-libs/aiopg) ``` ```{sd-item} -For connecting to CrateDB from Python, supporting Python's `asyncio` (PEP-3156/tulip) framework. +For connecting to CrateDB from Python, supporting Python's async implementations +using the PEP-3156/tulip framework. ``` ```{sd-item} [![](https://img.shields.io/github/v/tag/aio-libs/aiopg?label=latest)](https://github.com/aio-libs/aiopg) @@ -190,7 +191,7 @@ For connecting to CrateDB from Python, supporting Python's `asyncio` (PEP-3156/t [asyncpg](https://github.com/MagicStack/asyncpg) ``` ```{sd-item} -For connecting to CrateDB from Python, supporting Python's `asyncio`. +For connecting to CrateDB from Python, supporting Python's async implementations. ``` ```{sd-item} [![](https://img.shields.io/github/v/tag/MagicStack/asyncpg?label=latest)](https://github.com/MagicStack/asyncpg) @@ -205,7 +206,7 @@ For connecting to CrateDB from Python, supporting Python's `asyncio`. [psycopg3](https://www.psycopg.org/psycopg3/docs/) ``` ```{sd-item} -For connecting to CrateDB from Python, supporting Python's `asyncio`. +For connecting to CrateDB from Python, supporting Python's async implementations. ``` ```{sd-item} [![](https://img.shields.io/github/v/tag/psycopg/psycopg?label=latest)](https://github.com/psycopg/psycopg) @@ -325,6 +326,21 @@ For connecting to CrateDB from Python, using SQLAlchemy. ``` ::: +:::{sd-row} +```{sd-item} Python +``` +```{sd-item} +[CrateDB Async Python driver](https://github.com/surister/cratedb-async) +``` +```{sd-item} +For connecting to CrateDB from Python, supporting Python's async implementations +by using the `httpx` HTTP client. +``` +```{sd-item} +[![](https://img.shields.io/github/v/tag/surister/cratedb-async?label=latest)](https://github.com/surister/cratedb-async) +``` +::: + :::{sd-row} ```{sd-item} Ruby ``` diff --git a/docs/connect/python.rst b/docs/connect/python.rst index 2255691c..7e3e69d4 100644 --- a/docs/connect/python.rst +++ b/docs/connect/python.rst @@ -51,6 +51,29 @@ The package can be installed using ``pip install sqlalchemy-cratedb``. for record in result.all(): print(record) +.. _cratedb-async: + +cratedb-async +------------- + +Asynchronous Python driver for CrateDB based on HTTPX_. +See the full documentation at https://github.com/surister/cratedb-async. +The package can be installed using ``pip install cratedb-async``. + +.. _HTTPX: https://www.python-httpx.org/ + +.. code-block:: python + + import asyncio + from cratedb_async.client import CrateClient + + async def main(): + crate = CrateClient("https://.cratedb.net:4200") + response = await crate.query("SELECT * FROM sys.summits") + print(response.as_table()) + + asyncio.run(main()) + .. _psycopg2: psycopg2 diff --git a/docs/performance/inserts/bulk.rst b/docs/performance/inserts/bulk.rst index 0ce279ea..778f84e4 100644 --- a/docs/performance/inserts/bulk.rst +++ b/docs/performance/inserts/bulk.rst @@ -46,7 +46,7 @@ The rest of this document goes into more detail. :ref:`Best practices: Migrating from MySQL ` - :ref:`Best practices: Migrating from MongoDB ` + :ref:`Best practices: Migrating from MongoDB ` .. _bulk-configure-tables: