NAME
CPAN::Releases::Latest - find latest release(s) of all dists on CPAN, including dev releases
SYNOPSIS
use CPAN::Releases::Latest;
my $latest = CPAN::Releases::Latest->new(max_age => '1 day');
my $iterator = $latest->release_iterator();
while (my $release = $iterator->next_release) {
printf "%s path=%s time=%d size=%d\n",
$release->distname,
$release->path,
$release->timestamp,
$release->size;
}
DESCRIPTION
VERY MUCH AN ALPHA. ALL THINGS MAY CHANGE.
This module uses the MetaCPAN API to construct a list of all dists on CPAN. The generated index is cached locally. It will let you iterate across these, returning the latest release of the dist. If the latest release is a developer release, then you'll first get back the non-developer release (if there is one), and then you'll get back the developer release.
When you instantiate this class, you can specify the max_age
of the generated index. You can specify the age using any of the expressions supported by Time::Duration::Parse:
5 minutes
1 hour and 30 minutes
2d
3600
If no units are given, it will be interpreted as a number of seconds. The default for max age is 1 day.
If you already have a cached copy of the index, and it is less than the specified age, then we'll use your cached copy and not even check with MetaCPAN.
SEE ALSO
CPAN::ReleaseHistory provides a similar iterator, but for all releases ever made to CPAN, even those that are no longer on CPAN.
BackPAN::Index is another way to get information about all releases ever made to CPAN.
REPOSITORY
https://github.com/neilbowers/CPAN-Releases-Latest
AUTHOR
Neil Bowers <neilb@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2014 by Neil Bowers <neilb@cpan.org>.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.