djtest

djtest

An interactive test runner for Django projects.

Purposes:

• keep the list of apps available for test in a local configuration file
• display the list of all available unit tests (-l option)
• run unit tests for apps specified on command line
• cleanup a test "media folder" before each execution
• optionally filter the list of unit tests to be executed (-f option)

Installation

::

pip install djtest

or:

::

pip install git+https://github.com/morlandi/djtest

Sample usage

::

Using config file "./.djtest.conf"
usage: djtest [-h] [-v {0,1,2,3}] [-m] [-n] [-f FILTER] [-l] [apps [apps ...]]

Targets may specify either: 'all' for all available apps, and app name (one or
more), or a specific test module/method

positional arguments:
  apps

optional arguments:
  -h, --help            show this help message and exit
  -v {0,1,2,3}, --verbosity {0,1,2,3}
                        Verbosity level. (default: 2)
  -m, --no-migrations   Skip migrations. (default: False)
  -n, --dry-run         Don't execute commands, just pretend. (default: False)
  -f FILTER, --filter FILTER
                        Filtering: run only test methods matching specified pattern
                        (multiple patterns separated by ',')
  -l, --list            List available test methods
  --version             show program's version number and exit

Available apps: tasks, wallet_clients, frontend_api, trading_api, backend

Sample config file

A sample "skeleton" config file "./.djtest.conf" is automatically created on first run.

You should edit it to specify the list of testable apps.

::

[general] project=myproject test_settings_module=myproject.settings.test_settings test_settings_no_migrations_module=myproject.settings.test_settings_no_migrations media_folder="../public/test_media/" apps=app1, app2, appN

Sample "test settings" module

::

from myproject.settings.settings import *

LANGUAGE_CODE = 'en'
TIME_ZONE = 'UTC'
EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend'

...

Sample "test settings - no migrations" module

::

from myproject.settings.test_settings import *

class DisableMigrations(object):

    def __contains__(self, item):
        return True

    def __getitem__(self, item):
        #return "notmigrations"
        return None


MIGRATION_MODULES = DisableMigrations()

History

v0.1.9

• ignore media_folder when empty

v0.1.8

• force the stdout and stderr streams to be unbuffered

v0.1.7

• fix --list option when no filter have been specified

v0.1.6

• Accept multiple filters separated by ','
• Improved checks for command line parameters

v0.1.5

• Create sample test settings files
• rename dry_run and deprecations options
• removed dependency on "six"

v0.1.4

• config file: use either ',' or spaces as separators in the app list

v0.1.3

• --deprecations switch added

v0.1.2

• cleanup

v0.1.1

• add test settings example to Readme

v0.1.0

• published on PyPI

v0.0.3

• added versioning
• added support for unittest.TestCase