skip to navigation
skip to content

Not Logged In

django-juno-testrunner 0.2.4

A more useful (and slightly more glamorous) test runner for Django 1.6+ from the folks at YunoJuno

This is a drop-in test-runner alternative for Django 1.6+ which takes DiscoverRunner and adds the following:

  • Generates a file with all failed or errored test output for inspection later
  • Generates a file listing the dot-separated paths of all failed or errored tests to make it easy to re-run just the failed ones
  • Displays a countdown of tests as they run, showing each test's number out of the total
  • Displays the elapsed time so far and a (rough) estimate of how long the remaining tests will take
  • Colourised output to make it easier to grok how your test run is going. (Plus, it's prettier.)

The Python package you get, if you're interested, is called junorunner. That's because it came from the YunoJuno codebase, and we'd put all of our pun skills into copy for the site, so we played it safe this time.

Installation

  1. Recommended installation is via pip, inside a virtualenv.

To get it from PyPi et al:

$ pip install django-juno-testrunner

If you want the bleeding-edge version from GitHub:

$ pip install -e git+ssh://git@github.com/YunoJuno/django-juno-testrunner.git#egg=django-juno-testrunner

Downloading the package's source and installing it yourself is also an option.

Once downloaded, run:

$ python setup.py

But you knew that already, yep?

django-juno-testrunner has one automatically installed dependency, the delightful colorama.

  1. Update your settings.py to use this test runner:

    TEST_RUNNER = 'junorunner.testrunner.TestSuiteRunner'
    
  2. Set some options, if you want.

By default, junorunner will show you test errors and failures as they happen, inline in the test output, so you can ponder them while waiting for the rest of the suite to run. You can disable this, of course:

TEST_RUNNER_IMMEDIATELY_SHOW_FAILS = False

Also by default, junorunner puts the traceback from all test failures and errors in a file called 'test_failures.txt' in the project root. Alongside that is a file with the name of each failed test in full dot-separated syntax, one test per line, to make it easier to re-run just your failed tests (more on that later). If you don't like the default names, go to town with your own choices:

TEST_RUNNER_RERUN_LOG_FILE_NAME = 'must_try_harder.txt'
TEST_RUNNER_FAILURE_LIST_FILENAME = 'post_mortem.txt'

That's it.

Usage

Running tests

junorunner will replace the default Django 1.6+ DiscoverRunner so run your tests as 'normal', whether that's via a straight ./manage.py test or Fabric or some big red button and an Arduino, as long as manage.py test is ultimately called, it's all good.

You'll get the most informative in-flight output with --verbosity=2.

When your test run is over, you'll get the usual detailed failure and error output, if any, plus there'll be the failures list (default name test_failures.txt) and the rerun log (test_rerun.txt) in your project directory. If all your tests passed, these files will still exist, but will be empty.

Note that as soon as you start a new test run (even if you then Ctrl-C it to death or use an axe to cut the power cable), the contents of those files will be immediately zapped.

Using the rerun log

If you're not sure how to to pump the dot-separated failed tests back into the test client, you can do this way:

$ ./manage.py test $(cat test_rerun.txt)  # POSIX

or

$ ./manage.py test $(< test_rerun.txt)  # bash

(At YunoJuno, we run our test suites via Fabric, with a :rerun option that reads in the file and passes each line — i.e. each bad test — as an extra arg to the test client.)

Roadmap

  • improve time-left-to-run estimate
  • support use on < Django 1.6 (the code exists in another repo's history, it just needs some dusting off)

Contributing

Contributions and bug reports are welcome. Pull requests adding jazzy new features are even more welcome

 
File Type Py Version Uploaded on Size
django-juno-testrunner-0.2.4.tar.gz (md5) Source 2014-01-16 7KB
  • Downloads (All Versions):
  • 35 downloads in the last day
  • 159 downloads in the last week
  • 689 downloads in the last month