python-gitlab is a Python package providing access to the GitLab server API.
It supports the v4 API of GitLab, and provides a CLI tool (gitlab).
As of 3.0.0, python-gitlab is compatible with Python 3.7+.
Use pip to install the latest stable version of python-gitlab:
$ pip install --upgrade python-gitlabThe current development version is available on both GitHub.com and GitLab.com, and can be installed directly from the git repository:
$ pip install git+https://github.com/python-gitlab/python-gitlab.gitFrom GitLab:
$ pip install git+https://gitlab.com/python-gitlab/python-gitlab.gitYou can run the Docker image directly from the GitLab registry:
$ docker run -it --rm registry.gitlab.com/python-gitlab/python-gitlab:latest <command> ...For example, to get a project on GitLab.com (without authentication):
$ docker run -it --rm registry.gitlab.com/python-gitlab/python-gitlab:latest project get --id gitlab-org/gitlabYou can also mount your own config file:
$ docker run -it --rm -v /path/to/python-gitlab.cfg:/etc/python-gitlab.cfg registry.gitlab.com/python-gitlab/python-gitlab:latest <command> ...To build your own image from this repository, run:
$ docker build -t python-gitlab:latest .Run your own image:
$ docker run -it --rm -v python-gitlab:latest <command> ...Please report bugs and feature requests at https://github.com/python-gitlab/python-gitlab/issues.
We have a gitter community chat available at https://gitter.im/python-gitlab/Lobby, which you can also directly access via the Open Chat button below.
If you have a simple question, the community might be able to help already, without you opening an issue. If you regularly use python-gitlab, we also encourage you to join and participate. You might discover new ideas and use cases yourself!
The full documentation for CLI and API is available on readthedocs.
We use tox to manage our environment and build the documentation:
pip install tox tox -e docs
For guidelines for contributing to python-gitlab, refer to CONTRIBUTING.rst.