Test::Stream::Plugin::SRand - Control the random seed for more controlled test environments.
This is an experimental release! Test-Stream, and all its components are still in an experimental phase. This dist has been released to cpan in order to allow testers and early adopters the chance to write experimental new tools with it, or to add experimental support for it into old tools.
PLEASE DO NOT COMPLETELY CONVERT OLD TOOLS YET. This experimental release is very likely to see a lot of code churn. API's may break at any time. Test-Stream should NOT be depended on by any toolchain level tools until the experimental phase is over.
This module gives you control over the random seed used for your unit tests. In some testing environments the random seed can play a major role in results.
The default configuration for this module will seed srand with the local date. Using the date as the seed means that on any given day the random seed will always be the same, this means behavior will not change from run to run on a given day. However the seed is different on different days allowing you to be sure the code still works with actual randomness.
The seed is printed for you on failure, or when the harness is verbose. You can use the TS_RAND_SEED environment variable to specify the seed. You can also provide a specific seed as a load-time argument to the plugin.
TS_RAND_SEED
Loading the plugin is easy, and the defaults are sane:
use Test::Stream 'SRand';
Custom seed:
use Test::Stream SRand => ['42'];
If you use this plugin you probably want to use it as the first, or near-first plugin. srand is not called until the plugin is loaded, so other plugins loaded first may already be making use of random numbers before your seed takes effect.
srand
The source code repository for Test::Stream can be found at http://github.com/Test-More/Test-Stream/.
Copyright 2015 Chad Granum <exodist7@gmail.com>.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
See http://www.perl.com/perl/misc/Artistic.html
To install Test::Stream, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Test::Stream
CPAN shell
perl -MCPAN -e shell install Test::Stream
For more information on module installation, please visit the detailed CPAN module installation guide.