Installing the `git-lab` executable

Assuming you have Rust/Cargo installed, run this command in a terminal:

cargo install git_lab_cli

It will make the git-lab command available in your PATH if you've allowed the PATH to be modified when installing Rust. cargo uninstall git_lab_cli uninstalls.

Back to the crate overview.

Readme

git_lab_cli

This is a cli tool that adds the lab command to git to enable interaction with a GitLab server.

Change Log

See CHANGELOG.md for a summary of fixes and features added to each release.

Functionality

The tool is designed to work as a custom command to the vanilla git cli command. Once installed you can invoke it with git lab <subcommand> <options>....

Current functions

init -- initialise credentials against a remote GitLab server
project -- interact with GitLab projects
- project create -- create project
- project attach -- associate a local repo with a project
- project (open|view|browse) -- open project's URL in browser
- project (show|info|get) -- show details about a project
issue -- interact with issues
- issue create -- create issue (either entirely via cli-passed parameters, or interactively, by prompting the user for the inputs needed)
- issue assign -- assign issue
- issue (open|view|browse) -- open issue's URL in browser
- issue (show|info|get) -- show details about a issue
- issue list -- get list of issues
- issue close -- close issue
- issue reopen -- reopen issue
- issue lock -- lock discussions on issue
- issue unlock -- unlock discussions on issue
mr -- interact with merge requests
- mr create -- create merge request (either entirely via cli-passed parameters, or interactively, by prompting the user for the inputs needed)
- mr assign -- assign merge request
- mr close -- close merge request
- mr reopen -- reopen merge request
- mr lock -- lock discussions on merge request
- mr unlock -- unlock discussions on merge request
- mr list -- get list of merge requests
- mr (open|view|browse) -- open merge request's URL in browser
- mr (show|info|get) -- show details about a merge request
- mr (checkout|co) -- checkout merge request
- mr wip -- toggle WIP: (or Draft:) status of merge request
- mr approve -- approve merge request
- mr merge -- merge merge request

Planned functions

labels -- interact with Gitlab labels
project list -- get list of projects
pipeline -- interact with Gitlab CI jobs
group -- interact with Gitlab groups
user -- interact with Gitlab users
probably others...

Features

Current features

Config stored using standard git config machinery
Locally cached Gitlab metadata to improve usability when creating gitlab objects interactively
JSON output in addition to plain text to allow for parsing with tools like jq
Terminal-based markdown rendering
$EDITOR integration on create commands
musl binaries available here

Planned features

support for various linux packaging tools like AUR, Deb, RPM, etc
non-Linux support (PRs requested!)

Installation

Cargo

If you have the Rust toolchain installed, you can install via cargo:

cargo install git_lab_cli

Statically linked Linux binaries

Grab a tarball for these here. Untar the file and then copy the included files into place as shown in the below example:

cd git_lab_cli-x.y.z-x86_64-unknown-linux-musl
sudo cp git-lab /usr/local/bin/
sudo cp man/git-lab.1 /usr/local/share/man/man1/

Getting started

To connect the git-lab cli binary to a GitLab instance you need to create a Personal Access Token. On Gitlab.com this can be done here. Copy the token to your clipboard and then run the following from your home directory:

git lab init

This will prompt you though entering the required set-up parameters, one of which will require you to paste the GitLab token copied in the previous step into the config. Your default .gitconfig will then be updated with the information needed to connect git-lab to your server. You can also set this config up with vanilla git config commands. See git lab init --help for details on how to do this.

The easiest way to get started with an existing git repo is to run the following from within the repo:

git lab project attach

This will assoicate the git repo you are working on with a server-side GitLab project by looking at your origin git remote. Once this is done, you'll be able to query, create, and modify project-specific objects like GitLab issues, merge-requests, and such like as long as you remain within the repo's subtree.

Compatibility

The tool tries to track GitLab.com's latest version pretty closely. Currently GitLab 13.0 and above work but earlier versions do not.

Contributions

Merge requests are welcome. Please raise a merge request on GitLab, not GitHub.

License: MIT

Installing the git-lab executable

Installing the `git-lab` executable