github.com/ianfoo/lab@v0.9.5-0.20180123060006-5ed79f2ccfc7/README.md (about) 1 # git + lab = gitlab [![Build Status](https://travis-ci.org/zaquestion/lab.svg?branch=master)](https://travis-ci.org/zaquestion/lab) [![Go Report Card](https://goreportcard.com/badge/github.com/zaquestion/lab)](https://goreportcard.com/report/github.com/zaquestion/lab) [![codecov](https://codecov.io/gh/zaquestion/lab/branch/master/graph/badge.svg)](https://codecov.io/gh/zaquestion/lab) [![Join the chat at https://gitter.im/labcli](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/labcli) 2 3 ![banner](https://user-images.githubusercontent.com/2358914/34196973-420d389a-e519-11e7-92e6-3a1486d6b280.png) 4 5 Lab wraps Git or [Hub](https://github.com/github/hub), making it simple to clone, fork, and interact with repositories on GitLab, including seamless workflows for creating merge requests, issues and snippets. 6 7 ``` 8 $ lab clone gitlab-com/infrastructure 9 10 # expands to: 11 $ git clone git@gitlab.com:gitlab-com/infrastructure 12 ``` 13 14 ## hub + lab = hublab?? 15 16 lab will look for hub and uses that as your git binary when available so you don't have to give up hub to use lab 17 ``` 18 $ lab version 19 git version 2.11.0 20 hub version 2.3.0-pre9 21 lab version 0.9.0 22 ``` 23 24 # Inspiration 25 26 The [hub](https://github.com/github/hub) tool made my life significantly easier and still does! lab is heavily inspired by hub and attempts to provide a similar feel. 27 28 # Installation 29 30 Dependencies 31 32 * `git` or `hub` 33 34 ### Homebrew 35 ``` 36 brew install zaquestion/tap/lab 37 ``` 38 39 ### Bash 40 41 Installs lab into `/usr/local/bin/` 42 ``` 43 curl -s https://raw.githubusercontent.com/zaquestion/lab/master/install.sh | bash 44 ``` 45 46 ### Source 47 48 Required 49 * [Go 1.9+](https://golang.org/doc/install) 50 * [GOPATH](https://golang.org/doc/code.html#GOPATH) 51 * [dep](https://github.com/golang/dep) 52 ``` 53 go get -u -d github.com/zaquestion/lab 54 cd $GOPATH/src/github.com/zaquestion/lab 55 dep ensure 56 go install -ldflags "-X \"main.version=$(git rev-parse --short=10 HEAD)\"" github.com/zaquestion/lab 57 ``` 58 59 # Configuration 60 61 The first time you run lab it will prompt for your GitLab information. lab uses HCL for its config and looks in `~/.config/lab.hcl` and `./lab.hcl` 62 ``` 63 $ lab 64 Enter default GitLab host (default: https://gitlab.com): 65 Enter default GitLab user: zaq 66 Enter default GitLab token: 67 ``` 68 69 # Aliasing 70 71 Like hub, lab feels best when aliased as `git`. In your `.bashrc` or `.bash_profile` 72 ``` 73 alias git=lab 74 ```