Dist/Zilla/PluginBundle/Author/TABULO.pm

filter: Statementstmt 91.4% 299 / 327 Branchbran 54.3% 62 / 114 Conditioncond 43.9% 51 / 116 MC/DCmcdc 11.2% 7 / 62 Subroutinesub 91.3% 53 / 58 Podpod 0.0% 0 / 3 totaltotal 69.4% 472 / 680 CC 105 SCAR 32.9
CC
105
Cov
74%
_prepare_plugins
69.2
_plug__GitPush
43.2
_plug__CopyFiles
23.6
CRAP 26.9
↑ Summary Zest/Author/TABULO/MungersForHas.pm »
1 package Dist::Zilla::PluginBundle::Author::TABULO;
2 ### ex: set ft=perl noai ts=4 sw=4:
3  
4 2 our $VERSION = '1.000014';
5  
6 2 ▶use 5.026; # Indented HEREDOC.
Subroutine BEGIN: called CC=1 SCAR=0.0
7 2 ▶use Data::Printer qw(p np);
Subroutine BEGIN: called CC=1 SCAR=0.0
8 2 ▶use Data::Printer qw(p np);
Subroutine BEGIN: called CC=1 SCAR=0.0
9 2 ▶use List::Util qw(uniq);
Subroutine BEGIN: called CC=1 SCAR=0.0
10 2 ▶use Module::Runtime qw(require_module use_module);
Subroutine BEGIN: called CC=1 SCAR=0.0
11 2 ▶use Path::Tiny qw(path);
Subroutine BEGIN: called CC=1 SCAR=0.0
12 2 ▶use PerlX::Maybe qw(maybe);
Subroutine BEGIN: called CC=1 SCAR=0.0
13  
14 # our own modules
15 2 ▶use Pod::Weaver::PluginBundle::Author::TABULO;
Subroutine BEGIN: called CC=1 SCAR=0.0
16 2 ▶use Pod::Wordlist::Author::TABULO;
Subroutine BEGIN: called CC=1 SCAR=0.0
17 2 ▶use Zest::Author::TABULO::MungersForHas qw(hm_tabulo);
Subroutine BEGIN: called CC=1 SCAR=0.0
18 2 ▶use Zest::Author::TABULO::Util::List qw(flat uniq_sort_flat);
Subroutine BEGIN: called CC=1 SCAR=0.0
19 2 ▶use Zest::Author::TABULO::Util::Mayhap qw(mayhap);
Subroutine BEGIN: called CC=1 SCAR=0.0
20 2 ▶use Zest::Author::TABULO::Util::Dzil qw(grok_plugins);
Subroutine BEGIN: called CC=1 SCAR=0.0
21 2 ▶use Zest::Author::TABULO::Util::Text qw(docstr);
Subroutine BEGIN: called CC=1 SCAR=0.0
22  
23 2 ▶use Moose;
Subroutine BEGIN: called CC=1 SCAR=0.0
24 2 with
25 'Dist::Zilla::Role::PluginBundle::Easy',
26 'Dist::Zilla::Role::PluginBundle::Config::Slicer',
27 'Dist::Zilla::Role::PluginBundle::PluginRemover';
28 2 ▶use namespace::clean;
Subroutine BEGIN: called CC=1 SCAR=0.0
29  
30 #region #=== CONSTANTS ===
31  
32 2 my %allowed_installers = (
33 MakeMaker => 1,
34 'MakeMaker::Awesome' => 1,
35 ModuleBuild => 1,
36 ModuleBuildTiny => 1,
37 'ModuleBuildTiny::Fallback' => 1,
38 );
39 2 my @allowed_installers = grep { $allowed_installers{$_} } sort keys %allowed_installers;
40 2 my @allowed_copy_modes = qw/Regenerate Release Build Build::Filtered None/;
41  
42 2 my @allow_dirty = qw(dist.ini Changes);
43 2 my %boilerplate = (
44 distmeta => [qw(cpanfile Meta.yml META.json)],
45 installer => [qw(Build.PL Makefile.PL ppport.h)],
46 readme => [qw(README README.md README.mkdn README.pod)],
47 readme_too => [qw(CODE_OF_CONDUCT CONTRIBUTING LICENCE LICENSE INSTALL)],
48 );
49 2 my @boilerplate = uniq( sort map { @$_ } ( values %boilerplate ) );
50  
51 2 my @never_gather = (
52 @boilerplate, qw(
53 TODO
54 inc/ExtUtils/MakeMaker/Dist/Zilla/Develop.pm
55 )
56 );
57  
58 2 my @prune_not = map { qr/"$_"/ } qw (
59 \.travis\.yml
60 \.perltidyrc
61 .*/\.gitignore$
62 .*/\.(git)?keep$
63 );
64  
65 #endregion CONSTANTS
66  
67 #region: #=== ATTRIBUTES ===
68  
69 ##== DRY mungers for MooseX::MungeHas (see below)
70 2 ▶use MooseX::MungeHas 'is_ro', \&hm_tabulo;
Subroutine BEGIN: called CC=1 SCAR=0.0
71  
72 2 ▶sub mvp_aliases {
Subroutine mvp_aliases: called CC=1 SCAR=0.0
Pod undocumented
73 return +{
74 2 auto_prereq => 'auto_prereqs',
75 exclude_filename => 'exclude_filenames',
76 regenerate => 'copy',
77 copy_from => 'copy_mode',
78 git_remote => 'git_remotes',
79 stopword => 'stopwords',
80 stopwords_file => 'stopwords_files',
81 stopwords_provider => 'stopwords_providers',
82 wordlist => 'stopwords_providers',
83 wordlists => 'stopwords_providers',
84 };
85 }
86  
87 ##== Most of the below options were adapted from various sources,
88 ## such as: @DAGOLDEN, @DROLSKY, @ETHER, @KENTNL (MHRIP), @Starter, @Starter::Git
89  
90 2 has archive_dir => (
91 isa => 'Str',
92 default => 'releases',
93 -doc => docstr("
94 Passed as the 'directory' option, to [ArchiveRelease] whose docs are quoted below:
95  
96 * The 'directory' [name] may begin with ~ (or ~user) to mean your (or some other user's) home directory.
97 * If the directory doesn't exist, it will be created during the BeforeRelease phase.
98 * All files inside this directory will be pruned from the distribution.
99 "),
100 );
101  
102 2 has authority => (
103 isa => 'Str',
104 default => 'cpan:TABULO',
105 -doc => "Specifies the x_authority field for PAUSE.",
106 );
107  
108 2 has auto_prereqs => (
109 isa => 'Bool',
110 default => 1,
111 -doc => "Indicates whether or not to use [AutoPrereqs].",
112 );
113  
114 2 has auto_version => (
115 isa => 'Bool',
116 default => 0,
117 -doc => "Indicates whether or not to use [AutoVersion] instead of our standard plugins for version management.",
118 );
119  
120 has copy => (
121 isa => 'ArrayRef',
122 1 ▶ default => sub { [] },
Subroutine __ANON__: called CC=1 SCAR=0.0
123 2 -doc => docstr("
124 Additional files to copy (or regenerate) in addition to those that are already harvested by default. [May be repeated]. Note that the copying may be done from the build or the release, depending on the 'copy_mode' setting. See 'copy_mode'.
125 "),
126 );
127  
128 2 has copy_mode => (
129 isa => 'Maybe[Str]',
130 default => 'Release',
131 -doc => docstr("
132 Determines the 'copy-mode' and hence ultimately the set of plugins used for that purpose. Possible values are ["
133 . join( ', ', @allowed_copy_modes )
134 . "]. dzil 'regenerate' command will still work.
135 "),
136 );
137  
138 has copy_not => (
139 isa => 'ArrayRef',
140 2 ▶ default => sub { [] },
Subroutine __ANON__: called CC=1 SCAR=0.0
141 2 -doc => "Do NOT copy given file(s). [May be repeated].",
142 );
143  
144 2 has darkpan => (
145 isa => 'Bool',
146 default => 0,
147 -doc => "For private code; uses [FakeRelease] and fills in dummy repo/bugtracker data.",
148 );
149  
150 2 has dist_genre => (
151 isa => 'Str',
152 default => 'standard',
153 -doc => docstr("
154 Specifies the 'genre' of the distro. Currently allowed values are: 'standard' (the default) and 'task'.
155  
156 This may be used in the future to associate a set behaviours/settings to given genres.
157  
158 Currently, the only distinction made is for the 'task' genre, which will result in [TaskWeaver] being used
159 instead of [SurgicalPodWeaver].
160 "),
161 );
162  
163 has exclude_filenames => (
164 isa => 'ArrayRef',
165 2 ▶ default => sub { [] },
Subroutine __ANON__: called CC=1 SCAR=0.0
166 2 -doc => "Do NOT gather given file(s). [May be repeated].",
167 );
168  
169 has exclude_match => (
170 isa => 'ArrayRef',
171 2 ▶ default => sub { [] },
Subroutine __ANON__: called CC=1 SCAR=0.0
172 2 -doc => "Do NOT gather file(s) that match the given pattern(s). [May be repeated].",
173 );
174  
175 has exec_dir => (
176 isa => 'Maybe[Str]',
177 2 ▶ default => sub { $_[0]->installer =~ /Module::Build::Tiny/ ? 'script' : undef },
Subroutine __ANON__: called CC=2 SCAR=7.6
Branch: 1 branch
BranchTrueFalseTotal
$_[0]->installer =~ /Module::Build::Tiny/u ? : 0 2 2
178 2 -doc => docstr("
179 If defined, passed to [ExecDir] as its 'dir' option.
180 Defaults to 'script' when the installer is [Module::Build::Tiny],undef otherwise, which means the [ExecDir] default will be in effect, and that is 'bin' as of this writing.,
181 "),
182 );
183  
184 2 has fake_release => (
185 isa => 'Bool',
186 default => 0,
187 -doc => docstr("
188 Swaps [FakeRelease] for [UploadToCPAN]. Mostly useful for testing a dist.ini without risking a real release.
189 Note that this can also be achieved by setting the FAKE_RELEASE environment variable (which will have precedence over this option).
190 "),
191 );
192  
193 has has_xs => (
194 isa => 'Bool',
195 0 ▶ default => sub { glob('*.xs') ? 1 : 0 }, # @ETHER
Subroutine __ANON__: not called CC=2 SCAR=17.9
Branch: 1 branch
BranchTrueFalseTotal
glob('*.xs') ? : 0 0 0
196 2 -doc => docstr("
197 Signifies that the distribution contains XS code.
198 "),
199 );
200  
201 2 has hub => (
202 isa => 'Maybe[Str]',
203 default => 'github',
204 -doc => docstr("
205 The repository 'hub' provider.
206 Currently, other than unsetting to undef, the only supported value, which is also the default, is 'github'.
207 Other providers, such as 'gitlab' or 'bitbucket', may be supported in the future.
208 "),
209 );
210  
211 has git_remotes => (
212 isa => 'ArrayRef',
213 0 ▶ default => sub { ['origin'] },
Subroutine __ANON__: not called CC=1 SCAR=6.9
214 2 -doc => "Where to push after release.",
215 );
216  
217 2 has github_issues => (
218 isa => 'Str',
219 default => 1,
220 -doc => "Whether or not to use github issue tracker.",
221 );
222  
223 2 has installer => (
224 default => 'MakeMaker',
225 -doc => "The installer to employ. Currently, possible values are: [" . join( ', ', @allowed_installers ) . "].",
226 );
227  
228 has is_task => ( #DEPRECATED
229 isa => 'Bool',
230 2 ▶ default => sub { ( $_[0]->dist_genre // '' ) =~ m/^task/i },
Subroutine __ANON__: called CC=2 SCAR=7.6
Condition50%1/2
$_[0]->dist_genre // ""
l!l
20
MC/DC0%0/1
$_[0]->dist_genre // ""
$_[0]->dist_genre
Truth table50%1/2
A
A= $_[0]->dist_genre
Aresult
11
00
231 2 -doc => docstr("
232 DEPRECATED. Prefer setting instead, like so:
233  
234 [\@Author::TABULO]
235 dist_genre=task
236  
237 Identifies this distro as a 'task'.
238  
239 Currently, the only distinction is that, for a task, we use [TaskWeaver] instead of [SurgicalPodWeaver].
240 "),
241 );
242  
243 2 has manage_versions => ( # adopted from @Starter (also dropping the 'd' in the name)
244 isa => 'Bool',
245 default => 1,
246 -doc => "Whether or not to manage versioning, which means: providing, rewriting, bumping, munging \$VERSION in sources, ....",
247 );
248  
249 2 has no_archive => (
250 isa => 'Bool',
251 default => 0,
252 -doc => "Omit the [ArchiveRelease] plugin.",
253 );
254  
255 2 has no_copy => (
256 isa => 'Bool',
257 default => 0,
258 -doc => "Skip copying files from the build/release : ('Makefile.PL', 'cpanfile',' Meta.json', ...).",
259 );
260  
261 2 has no_coverage => (
262 isa => 'Bool',
263 default => 0,
264 -doc => "Omit PodCoverage tests -- which are actually done using [Test::Pod::Coverage::Configurable].",
265 );
266  
267 2 has no_critic => (
268 isa => 'Bool',
269 default => 0,
270 -doc => "Omit [Test::Perl::Critic] tests.",
271  
272 );
273  
274 2 has no_git => (
275 isa => 'Bool',
276 default => 0,
277 -doc => "Bypass all git-dependent plugins.",
278 );
279  
280 2 has no_git_commit => (
281 isa => 'Bool',
282 default => 0,
283 -doc => "Omit [Git::Commit] and [Git::CommitBuild] and related [Git::Tag] operations.",
284 );
285  
286 2 has no_git_commit_build => (
287 isa => 'Bool',
288 default => 0,
289 -doc => "Omit [Git::CommitBuild] and related [Git::Tag] operations.",
290 );
291  
292  
293 2 has no_git_push => (
294 isa => 'Bool',
295 default => 0,
296 -doc => "Omit [Git::Push].",
297 );
298  
299 2 has no_git_impact => (
300 isa => 'Bool',
301 default => 0,
302 -doc => docstr("
303 Omit any [Git:*] plugins that may modify the vcs repository state, such as : [Git::Commit], [Git::CommitBuild], [Git::Tag], [Git::Push] and the like.
304 Git plugins that are read-only, such as [Git::GatherDir] or [Git::Check] shouldn't be effected by this option.
305 "),
306 );
307  
308 has no_github => (
309 isa => 'Bool',
310 2 ▶ default => sub { ( $_[0]->hub // '' ) !~ m/^github$/ },
Subroutine __ANON__: called CC=2 SCAR=7.6
Condition50%1/2
$_[0]->hub // ""
l!l
20
MC/DC0%0/1
$_[0]->hub // ""
$_[0]->hub
Truth table50%1/2
A
A= $_[0]->hub
Aresult
11
00
311 2 -doc => docstr("
312 Do not assume that the repository is backed by 'github', which currently means abstaining from using [GithubMeta] and feeding fake values to [MetaResources] and [Bugtracker] -- which you may separately override, by the way, thanks to our[\@Config::Slicer] role.
313 "),
314 );
315  
316 2 has no_minimum_perl => (
317 isa => 'Bool',
318 default => 0,
319 -doc => "Omit [Test::MinimumVersion] tests.",
320 );
321  
322 has no_pod_coverage => (
323 isa => 'Bool',
324 2 ▶ default => sub { $_[0]->no_coverage // 0 },
Subroutine __ANON__: called CC=2 SCAR=7.6
Condition50%1/2
$_[0]->no_coverage // 0
l!l
20
MC/DC0%0/1
$_[0]->no_coverage // 0
$_[0]->no_coverage
Truth table50%1/2
A
A= $_[0]->no_coverage
Aresult
11
00
325 2 -doc => "Skip [PodCoverage] tests -- Well, [Test::Pod::Coverage::Configurable] tests, actually.",
326 );
327  
328 has no_pod_spellcheck => (
329 isa => 'Bool',
330 2 ▶ default => sub { $_[0]->no_spellcheck // 0 },
Subroutine __ANON__: called CC=2 SCAR=7.6
Condition50%1/2
$_[0]->no_spellcheck // 0
l!l
20
MC/DC0%0/1
$_[0]->no_spellcheck // 0
$_[0]->no_spellcheck
Truth table50%1/2
A
A= $_[0]->no_spellcheck
Aresult
11
00
331 2 -doc => "Skip [Test::PodSpelling] tests.",
332 );
333  
334 2 has no_portability_check => (
335 isa => 'Bool',
336 default => 0,
337 -doc => "Skip [Test::Portability] tests.",
338 );
339  
340 2 has no_sanitize_version => (
341 isa => 'Bool',
342 default => 0,
343 -doc => "When set => We won't prefer [RewriteVersion::Sanitized] over [RewriteVersion], which we normally do.",
344 );
345  
346 2 has no_spellcheck => (
347 isa => 'Bool',
348 default => 0,
349 -doc => "Omit [Test::PodSpelling] tests.",
350 );
351  
352 2 has pod_coverage_class => (
353 isa => 'Maybe[Str]',
354 -doc => "If defined, passed to [Test::Pod::Coverage::Configurable] as its 'class' option.",
355 );
356  
357 2 has pod_coverage_skip => (
358 isa => 'Maybe[ArrayRef]',
359 -doc => "If defined, passed to [Test::Pod::Coverage::Configurable] as its 'skip' option.",
360 );
361  
362 2 has pod_coverage_trustme => (
363 isa => 'Maybe[ArrayRef]',
364 -doc => "If defined, passed to [Test::Pod::Coverage::Configurable] as its 'trustme' option.",
365 );
366  
367 2 has pod_coverage_also_private => (
368 isa => 'Maybe[ArrayRef]',
369 -doc => "If defined, passed to [Test::Pod::Coverage::Configurable] as its 'also_private' option.",
370 );
371  
372 2 has tag_format => (
373 isa => 'Str',
374 default => 'repo-release-v%V%t',
375 -doc => docstr("
376 The tag format passed to [Git::Tag] after committing sources.
377 The default is 'repo-release-v%V%t', which may be prefixed by some other string.
378 The idea was copied from \@DAGOLDEN who chose something more robust than just the version number when parsing versions with a regex.
379 "),
380 );
381  
382 2 has tag_format_dist => (
383 isa => 'Str',
384 default => 'dist-release-v%V%t',
385 -doc => docstr("
386 The tag format passed to [Git::Tag] after committing the build.
387 The default is 'dist-release-v%V%t', which may be prefixed by some other string.
388 The idea was copied from \@DAGOLDEN who chose something more robust than just the version number when parsing versions with a regex.
389 "),
390 );
391  
392 has stopwords => ( ## ALIAS: stopword
393 isa => 'ArrayRef',
394 2 ▶ default => sub { [] },
Subroutine __ANON__: called CC=1 SCAR=0.0
395 2 -doc => docstr("
396 Additional stopword(s) for Pod::Spell tests. [May be repeated].
397 See also: 'stopword_files' and 'wordlists' for alternative mechanisms of adding stopwords.
398 "),
399 );
400  
401 has stopwords_files => ( ## ALIAS: stopwords_file
402 isa => 'ArrayRef',
403 2 ▶ default => sub { [ grep -e, qw(stopwords) ] },
Subroutine __ANON__: called CC=1 SCAR=0.0
404 2 -doc => docstr("
405 File(s) that describe additional stopword(s) for Pod::Spell tests. [May be repeated].
406 See also: 'stopwords' and 'wordlists' for alternative mechanisms of adding stopwords.
407 "),
408 );
409  
410 has stopwords_providers => ( ## ALIAS: wordlist
411 isa => 'ArrayRef',
412 2 ▶ default => sub { [q/Pod::Wordlist::Author::TABULO/] },
Subroutine __ANON__: called CC=1 SCAR=0.0
413 2 -doc => docstr("
414 Perl module(s) for contributing additional stopword(s) for spelling tests. [May be repeated].
415 Note that given module(s) would need to expose the same API as L<Pod::Wordlist>.
416 See also: 'stopwords' and 'stopword_files' for alternative mechanisms of adding stopwords.
417 "),
418 );
419  
420 2 has version_regexp => (
421 isa => 'Str',
422 default => '^(?:[-\w]+)?release-(.+)$',
423 -doc => "The version regex that corresponds to the 'tag_format'.",
424 );
425  
426 2 has weaver_config => (
427 isa => 'Str',
428 default => '@Author::TABULO',
429 -doc => "Specifies a Pod::Weaver bundle to be used.",
430 );
431  
432  
433 ##== PRIVATE attributes
434 has _fake_release => (
435 isa => 'Bool',
436 2 ▶ default => sub {
Subroutine __ANON__: called CC=4 SCAR=17.9
437 2 ▶ exists $ENV{FAKE_RELEASE} ? !!$ENV{FAKE_RELEASE} : $_[0]->fake_release // 0 || $_[0]->darkpan;
Branch: 1 branch
BranchTrueFalseTotal
exists $ENV{'FAKE_RELEASE'} ? : 0 2 2
Condition40%2/5
$_[0]->fake_release // 0 or $_[0]->darkpan
l!l&&r!l&&!r
002
$_[0]->fake_release // 0
l!l
20
MC/DC0%0/2
$_[0]->fake_release // 0 or $_[0]->darkpan
$_[0]->fake_release $_[0]->darkpan
Truth table0%0/3
A or B
A= $_[0]->fake_releaseB= $_[0]->darkpan
ABresult
1X1
011
000
438 },
439 2 -access => 'private',
440 -doc => "->fake_release (effective), also taking into account the \%ENV and other parameters.",
441 );
442  
443 2 has _stopwords => (
444 traits => ['Array'],
445 isa => 'ArrayRef',
446 builder => '_build__stopwords',
447 handles => {
448 _all_stopwords => 'elements',
449 },
450 -access => 'private',
451 -doc => "->stopwords (effective): also taking into account all valid sources: ->stopwords, ->stopwords_files, ->stopwords_providers, ...",
452 );
453  
454 has _harvested_files => (
455 traits => ['Array'],
456 isa => 'ArrayRef',
457 2 ▶ default => sub { [] },
Subroutine __ANON__: called CC=1 SCAR=0.0
458 2 handles => {
459 _all_harvested_files => 'elements',
460 _add_harvested_files => 'push',
461 _clear_harvested_files => 'clear',
462 },
463 -access => 'private',
464 -doc => docstr("
465 List of files that are effectively 'harvested', i.e. default candidates to be copied from the build/release.
466 This list is dynamically built during bundle configuration.
467 "),
468 );
469  
470 has _installer_files => (
471 traits => ['Array'],
472 isa => 'ArrayRef',
473 2 ▶ default => sub { [ $_[0]->installer =~ /MakeMaker/ ? 'Makefile.PL' : 'Build.PL' ] },
Subroutine __ANON__: called CC=2 SCAR=7.6
Branch: 1 branch
BranchTrueFalseTotal
$_[0]->installer =~ /MakeMaker/u ? : 2 0 2
474 2 -access => 'private',
475 -doc => docstr("
476 List of files that are expected to be generated for the given installer. (e.g. : Makefile.PL, Build.PL, ...).
477 TODO: handle 'ppport.h' and equivalent.
478 "),
479 );
480  
481 2 has _plugins => (
482 traits => ['Array'],
483 isa => 'ArrayRef',
484 builder => '_build_plugins',
485 -access => 'private',
486 -doc => "The roster on which we prepare our plugin configuration.",
487 );
488  
489 has _target_branches => (
490 traits => ['Array'],
491 isa => 'ArrayRef',
492 0 ▶ default => sub { [] },
Subroutine __ANON__: not called CC=1 SCAR=6.9
493 2 handles => {
494 _all_target_branches => 'elements',
495 _add_target_branches => 'push',
496 _clear_target_branches => 'clear',
497 },
498 -access => 'private',
499 -doc => "List of branches that will become targets for [Git::Push]",
500 );
501  
502 #region: BUILDARGS and co: copied/adapted from: @DROLSKY
503  
504 34 my @array_params = grep { !/^_/ } map { $_->name }
505 grep {
506 2 ▶ $_->has_type_constraint
Condition100%6/6
$_->has_type_constraint && ($_->type_constraint->is_a_type_of('ArrayRef') || $_->type_constraint->is_a_type_of('Maybe[ArrayRef]'))
!ll&&!rl&&r
27634
$_->type_constraint->is_a_type_of("ArrayRef") or $_->type_constraint->is_a_type_of("Maybe[ArrayRef]")
l!l&&r!l&&!r
28676
MC/DC100%3/3
$_->has_type_constraint && ($_->type_constraint->is_a_type_of('ArrayRef') || $_->type_constraint->is_a_type_of('Maybe[ArrayRef]'))
$_->has_type_constraint $_->type_constraint->is_a_type_of("ArrayRef") $_->type_constraint->is_a_type_of("Maybe[ArrayRef]")
Truth table100%4/4
A && B or C
A= $_->has_type_constraintB= $_->type_constraint->is_a_type_of("ArrayRef")C= $_->type_constraint->is_a_type_of("Maybe[ArrayRef]")
ABCresult
0XX0
1000
11X1
1011
507 && ( $_->type_constraint->is_a_type_of('ArrayRef') || $_->type_constraint->is_a_type_of('Maybe[ArrayRef]') )
508 } __PACKAGE__->meta->get_all_attributes;
509  
510 2 ▶sub mvp_multivalue_args {
Subroutine mvp_multivalue_args: called CC=1 SCAR=0.0
511 2 return @array_params;
512 }
513  
514 2 ▶around BUILDARGS => sub {
Subroutine __ANON__: called CC=4 SCAR=14.2
515 2 my $orig = shift;
516 2 my $class = shift;
517  
518 2 my $p = $class->$orig(@_);
519  
520 2 my %args = ( %{ $p->{payload} }, %{$p} );
521  
522 2 for my $key (@array_params) {
523 24 ▶ if ( $args{$key} && !ref $args{$key} ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($args{$key} and not ref $args{$key}) 0 24 24
Condition66%2/3
$args{$key} and not ref $args{$key}
!ll&&!rl&&r
2310
MC/DC0%0/2
$args{$key} and not ref $args{$key}
$args{$key} not ref $args{$key}
Truth table66%2/3
A and not(B)
A= $args{$key}B= not ref $args{$key}
ABresult
0X0
100
111
524 0 $args{$key} = [ delete $args{$key} ];
525 }
526  
527 # $args{$key} //= [];
528 }
529  
530 2 return \%args;
531 2 };
532  
533 #endregion @DROLSKY
534  
535  
536 #region #== ATTRIBUTE BUILDERS ==
537  
538 2 ▶sub _build__stopwords {
Subroutine _build__stopwords: called CC=4 SCAR=14.8
539 2 my $self = shift;
540  
541 2 my @teachers;
542 2 ▶ push @teachers, map { require_module $_ ? $_ : () } @{ $self->stopwords_providers };
Branch: 1 branch
BranchTrueFalseTotal
&require_module($_) ? : 2 0 2
543 0 ▶ push @teachers, map { path($_) // () } @{ $self->stopwords_files };
Condition0%0/3
path($_) // ()
l!l&&r!l&&!r
000
MC/DC0%0/2
path($_) // ()
path($_) ()
Truth table0%0/3
A // B
A= path($_)B= ()
ABresult
1X1
011
000
544 2 ▶ push @teachers, join( ' ', @{ $self->stopwords // [] } );
Condition50%1/2
$self->stopwords // []
l!l
20
MC/DC0%0/1
$self->stopwords // []
$self->stopwords
Truth table50%1/2
A
A= $self->stopwords
Aresult
11
00
545  
546 2 my $lexicon = Pod::Wordlist::Author::TABULO->new();
547 2 $lexicon->learn_stopwords_from(@teachers);
548 2 return [ sort keys %{ $lexicon->wordlist } ];
549 }
550  
551 #endregion
552  
553 #region #== DYNAMIC ATTRIBUTES (recomputed on each call) ==
554 0 ▶sub _all_git_remotes {
Subroutine _all_git_remotes: not called CC=2 SCAR=17.9
555 0 my $self = shift;
556 uniq ( split( ' ', join( ' ',
557 0 ▶ grep { defined $_ && $_ }
Condition0%0/3
defined $_ && $_
!ll&&!rl&&r
000
MC/DC0%0/2
defined $_ && $_
defined $_ $_
Truth table0%0/3
A && B
A= defined $_B= $_
ABresult
0X0
100
111
558 flat $self->git_remotes
559 )))
560 }
561  
562 5 ▶sub _files_to_copy { # from build (or release)
Subroutine _files_to_copy: called CC=1 SCAR=0.0
563 5 my $self = shift;
564 my @include = uniq(
565 5 sort @{ $self->_harvested_files },
566 5 @{ $self->copy }, # extras requested via "dist.ini"
567 @_ # extras requested via passed arguments
568 );
569 5 my @exclude = uniq( sort( @{ $self->copy_not } ) );
570 my @res = grep {
571 0 my $item = $_; not grep { $item eq $_ } @exclude
572 } @include;
573 5 [ uniq( sort(@res) ) ];
574 }
575  
576 1 ▶sub _allow_dirty_on_release_commit {
Subroutine _allow_dirty_on_release_commit: called CC=1 SCAR=0.0
577 my @res = uniq_sort_flat(
578 @allow_dirty,
579 $boilerplate{readme}, # Readme.* may be directly harvested under dist-root/ (not copied from build/)
580 1 $_[0]->_files_to_copy,
581 @_ # extras requested via passed arguments
582 );
583 1 [ grep -e, @res ];
584 }
585  
586 2 ▶sub _files_to_exclude { # files that might be in the repository, but that should not be gathered
Subroutine _files_to_exclude: called CC=1 SCAR=0.0
587 2 [ uniq_sort_flat( @never_gather, $_[0]->_files_to_copy, $_[0]->exclude_filenames ) ];
588 }
589  
590 #endregion DYNAMIC ATTRIBUTES
591  
592 #endregion ATTRIBUTES
593  
594 #region: #== UTILITY METHODS ==
595  
596 0 ▶sub payload_item {
Subroutine payload_item: not called CC=2 SCAR=17.9
Pod undocumented
597 0 my ( $self, $key ) = (@_);
598 0 ▶ exists $self->payload->{$key} ? $self->payload->{$key} : undef;
Branch: 1 branch
BranchTrueFalseTotal
exists $self->payload->{$key} ? : 0 0 0
599 }
600  
601 #endregion (UTILITY METHODS)
602  
603  
604 #region: #=== MEAT ===
605  
606 2 ▶sub configure {
Subroutine configure: called CC=1 SCAR=0.0
Pod undocumented
607 2 my $self = shift;
608 2 $self->_check;
609 2 $self->add_plugins( @{ $self->_plugins } );
610 }
611  
612 2 ▶sub _check {
Subroutine _check: called CC=2 SCAR=7.0
613 2 my $self = shift;
614 2 my $name = $self->name;
615  
616 # check: installer support status
617 2 my $installer = $self->installer;
618 die "Unsupported installer $installer\n"
619 2 ▶ unless $allowed_installers{$installer};
Branch: 1 branch
BranchTrueFalseTotal
unless $allowed_installers{$installer} 0 2 2
620 2 return 1;
621 }
622  
623 2 ▶sub _build_plugins {
Subroutine _build_plugins: called CC=3 SCAR=11.1
624 2 my ($self) = @_;
625 2 my @plugins;
626 2 for my $p ( $self->_prepare_plugins ) {
627  
628 # CODE references are OK (though that would rarely be needed)
629 124 ▶ push @plugins, ref $p eq 'CODE' ? $p->($self) : $p;
Branch: 1 branch
BranchTrueFalseTotal
ref $p eq 'CODE' ? : 0 124 124
630 }
631 2 [@plugins];
632 }
633  
634 2 ▶sub _plug__CopyFiles {
Subroutine _plug__CopyFiles: called CC=10 SCAR=31.6
635 2 my ($self) = @_;
636  
637 2 my @plugins;
638 4 ▶ my sub plugin { push @plugins, grok_plugins(@_) }
Subroutine plugin: called CC=1 SCAR=0.0
639  
640 2 my @files_to_copy = flat $self->_files_to_copy;
641 2 my $no_copy = $self->no_copy;
642  
643 2 ▶ for ( $self->copy_mode // () ) {
Condition33%1/3
$self->copy_mode // ()
l!l&&r!l&&!r
200
MC/DC0%0/2
$self->copy_mode // ()
$self->copy_mode ()
Truth table33%1/3
A // B
A= $self->copy_modeB= ()
ABresult
1X1
011
000
644 2 ▶ last unless @files_to_copy;
Branch: 1 branch
BranchTrueFalseTotal
unless @files_to_copy 0 2 2
645 2 ▶ if ( $no_copy || m/Regenerate$/i ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($no_copy or /Regenerate$/iu) 0 2 2
Condition33%1/3
$no_copy or /Regenerate$/iu
l!l&&r!l&&!r
002
MC/DC0%0/2
$no_copy or /Regenerate$/iu
$no_copy /Regenerate$/iu
Truth table33%1/3
A or B
A= $no_copyB= /Regenerate$/iu
ABresult
1X1
011
000
646 0 plugin 'Regenerate' => { filename => [@files_to_copy] }; # Allows `dzil regenerate` (no copying during normal flows)
647 0 last;
648 }
649 2 ▶ if (m/Release$/i) {
Branch: 4 branches
BranchTrueFalseTotal
if (/Release$/iu) { } 2 0 2
elsif (/Build::?Filtered$/iu) { } 0 0 0
elsif (/Build$/iu) { } 0 0 0
elsif (/(^|none)$/iu) { } 0 0 0
650 2 plugin 'CopyFilesFromRelease' => { filename => [@files_to_copy] };
651 2 plugin 'Regenerate::AfterReleasers' => { plugin => $self->name . '/CopyFilesFromRelease' };
652 } elsif (m/Build::?Filtered$/i) {
653 0 plugin 'CopyFilesFromBuild::Filtered' => { copy => [@files_to_copy] };
654 } elsif (m/Build$/i) {
655 0 plugin 'CopyFilesFromBuild' => { copy => [@files_to_copy] };
656 } elsif (m/(^|none)$/i) {
657  
658 # Noop.
659 } else {
660 0 die "Illegal file-copy mode: '$_'";
661 }
662 }
663 2 @plugins;
664 }
665  
666 2 ▶sub _plug__Weaver {
Subroutine _plug__Weaver: called CC=2 SCAR=7.2
667 2 my ($self) = @_;
668 2 ▶ $self->is_task
Branch: 1 branch
BranchTrueFalseTotal
$self->is_task ? : 0 2 2
669 ? 'TaskWeaver'
670 : [
671 'SurgicalPodWeaver' => {
672 maybe
673 config_plugin => $self->weaver_config,
674 replacer => 'replace_with_comment',
675 post_code_replacer => 'replace_with_nothing',
676 }
677 ];
678 }
679  
680 1 ▶sub _plug__GitCommit__sourcesAsReleased {
Subroutine _plug__GitCommit__sourcesAsReleased: called CC=5 SCAR=20.1
681 # Commit sources and generated files (as released) + tag the release
682 1 ▶ my ($self, $label) = (shift, shift // 'sourcesAsReleased');
Condition50%1/2
shift() // "sourcesAsReleased"
l!l
01
MC/DC0%0/1
shift() // "sourcesAsReleased"
shift()
Truth table50%1/2
A
A= shift()
Aresult
11
00
683 1 ▶ return if $self->no_git || $self->no_git_impact || $self->no_git_commit;
Branch: 1 branch
BranchTrueFalseTotal
if $self->no_git or $self->no_git_impact or $self->no_git_commit 0 1 1
Condition33%2/6
$self->no_git or $self->no_git_impact or $self->no_git_commit
l!l&&r!l&&!r
001
$self->no_git or $self->no_git_impact
l!l&&r!l&&!r
001
MC/DC0%0/3
$self->no_git or $self->no_git_impact or $self->no_git_commit
$self->no_git $self->no_git_impact $self->no_git_commit
Truth table25%1/4
A or B or C
A= $self->no_gitB= $self->no_git_impactC= $self->no_git_commit
ABCresult
1XX1
01X1
0011
0000
684  
685 (
686 1 [ "Git::Commit/$label" => {
687 add_files_in => '/', # add harvested files (README.md, LICENSE, ..) upon initial creation.
688 mayhap
689 allow_dirty => $self->_allow_dirty_on_release_commit,
690 commit_msg => 'v%V%n%n%c', # differs from @DAGOLDEN
691 }
692 ],
693  
694 [ "Git::Tag/$label" => { tag_format => $self->tag_format } ],
695 )
696 }
697  
698 1 ▶sub _plug__GitCommit__sourcesAfterBump {
Subroutine _plug__GitCommit__sourcesAfterBump: called CC=5 SCAR=20.1
699 # Commit the change-log (just stamped) and perl sources (where $VERSION has just been bumped)
700 1 ▶ my ($self, $label) = (shift, shift // 'sourcesAfterBump');
Condition50%1/2
shift() // "sourcesAfterBump"
l!l
01
MC/DC0%0/1
shift() // "sourcesAfterBump"
shift()
Truth table50%1/2
A
A= shift()
Aresult
11
00
701 1 ▶ return if $self->no_git || $self->no_git_impact || $self->no_git_commit;
Branch: 1 branch
BranchTrueFalseTotal
if $self->no_git or $self->no_git_impact or $self->no_git_commit 0 1 1
Condition33%2/6
$self->no_git or $self->no_git_impact or $self->no_git_commit
l!l&&r!l&&!r
001
$self->no_git or $self->no_git_impact
l!l&&r!l&&!r
001
MC/DC0%0/3
$self->no_git or $self->no_git_impact or $self->no_git_commit
$self->no_git $self->no_git_impact $self->no_git_commit
Truth table25%1/4
A or B or C
A= $self->no_gitB= $self->no_git_impactC= $self->no_git_commit
ABCresult
1XX1
01X1
0011
0000
702  
703 [
704 1 "Git::Commit/$label" => {
705 commit_msg => "After release: bump \$VERSION and timestamp Changes",
706 ## and also commit files copied from the build/release
707 allow_dirty_match => '^(lib|bin|script)', # Possibly bumped $VERSION in actual perl sources by [BumpVersionAfterRelease]
708 allow_dirty => [
709 qw/Changes/, # modified by ['NextRelease']
710 $self->_installer_files, # Possibly bumped '$VERSION in 'Makefile.PL' or 'Build.PL'
711 ],
712  
713 }
714 ]
715 }
716  
717 1 ▶sub _plug__GitCommitBuild__toBuildBranch {
Subroutine _plug__GitCommitBuild__toBuildBranch: called CC=6 SCAR=25.2
718 1 ▶ my ($self, $label) = (shift, shift // 'toBuildBranch');
Condition50%1/2
shift() // "toBuildBranch"
l!l
01
MC/DC0%0/1
shift() // "toBuildBranch"
shift()
Truth table50%1/2
A
A= shift()
Aresult
11
00
719 1 ▶ return if $self->no_git || $self->no_git_impact || $self->no_git_commit || $self->no_git_commit_build;
Branch: 1 branch
BranchTrueFalseTotal
if $self->no_git or $self->no_git_impact or $self->no_git_commit or $self->no_git_commit_build 1 0 1
Condition33%3/9
$self->no_git or $self->no_git_impact or $self->no_git_commit or $self->no_git_commit_build
l!l&&r!l&&!r
010
$self->no_git or $self->no_git_impact or $self->no_git_commit
l!l&&r!l&&!r
001
$self->no_git or $self->no_git_impact
l!l&&r!l&&!r
001
MC/DC0%0/4
$self->no_git or $self->no_git_impact or $self->no_git_commit or $self->no_git_commit_build
$self->no_git $self->no_git_impact $self->no_git_commit $self->no_git_commit_build
Truth table20%1/5
A or B or C or D
A= $self->no_gitB= $self->no_git_impactC= $self->no_git_commitD= $self->no_git_commit_build
ABCDresult
1XXX1
01XX1
001X1
00011
00000
720  
721 (
722 0 [ "Git::CommitBuild/$label" => { branch => 'build/%b', multiple_inheritence => 1 }]
723 )
724 }
725  
726 1 ▶sub _plug__GitCommitBuild__toReleaseBranch {
Subroutine _plug__GitCommitBuild__toReleaseBranch: called CC=6 SCAR=26.5
727 1 ▶ my ($self, $label) = (shift, shift // 'toReleaseBranch');
Condition50%1/2
shift() // "toReleaseBranch"
l!l
01
MC/DC0%0/1
shift() // "toReleaseBranch"
shift()
Truth table50%1/2
A
A= shift()
Aresult
11
00
728 1 ▶ return if $self->no_git || $self->no_git_impact || $self->no_git_commit || $self->no_git_commit_build;
Branch: 1 branch
BranchTrueFalseTotal
if $self->no_git or $self->no_git_impact or $self->no_git_commit or $self->no_git_commit_build 1 0 1
Condition33%3/9
$self->no_git or $self->no_git_impact or $self->no_git_commit or $self->no_git_commit_build
l!l&&r!l&&!r
010
$self->no_git or $self->no_git_impact or $self->no_git_commit
l!l&&r!l&&!r
001
$self->no_git or $self->no_git_impact
l!l&&r!l&&!r
001
MC/DC0%0/4
$self->no_git or $self->no_git_impact or $self->no_git_commit or $self->no_git_commit_build
$self->no_git $self->no_git_impact $self->no_git_commit $self->no_git_commit_build
Truth table20%1/5
A or B or C or D
A= $self->no_gitB= $self->no_git_impactC= $self->no_git_commitD= $self->no_git_commit_build
ABCDresult
1XXX1
01XX1
001X1
00011
00000
729  
730 0 my $branch = 'release/cpan';
731 0 $self->_add_target_branches($branch);
732  
733 (
734 0 ["Git::CommitBuild/$label" => { branch => '', release_branch => $branch, multiple_inheritence => 1 } ],
735 ["Git::Tag/$label" => { branch => $branch, tag_format => $self->tag_format_dist } ],
736 )
737 }
738  
739 1 ▶sub _plug__GitPush {
Subroutine _plug__GitPush: called CC=9 SCAR=37.7
740 1 ▶ my ($self, $label) = (shift, shift // '');
Condition50%1/2
shift() // ""
l!l
01
MC/DC0%0/1
shift() // ""
shift()
Truth table50%1/2
A
A= shift()
Aresult
11
00
741 1 ▶ return if $self->no_git || $self->no_git_impact || $self->no_git_push;
Branch: 1 branch
BranchTrueFalseTotal
if $self->no_git or $self->no_git_impact or $self->no_git_push 1 0 1
Condition33%2/6
$self->no_git or $self->no_git_impact or $self->no_git_push
l!l&&r!l&&!r
010
$self->no_git or $self->no_git_impact
l!l&&r!l&&!r
001
MC/DC0%0/3
$self->no_git or $self->no_git_impact or $self->no_git_push
$self->no_git $self->no_git_impact $self->no_git_push
Truth table25%1/4
A or B or C
A= $self->no_gitB= $self->no_git_impactC= $self->no_git_push
ABCresult
1XX1
01X1
0011
0000
742  
743 0 my @targets;
744 0 my @branches = uniq( $self->_all_target_branches );
745 0 for my $remote ( $self->_all_git_remotes ) {
746 0 push @targets, "$remote";
747 0 for my $branch (@branches) {
748 0 ▶ next unless $branch // '';
Branch: 1 branch
BranchTrueFalseTotal
unless $branch // "" 0 0 0
Condition0%0/2
$branch // ""
l!l
00
MC/DC0%0/1
$branch // ""
$branch
Truth table0%0/2
A
A= $branch
Aresult
11
00
749 0 push @targets, "$remote refs/heads/$branch:refs/heads/$branch",
750 }
751 }
752  
753 0 [ 'Git::Push' => { push_to => \@targets, remotes_must_exist => 0 } ]
754 }
755  
756 2 ▶sub _prepare_plugins {
Subroutine _prepare_plugins: called CC=48 SCAR=42.4
757 2 my ($self) = @_;
758 2 my @plugins;
759 124 ▶ my sub plugin { push @plugins, grok_plugins(@_) }
Subroutine plugin: called CC=1 SCAR=0.0
760 14 ▶ my sub harvest { $self->_add_harvested_files(@_) }
Subroutine harvest: called CC=1 SCAR=0.0
761 2 $self->_clear_harvested_files;
762  
763  
764 2 my $auto_version = $self->auto_version;
765 2 my $darkpan = $self->darkpan;
766 2 my $no_git = $self->no_git;
767 2 ▶ my $no_github = $self->no_github || $self->no_git || $self->darkpan;
Condition66%4/6
$self->no_github || $self->no_git || $self->darkpan
l!l&&r!l&&!r
101
$self->no_github or $self->no_git
l!l&&r!l&&!r
011
MC/DC33%1/3
$self->no_github || $self->no_git || $self->darkpan
$self->no_github $self->no_git $self->darkpan
Truth table50%2/4
A or B || C
A= $self->no_githubB= $self->no_gitC= $self->darkpan
ABCresult
1XX1
01X1
0011
0000
768 2 my $no_versioning = !!!$self->manage_versions;
769  
770 # decide on some mutually exclusive alternatives
771 2 ▶ my $gatherer = $no_git // 0 ? 'GatherDir' : 'Git::GatherDir';
Branch: 1 branch
BranchTrueFalseTotal
$no_git // 0 ? : 1 1 2
Condition50%1/2
$no_git // 0
l!l
20
MC/DC0%0/1
$no_git // 0
$no_git
Truth table50%1/2
A
A= $no_git
Aresult
11
00
772 2 ▶ my $versioner =
Branch: 2 branches
BranchTrueFalseTotal
$self->auto_version ? : 0 2 2
$self->no_sanitize_version // 0 ? : 1 1 2
Condition50%1/2
$self->no_sanitize_version // 0
l!l
20
MC/DC0%0/1
$self->no_sanitize_version // 0
$self->no_sanitize_version
Truth table50%1/2
A
A= $self->no_sanitize_version
Aresult
11
00
773 $self->auto_version ? 'AutoVersion'
774 : $self->no_sanitize_version // 0 ? 'RewriteVersion'
775 : 'RewriteVersion::Sanitized';
776  
777  
778 ##=== EARLY birds
779 2 plugin 'NameFromDirectory'; # src: @Milla
780 2 plugin $versioner; # XXX: I don't know why @DAGOLDEN lists this so early...
781  
782 ##=== file gatherers
783 2 plugin $gatherer => {
784 mayhap
785 exclude_filename => $self->_files_to_exclude,
786 mayhap
787 exclude_match => $self->exclude_match,
788 include_dotfiles => 1, # PruneCruft should take care of pruning dotfiles (w/ possible exceptions)
789 };
790  
791 ##=== file pruners
792 2 ▶ plugin 'PruneCruft' => { maybe except => @prune_not ? [@prune_not] : undef, };
Branch: 1 branch
BranchTrueFalseTotal
@prune_not ? : 2 0 2
793  
794 2 plugin 'PruneFiles' => { filename => ['README.pod'] }; # Otherwise: MakeMaker will try to install it!
795 2 plugin 'ManifestSkip';
796  
797 ###== file mungers
798 2 plugin 'InsertCopyright';
799 2 ▶ plugin 'PkgVersion' if $self->auto_version // 0; # [TAU] : XXX: Consider: OurPkgVersion (which doesn't add lines)
Branch: 1 branch
BranchTrueFalseTotal
if $self->auto_version // 0 0 2 2
Condition50%1/2
$self->auto_version // 0
l!l
20
MC/DC0%0/1
$self->auto_version // 0
$self->auto_version
Truth table50%1/2
A
A= $self->auto_version
Aresult
11
00
800 2 plugin $self->_plug__Weaver;
801  
802 ##=== file generators
803 ## --except Meta* and Manifest which are postponed until the latest possible moment
804 ## XXX: Readme generation needs to come after POD weaving (which munges POD, obviously...)
805 2 plugin 'Pod2Readme'; # We don't really need to harvest the plain-text README into dist-root, since we will have README.md
806 2 ▶ plugin 'License' and harvest 'LICENSE';
Branch: 1 branch
BranchTrueFalseTotal
plugin "License" and harvest "LICENSE" 2 0 2
807 2 ▶ plugin 'InstallGuide' and harvest 'INSTALL';
Branch: 1 branch
BranchTrueFalseTotal
plugin "InstallGuide" and harvest "INSTALL" 2 0 2
808 2 ▶ plugin 'ReadmeAnyFromPod / MarkdownInBuild' => {
Branch: 1 branch
BranchTrueFalseTotal
plugin "ReadmeAnyFromPod / MarkdownInBuild", {"type", "markdown", "filename", "README.md", "location", "build", "phase", "build"} and harvest "README.md" 2 0 2
809 type => 'markdown',
810 filename => 'README.md',
811 location => 'build', # 'root',
812 phase => 'build',
813 }
814 and harvest 'README.md';
815  
816 ##=== author tests
817 2 plugin 'Test::Compile' => {
818 xt_mode => 1,
819 fake_home => 1
820 };
821 2 ▶ plugin 'Test::MinimumVersion' => { max_target_perl => '5.026' }
Branch: 1 branch
BranchTrueFalseTotal
unless $self->no_minimum_perl 2 0 2
822 unless $self->no_minimum_perl;
823 2 plugin 'Test::ReportPrereqs';
824  
825 ##== harvested xt/ tests
826 2 ▶ plugin 'Test::Perl::Critic'
Branch: 1 branch
BranchTrueFalseTotal
unless $self->no_critic 2 0 2
827 unless $self->no_critic;
828 2 plugin 'MetaTests';
829 2 plugin 'PodSyntaxTests';
830 2 ▶ plugin 'Test::PodSpelling' => { mayhap stopwords => $self->_stopwords, }
Branch: 1 branch
BranchTrueFalseTotal
unless $self->no_pod_spellcheck 2 0 2
831 unless $self->no_pod_spellcheck;
832  
833 2 ▶ plugin 'Test::Pod::Coverage::Configurable' => {
Branch: 1 branch
BranchTrueFalseTotal
unless $self->no_pod_coverage 2 0 2
834 maybe
835 class => $self->pod_coverage_class,
836 mayhap
837 skip => $self->pod_coverage_skip,
838 mayhap
839 trustme => $self->pod_coverage_trustme,
840 mayhap also_private => $self->pod_coverage_also_private,
841 }
842 unless $self->no_pod_coverage;
843  
844  
845 2 ▶ plugin 'Test::Portability' => { options => "test_one_dot = 0" }
Branch: 1 branch
BranchTrueFalseTotal
unless $self->no_portability_check 2 0 2
846 unless $self->no_portability_check;
847  
848 2 plugin 'Test::Version';
849 2 plugin 'Test::Kwalitee';
850 2 plugin 'MojibakeTests';
851 2 plugin 'Test::EOL';
852  
853 ##=== meta
854 2 plugin 'Authority' => {
855 authority => $self->authority,
856 do_munging => 0,
857 };
858 2 ▶ plugin 'CopyrightYearFromGit' => { continuous_year => 1 }
Branch: 1 branch
BranchTrueFalseTotal
unless $no_git 1 1 2
859 unless $no_git;
860  
861 2 plugin 'Keywords';
862 2 plugin 'MinimumPerl';
863 2 ▶ plugin 'AutoPrereqs' => { skip => "^t::lib" }
Branch: 1 branch
BranchTrueFalseTotal
if $self->auto_prereqs 2 0 2
864 if $self->auto_prereqs;
865 2 ▶ plugin 'PrereqsFile' if -e 'prereqs.yml' || -e 'prereqs.json';
Branch: 1 branch
BranchTrueFalseTotal
if -e "prereqs.yml" or -e "prereqs.json" 0 2 2
Condition33%1/3
-e "prereqs.yml" or -e "prereqs.json"
l!l&&r!l&&!r
002
MC/DC0%0/2
-e "prereqs.yml" or -e "prereqs.json"
-e "prereqs.yml" -e "prereqs.json"
Truth table33%1/3
A or B
A= -e "prereqs.yml"B= -e "prereqs.json"
ABresult
1X1
011
000
866 2 plugin 'MetaNoIndex' => {
867 directory => [ sort( qw(t xt), qw(corpus demo eg examples fatlib local inc perl5 share) ) ],
868 'package' => [qw/DB/],
869 };
870 2 plugin 'MetaProvides::Package' => { # MUST come AFTER MetaNoIndex
871 meta_noindex => 1,
872  
873 # maybe inherit_version => ( $no_versioning ? 0 : undef ),
874 };
875 2 ▶ plugin 'GithubMeta' => {
Branch: 1 branch
BranchTrueFalseTotal
unless $no_github 1 1 2
Condition50%1/2
$self->github_issues || undef
l!l
10
MC/DC0%0/1
$self->github_issues || undef
$self->github_issues
Truth table50%1/2
A
A= $self->github_issues
Aresult
11
00
876 remote => [qw(origin github)],
877 maybe issues => $self->github_issues || undef,
878 }
879 unless $no_github;
880  
881 2 ▶ plugin 'Bugtracker' => { # fake out Pod::Weaver::Section::Support (if needed)
Branch: 2 branches
BranchTrueFalseTotal
if $no_github or not $self->github_issues 1 1 2
$self->darkpan ? : 0 1 1
Condition66%2/3
$no_github or not $self->github_issues
l!l&&r!l&&!r
101
MC/DC50%1/2
$no_github or not $self->github_issues
$no_github not $self->github_issues
Truth table66%2/3
A or not(B)
A= $no_githubB= not $self->github_issues
ABresult
1X1
011
000
882 mailto => '',
883 maybe web => ( $self->darkpan ? "http://localhost/" : undef ),
884 }
885 if $no_github || !$self->github_issues;
886  
887 2 ▶ plugin 'MetaResources' => { # fake out Pod::Weaver::Section::Support (if needed)
Branch: 1 branch
BranchTrueFalseTotal
if $no_github 1 1 2
888 'repository.url' => "http://localhost/",
889 'repository.web' => "http://localhost/",
890 }
891 if $no_github;
892  
893 2 ▶ plugin 'Git::Contributors' unless $no_git;
Branch: 1 branch
BranchTrueFalseTotal
unless $no_git 1 1 2
894 2 ▶ plugin 'Prereqs::AuthorDeps' if $self->auto_prereqs;
Branch: 1 branch
BranchTrueFalseTotal
if $self->auto_prereqs 2 0 2
895 2 plugin 'RemovePrereqs::Provided'; # Must come after MetaProvides
896 # plugin 'PrereqsClean'; # XXX: It looks like this plugin is no longer maintained... [PluginBundle::Prereqs](https://metacpan.org/dist/Dist-Zilla-PluginBundle-Prereqs)
897 2 ▶ plugin 'MetaYAML' and harvest 'Meta.yml';
Branch: 1 branch
BranchTrueFalseTotal
plugin "MetaYAML" and harvest "Meta.yml" 2 0 2
898 2 ▶ plugin 'MetaJSON' and harvest 'Meta.json';
Branch: 1 branch
BranchTrueFalseTotal
plugin "MetaJSON" and harvest "Meta.json" 2 0 2
899 2 ▶ plugin 'CPANFile' and harvest 'cpanfile';
Branch: 1 branch
BranchTrueFalseTotal
plugin "CPANFile" and harvest "cpanfile" 2 0 2
900  
901 ##=== build system, INSTALLER, ..., Manifest
902 2 plugin 'ExecDir' => { maybe dir => $self->exec_dir, };
903 2 plugin 'ShareDir'; # core
904 2 ▶ plugin $self->installer and harvest( flat $self->_installer_files );
Branch: 1 branch
BranchTrueFalseTotal
plugin $self->installer and harvest flat($self->_installer_files) 2 0 2
905 2 plugin 'PromptIfStale' => { # are we up to date?
906 modules => [ qw/Dist::Zilla/, __PACKAGE__ ],
907 check_all_plugins => 1,
908 };
909 2 plugin 'Manifest'; # core. -- must come after all harvested files
910  
911 ##=== BEFORE RELEASE: extra tests (src: @Starter, @DAGOLDEN)
912 ## MUST come before test/confirm for before-release verification
913 2 ▶ plugin 'Git::CheckFor::CorrectBranch' unless $no_git;
Branch: 1 branch
BranchTrueFalseTotal
unless $no_git 1 1 2
914 2 ▶ plugin 'Git::Check' => { allow_dirty => [@allow_dirty] } unless $no_git;
Branch: 1 branch
BranchTrueFalseTotal
unless $no_git 1 1 2
915 2 plugin 'CheckMetaResources';
916 2 plugin 'CheckPrereqsIndexed';
917 2 plugin 'CheckChangesHasContent';
918 2 plugin 'ConsistentVersionTest';
919 2 plugin 'CheckStrictVersion';
920 2 ▶ plugin 'CheckVersionIncrement'
Branch: 1 branch
BranchTrueFalseTotal
unless $self->_fake_release 2 0 2
921 unless $self->_fake_release;
922 2 plugin 'Test::CheckManifest';
923 2 plugin 'RunExtraTests' => { default_jobs => 9 };
924  
925 ##== test/confirm release (just before releaser)
926 2 plugin 'TestRelease';
927 2 plugin 'ConfirmRelease';
928  
929 ##=== release
930 2 ▶ plugin( $self->_fake_release ? 'FakeRelease' : 'UploadToCPAN' ); # core
Branch: 1 branch
BranchTrueFalseTotal
$self->_fake_release ? : 0 2 2
931  
932 ##=== AFTER release
933 2 plugin $self->_plug__CopyFiles; ## Copy files (from the release/build to the repo)
934 2 ▶ plugin $self->_plug__GitCommit__sourcesAsReleased unless $self->no_git || $self->no_git_impact;
Branch: 1 branch
BranchTrueFalseTotal
unless $self->no_git or $self->no_git_impact 1 1 2
Condition66%2/3
$self->no_git or $self->no_git_impact
l!l&&r!l&&!r
101
MC/DC50%1/2
$self->no_git or $self->no_git_impact
$self->no_git $self->no_git_impact
Truth table66%2/3
A or B
A= $self->no_gitB= $self->no_git_impact
ABresult
1X1
011
000
935 2 ▶ plugin 'NextRelease' => { ## stamp the change-log and bump $VERSION (in all source files)
Branch: 1 branch
BranchTrueFalseTotal
unless $no_versioning 2 0 2
936 ## 'NextRelease' marks the release in the change-log (but also does munging earlier).
937 ## It is placed here to get the ordering right with git actions.
938 time_zone => 'UTC',
939 format => '%-20{-TRIAL}V %{yyyy-MM-dd HH:mm:ssZZZZZ VVV}d %P'
940 }
941 unless $no_versioning;
942  
943 2 ▶ plugin 'BumpVersionAfterRelease' ## Bump $VERSION (after the release) directly on source files (in lib/)!
Branch: 1 branch
BranchTrueFalseTotal
unless $no_versioning or $auto_version 2 0 2
Condition33%1/3
$no_versioning or $auto_version
l!l&&r!l&&!r
002
MC/DC0%0/2
$no_versioning or $auto_version
$no_versioning $auto_version
Truth table33%1/3
A or B
A= $no_versioningB= $auto_version
ABresult
1X1
011
000
944 unless $no_versioning || $auto_version;
945  
946 2 ▶ unless ($self->no_git || $self->no_git_impact) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($self->no_git or $self->no_git_impact) 1 1 2
Condition66%2/3
$self->no_git or $self->no_git_impact
l!l&&r!l&&!r
101
MC/DC50%1/2
$self->no_git or $self->no_git_impact
$self->no_git $self->no_git_impact
Truth table66%2/3
A or B
A= $self->no_gitB= $self->no_git_impact
ABresult
1X1
011
000
947 1 plugin $self->_plug__GitCommit__sourcesAfterBump;
948 1 plugin $self->_plug__GitCommitBuild__toBuildBranch;
949 1 plugin $self->_plug__GitCommitBuild__toReleaseBranch;
950 1 plugin $self->_plug__GitPush;
951 }
952  
953 2 ▶ plugin 'ArchiveRelease' => { directory => $self->archive_dir } unless $self->no_archive || !$self->archive_dir;
Branch: 1 branch
BranchTrueFalseTotal
unless $self->no_archive or not $self->archive_dir 2 0 2
Condition33%1/3
$self->no_archive or not $self->archive_dir
l!l&&r!l&&!r
002
MC/DC0%0/2
$self->no_archive or not $self->archive_dir
$self->no_archive not $self->archive_dir
Truth table33%1/3
A or not(B)
A= $self->no_archiveB= not $self->archive_dir
ABresult
1X1
011
000
954  
955 2 @plugins;
956 }
957  
958 #endregion: MEAT
959  
960  
961 2 __PACKAGE__->meta->make_immutable;
962 2 1;
963  
964 =pod
965  
966 =encoding UTF-8
967  
968 =for :stopwords Tabulo[n] cpan testmatrix url bugtracker rt cpants kwalitee diff irc mailto
969 metadata placeholders metacpan
970  
971 =head1 NAME
972  
973 Dist::Zilla::PluginBundle::Author::TABULO - A Dist::Zilla plugin bundle à la TABULO
974  
975 =head1 VERSION
976  
977 version 1.000014
978  
979 =head1 SYNOPSIS
980  
981 In your F<dist.ini>:
982  
983 [@Author::TABULO]
984  
985 =head1 DESCRIPTION
986  
987 This is the dzil plug-in bundle that TABULO intends to use for his distributions.
988  
989 It exists mostly because TABULO is very lazy, like many other folks out there.
990  
991 But since TABULO is probably even lazier than most folks; instead of starting his
992 bundle from scratch, he just shopped around to find a few bundles that had the most
993 overlap with his taste or whatever; and then just slurped stuff,
994 even including some documentation which is what you will eventually see here and in the
995 related modules.:-)
996  
997 Admittedly, the fact that TABULO was so late in migrating to dzil worked to his
998 advantage for this particular task at least, since by that time
999 the bold and the brave had already made delicious stuff!
1000  
1001 As such, it is heavily inspired by (and in some places outright copied from) several others such as:
1002 @DAGOLDEN, @DBOOK, @DROLSKY, @ETHER, @KENTNL, @RJBS, @Starter, @Starter::Git, @YANICK.
1003  
1004 (Thank you, folks!).
1005  
1006 =head2 WARNING
1007  
1008 Please note that, although this module needs to be on CPAN for obvious reasons,
1009 it is really intended to be a collection of personal preferences, which are
1010 expected to be in great flux, at least for the time being.
1011  
1012 Therefore, please do NOT base your own distributions on this one, since anything
1013 can change at any moment without prior notice, while I get accustomed to dzil
1014 myself and form those preferences in the first place...
1015  
1016 Absolutely nothing in this distribution is guaranteed to remain constant or
1017 be maintained at this point. Who knows, I may even give up on dzil altogether...
1018  
1019 You have been warned.
1020  
1021 Also note that the early versions of this module had much more in common with that of @ETHER, and tried to keep a compatible interface. This is no longer the case. So some stuff will break, and hence the bump of major version. But you weren't really using this for your distros anyway, right?
1022  
1023 And here comes the rest of the documentation -- some of which slurped from the several original sources cited above ... :-)
1024  
1025 =head2 OVERVIEW
1026  
1027 Using this plugin bundle (with its default options) is roughly equivalent to the following content in C<dist.ini>.
1028  
1029 ...
1030  
1031 [NameFromDirectory]
1032  
1033 [RewriteVersion::Sanitized]
1034  
1035 [Git::GatherDir]
1036 exclude_filename = Build.PL
1037 exclude_filename = CODE_OF_CONDUCT
1038 exclude_filename = CONTRIBUTING
1039 exclude_filename = INSTALL
1040 exclude_filename = LICENCE
1041 exclude_filename = LICENSE
1042 exclude_filename = META.json
1043 exclude_filename = Makefile.PL
1044 exclude_filename = Meta.yml
1045 exclude_filename = README
1046 exclude_filename = README.md
1047 exclude_filename = README.mkdn
1048 exclude_filename = README.pod
1049 exclude_filename = TODO
1050 exclude_filename = cpanfile
1051 exclude_filename = inc/ExtUtils/MakeMaker/Dist/Zilla/Develop.pm
1052 exclude_filename = ppport.h
1053 include_dotfiles = 1
1054  
1055 [PruneCruft]
1056 except = (?^u:"\.travis\.yml")
1057 except = (?^u:"\.perltidyrc")
1058 except = (?^u:".*/\.gitignore$")
1059 except = (?^u:".*/\.(git)?keep$")
1060  
1061 [PruneFiles]
1062 filename = README.pod
1063  
1064 [ManifestSkip]
1065  
1066 [InsertCopyright]
1067  
1068 [SurgicalPodWeaver]
1069 config_plugin = @Author::TABULO
1070 post_code_replacer = replace_with_nothing
1071 replacer = replace_with_comment
1072  
1073 [Pod2Readme]
1074  
1075 [License]
1076  
1077 [InstallGuide]
1078  
1079 [ReadmeAnyFromPod / ReadmeAnyFromPod/MarkdownInBuild]
1080 filename = README.md
1081 location = build
1082 phase = build
1083 type = markdown
1084  
1085 [Test::Compile]
1086 fake_home = 1
1087 xt_mode = 1
1088  
1089 [Test::MinimumVersion]
1090 max_target_perl = 5.026
1091  
1092 [Test::ReportPrereqs]
1093  
1094 [Test::Perl::Critic]
1095  
1096 [MetaTests]
1097  
1098 [PodSyntaxTests]
1099  
1100 [Test::PodSpelling]
1101  
1102 [Test::Pod::Coverage::Configurable]
1103  
1104 [Test::Portability]
1105 options = test_one_dot = 0
1106  
1107 [Test::Version]
1108  
1109 [Test::Kwalitee]
1110  
1111 [MojibakeTests]
1112  
1113 [Test::EOL]
1114  
1115 [Authority]
1116 authority = cpan:TABULO
1117 do_munging = 0
1118  
1119 [CopyrightYearFromGit]
1120 continuous_year = 1
1121  
1122 [Keywords]
1123  
1124 [MinimumPerl]
1125  
1126 [AutoPrereqs]
1127 skip = ^t::lib
1128  
1129 [PrereqsFile]
1130  
1131 [MetaNoIndex]
1132 directory = corpus
1133 directory = demo
1134 directory = eg
1135 directory = examples
1136 directory = fatlib
1137 directory = inc
1138 directory = local
1139 directory = perl5
1140 directory = share
1141 directory = t
1142 directory = xt
1143 package = DB
1144  
1145 [MetaProvides::Package]
1146 meta_noindex = 1
1147  
1148 [GithubMeta]
1149 issues = 1
1150 remote = origin
1151 remote = github
1152  
1153 [Git::Contributors]
1154  
1155 [Prereqs::AuthorDeps]
1156  
1157 [RemovePrereqs::Provided]
1158  
1159 [MetaYAML]
1160  
1161 [MetaJSON]
1162  
1163 [CPANFile]
1164  
1165 [ExecDir]
1166  
1167 [ShareDir]
1168  
1169 [MakeMaker]
1170  
1171 [PromptIfStale]
1172 check_all_plugins = 1
1173 modules = Dist::Zilla
1174 modules = @Author::TABULO
1175  
1176 [Manifest]
1177  
1178 [Git::CheckFor::CorrectBranch]
1179  
1180 [Git::Check]
1181 allow_dirty = dist.ini
1182 allow_dirty = Changes
1183  
1184 [CheckMetaResources]
1185  
1186 [CheckPrereqsIndexed]
1187  
1188 [CheckChangesHasContent]
1189  
1190 [ConsistentVersionTest]
1191  
1192 [CheckStrictVersion]
1193  
1194 [CheckVersionIncrement]
1195  
1196 [Test::CheckManifest]
1197  
1198 [RunExtraTests]
1199 default_jobs = 9
1200  
1201 [TestRelease]
1202  
1203 [ConfirmRelease]
1204  
1205 [UploadToCPAN]
1206  
1207 [CopyFilesFromRelease]
1208 filename = INSTALL
1209 filename = LICENSE
1210 filename = Makefile.PL
1211 filename = Meta.json
1212 filename = Meta.yml
1213 filename = README.md
1214 filename = cpanfile
1215  
1216 [Regenerate::AfterReleasers]
1217 plugin = @Author::TABULO/CopyFilesFromRelease
1218  
1219 [Git::Commit / Git::Commit/sourcesAsReleased]
1220 add_files_in = /
1221 allow_dirty = Changes
1222 allow_dirty = INSTALL
1223 allow_dirty = LICENSE
1224 allow_dirty = Makefile.PL
1225 allow_dirty = Meta.json
1226 allow_dirty = Meta.yml
1227 allow_dirty = README.md
1228 allow_dirty = cpanfile
1229 commit_msg = v%V%n%n%c
1230  
1231 [Git::Tag / Git::Tag/sourcesAsReleased]
1232 tag_format = release-%v
1233  
1234 [NextRelease]
1235 format = %-20{-TRIAL}V %{yyyy-MM-dd HH:mm:ssZZZZZ VVV}d %P
1236 time_zone = UTC
1237  
1238 [BumpVersionAfterRelease]
1239  
1240 [Git::Commit / Git::Commit/sourcesAfterBump]
1241 allow_dirty = Changes
1242 allow_dirty = ARRAY(0x7fd7767bf1e0)
1243 allow_dirty_match = ^(lib|bin|script)
1244 commit_msg = After release: bump $VERSION and timestamp Changes
1245  
1246 [Git::CommitBuild / Git::CommitBuild/toBuildBranch]
1247 branch = build/%b
1248 multiple_inheritence = 1
1249  
1250 [Git::CommitBuild / Git::CommitBuild/toReleaseBranch]
1251 branch =
1252 multiple_inheritence = 1
1253 release_branch = release/cpan
1254  
1255 [Git::Tag / Git::Tag/toReleaseBranch]
1256 branch = release/cpan
1257 tag_format = release-%v
1258  
1259 [Git::Push]
1260 push_to = origin
1261 push_to = origin refs/heads/release/cpan:refs/heads/release/cpan
1262 remotes_must_exist = 0
1263  
1264 [ArchiveRelease]
1265 directory = releases
1266  
1267 =head1 ATTRIBUTES
1268  
1269 =head2 archive_dir
1270  
1271 Reader: archive_dir
1272  
1273 Type: Str
1274  
1275 Additional documentation: Passed as the 'directory' option, to [ArchiveRelease] whose docs are quoted below:
1276  
1277 * The 'directory' [name] may begin with ~ (or ~user) to mean your (or some other user's) home directory.
1278 * If the directory doesn't exist, it will be created during the BeforeRelease phase.
1279 * All files inside this directory will be pruned from the distribution. Default: 'releases'
1280  
1281 =head2 authority
1282  
1283 Reader: authority
1284  
1285 Type: Str
1286  
1287 Additional documentation: Specifies the x_authority field for PAUSE. Default: 'cpan:TABULO'
1288  
1289 =head2 auto_prereqs
1290  
1291 Reader: auto_prereqs
1292  
1293 Type: Bool
1294  
1295 Additional documentation: Indicates whether or not to use [AutoPrereqs]. Default: '1'
1296  
1297 =head2 auto_version
1298  
1299 Reader: auto_version
1300  
1301 Type: Bool
1302  
1303 Additional documentation: Indicates whether or not to use [AutoVersion] instead of our standard plugins for version management. Default: '0'
1304  
1305 =head2 copy
1306  
1307 Reader: copy
1308  
1309 Type: ArrayRef
1310  
1311 Additional documentation: Additional files to copy (or regenerate) in addition to those that are already harvested by default. [May be repeated]. Note that the copying may be done from the build or the release, depending on the 'copy_mode' setting. See 'copy_mode'.
1312  
1313 =head2 copy_mode
1314  
1315 Reader: copy_mode
1316  
1317 Type: Maybe[Str]
1318  
1319 Additional documentation: Determines the 'copy-mode' and hence ultimately the set of plugins used for that purpose. Possible values are [Regenerate, Release, Build, Build::Filtered, None]. dzil 'regenerate' command will still work. Default: 'Release'
1320  
1321 =head2 copy_not
1322  
1323 Reader: copy_not
1324  
1325 Type: ArrayRef
1326  
1327 Additional documentation: Do NOT copy given file(s). [May be repeated].
1328  
1329 =head2 darkpan
1330  
1331 Reader: darkpan
1332  
1333 Type: Bool
1334  
1335 Additional documentation: For private code; uses [FakeRelease] and fills in dummy repo/bugtracker data. Default: '0'
1336  
1337 =head2 dist_genre
1338  
1339 Reader: dist_genre
1340  
1341 Type: Str
1342  
1343 Additional documentation: Specifies the 'genre' of the distro. Currently allowed values are: 'standard' (the default) and 'task'.
1344  
1345 This may be used in the future to associate a set behaviours/settings to given genres.
1346  
1347 Currently, the only distinction made is for the 'task' genre, which will result in [TaskWeaver] being used
1348 instead of [SurgicalPodWeaver]. Default: 'standard'
1349  
1350 =head2 exclude_filenames
1351  
1352 Reader: exclude_filenames
1353  
1354 Type: ArrayRef
1355  
1356 Additional documentation: Do NOT gather given file(s). [May be repeated].
1357  
1358 =head2 exclude_match
1359  
1360 Reader: exclude_match
1361  
1362 Type: ArrayRef
1363  
1364 Additional documentation: Do NOT gather file(s) that match the given pattern(s). [May be repeated].
1365  
1366 =head2 exec_dir
1367  
1368 Reader: exec_dir
1369  
1370 Type: Maybe[Str]
1371  
1372 Additional documentation: If defined, passed to [ExecDir] as its 'dir' option.
1373 Defaults to 'script' when the installer is [Module::Build::Tiny],undef otherwise, which means the [ExecDir] default will be in effect, and that is 'bin' as of this writing.,
1374  
1375 =head2 fake_release
1376  
1377 Reader: fake_release
1378  
1379 Type: Bool
1380  
1381 Additional documentation: Swaps [FakeRelease] for [UploadToCPAN]. Mostly useful for testing a dist.ini without risking a real release.
1382 Note that this can also be achieved by setting the FAKE_RELEASE environment variable (which will have precedence over this option). Default: '0'
1383  
1384 =head2 git_remotes
1385  
1386 Reader: git_remotes
1387  
1388 Type: ArrayRef
1389  
1390 Additional documentation: Where to push after release.
1391  
1392 =head2 github_issues
1393  
1394 Reader: github_issues
1395  
1396 Type: Str
1397  
1398 Additional documentation: Whether or not to use github issue tracker. Default: '1'
1399  
1400 =head2 has_xs
1401  
1402 Reader: has_xs
1403  
1404 Type: Bool
1405  
1406 Additional documentation: Signifies that the distribution contains XS code.
1407  
1408 =head2 hub
1409  
1410 Reader: hub
1411  
1412 Type: Maybe[Str]
1413  
1414 Additional documentation: The repository 'hub' provider.
1415 Currently, other than unsetting to undef, the only supported value, which is also the default, is 'github'.
1416 Other providers, such as 'gitlab' or 'bitbucket', may be supported in the future. Default: 'github'
1417  
1418 =head2 installer
1419  
1420 Reader: installer
1421  
1422 Additional documentation: The installer to employ. Currently, possible values are: [MakeMaker, MakeMaker::Awesome, ModuleBuild, ModuleBuildTiny, ModuleBuildTiny::Fallback]. Default: 'MakeMaker'
1423  
1424 =head2 is_task
1425  
1426 Reader: is_task
1427  
1428 Type: Bool
1429  
1430 Additional documentation: DEPRECATED. Prefer setting instead, like so:
1431  
1432 [@Author::TABULO]
1433 dist_genre=task
1434  
1435 Identifies this distro as a 'task'.
1436  
1437 Currently, the only distinction is that, for a task, we use [TaskWeaver] instead of [SurgicalPodWeaver].
1438  
1439 =head2 manage_versions
1440  
1441 Reader: manage_versions
1442  
1443 Type: Bool
1444  
1445 Additional documentation: Whether or not to manage versioning, which means: providing, rewriting, bumping, munging $VERSION in sources, .... Default: '1'
1446  
1447 =head2 name
1448  
1449 Reader: name
1450  
1451 Type: Str
1452  
1453 This attribute is required.
1454  
1455 =head2 no_archive
1456  
1457 Reader: no_archive
1458  
1459 Type: Bool
1460  
1461 Additional documentation: Omit the [ArchiveRelease] plugin. Default: '0'
1462  
1463 =head2 no_copy
1464  
1465 Reader: no_copy
1466  
1467 Type: Bool
1468  
1469 Additional documentation: Skip copying files from the build/release : ('Makefile.PL', 'cpanfile',' Meta.json', ...). Default: '0'
1470  
1471 =head2 no_coverage
1472  
1473 Reader: no_coverage
1474  
1475 Type: Bool
1476  
1477 Additional documentation: Omit PodCoverage tests -- which are actually done using [Test::Pod::Coverage::Configurable]. Default: '0'
1478  
1479 =head2 no_critic
1480  
1481 Reader: no_critic
1482  
1483 Type: Bool
1484  
1485 Additional documentation: Omit [Test::Perl::Critic] tests. Default: '0'
1486  
1487 =head2 no_git
1488  
1489 Reader: no_git
1490  
1491 Type: Bool
1492  
1493 Additional documentation: Bypass all git-dependent plugins. Default: '0'
1494  
1495 =head2 no_git_commit
1496  
1497 Reader: no_git_commit
1498  
1499 Type: Bool
1500  
1501 Additional documentation: Omit [Git::Commit] and [Git::CommitBuild] and related [Git::Tag] operations. Default: '0'
1502  
1503 =head2 no_git_commit_build
1504  
1505 Reader: no_git_commit_build
1506  
1507 Type: Bool
1508  
1509 Additional documentation: Omit [Git::CommitBuild] and related [Git::Tag] operations. Default: '0'
1510  
1511 =head2 no_git_impact
1512  
1513 Reader: no_git_impact
1514  
1515 Type: Bool
1516  
1517 Additional documentation: Omit any [Git:*] plugins that may modify the vcs repository state, such as : [Git::Commit], [Git::CommitBuild], [Git::Tag], [Git::Push] and the like.
1518 Git plugins that are read-only, such as [Git::GatherDir] or [Git::Check] shouldn't be effected by this option. Default: '0'
1519  
1520 =head2 no_git_push
1521  
1522 Reader: no_git_push
1523  
1524 Type: Bool
1525  
1526 Additional documentation: Omit [Git::Push]. Default: '0'
1527  
1528 =head2 no_github
1529  
1530 Reader: no_github
1531  
1532 Type: Bool
1533  
1534 Additional documentation: Do not assume that the repository is backed by 'github', which currently means abstaining from using [GithubMeta] and feeding fake values to [MetaResources] and [Bugtracker] -- which you may separately override, by the way, thanks to our[@Config::Slicer] role.
1535  
1536 =head2 no_minimum_perl
1537  
1538 Reader: no_minimum_perl
1539  
1540 Type: Bool
1541  
1542 Additional documentation: Omit [Test::MinimumVersion] tests. Default: '0'
1543  
1544 =head2 no_pod_coverage
1545  
1546 Reader: no_pod_coverage
1547  
1548 Type: Bool
1549  
1550 Additional documentation: Skip [PodCoverage] tests -- Well, [Test::Pod::Coverage::Configurable] tests, actually.
1551  
1552 =head2 no_pod_spellcheck
1553  
1554 Reader: no_pod_spellcheck
1555  
1556 Type: Bool
1557  
1558 Additional documentation: Skip [Test::PodSpelling] tests.
1559  
1560 =head2 no_portability_check
1561  
1562 Reader: no_portability_check
1563  
1564 Type: Bool
1565  
1566 Additional documentation: Skip [Test::Portability] tests. Default: '0'
1567  
1568 =head2 no_sanitize_version
1569  
1570 Reader: no_sanitize_version
1571  
1572 Type: Bool
1573  
1574 Additional documentation: When set => We won't prefer [RewriteVersion::Sanitized] over [RewriteVersion], which we normally do. Default: '0'
1575  
1576 =head2 no_spellcheck
1577  
1578 Reader: no_spellcheck
1579  
1580 Type: Bool
1581  
1582 Additional documentation: Omit [Test::PodSpelling] tests. Default: '0'
1583  
1584 =head2 payload
1585  
1586 Reader: payload
1587  
1588 Type: HashRef
1589  
1590 This attribute is required.
1591  
1592 =head2 plugins
1593  
1594 Reader: plugins
1595  
1596 Type: ArrayRef
1597  
1598 =head2 pod_coverage_also_private
1599  
1600 Reader: pod_coverage_also_private
1601  
1602 Type: Maybe[ArrayRef]
1603  
1604 Additional documentation: If defined, passed to [Test::Pod::Coverage::Configurable] as its 'also_private' option.
1605  
1606 =head2 pod_coverage_class
1607  
1608 Reader: pod_coverage_class
1609  
1610 Type: Maybe[Str]
1611  
1612 Additional documentation: If defined, passed to [Test::Pod::Coverage::Configurable] as its 'class' option.
1613  
1614 =head2 pod_coverage_skip
1615  
1616 Reader: pod_coverage_skip
1617  
1618 Type: Maybe[ArrayRef]
1619  
1620 Additional documentation: If defined, passed to [Test::Pod::Coverage::Configurable] as its 'skip' option.
1621  
1622 =head2 pod_coverage_trustme
1623  
1624 Reader: pod_coverage_trustme
1625  
1626 Type: Maybe[ArrayRef]
1627  
1628 Additional documentation: If defined, passed to [Test::Pod::Coverage::Configurable] as its 'trustme' option.
1629  
1630 =head2 stopwords
1631  
1632 Reader: stopwords
1633  
1634 Type: ArrayRef
1635  
1636 Additional documentation: Additional stopword(s) for Pod::Spell tests. [May be repeated].
1637 See also: 'stopword_files' and 'wordlists' for alternative mechanisms of adding stopwords.
1638  
1639 =head2 stopwords_files
1640  
1641 Reader: stopwords_files
1642  
1643 Type: ArrayRef
1644  
1645 Additional documentation: File(s) that describe additional stopword(s) for Pod::Spell tests. [May be repeated].
1646 See also: 'stopwords' and 'wordlists' for alternative mechanisms of adding stopwords.
1647  
1648 =head2 stopwords_providers
1649  
1650 Reader: stopwords_providers
1651  
1652 Type: ArrayRef
1653  
1654 Additional documentation: Perl module(s) for contributing additional stopword(s) for spelling tests. [May be repeated].
1655 Note that given module(s) would need to expose the same API as L<Pod::Wordlist>.
1656 See also: 'stopwords' and 'stopword_files' for alternative mechanisms of adding stopwords.
1657  
1658 =head2 tag_format
1659  
1660 Reader: tag_format
1661  
1662 Type: Str
1663  
1664 Additional documentation: The tag format passed to [Git::Tag] after committing sources.
1665 The default is 'repo-release-v%V%t', which may be prefixed by some other string.
1666 The idea was copied from @DAGOLDEN who chose something more robust than just the version number when parsing versions with a regex. Default: 'repo-release-v%V%t'
1667  
1668 =head2 tag_format_dist
1669  
1670 Reader: tag_format_dist
1671  
1672 Type: Str
1673  
1674 Additional documentation: The tag format passed to [Git::Tag] after committing the build.
1675 The default is 'dist-release-v%V%t', which may be prefixed by some other string.
1676 The idea was copied from @DAGOLDEN who chose something more robust than just the version number when parsing versions with a regex. Default: 'dist-release-v%V%t'
1677  
1678 =head2 version_regexp
1679  
1680 Reader: version_regexp
1681  
1682 Type: Str
1683  
1684 Additional documentation: The version regex that corresponds to the 'tag_format'. Default: '^(?:[-\w]+)?release-(.+)$'
1685  
1686 =head2 weaver_config
1687  
1688 Reader: weaver_config
1689  
1690 Type: Str
1691  
1692 Additional documentation: Specifies a Pod::Weaver bundle to be used. Default: '@Author::TABULO'
1693  
1694 =for Pod::Coverage configure mvp_aliases payload_item
1695  
1696 =head1 AUTHORS
1697  
1698 Tabulo[n] <dev@tabulo.net>
1699  
1700 =head1 SUPPORT
1701  
1702 =head2 Bugs / Feature Requests
1703  
1704 Please report any bugs or feature requests through the issue tracker
1705 at L<https://github.com/tabulon-perl/p5-Dist-Zilla-PluginBundle-Author-TABULO/issues>.
1706  
1707 =head2 Source Code
1708  
1709 This is open source software. The code repository is available for
1710 public review and contribution under the terms of the license.
1711  
1712 L<https://github.com/tabulon-perl/p5-Dist-Zilla-PluginBundle-Author-TABULO>
1713  
1714 git clone https://github.com/tabulon-perl/p5-Dist-Zilla-PluginBundle-Author-TABULO.git
1715  
1716 =head1 CONTRIBUTOR
1717  
1718 =for stopwords Tabulo
1719  
1720 Tabulo <dev-git.perl@tabulo.net>
1721  
1722 =head1 LEGAL
1723  
1724 This software is copyright (c) 2023 by Tabulo[n].
1725  
1726 This is free software; you can redistribute it and/or modify it under
1727 the same terms as the Perl 5 programming language system itself.
1728  
1729 =cut
1730  
1731 __END__
↑ Summary Zest/Author/TABULO/MungersForHas.pm »