NAME

Dist::Zilla::Plugin::Libarchive - Create dist archives using Archive::Libarchive

VERSION

version 0.03

SYNOPSIS

In your dist.ini

[Libarchive]

DESCRIPTION

This Dist::Zilla plugin overrides the built in archive builder and uses libarchive via Archive::Libarchive instead. It is different from the built in version in these ways:

Predictable

The built in behavior will sometimes use Archive::Tar or Archive::Tar::Wrapper. The problem with Archive::Tar::Wrapper is that it depends on the system implementation of tar, which in some cases can produce archives that are not readable by older implementations of tar. In particular GNU tar which is typically the default on Linux systems includes unnecessary features that break tar on HP-UX. (You should probably be getting off HP-UX if you are still using it in 2021 as I write this).

Sorted by name

The contents of the archive are sorted by name instead of being sorted by filename length. While sorting by length makes for a pretty display when they are unpacked, I find it harder to find stuff when the content is listed.

Additional formats

Because libarchive supports a large number of formats, this plugin can be extended to support them as well. Currently there is an interface to produce .tar, .tar.gz and .zip. Other formats may be added in the future.

PROPERTIES

format

[Libarchive]
format = tar.gz

Sets the output format. The default, most common and easiest to unpack for cpan clients is tar.gz. You should consider carefully before not using the default. Supported formats:

tar.gz

tar

zip

SEE ALSO

Archive::Libarchive

Dist::Zilla

Dist::Zilla::Plugin::ArchiveTar

Dist::Zilla::Role::ArchiveBuilder

AUTHOR

Graham Ollis <plicease@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2021 by Graham Ollis.

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