BackPAN::Index::Release - A single release of a distribution


BackPAN-Index documentation Contained in the BackPAN-Index distribution.

Index


Code Index:

NAME

Top

BackPAN::Index::Release - A single release of a distribution

SYNOPSIS

Top

  my $b = BackPAN::Index->new();

  # Find version 1.2.3 of Acme-Colour
  my $release = $b->release("Acme-Colour", '1.2.3');

  print "   CPANID: " . $release->cpanid . "\n";
  print "     Date: " . $release->date . "\n";
  print "     Dist: " . $release->dist . "\n";
  print "Distvname: " . $release->distvname . "\n";
  print " Filename: " . $release->filename . "\n";
  print " Maturity: " . $release->maturity . "\n";
  print "     Path: " . $release->path . "\n";
  print "  Version: " . $release->version . "\n";

DESCRIPTION

Top

BackPAN::Index::Release objects represent releases, individual tarballs/zip files, of a distribution on BackPAN.

For example, Acme-Pony-1.2.3.tar.gz is a release of the Acme-Pony distribution.

METHODS

Top

cpanid

    my $cpanid = $release->cpanid;

Returns the PAUSE ID of the author of the release.

date

    my $date = $release->date;

Returns the date of the release, in UNIX epoch seconds.

dist

    my $dist_name = $release->dist;

Returns the name of the distribution this release belongs to.

distvname

    my $distvname = $release->distvname;

Returns the name of the distribution, hyphen, and version.

filename

    my $filename = $release->filename;

Returns the filename of the release, just the file part.

maturity

    my $maturity = $release->maturity;

Returns the maturity of the release.

path

    my $path = $release->path;

Returns the full path on CPAN to the release. This is a BackPAN::File object.

version

    my $version = $release->version;

Returns the version of the release:

as_hash

    my $data = $release->as_hash;

Returns a hash ref containing the data inside $release.

AUTHOR

Top

Leon Brocard <acme@astray.com> and Michael G Schwern <schwern@pobox.com>

COPYRIGHT

Top

SEE ALSO

Top

BackPAN::Index, BackPAN::Index::Dist, BackPAN::Index::File


BackPAN-Index documentation Contained in the BackPAN-Index distribution.

package BackPAN::Index::Release;

use strict;
use warnings;

use overload
  q[""]         => sub { $_[0]->distvname },
  fallback      => 1;

use BackPAN::Index::Role::AsHash;

sub data_methods {
    return qw(dist version cpanid date path maturity);
}

sub filename {
    my $self = shift;
    return $self->path->filename;
}

# Compatibility with PBP
sub prefix {
    my $self = shift;
    return $self->path;
}

1;

__END__