NAME

CPAN::ReleaseHistory - information about all files ever released to CPAN

SYNOPSIS

use CPAN::ReleaseHistory;

my $history  = CPAN::ReleaseHistory->new();
my $iterator = $history->release_iterator();

while (my $release = $iterator->next_release) {
  print 'path = ', $release->path,           "\n";
  print 'dist = ', $release->distinfo->dist, "\n";
  print 'time = ', $release->timestamp,      "\n";
  print 'size = ', $release->size,           "\n";
}

DESCRIPTION

NOTE: this is very much an alpha release. Any and all feedback appreciated.

This module provides an iterator that can be used to look at every file that has ever been released to CPAN, regardless of whether it is still on CPAN.

The $release returned by the next_release() method on the iterator is an instance of CPAN::ReleaseHistory::Release. It has four methods:

path

the relative path of the release. For example N/NE/NEILB/again-0.05.tar.gz.

distinfo

an instance of CPAN::DistnameInfo, which is constructed lazily. Ie it is only created if you ask for it.

timestamp

An integer epoch-based timestamp.

size

The number of bytes in the file.

METHODS

At the moment there is only one method, to create a release iterator. Other methods will be added as required / requested.

release_iterator()

See the SYNOPSIS.

SEE ALSO

BackPAN::Index - creates an SQLite database of the BackPAN index, and provides an interface for querying it.

REPOSITORY

https://github.com/neilbowers/CPAN-ReleaseHistory

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.