NAME

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

SYNOPSIS

    use Mail::SPF::Test::Case;
    
    my $test_case   = Mail::SPF::Test::Case->new_from_yaml_struct($struct);
    
    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

An object of class Mail::SPF::Test::Case represents a single test case within an SPF test-suite scenario.

Constructors

The following constructors are provided:

new(%options): returns Mail::SPF::Test::Case

Creates a new SPF test-suite test case object from scratch.

new_from_yaml_struct($yaml_struct): returns Mail::SPF::Test::Case

Creates a new SPF test-suite test case object from the given YAML-generated data structure.

Instance methods

The following instance methods are provided:

name: returns string

Returns the name of the test case.

description: returns string

Returns the description of the test case.

comment: returns string

Returns the optional comment of the test case.

spec_refs: returns list of string

Returns a list of the specification references for the test case.

scope: returns string

Returns the SPF identity's scope for the test case.

identity: returns string

Returns the SPF identity for the test case.

ip_address: returns string

Returns the SMTP sender's IP address for the test case.

helo_identity: returns string

Returns the SPF HELO identity for the test case.

expected_results: returns list of string

Returns the list of acceptable SPF result codes for the test case.

is_expected_result($result_code): returns boolean

Returns true if the given result code is among the acceptable SPF result codes for the test case, false otherwise.

expected_explanation: returns string

Returns the expected authority explanation string for the test case.

SEE ALSO

Mail::SPF::Test

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

AUTHORS

Julian Mehnle <julian@mehnle.net>