/gitlab-users

A CLI tool to manage GitLab users.

Primary LanguagePythonMIT LicenseMIT

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