v5.3.0

v5.3.0 (2024-12-28)

Chores

• deps: Update gitlab/gitlab-ee docker tag to v17.7.0-ee.0 (#3070, 62b7eb7)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

• renovate: Update httpx and respx again (aa07449)

Features

• api: Support the new registry protection rule endpoint (40af1c8)

---

Detailed Changes: v5.2.0...v5.3.0

v5.2.0

v5.2.0 (2024-12-17)

Chores

• deps: Update all non-major dependencies (1e02f23)

• deps: Update all non-major dependencies (6532e8c)

• deps: Update all non-major dependencies (8046387)

• deps: Update codecov/codecov-action action to v5 (735efff)

• deps: Update dependency commitizen to v4 (9306362)

• deps: Update gitlab/gitlab-ee docker tag to v17.6.1-ee.0 (#3053, f2992ae)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

• deps: Update gitlab/gitlab-ee docker tag to v17.6.2-ee.0 (#3065, db0db26)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

• deps: Update pre-commit hook commitizen-tools/commitizen to v4 (a8518f1)

• docs: Fix CHANGELOG tracebacks codeblocks (9fe372a)

With v5.1.0 CHANGELOG.md was updated that mangled v1.10.0 triple backtick codeblock Traceback output that made sphinx fail [1] with a non-zero return code.

The resulting docs appears to be processes as text after the failing line [2]. While reviewing other backtick codeblocks fix v1.8.0 [3] to the original traceback.

[1] https://github.com/python-gitlab/python-gitlab/actions/runs/12060608158/job/33631303063#step:5:204 [2] https://python-gitlab.readthedocs.io/en/v5.1.0/changelog.html#v1-10-0-2019-07-22 [3] https://python-gitlab.readthedocs.io/en/v5.0.0/changelog.html#id258

• renovate: Pin httpx until respx is fixed (b70830d)

Documentation

• api-usage: Fix link to Gitlab REST API Authentication Docs (#3059, f460d95)

Features

• api: Add project templates (#3057, 0d41da3)

• feat(api): Added project template classes to templates.py
• feat(api): Added project template managers to Project in project.py
• docs(merge_requests): Add example of creating mr with description template
• test(templates): Added unit tests for templates
• docs(templates): added section for project templates

• graphql: Add async client (288f39c)

---

Detailed Changes: v5.1.0...v5.2.0

v5.1.0

v5.1.0 (2024-11-28)

Chores

• deps: Update all non-major dependencies (9061647)

• deps: Update gitlab/gitlab-ee docker tag to v17.6.0-ee.0 (#3044, 79113d9)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

• deps: Update all non-major dependencies (62da12a)

• deps: Update gitlab/gitlab-ee docker tag to v17.5.2-ee.0 (#3041, d39129b)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

• deps: Update pre-commit hook maxbrunet/pre-commit-renovate to v39 (11458e0)

• deps: Update all non-major dependencies (7e62136)

• deps: Update dependency pytest-cov to v6 (ffa88b3)

• deps: Update all non-major dependencies (d4b52e7)

• deps: Update all non-major dependencies (541a7e3)

• deps: Update gitlab/gitlab-ee docker tag to v17.5.1-ee.0 (8111f49)

Features

• api: Get single project approval rule (029695d)

• cli: Enable token rotation via CLI (0cb8171)

• const: Add new Planner role to access levels (bdc8852)

• api: Support list and delete for group service accounts (#2963, 499243b)

• files: Add support for more optional flags (f51cd52)

GitLab's Repository Files API supports additional flags that weren't implemented before. Notably, the "start_branch" flag is particularly useful, as previously one had to use the "project-branch" command alongside "project-file" to add a file on a separate branch.

[1] https://docs.gitlab.com/ee/api/repository_files.html

v5.0.0

v5.0.0 (2024-10-28)

Breaking

• feat: remove support for Python 3.8, require 3.9 or higher (#3005)

Python 3.8 is End-of-Life (EOL) as of 2024-10 as stated in
https://devguide.python.org/versions/ and
https://peps.python.org/pep-0569/#lifespan

By dropping support for Python 3.8 and requiring Python 3.9 or higher
it allows python-gitlab to take advantage of new features in Python
3.9, which are documented at:
https://docs.python.org/3/whatsnew/3.9.html

Closes: #2968

BREAKING CHANGE: As of python-gitlab 5.0.0, Python 3.8 is no longer
supported. Python 3.9 or higher is required. (9734ad4)

Bug Fixes

• fix(api): set _repr_attr for project approval rules to name attr (#3011)

Co-authored-by: Patrick Evans [email protected] (1a68f1c)

Chores

• chore: add testing of Python 3.14

Also fix annotations not working in Python 3.14 by using the
annotation on the 'class' instead of on the 'instance'

Closes: #3013 (14d2a82)

• chore(deps): update dependency ubuntu to v24 (6fda15d)

• chore(deps): update all non-major dependencies (1e4326b)

• chore(deps): update gitlab/gitlab-ee docker tag to v17.5.0-ee.0 (c02a392)

• chore: add Python 3.13 as supported (#3012)

Mark that Python 3.13 is supported.

Use Python 3.13 for the Mac and Windows tests.

Also remove the 'py38' tox environment. We no longer support Python 3.8. (b565e78)

• chore: remove "v3" question from issue template (#3017)

python-gitlab hasn't supported the GitLab v3 API since 2018. The last
version of python-gitlab to support it was v1.4

Support was removed in:

commit fe89b94
Author: Gauvain Pocentek [email protected]
Date: Sat May 19 17:10:08 2018 +0200

Drop API v3 support

Drop the code, the tests, and update the documentation. ([`482f2fe`](https://github.com/python-gitlab/python-gitlab/commit/482f2fe6ccae9239b3a010a70969d8d887cdb6b6))

• chore(deps): update all non-major dependencies (b3834dc)

• chore(deps): update gitlab/gitlab-ee docker tag to v17.4.2-ee.0 (1cdfe40)

Documentation

• docs(users): update Gitlab docs links (#3022) (3739b5d)

Testing

• test: add test for to_json() method

This should get us to 100% test coverage on gitlab/base.py (f4bfe19)

v4.13.0

v4.13.0 (2024-10-08)

Chore

• chore(deps): update dependency pre-commit to v4 (#3008)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com> (5c27546)

• chore(deps): update all non-major dependencies (c3efb37)

Feature

• feat(api): add support for project Pages API (0ee0e02)

v4.12.2

v4.12.2 (2024-10-01)

Fix

• fix: raise GitlabHeadError in project.files.head() method (#3006)

When an error occurs, raise GitlabHeadError in
project.files.head() method.

Closes: #3004 (9bf26df)

v4.12.1

v4.12.1 (2024-09-30)

Chore

• chore(deps): update all non-major dependencies (#3000)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com> (d3da326)

• chore(deps): update gitlab/gitlab-ee docker tag to v17.4.1-ee.0 (64eed5d)

Fix

• fix(ci): do not rely on GitLab.com runner arch variables (#3003) (c848d12)

• fix(files): correctly raise GitlabGetError in get method (190ec89)

v4.12.0

v4.12.0 (2024-09-28)

Chore

• chore(deps): update all non-major dependencies (ae132e7)

• chore: update pylint to 3.3.1 and resolve issues (#2997)

pylint 3.3.1 appears to have added "too-many-positional-arguments"
check with a value of 5.

I don't disagree with this, but we have many functions which exceed
this value. We might think about converting some of positional
arguments over to keyword arguments in the future. But that is for
another time.

For now disable the check across the project. (a0729b8)

• chore(deps): update dependency types-setuptools to v75 (a2ab54c)

• chore(deps): update gitlab/gitlab-ee docker tag to v17.4.0-ee.0 (8601808)

• chore(deps): update all non-major dependencies (10ee58a)

• chore(deps): update gitlab/gitlab-ee docker tag to v17.3.2-ee.0 (5cd1ab2)

Feature

• feat(build): build multi-arch images (#2987) (29f617d)

• feat: introduce related_issues to merge requests (#2996) (174d992)

Fix

• fix(api): head requests for projectfilemanager (#2977)

• fix(api): head requests for projectfilemanager

---

Co-authored-by: Patrick Evans <[email protected]>
Co-authored-by: Nejc Habjan <[email protected]> (96a18b0)

v4.11.1

v4.11.1 (2024-09-13)

Fix

• fix(client): ensure type evaluations are postponed (b41b2de)

v4.11.0

v4.11.0 (2024-09-13)

Chore

• chore(pre-commit): add deps (fe5e608)

• chore(deps): update all non-major dependencies (fac8bf9)

• chore(deps): update dependency types-setuptools to v74 (bdfaddb)

• chore(deps): update all non-major dependencies (88c7529)

Documentation

• docs(objects): fix typo in get latest pipeline (b9f5c12)

Feature

• feat(client): make retries configurable in GraphQL (145870e)

• feat(client): add retry handling to GraphQL client (8898c38)

• feat(api): add exclusive GET attrs for /projects/:id/members (e637808)

• feat: add a minimal GraphQL client (d6b1b0a)

• feat(api): add exclusive GET attrs for /groups/:id/members (d44ddd2)

Refactor

• refactor(client): move retry logic into utility (3235c48)