Standalone CouchDB Application Development Made Simple.
CouchApp is designed to structure standalone CouchDB application development for maximum application portability.
Also, be sure to checkout our Erlang-based sibling, erica.
CouchDB’s replication means that programs running locally can still be social. Applications control replication data-flows, so publishing messages and subscribing to other people is easy. Your users will see the benefits of the web without the hassle of requiring always-on connectivity.
Couchapp requires Python 2.6 or greater. Couchapp is most easily installed using the latest versions of the standard python packaging tools, setuptools and pip. They may be installed like so:
$ curl -O https://bootstrap.pypa.io/get-pip.py $ sudo python get-pip.py
Installing couchapp is then simply a matter of:
$ pip install couchapp
On OSX 10.6/10.7 you may need to set ARCH_FLAGS:
$ env ARCHFLAGS="-arch i386 -arch x86_64" pip install couchapp
To install/upgrade a development version of couchapp:
$ pip install -e git+http://github.com/couchapp/couchapp.git#egg=Couchapp
Note: Some installations need to use sudo command before each command line.
Note: On debian system don’t forget to install python-dev.
To install on Windows follow instructions here.
More installation options on the website.
$ python setup.py nosetests
Our nosetests will run with options listed in setup.cfg.
In the tests directory, copy config.sample.ini to config.ini, tweak the settings, and then modify your setup.cfg:
[nosetests] ... tc-file=tests/config.ini
If you’re wanting to examine code coverage reports (because you’ve got big plans to make our tests better!), you can browse around the cover dir
$ cd cover $ python2 -m SimpleHTTPServer
or (if you prefer python3):
$ python3 -m http.server
If you want to debug the failed run with pdb, add the following option to setup.cfg:
[nosetests] ... pdb=1
Thanks for testing couchapp!
We generate the document via sphinx.
First, prepare our building env. We need sphinx:
$ cd docs/ $ pip install sphinx
To build it, just issue:
$ make html
And sphinx will generate static html at docs/_build/html. We can browse the site from this dir already.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.