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](https://metacpan.org/pod/Dist::Zilla::Plugin::FakeRelease)
instead of[UploadToCPAN](https://metacpan.org/pod/Dist::Zilla::Plugin::UploadToCPAN)
.Default is false.
-
enable_tests
is a comma-separated list of testing plugins to add to[TestingMania](https://metacpan.org/pod/Dist::Zilla::PluginBundle::TestingMania)
.Default is none.
-
disable_tests
is a comma-separated list of testing plugins to skip in[TestingMania](https://metacpan.org/pod/Dist::Zilla::PluginBundle::TestingMania)
.Default is none.
-
tag_format
specifies how a git release tag should be named. This is passed to[Git::Tag](https://metacpan.org/pod/Dist::Zilla::Plugin::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](https://metacpan.org/pod/Dist::Zilla::Plugin::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 aminimum-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 withfork_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 theorigin
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
andstrict_version
set options in Dist::Zilla::PluginBundle::TestingMania, which passes them along to Dist::Zilla::Plugin::Test::Version and thus Test::Version. They sethas_version
andis_strict
respectively. -
sharedir
indicates which directory is your dist's share directory. The default isshare
.
-
--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
andtwitter
to false; setspush_to
to an empty array ref (ie: don't push anywhere); and setsrelease_to
to local.
-
NO_TEST
If true, doesn't add TestRelease or CheckExtraTests.
[Dist::Zilla](https://metacpan.org/pod/Dist::Zilla)
# in dist.ini
[@Author::DOHERTY]
Dist::Zilla::PluginBundle::Author::DOHERTY
provides shorthand for
a Dist::Zilla configuration that does what Mike wants.
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.