gitlab-users

A simple command line interface to manage GitLab user accounts, based on python-gitlab.

Installation

• Install the package on your system

pip install gitlab-users

• Edit the ~/.python-gitlab.cfg following the python-gitlab package instructions to setup the GitLab instance to connect with (present version only targets default instance).

Usage

• Get help

gitlab-users -h

• List all users with their email

gitlab-users

• List emails from a given group

gitlab-users -g a_group --email-only

• Create multiple user accounts at once from a csv file

gitlab-users --create-from example.csv

where example.csv contains

# username, name, email, [organization], [location], [group], [access_level]
wayne,Bruce Wayne,bruce.wayne@wayne-entreprises.com,Wayne Entreprises,Gotham City,Board,owner
kent,Clark Kent,clark.kent@krypton.univ,,Smallville

• List unused accounts (never sign-in or last connection is older than 1 year)

gitlab-users --unused