Dist::Zilla::PluginBundle::Author::DOHERTY - configure Dist::Zilla like DOHERTY


version 0.42


Just put [@Author::DOHERTY] in your dist.ini. You can supply the following options:

  • custom_build specifies to use Dist::Zilla::Plugin::ModuleBuild::Custom instead of generating boilerplate ExtUtils::MakeMaker and Module::Build build tools.

  • fake_release specifies whether to use FakeRelease instead of UploadToCPAN.

    Default is false.

  • enable_tests is a comma-separated list of testing plugins to add to TestingMania.

    Default is none.

  • disable_tests is a comma-separated list of testing plugins to skip in TestingMania.

    Default is none.

  • tag_format specifies how a git release tag should be named. This is passed to Git::Tag.

    Default is %v%t .

  • version_regexp specifies a regexp to find the version number part of a git release tag. This is passed to Git::NextVersion.

    Default is ^(v.+)$.

  • twitter says whether releases of this module should be tweeted.

    Default is true.

  • surgical says to use Dist::Zilla::Plugin::SurgicalPodWeaver.

    Default is false.

  • max_target_perl is the highest minimum version of perl you intend to require. This is passed to Dist::Zilla::Plugin::Test::MinimumVersion, which generates a minimum-version.t test that'll warn you if you accidentally used features from a higher version of perl than you wanted. (Having a lower required version of perl is okay.)

  • changelog is the filename of the changelog.

    Default is Changes.

  • push_to is the git remote to push to; can be specified multiple times.

    Default is origin.

  • github is a boolean specifying whether to use the plugins Dist::Zilla::Plugin::GitHub::Meta and Dist::Zilla::Plugin::GitHub::Update.

  • critic_config is a filename to pass through to Dist::Zilla::Plugin::Test::Perl::Critic.

  • fork_is_authoritative tells GitHub::Meta that your fork is authoritative. That means that the repository, issues, etc will point to your stuff on github, instead of wherever you forked from. This is useful if your repository on Github is a fork, but you have taken over maintaining the module, so people should probably send bug reports to you instead of the original author, and should fork from your repo, etc.

  • github_metadata_remote tells GitHub::Meta that this is the Github repository from which to take metadata. This can be freely combined with fork_is_authoritative to control whether we "follow the symlink" if the repo this points to is a fork. By default, the repo will be extracted from the url for the origin remote.

  • release_to is a string that specifies where to send the release. Valid release targets are:

    • PAUSE (or CPAN)

      We'll use UploadToPAUSE to do the release, and clean up afterwards. This is the default

    • local

      We will do all the releasey things like tagging and pushing and whatnot, but we won't do any releasing things, and we won't clean up. This leaves the release tarball sitting there for you to do with as you will.

    In the future, there might be an option to scp the tarball somewhere.

  • has_version and strict_version set options in Dist::Zilla::PluginBundle::TestingMania, which passes them along to Dist::Zilla::Plugin::Test::Version and thus Test::Version. They set has_version and is_strict respectively.

  • sharedir indicates which directory is your dist's share directory. The default is share.



Do a fake release.


Specify release targets - can be specified multiple times.


Don't do things that need a network connection: sets github and twitter to false; sets push_to to an empty array ref (ie: don't push anywhere); and sets release_to to local.





    # in dist.ini


Dist::Zilla::PluginBundle::Author::DOHERTY provides shorthand for a Dist::Zilla configuration that does what Mike wants.


The project homepage is

The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit to find a CPAN site near you, or see


The development version is on github at and may be cloned from git://


You can make new bug reports, and view existing ones, through the web interface at


Mike Doherty <>


This software is copyright (c) 2010 by Mike Doherty <>.

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