semvec/pypi-packages huggingface dataset:
gitlab-usermgmt 1.0.6
Manage big GitLab groups with automation.
License: MIT
Requires Python: >=3.6,<4.0

===============
gitlab_usermgmt
===============


.. image:: https://img.shields.io/pypi/v/gitlab_usermgmt.svg
        :target: https://pypi.python.org/pypi/gitlab_usermgmt
        :alt: Pypi Status

.. image:: https://gitlab.com/ayeks/gitlab_usermgmt/badges/master/pipeline.svg
        :target: https://gitlab.com/ayeks/gitlab_usermgmt/pipelines/latest
        :alt: CICD Pipeline Status

.. image:: https://gitlab.com/ayeks/gitlab_usermgmt/badges/master/coverage.svg
        :target: https://gitlab.com/ayeks/gitlab_usermgmt/-/commits/master
        :alt: Coverage

.. image:: https://img.shields.io/badge/docs-online-brightgreen
        :target: https://ayeks.gitlab.io/gitlab_usermgmt
        :alt: Documentation


Manage big GitLab groups with automation.

* Free software: MIT license
* Sourcecode: https://gitlab.com/ayeks/gitlab_usermgmt
* Issues: https://gitlab.com/ayeks/gitlab_usermgmt/issues
* Documentation: https://ayeks.gitlab.io/gitlab_usermgmt

Features
--------

* lists all user access rights for a group inclusive all subgroups and projects
* manage users access to GitLab groups or projects by defining user groups in a JSON file
* grant all users in a group access to defined shared GitLab groups or projects
* set expire dates for user access
* create GitLab issues to notify users about expiring access via email
* use gitlab_usermgmt in GitLab CI to automate it completely

Usage
-----

Checkout the full `usage documentation`_ for detailed information and required config files.

.. _usage documentation: https://ayeks.gitlab.io/gitlab_usermgmt

Install gitlab_usermgmt.::

  pip install gitlab-usermgmt

Execute gitlab_usermgmt in dry run first. Assuming you have your GitLab Token in the env var ``GITLAB_TOKEN``::

  gitlab_usermgmt --config config.json --dry_run

You can increase the output level with ``--verbose``. Review the output and if you are agree with the changes apply them::

  gitlab_usermgmt --config config.json

Credits
-------

This package was created with Cookiecutter_ and the `wboxx1/cookiecutter-pypackage`_ project template.
`Adrien Coquet`_ created the `logo`_.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`wboxx1/cookiecutter-pypackage`: https://github.com/wboxx1/cookiecutter-pypackage-poetry
.. _logo: https://thenounproject.com/search/?q=automation&i=2689746
.. _Adrien Coquet: https://www.behance.net/coquet_adrien