DOKK / manpages / debian 12 / libtest-randomresult-perl / Test::RandomResult.3pm.en
Test::RandomResult(3pm) User Contributed Perl Documentation Test::RandomResult(3pm)

Test::RandomResult - Test that results of a running code look random

This document describes version 0.001 of Test::RandomResult (from Perl distribution Test-RandomResult), released on 2019-07-17.

 use Test::More;
 use Test::RandomResult; # exports results_look_random
 results_look_random { your_func($arg) } 'your_func returns random result';
 results_look_random { your_func($arg) } between=>[1,10], 'your_func returns random between 1-10';
 ...
 done_testing;

EARLY RELEASE. CURRENTLY HAS NOT CHECKED THE DISTRIBUTION OF RANDOM RESULTS.

Usage:

 results_look_random { CODE... }, 'TEST NAME';
 results_look_random { CODE... }, OPT1=>VAL, OPT2=>VAL, ..., 'TEST NAME';

Run code multiple times (by default 30 or more, see the "runs" option) and check if the results look random.

Known options:

  • runs

    Integer. Default 30 or more. Number of times to run CODE.

  • between

    2-element array of numbers ("[$min, $max]"). Check that results are between $min and $max.

  • min

    Number. Specify minimum value (inclusive).

  • xmin

    Number. Specify minimum value (exclusive).

  • max

    Number. Specify maximum value (inclusive).

  • xmax

    Number. Specify maximum value (exclusive).

Please visit the project's homepage at <https://metacpan.org/release/Test-RandomResult>.

Source repository is at <https://github.com/perlancar/perl-Test-RandomResult>.

Please report any bugs or feature requests on the bugtracker website <https://rt.cpan.org/Public/Dist/Display.html?Name=Test-RandomResult>

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

Test::RandomResults

Test::Stochastic

perlancar <perlancar@cpan.org>

This software is copyright (c) 2019 by perlancar@cpan.org.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

2022-06-30 perl v5.34.0