NAME
Dist::Zilla::PluginBundle::Author::GETTY - BeLike::GETTY when you build your dists
VERSION
version 0.300
SYNOPSIS
name = Your-App
author = You User <you@universe.org>
license = Perl_5
copyright_holder = You User
copyright_year = 2013
[@Author::GETTY]
author = YOUONCPANDESCRIPTION
This is the plugin bundle that GETTY uses. You can configure it (given values are default):
[@Author::GETTY]
author = GETTY
deprecated = 0
release_branch = main
weaver_config = @Author::GETTY
no_cpan = 0
no_install = 0
no_makemaker = 0
no_installrelease = 0
no_changes = 0
no_podweaver = 0
xs = 0
installrelease_command = cpanm .In default configuration it is equivalent to:
[@Filter]
-bundle = @Basic
-remove = GatherDir
-remove = PruneCruft
[PkgVersion]
[MetaConfig]
[MetaJSON]
[PodSyntaxTests]
[GithubMeta]
[InstallRelease]
install_command = cpanm .
[Authority]
authority = cpan:GETTY
do_metadata = 1
[PodWeaver]
config_plugin = @Author::GETTY
[Repository]
[Git::CheckFor::CorrectBranch]
release_branch = main
[@Git::VersionManager]
; handles versioning, changelog (NextRelease), commits, tags, and pushIf the task argument is given to the bundle, PodWeaver is replaced with TaskWeaver and AutoVersion is used for versioning (instead of @Git::VersionManager). You can also give a bigger major version with version:
[@Author::GETTY]
task = 1If the manual_version argument is given, AutoVersion and Git::NextVersion are omitted.
[@Author::GETTY]
manual_version = 1.222333You can also use shortcuts for integrating Dist::Zilla::Plugin::Run:
[@Author::GETTY]
run_after_build = script/do_this.pl --dir %s --version %s
run_before_build = script/do_this.pl --version %s
run_before_release = script/myapp_before1.pl %s
run_release = deployer.pl --dir %d --tgz %a --name %n --version %v
run_after_release = script/myapp_after.pl --archive %s --version %s
run_test = script/tester.pl --name %n --version %v some_file.ext
run_if_release_test = ./Build install
run_if_release_test = make installYou can also use add up configuration for Dist::Zilla::Plugin::Git::GatherDir, excluding root or prefix:
[@Author::GETTY]
gather_include_dotfiles = 1 # activated by default
gather_include_untracked = 0
gather_exclude_filename = dir/skip
gather_exclude_match = ^local_It also combines on request with Dist::Zilla::Plugin::Alien, you can set all parameter of the Alien plugin here, just by preceeding with alien_, the only required parameter here is alien_repo:
[@Author::GETTY]
alien_repo = http://myapp.org/releases
alien_bins = myapp myapp_helper
alien_name = myapp
alien_pattern_prefix = myapp-
alien_pattern_version = ([\d\.]+)
alien_pattern_suffix = \.tar\.gz
alien_pattern = myapp-([\d\.]+)\.tar\.gzATTRIBUTES
author
This is used to name the CPAN author of the distribution. See "authority" in Dist::Zilla::Plugin::Authority.
deprecated
Adds Dist::Zilla::Plugin::Deprecated to the distribution.
release_branch
This variable is used to set the release_branch, only releases on this branch will be allowed. See "release_branch" in Dist::Zilla::Plugin::Git::CheckFor::CorrectBranch.
weaver_config
This defines the PodWeaver config that is used. See config_plugin on Dist::Zilla::Plugin::PodWeaver.
no_github
If set to 1, this attribute will disable Dist::Zilla::Plugin::GithubMeta and will add Dist::Zilla::Plugin::Repository instead.
no_cpan
If set to 1, this attribute will disable Dist::Zilla::Plugin::UploadToCPAN. By default a dzil release would release to CPAN.
no_changes
If set to 1, then Dist::Zilla::Plugin::NextRelease (from @Git::VersionManager) will not generate changes entries.
no_podweaver
If set to 1, then Dist::Zilla::Plugin::PodWeaver is not used.
xs
If set to 1, then Dist::Zilla::Plugin::ModuleBuildTiny. This will also automatically set no_makemaker to 1.
no_install
If set to 1, the resulting distribution can't be installed.
no_makemaker
If set to 1, the resulting distribution will not use Dist::Zilla::Plugin::MakeMaker. This is an internal function, and you should know what you do, if you activate this flag.
no_installrelease
By default, this bundle will install your distribution after the release. If you set this attribute to 1, then this will not happen. See Dist::Zilla::Plugin::InstallRelease.
If you use the Dist::Zilla::Plugin::Alien options, then this one will not use Dist::Zilla::Plugin::InstallRelease, instead, it will use the trick mentioned in "InstallRelease" in Dist::Zilla::Plugin::Alien.
installrelease_command
If you don't like the usage of App::cpanminus to install your distribution after install, you can set another command here. See install_command on Dist::Zilla::Plugin::InstallRelease.
irc
Specify an IRC channel for support. This will be added to the distribution metadata and displayed in the SUPPORT section of the generated POD.
[@Author::GETTY]
irc = #perlThe channel name can be specified with or without the leading #.
irc_server
Specify the IRC server. Defaults to irc.perl.org.
[@Author::GETTY]
irc = #mychannel
irc_server = irc.libera.chatSEE ALSO
Dist::Zilla::Plugin::Authority
Dist::Zilla::PluginBundle::Git
Dist::Zilla::PluginBundle::Git::VersionManager
Dist::Zilla::Plugin::Git::CheckFor::CorrectBranch
Dist::Zilla::Plugin::GithubMeta
Dist::Zilla::Plugin::InstallRelease
Dist::Zilla::Plugin::MakeMaker::SkipInstall
Dist::Zilla::Plugin::PodWeaver
Dist::Zilla::Plugin::Repository
Dist::Zilla::Plugin::TaskWeaver
SUPPORT
Issues
Please report bugs and feature requests on GitHub at https://github.com/Getty/p5-dist-zilla-pluginbundle-author-getty/issues.
IRC
You can reach Getty on irc.perl.org for questions and support.
CONTRIBUTING
Contributions are welcome! Please fork the repository and submit a pull request.
AUTHOR
Torsten Raudssus <torsten@raudssus.de> https://raudss.us/
COPYRIGHT AND LICENSE
This software is copyright (c) 2025 by Torsten Raudssus <torsten@raudssus.de> https://raudss.us/.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.