Skip to main content

Google App Engine project bootstrap

Project description

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

create virtualenv

> 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. Keep your code inside src/app (see wiki::Pip support <https://github.com/czervenka/gap/wiki/Pip-support> for details).
  11. Libraries installed using gip are accessible in dev_server as well as on GAE servers.

See Gap wiki page 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.

Changes

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for gap, version 0.4.4
Filename, size File type Python version Upload date Hashes
Filename, size gap-0.4.4.tar.gz (22.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page