Doc::Perlish::Reader - abstaction for stream-ish data input

 my $reader = Doc::Perlish::Reader->new($where);

 # or "lines", "characters", or a regex
 $reader->give_me("paragraphs");

 while (!$reader->eof) {
     my $data = $reader->next;

     # do something with $data...

     # if you didn't want a chunk, put it back.
     if ($unwanted) {
         $reader->unget($data);
     }
 }

 # if you want to use it again.
 $reader->reset;

A Doc::Perlish reader is an abstraction around the job of pulling in data from a file. It is here so that other input for information can choose to emulate an IO::All, or this class.