README

App::dategrep

dategrep searches the named input files for lines matching a date range
and prints them to stdout.

If dategrep works on a seekable file, it can do a binary search to find
the first and last line to print pretty efficiently. dategrep can also
read from stdin and compressed files, but it has to parse every single
line until the end of the range for those.

INSTALLATION

It is possible to install this script via perl normal install routines. 

  perl Build.PL
  ./Build
  ./Build install

Or you can use one of the two prebuild versions, which already include
all or same of dategreps dependencies. Which to choose mainly depends
on how hard it is for you to install Date::Manip. The L<small
version|https://mdom.github.io/dategrep/dategrep-standalone-small.pl>
is just 22.3KB big and includes all libraries except Date::Manip. The
L<big one|https://mdom.github.io/dategrep/dategrep-standalone-big.pl>
packs everything in a nice, neat package for you, but will cost you
almost 10MB of disk space.

So, to install the big version you could just type:

  wget https://mdom.github.io/dategrep/dategrep-standalone-big.pl
  cp dategrep-standalone-big.pl ~/bin/dategrep
  chmod +x ~/bin/dategrep

And for the small one (with the apt-get for Debian):

  wget https://mdom.github.io/dategrep/dategrep-standalone-small.pl
  cp dategrep-standalone-small.pl ~/bin/dategrep
  chmod +x ~/bin/dategrep
  apt-get install libdate-manip-perl

SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the
perldoc command.

    perldoc Foo

You can also look for information at:

    Github Issues
        https://github.com/mdom/dategrep/issues

    AnnoCPAN, Annotated CPAN documentation
        http://annocpan.org/dist/App-dategrep

    CPAN Ratings
        http://cpanratings.perl.org/dist/App-dategrep

    Search CPAN
        http://search.cpan.org/dist/App.dategrep


LICENSE AND COPYRIGHT

Copyright 2014 Mario Domgoergen

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

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.