<commit_before>Discover Road Runner
====================

*Running tests should be a fun voyage of learning and discovery*


Another test runner?
--------------------

Yes. Why?

*   Maxim: Productivity
*   Maxim: App-based breakdown
*   Maxim: Multiprocessing by default

Features:

*   Traffic-light red / yellow / green feedback
*   Cyan for fast repro strings - if you can't reproduce it, you can't fix it
*   Full stack trace as soon as that error occurs, without `--verbosity=2`
*   MARS: Minimal app reproduction summary, for faster copy/paste test repro
*   `TEST_RUNNER_EXCLUDE_APPS` - setting to exclude problematic apps
    such as third party apps that don't play nice, or slow / god apps, e.g. ::

        TEST_RUNNER_EXCLUDE_APPS = (
            # Would like it if this ran faster,
            # trust the authors to get it right
            'django.contrib.auth',
        )

But please feel free to check out other awesome test runners:

* tox
* nose
* etc


Getting it
----------

pip install -e git+https://github.com/pzrq/discover-road-runner.git#egg=discover_road_runner


Support
-------

TODO: Add TravisCI integration to validate this all the time?

Tested under OSX, Linux (Ubuntu). YMMV with other platforms.

Python 2.7+, 3.4+
Django 1.6.10+

Please feel free to open issues or contribute back patches via GitHub
`pull requests <https://help.github.com/articles/creating-a-pull-request/>`_.


Known issues
------------

* Doesn't work nicely with coverage
* Doesn't work nicely with PyCharm's unit test runner
* Doesn't support fuzzy matching like tox does
* `./manage.py test typo` shouldn't print in nice green...<commit_msg>Explain installing it so others shouldn't need to trawl through my settings.py file.<commit_after>Discover Road Runner
====================

*Running tests should be a fun voyage of learning and discovery*


Another test runner?
--------------------

Yes. Why?

*   Maxim: Productivity
*   Maxim: App-based breakdown
*   Maxim: Multiprocessing by default

Features:

*   Traffic-light red / yellow / green feedback
*   Cyan for fast repro strings - if you can't reproduce it, you can't fix it
*   Full stack trace as soon as that error occurs, without `--verbosity=2`
*   MARS: Minimal app reproduction summary, for faster copy/paste test repro
*   `TEST_RUNNER_EXCLUDE_APPS` - setting to exclude problematic apps
    such as third party apps that don't play nice, or slow / god apps, e.g. ::

        TEST_RUNNER_EXCLUDE_APPS = (
            # Would like it if this ran faster,
            # trust the authors to get it right
            'django.contrib.auth',
        )

But please feel free to check out other awesome test runners:

* tox
* nose
* etc


Getting it
----------

pip install -e git+https://github.com/pzrq/discover-road-runner.git#egg=discover_road_runner

Then in your `settings.py` file::

    TEST_RUNNER = 'discover_road_runner.runners.DiscoverRoadRunner'


Support
-------

TODO: Add TravisCI integration to validate this all the time?

Tested under OSX, Linux (Ubuntu). YMMV with other platforms.

Python 2.7+, 3.4+
Django 1.6.10+

Please feel free to open issues or contribute back patches via GitHub
`pull requests <https://help.github.com/articles/creating-a-pull-request/>`_.


Known issues
------------

* Doesn't work nicely with coverage
* Doesn't work nicely with PyCharm's unit test runner
* Doesn't support fuzzy matching like tox does
* `./manage.py test typo` shouldn't print in nice green...
{'fraction_non_alphanumeric': 0.11468812877263582, 'fraction_numerical': 0.005173900546133947, 'mean_word_length': 3.0371229698375872, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 4, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1936204', 'n_tokens_mistral': 1094, 'n_tokens_neox': 990, 'n_words': 408}