Mail::SPF::Test.3pm

Langue: en

Version: 2008-03-06 (mandriva - 01/05/08)

Section: 3 (Bibliothèques de fonctions)

NAME

Mail::SPF::Test - SPF test-suite class

VERSION

1.001

SYNOPSIS

     use Mail::SPF::Test;
     
     my $test_suite = Mail::SPF::Test->new_from_yaml_file('rfc4408-tests.yml');
     
     foreach my $scenario ($test_suite->scenarios) {
         printf("Scenario '%s'\n", $scenario->description);
         
         foreach my $test_case ($scenario->test_cases) {
             my $name        = $test_case->name;
             my $description = $test_case->description;
             my $comment     = $test_case->comment;
             my @spec_refs   = $test_case->spec_refs(undef || '*.*/*');
             
             my $scope       = $test_case->scope;
             my $identity    = $test_case->identity;
             
             my $ip_address  = $test_case->ip_address;
             my $helo_identity
                             = $test_case->helo_identity;
             
             my @expected_results
                             = $test_case->expected_results;
             my $expected_explanation
                             = $test_case->expected_explanation;
             
             my $ok =
                 $test_case->is_expected_result($result_code) and
                 $expected_explanation eq $authority_explanation;
         }
     }
 
 

DESCRIPTION

Mail::SPF::Test is a class for reading and manipulating SPF test-suite data.

Constructors

The following constructors are provided:

new(%options): returns Mail::SPF::Test
Creates a new SPF test-suite object from scratch.
new_from_yaml($yaml_text, %options): returns Mail::SPF::Test
Creates a new SPF test-suite object from the given YAML string.
new_from_yaml_file($file_name, %options): returns Mail::SPF::Test
Creates a new SPF test-suite object by reading from the YAML file of the given name.

Instance methods

The following instance methods are provided:

as_yaml: returns string
Returns the test-suite object's list of scenarios formatted as a stream of YAML documents.
scenarios: returns list of Mail::SPF::Test::Scenario
Returns a list of the test-suite object's scenario objects.

SEE ALSO

For availability, support, and license information, see the README file included with Mail::SPF::Test.

AUTHORS

Julian Mehnle <julian@mehnle.net>