Guillaume Aubert > App-GitHooks-Plugin-MatchBranchTicketID-v1.0.1 > App::GitHooks::Plugin::MatchBranchTicketID

Download:
App-GitHooks-Plugin-MatchBranchTicketID-v1.0.1.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: v1.0.1   Source  

NAME ^

App::GitHooks::Plugin::MatchBranchTicketID - Detect discrepancies between the ticket ID specified by the branch name and the one in the commit message.

DESCRIPTION ^

App::GitHooks::Plugin::PrependTicketID allows pulling ticket IDs from the branch name. This way, if you're committing a lot, having a proper branch name can save you a lot of time.

That said, you sometimes need to commit using a different ticket ID than what the branch specifies. In order to prevent typos, this plugin will detect if the ticket ID specified in the commit message doesn't match the ticket ID infered from the branch name, and ask you to confirm that you want to proceed forward.

VERSION ^

Version 1.0.1

CONFIGURATION OPTIONS ^

This plugin supports the following options in the main section of your .githooksrc file.

        project_prefixes = OPS, DEV, TEST
        extract_ticket_id_from_branch = /^($project_prefixes\d+)/
        normalize_branch_ticket_id = s/^(.*?)(\d+)$/\U$1-$2/
        extract_ticket_id_from_commit = /^($project_prefixes-\d+|--): /

project_prefixes

The list of valid ticket prefixes.

        project_prefixes = OPS, DEV, TEST

extract_ticket_id_from_branch

A regular expression with one capturing group that will extract the ticket ID from a branch name.

        extract_ticket_id_from_branch = /^($project_prefixes\d+)/

In the example above, if a branch is named dev1293_my_new_feature, the regular expression will identify dev1293 as the ticket ID corresponding to that branch.

Note that:

normalize_branch_ticket_id

A replacement expression to normalize the ticket ID extracted with extract_ticket_id_from_branch.

        normalize_branch_ticket_id = s/^(.*?)(\d+)$/\U$1-$2/

In the example above, dev1293_my_new_feature gave dev1293, which is then normalized as DEV-1293.

extract_ticket_id_from_commit

A regular expression with one capturing group that will extract the ticket ID from a commit message.

        extract_ticket_id_from_commit = /^($project_prefixes-\d+|--): /

Note that:

METHODS ^

run_commit_msg()

Code to execute as part of the commit-msg hook.

  my $success = App::GitHooks::Plugin::MatchBranchTicketID->run_commit_msg();

BUGS ^

Please report any bugs or feature requests through the web interface at https://github.com/guillaumeaubert/App-GitHooks-Plugin-MatchBranchTicketID/issues/new. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT ^

You can find documentation for this module with the perldoc command.

        perldoc App::GitHooks::Plugin::MatchBranchTicketID

You can also look for information at:

AUTHOR ^

Guillaume Aubert, <aubertg at cpan.org>.

COPYRIGHT & LICENSE ^

Copyright 2013-2014 Guillaume Aubert.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version 3 as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/

syntax highlighting: