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?";
# 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.
Functions
These are exported on demand or may be called fully qualified
- recent $date_and_time
- recent $date_and_time, $test_description
- recent $date_and_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 $date_and_time, $duration
-
Returns true if and only if the time occured within the duration ago from the current time.
Parsing of Datetimes
This module supports the following things being passed in as a date and time:
- A DateTime object
- An ISO8601 formatted date string
-
i.e. anything that DateTime::Format::ISO8601 can parse
- A Postgres style TIMESTAMP WITH TIME ZONE
-
i.e. something of the form
YYYY-MM-DD HH:MM:SS.ssssss+TZ
Older verions of this module used DateTimeX::Easy to parse the datetime, but this proved to be unreliable.
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
In order not to depend on another DateTime library, this module converts postgres style TIMESTAMP WITH TIME ZONE by using a regular expression and simply ignoring microseconds. This potentially introduces a one second inaccuracy in the recent handling.