Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bleargh45/dist-zilla-pluginbundle-author-gtermars
Plugin Bundle for distributions built by GTERMARS
https://github.com/bleargh45/dist-zilla-pluginbundle-author-gtermars
dist-zilla dzil
Last synced: about 2 months ago
JSON representation
Plugin Bundle for distributions built by GTERMARS
- Host: GitHub
- URL: https://github.com/bleargh45/dist-zilla-pluginbundle-author-gtermars
- Owner: bleargh45
- Created: 2020-12-31T04:34:15.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2023-06-12T20:11:13.000Z (over 1 year ago)
- Last Synced: 2024-10-15T16:24:08.257Z (3 months ago)
- Topics: dist-zilla, dzil
- Language: Perl
- Homepage: https://metacpan.org/release/Dist-Zilla-PluginBundle-Author-GTERMARS/
- Size: 82 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: Changes
Awesome Lists containing this project
README
# NAME
Dist::Zilla::PluginBundle::Author::GTERMARS - Plugin Bundle for distributions built by GTERMARS
# SYNOPSIS
In your `dist.ini`:
```
[@Author::GTERMARS]
```
# DESCRIPTION
This is the `Dist::Zilla` plugin bundle that GTERMARS uses to build his
distributions.
It is _roughly_ equivalent to the following:
```perl
; ==============================================================================
; Ensure we're using the correct Author Bundle
[PromptIfStale / Stale author bundle]
phase = build
module = Dist::Zilla::PluginBundle::Author::GTERMARS
; ==============================================================================
; Gather up all the files we need in our distribution
[GatherDir]
exclude_filename = dist.ini
exclude_filename = cpanfile
[ExecDir]
dir = (-d 'script' ? 'script' : 'bin')
[ShareDir]
[PruneCruft]
; ==============================================================================
; Auto-generate files as needed...
; ... Makefile.PL
[MakeMaker]
; ... MANIFEST
[Manifest]
; ... LICENSE
[License]
; ... README file(s)
[ReadmeAnyFromPod / ReadmeGfmInRoot]
[ReadmeAnyFromPod / ReadmeInDist]
; ... Dependencies
[Prereqs::FromCPANfile]
[Prereqs::AuthorDeps]
; ... META
[MetaYAML]
[MetaJSON]
[MetaNoIndex]
directory = examples
directory = inc
directory = local
directory = share
directory = t
directory = xt
; ... Tests
[MetaTests]
[Test::ReportPrereqs]
verify_prereqs = 1
[Test::NoTabs]
[Test::EOL]
[Test::EOF]
[Test::MinimumVersion]
[Test::Synopsis]
[PodSyntaxTests]
[PodCoverageTests]
[Test::PodSpelling]
[Test::NoBreakpoints]
[Test::CleanNamespaces]
[Test::DiagINC]
[Test::UnusedVars]
[Test::Kwalitee]
[Test::Compile]
fake_home = 1
filename = t/01-compile.t
bail_out_on_fail = 1
; ==============================================================================
; Additional Metadata
[GitHub::Meta]
[StaticInstall]
mode = auto
; ==============================================================================
; Run "xt/" tests, but don't include them in the release.
[RunExtraTests]
default_jobs = 8
; ==============================================================================
; Munge existing files
[NextRelease]
[RewriteVersion]
; ==============================================================================
; Release
; ... before release
[PromptIfStale / Stale modules, release]
phase = release
check_all_plugins = 1
check_all_prereqs = 1
skip = ExtUtils::MakeMaker
[Git::CheckFor::MergeConflicts]
[Git::CheckFor::CorrectBranch]
release_branch = main
[EnsureChangesHasContent]
[EnsureMinimumPerl]
[Git::Check / initial check]
[TestRelease]
[Git::Check / after tests]
[GitHub::RequireGreenBuild]
[CheckIssues]
; ... do the release (unless "fake_release" is set)
[ConfirmRelease]
[UploadToCPAN]
[GitHub::Update]
; ... after release; commit Changes and Tag release
[Git::Commit / Commit Changes]
commit_msg = Release v%V
[Git::Tag]
; ... after release; save Release artifacts
[Git::CommitBuild]
branch =
release_branch = releases
release_message = Release - v%v
; ... after release; bump Version for next release
[BumpVersionAfterRelease]
[Git::Commit / Commit Version Bump]
allow_dirty_match = ^lib/
commit_msg = Version bump.
; ... after release; push changes up to Git (unless "fake_release" is set)
[Git::Push]
push_to = origin
push_to = origin releases:releases
```
# CUSTOMIZATION
## Our Configuration Options
- fake\_release
A boolean option, which when set, removes `[ConfirmRelease]`,
`[UploadToCPAN]`, and `[GitHub::Update]`, replacing them with
`[FakeRelease]`.
Defaults to false, and can also be set with the `FAKE_RELEASE=1` environment
variable.
## POD Coverage
Subroutines can be considered "covered" for POD Coverage checks, by adding a
directive to the POD itself, as described in [Pod::CoverageTrustPod](https://metacpan.org/pod/Pod%3A%3ACoverageTrustPod):
```
=for Pod::Coverage foo bar baz
```
## POD Spelling
Stopwords for POD Spelling checks can be added by adding a directive to the POD
itself, as described in [Pod::Spell](https://metacpan.org/pod/Pod%3A%3ASpell):
```
=for stopwords foo bar baz
```
## Providing Plugin Configuration
This plugin bundle uses `Dist::Zilla::Role::PluginBundle::Config::Slicer`,
which allows you to provide plugin-specific configuration like this:
```
[@Author::GTERMARS]
GatherDir.exclude_filename = cpanfile
```
## Removing Plugins
This plugin bundle uses `Dist::Zilla::Role::PluginBundle::Remover`, allowing
you to remove specific plugins like this:
```
[@Author::GTERMARS]
-remove = GitHub::Meta
-remove = RunExtraTests
```
# AUTHOR
Graham TerMarsch ([email protected])
# COPYRIGHT
Copyright (C) 2020-, Graham TerMarsch. All Rights Reserved.
This is free software; you can redistribute it and/or modify it under the same
license as Perl itself.
# SEE ALSO
- [Dist::Zilla](https://metacpan.org/pod/Dist%3A%3AZilla)