Skip to main content

Write Django test requests using curl syntax

Project description

Django test curl

CI

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.

Installation

$ pip install django-test-curl

Usage

from django_test_curl import CurlClient

class SimpleTest(TestCase):
    """https://docs.djangoproject.com/en/stable/topics/testing/tools/#example"""
    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
  • GET/POST/PUT/DELETE/etc
  • 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 details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

Details for the file django-test-curl-0.2.0.tar.gz.

File metadata

  • Download URL: django-test-curl-0.2.0.tar.gz
  • Upload date:
  • Size: 7.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.7.12

File hashes

Hashes for django-test-curl-0.2.0.tar.gz
Algorithm Hash digest
SHA256 a5fff1933419ed97d91314bddbc9b639d4f34697d9765ffbf8150fa535de35ba
MD5 a49828d5aaf13a6a2311adccb8d5dfb5
BLAKE2b-256 310ef9cebfa079d897a07fa0e4a49991e63017ed31c327ca7b374c8e92f81feb

See more details on using hashes here.

File details

Details for the file django_test_curl-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: django_test_curl-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 8.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.7.12

File hashes

Hashes for django_test_curl-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8f569c15a8a3e7872805ba3b7137975f822835dd6a81fb52238fccc8d0fb8146
MD5 640fa65abaefdac01f7426db7df2c7d4
BLAKE2b-256 2824734a8bc73540a2dc4f33c26292617fa9a24d37d8795cec7837ed036001a8

See more details on using hashes here.

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