Fetching contributors…
Cannot retrieve contributors at this time
52 lines (31 sloc) 2.71 KB


This project is an extension of pyVows to test Django projects. It enables usage of core Django testing tools in a way that is in sync with pyVows workflow mindset.

PyVows is a BDD (Behaviour Driven Development) inspired by Vows for node.js

More documentation about pyVows can be found at the project homepage or for more updated usage check the project tests itself.

Django-PyVows is in sync with the latest Django developments and supports Django 1.8.


There is no need to modify your project to use Django-PyVows. You only have to define where is your project settings module and start calling your project urls in your tests.

from pyvows import Vows, expect

from django_pyvows.context import DjangoContext

class SimpleTestVows(DjangoContext):

    def settings_module(self):
        return 'yourproject.settings'

    def topic(self):
        return self.get('/mygreaturl/')

    def should_be_a_success(self, topic):

    def should_return_the_correct_response(self, topic):

The default settings_module is settings so you should define it accordly based on your PYTHONPATH.

HTTP Client

We support django.test.Client, the methods DjangoContext.get and are actually simple wrappers around it so the usage is the same. The test client is also available in the DjangoContext instance as self.client.


The available assertions in Django-PyVows are the same as in django.test.SimpleTestCase they were adapted to the context of BDD and PyVows.

Settings Override