Skip to main content

A GitLab bot that tidies and attends to repositories

Project description

GitLab Attendant

Build Status Code style: black License: MIT


The GitLab Attendant is a bot that will tidy and attend to repositories on a specified GitLab installation at a scheduled basis. Currently the bot is capable of removing merged branches, assigning project members to open issues, assigning project members to open merge requests, notifying issue assignees of due or overdue issues, and notifying assignees of stale merge requests.

In order to use the GitLab Attendant fully, you should create a new account within the specified GitLab installation with privileges that will allow the bot to read and write any changes necessary to branches, merge requests, issues, etc. The personal access token for this account should then be entered in the token paramter when calling the bot from the command line.

Python 3.6 or Python 3.7 are required to run this utility.


This utility can be installed through pip by running the following command:

pip install gitlab-attendant


gitlab-attendant --ip localhost --interval 7 --token TOKEN

  --ip          The IP address of the GitLab installation.
  --interval    task scheduler interval in hours (ex. 1, 10) [default: 24]
  --token       GitLab personal access token.

This will run the GitLab Attendant process, which will begin attending to the specified GitLab installation at the first interval specified.


Tests for this project utilise the Pytest framework. To run the existing suite of unit tests run the following command within the root directory:



All Python code has been formatted by Black, 'the uncompromising Python code formatter'.

Type checking has been provided by Pyre.

Continuous integration is handled by Travis CI.



Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gitlab-attendant-0.0.1.tar.gz (2.4 kB view hashes)

Uploaded source

Built Distribution

gitlab_attendant-0.0.1-py3-none-any.whl (2.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page