gitlab.com/prarit/lab@v0.14.0/README.md (about)

     1  # git + <img src="https://user-images.githubusercontent.com/3167497/34473826-40b4987c-ef2c-11e7-90b9-5ff322c4966f.png" width="30" height="30"> = 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) [![Donate](https://liberapay.com/assets/widgets/donate.svg)](https://liberapay.com/zaquestion/donate)
     2  
     3  <p align="center"><img src="https://user-images.githubusercontent.com/1964720/42740177-6478d834-8858-11e8-9667-97f193ecb404.gif" align="center"></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 + <img src="https://user-images.githubusercontent.com/3167497/34473826-40b4987c-ef2c-11e7-90b9-5ff322c4966f.png" width="30" height="30"> = 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.13.1
    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  ### Scoop
    40  ```
    41  scoop bucket add zaquestion https://github.com/zaquestion/scoop-bucket.git
    42  scoop install lab
    43  ```
    44  
    45  ### Bash
    46  
    47  Installs lab into `/usr/local/bin/`
    48  ```
    49  curl -s https://raw.githubusercontent.com/zaquestion/lab/master/install.sh | bash
    50  ```
    51  
    52  ### PreBuilt Binaries
    53  
    54  Head to the [releases](https://github.com/zaquestion/lab/releases) page and download your preferred release
    55  
    56  ### Source
    57  
    58  Required
    59  * [Go 1.9+](https://golang.org/doc/install)
    60  * [GOPATH](https://golang.org/doc/code.html#GOPATH)
    61  * [dep](https://github.com/golang/dep)
    62  
    63  ```
    64  go get -u -d github.com/zaquestion/lab
    65  cd $GOPATH/src/github.com/zaquestion/lab
    66  dep ensure
    67  go install -ldflags "-X \"main.version=$(git  rev-parse --short=10 HEAD)\""  github.com/zaquestion/lab
    68  ```
    69  
    70  or
    71  
    72  ```
    73  make install
    74  ```
    75  
    76  # Configuration
    77  
    78  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`
    79  ```
    80  $ lab
    81  Enter default GitLab host (default: https://gitlab.com):
    82  Enter default GitLab user: zaq
    83  Enter default GitLab token:
    84  ```
    85  
    86  # Aliasing
    87  
    88  Like hub, lab feels best when aliased as `git`. In your `.bashrc` or `.bash_profile`
    89  ```
    90  alias git=lab
    91  ```
    92  
    93  <p align="center"><img src="https://user-images.githubusercontent.com/2358914/34196973-420d389a-e519-11e7-92e6-3a1486d6b280.png" align="center"></p>