NAME

Mail::Freshmeat - parses daily newsletters from http://freshmeat.net/

SYNOPSIS

 use Mail::Freshmeat;

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

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

 for my $entry ($newsletter->entries())
 {
   print "Position: ", $entry->position(), "\n";
   print "Name and version: ", $entry->name_and_version(), "\n";
 }

DESCRIPTION

IMPORTANT: DUE TO FRESHMEAT.NET CHANGING THE STRUCTURE OF THEIR NEWSLETTERS, THE INTERFACE FOR THIS PACKAGE HAS CHANGED SINCE Mail::Freshmeat 0.94.

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

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

NEWSLETTER 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.

• 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.

• articles

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

ENTRY METHODS

• entry_keys

  This object method will return an array or an array reference (depending on context) of all the attribute names of an entry (e.g.: position, name, license, url) in the order that they appeared.

• short_entry

  This object method will return the short description of the entry as it appeared in the newsletter headlines section (eg: Linux 2.4.9-ac15 (2.4-ac))

ARTICLE METHODS

• article_keys

  This object method will return an array or an array reference (depending on context) of all the attribute names of an article (e.g.: title, description, url) in the order that they appeared.

NEWSLETTER ACCESSORS

• ad

• ad_header

• articles_header

• articles_payload

• articles_total

• date

• entries_header

• entries_payload

• entries_total

• footer

• full

• headlines

• headlines_header

• links

• links_header

ENTRY ACCESSORS

• about

• changes

• full

• license

• name

• name_and_version

• position

• posted_by_name

• posted_by_url

• posted_on

• trove

• url

• version

ARTICLE ACCESSORS

• description

• full

• posted_by_name

• posted_by_url

• posted_on

• section

• title

• url

AUTHORS

Adam J. Foxson afoxson@pobox.com, 2002-

Adam Spiers adam@spiers.net, 1999-2000

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.

VERSION

This is release 1.20.

SEE ALSO

perl(1).