Files in the top-level directory in any check-in

===========
gaedeferred
===========

What's this
===========

gaedeferred attempts to make deferred chain on Google Appengine. The design of
the deferred chain is inspired by Twisted. Because of no support for callback
and errback on taskqueue.

How to use
==========

First of all, please ensure that the google library exists on sys.path. Then
follow bellow steps::

    >>> from google.appengine.ext import deferred
    >>> from gaedeferred import Deferred

    Setup test environment. (These steps are meanless for actual use, just for doctest)
    >>> import sys
    >>> sys.path.insert(0, '.')
    >>> from tests.test_deferred import value, increase, must_be
    >>> from tests.conftest import mimic_defer
    >>> deferred.defer = mimic_defer

    >>> d = Deferred()
    >>> d.addCallback(increase, 10)

    An alias exists for addCallback
    >>> d.next(must_be, 15)

    The deferred to be executed on an asynchronous task.
    >>> deferred.defer(d.callback, 5)

How to test
===========

Like this.::

  $ py.test --appengine=${your appengine path} --doctest-glob='\*.txt'

Or::

  $ export APPENGINE_PATH=${your appengine path}
  $ py.test --doctest-glob='\*.txt'

Dependencies
============

* py.test
  It is used for testing.

To do
=====

* deferred list

Questions and Bug Reports
=========================

* Site
  https://chiselapp.com/user/jbking/repository/gaedeferred/

* Or, cantact me.
  MURAOKA Yusuke <yusuke.muraoka@gmail.com>