News::Article::Mbox - combines News::Article and Mail::Mbox::MessageParser
use News::Article::Mbox; my @articles = News::Article::Mbox->read_mbox( \*STDIN );
News::Article is capable of reading in individual messages from STDIN or other sources to make into Article objects. However, it is often helpful to be able to read many Articles out of an mbox-class storage format, as created by many newsreader programs. This package adds a single function, read_mbox(), to News::Article which makes this easy and accurate, using the functionality of Mail::Mbox::MessageParser.
Mostly the same as News::Article, except with the following function:
- read_mbox ( SOURCE [, MAXSIZE, MAXHEAD] )
Acts like News::Article::read(), except that it loads a large number of articles instead of each one.
SOURCEis parsed with
Mail::Mbox::MessageParser; if it turns out to only be a single news message and not a full mbox, then this is bypassed and that message is parsed. All messages make News::Article references. Returns an array or arrayref of articles.
This function is exportable, but is not exported by default.
News::Article, File::Temp, Mail::Mbox::MessageParser
This actually works pretty much the way it's supposed to.
It might be nice if we didn't have to use File::Temp...
Tim Skirvin <email@example.com>
This code may be redistributed under the same terms as Perl itself.
Copyright 2004, Tim Skirvin.