NAME

Dist::Zilla::PluginBundle::Author::AJNN - Dist::Zilla configuration the way AJNN does it

VERSION

version 0.03

SYNOPSIS

in dist.ini:

 name = Example-Dist-Name
 main_module = lib/Local/Example.pm
 
 author  = Jane Doe <doe@example.org>
 license = Artistic_2_0
 copyright_holder = Jane Doe
 copyright_year   = 2020
 
 version = 0.123
 release_status = unstable
 
 [@Author::AJNN]
 
 [AutoPrereqs]

skip some parts if required:

 [@Author::AJNN]
 -remove = CheckChangeLog
 -remove = Git::Check

DESCRIPTION

This is the configuration I use for Dist::Zilla.

(Most likely you don't want or need to read this.)

OVERVIEW

This plugin bundle is nearly equivalent to the following dist.ini config:

 [GatherDir]
 exclude_filename = README.md
 exclude_filename = cpanfile
 exclude_filename = dist.ini
 exclude_match = ~|\.webloc$
 prune_directory = ^cover_db$|^Stuff$|\.bbprojectd$
 [PruneCruft]
 [PruneAliases]
 
 [CPANFile]
 [MetaJSON]
 [MetaYAML]
 [MetaProvides::Package]
 [PkgVersion]
 die_on_existing_version = 1
 die_on_line_insertion = 1
 [GithubMeta]
 issues = 1
 homepage = ''
 
 [Git::Check]
 allow_dirty =
 [CheckChangeLog]
 [TestRelease]
 [ConfirmRelease]
 [UploadToCPAN]
 [Git::Tag]
 tag_format = '%V'
 tag_message = '%V%t  %{yyyy-MM-dd}d%n%c'
 
 [MakeMaker]
 [@Author::AJNN::Readme]
 [Manifest]
 
 [FileFinder::Filter / PodWeaverFiles]
 finder = :InstallModules
 finder = :ExecFiles
 [PodWeaver]
 finder = PodWeaverFiles
 config_plugin = @Author::AJNN
 
 [Test::MinimumVersion]
 [PodSyntaxTests]
 [RunExtraTests]

ATTRIBUTES

-remove

Moniker of a plugin that is to be removed from this bundle. May be given multiple times. See Dist::Zilla::PluginBundle::Filter. Offered here as a workaround for RT 81958.

 -remove = Git::Check

cpan_release

Whether or not this distribution is meant to be released to "/www.cpan.org/ CPAN" in https:. The default is yes, but for software of low quality or little interest to others, it can be set to no.

 cpan_release = 0

GatherDir.exclude_match

Files or directories that match any of these regular expressions will not be included in the build. May be given multiple times. See "exclude_match" in Dist::Zilla::Plugin::GatherDir.

 GatherDir.exclude_match = private_dir
 GatherDir.exclude_match = \.data$

PodWeaver.skip

PodWeaver will not be applied to a file that matches any of these regular expressions. May be given multiple times. See "skip" in Dist::Zilla::Plugin::FileFinder::Filter.

 PodWeaver.skip = \.pod$
 PodWeaver.skip = Net/(?:SSL|TLS)

Test::MinimumVersion.max_target_perl

A syntax test for the specified target version will be generated. If omitted or set to 0, the test will not be generated. See Dist::Zilla::Plugin::Test::MinimumVersion.

 Test::MinimumVersion.max_target_perl = v5.26

BUGS

This configuration is hacked together specifically for AJNN's needs. It has not been designed with extensibility or reusability in mind. No forward or backward compatibility should be expected.

SEE ALSO

Dist::Zilla::PluginBundle::Author::AJNN::Readme

Pod::Weaver::PluginBundle::Author::AJNN

Dist::Zilla::Role::PluginBundle::Easy

Dist::Zilla::PluginBundle::Filter

AUTHOR

Arne Johannessen <ajnn@cpan.org>

If you contact me by email, please make sure you include the word "Perl" in your subject header to help beat the spam filters.

COPYRIGHT AND LICENSE

Arne Johannessen has dedicated the work to the Commons by waiving all of his or her rights to the work worldwide under copyright law and all related or neighboring legal rights he or she had in the work, to the extent allowable by law.

Works under CC0 do not require attribution. When citing the work, you should not imply endorsement by the author.