huschi.net

CPAN::DistnameInfo(3) User Contributed Perl DocumentationCPAN::DistnameInfo(3)
NAME
       CPAN::DistnameInfo - Extract distribution name and version from a
       distribution filename
SYNOPSIS
         my $pathname = "authors/id/G/GB/GBARR/CPAN-DistnameInfo-0.02.tar.gz";
         my $d = CPAN::DistnameInfo->new($pathname);
         my $dist      = $d->dist;      # "CPAN-DistnameInfo"
         my $version   = $d->version;   # "0.02"
         my $maturity  = $d->maturity;  # "released"
         my $filename  = $d->filename;  # "CPAN-DistnameInfo-0.02.tar.gz"
         my $cpanid    = $d->cpanid;    # "GBARR"
         my $distvname = $d->distvname; # "CPAN-DistnameInfo-0.02"
         my $extension = $d->extension; # "tar.gz"
         my $pathname  = $d->pathname;  # "authors/id/G/GB/GBARR/..."
         my %prop = $d->properties;
DESCRIPTION
       Many online services that are centered around CPAN attempt to associate
       multiple uploads by extracting a distribution name from the filename of
       the upload. For most distributions this is easy as they have used
       ExtUtils::MakeMaker or Module::Build to create the distribution, which
       results in a uniform name. But sadly not all uploads are created in
       this way.
       "CPAN::DistnameInfo" uses heuristics that have been learnt by
       <http://search.cpan.org/>; to extract the distribution name and version
       from filenames and also report if the version is to be treated as a
       developer release
       The constructor takes a single pathname, returning an object with the
       following methods
       cpanid
           If the path given looked like a CPAN authors directory path, then
           this will be the the CPAN id of the author.
       dist
           The name of the distribution
       distvname
           The file name with any suffix and leading directory names removed
       filename
           If the path given looked like a CPAN authors directory path, then
           this will be the path to the file relative to the detected CPAN
           author directory. Otherwise it is the path that was passed in.
       maturity
           The maturity of the distribution. This will be either "released" or
           "developer"
       extension
           The extension of the distribution, often used to denote the archive
           type (e.g. 'tar.gz')
       pathname
           The pathname that was passed to the constructor when creating the
           object.
       properties
           This will return a list of key-value pairs, suitable for assigning
           to a hash, for the known properties.
       version
           The extracted version
AUTHOR
       Graham Barr <gbarr AT pobox.com>
COPYRIGHT
       Copyright (c) 2003 Graham Barr. All rights reserved. This program is
       free software; you can redistribute it and/or modify it under the same
       terms as Perl itself.
perl v5.26.3                      2011-03-11             CPAN::DistnameInfo(3)