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:
[@Author::DOHERTY]
custom_build specifies to use Dist::Zilla::Plugin::ModuleBuild::Custom instead of generating boilerplate ExtUtils::MakeMaker and Module::Build build tools.
custom_build
fake_release specifies whether to use FakeRelease instead of UploadToCPAN.
fake_release
FakeRelease
UploadToCPAN
Default is false.
enable_tests is a comma-separated list of testing plugins to add to TestingMania.
enable_tests
TestingMania
Default is none.
disable_tests is a comma-separated list of testing plugins to skip in TestingMania.
disable_tests
tag_format specifies how a git release tag should be named. This is passed to Git::Tag.
tag_format
Git::Tag
Default is %v%t .
%v%t
version_regexp specifies a regexp to find the version number part of a git release tag. This is passed to Git::NextVersion.
version_regexp
Git::NextVersion
Default is ^(v.+)$.
^(v.+)$
twitter says whether releases of this module should be tweeted.
twitter
Default is true.
surgical says to use Dist::Zilla::Plugin::SurgicalPodWeaver.
surgical
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.)
max_target_perl
changelog is the filename of the changelog.
changelog
Default is Changes.
push_to is the git remote to push to; can be specified multiple times.
push_to
Default is origin.
origin
github is a boolean specifying whether to use the plugins Dist::Zilla::Plugin::GitHub::Meta and Dist::Zilla::Plugin::GitHub::Update.
github
critic_config is a filename to pass through to Dist::Zilla::Plugin::Test::Perl::Critic.
critic_config
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.
fork_is_authoritative
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.
github_metadata_remote
release_to is a string that specifies where to send the release. Valid release targets are:
release_to
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.
has_version
strict_version
is_strict
sharedir indicates which directory is your dist's share directory. The default is share.
sharedir
--fake-release
Do a fake release.
--release-to
Specify release targets - can be specified multiple times.
--offline
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.
NO_TEST
If true, doesn't add TestRelease or CheckExtraTests.
Dist::Zilla
# in dist.ini [@Author::DOHERTY]
Dist::Zilla::PluginBundle::Author::DOHERTY provides shorthand for a Dist::Zilla configuration that does what Mike wants.
Dist::Zilla::PluginBundle::Author::DOHERTY
The project homepage is http://metacpan.org/release/Dist-Zilla-PluginBundle-Author-DOHERTY/.
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::DOHERTY/.
The development version is on github at https://github.com/doherty/Dist-Zilla-PluginBundle-Author-DOHERTY and may be cloned from git://github.com/doherty/Dist-Zilla-PluginBundle-Author-DOHERTY.git
You can make new bug reports, and view existing ones, through the web interface at https://github.com/doherty/Dist-Zilla-PluginBundle-Author-DOHERTY/issues.
Mike Doherty <doherty@cpan.org>
This software is copyright (c) 2010 by Mike Doherty <doherty@cpan.org>.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Dist::Zilla::PluginBundle::Author::DOHERTY, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Dist::Zilla::PluginBundle::Author::DOHERTY
CPAN shell
perl -MCPAN -e shell install Dist::Zilla::PluginBundle::Author::DOHERTY
For more information on module installation, please visit the detailed CPAN module installation guide.