Dist::Zilla::Plugin::Git::CommitBuild - Check in build results on separate branch
version 2.047
In your dist.ini:
[Git::CommitBuild] ; these are the defaults branch = build/%b message = Build results of %h (on %b) multiple_inheritance = 0
Once the build is done, this plugin will commit the results of the build to a branch that is completely separate from your regular code branches (i.e. with a different root commit). This potentially makes your repository more useful to those who may not have Dist::Zilla and all of its dependencies installed.
The plugin accepts the following options:
branch - String::Formatter string for where to commit the build contents.
A single formatting code (%b) is defined for this attribute and will be substituted with the name of the current branch in your git repository.
%b
Defaults to build/%b, but if set explicitly to an empty string causes no build contents checkin to be made.
build/%b
release_branch - String::Formatter string for where to commit the build contents
Same as branch, but commit the build content only after a release. No default, meaning no release branch.
branch
message - String::Formatter string for what commit message to use when committing the results of the build.
This option supports five formatting codes:
%b - Name of the current branch
%H - Commit hash
%H
%h - Abbreviated commit hash
%h
%v - The release version number
%v
%V - The release version number, but with a leading v removed if it exists
%V
v
%t - The string "-TRIAL" if this is a trial release
%t
release_message - String::Formatter string for what commit message to use when committing the results of the release.
Defaults to the same as message.
message
multiple_inheritance - Indicates whether the commit containing the build results should have the source commit as a parent.
If false (the default), the build branch will be completely separate from the regular code branches. If set to a true value, commits on a build branch will have two parents: the previous build commit and the source commit from which the build was generated.
Bugs may be submitted through the RT bug tracker (or bug-Dist-Zilla-Plugin-Git@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 on irc.perl.org.
#distzilla
irc.perl.org
Jerome Quelin
This software is copyright (c) 2009 by Jerome Quelin.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Dist::Zilla::Plugin::Git, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Dist::Zilla::Plugin::Git
CPAN shell
perl -MCPAN -e shell install Dist::Zilla::Plugin::Git
For more information on module installation, please visit the detailed CPAN module installation guide.