Google App Engine base project
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
doc
gap
test
tmp
.gitignore
LICENSE
MANIFEST.in
README
README.rst
changes.rst
requirements.gip
setup.py

README.rst

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
  2. Create a virtualenv 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) 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 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: