Pieter van de Bruggen > Test-Mini-v1.1.3 > Test::Mini::Logger

Download:
Test-Mini-v1.1.3.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Source  

NAME ^

Test::Mini::Logger - Output Logger Base Class

DESCRIPTION ^

Whether you're using a tool that expects output in a certain format, or you just long for the familiar look and feel of another testing framework, this is what you're looking for.

METHODS ^

Attribute Accessors

buffer
    buffer($self) # => IO 

Output buffer.

Returns:

  • (IO) -- Output buffer.
verbose
    verbose($self) 

Logger verbosity.

Returns:

  • Logger verbosity.

Output Functions

print
    print($self, @msg) 

Write output to the #buffer. Lines will be output without added newlines.

Parameters:

  • @msg -- The message(s) to be printed; will be handled as per print.
say
    say($self, @msg) 

Write output to the #buffer. Lines will be output with appended newlines.

Parameters:

  • @msg -- The message(s) to be printed; newlines will be appended to each message, before being passed to #print.

Callbacks

begin_test
    begin_test($self, $tc, $test) 

Called before each test is run.

Parameters:

  • (Class) $tc -- The test case owning the test method.
  • (String) $test -- The name of the test method being run.
begin_test_case
    begin_test_case($self, $tc, @tests) 

Called before each test case is run.

Parameters:

  • (Class) $tc -- The test case being run.
  • (Array<String>) @tests -- A list of tests to be run.
begin_test_suite
    begin_test_suite($self, %args) 

Called before the test suite is run.

Parameters:

  • (Hash) %args -- Options the test suite was run with.

Valid Options for %args:

  • (String) filter -- Test name filter.
  • (String) seed -- Randomness seed.
error
    error($self, $tc, $test, $e) 

Called when a test dies with an error. Increments the error count.

Parameters:

  • (Class) $tc -- The test case owning the test method.
  • (String) $test -- The name of the test with an error.
  • (Test::Mini::Exception) $e -- The exception object.
fail
    fail($self, $tc, $test, $e) 

Called when a test fails. Increments the failure count.

Parameters:

  • (Class) $tc -- The test case owning the test method.
  • (String) $test -- The name of the failed test.
  • (Test::Mini::Exception::Assert) $e -- The exception object.
finish_test
    finish_test($self, $tc, $test, $assertions) 

Called after each test is run. Increments the test and assertion counts, and finalizes the test's timing.

Parameters:

  • (Class) $tc -- The test case owning the test method.
  • (String) $test -- The name of the test method just run.
  • (Integer) $assertions -- The number of assertions called.
finish_test_case
    finish_test_case($self, $tc, @tests) 

Called after each test case is run. Increments the test case count, and finalizes the test case's timing.

Parameters:

  • (Class) $tc -- The test case just run.
  • (Array<String>) @tests -- A list of tests run.
finish_test_suite
    finish_test_suite($self, $exit_code) 

Called after each test suite is run. Finalizes the test suite timing.

Parameters:

  • (Integer) $exit_code -- Status the tests finished with.
pass
    pass($self, $tc, $test) 

Called when a test passes. Increments the pass count.

Parameters:

  • (Class) $tc -- The test case owning the test method.
  • (String) $test -- The name of the passing test.
skip
    skip($self, $tc, $test, $e) 

Called when a test is skipped. Increments the skip count.

Parameters:

  • (Class) $tc -- The test case owning the test method.
  • (String) $test -- The name of the skipped test.
  • (Test::Mini::Exception::Skip) $e -- The exception object.

Statistics

count
    count # => Hash
    count($key) # => Number

Accessor for counters.

Overloads:

    count # => Hash 

The count hash.

Returns:

  • (Hash) -- The count hash.
    count($key) # => Number 

The value for the given key.

Parameters:

  • $key -- A key in the count hash.

Returns:

  • (Number) -- The value for the given key.
time
    time($self, $key) # => Number 

Accessor for the timing data.

Parameters:

  • $key -- The key to look up timings for. Typical values are:
    $self

    Time for test suite

    "TestCase"

    Time for the test case

    "TestCase#test"

    Time for the given test

    Times for units that have not finished should not be relied upon.

Returns:

  • (Number) -- The time taken by the given argument, in seconds.

Class Methods

new
    new($class, %args) 

Constructor.

Parameters:

  • (Hash) %args -- Initial state for the new instance.

Valid Options for %args:

  • verbose -- Logger verbosity. Defaults to 0.
  • (IO) buffer -- Output buffer. Defaults to STDOUT.
syntax highlighting: