NAME

Test::Shadow - override a class's methods in a scope, checking input/output

SYNOPSIS

Provides RSpec-like mocking with 'receive'/'and_return' functionality. However the interface is more explicit. This may be considered a feature.

use Test::More;
use Test::Shadow;

use Foo;

with_shadow Foo => inner_method => {
    in => [ 'list', 'of', 'parameters' ],
    out => 'barry',
    count => 3
}, sub {
    my $foo = Foo->new;
    $foo->outer_method();
};

DETAILS

One function is provided:

with_shadow $class1 => $method1 => $args1, ..., $callback

Each supplied class/method is overridden as per the specification in the supplied args. Finally, the callback is run with that specification.

The args passed are as follows:

in

A list of parameters to compare every call of the method against. This will be checked each time, until the first failure, if any. The parameters can be supplied as an arrayref:

in => [ 'list', 'of', 'parameters' ]

or a hashref:

in => { key => 'value', key2 => 'value2 },

and the comparison may be made using any of the extended routines in Test::Deep

use Test::Deep;
with_shadow Foo => inner_method => {
    in => { foo => any(1,2,3) },
    ...

out

Stub the return value.

count

The number of times you expect the method to be called. This is checked at the end of the callback scope.

AUTHOR and LICENSE

Copyright 2014 Hakim Cassimally <osfameron@cpan.org>

This module is released under the same terms as Perl.