GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Blog
  • Docs
  • Log in
  • Register
  • Getting help
  • Installing packages
  • Uploading packages
  • Packaging user guide
  • Infrastructure dashboard
  • Statistics
  • Logos & trademarks
  • Our sponsors
  • Bugs and feedback
  • Contribute on GitHub

This view

  • Original page
  • New address

GeezerVison is showing pypi.org — python-gitlab

python-gitlab 8.6.0

The python wrapper for the GitLab REST and GraphQL APIs.

pip install python-gitlab

python-gitlab

https://github.com/python-gitlab/python-gitlab/workflows/Test/badge.svg https://badge.fury.io/py/python-gitlab.svg https://readthedocs.org/projects/python-gitlab/badge/?version=latest https://codecov.io/github/python-gitlab/python-gitlab/coverage.svg?branch=main https://img.shields.io/pypi/pyversions/python-gitlab.svg https://img.shields.io/gitter/room/python-gitlab/Lobby.svg https://img.shields.io/badge/code%20style-black-000000.svg https://img.shields.io/github/license/python-gitlab/python-gitlab

python-gitlab is a Python package providing access to the GitLab APIs.

It includes a client for GitLab’s v4 REST API, synchronous and asynchronous GraphQL API clients, as well as a CLI tool (gitlab) wrapping REST API endpoints.

Features

python-gitlab enables you to:

  • write Pythonic code to manage your GitLab resources.

  • pass arbitrary parameters to the GitLab API. Simply follow GitLab’s docs on what parameters are available.

  • use a synchronous or asynchronous client when using the GraphQL API.

  • access arbitrary endpoints as soon as they are available on GitLab, by using lower-level API methods.

  • use persistent requests sessions for authentication, proxy and certificate handling.

  • handle smart retries on network and server errors, with rate-limit handling.

  • flexible handling of paginated responses, including lazy iterators.

  • automatically URL-encode paths and parameters where needed.

  • automatically convert some complex data structures to API attribute types

  • merge configuration from config files, environment variables and arguments.

Installation

As of 7.0.0, python-gitlab is compatible with Python 3.10+.

Use pip to install the latest stable version of python-gitlab:

$ pip install --upgrade python-gitlab

The 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.git

From GitLab:

$ pip install git+https://gitlab.com/python-gitlab/python-gitlab.git

Using the docker images

python-gitlab provides Docker images in two flavors, based on the Alpine and Debian slim python base images. The default tag is alpine, but you can explicitly use the alias (see below).

The alpine image is smaller, but you may want to use the Debian-based slim tag (currently based on -slim-bullseye) if you are running into issues or need a more complete environment with a bash shell, such as in CI jobs.

The images are published on the GitLab registry, for example:

  • registry.gitlab.com/python-gitlab/python-gitlab:latest (latest, alpine alias)

  • registry.gitlab.com/python-gitlab/python-gitlab:alpine (latest alpine)

  • registry.gitlab.com/python-gitlab/python-gitlab:slim-bullseye (latest slim-bullseye)

  • registry.gitlab.com/python-gitlab/python-gitlab:v3.2.0 (alpine alias)

  • registry.gitlab.com/python-gitlab/python-gitlab:v3.2.0-alpine

  • registry.gitlab.com/python-gitlab/python-gitlab:v3.2.0-slim-bullseye

You 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/gitlab

You 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> ...

Usage inside GitLab CI

If you want to use the Docker image directly inside your GitLab CI as an image, you will need to override the entrypoint, as noted in the official GitLab documentation:

Job Name:
   image:
      name: registry.gitlab.com/python-gitlab/python-gitlab:latest
      entrypoint: [""]
   before_script:
      gitlab --version
   script:
      gitlab <command>

Building the image

To build your own image from this repository, run:

$ docker build -t python-gitlab:latest .

Run your own image:

$ docker run -it --rm python-gitlab:latest <command> ...

Build a Debian slim-based image:

$ docker build -t python-gitlab:latest --build-arg PYTHON_FLAVOR=slim-bullseye .

