<commit_before>==========
py-couchdb
==========

Modern pure python CouchDB Client.

Currently there are several libraries in python to connect to couchdb. **Why one more?** It's very simple. 
All seems not be maintained, all libraries used standard Python libraries for http requests, and are not compatible with python3.

Advantages of py-couchdb
^^^^^^^^^^^^^^^^^^^^^^^^

- Use `requests`_ for http requests (much faster than the standard library)
- Python2 and Python3 compatible with same codebase (with one exception, python view server that uses 2to3)
- Also compatible with pypy.

.. _requests: http://docs.python-requests.org/en/latest/


Example:

.. code-block:: python

    >>> import pycouchdb
    >>> server = pycouchdb.Server("http://admin:admin@localhost:5984/")
    >>> server.info()['version']
    '1.2.1'


Installation
^^^^^^^^^^^^

To install py-couchdb, simply:

.. code-block:: console

    pip install pycouchdb

Test
^^^^
To test py-couchdb, simply run:

.. code-block:: console

   python tests.py
 
This command assumes a couchdb account with username "admin" and
password "<PASSWORD>". Otherwise change "SERVER_URL" in tests.py.


.. image:: https://d2weczhvl823v0.cloudfront.net/niwibe/py-couchdb/trend.png
   :alt: Bitdeli badge
   :target: https://bitdeli.com/free

<commit_msg>Add badges to readme.<commit_after>==========
py-couchdb
==========

.. image:: https://img.shields.io/travis/niwibe/py-couchdb.svg?style=flat
    :target: https://travis-ci.org/niwibe/py-couchdb

.. image:: https://img.shields.io/pypi/v/py-couchdb.svg?style=flat
    :target: https://pypi.python.org/pypi/py-couchdb

.. image:: https://img.shields.io/pypi/dm/py-couchdb.svg?style=flat
    :target: https://pypi.python.org/pypi/py-couchdb


Modern pure python CouchDB Client.

Currently there are several libraries in python to connect to couchdb. **Why one more?** It's very simple. 
All seems not be maintained, all libraries used standard Python libraries for http requests, and are not compatible with python3.

Advantages of py-couchdb
^^^^^^^^^^^^^^^^^^^^^^^^

- Use `requests`_ for http requests (much faster than the standard library)
- Python2 and Python3 compatible with same codebase (with one exception, python view server that uses 2to3)
- Also compatible with pypy.

.. _requests: http://docs.python-requests.org/en/latest/


Example:

.. code-block:: python

    >>> import pycouchdb
    >>> server = pycouchdb.Server("http://admin:admin@localhost:5984/")
    >>> server.info()['version']
    '1.2.1'


Installation
^^^^^^^^^^^^

To install py-couchdb, simply:

.. code-block:: console

    pip install pycouchdb

Test
^^^^
To test py-couchdb, simply run:

.. code-block:: console

   python tests.py

{'fraction_non_alphanumeric': 0.1559633027522936, 'fraction_numerical': 0.010642201834862385, 'mean_word_length': 3.9384057971014492, 'pattern_counts': {'":': 0, '<': 4, '<?xml version=': 0, '>': 22, 'https://': 8, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6359270', 'n_tokens_mistral': 905, 'n_tokens_neox': 863, 'n_words': 257}