NAME

Game::Golf::Entry - Single solution for a golf hole.

SYNOPSIS

use Game::Golf;

my $entry = new Game::Golf::Entry ( "hole.pl" );

$entry->test;

$entry->print_report;

$entry->test_ok or die;

DESCRIPTION

Internal object to be used by Game::Golf. Each solution represents a single hole.

CONSTRUCTOR

new( "author", "hole_name", "/path/to/solution/file" )

Creates a new Game::Golf::Entry object. You should pass the path to the file that holds the solution.

!!FIXME!! We should pass the hole name in order to know which test suite to apply.

!!FIXME!! Should we pass arguments as an array or as a hash?

!!FIXME!! Maybe we could create another constructor that will accept directly the code to test? Don't sure this is a good idea.

ACCESSORS

All the accessors are autoloaded.

author() Full name of the author.

email() Author's nickname.

nick() Author's nickname.

hole() The name of the hole this solution solves.

date() Date of the entry.

code() The entry's code.

result() The entry's test result.

file() Filename of the entry.

id() MD5 sum of the file, to make caching easier.

METHODS

test()

Run the test suite on this entry.

test_ok()

Return true if entry passed the test suite.

!!FIXME!! A simple true/false value, or maybe a percentage if we're playing with Test::Harness?

print_report()

Outputs result of the tests.

!!FIXME!! This means whe should cache also the result of tests?

test_one

score()

Compute the this Entry's score.

BUGS

Please report all bugs to:

http://rt.cpan.org/NoAuth/Bugs.html?Dist=Games-Golf

TODO

Lots of stuff.

AUTHORS

Philippe 'BooK' Bruhat <book@cpan.org>

Dave Hoover <dave@redsquirreldesign.com>

Steffen Müller <tsee@gmx.net>

Jonathan E. Paton <jonathanpaton@yahoo.com>

Jérôme Quelin <jerome.quelin@insalien.org>

Eugène Van der Pijll <E.C.vanderPijll@phys.uu.nl>

COPYRIGHT

This module is free software. It may be used, redistributed and/or modified under the same terms as Perl itself.

SEE ALSO

perl, Game::Golf.