Skip to content
A pyVows extension for test Django projects.
Python Makefile HTML
Latest commit 4b29266 Jul 20, 2015 @rafaelcaricio Merge pull request #13 from rafaelcaricio/django-1.8-support
Django 1.8 support / Project revamp


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


Something went wrong with that request. Please try again.