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.