https://github.com/boileaum/gitlab-users

A CLI tool to manage GitLab users.
https://github.com/boileaum/gitlab-users

cli gitlab python user-management

Last synced: 3 months ago
JSON representation

A CLI tool to manage GitLab users.

• Host: GitHub
• URL: https://github.com/boileaum/gitlab-users
• Owner: boileaum
• License: mit
• Created: 2017-10-11T15:29:02.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-02-26T19:42:16.000Z (almost 2 years ago)
• Last Synced: 2024-10-08T14:41:33.975Z (4 months ago)
• Topics: cli, gitlab, python, user-management
• Language: Python
• Size: 48.8 KB
• Stars: 9
• Watchers: 2
• Forks: 6
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# gitlab-users

A simple command line interface to manage GitLab user accounts, based on [python-gitlab](https://github.com/python-gitlab/python-gitlab).

## Installation

* Install the package on your system

```sh

pip install gitlab-users

```

* Edit the `~/.python-gitlab.cfg` following the [python-gitlab package instructions](http://python-gitlab.readthedocs.io/en/stable/cli.html) to setup the GitLab instance to connect with (present version only targets default instance).

## Usage

* Get help

```sh

gitlab-users -h

```

* List all users with their email

```sh

gitlab-users

```

* List emails from a given group

```sh

gitlab-users -g a_group --email-only

```

* Create multiple user accounts at once from a csv file

```sh

gitlab-users --create-from example.csv

```

where `example.csv` contains

```csv

# username, name, email, [organization], [location], [group], [access_level]

wayne,Bruce Wayne,[email protected],Wayne Entreprises,Gotham City,Board,owner

kent,Clark Kent,[email protected],,Smallville

```

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

```sh

gitlab-users --unused

```