NAME

       MediaWiki::DumpFile::FastPages - Fastest way to parse a page dump file

SYNOPSIS

         use MediaWiki::DumpFile::FastPages;

         $pages = MediaWiki::DumpFile::FastPages->new($file);
         $pages = MediaWiki::DumpFile::FastPages->new(\*FH);

         while(($title, $text) = $pages->next) {
           print "Title: $title\n";
           print "Text: $text\n";
         }

ABOUT

       This is a subclass of MediaWiki::DumpFile::Pages that configures it to run in fast mode and uses a custom
       iterator that dispenses with the duck-typed MediaWiki::DumpFile::Pages::Page object that fast mode uses
       giving a slight processing speed boost.

       See the MediaWiki::DumpFile::Pages documentation for information about fast mode.

METHODS

       All of the methods of MediaWiki::DumpFile::Pages are also available on this subclass.

   new
       This is the constructor for this package. It is called with a single parameter: the location of a
       MediaWiki pages dump file or a reference to an already open file handle.

   next
       Returns a two element list where the first element is the article title and the second element is the
       article text. Returns an empty list when there are no more pages available.

AUTHOR

       Tyler Riddle, "<triddle at gmail.com>"

BUGS

       Please see MediaWiki::DumpFile for information on how to report bugs in this software.

HISTORY

       This package originally started life as a very limited hack using only XML::LibXML::Reader and seeking to
       text and title nodes in the document.  Implementing a parser for the full document was a daunting task
       and this package sat in the hopes that other people might find it useful.

       Because XML::TreePuller can expose the underlying XML::LibXML::Reader object and sync itself back up
       after the cursor was moved out from underneath it, I was able to integrate the logic from this package
       into the main ::Pages parser.

COPYRIGHT & LICENSE

       Copyright 2009 "Tyler Riddle".

       This program is free software; you can redistribute it and/or modify it under the terms of either: the
       GNU General Public License as published by the Free Software Foundation; or the Artistic License.

       See http://dev.perl.org/licenses/ for more information.