NAME

File::ShareDir::Tarball - Deal transparently with shared files distributed as tarballs

VERSION

version 0.2.2

SYNOPSIS

    use File::ShareDir::Tarball ':all';

    # use exactly like File::ShareDir
    $dir = dist_dir('File-ShareDir');

DESCRIPTION

If the shared files of a distribution are contained in a tarball (see Dist::Zilla::Plugin::ShareDir::Tarball for why you would want to do that), automatically extract the archive in a temporary directory and return the path to that directory. If called for a regular distribution without a bundle file (shared-files.tar.gz), it'll return the original shared dir. In other words, from the consumer point of view, it'll behave just like File::ShareDir.

EXPORT TAGS

:all

Exports dist_dir() and dist_file().

EXPORTABLE FUNCTIONS

dist_dir( $distribution )

Behaves just like dist_dir() from File::ShareDir.

dist_file( $distribution, $file )

Behaves just like dist_file() from File::ShareDir.

SEE ALSO

Test::File::ShareDir

To test or use a shared dir that is not deployed yet.

Dist::Zilla::Plugin::ShareDir::Tarball

Dist::Zilla plugin to create the tarball effortlessly.

Module::Build::CleanInstall

Provides an alternative to this module by subclassing Module::Build and, upon installation, remove the files from previous installations as given in the packlist.

AUTHOR

Yanick Champoux <yanick@babyl.dyndns.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Yanick Champoux.

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