NAME

       Test::Roo::Role - Composable role for Test::Roo

VERSION

       version 1.004

SYNOPSIS

       A testing role:

           # t/lib/MyTestRole.pm
           package MyTestRole;
           use Test::Roo::Role; # loads Moo::Role and Test::More

           requires 'class';

           test 'object creation' => sub {
               my $self = shift;
               require_ok( $self->class );
               my $obj  = new_ok( $self->class );
           };

           1;

DESCRIPTION

       This module defines test behaviors as a Moo::Role.

USAGE

       Importing Test::Roo::Role also loads Moo::Role (which gives you strictures with fatal
       warnings and other goodies).

       Importing also loads Test::More.  Any import arguments are passed through to Test::More's
       "import" method.

   Creating and requiring fixtures
       You can create fixtures with normal Moo syntax.  You can even make them lazy if you want
       and require the composing class to provide the builder:

           has fixture => (
               is => 'lazy'
           );

           requires '_build_fixture';

       Because this is a Moo::Role, you can require any method you like, not just builders.

       See Moo::Role and Role::Tiny for everything you can do with roles.

   Setup and teardown
       You can add method modifiers around the "setup" and "teardown" methods and these will be
       run before tests begin and after tests finish (respectively).

           before  setup     => sub { ... };

           after   teardown  => sub { ... };

       You can also add method modifiers around "each_test", which will be run before and after
       every individual test.  You could use these to prepare or reset a fixture.

           has fixture => ( is => 'lazy, clearer => 1, predicate => 1 );

           after  each_test => sub { shift->clear_fixture };

       Roles may also modify "setup", "teardown", and "each_test", so the order that modifiers
       will be called will depend on when roles are composed.  Be careful with "each_test",
       though, because the global effect may make composition more fragile.

       You can call test functions in modifiers. For example, you could confirm that something
       has been set up or cleaned up.

           before each_test => sub { ok( ! shift->has_fixture ) };

EXPORTED FUNCTIONS

       Loading Test::Roo::Role exports a single subroutine into the calling package to declare
       tests.

   test
           test $label => sub { ... };

       The "test" function adds a subtest.  The code reference will be called with the test
       object as its only argument.

       Tests are run in the order declared, so the order of tests from roles will depend on when
       they are composed relative to other test declarations.

AUTHOR

       David Golden <dagolden@cpan.org>

COPYRIGHT AND LICENSE

       This software is Copyright (c) 2013 by David Golden.

       This is free software, licensed under:

         The Apache License, Version 2.0, January 2004