django-selenium-test-runner 0.1.0

Incorporate functional testing into Django's test subcommand using Selenium web testing tools

  Add it to your Download Basket!

 Add it to your Watch List!


Rate it!
send us
an update
BSD License 
Daniel Mizyrycki
ROOT \ Internet \ HTTP (WWW)
django-selenium-test-runner is a Django plugin that incorporates functional testing into Django's test subcommand using Selenium web testing tools.


This package was made to facilitate and simplify functional testing in Django using Selenium tools.

Selenium tests are code that emulate a user/web browser interaction allowing automatic web server testing. These tests can be created using `selenium-ide`_ and exported as python files for this test runner to use them. Selenium-ide allows to record in real time a user interaction with a web browser, in a similar way as a macro recorder in word processing applications.

`Fixtures`_ are fixed data fed into the database at the beginning of each test run. The idea is that each test run against a consistent predefined state. Fixtures can be created using dumpdata [options] [appname ...]


If you have `setuptools`_ installed, you can simply run the following command::

    sudo easy_install django-selenium-test-runner

If you downloaded the package, you can just unpack it with::

    tar zxvf django-selenium-test-runner-0.1.0.tar.gz

and copy "dstest" directory tree to Python's site-packages directory, which is usually located at:

    /usr/lib/python2.4/site-packages (Unix, Python 2.4)
    /usr/lib/python2.5/site-packages (Unix, Python 2.5)
    /usr/lib/python2.6/dist-packages (Unix, Python 2.6)

django-selenium-test-runner is enabled in the project's with::

    TEST_RUNNER = 'dstest.test_runner.run_tests'


Both, django unittest and selenium tests will be run with the standard command::

  python test [options] [appname ...]

The exported selenium tests will be searched in django_app_dir/tests/selenium/ directories where django_app_dir is an application defined in INSTALLED_APPS. This default can be changed with the setting SELENIUM_TESTS_PATH. Test names start with "test_". As these tests will be imported, please be sure to create django_app_dir/tests/ and django_app_dir/tests/selenium/ files as any python package.

Fixture data is loaded by default from django_app_dir/fixtures/tests/data.json at the beginning of each selenium test. This default can be change using the FIXTURES setting.


There is only one required setting into your project's, assuming django-selenium-test-runner is correctly installed:

TEST_RUNNER = 'dstest.test_runner.run_tests'

optional settings are:

* SELENIUM_TESTS_PATH - Changes default directories to look for Selenium tests within the application directories. (Default: 'tests/selenium')

* FIXTURES - List of fixture files to load within the django_app_dir/fixtures directories. (Default: ['tests/data.json'])

* SELENIUM_PATH - Directory path for Selenium RC jar its python driver (i.e.: selenium-server.jar and (Default: path where django-selenium-test-runner/dstest is installed)

Testing the package:

django-selenium-test-runner comes with its own test suite based on the Django `tutorial`_. It is designed to serve as example in a Django admin application, and showcase django-selenium-test-runner capabilities. To run it, cd into the tests directory of the package and execute::

    python runtests


Most dependencies are integrated in the django-selenium-test-runner package. For now, either Sqlite 3 or Postgres is required as more testing is needed to make it database agnostic.

Included in django-selenium-test-runner package:

* `Selenium RC server and python driver`_. Provide selenium testing engine. Tested with selenium-server.jar and v1.0.1

* `CherryPy WSGI multi-thread web server`_. Provide a reliable web server. Tested with v3.1.2

* `Django`_, by Artem Egorkine. Provide static media handler.

Not included in the package:

* `Python 2.x`_ where x >= 4. Tested with Python v2.6

* `Django 1.x`_. Tested with Django v1.1

* `Java VM command line runner`_. Provide selenium-server.jar dependency. Tested with java openjdk-6-jre.

* `Sqlite 3`. Provided by Python v2.5 or higher.

* `Postgres`_ as a database engine. Provide database replication for fixtures. Tested with Postgres v8.2

* `Python-PostgreSQL database driver`_. Provide access to postgres database. Tested with psycopg2 v2.0.5

Last updated on October 25th, 2009


#selenium testing #Django plugin #test runner #Django #selenium #testing #plugin

Add your review!