NAME

Test::FITesque::Fixture - Abstract calls for fixtures

SYNOPSIS

  package Buddha::Fixture;

  use strict;
  use warnings;
  use base qw(Test::FITesque::Fixture);
  use Test::More qw();

  sub click_on_button : Test {
    my ($self, @args) = @_;
    ...
    ok(1);
  }

  sub open_window : Test : Plan(3) {
    my ($self, @args) = @_;
    ...
    ok(1);
    ok(2);
    ok(3);
  }

DESCRIPTION

This module provides the base class for FITesque fixtures. It provides methods for the 'Test' and 'Plan' attributes along with some utility functions for Test::FITesque::Fixture.

All methods for use as FITesque test methods must be marked with the 'Test' attribute.

The 'Plan' attribute states how many Test::More functions the FITesque test method expects to run. If a method does not have the 'Plan' attribute set, it is implied that the test method will execute one Test::More functions.

  # Execute 10 Test::More functions
  sub test_method : Test : Plan(10) {
    ...  
  }

  # Just one this time
  sub test_method : Test {
    ...
  }

  # not a test method
  sub normal_method {
    ...
  }

There are also 2 methods which may require overriding. The parse_method_string method returns a coderef of the method that relates to the method string used as the first element of a FITesque test row.

  # get coderef for the 'click_on_buton' method of the fixture class
  my $coderef = $fixture->parse_method_string('click on button');

The other method, 'parse_arguments' provides a hook in point to allow preprocessing on arguments to FITesque fixture test methods. This might be useful in case you want to design a domain specific langauge into your arguments. By default, this method just returns the arguments as is.

METHODS

new

  my $fixture = Buddha::Fixture->new();

Simple constructor

method_test_count

 my $count = $fixture->method_test_count('foo');

This returns the planned test count associated with the passed method name.

parse_method_string

  my $coderef = $fixture->parse_method_string('click on button');

This method takes a string of text and attempts to return a coderef of a method within the fixture class.

parse_arguments

  my @arguments = $fixture->parse_arguments(qw(one two three));

This method provides a way to preprocess arguments for methods before they are run.

AUTHORS

Scott McWhirter, <konobi@cpan.org>

COPYRIGHT & LICENSE

Copyright 2007 Scott McWhirter, all rights reserved.

This program is released under the following license: BSD. Please see the LICENSE file included in this distribution for details.