ZC Buildout recipe for setting up a google appengine development environment
Project description
Buildout recipe for setting up a google appengine development environment.
The rod.recipe.appengine is a zc.buildout recipe to build, test and deploy projects for the google appengine. It makes it easy to use eggs and resolve their dependencies automatically.
To be honest, this is a recipe for scrambled eggs. It produces a zip file containing all configured external packages in a traditional folder hierarchy.
A brief documentation
This recipe takes a number of options:
- appengine-lib
Path to an already installed appengine library
- eggs
List of required eggs
- exclude
A list of basenames to be excluded when setting up the application files, e.g. the whole ‘tests’ directory.
- packages
A list of packages to be included into the zip archive, which will be uploaded to the appspot.
- src
The directory which contains the project source files.
- url
The url for fetching the google appengine distribution
- zip-name
The name of the zip archive containing all external packages ready to deploy.
- zip-packages
Flag whether external packages shall be zipped in single zip file. (Default=True)
Tests
We will define a buildout template used by the recipe:
>>> buildout_template = """ ... [buildout] ... develop = %(egg_src)s ... parts = sample ... ... [sample] ... recipe = rod.recipe.appengine ... eggs = foo.bar ... exclude = tests ... url = http://googleappengine.googlecode.com/files/google_appengine_1.2.3.zip ... """
We’ll start by creating a buildout:
>>> import os.path >>> import rod.recipe.appengine.tests as tests >>> egg_src = os.path.join(os.path.split(tests.__file__)[0], 'foo.bar') >>> write('buildout.cfg', buildout_template % {'egg_src': egg_src})
Running the buildout gives us:
>>> output = system(buildout) >>> if output.endswith("Google App Engine distribution...\n"): True ... else: print output True
And now we try to run the appserver script:
>>> print system(os.path.join('bin', 'sample')) <BLANKLINE> ... Invalid arguments <BLANKLINE>
There should be a configuration script in bin as well:
>>> print system(os.path.join('bin', 'appcfg')) Usage: appcfg [options] <action> <BLANKLINE> ... <BLANKLINE>
Let’s see if the ‘tests’ directory has been excluded:
>>> l = os.listdir(os.sep.join(['parts', 'sample', 'foo', 'bar'])) >>> assert 'tests' not in l
Changes
1.3.0 2009-07-04
Added options zip-packages and exclude.
1.2.1 2009-07-03
Uses a much better method for excluding optional c extensions and compiled modules.
A step forward in platform independence.
1.2.0 2009-06-24
Creates appcfg script.
1.1.1 2009-06-07
Makes symbolic links for application files.
Downloads stay untouched.
1.1.0 2009-04-08
Mostly rewritten.
Installs google appengine as part.
Adding dummy pkg_resources module to handle namespace package relicts.
Tests added.
Ready for Google App Engine SDK 1.2.0
1.0.0b5 2009-01-20
Requires Google App Engine SDK 1.1.8
1.0.0b4 2008-09-04
Create and use PROJECT_HOME/var to place temporary project files like data base files.
1.0.0b3 2008-09-02
Copy package contents to temporary library directory.
1.0.0b2 2008-09-02
Installs the whole distribution in the parts directory now. So it is ready to test and deploy.
1.0.0b1 2008-09-01
First beta release.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for rod.recipe.appengine-1.3.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | a6fb445a30acb98bb941d1f097115d72af2c968016501e8ea273e33cb7d6565c |
|
MD5 | 8bb3301c54a2e4e3d91c9696f03241a4 |
|
BLAKE2b-256 | ad8b49697aafc43c7fff2b92bd0cacbe84655d379920380b51c3e700cf53f952 |
Hashes for rod.recipe.appengine-1.3.0-py2.5.egg
Algorithm | Hash digest | |
---|---|---|
SHA256 | 03db461f8fa162771ac8b34023c89a686dfebec8ae2c8c9a17d5e6c126f9ac92 |
|
MD5 | 8ef490d4725ac85b3b2814ad952561e3 |
|
BLAKE2b-256 | 4a415f55d5ab7a341a70d51bd54895574411aedfd954e970e85207749e34b437 |