Test::LectroTest::RegressionTesting - How to do regression testing (for free!)

       Tom Moertel (tom@moertel.com)

       Copyright (c) 2004-13 by Thomas G Moertel.  All rights reserved.

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

perl v5.34.0                                       2022-06-21              Test::LectroTe...gressionTesting(3pm)

       Say that LectroTest uncovers a bug in your software by finding a random test case that proves one of your
       properties to be false.  If you apply a fix for the bug, how can you be sure that LectroTest will re-test
       the property using the exact same test case that "broke" it before, just to be certain the bug really is
       fixed?  And how can you be sure that future changes to your code will not reintroduce the same bug
       without your knowing it?

       For situations like these, LectroTest can record failure-causing test cases to a file, and it can play
       those test cases back as part of its normal testing strategy.

       The easiest way to take advantage of this feature is to set the regressions parameter when you "use"
       Test::LectroTest or Test::LectroTest::Compat:

           use Test::LectroTest
               regressions => "regressions.txt";

       This tells LectroTest to use the file "regressions.txt" for both recording and playing back failures.  If
       you want to record and play back from separate files, use the record_failures and playback_failures
       options:

           use Test::LectroTest::Compat
               playback_failures => "regression_suite_for_my_module.txt",
               record_failures   => "failures_in_the_field.txt";

       Here is how it works:

       1.  When  testing  a  property  named N, LectroTest will check for a play-back file.  If the file exists,
           LectroTest will search it for test cases associated with N.  If any such test cases exist, LectroTest
           will play them back before and inadditionto performing the usual, random testing of the property.

       2.  When performing the usual, random testing  of  a  property  named  N,  if  a  failure  occurs  (i.e.,
           LectroTest  finds  a counterexample), LectroTest will record the test case that caused the failure to
           the recording file, associating the test case with the name N.

       NOTE: If you pass any of the recording or playback parameters to Test::LectroTest::Compat, you must  have
       version  0.3500  or  greater  of Test::LectroTest installed.  (Module authors, update your modules' build
       dependencies accordingly.)  The Test::LectroTest module itself, however, has  always  ignored  unfamiliar
       parameters, and thus these options are backward compatible with older versions.

       Test::LectroTest::RegressionTesting - How to do regression testing (for free!)

       Test::LectroTest  gives a quick overview of automatic, specification-based testing with LectroTest.  This
       module accepts failure recording and play-back options.

       Test::LectroTest::Compat lets you mix LectroTest with the popular family of  Test::Builder-based  modules
       such as Test::Simple and Test::More. This module accepts failure recording and play-back options.

           use Test::LectroTest
               regressions => "regressions.txt";

           # -- OR --

           use Test::LectroTest
               playback_failures => "regression_suite_for_my_module.txt",
               record_failures   => "failures_in_the_field.txt";

           # -- OR --

           use Test::LectroTest::Compat
               regressions => "regressions.txt";

           # -- OR --

           use Test::LectroTest::Compat
               playback_failures => "regression_suite_for_my_module.txt",
               record_failures   => "failures_in_the_field.txt";

       version 0.5001