NAME

Dist::Zilla::Plugin::Author::GETTY::Binary - Declare one standalone binary of the distribution in META.json

VERSION

version 0.328

DESCRIPTION

One instance per standalone binary of the distribution, added by binary in @Author::GETTY or by a @Author::GETTY::Binary subsection. It writes the x_binaries key of META.json, which the binary release workflow reads. Fails the build when the binary's script is not part of the distribution.

Right after dzil build it packs the binary with pp as a local check and runs its verify and smoke commands on it; that needs PAR::Packer in the PATH, or the environment variable DZIL_BINARY_SKIP set to skip the check. Before a release it refuses to go on without a .github/workflows/binaries.yml that calls the binary workflow of Dist::Zilla::PluginBundle::Author::GETTY. See the Binaries section there for the whole binary release.

ATTRIBUTES

binary_name

Name of the binary, required: a letter or digit, then letters, digits, ., _ or -. Also the name of the binary in META.json.

script

Script packed into the binary, required, relative to the distribution root; it has to be part of the distribution.

modules

Modules packed in besides what pp finds, each as -M. Repeatable. A trailing ::* goes to pp as ::**: every module below, at any depth, without the module itself.

require

Modules that have to be inside the finished binary. Repeatable.

pp_args

Shell command whose output lines are added to the pp command line.

verify

Shell command run with the packed binary as its argument. It runs without PERL5LIB and gets in DZIL_BINARY_PERL5LIB the PERL5LIB under which pp loaded the distribution's dependencies; in the local check that is the caller's PERL5LIB, empty without one.

smoke

Shell command the workflow runs with the binary on a machine without Perl. It runs without PERL5LIB and without DZIL_BINARY_PERL5LIB, in the local check too.

platforms

Platforms to build, default all of linux-x86_64, linux-arm64, macos-arm64, macos-x86_64 and windows-x86_64. Dist-wide, repeatable.

prepare

Shell command run once per platform before the build. Dist-wide.

SUPPORT

Issues

Please report bugs and feature requests at https://github.com/Getty/p5-dist-zilla-pluginbundle-author-getty/issues.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <getty@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012-2026 by Torsten Raudssus <torsten@raudssus.de> https://raudssus.de/.

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