NAME

PITA::XML::Request - A request for the testing of a software package

SYNOPSIS

  # Create a request specification
  my $dist = PITA::XML::Request->new(
        scheme    => 'perl5',
        distname  => 'PITA-XML',
  
        # File properties
        filename  => 'Foo-Bar-0.01.tar.gz',
        md5sum    => '0123456789ABCDEF0123456789ABCDEF',
 
        # Optional fields for repository-based requests
        authority => 'cpan',
        authpath  => '/id/A/AD/ADAMK/Foo-Bar-0.01.tar.gz',
        );

DESCRIPTION

PITA::XML::Request is an object for holding information about a request for a distribution to be tested. It is created most often as part of the parsing of a PITA::XML XML file.

It holds the testing scheme, name of the distribition, file information, and authority information (if the distribution was sourced from a repository such as CPAN)

METHODS

scheme

The scheme accessor returns the name of the testing scheme that the distribution is to be tested under.

In this initial implementation, the following schemes are supported.

perl5

Perl 5 general testing scheme.

Auto-detect the specific sub-scheme (currently either perl5.makefile or perl5.build)

perl5.make

Traditional Perl 5 testing scheme.

Executes perl Makefile.PL, make, make test, make install.

perl5.build

Module::Build Perl 5 testing scheme.

Executes perl Build.PL, Build, Build test, Build install.

perl6

Perl 6 general testing scheme.

Specifics are yet to be determined.

distname

The distname accessor returns the name of the request as a string.

Most often, this would be something like 'Foo-Bar' with a primary focus on the class Foo::Bar.

filename

The filename accessor returns ...

md5sum

The md5sum accessor returns the MD5 sum for package. This is only used as a CRC and isn't assumed to be cryptographically secure.

authority

If present, the authority accessor returns the name of the package authority. For example, CPAN distributions use the authority 'cpan'.

authpath

When testing distributions , the authpath returns the path for the Request file within the CPAN.

For non-CPAN distributions, returns false (the null string).

SUPPORT

Bugs should be reported via the CPAN bug tracker at

http://rt.cpan.org/NoAuth/ReportBug.html?Queue=PITA-XML

For other issues, contact the author.

AUTHOR

Adam Kennedy <cpan@ali.as>, http://ali.as/

SEE ALSO

PITA::XML

The Perl Image-based Testing Architecture (http://ali.as/pita/)

COPYRIGHT

Copyright 2005, 2006 Adam Kennedy. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the LICENSE file included with this module.