NAME

Mail::VersionTracker - Parses newsletters from versiontracker.com

SYNOPSIS

 use Mail::VersionTracker;

 my $newsletter = Mail::VersionTracker->new(\*STDIN);

 print "Date: ", $newsletter->date(), "\n";
 print "Total entries: ", $newsletter->total(), "\n\n";

 for my $entry ($newsletter->entries()) {
    print "Name and version: ", $entry->name_and_version(), "\n";
    print "Name: ", $entry->name(), "\n";
    print "Version: ", $entry->version(), "\n";
    print "Category: ", $entry->category(), "\n";
    print "Date: ", $entry->date(), "\n";
    print "Description: ", $entry->description(), "\n";
    print "URL: ", $entry->url(), "\n\n";
 }

 # or

 for my $entry ($newsletter->entries()) {
     for my $key ($entry->entry_keys()) {
         my $key_stringified = $entry->stringify($key);
         print "$key_stringified: ", $entry->$key(), "\n";
     }
     print "\n";
 }

DESCRIPTION

Mail::VersionTracker is a subclass of Mail::Internet.

This package provides parsing of the daily e-mail newsletters which are sent out from http://versiontracker.com/ to any individual who requests them.

CLASS METHODS

• new

  This is the constructor. Pass it something that Mail::Internet will like such as a file descriptor (reference to a GLOB) or a reference to an array and you will get back a newsletter object.

NEWSLETTER METHODS

• date

  Returns the date of this newsletter.

• total

  Returns the total number entries in this newsletter.

• entries

  This object method will return an array or an array reference (depending on context) of entry objects for all of the entries in the newsletter.

• details

  Returns the text representation of all of the newsletter's entries.

• full

  Return the text representation of the entire newsletter.

ENTRY METHODS

• entry_keys

  Returns all of the methods, by name, that can be called against an entry.

• stringify

  Stringifies the name of an entry key, i.e., ucfirst's it, and converts all underscores to spaces.

• name_and_version

  Returns the name and version of this entry. I.e., Zoe 0.5.4

• name

  Returns the name of this entry. I.e., Zoe

• version

  Returns the version of this entry. I.e., 0.5.4

• category

  Returns the category of this entry. I.e., Freeware

• date

  Returns the date of this entry. I.e., 11/22/2003

• description

  Returns the description of this entry. I.e., Browser based email client

• url

  Returns the URL of this entry. I.e., http://www.versiontracker.com/dyn/moreinfo/mac/14677

BUGS

  Please report any bugs to (patches welcome):
  http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Mail-VersionTracker

COPYRIGHT

  Copyright (c) 2003 Adam J. Foxson. All rights reserved.

LICENSE

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

SEE ALSO

• perl

• Mail::Internet

AUTHOR

Adam J. Foxson <afoxson@pobox.com>.