CONTENTS

• NAME
• VERSION
• DESCRIPTION
• SYNOPSIS
• METHODS
  • Class Methods
    • new
  • result_class
  • extensions
  • results
  • commit
  • Instance Methods
    • apply_switch
    • get_tests
    • observe_test
    • save
    • load

#NAME

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

#VERSION

Version 3.42

#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:

• store

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

• extensions (optional)

  The test name extensions. Defaults to .t.

• 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

development instance

GitHub issue tracker 🎃 DBOOK