Skip to content

artyom-poptsov/guile-gitlab

Repository files navigation

Guile-GitLab

GNU Guile interface to GitLab CE REST API.

Requirements

Installation

$ autoreconf -vif
$ ./configure
$ make
$ sudo make install

gitlab-cli tool

Guile-GitLab comes with the tool called gitlab-cli – the tool can be used to interact with a GitLab instance from the console.

Getting help

$ gitlab-cli --help
$ gitlab-cli user --help
$ gitlab-cli user list --help

Commands

user

$ gitlab-cli user <sub-command> \
        --token "your-secret-gitlab-token" \
        --server "https://gitlab.example.org" \
        <other-options>

Sub-commands:

  • list, ls
  • remove, rm
Getting the list of all users
$ gitlab-cli user list \
        --token "your-secret-gitlab-token" \
        --server "https://gitlab.example.org"
Getting a user with the specific ID
$ gitlab-cli user list \
        --token "your-secret-gitlab-token" \
        --server "https://gitlab.example.org" \
        --id 12345
Limit number of users
$ gitlab-cli user list \
        --token "your-secret-gitlab-token" \
        --server "https://gitlab.example.org" \
        --search "gmail" \
        --limit 10
Use regular expressions to match user emails
$ gitlab-cli user list \
        --token "your-secret-gitlab-token" \
        --server "https://gitlab.example.org" \
        --email-like ".*gmail.com"
Print only the specified fields for each user
$ gitlab-cli user list \
        --token "your-secret-gitlab-token" \
        --server "https://gitlab.example.org" \
        --limit 10 \
        --print "name,email"
Remove a user
$ gitlab-cli user remove \
        --token "your-secret-gitlab-token" \
        --server "https://gitlab.example.org" \
        --id 12345

group

Prints the list of groups to standard output by default.

$ gitlab-cli group list \
        --token "your-secret-gitlab-token" \
        --server "https://gitlab.example.org"
        <other-options>

Pass --help option to the command to get help.

project

$ gitlab-cli project list \
        --token "your-secret-gitlab-token" \
        --server "https://gitlab.example.org"
        <other-options>

Pass --help option to the command to get help.