.. image:: https://github.com/python-gitlab/python-gitlab/workflows/Test/badge.svg
:target: https://github.com/python-gitlab/python-gitlab/actions
.. image:: https://badge.fury.io/py/python-gitlab.svg
:target: https://badge.fury.io/py/python-gitlab
.. image:: https://readthedocs.org/projects/python-gitlab/badge/?version=latest
:target: https://python-gitlab.readthedocs.org/en/latest/?badge=latest
.. image:: https://codecov.io/github/python-gitlab/python-gitlab/coverage.svg?branch=main
:target: https://codecov.io/github/python-gitlab/python-gitlab?branch=main
.. image:: https://img.shields.io/pypi/pyversions/python-gitlab.svg
:target: https://pypi.python.org/pypi/python-gitlab
.. image:: https://img.shields.io/gitter/room/python-gitlab/Lobby.svg
:target: https://gitter.im/python-gitlab/Lobby
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
:target: https://github.com/python/black
Python GitLab
=============
``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``).
Installation
============
Requirements
------------
python-gitlab depends on:
* `python-requests `_
Install with pip
----------------
.. code-block:: console
pip install python-gitlab
Using the python-gitlab docker image
====================================
How to build
------------
``docker build -t python-gitlab:TAG .``
How to use
----------
``docker run -it --rm -e GITLAB_PRIVATE_TOKEN= -v /path/to/python-gitlab.cfg:/python-gitlab.cfg python-gitlab ...``
or run it directly from the upstream image:
``docker run -it --rm -e GITLAB_PRIVATE_TOKEN= -v /path/to/python-gitlab.cfg:/python-gitlab.cfg registry.gitlab.com/python-gitlab/python-gitlab:latest ...``
To change the GitLab URL, use `-e GITLAB_URL=`
Bring your own config file:
``docker run -it --rm -v /path/to/python-gitlab.cfg:/python-gitlab.cfg -e GITLAB_CFG=/python-gitlab.cfg python-gitlab ...``
Bug reports
===========
Please report bugs and feature requests at
https://github.com/python-gitlab/python-gitlab/issues.
Gitter Community Chat
=====================
There is a `gitter `_ community chat
available at https://gitter.im/python-gitlab/Lobby
Documentation
=============
The full documentation for CLI and API is available on `readthedocs
`_.
Build the docs
--------------
You can build the documentation using ``sphinx``::
pip install sphinx
python setup.py build_sphinx
Contributing
============
For guidelines for contributing to ``python-gitlab``, refer to `CONTRIBUTING.rst `_.