Skip to main content
Downloads Latest Version License

Instantly test-cover your Django REST Framework based API.

Django-REST-Assured adds another layer on top of Django REST Framework’s APITestCase which allows covering a set of RESTful resource’s endpoints with a single class declaration.

This gives both a quick coverage of sanity tests to your API and a more DRY and more friendly platform for writing additional, more comprehensive tests.

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 login via session or token authentication.

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:

Requirements

  • Django >= 1.6

  • Django REST Framework >= 2.4.3

Currently supporting python 2.7 & 3.4.

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!

License

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-rest-assured-0.0.10.tar.gz (6.2 kB view details)

Uploaded Source

File details

Details for the file django-rest-assured-0.0.10.tar.gz.

File metadata

File hashes

Hashes for django-rest-assured-0.0.10.tar.gz
Algorithm Hash digest
SHA256 dc62d4577f02ab51d832a7f8488280b36f25a0db9d949e2212042f4b5a70915c
MD5 ca1bb69a09cd459b4f663088cbc14f71
BLAKE2b-256 a559bbbccfc926bf1d8d569fb23818f4f09675d0eaaa2b96e9a9e0066ec3e38a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page