git-checkout-task

Git custom command to checkout branch for a specific task

Description

This custom git command is intended to simplify checkout of feature-branch for a specific task from issue tracker like Jira.

Requirements

Feature-branch must contain a task ID anywhere within it. The following branchs names are valid for task ABC-1234: ABC-1234-awesome-bugfix, ABC-1234/awesome-bugfix, feature/ABC-1234-awesome-feature, and etc.

How to use

git checkout-task ABS-1234

If the command name looks long for you just add an alias for it:

git config --global alias.cot checkout-task

How it works

Grep all branches including remote ones with the task ID
Removes everything before task id thus remotes/origin/ABC-1234-awesome-bugfix becomes just ABC-1234-awesome-bugfix or remotes/origin/ABC-1234/awesome-bugfix becomes ABC-1234/awesome-bugfix
Checkout that branch

Edge cases

C - case, B - behavior

C: You're already on the desired branch
B: No branch checkout. Info message printed

C: There are no branches with the specified prefix
B: No branch checkout. Error message printed

C: There is more than one branch with the specified prefix
B: No branch checkout. The names of clashing branches will be printed

How to install

Put the file git-checkout-task to any folder that is in the PATH and make it executable.

For example:

cd ~ && \
mkdir .gitbin && \
cd .gitbin && \
curl -o git-checkout-task https://raw.githubusercontent.com/int02h/git-checkout-task/master/git-checkout-task && \
chmod +x git-checkout-task

Then add ~/.gitbin to the PATH. Put the following line in the ~/.bashrc, or ~/.zshrc, or in the script for whatever shell you're using:

export PATH=$PATH:~/.gitbin

Changelog

v1.0.1

Support slash / in branch name so both ABC-1234-awesome-bugfix and ABC-1234/awesome-bugfix are valid

v1.0.2

Task ID can be anywhere within a branch name, not only at the beginning.

License

Licensed under the MIT License.