VERSION

version 0.925

SYNOPSIS

  my $dist = Dist::Metadata->new(file => $path_to_archive);

DESCRIPTION

This is a subclass of Dist::Metadata::Dist to enable determining the metadata from an archive file.

It is a base class for archive file formats:

  • Dist::Metadata::Tar

  • Dist::Metadata::Zip

It's not useful on it's own and should be used from \*(L"new\*(R" in Dist::Metadata.

METHODS

new

$dist = Dist::Metadata::Archive->new(file => $path);

Accepts a single \*(C`file\*(C' argument that should be a path to a file.

If called from this base class \*(C`new()\*(C' will delegate to a subclass based on the filename and return a blessed instance of that subclass.

archive

Returns an object representing the archive file.

default_file_spec

Returns \*(C`Unix\*(C' since most archive files are be in unix format.

determine_name_and_version

Attempts to parse name and version from file name.

file

The \*(C`file\*(C' attribute passed to the constructor, used to load \*(L"archive\*(R".

read_archive

$dist->read_archive($file);

Returns a format-specific object representing the specified file.

This must be defined by subclasses.

AUTHOR

Randy Stauner <[email protected]>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Randy Stauner.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.