git_lab_cli 0.7.0

A custom git command for interacting with a GitLab server
git_lab_cli-0.7.0 is not a library.

git_lab_cli

pipeline status coverage report

ALPHA - what is here works, but functionality is still under active development.

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

Functionality

The tool is designed to work as a custom command to the vanilla git cli command.

Current functions

  • init -- initialise credentials aganst 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 (open|view|browse) -- open issue's URL in browser
    • issue (show|info|get) -- show details about a issue

Planned functions

  • project -- interact with GitLab projects

    • project list -- get list of projects

  • issue -- interact with issues

    • issue list -- get list of issues

  • merge-request -- interact with merge requests

    • merge-request create -- create merge request
    • merge-request list -- get list of merge requests
    • merge-request (open|view|browse) -- open merge-request's URL in browser
    • merge-request (show|info|get) -- show details about a merge-request
    • merge-request approve -- approve merge request
    • merge-request merge -- merge merge request

  • pipeline -- interact with Gitlab CI jobs

  • group -- interact with Gitlab groups

  • user -- interact with Gitlab users

  • probably others like labels, etc..

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

Planned features

  • musl and glibc binary packages
  • support for various linux packaging tools like AUR, Deb, RPM, etc
  • non-Linux support (maybe)

Installation

For now, this is only available via cargo while under development.

cargo install git_lab_cli

Compatibility

Supports GitLab server version 13

Contributions

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

License: MIT