Unmaintained: I'm no longer maintaining this package because I haven't used nose for some time, and nose itself has not seen a release since 2015, nor a commit since 2016 (nearly 3 years at time of writing). If you want to continue maintenance please contact me.
Nose plugin to randomly order tests and control random.seed
. (Also available for pytest).
All of these features are on by default but can be disabled with flags.
TestCase
classes + test functions when loading a module of tests.TestCase
when loading it.random.seed()
at the start of every test case and test to a fixed number - this defaults to time.time()
from the start of your test run, but you can pass in --randomly-seed
to repeat a randomness-induced failure.Randomness in testing can be quite powerful to discover hidden flaws in the tests themselves, as well as giving a little more coverage to your system.
By randomly ordering the tests, the risk of surprising inter-test dependencies is reduced - a technique used in many places, for example Google's C++ test runner googletest.
By resetting the random seed to a repeatable number for each test, tests can create data based on random numbers and yet remain repeatable, for example factory boy's fuzzy values. This is good for ensuring that tests specify the data they need and that the tested system is not affected by any data that is filled in randomly due to not being specified.
Tested with:
Install from pip with:
pip install nose-randomly
Nose will automatically find the plugin.
To activate it on your test run, use the --with-randomly
flag, for example:
nosetests -v --with-randomly
The output will start with an extra line that tells you the random seed that is being used:
Using --randomly-seed=1234 test_D (abcd_tests.Tests) ... ok ...
If the tests then fail due to ordering or randomly created data, you can then restart them with that seed:
nosetests -v --with-randomly --randomly-seed=1234
You can disable behaviours you don't like with the following flags:
--randomly-dont-shuffle-modules
- turn off the shuffling of the contents of modules--randomly-dont-shuffle-cases
- turn off the shuffling of test functions inside TestCase
classes--randomly-dont-reset-seed
- turn off the reset of random.seed()
at the start of every testnose has an unmerged pull request from 2009 to add random ordering functionality. This is available in plugin format in the nose-randomize package. It works quite well but I found that since it replaces all of the test loading machinery inside nose, it can interact badly with other plugins. This plugin was developed as a thinner layer to achieve the same thing, plus the random seed resetting which was not available before.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4