Bug reports

Please report bugs and feature requests at https://github.com/python-gitlab/python-gitlab/issues.

Gitter Community Chat

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!

Documentation

The full documentation for CLI and API is available on readthedocs.

Build the docs

We use tox to manage our environment and build the documentation:

pip install tox
tox -e docs

Contributing

For guidelines for contributing to python-gitlab, refer to CONTRIBUTING.rst.

Project links

Data verified by PyPI on Sep 28, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.
  • Changelog
  • Homepage
  • Source
  • Documentation

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released: Sep 28, 2026
Latest release

3 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for bufferoverflow from gravatar.com bufferoverflow Avatar for max-wittig from gravatar.com max-wittig Avatar for nejch from gravatar.com nejch

Credits

Author: Gauvain Pocentek

Maintainer: John Villalovos

GitHub Statistics

Data verified by PyPI on Sep 28, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.
  • Repository
  • Stars:
  • Forks:
  • Open issues:
  • Open PRs:

Provenance

Data verified by PyPI on Sep 28, 2026
Data provided by the project maintainers and verified by PyPI at the time of upload.

Full provenance

Both files in this release have provenance metadata.

View provenance details

License

GNU Lesser General Public License v3 (LGPLv3) (LGPL-3.0-or-later)

Requires

Python >=3.10.0

Provides Extra

autocompletion yaml graphql

Tags

api client gitlab python python-gitlab wrapper

Classifiers

  • Development Status
    • 5 - Production/Stable
  • Environment
    • Console
  • Intended Audience
    • System Administrators
  • License
    • OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
  • Natural Language
    • English
  • Operating System
    • Microsoft :: Windows
    • POSIX
  • Programming Language
    • Python
    • Python :: 3
    • Python :: 3.10
    • Python :: 3.11
    • Python :: 3.12
    • Python :: 3.13
    • Python :: 3.14

Metadata

Project links

Data verified by PyPI on Sep 28, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.
  • Changelog
  • Homepage
  • Source
  • Documentation

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released: Sep 28, 2026
Latest release

3 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for bufferoverflow from gravatar.com bufferoverflow Avatar for max-wittig from gravatar.com max-wittig Avatar for nejch from gravatar.com nejch

Credits

Author: Gauvain Pocentek

Maintainer: John Villalovos

GitHub Statistics

Data verified by PyPI on Sep 28, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.
  • Repository
  • Stars:
  • Forks:
  • Open issues:
  • Open PRs:

Provenance

Data verified by PyPI on Sep 28, 2026
Data provided by the project maintainers and verified by PyPI at the time of upload.

Full provenance

Both files in this release have provenance metadata.

View provenance details

License

GNU Lesser General Public License v3 (LGPLv3) (LGPL-3.0-or-later)

Requires

Python >=3.10.0

Provides Extra

autocompletion yaml graphql

Tags

api client gitlab python python-gitlab wrapper

Classifiers

  • Development Status
    • 5 - Production/Stable
  • Environment
    • Console
  • Intended Audience
    • System Administrators
  • License
    • OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
  • Natural Language
    • English
  • Operating System
    • Microsoft :: Windows
    • POSIX
  • Programming Language
    • Python
    • Python :: 3
    • Python :: 3.10
    • Python :: 3.11
    • Python :: 3.12
    • Python :: 3.13
    • Python :: 3.14

Release files for python-gitlab 8.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-gitlab 8.6.0
File Size Uploaded Provenance Actions
python_gitlab-8.6.0.tar.gz 423.3 kB Sep 28, 2026 With provenance Details for python_gitlab-8.6.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for python-gitlab 8.6.0
File Interpreter ABI Platform Actions Reset
python_gitlab-8.6.0-py3-none-any.whl 159.7 kB Sep 28, 2026 With provenance Python 3 none any Details for python_gitlab-8.6.0-py3-none-any.whl

Total release size: 583.0 kB

Release files / python_gitlab-8.6.0.tar.gz

Download URL python_gitlab-8.6.0.tar.gz
Size 423.3 kB
Tags Source
SHA-256 checksum
How to use checksums
d1602164fb58ab280ceef460faf015cec6e7d83bb2d9cbae44ba448adb5568ef
BLAKE2b-256 checksum
How to use checksums
5cdc292d32245ca35447b265c47a0ed9f35de1ab280a05da1da306b61a035833
Upload date Sep 28, 2026
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.

Transparency log
Identity
Publishing platform
GitHub Actions
Publishing repository
github.com/python-gitlab/python-gitlab
Publishing commit
github.com/python-gitlab/python-gitlab/tree/ce92c8fd96b4babb830853d04e5c86a6edf98202
Workflow
Publishing configuration
github.com/python-gitlab/python-gitlab/blob/ce92c8fd96b4babb830853d04e5c86a6edf98202/.github/workflows/release.yml
Publishing logs
github.com/python-gitlab/python-gitlab/actions/runs/36372775007/attempts/1
Artifact
Subject
python_gitlab-8.6.0.tar.gz
SHA-256 checksum
d1602164fb58ab280ceef460faf015cec6e7d83bb2d9cbae44ba448adb5568ef Verifying attestations

Release files / python_gitlab-8.6.0-py3-none-any.whl

Download URL python_gitlab-8.6.0-py3-none-any.whl
Size 159.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
34fee7e5576cf01982c4bfa98f94d50e24733edb66beba3cb8ef286287723019
BLAKE2b-256 checksum
How to use checksums
55aa9c96a88d79453eaea91f301c318dc3c5e95b195087759fd94fedf1104386
Upload date Sep 28, 2026
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.

Transparency log
Identity
Publishing platform
GitHub Actions
Publishing repository
github.com/python-gitlab/python-gitlab
Publishing commit
github.com/python-gitlab/python-gitlab/tree/ce92c8fd96b4babb830853d04e5c86a6edf98202
Workflow
Publishing configuration
github.com/python-gitlab/python-gitlab/blob/ce92c8fd96b4babb830853d04e5c86a6edf98202/.github/workflows/release.yml
Publishing logs
github.com/python-gitlab/python-gitlab/actions/runs/36372775007/attempts/1
Artifact
Subject
python_gitlab-8.6.0-py3-none-any.whl
SHA-256 checksum
34fee7e5576cf01982c4bfa98f94d50e24733edb66beba3cb8ef286287723019 Verifying attestations

Security for python-gitlab 8.6.0

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files
No files match the current filters. Reset filters

Attestation for python_gitlab-8.6.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.

Transparency log
Identity
Publishing platform
GitHub Actions
Publishing repository
github.com/python-gitlab/python-gitlab
Publishing commit
github.com/python-gitlab/python-gitlab/tree/ce92c8fd96b4babb830853d04e5c86a6edf98202
Workflow
Publishing configuration
github.com/python-gitlab/python-gitlab/blob/ce92c8fd96b4babb830853d04e5c86a6edf98202/.github/workflows/release.yml
Publishing logs
github.com/python-gitlab/python-gitlab/actions/runs/36372775007/attempts/1
Artifact
Subject
python_gitlab-8.6.0.tar.gz
SHA-256 checksum
d1602164fb58ab280ceef460faf015cec6e7d83bb2d9cbae44ba448adb5568ef Verifying attestations

Attestation for python_gitlab-8.6.0-py3-none-any.whl

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.

Transparency log
Identity
Publishing platform
GitHub Actions
Publishing repository
github.com/python-gitlab/python-gitlab
Publishing commit
github.com/python-gitlab/python-gitlab/tree/ce92c8fd96b4babb830853d04e5c86a6edf98202
Workflow
Publishing configuration
github.com/python-gitlab/python-gitlab/blob/ce92c8fd96b4babb830853d04e5c86a6edf98202/.github/workflows/release.yml
Publishing logs
github.com/python-gitlab/python-gitlab/actions/runs/36372775007/attempts/1
Artifact
Subject
python_gitlab-8.6.0-py3-none-any.whl
SHA-256 checksum
34fee7e5576cf01982c4bfa98f94d50e24733edb66beba3cb8ef286287723019 Verifying attestations

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

