Git extension for trello

You can mange your feature branches related with trello cards.

• RULE1: Every branch name should have trello id.
• RULE2: Every commit message should contain its related trello card url.

Installation

Clone the git repository or download zip file and run install.sh in it.

$ git clone https://github.com/gitulamy/git-tr.git
$ cd git-tr
$ bash ./install.sh

OR

$ curl https://codeload.github.com/gitulamy/git-tr/zip/master > git-tr.zip
$ unzip git-tr.zip
$ cd git-tr-master
$ bash ./install.sh

Usage

(1) Initialization

This will ask you to determine the base branch names, which is used for branching feature and hotfix.

$ git tr init

(2) Start feature branch

You should have a trello card before creating a feature branch. Let's pick an example trello card to explain.

https://trello.com/c/AtX5el00/225-We-need-a-new-button-for-check

What we need is the full url of a card.

And run git tr with subcommand 'feature' (You can use only the first letter 'f' for quick)

$ git tr feature https://trello.com/c/AtX5el00/225-We-need-a-new-button-for-check

or simply

$ git tr f https://trello.com/c/AtX5el00/225-We-need-a-new-button-for-check

This will make a branch named as 'feature/AtX5el00' branching from develop branch which is set at init phase.

(3) Commit a changeset

As long work to meet the requirement of the trello card, now you are about to commit a changeset. (You can also 'c' instead of 'commit')

$ git tr commit

This will show up the editor with an commit template message, which contains the trello url.

https://trello.com/c/AtX5el00/225-We-need-a-new-button-for-check

# blah blah index and diff of the files.

(4) Push the branch to origin

After finishing the works, now you are about to push the branch for making pull request, at this moment, the origin repository doens't have your feature branch, and this will make a new branch.

$ git tr push

(You can also 'p' instead of 'push')

(5) Etc 1: Start hotfix branch

All the process is same with feature branching, but use 'hotfix' instead of 'feature'

$ git tr hotfix https://trello.com/c/AtX5el01/226-We-need-a-button-for-check

And as the same before 'h' is enough for typing 'hotfix'

(6) Etc 2: Change the prefix of 'feature', 'hotfix'

If you don't want 'feature/' ans the prefix for new feature branch. You can edit 'git config' file.

$ git config trello.prefix.feature 'feature-'
$ git config trello.prefix.hotfix 'hotfix-'


$ git config | grep trello

Be happy with trello.