Skip to main content

Django GAE tasks improves upon App Engine's Deferred library and is forked from FreshPlanet's project.

Project description

This is forked from FreshPlanet’s improved App Engine Deferred module. and has the added functionality of having a Django View along with the webapp2 handler so that it can be used in either project type.

The AppEngine Python SDK has a great module when it comes to easily run some code “later”: the deferred library (if you are unfamiliar with this library, please have a look at its documentation first).

However the library has a few drawbacks that we solve here:

  • No asynchronous method (issue 9530)

  • The internal request handler inherits from webapp instead of webapp2 which can be an issue when using some webapp2 features (like webapp2.get_request)

  • It uses pickle instead of leveraging cPickle available with the Python 2.7 runtime.

  • The Route it uses is internal and will skip your middlewares unless you define them in a special module.

  • Task could fail to properly execute when hitting a fresh instance which did not had all code loaded

  • Logging is a bit verbose: it uses the INFO level to show task headers that are redundant with what we can see by default in the AppEngine logs

We also added a couple of features to it:

  • Explicit URLs for tasks: instead of just seeing /_ah/queue/deferred in your logs you will see something like /_cb/deferred/

  • Possibility to spread tasks over several queues in case of high throughput

  • Improved logging in case of error

  • Possibility to tie it to a background module to optimize serving requests

And some helpers: - is_from_task_queue(): Check if we are currently running from a task queue - get_retry_count(): Returns the current number of times the current task is being retried - log_as_retried(): Depending on # of times the task is being retried, we will increase the logging level.

Our module still makes use of the deferred exceptions types `SingularTaskFailure` and `PermanentTaskFailure` to be compatible with existing code.


  1. pip install fh-django-gae-tasks

  2. Load the app in your Django project’s

  1. Load the URL for the app

urlpatterns = [
    url(r'^', include('gae_tasks.urls')),
  1. Optionally, better integrate with your application by updating the tasks settings:


(See the tasks module for more details)

Project details

Download files

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

Source Distribution

fh-django-gae-tasks-0.2.4.tar.gz (6.8 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page