View on
MetaCPAN
Brendan Byrd > Dist-Zilla-PluginBundle-Author-BBYRD > Dist::Zilla::PluginBundle::Author::BBYRD

Download:
Dist-Zilla-PluginBundle-Author-BBYRD-1.06.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 1.06   Source  

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
    notify_irc = irc://irc.perl.org/#sanity
    ; 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 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 https://github.com/SineSwiper/Dist-Zilla-PluginBundle-Author-BBYRD.

The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit http://www.perl.com/CPAN/ to find a CPAN site near you, or see https://metacpan.org/module/Dist::Zilla::PluginBundle::Author::BBYRD/.

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: http://en.wikipedia.org/wiki/Internet_Relay_Chat. Please be courteous and patient when talking to us, as we might be busy or sleeping! You can join those networks/channels and get help:

Bugs / Feature Requests

Please report any bugs or feature requests via https://github.com/SineSwiper/Dist-Zilla-PluginBundle-Author-BBYRD/issues.

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)
syntax highlighting: