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
File details
Details for the file rod.recipe.appengine-1.3.0.tar.gz
.
File metadata
- Download URL: rod.recipe.appengine-1.3.0.tar.gz
- Upload date:
- Size: 12.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | a6fb445a30acb98bb941d1f097115d72af2c968016501e8ea273e33cb7d6565c |
|
MD5 | 8bb3301c54a2e4e3d91c9696f03241a4 |
|
BLAKE2b-256 | ad8b49697aafc43c7fff2b92bd0cacbe84655d379920380b51c3e700cf53f952 |
File details
Details for the file rod.recipe.appengine-1.3.0-py2.5.egg
.
File metadata
- Download URL: rod.recipe.appengine-1.3.0-py2.5.egg
- Upload date:
- Size: 18.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 03db461f8fa162771ac8b34023c89a686dfebec8ae2c8c9a17d5e6c126f9ac92 |
|
MD5 | 8ef490d4725ac85b3b2814ad952561e3 |
|
BLAKE2b-256 | 4a415f55d5ab7a341a70d51bd54895574411aedfd954e970e85207749e34b437 |