github.com/lelandbatey/lab@v0.12.1-0.20180712064405-55bfd303a5f0/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  <p align="center"><img src="https://user-images.githubusercontent.com/2358914/34196973-420d389a-e519-11e7-92e6-3a1486d6b280.png" align="center" height="350"></p>
     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.12.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  ```
    54  go get -u -d github.com/zaquestion/lab
    55  cd $GOPATH/src/github.com/zaquestion/lab
    56  dep ensure
    57  go install -ldflags "-X \"main.version=$(git  rev-parse --short=10 HEAD)\""  github.com/zaquestion/lab
    58  ```
    59  
    60  or
    61  
    62  ```
    63  make install
    64  ```
    65  
    66  # Configuration
    67  
    68  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`
    69  ```
    70  $ lab
    71  Enter default GitLab host (default: https://gitlab.com):
    72  Enter default GitLab user: zaq
    73  Enter default GitLab token:
    74  ```
    75  
    76  # Aliasing
    77  
    78  Like hub, lab feels best when aliased as `git`. In your `.bashrc` or `.bash_profile`
    79  ```
    80  alias git=lab
    81  ```