Skip to main content

Asynchronous client for CouchDB

Project description


Logo Documentation Status Python package PyPI version


This is simple asynchronous python CouchDB client that works with aiohttp, httpx and able to be adopted easily to any other http client.


  • = Python 3.7

Allowed http client

How to install

pip install async-couch

Get Started

   import asyncio

   from async_couch import get_couch_client
   from async_couch.http_clients import HttpxCouchClient

   async def example(client, doc_id: str):
      await client.db_create('test_index')
      await client.doc_create_or_update('test_index', doc_id, dict(val=1))

      response = await client.doc_get('test_index', response.model._id)
      assert response.model._id == doc_id

      await client.attachment_upload(
         'test_index', response.model._id, 'attachment_name', 'text/plain', b'\0')

   if __name__ == '__main__':
      loop = asyncio.get_event_loop()
      client = get_couch_client(request_adapter=HttpxCouchClient)

      loop.run_until_complete(example(client, 'document_name'))


  • Rest endpoints
  • Aiohttp adapter

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

async-couch-0.1a15.tar.gz (14.5 kB view hashes)

Uploaded source

Built Distribution

async_couch-0.1a15-py3-none-any.whl (21.0 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page