-
-
02 Feb 2018 02:46:25 UTC
- Distribution: Dist-Zilla-Plugin-RewriteVersion-Transitional
- Module version: 0.009
- Source (raw)
- Browse (raw)
- Changes
- Homepage
- How to Contribute
- Repository
- Issues
- Testers (2166 / 0 / 0)
- Kwalitee
Bus factor: 1- 81.68% Coverage
- License: perl_5
- Perl: v5.6.0
- Activity
24 month- Tools
- Download (35.55KB)
- MetaCPAN Explorer
- Permissions
- Subscribe to distribution
- Permalinks
- This version
- Latest version
- Dependencies
- Dist::Zilla
- Dist::Zilla::Plugin::BumpVersionAfterRelease
- Dist::Zilla::Plugin::PkgVersion
- Dist::Zilla::Plugin::RewriteVersion
- Dist::Zilla::Util
- Module::Runtime
- Moose
- Moose::Role
- Moose::Util::TypeConstraints
- Path::Tiny
- Scalar::Util
- Term::ANSIColor
- namespace::autoclean
- strict
- warnings
- Reverse dependencies
- CPAN Testers List
- Dependency graph
- NAME
- VERSION
- SYNOPSIS
- DESCRIPTION
- CONFIGURATION OPTIONS
- SEE ALSO
- SUPPORT
- AUTHOR
- COPYRIGHT AND LICENCE
NAME
Dist::Zilla::Plugin::RewriteVersion::Transitional - Ease the transition to [RewriteVersion] in your distribution
VERSION
version 0.009
SYNOPSIS
In your dist.ini:
[RewriteVersion::Transitional] fallback_version_provider = Git::NextVersion
DESCRIPTION
This is a Dist::Zilla plugin that subclasses [RewriteVersion], to allow plugin bundles to transition from [PkgVersion] or [OurPkgVersion] to [RewriteVersion] and [BumpVersionAfterRelease] without having to manually edit the dist.ini or any .pm files.
Determining the distribution version
As with [RewriteVersion], the version can be overridden with the
V
environment variable, or provided through some other means by settingskip_version_provider = 1
. Then, the main module (see "main module" in Dist::Zilla) in the distribution is checked for a$VERSION
assignment. If one is not found, then the plugin named by thefallback_version_provider
is instantiated (with any extra configuration options provided) and called to determine the version.Munging the modules
When used in a distribution where the .pm file(s) does not contain a
$VERSION
declaration, this plugin will add one. If one is already present, it leaves it alone, acting just as [RewriteVersion] would.You would then use [BumpVersionAfterRelease::Transitional] to increment the
$VERSION
in the .pm files in the repository.Note: If there is more than one package in a single file, if there was any
$VERSION
declaration in the file, no additional declarations are added for the other packages, even if you are using theglobal
option.CONFIGURATION OPTIONS
Configuration is the same as in [RewriteVersion], with the addition of:
fallback_version_provider
Specify the name (in abbreviated form) of the plugin to use as a version provider if the version was not already set with the
V
environment variable. Not used if "skip_version_provider" in Dist::Zilla::Plugin::RewriteVersion is true.Don't forget to add this plugin as a runtime-requires prerequisite in your plugin bundle!
SEE ALSO
SUPPORT
Bugs may be submitted through the RT bug tracker (or bug-Dist-Zilla-Plugin-RewriteVersion-Transitional@rt.cpan.org).
There is also a mailing list available for users of this distribution, at http://dzil.org/#mailing-list.
There is also an irc channel available for users of this distribution, at
#distzilla
onirc.perl.org
.I am also usually active on irc, as 'ether' at
irc.perl.org
.AUTHOR
Karen Etheridge <ether@cpan.org>
COPYRIGHT AND LICENCE
This software is copyright (c) 2014 by Karen Etheridge.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
Module Install Instructions
To install Dist::Zilla::Plugin::RewriteVersion::Transitional, copy and paste the appropriate command in to your terminal.
cpanm Dist::Zilla::Plugin::RewriteVersion::Transitional
perl -MCPAN -e shell install Dist::Zilla::Plugin::RewriteVersion::Transitional
For more information on module installation, please visit the detailed CPAN module installation guide.