8.6.0 This release

Sep 28, 2026 2 release files Full provenance

8.5.0

Jul 28, 2026 2 release files Full provenance

8.4.0

May 28, 2026 2 release files Full provenance

8.3.0

Apr 28, 2026 2 release files Full provenance

8.2.0

Mar 28, 2026 2 release files Full provenance

8.1.0

Feb 28, 2026 2 release files Full provenance

8.0.0

Jan 28, 2026 2 release files Full provenance

7.1.0

Dec 28, 2025 2 release files Full provenance

7.0.0

Oct 29, 2025 2 release files Full provenance

6.5.0

Oct 17, 2025 2 release files Full provenance

6.4.0

Sep 28, 2025 2 release files Full provenance

6.3.0

Aug 28, 2025 2 release files Full provenance

6.2.0

Jul 28, 2025 2 release files Full provenance

6.1.0

Jun 28, 2025 2 release files Full provenance

6.0.0

Jun 4, 2025 2 release files Full provenance

5.6.0

Jan 28, 2025 2 release files Full provenance

5.5.0

Jan 28, 2025 2 release files Full provenance

5.4.0

Jan 28, 2025 2 release files Full provenance

5.3.1

Jan 7, 2025 2 release files Full provenance

5.3.0

Dec 28, 2024 2 release files Full provenance

5.2.0

Dec 17, 2024 2 release files Full provenance

5.1.0

Nov 28, 2024 2 release files Full provenance

5.0.0

Oct 28, 2024 2 release files No provenance

4.13.0

Oct 8, 2024 2 release files No provenance

4.12.2

Oct 1, 2024 2 release files No provenance

4.12.1

Sep 30, 2024 2 release files No provenance

4.12.0

Sep 28, 2024 2 release files No provenance

4.11.1

Sep 13, 2024 2 release files No provenance

Yanked

4.11.0

Sep 13, 2024 2 release files No provenance

Yanked reason: Annotation evaluation was not postponed for optional dependencies, causing failures if httpx was not installed. Please use 4.11.1 or later.

4.10.0

Aug 28, 2024 2 release files No provenance

4.9.0

Aug 6, 2024 2 release files No provenance

4.8.0

Jul 16, 2024 2 release files No provenance

4.7.0

Jun 28, 2024 2 release files No provenance

4.6.0

May 28, 2024 2 release files No provenance

4.5.0

May 13, 2024 2 release files No provenance

4.4.0

Jan 15, 2024 2 release files No provenance

4.3.0

Dec 28, 2023 2 release files No provenance

4.2.0

Nov 28, 2023 2 release files No provenance

4.1.1

Nov 3, 2023 2 release files No provenance

4.1.0

Nov 3, 2023 2 release files No provenance

4.0.0

Nov 3, 2023 2 release files No provenance

3.15.0

Jun 9, 2023 2 release files No provenance

3.14.0

Apr 11, 2023 2 release files No provenance

3.13.0

Jan 30, 2023 2 release files No provenance

3.12.0

Nov 28, 2022 2 release files No provenance

3.11.0

Oct 28, 2022 2 release files No provenance

3.10.0

Sep 28, 2022 2 release files No provenance

3.9.0

Aug 28, 2022 2 release files No provenance

3.8.1

Aug 10, 2022 2 release files No provenance

3.8.0

Aug 4, 2022 2 release files No provenance

3.7.0

Jul 28, 2022 2 release files No provenance

3.6.0

Jun 28, 2022 2 release files No provenance

3.5.0

May 28, 2022 2 release files No provenance

3.4.0

Apr 28, 2022 2 release files No provenance

3.3.0

Mar 28, 2022 2 release files No provenance

3.2.0

Feb 28, 2022 2 release files No provenance

3.1.1

Jan 28, 2022 2 release files No provenance

3.1.0

Jan 14, 2022 2 release files No provenance

3.0.0

Jan 5, 2022 2 release files No provenance

