waldofe / git-gitlab

gitlab command line interface

git + lab = gitlab

lab is a command line tool that wrap git in order to extend it with extra features and commands that make working with GitLab easier.

$ git lab clone numa08/dejiko

# extends to:
$ git clone git://${gitlab.url}/numa08/dejiko.git

Installation

Mac OS X

Install go-lang (if not already installed)

$ brew install go

When go-lang is installed:

$ brew install libgit2
$ go get gopkg.in/libgit2/git2go.v23
$ go get github.com/plouc/go-gitlab-client
$ go get github.com/codegangsta/cli

Execute from within the git-gitlab repository clone

$ make build

Finally, move build/git-lab somewhere in $PATH.

Note

OSX El Capitan users may encounter the following error

could not determine kind of name for C.GIT_CHECKOUT_SAFE_CREATE

when running

$ go get gopkg.in/libgit2/git2go.v22

This is because libgit v0.23.x was installed. You need 0.22.x. See libgit2/git2go#181 (comment) for more information.

Archlinux

There is an aur package called git-gitlab.

Configure

Set the value of Gitlab-url and token.

$ git config --global gitlab.url http://gitlab.example.com

$ git config --global gitlab.token GITLAB_SECRET_TOKEN

then, set gitlab namespace and project.

$ git config gitlab.project [NAMESPACE]/[PROJECT]

Commands

git clone

$ git lab clone numa08/dejiko
> git clone git://{gitlab.url}/numa08/dejiko

$ git lab clone -p numa08/dejiko
> git clone git@{gitlab.url}/:numa08/dejiko

merge request

$ git lab merge-request -b basebranch -h headbranch
>open text editor to edit title and body
>open pull request on GitLab

$ git merge-request -b forked:branch -h origin:branch -m "Fix issue #xxx"

git merge

$ git lab merge [MERGE_REQUEST_ID]

git show

$ git lab show issues/[ISSUE_ID]
$ git lab show merge_requests/[MERGE_REQUEST_ID]

$ git lab show -d issues 
> Opens issues dashboard

$ git lab show -d merge_requests 
> Opens issues dashboard

git-gitlab's Issues

Add a "CONTRIBUING.md"

Mention:

• Forking
• How to run tests

Adjust styling

• Remove trailing spaces
• Unnecessary empty lines
• Make a gofmt check in order to stardandize alignments

Remove "gitlab.host" git config dependency

Discover why one needs to set "gitlab.host" git config if we're already setting "gitlab.url" in the first place.

Implement "lab show issue" command

asdasdadasda

Improve docs

Documentation seems outdated.

• Mention git config --global gitlab.host gitlab.xxx.com
• Remove cli commands that does not work

Implement "lab merge-request" command

This command should work similarly to hub project, opening the editor for merge request Title and Description editing.

Improve "lab show" command

show command could be used to open /issues or /merge_requests page directly from terminal:

Proposal

git lab show issues
# open "http://[gitlab.url]/[namespace]/[project]/issues

git lab show merge_requests
# open "http://[gitlab.url]/[namespace]/[project]/merge_requests

Future ideas

git lab show -d issues
# open "http://[gitlab.url]/dashboard/issues?assignee_id=x

git lab show -d merge_requests
# open "http://[gitlab.url]/dashboard/merge_requests?assignee_id=x

aisugdasgdjahsgdjkahsgdjkg