devel/p5-Test-MockRandom/pkg-descr

   1 This perhaps ridiculous-seeming module was created to test routines that
   2 manipulate random numbers by providing a known output from rand. Given a list of
   3 seeds with srand, it will return each in turn. After seeded random numbers are
   4 exhausted, it will always return 0. Seed numbers must be of a form that meets
   5 the expected output from rand as called with no arguments -- i.e. they must be
   6 between 0 (inclusive) and 1 (exclusive). In order to facilitate generating and
   7 testing a nearly-one number, this module exports the function oneish, which
   8 returns a number just fractionally less than one.
   9
  10 Depending on how this module is called with use, it will export rand to a
  11 specified package (e.g. a class being tested) effectively overriding and
  12 intercepting calls in that package to the built-in rand. It can also override
  13 rand in the current package or even globally. In all of these cases, it also
  14 exports srand and oneish to the current package in order to control the output
  15 of rand.
  16
  17 Alternatively, this module can be used to generate objects, with each object
  18 maintaining its own distinct seed array.
  19
  20 WWW: http://search.cpan.org/dist/Test-MockRandom/