2.10.1

Aug 28, 2021 2 release files No provenance

2.10.0

Jul 28, 2021 2 release files No provenance

2.9.0

Jun 28, 2021 2 release files No provenance

2.8.0

Jun 10, 2021 2 release files No provenance

2.7.1

Apr 26, 2021 2 release files No provenance

2.7.0

Apr 26, 2021 2 release files No provenance

2.6.0

Jan 29, 2021 2 release files No provenance

2.5.0

Sep 1, 2020 2 release files No provenance

2.4.0

Jul 9, 2020 2 release files No provenance

2.3.1

Jun 9, 2020 2 release files No provenance

2.3.0

Jun 8, 2020 2 release files No provenance

2.2.0

Apr 7, 2020 2 release files No provenance

2.1.2

Mar 9, 2020 2 release files No provenance

2.1.1

Mar 9, 2020 2 release files No provenance

2.1.0

Mar 8, 2020 2 release files No provenance

2.0.1

Feb 5, 2020 2 release files No provenance

2.0.0

Jan 26, 2020 2 release files No provenance

1.15.0

Dec 16, 2019 2 release files No provenance

1.14.0

Dec 7, 2019 2 release files No provenance

1.13.0

Nov 2, 2019 2 release files No provenance

1.12.1

Oct 7, 2019 2 release files No provenance

1.12.0

Oct 6, 2019 2 release files No provenance

1.11.0

Aug 31, 2019 2 release files No provenance

1.10.0

Jul 22, 2019 2 release files No provenance

1.9.0

Jun 19, 2019 2 release files No provenance

1.8.0

Feb 22, 2019 2 release files No provenance

1.7.0

Dec 9, 2018 1 release file No provenance

1.6.0

Aug 25, 2018 1 release file No provenance

1.5.1

Jun 23, 2018 1 release file No provenance

1.5.0

Jun 22, 2018 1 release file No provenance

1.4.0

May 19, 2018 1 release file No provenance

1.3.0

Feb 18, 2018 1 release file No provenance

1.2.0

Jan 1, 2018 1 release file No provenance

1.1.0

Nov 3, 2017 1 release file No provenance

1.0.2

Sep 29, 2017 1 release file No provenance

1.0.1

Sep 21, 2017 1 release file No provenance

1.0.0

Sep 8, 2017 1 release file No provenance

0.21.2

Jun 11, 2017 1 release file No provenance

0.21.1

May 25, 2017 1 release file No provenance

0.21

May 24, 2017 1 release file No provenance

0.20

Mar 25, 2017 1 release file No provenance

0.19

Feb 21, 2017 1 release file No provenance

0.18

Dec 27, 2016 1 release file No provenance

0.17

Dec 2, 2016 1 release file No provenance

0.16

Oct 16, 2016 1 release file No provenance

0.15.1

Sep 3, 2016 1 release file No provenance

0.15

Aug 28, 2016 1 release file No provenance

0.14

Aug 7, 2016 1 release file No provenance

0.13

May 16, 2016 1 release file No provenance

0.12.2

Mar 19, 2016 1 release file No provenance

0.12.1

Feb 3, 2016 1 release file No provenance

0.12

Feb 3, 2016

0.11.1

Jan 17, 2016 1 release file No provenance

0.11

Jan 9, 2016 1 release file No provenance

0.10

Dec 29, 2015 1 release file No provenance

0.9.2

Jul 11, 2015 1 release file No provenance

0.9.1

May 15, 2015 1 release file No provenance

0.9

May 15, 2015 1 release file No provenance

0.8

Oct 26, 2014 1 release file No provenance

0.7

Aug 21, 2014 1 release file No provenance

0.6

Jan 17, 2014 1 release file No provenance

0.5

Dec 26, 2013 1 release file No provenance

0.4

Sep 26, 2013 1 release file No provenance

0.3

Aug 27, 2013 1 release file No provenance

0.2

Aug 8, 2013 1 release file No provenance

0.1

Jul 8, 2013 1 release file No provenance

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.