From a50f103ff137ab8669b026c733135d65614c766e Mon Sep 17 00:00:00 2001 From: Ipan Ardian Date: Sun, 19 Aug 2018 15:02:43 +0700 Subject: [PATCH] Update README.md --- README.md | 79 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 79 insertions(+) diff --git a/README.md b/README.md index ebf48f7..37f8dfb 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,81 @@ # GoBranch +[![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/ipanardian/gobranch/issues) +[![Release](https://img.shields.io/badge/release-v0.0.0.1-orange.svg)](https://github.com/ipanardian/gobranch/releases) +[![Status](https://img.shields.io/badge/status-beta-green.svg)](https://github.com/ipanardian/gobranch/releases) +[![Go](https://img.shields.io/badge/go-v1.10.x-blue.svg)](https://gitter.im/ipanardian/gobranch) +[![GitHub license](https://img.shields.io/badge/license-MIT-red.svg)](https://github.com/ipanardian/GoBranch/blob/master/LICENSE) +[![Github All Releases](https://img.shields.io/github/downloads/ipanardian/GoBranch/total.svg)](https://github.com/ipanardian/GoBranch) + + + A command line app to help you quickly creating git branch without hassle step. + +## Usage +``` +$ gobranch +``` +![gobranch](https://user-images.githubusercontent.com/415225/44306664-cc81b880-a3bd-11e8-878f-73bc0551bfca.gif) + +## Custom +![gobranch-custom](https://user-images.githubusercontent.com/415225/44306690-49ad2d80-a3be-11e8-9c2c-f626618486cc.gif) + +## Features +* You don't need to type a valid branch name +* You don't need to checkout to the base branch +* You don't need to git pull the base branch +* Automatic prefixes such as feature, enhance, bugfix, hotfix +* Prevent the selected base branch from being wrong +* Custom base branch +* Custom naming conventions + +## Requirements +* Git + +## Installation +``` +$ go get github.com/ipanardian/GoBranch +``` +or just download the binary file on the release tab and add it to your ***$PATH*** or save it to ***/usr/local/bin***. + +## Naming Conventions +``` +$ gobranch --tc "/" --nc "snake" +//output: feature/abcd_efgh + +$ gobranch --tc "-" --nc "kebab" +//output: feature-abcd-efgh +``` + +## Branch Tree +The following is a branch of the gobranch diagram, you must have a branch **development** and **hotfix**, unless you choose **custom** then there is no need to follow this diagram. +``` + -- master + |-- development + | |-- feature_{name} + | |-- enhance_{name} + | |-- bugfix_{name} + | `-- test_{name} + `-- hotfix + |-- hotfix_{name} + `-- hotfeature_{name} +``` + +## Flags +``` +//show help +$ gobranch --help or -h + +//show version +$ gobranch --version or -v + +//Set type convention +$ gobranch --tc / +//output: feature/{branch} + +//Set naming convention +$ gobranch --nc kebab +//output: branch-name +``` + +## License +The MIT License (MIT)