django-rest-assured 0.2.1

As easy as

class CategoryTestCase(ReadWriteRESTAPITestCaseMixin, BaseRESTAPITestCase):

    base_name = 'category'
    factory_class = CategoryFactory
    create_data = {'name': 'comedy'}
    update_data = {'name': 'horror'}

Django-REST-Assured is designed to work with factory_boy for mocking objects to test against. However, you can easily extend the BaseRESTAPITestCase to work directly with Django Models or any other factory.

Main features

• Class-based declarative API for creating tests.

• Covers the stack through: route > view > serializer > model.

• Uses Django REST Framework’s conventions to minimize configuration.

• All tests return the response object for more extensive assertions.

• Automatic mocking of authentication if a user factory is provided.

Usage

The basic form of usage is simply to create a class that extends any mixin from rest_assured.testcases, according to the endpoints you wish to cover, and the BaseRESTAPITestCase class.

Then just set the required attributes, and continue extending it from there.

If your API requires authentication and/or authorization just add a user factory class. Assuming you use factory_boy:

Supports

Tests run against:

• Django 1.6, 1.7, 1.8 & 1.9.

• Django REST Framework 2.4.3, 2.4.4, 3.0, 3.1, 3.2 & 3.3.

• Python 2.7, 3.3, 3.4 & 3.5 (3.2 should work but is not tested).

Installation

PyPI: https://pypi.python.org/pypi/django-rest-assured

$ pip install django-rest-assured

Source: https://github.com/ydaniv/django-rest-assured

$ git clone https://github.com/ydaniv/django-rest-assured
$ python setup.py install

Contributing

Issues are tracked in the github repository.

Pull requests are welcome!

Running tests

$ pip install pytest pytest-django
$ py.test

License

Django-REST-Assured is distributed under the BSD license.