(this is a placeholder, it will be replaced with a changelog contents)

5.2.0

Features

• Replace cli_ui with native logging to improve messaging consistency #1218. (TimKnight01))
  • Cli_UI was deprecated in Feb 2026: https://github.com/your-tools/python-cli-ui
  • resolves: #920
  • previous "verbose" logging and cli flag -v is retained, with those logs output at INFO level
  • by default logging level set to WARNING
  • uses Rich's direct console logger to nicely format the processing and version info into CLI

Dependencies

• Update various dependencies to newer version.

Thanks to all the contributors of this release!

Bug Fixes

• KeyError: 'inherit' when using inherit: false in nested config sections with repeated key names #1238. (sentoz)
• Branch protection to support deploy key id #1232. (amimas)

Dependencies

• Update various dependencies to newer version.

Thanks to all the contributors of this release!

Deprecations

• GitLab versions <16 are Deprecated and will be removed in v7 #1215. (timknight01

Bug Fixes

• Reduce excessive Info level logs from Branches Protection #1224. (amimas)
• Hooks processor should error gracefully against Community Edition #1213. (timknight01)

Build

• Ensure standard acceptance tests are run against GitLab Community Edition in addition to Enterprise Edition #1225 (timknight01)

Tests

• Stabilizing Tests to run against Community Edition #1214, #1209, #1208. (amimas)

Dependencies

• Update various dependencies to newer version.

Thanks to all the contributors of this release!

Documentation

• Fix typo in protected_branches documentation, should refer to PATCH api

Tests

• Stabilize job token scope tests #1209. (amimas)

Thanks to all the contributors of this release!

Bug Fixes

• idempotent branch protection updates for redundant user/role rules #1194. (amimas)
• branch protection to be successful in GitLab CE #1195. (timknight01)

Refactoring

• Remove legacy SingleEntityProcessor #1164. (thomascizeron)

Documentation

• document and test syntax for inputs in pipeline schedules #1196. (timknight01)

Dependencies

• Update various dependencies to newer version.

Thanks to all the contributors of this release!

Breaking Changes

• Branch Protection: Dynamic updates to branch protection rules instead of unprotect-and-reprotect proecss. #1070 (TimKnight-DWP & br0ziliy)
• Group SAML Links: The group-level SAML link configuration key saml_group_links has been renamed to group_saml_links for consistency #1175 (amimas)
• Removed Deprecated MR Approval Config: The v3-deprecated syntax for merge request approvals (merge_requests.approvals, merge_requests.approvers, etc.) has been removed. Please use the merge_requests_approvals and merge_requests_approval_rules syntax. #926 (amimas)

See upgrade guide for important upgrade instructions and migration details.

Bug Fixes

• Fixed an issue where branch protection changes would cause unnecessary API errors when the configuration had not changed. #1107 (TimKnight-DWP)
• Fixed a bug that prevented the deletion of CI/CD variables with the same name but different scopes. #962 (amimas)

Build

• Optimized Docker image: Multi-layer builds, reduced size from 88.5MB to 68.5MB. #960 (amimas)
• Add support for Python 3.14 (#1177) (TimKnight01)

Dependencies

• Update various dependencies to newer version.

Thanks to all the contributors of this release!

First release candidate for v5.0.0. All features/fixes are included from the final 5.0.0 release notes above. The v5.0.0 includes a few additional dependency updates that are not included in this.

Chores

• Rebased on v4.8.0 so that latest changes from v4 are availabe in v5 rc.1.

4.8.0

Refactors

• migrate project security settings to python-gitlab #1152. thomascizeron)

Documentation

• add deprecation warning for saml_group_links #1168. (amimas)
• fix broken ordered list formatting #1174. (brlin-tw)

Style

• Apply black v26 formatting #1176. (amimas)

Dependencies

• Update various dependencies to newer version.

Thanks to all the contributors of this release!

Features

• Allow configuring any options supported by python-gitlab API client #1140, #1151. (thomascizeron)
• Allow configuring max_retries, retry_transient_errors and backoff_factor for legacy Gitlab API client #1154. (thomascizeron)
• Add support for configuring push/remote mirrors #1157. (amimas)

Bug Fixes

• Handle 403 Forbidden error when updating files in protected branches #1163. (amimas)
• Handle 403 Forbidden error when editing files in archived projects #1163. (amimas)

Tests

• Fix group push rule test assertion #1142. (amimas)
• Fix tests for GitLab 18.8 instance enforcement on job token scope #1163. (amimas)

Documentation

• Fix broken ordered list formatting in documentation #1134. (brlin-tw)
• Improve documentation for gitlab client configuration #1156. (thomascizeron)
• Add Ströer Online Marketing logo to "Used by" section #1157. (lociii)

Chores

• Suppress false positive bandit warning for private_token #1163. (amimas)

Dependencies

• Update various dependencies to newer version.

Thanks to all the contributors of this release!