new

default_file_spec

determine_name_and_version

determine_packages

  $packages = $dist->determine_packages(@files);

Search the specified files (or all files if unspecified) for perl packages.

Extracts the files to a temporary directory if necessary and uses Module::Metadata to discover package names and versions.

extract_into

  $ddir = $dist->extract_into($dir);
  ($ddir, @dfiles) = $dist->extract_into($dir, @files);

Extracts the specified files (or all files if not specified) into the specified directory.

In list context this returns a list of the directory (which may be a subdirectory of the $dir passed in) and the files extracted (in native OS (on-disk) format).

In scalar context just the directory is returned.

file_content

This must be defined by subclasses.

file_checksum

  $dist->file_checksum('lib/Mod/Name.pm', 'sha256');

Returns a checksum (hex digest) of the file content.

The Digest module is used to generate the checksums. The value specified should be one accepted by "Digest->new". A small effort is made to translate simpler names like "md5" into "MD5" and "sha1" into "SHA-1" (which are the names Digest expects).

If the type of checksum is not specified "md5" will be used.

find_files

This is called from "list_files" and cached on the object.

This must be defined by subclasses.

file_spec

A "file_spec" attribute can be passed to the constructor to override the default.

NOTE: This is used for the internal format of the dist. Tar archives, for example, are always in unix format. For operations outside of the dist, the format determined by File::Spec will always be used.

full_path

  $dist->full_path("lib/Mod.pm"); # "root-dir/lib/Mod.pm"

Used internally to put the "root" directory back onto the file.

list_files

This calls "find_files" to get a listing of the contents of the dist, determines (and caches) the root directory (if any), caches and returns the list of files with the root dir stripped.

  @files = $dist->list_files;
  # something like qw( README META.yml lib/Mod.pm )

name

packages_from_directory

  $provides = $dist->packages_from_directory($dir, @files);

Determines the packages provided by the perl modules found in a directory. This is thin wrapper around "package_versions_from_directory" in Module::Metadata. It returns a hashref like "provides" in CPAN::Meta::Spec.

NOTE: $dir must be a physical directory on the disk, therefore @files (if specified) must be in native OS format. This function is called internally from "determine_packages" (which calls physical_directory (which calls "extract_into")) which manages these requirements.

parse_name_and_version

  ($name, $version) = $dist->parse_name_and_version($path);

Attempt to parse name and version from the provided string. This will work for dists named like "Dist-Name-1.0".

path_class_dir

path_class_file

path_classify_dir

path_classify_file

perl_files

TODO: This should probably be customizable.

physical_directory

  $dir = $dist->physical_directory();
  ($dir, @dir_files) = $dist->physical_directory(@files);

Returns the path to a physical directory on the disk where the specified files (if any) can be found.

For in-memory formats this will make a temporary directory and write the specified files (or all files) into it.

The return value is the same as "extract_into": In scalar context the path to the directory is returned. In list context the (possibly adjusted) paths to any specified files are appended to the return value.

remove_root_dir

  my ($dir, @rel) = $dm->remove_root_dir(@files);

If all the @files are beneath the same root directory (as is normally the case) this will strip the root directory off of each file and return a list of the root directory and the stripped files.

If there is no root directory the first element of the list will be "undef".

required_attribute

root

set_name_and_version

version