lab

Lab

关于GitLab的命令行工具

功能

lab sync     同步gitlab项目至本地
lab browser  模糊搜索项目名, 回车后，默认浏览器中打开项目地址
lab open     快捷在默认浏览器中打开当前所在项目的web地址
lab clone    模糊搜索项目名, 如果设置了codespace, 会将项目clone至codespace，
             否则在当前目录，当然也可以通过--current(-c)，clone至当前路径
lab ws       模糊搜索codespace中的项目，可配合cd，rm使用
lab lint     校验.gitlab-ci.yml文件格式
lab ci       获取当前项目指定远端分支的ci日志
lab config   快捷打开lab的配置文件

通过 lab help 查看lab更多命令及其参数

安装

homebrew

$ brew install ackerr/tap/lab

scoop

$ scoop bucket add ackerr https://github.com/Ackerr/scoop-bucket
$ scoop install ackerr/lab

go get

$ go get -u "github.com/ackerr/lab"

配置

在首次使用lab config时，会默认生成配置文件，所有配置如下

[gitlab]
base_url  = $GITLAB_BASE_URL
token     = $GITLAB_TOKEN

codespace = ""
name      = ""
email     = ""

[main]
fzf        = 0    # 是否使用系统fzf
clone_opts = ""   # git clone 额外参数

根据功能分为 gitlab 与 main 两个部分，添加时需要注意。其中base_url 与 token 为必填项，其余配置均为选填。token获取方式可参考链接。

lab clone

• 设置name和email，会默认为项目设置git user.name以及user.email
• 设置codespace，会将项目clone至codespace路径中，并使用结构化目录展示, 例如clone ackerr/ackerr 则会克隆至$CODESPACE/$GITLAB_BASE_URL/ackerr/ackerr
• 通过clone_opts，可额外添加自定义git参数，例如clone_opts="--origin ackerr --branch fix"

lab ws

配合alias使用

alias ws='cd `lab ws`'
alias rro='rm -r `lab ws`'