Skip to main content

Write Django test requests using curl syntax

Project description

Django test curl


With Django test curl, you can take your test cases and immediately try them against an actual server via the magic of copy-paste!

Django's testing tools come with a great test client you can use to simulate requests against views. Against deployed Django projects, if you want to do simple requests, you would probably use curl. If you want to use the same syntax for both, this is the package for you.

Good places to use this

This was developed to TDD recreating an existing API in Django. If you have a library of curl requests that you need to replicate, this is perfect for that. If you need a portable format to turn test cases into QA automation, this is great for that too.

Bad places to use this

If the .curl(...) syntax requires lots of string formatting, you should stick to the traditional test client. If the test case isn't copy-pastable, it's not a good fit. This also means if you use randomness to generate your requests, you'll lose that extra test coverage.


$ pip install django-test-curl


from django_test_curl import CurlClient

class SimpleTest(TestCase):
    def setUp(self):
        self.client = CurlClient()

    def test_details(self):
        response = self.client.curl("""
          curl http://localhost:8000/customer/details/

        self.assertEqual(response.status_code, 200)

        self.assertEqual(len(response.context['customers']), 5)

If you're using a custom Client, you can use the mixin version:

from django.test import Client
from django_test_curl import CurlClientMixin

class MyClient(CurlClientMixin, Client):

We support a subset of curl's functionality. For a full list and examples, see the tests.

  • Headers
  • HTTP basic auth

Project details

Download files

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

Source Distribution

django-test-curl-0.2.0.tar.gz (7.8 kB view hashes)

Uploaded Source

Built Distribution

django_test_curl-0.2.0-py3-none-any.whl (8.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page