Metadata-Version: 1.1
Name: Couchapp
Version: 1.0.1
Summary: Standalone CouchDB Application Development Made Simple.
Home-page: http://github.com/couchapp/couchapp/tree/master
Author: Benoit Chesneau
Author-email: benoitc@e-engura.org
License: Apache License 2
Description: CouchApp: Standalone CouchDB Application Development Made Simple
        ================================================================
        .. image:: https://travis-ci.org/couchapp/couchapp.png?branch=master
           :target: https://travis-ci.org/couchapp/couchapp
        
        .. image:: https://coveralls.io/repos/couchapp/couchapp/badge.png
          :target: https://coveralls.io/r/couchapp/couchapp
        
        CouchApp is designed to structure standalone CouchDB application
        development for maximum application portability.
        
        CouchApp is a set of scripts and a `jQuery <http://jquery.com>`_ plugin
        designed  to bring clarity and order to the freedom of
        `CouchDB <http://couchdb.apache.org>`_'s document-based approach.
        
        Also, be sure to checkout our Erlang-based sibling,
        `erica <https://github.com/benoitc/erica>`_.
        
        Write apps using just JavaScript and HTML
        -----------------------------------------
        
        Render HTML documents using JavaScript templates run by CouchDB. You'll
        get parallelism and cacheability, **using only HTML and JS.** Building
        standalone CouchDB applications according to correct principles affords
        you options not found on other platforms.
        
        Deploy your apps to the client
        ++++++++++++++++++++++++++++++
        
        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.
        
        Installation
        ------------
        
        Couchapp requires Python 2.5x 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://bitbucket.org/pypa/setuptools/raw/bootstrap/ez_setup.py
            $ sudo python ez_setup.py
            $ curl -O https://raw.github.com/pypa/pip/master/contrib/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 beafore each command
        line.
        
        Note: on debian system don't forget to install python-dev.
        
        To install on windows follow instructions `here
        <http://www.couchapp.org/page/windows-python-installers>`_.
        
        More installion options on the `website
        <http://www.couchapp.org/page/installing>`_.
        
        Getting started
        ---------------
        
        Read the `tutorial <http://www.couchapp.org/page/getting-started>`_.
        
        Testing
        -------
        
        We use `nose <http://nose.readthedocs.org/>`_. and
        `nose-testconfig <https://pypi.python.org/pypi/nose-testconfig>`_. for setting
        up and running tests.
        
        In the ``tests`` directory, copy ``config.sample.ini`` to ``config.ini``, tweak
        the settings, and then run the tests from the main ``couchapp`` directory (as
        the paths below are relative to that):
        
            $ nosetests --tc-file=tests/config.ini
        
        If you're wanting to generate code coverage reports (because you've got big
        plans to make our tests better!), you can do so with this command instead:
        
            $ nosetests --with-coverage --cover-package=couchapp --cover-html --tc-file=tests/config.ini
        
        Thanks for testing ``couchapp``!
        
        Other resources
        ---------------
        
        * `Couchapp website <http://couchapp.org>`_
        * `Frequently Asked Questions <http://couchapp.org/page/faq>`_
        * `couchapp command line usage <http://couchapp.org/page/couchapp-usage>`_
        * `Extend couchapp command line <http://couchapp.org/page/couchapp-extend>`_
        * `List of CouchApps <http://couchapp.org/page/list-of-couchapps>`_
        
        
Keywords: couchdb couchapp
Platform: any
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Operating System :: OS Independent
Classifier: Topic :: Database
Classifier: Topic :: Utilities
