Pinger
======

Sometimes, you need to get your CouchDB views in actual state. The only way is to call each document (one view function per document) in each databases. I called this process - "ping" (this is absolutely new word). 

Pinging CouchDB may be painful without apropriate tool. This tool is pinger (couchdb-curl-pinger in your installation).

Usage
~~~~~
::

  pinger.py [options] url1 ... urlN

  Options:

   -h, --help            show this help message and exit
   -v, --verbose         Be verbose
   -p THREADS, --threads=THREADS
                         Threads count. Defaults to CPU count
   -t TIMEOUT, --timeout=TIMEOUT
                         Script execution timeout


URL may link to:

* Document - and pinger will ping only one document. Example: http://localhost:5984/database/yourdocument

* Database - and pinger will ping whole database. Example: http://localhost:5984/database/

* Server - and pinger will ping all databases on server. Example: http://localhost:5984/

As you see above, you may limit script execution time (to safe use in your cron-scripts, without worry to forkbomb server) and limit concurrency of view requests.



Example
~~~~~~~
::

  couchdb-curl-pinger http://node1:5984/bbb http://node2:5984/bbb

Will ping all document in database bbb on hosts node1 and node2


Another example
~~~~~~~~~~~~~~~
::

  couchdb-curl-pinger -t 30 -p 2 http://node1:5984

Will ping all documents in all databases on server node1 with script execution timeout 30s in 2 concurrent threads.