NAME
Dist::Zilla::PluginBundle::Author::BBYRD - DZIL Author Bundle for BBYRD
SYNOPSIS
; Very similar to...
[ReportPhase]
; Makefile.PL maker
[MakeMaker]
[Authority]
authority = cpan:BBYRD
locate_comment = 1
[Git::NextVersion]
first_version = 0.90
[Git::GatherDir]
; File modifiers
[OurPkgVersion]
[PodWeaver]
config_plugin = @Author::BBYRD
; File pruners
[PruneCruft]
; Extra file creation
[ChangelogFromGit::CPAN::Changes]
file_name = CHANGES
copy_to_root = 0
[ManifestSkip]
[Manifest]
[License]
[ReadmeAnyFromPod / ReadmePodInRoot] ; Pod README for Root (for GitHub, etc.)
[ReadmeAnyFromPod / ReadmeTextInBuild] ; Text README for Build
[ReadmeAnyFromPod / ReadmeHTMLInBuild] ; HTML README for Build (never POD, so it doesn't get installed)
[InstallGuide]
[ExecDir]
; Many tests
[@TestingMania]
disable = Test::Perl::Critic
disable = Test::EOL
disable = Test::Kwalitee
disable = Test::Pod::LinkCheck
disable = MetaTests
changelog = CHANGES
; POD tests
;[Test::PodSpelling] ; Win32 install problems
; Other xt/* tests
[RunExtraTests]
;[MetaTests] ; until Test::CPAN::Meta supports 2.0
[Test::EOL]
trailing_whitespace = 0
[Test::CheckDeps]
;[Test::Pod::LinkCheck] ; Both of these are borked...
;[Test::Pod::No404s] ; ...I really need to create my own
[Test::ReportPrereqs]
[Test::CheckManifest]
; Prereqs
[@Prereqs]
minimum_perl = 5.10.1
[CheckPrereqsIndexed]
; META maintenance
[MetaConfig]
[MetaJSON]
[MetaYAML]
[MetaNoIndex]
directory = t
directory = xt
directory = examples
directory = corpus
[MetaProvides::Package]
meta_noindex = 1 ; respect prior no_index directives
[GithubMeta]
issues = 1
user = SineSwiper
[ContributorsFromGit]
[MetaResources] ; only loaded if needed
x_IRC = $x_IRC
; Post-build plugins
[CopyFilesFromBuild]
move = .gitignore
move = README.pod
; Post-build Git plugins
[TravisYML]
notify_email = 0
; used for Travis::TestRelease
support_builddir = 1
; keep sanity from balking at these
post_before_install_build = cpanm --quiet --notest --skip-satisfied autovivification indirect multidimensional
[Git::CheckFor::CorrectBranch]
[Git::CommitBuild]
branch =
release_branch = build/%b
release_message = Release build of v%v (on %b)
[@Git]
allow_dirty = dist.ini
allow_dirty = .travis.yml
allow_dirty = README.pod
changelog =
commit_msg = Release v%v
push_to = origin master:master
push_to = origin build/master:build/master
[GitHub::Update]
metacpan = 1
[TestRelease]
[Travis::TestRelease]
create_builddir = 1
[ConfirmRelease]
[UploadToCPAN]
[InstallRelease]
[Clean]
; sanity deps
; authordep autovivification
; authordep indirect
; authordep multidimensional
DESCRIPTION
I frelling hate these things, but several releases in, I found myself
needing to keep my dist.ini stuff in sync, which requires a single
module to bind them to.
NAMING SCHEME
I'm a strong believer in structured order in the chaos that is the CPAN
namespace. There's enough cruft in CPAN, with all of the forked
modules, legacy stuff that should have been removed 10 years ago, and
confusion over which modules are available vs. which ones actually
work. (Which all stem from the same base problem, so I'm almost
repeating myself...)
Like I said, I hate writing these personalized modules on CPAN. I even
bantered around the idea of using MetaCPAN's author JSON input
master/BeLike-You.pod> to store the plugin data. However, keeping the
Author plugins separated from the real PluginBundles is a step in the
right direction. See KENTNL's comments on the Author namespace for more
information.
CAVEATS
This uses Dist::Zilla::Role::PluginBundle::Merged, so all of the
plugins' arguments are available, using Merged's rules. Special care
should be made with arguments that might not be unique with other
plugins. (Eventually, I'll throw these into config_rename.)
If this is a problem, you might want to consider using @Filter.
One exception is x_IRC, which is detected and passed to MetaResources
properly.
SEE ALSO
In building my ultimate dist.ini file, I did a bunch of research on
which modules to cram in here. As a result, this is a pretty large set
of plugins, but that's exactly how I like my DZIL. Feel free to
research the modules listed here, as there's a bunch of good modules
that you might want to include in your own dist.ini and/or Author
bundle.
AVAILABILITY
The project homepage is
The latest version of this module is available from the Comprehensive
CPAN site near you, or see
SUPPORT
Internet Relay Chat
You can get live help by using IRC ( Internet Relay Chat ). If you
don't know what IRC is, please read this excellent guide:
and patient when talking to us, as we might be busy or sleeping! You
can join those networks/channels and get help:
* irc.perl.org
You can connect to the server at 'irc.perl.org' and talk to this
person for help: SineSwiper.
Bugs / Feature Requests
Please report any bugs or feature requests via
es.
AUTHOR
Brendan Byrd <BBYRD@CPAN.org>
CONTRIBUTOR
Sergey Romanov <complefor@rambler.ru>
COPYRIGHT AND LICENSE
This software is Copyright (c) 2015 by Brendan Byrd.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)