Skip to main content

A CouchDB driver for Python.

Project description

time2relax: Python CouchDB Driver

A CouchDB driver for Python.

time2relax is a Python CouchDB driver that tries to offer a minimal level of abstraction between you and CouchDB.

To use time2relax:

>>> from time2relax import CouchDB
>>> db = CouchDB('http://localhost:5984/dbname')
>>> db.insert({'title': 'Ziggy Stardust'})
<Response [201]>

Feature Support

Inspired by pouchdb and couchdb-nano APIs, it features:

  • Requests ✨🍰✨ (HTTP for Humans) under the hood.

  • Transparent URL and parameter encoding.

  • HTTP exceptions modelled from CouchDB error codes.

  • Tested on CouchDB 1.6.x and 1.7.x (2.x.x unknown).

time2relax officially supports Python 2.7, 3.3+, and PyPy.


To install time2relax, simply run:

$ pip install -U time2relax


Detailed documentation is available at

How to Contribute

  1. Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.

  2. Fork the repository on GitHub to start making your changes to the master branch (or branch off of it).

  3. Write a test which shows that the bug was fixed or that the feature works as expected.

  4. Send a pull request and bug the maintainer until it gets merged and published. :) Make sure to add yourself to AUTHORS.

time2relax follows the Contributor Covenant code of conduct.

Version History

0.4.1 (2017-11-22)

  • Fix Travis build error - invalid config

0.4.0 (2017-11-21)

  • CouchDBError is now HTTPError (Backwards Incompatible)

  • CouchDB(skip_setup=False) is now CouchDB(create_db=True) (Backwards Incompatible)

  • Add Python 3.6 support.

  • Drop Python 2.6 support - Python 2.6 is no longer supported by the Python core team. (Backwards Incompatible)

0.3.0 (2017-03-03)

  • New time2relax API. (Backwards Incompatible)

  • time2relax is now a thin requests wrapper.

  • New design document functions; list, show, view.

0.2.0 (2016-12-10)

  • Add Python 3.3, 3.4, 3.5 support.

0.1.0 (2016-12-10)

  • First release on PyPI.

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

time2relax-0.4.1.tar.gz (27.6 kB view hashes)

Uploaded source

Built Distribution

time2relax-0.4.1-py2.py3-none-any.whl (11.1 kB view hashes)

Uploaded py2 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