gap 0.4.9.1
Google App Engine project bootstrap
License: Apache License 2.0

GAP
###

Google App Engine is excellent technology but there is a gap.

If you are missing

-  use of pip with Google App Engine,
-  cooperation of appengine and virtualenv,
-  possibility to add any module to your python path,

then this barebone could be at least an inspiration for you.

How to use (fill) the gap?
==========================

Short version
-------------

::

    > workon <myvirtualenv>
    > pip install gap
    > gap start-project <applicationid>
    > cd <applicationid>
    > appcfg update src

Long version
------------

1.   Install
     `Google Appengine SDK <https://developers.google.com/appengine/downloads>`__
2.   Create a `virtualenv <http://www.virtualenv.org/en/latest/>`__ for you project
3.   if necessary ``easy_install pip``
4.   run ``pip install gap``
5.   Go to directory where you want to create your GAE project.
6.   run ``gap start-project <projectname>``  # <projectname> will be used as applicationId
7.   Add your dependencies to requirements.gip (format is the same as pip
     `requirements file <http://www.pip-installer.org/en/latest/cookbook.html>`__) and
     run ``bin/gip install -r requirements.gip``
8.   or install any packages using bin/gip same way as you are used to do it
     with pip.
9.   To create a new module in your application run ``gap start-app <module_name>``
10.  Libraries installed using gip are accessible in dev_server as well as on GAE servers.

See `Gap documentation on github <https://github.com/czervenka/gap/blob/master/doc/index.rst>`__ for more
informations.

Any ideas, thoughts, fixes (specially corrections of my English :) are
welcome!

Disclaimer
==========

Of course ... This code is published in hope that someone will find it
useful but it is provided as-is and I can take no responsibility for
improper as well as proper use.

See also
========
Enhance GAP with plugins and addons:

- `GAP Resources <https://github.com/fragaria/gap-resources>`__
- `GAP Angular <https://github.com/fragaria/gap-angular>`__
- `GAP Datastore Admin <https://github.com/fragaria/gap-datastoreadmin>`__



Changes
=======
Version 0.4.9
-------------
- gip
  1. some packages caused gip not to work properly
  2. ``-v`` option shows a lot of debug informations
- minor fixes in documentation
- invalid import in new poject's views.py

Version 0.4.8
-------------
- mainly enhancements in test suite
  1. executable flag on run_test
  2. added base class for testing views
  3. support for rednose in tests (rednose seems not compatible with multiprocess plugin)
  4. Test* classes not imported in utils.__init__ (forced test requirements even when running gap project)
  5. test requirements ignored by gip (not usefull on production)
- fixed link in changelog
- extended Route class which can better handle ending slash

Version 0.4.7
-------------
- documentation (see `doc/index.rst` or on `github <https://github.com/czervenka/gap/blob/master/doc/index.rst>`__)

Version 0.4.3, 0.4.5
--------------------
- fixed missing README.rst in MANIFEST.in (sorry)
- changes added to package description

Version 0.4
-----------

-  tests in project template (application tests)
-  bin/ipython in project runs ipython (if installed) with gae testbed
   stubs
-  new apps have model template file now
-  better template loaders to allow install 3rd party modules
-  default 404 page now shows list of routes
-  gap tests can be run from setup.py test
-  settings can have defaults in config.py (refer to project's
   config.py:DEFAULT\_SETTINGS)

Version 0.3
-----------

-  added some tests
-  added baseTest classes (many thanks to Lukas Lukovsky)
-  added gap.conf.settings (highly cached db stored settings)
-  minor fixes in setup.py

Version 0.2
-----------

Major rewrite to enable installation using pip and project creation a-la
django.

-  first version of setup.py

Version 0.1
-----------

Never released