Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
App::Prove::State(3)   Perl Programmers	Reference Guide	  App::Prove::State(3)

NAME
       App::Prove::State - State storage for the "prove" command.

VERSION
       Version 3.43

DESCRIPTION
       The "prove" command supports a "--state"	option that instructs it to
       store persistent	state across runs. This	module implements that state
       and the operations that may be performed	on it.

SYNOPSIS
	   # Re-run failed tests
	   $ prove --state=failed,save -rbv

METHODS
   Class Methods
       "new"

       Accepts a hashref with the following key/value pairs:

       o   "store"

	   The filename	of the data store holding the data that
	   App::Prove::State reads.

       o   "extensions"	(optional)

	   The test name extensions.  Defaults to ".t".

       o   "result_class" (optional)

	   The name of the "result_class".  Defaults to
	   "App::Prove::State::Result".

   "result_class"
       Getter/setter for the name of the class used for	tracking test results.
       This class should either	subclass from "App::Prove::State::Result" or
       provide an identical interface.

   "extensions"
       Get or set the list of extensions that files must have in order to be
       considered tests. Defaults to ['.t'].

   "results"
       Get the results of the last test	run.  Returns a	"result_class()"
       instance.

   "commit"
       Save the	test results. Should be	called after all tests have run.

   Instance Methods
       "apply_switch"

	$self->apply_switch('failed,save');

       Apply a list of switch options to the state, updating the internal
       object state as a result. Nothing is returned.

       Diagnostics:
	   - "Illegal state option: %s"

       "last"
	   Run in the same order as last time

       "failed"
	   Run only the	failed tests from last time

       "passed"
	   Run only the	passed tests from last time

       "all"
	   Run all tests in normal order

       "hot"
	   Run the tests that most recently failed first

       "todo"
	   Run the tests ordered by number of todos.

       "slow"
	   Run the tests in slowest to fastest order.

       "fast"
	   Run test tests in fastest to	slowest	order.

       "new"
	   Run the tests in newest to oldest order.

       "old"
	   Run the tests in oldest to newest order.

       "save"
	   Save	the state on exit.

       "get_tests"

       Given a list of args get	the names of tests that	should run

       "observe_test"

       Store the results of a test.

       "save"

       Write the state to a file.

       "load"

       Load the	state from a file

perl v5.35.5			  2021-09-26		  App::Prove::State(3)

NAME | VERSION | DESCRIPTION | SYNOPSIS | METHODS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=App::Prove::State&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help