- Django 1.2.1
- py.test 1.3.2
Changes between orginal and this fork
The original pytest_django module didn't work for me. It was written for django 1.1 and is probably not completely compatible with django 1.2.1.
This fork uses django's TestSuite and TestCase to setup the test database and environment instead of implementing the database setup code in the py.test plugin. As a result some command line options have been removed:
$ python setup.py install
Then simply create a
conftest.py file in the root of your Django project
pytest_plugins = ['django']
Run py.test in the root directory of your Django project:
This will attempt to import the Django settings and run any tests.
Note that the default py.test collector is used, as well as any file within a
tests directory. As such, so it will not honour
INSTALLED_APPS. You must use
collect_ignore in a
conftest.py file to exclude any tests you don't want
to be run.
See py.test's documentation for more information,
including usage of the
-k option for selecting specific tests.
--settings option is provided for explicitly setting a settings module,
pytest_django makes py.test's built in unittest support fully backwards compatible with Django's unittest test cases. If they are failing, this is a bug.
The session start/finish and setup/teardown hooks act like Django's
management command and unittest test cases. This includes creating the test
database and maintaining a constant test environment, amongst other things.
A Django test client instance.
def test_something(client): assert 'Success!' in client.get('/path/')
An instance of Simon Willison's excellent RequestFactory.
A Django settings object that restores itself after the tests have run, making it safe to modify for testing purposes.
def test_middleware(settings, client): settings.MIDDLEWARE_CLASSES = ('app.middleware.SomeMiddleware',) assert 'Middleware works!' in client.get('/')
A decorator to make parametrised tests easy. Takes a list of dictionaries of keyword arguments for the function. A test is created for each dictionary.
@py.test.params([dict(a=1, b=2), dict(a=3, b=3), dict(a=5, b=4)]) def test_equals(a, b): assert a == b
Provides the ability to change the URLconf for this test, similar to the
urls attribute on Django's
@py.test.urls('myapp.test_urls') def test_something(client): assert 'Success!' in client.get('/some_path/')
Fixtures can be loaded with
py.test.load_fixture(name). For example:
def pytest_funcarg__articles(request): py.test.load_fixture('test_articles') return Article.objects.all()