Metadata-Version: 2.1
Name: asyncpgx
Version: 1.1.5
Summary: User-friendly extensions for asyncpg
Home-page: https://github.com/laukhin/asyncpgx
License: Apache-2.0
Keywords: postgresql,asyncio,asyncpg
Author: Vladislav Laukhin
Author-email: laukhin97@gmail.com
Requires-Python: >=3.6,<=3.10
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Provides-Extra: format
Requires-Dist: asyncpg (>=0.21,<0.26)
Project-URL: Documentation, https://laukhin.github.io/asyncpgx/index.html
Project-URL: Repository, https://github.com/laukhin/asyncpgx
Description-Content-Type: text/markdown

# asyncpgx
[![Build passed](https://img.shields.io/github/workflow/status/laukhin/asyncpgx/CI)](https://github.com/laukhin/asyncpgx/actions?query=workflow%3ACI)
[![Test coverage](https://img.shields.io/codecov/c/github/laukhin/asyncpgx)](https://codecov.io/gh/laukhin/asyncpgx)
[![Version](https://img.shields.io/pypi/v/asyncpgx)](https://pypi.org/project/asyncpgx/)

Extensions for asyncpg.

Based on the [asyncpg](https://github.com/MagicStack/asyncpg) and highly inspired by the [sqlx](https://github.com/jmoiron/sqlx) package

This package supports 3.6+ python versions

## Setup
Use `pip install asyncpgx`

## Purpose
This is a thin wrapper on the `asyncpg` package.
Our purpose is to provide convenient extensions to the original package.
We're trying to delegate as much work as we can to the asyncpg (basically our extension methods are high-level proxies to the underlying ones)
and make only converting job.
Original asyncpg API stays the same, you can see it in the [asyncpg documentation](https://magicstack.github.io/asyncpg/current/).

## Functionality
* queries with named parameters, i.e.
```python
import asyncpgx

connection = await asyncpgx.connect('postgresql://127.0.0.1:5432')
await connection.named_fetch('''SELECT field FROM some_table WHERE id <= :id;''', {'id': 1})
```
* prepared statements with named parameters, i.e.
```python
import asyncpgx

connection = await asyncpgx.connect('postgresql://127.0.0.1:5432')
prepared_statement = await connection.named_prepare('''SELECT field FROM some_table WHERE id <= :id;''')
await prepared_statement.named_fetch({'id': 1})
```

## Documentation
You can find project documentation [here](https://laukhin.github.io/asyncpgx/index.html)

## Changelog
You can find all releases description [here](https://github.com/laukhin/asyncpgx/releases)

