/ 
Parse-PAUSE-1.001
River stage zero No dependents
/ Parse::PAUSE

NAME

Parse::PAUSE - Parses CPAN upload emails sent by PAUSE

VERSION

version 1.001

SYNOPSIS

use Parse::PAUSE;

my $content = 'The uploaded file...'; # body of CPAN upload email from PAUSE
my $upload  = Parse::PAUSE->parse($content);

print $upload->pathname(), "\n"; # $CPAN/authors/id/S/SU/SUKRIA/Coat-Persistent-0.104.tar.gz
print $upload->entered_by(), "\n"; # SUKRIA (Alexis Sukrieh)

DESCRIPTION

Given the content of a CPAN upload email sent by PAUSE, this module will parse the content, and return an object which can be queried for the discrete bits of information about the upload.

SUBROUTINES/METHODS

The public API of this class exposes the following:

CLASS METHODS

  • parse

    Parses given content of a CPAN upload email sent by PAUSE. Returns an object that can be queried on success and undef on failure. Newlines will be automatically normalized.

OBJECT METHODS

  • upload

    Returns the uploaded filename or URL. For example: "Coat-Persistent-0.104.tar.gz".

  • pathname

    Returns the CPAN path of the upload. For example: "$CPAN/authors/id/S/SU/SUKRIA/Coat-Persistent-0.104.tar.gz".

  • size

    Returns the size of the upload. For example: "24105".

  • md5

    Returns the MD5 checksum of the upload. For example: "5f84687ad671b675c6e2936c7b2b3fd7".

  • entered_by

    Returns the Perl author of the upload. For example: "SUKRIA (Alexis Sukrieh)".

  • entered_on

    Returns the datetime of upload. For example: "Fri, 05 Jun 2009 17:10:00 GMT".

  • completed

    Returns the datetime that paused completed servicing the upload. For example: "Fri, 05 Jun 2009 17:11:11 GMT".

  • paused_version

    Returns the version of paused that processed the upload. For example: "1047".

DIAGNOSTICS

This module throws no exceptions. If the content is unparseable, the constructor, parse, will return undef.

CONFIGURATION AND ENVIRONMENT

This module does not employ any configuration nor environment variables.

DEPENDENCIES

  • Moose

  • Encode

  • Encode::Newlines

  • Module::Pluggable

  • Scalar::Util

INCOMPATIBILITIES

No known incompatibilities.

BUGS AND LIMITATIONS

Please report any issues to: http://github.com/afoxson/parse-pause/issues

AUTHOR

Adam J. Foxson <afoxson@pobox.com>

LICENSE AND COPYRIGHT

Copyright (C) 2009 Adam J. Foxson. All rights reserved.

LICENSE

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