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  ```