Install

pip install pytest-beds

After that the plugin is enabled by default. You can use specific fixtures (see below) to activate the Testbed and stub specific services.

Options

--no-gae

Disable the plugin, esp. do not change the python paths and try to import dev_appserver.

--sdk-path PATH

The plugin assumes it can just import dev_apserver. If that fails it looks up the SDK path in the environment variable GAE. Otherwise, you can specify the path to the SDK by using the --sdk-path PATH option.

--project-root PATH

Secondly, the plugin assume that your current path is the projects root folder, t.i. the dirctory which holds the app.yaml. You can specify a different path using --project-root PATH.

--noisy-tasklets

By default the plugin shortens the tracebacks when using ndb tasklets, so they don’t include the eventloop’s internal noise. Use this switch to make ndb noisy again.

Fixtures

The plugin provides fixtures to stub the different services. Usage is therefore simple and straightforward:

# Say, if you create a Foo you hit the database and put some work on queue
def test_foo(ndb, taskqueue):
    foo = Foo.create()

    assert Foo.query().fetch() == [foo]

List of builtin fixtures:

bed
mailer
channel
urlfetch
memcache
taskqueue
blobstore
ndb
users

def test_work(deferreds):
    deferred.defer(work, 'to be done')

    deferreds.consume()

    assert 'work has been done'