NAME
    Test::Recent - check a time is recent

SYNOPSIS
       use Test::More;
       use Test::Recent qw(recent);

       # check things happened in the last ten seconds
       recent DateTime->now, "now is recent!";
       recent "2012-12-23 00:00:00", "end of mayan calendar happened recently?";
       recent "5 seconds ago", "5 seconds ago is obviously recently";

       # check things happened in the last hour
       recent "2012-12-23 00:00:00", DateTime::Duration->new( hours => 1 ), "mayan";
       recent "2012-12-23 00:00:00", "1 hour", "mayan"

DESCRIPTION
    Simple module to check things happened recently. Uses
    DateTime::Format::ISO8601 and Time::Duration::Parse to parse the times
    and durations (older versions of this module used DateTimeX::Easy
    because that module didn't handle iso timezones very well.)

  Functions
    These are exported on demand or may be called fully qualified

    recent $time
    recent $time, $test_description
    recent $time, $duration, $test_description
        Tests (using the Test::Builder framework) if the time occured within
        the duration ago from the current time. If no duration is passed,
        ten seconds is assumed.

    occured_within_ago $time, $duration
        Returns true if and only if the time occured within the duration ago
        from the current time.

AUTHOR
    Written by Mark Fowler <mark@twoshortplanks.com>

COPYRIGHT
    Copyright OmniTI 2012. All Rights Rerserved.

    This program is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.

BUGS
    Bugs should be reported via this distribution's CPAN RT queue. This can
    be found at <https://rt.cpan.org/Dist/Display.html?Test-Recent>

    You can also address issues by forking this distribution on github and
    sending pull requests. It can be found at
    <http://github.com/2shortplanks/Test-Recent>

SEE ALSO
    DateTime::Format::ISO8601, Time::Duration::Parse

