Skip to main content

Helpers for creating functional tests in Django, with a unified API for WebTest and Selenium tests.

Project description

https://travis-ci.org/django-functest/django-functest.png?branch=master https://coveralls.io/repos/django-functest/django-functest/badge.svg?branch=master&service=github https://readthedocs.org/projects/pip/badge/?version=latest

Helpers for creating high-level functional tests in Django, with a unified API for WebTest and Selenium tests.

Documentation

The full documentation is at https://django-functest.readthedocs.org.

Installation

pip install django-functest

Features

  • A simplified API for writing functional tests in Django (tests that check the behaviour of entire views, or sets of views, e.g. a checkout process).

  • A unified API that abstracts over both WebTest and Selenium - write two tests at once!

  • Many of the gotchas and difficulties of using WebTest and Selenium ironed out for you.

  • Well tested - as well as its own test suite, which is run against Firefox, Chrome, and PhantomJS, it is also used by Wolf & Badger for tests covering many business critical functionalities.

Typical usage

In your tests.py:

from django.test import LiveServerTestCase, TestCase
from django_functest import FuncWebTestMixin, FuncSeleniumMixin

class ContactTestBase(object):

    def test_contact_form(self):
        self.get_url('contact_form')
        self.fill({'#id_name': 'Joe',
                   '#id_message': 'Hello'})
        self.submit('input[type=submit]')
        self.assertTextPresent("Thanks for your message")

 class ContactWebTest(FuncWebTestMixin, TestCase):
     pass

 class ContactSeleniumTest(FuncSeleniumMixin, LiveServerTestCase):
     pass

In this way, you can write a single test with a high-level API, and run it in two way - using a fast, WSGI-based method with emulates typical HTTP usage of a browser, and using a full browser that actually executes Javascript (if present) etc.

Under the hood, the WSGI-based method uses and builds upon WebTest and django-webtest.

django-functest provides its functionality as mixins, so that you can have your own base class for tests.

Running Tests

To run the tests:

source <YOURVIRTUALENV>/bin/activate
(myenv) $ ./setup.py develop
(myenv) $ ./runtests.py

Or, to run on all environments:

pip install tox
tox

Credits

This library was built by developers at Wolf & Badger, released with the kind permission of that company.

Tools used in rendering this package:

History

0.1.7

  • Fixed performance/reliability issue caused by browsers attempting to retrieve /favicon.ico after visiting emptypage.

0.1.6

  • Fixed bug where elements wouldn’t scroll into view if html height is set to 100%

  • New method get_webdriver_options for customizing WebDriver behaviour.

0.1.5

  • Added get_session_data()

  • Improved reliability of FuncSeleniumMixin.get_literal_url()

  • Allow <select> elements to be set using integers for values.

  • Fixed issues with .value() for radio buttons and text areas

  • Fixed bug with setting radio buttons when there are more than one set of radio buttons in the form.

0.1.4

  • Added support for file uploads

0.1.3

  • Support for filling radio buttons

  • More convenient support for quotes and apostrophes (” ‘) in text assertion methods.

0.1.2

  • Fixed wheel building - again!

0.1.1

  • Fixed packaging bug that caused wheels to fail on Python 3.

0.1.0

  • First release on PyPI.

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-functest-0.1.7.tar.gz (42.1 kB view hashes)

Uploaded Source

Built Distributions

django_functest-0.1.7-py3-none-any.whl (30.7 kB view hashes)

Uploaded Python 3

django_functest-0.1.7-py2-none-any.whl (30.8 kB view hashes)

Uploaded Python 2

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