Skip to main content

An extension of WebTest with useful extras, including requests-style authentication.

Project description

https://badge.fury.io/py/webtest-plus.png https://travis-ci.org/sloria/webtest-plus.png?branch=master

An extension of WebTest with useful extras, including requests-style authentication.

Install

$ pip install -U webtest-plus

Usage

import unittest
from myapp import app
from webtest_plus import TestApp

class TestMyApp(unittest.TestCase):

    def setUp(self):
        self.app = TestApp(app)

    def test_protected_endpoint(self):
        response = self.app.get("/secret/", expect_errors=True)
        assert response.status_code == 401
        # Requests-style authentication
        response = self.app.get("/secret/", auth=("admin", "passw0rd"))
        assert response.status_code == 200

    def test_more_secrets(self):
        # Another way to authenticate
        self.app.authenticate(username="admin", password="passw0rd")
        assert self.app.get("/secret/").status_code == 200
        self.app.deauthenticate()
        assert self.app.get("/secret/", expect_errors=True).status_code == 401

    def test_posting_json(self):
        # Testing json requests and responses
        response = self.app.post_json("/postsecret/", {"secret": "myprecious"},
                                        auth=("admin", "passw0rd"))
        assert response.request.content_type == "application/json"

    def test_clicking(self):
        response = self.app.get("/")
        response = response.click("Protected link", auth=("admin", "passw0rd"))
        assert response.status_code == 200

    def test_token_auth(self):
        response = self.app.get('/secret-requires-token/', expect_errors=True)
        assert response.status_code == 401

        # Authenticate with JWT
        response = self.app.get('/secret-requires-token',
            auth='yourlongtokenhere', auth_type='jwt')
        assert response.status_code == 200

Features

  • Basic HTTP authentication

  • JSON Web Token authentication

  • Auto-follow redirects

  • Framework-agnostic

Requirements

  • Python >= 2.6 or >= 3.3

License

MIT licensed. See the bundled LICENSE file for more details.

Changelog

1.0.0 (2017-05-17)

  • Fix handling of utf-encoded values when using auth (#3). Thanks @biern for the catch and patch.

  • Drop support for Python 2.6.

  • Test against Python 3.6.

0.3.3 (2015-03-17)

  • Implement TestApp.head.

0.3.2 (2014-06-04)

  • Bug fix that caused an UnboundLocalError.

0.3.1 (2014-05-31)

  • Fix string encoding bug on Python 2.

0.3.0 (2014-05-31)

  • Add support for JSON web token authentication.

0.2.1 (2013-11-24)

  • Add authentication to TestResponse.click and TestResponse.clickbutton.

0.2.0 (2013-10-15)

  • Add support for JSON methods (e.g. app.post_json, etc.)

0.1.0 (2013-10-06)

  • First release.

  • HTTP Basic Authentication working.

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

webtest-plus-1.0.0.tar.gz (8.9 kB view hashes)

Uploaded Source

Built Distribution

webtest_plus-1.0.0-py2.py3-none-any.whl (9.8 kB view hashes)

Uploaded Python 2 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