Smarttest

Wheel Status Latest Version License

Goal

Provide code snippets which help running tests in Django.

Installation

Install requirements:

pip install -r requirements.txt

Install Smarttest:

pip install django-smarttest

or current development version:

pip install git+https://github.com/kidosoft/django-smarttest.git

Configuration

INSTALLED_APPS =  [
 ...
 'smarttest',
 ...
]

Usage

Preventing tests from touching database

import unittest

from smarttest.decorators import no_db_testcase

@no_db_testcase
class SomeTestCase(unittest.TestCase):

     def test_some_test(self):
         ...

If you’ll accidentally write code that tries to run some query on database you’ll get exception.

Running only selected test types

import unittest

from smarttest.decorators import test_type

@test_type('acceptance')
class SomeAcceptanceTestCase(unittest.TestCase):

     def test_some_acceptance_test(self):
         ...

@test_type('unit')
class SomeUnitTestCase(unittest.TestCase):

     def test_some_unit_test(self):
         ...

class UnspecifiedTypeTestCase(unittest.TestCase):

     def test_some_test(self):
         ...
$ python -m unittest script
...
----------------------------------------------------------------------
Ran 3 tests in 0.000s

OK
$ IGNORE_TESTS=unit python -m unittest script
.s.
----------------------------------------------------------------------
Ran 3 tests in 0.000s

OK (skipped=1)
$ IGNORE_TESTS=acceptance python -m unittest script
s..
----------------------------------------------------------------------
Ran 3 tests in 0.000s

OK (skipped=1)
$ IGNORE_TESTS=acceptance,unit python -m unittest script
ss.
----------------------------------------------------------------------
Ran 3 tests in 0.000s

OK (skipped=2)

Test type can be any selected word. It doesn’t have to be “unit” or “acceptance”. You can have different test types for running in different environments if you need.

TestCase for use with switchable splinter driver

Simple TestCase that allows for simple switching between different drivers in tests.

In settings.py:

TEST_DRIVER = 'firefox'  # or django or any other

In test:

from smarttest.testcases import SplinterTestCase

class SomeTestCase(SplinterTestCase):

     def test_some_test(self):
         self.browser.visit(self.get_host() + '/')

If you run tests continuously (e.g. doing Test Driven Development) TEST_DRIVER=’django’ (default setting) is the fastest driver that do not interrupt your workflow. However when you run your acceptance tests you may want to check how it behaves with real browser. Simply set TEST_DRIVER=’firefox’ or any other real browser supported by splinter.

Supported Django versions

Tested with:

  • Django 1.2.7 on python2.7
  • Django 1.3.7 on python2.7
  • Django 1.4.16 on python2.7
  • Django 1.5.11 on python2.7, python3.3, python3.4
  • Django 1.6.8 on python2.7, python3.3, python3.4
  • Django 1.7.1 on python2.7, python3.3, python3.4
  • Django 1.8.8 on python2.7, python3.3, python3.4

Indices and tables