Overview

agar

Agar is a set of utilities for Google App Engine python, , created as part of the Substrate Project.

Requirements

Agar requires the Google App Engine SDK, webapp2, webapp2_extras, pytz, restler, and basin. Versions of these (except the Google App Engine SDK) are located in the lib directory.

Installation

To install Agar, download the source and add the agar directory to your Google App Engine project. It must be on your path.

Tests

Agar comes with a set of tests. Running Agar's tests requires unittest2 and WebTest (included in the lib directory). To run them, execute:

$ ./run_tests.py

Testing

Google App Engine now includes testbed to make local unit testing easier. This obsoletes the now-unsupported GAE TestBed library. However, it had several useful helper functions, many of which have been re-implemented in Agar. To use them, you must use unittest2 and inherit from agar.tests.BaseTest or agar.tests.WebTest.

License

Agar is licensed under the MIT License. See LICENSE.txt for details.

Contributing

To contribute to the Agar project, fork the repository, make your changes, and submit a pull request.