Python-gitlab

Bug Fixes

- Have `participants()` method use `http_list()`
([`d065275`](https://github.com/python-gitlab/python-gitlab/commit/d065275f2fe296dd00e9bbd0f676d1596f261a85))

Previously it was using `http_get()` but the `participants` API returns a list of participants. Also
by using this then we will warn if only a subset of the participants are returned.

Closes: 2913

- Issues `closed_by()/related_merge_requests()` use `http_list`
([`de2e4dd`](https://github.com/python-gitlab/python-gitlab/commit/de2e4dd7e80c7b84fd41458117a85558fcbac32d))

The `closed_by()` and `related_merge_requests()` API calls return lists. So use the `http_list()`
method.

This will also warn the user if only a subset of the data is returned.

- **cli**: Generate UserWarning if `list` does not return all entries
([`e5a4379`](https://github.com/python-gitlab/python-gitlab/commit/e5a43799b5039261d7034af909011444718a5814))

Previously in the CLI, calls to `list()` would have `get_all=False` by default. Therefore hiding the
fact that not all items are being returned if there were more than 20 items.

Added `--no-get-all` option to `list` actions. Along with the already existing `--get-all`.

Closes: 2900

- **files**: Cr: add explicit comparison to `None`
([`51d8f88`](https://github.com/python-gitlab/python-gitlab/commit/51d8f888aca469cff1c5ee5e158fb259d2862017))

Co-authored-by: Nejc Habjan <hab.nejcgmail.com>

- **files**: Make `ref` parameter optional in get raw file api
([`00640ac`](https://github.com/python-gitlab/python-gitlab/commit/00640ac11f77e338919d7e9a1457d111c82af371))

The `ref` parameter was made optional in gitlab v13.11.0.

Chores

- Add `show_caller` argument to `utils.warn()`
([`7d04315`](https://github.com/python-gitlab/python-gitlab/commit/7d04315d7d9641d88b0649e42bf24dd160629af5))

This allows us to not add the caller's location to the UserWarning message.

- Use correct type-hint for `die()`
([`9358640`](https://github.com/python-gitlab/python-gitlab/commit/93586405fbfa61317dc75e186799549573bc0bbb))

- **ci**: Specify name of "stale" label
([`44f62c4`](https://github.com/python-gitlab/python-gitlab/commit/44f62c49106abce2099d5bb1f3f97b64971da406))

Saw the following error in the log: [2618] Removing the label "Stale" from this issue...
[error][2618] Error when removing the label: "Label does not exist"

My theory is that the case doesn't match ("Stale" != "stale") and that is why it failed. Our label
is "stale" so update this to match. Thought of changing the label name on GitHub but then would
also require a change here to the "any-of-labels". So it seemed simpler to just change it here.

It is confusing though that it detected the label "stale", but then couldn't delete it.

- **ci**: Stale: allow issues/PRs that have stale label to be closed
([`2ab88b2`](https://github.com/python-gitlab/python-gitlab/commit/2ab88b25a64bd8e028cee2deeb842476de54b109))

If a `stale` label is manually applied, allow the issue or PR to be closed by the stale job.

Previously it would require the `stale` label and to also have one of 'need info' or 'Waiting for
response' labels added.

- **ci**: Use codecov token when available
([`b74a6fb`](https://github.com/python-gitlab/python-gitlab/commit/b74a6fb5157e55d3e4471a0c5c8378fed8075edc))

- **deps**: Update all non-major dependencies
([`4a2b213`](https://github.com/python-gitlab/python-gitlab/commit/4a2b2133b52dac102d6f623bf028bdef6dd5a92f))

- **deps**: Update all non-major dependencies
([`0f59069`](https://github.com/python-gitlab/python-gitlab/commit/0f59069420f403a17f67a5c36c81485c9016b59b))

- **deps**: Update all non-major dependencies
([`cf87226`](https://github.com/python-gitlab/python-gitlab/commit/cf87226a81108fbed4f58751f1c03234cc57bcf1))

- **deps**: Update gitlab/gitlab-ee docker tag to v17.1.1-ee.0
([`5e98510`](https://github.com/python-gitlab/python-gitlab/commit/5e98510a6c918b33c0db0a7756e8a43a8bdd868a))

- **deps**: Update gitlab/gitlab-ee docker tag to v17.1.2-ee.0
([`6fedfa5`](https://github.com/python-gitlab/python-gitlab/commit/6fedfa546120942757ea48337ce7446914eb3813))

- **deps**: Update python-semantic-release/upload-to-gh-release digest to c7c3b69
([`23393fa`](https://github.com/python-gitlab/python-gitlab/commit/23393faa0642c66a991fd88f1d2d68aed1d2f172))

- **deps**: Update python-semantic-release/upload-to-gh-release digest to fe6cc89
([`3f3ad80`](https://github.com/python-gitlab/python-gitlab/commit/3f3ad80ef5bb2ed837adceae061291b2b5545ed3))

Documentation

- Document how to use `sudo` if modifying an object
([`d509da6`](https://github.com/python-gitlab/python-gitlab/commit/d509da60155e9470dee197d91926850ea9548de9))

Add a warning about using `sudo` when saving.

Give an example of how to `get` an object, modify it, and then `save` it using `sudo`

Closes: 532

- Variables: add note about `filter` for updating
([`c378817`](https://github.com/python-gitlab/python-gitlab/commit/c378817389a9510ef508b5a3c90282e5fb60049f))

Add a note about using `filter` when updating a variable.

Closes: 2835

Closes: 1387

Closes: 1125

Features

- **api**: Add support for commit sequence
([`1f97be2`](https://github.com/python-gitlab/python-gitlab/commit/1f97be2a540122cb872ff59500d85a35031cab5f))

- **api**: Add support for container registry protection rules
([`6d31649`](https://github.com/python-gitlab/python-gitlab/commit/6d31649190279a844bfa591a953b0556cd6fc492))

- **api**: Add support for package protection rules
([`6b37811`](https://github.com/python-gitlab/python-gitlab/commit/6b37811c3060620afd8b81e54a99d96e4e094ce9))

- **api**: Add support for project cluster agents
([`32dbc6f`](https://github.com/python-gitlab/python-gitlab/commit/32dbc6f2bee5b22d18c4793f135223d9b9824d15))

Refactoring

- **package_protection_rules**: Add missing attributes
([`c307dd2`](https://github.com/python-gitlab/python-gitlab/commit/c307dd20e3df61b118b3b1a8191c0f1880bc9ed6))

Testing

- **files**: Omit optional `ref` parameter in test case
([`9cb3396`](https://github.com/python-gitlab/python-gitlab/commit/9cb3396d3bd83e82535a2a173b6e52b4f8c020f4))

- **files**: Test with and without `ref` parameter in test case
([`f316b46`](https://github.com/python-gitlab/python-gitlab/commit/f316b466c04f8ff3c0cca06d0e18ddf2d62d033c))

- **fixtures**: Remove deprecated config option
([`2156949`](https://github.com/python-gitlab/python-gitlab/commit/2156949866ce95af542c127ba4b069e83fcc8104))

- **registry**: Disable functional tests for unavailable endpoints
([`ee393a1`](https://github.com/python-gitlab/python-gitlab/commit/ee393a16e1aa6dbf2f9785eb3ef486f7d5b9276f))

Bug Fixes

- Add ability to add help to custom_actions
([`9acd2d2`](https://github.com/python-gitlab/python-gitlab/commit/9acd2d23dd8c87586aa99c70b4b47fa47528472b))

Now when registering a custom_action can add help text if desired.

Also delete the VerticalHelpFormatter as no longer needed. When the help value is set to `None` or
some other value, the actions will get printed vertically. Before when the help value was not set
the actions would all get put onto one line.

Chores

- Add a help message for `gitlab project-key enable`
([`1291dbb`](https://github.com/python-gitlab/python-gitlab/commit/1291dbb588d3a5a54ee54d9bb93c444ce23efa8c))

Add some help text for `gitlab project-key enable`. This both adds help text and shows how to use
the new `help` feature.

Example:

$ gitlab project-key --help usage: gitlab project-key [-h] {list,get,create,update,delete,enable}
...

options: -h, --help show this help message and exit

action: {list,get,create,update,delete,enable} Action to execute on the GitLab resource. list List
the GitLab resources get Get a GitLab resource create Create a GitLab resource update Update a
GitLab resource delete Delete a GitLab resource enable Enable a deploy key for the project

- Sort CLI behavior-related args to remove
([`9b4b0ef`](https://github.com/python-gitlab/python-gitlab/commit/9b4b0efa1ccfb155aee8384de9e00f922b989850))

Sort the list of CLI behavior-related args that are to be removed.

- **deps**: Update all non-major dependencies
([`88de2f0`](https://github.com/python-gitlab/python-gitlab/commit/88de2f0fc52f4f02e1d44139f4404acf172624d7))

- **deps**: Update all non-major dependencies
([`a510f43`](https://github.com/python-gitlab/python-gitlab/commit/a510f43d990c3a3fd169854218b64d4eb9491628))

- **deps**: Update all non-major dependencies
([`d4fdf90`](https://github.com/python-gitlab/python-gitlab/commit/d4fdf90655c2cb5124dc2ecd8b449e1e16d0add5))

- **deps**: Update all non-major dependencies
([`d5de288`](https://github.com/python-gitlab/python-gitlab/commit/d5de28884f695a79e49605a698c4f17b868ddeb8))

- **deps**: Update dependency types-setuptools to v70
([`7767514`](https://github.com/python-gitlab/python-gitlab/commit/7767514a1ad4269a92a6610aa71aa8c595565a7d))

- **deps**: Update gitlab/gitlab-ee docker tag to v17.0.1-ee.0
([`df0ff4c`](https://github.com/python-gitlab/python-gitlab/commit/df0ff4c4c1497d6449488b8577ad7188b55c41a9))

- **deps**: Update gitlab/gitlab-ee docker tag to v17.0.2-ee.0
([`51779c6`](https://github.com/python-gitlab/python-gitlab/commit/51779c63e6a58e1ae68e9b1c3ffff998211d4e66))

- **deps**: Update python-semantic-release/upload-to-gh-release digest to 477a404
([`02a551d`](https://github.com/python-gitlab/python-gitlab/commit/02a551d82327b879b7a903b56b7962da552d1089))

- **deps**: Update python-semantic-release/upload-to-gh-release digest to 6b7558f
([`fd0f0b0`](https://github.com/python-gitlab/python-gitlab/commit/fd0f0b0338623a98e9368c30b600d603b966f8b7))

Features

- Add `--no-mask-credentials` CLI argument
([`18aa1fc`](https://github.com/python-gitlab/python-gitlab/commit/18aa1fc074b9f477cf0826933184bd594b63b489))

This gives the ability to not mask credentials when using the `--debug` argument.

- **api**: Add support for latest pipeline
([`635f5a7`](https://github.com/python-gitlab/python-gitlab/commit/635f5a7128c780880824f69a9aba23af148dfeb4))

Bug Fixes

- Don't raise `RedirectError` for redirected `HEAD` requests
([`8fc13b9`](https://github.com/python-gitlab/python-gitlab/commit/8fc13b91d63d57c704d03b98920522a6469c96d7))

- Handle large number of approval rules
([`ef8f0e1`](https://github.com/python-gitlab/python-gitlab/commit/ef8f0e190b1add3bbba9a7b194aba2f3c1a83b2e))

Use `iterator=True` when going through the list of current approval rules. This allows it to handle
more than the default of 20 approval rules.

Closes: 2825

- **cli**: Don't require `--id` when enabling a deploy key
([`98fc578`](https://github.com/python-gitlab/python-gitlab/commit/98fc5789d39b81197351660b7a3f18903c2b91ba))

No longer require `--id` when doing: gitlab project-key enable

Now only the --project-id and --key-id are required.

- **deps**: Update minimum dependency versions in pyproject.toml
([`37b5a70`](https://github.com/python-gitlab/python-gitlab/commit/37b5a704ef6b94774e54110ba3746a950e733986))

Update the minimum versions of the dependencies in the pyproject.toml file.

This is related to PR 2878

- **projects**: Fix 'import_project' file argument type for typings
([`33fbc14`](https://github.com/python-gitlab/python-gitlab/commit/33fbc14ea8432df7e637462379e567f4d0ad6c18))

Signed-off-by: Adrian DC <radian.dcgmail.com>

Chores

- Add an initial .git-blame-ignore-revs
([`74db84c`](https://github.com/python-gitlab/python-gitlab/commit/74db84ca878ec7029643ff7b00db55f9ea085e9b))

This adds the `.git-blame-ignore-revs` file which allows ignoring certain commits when doing a `git
blame --ignore-revs`

Ignore the commit that requires keyword arguments for `register_custom_action()`

https://docs.github.com/en/repositories/working-with-files/using-files/viewing-a-file#ignore-commits-in-the-blame-view

- Add type info for ProjectFile.content
([`62fa271`](https://github.com/python-gitlab/python-gitlab/commit/62fa2719ea129b3428e5e67d3d3a493f9aead863))

Closes: 2821

- Correct type-hint for `job.trace()`
([`840572e`](https://github.com/python-gitlab/python-gitlab/commit/840572e4fa36581405b604a985d0e130fe43f4ce))

Closes: 2808

- Create a CustomAction dataclass
([`61d8679`](https://github.com/python-gitlab/python-gitlab/commit/61d867925772cf38f20360c9b40140ac3203efb9))

- Remove typing-extensions from requirements.txt
([`d569128`](https://github.com/python-gitlab/python-gitlab/commit/d56912835360a1b5a03a20390fb45cb5e8b49ce4))

We no longer support Python versions before 3.8. So it isn't needed anymore.

- Require keyword arguments for register_custom_action
([`7270523`](https://github.com/python-gitlab/python-gitlab/commit/7270523ad89a463c3542e072df73ba2255a49406))

This makes it more obvious when reading the code what each argument is for.

- Update commit reference in git-blame-ignore-revs
([`d0fd5ad`](https://github.com/python-gitlab/python-gitlab/commit/d0fd5ad5a70e7eb70aedba5a0d3082418c5ffa34))

- **cli**: Add ability to not add `_id_attr` as an argument
([`2037352`](https://github.com/python-gitlab/python-gitlab/commit/20373525c1a1f98c18b953dbef896b2570d3d191))

In some cases we don't want to have `_id_attr` as an argument.

Add ability to have it not be added as an argument.

- **cli**: Add some simple help for the standard operations
([`5a4a940`](https://github.com/python-gitlab/python-gitlab/commit/5a4a940f42e43ed066838503638fe612813e504f))

Add help for the following standard operations: * list: List the GitLab resources * get: Get a
GitLab resource * create: Create a GitLab resource * update: Update a GitLab resource * delete:
Delete a GitLab resource

For example: $ gitlab project-key --help usage: gitlab project-key [-h]
{list,get,create,update,delete,enable} ...

options: -h, --help show this help message and exit

action: list get create update delete enable Action to execute on the GitLab resource. list List the
GitLab resources get Get a GitLab resource create Create a GitLab resource update Update a GitLab
resource delete Delete a GitLab resource

- **cli**: On the CLI help show the API endpoint of resources
([`f1ef565`](https://github.com/python-gitlab/python-gitlab/commit/f1ef5650c3201f3883eb04ad90a874e8adcbcde2))

This makes it easier for people to map CLI command names to the API.

Looks like this: $ gitlab --help <snip> The GitLab resource to manipulate. application API endpoint:
/applications application-appearance API endpoint: /application/appearance application-settings
API endpoint: /application/settings application-statistics API endpoint: /application/statistics
<snip>

- **deps**: Update all non-major dependencies
([`4c7014c`](https://github.com/python-gitlab/python-gitlab/commit/4c7014c13ed63f994e05b498d63b93dc8ab90c2e))

- **deps**: Update all non-major dependencies
([`ba1eec4`](https://github.com/python-gitlab/python-gitlab/commit/ba1eec49556ee022de471aae8d15060189f816e3))

- **deps**: Update dependency requests to v2.32.0 [security]
([`1bc788c`](https://github.com/python-gitlab/python-gitlab/commit/1bc788ca979a36eeff2e35241bdefc764cf335ce))

- **deps**: Update gitlab/gitlab-ee docker tag to v17
([`5070d07`](https://github.com/python-gitlab/python-gitlab/commit/5070d07d13b9c87588dbfde3750340e322118779))

- **deps**: Update python-semantic-release/upload-to-gh-release digest to 673709c
([`1b550ac`](https://github.com/python-gitlab/python-gitlab/commit/1b550ac706c8c31331a7a9dac607aed49f5e1fcf))

Features

- More usernames support for MR approvals
([`12d195a`](https://github.com/python-gitlab/python-gitlab/commit/12d195a35a1bd14947fbd6688a8ad1bd3fc21617))

I don't think commit a2b8c8ccfb5d went far enough to enable usernames support. We create and edit a
lot of approval rules based on an external service (similar to CODE_OWNERS), but only have the
usernames available, and currently, have to look up each user to get their user ID to populate
user_ids for .set_approvers() calls. Would very much like to skip the lookup and just send the
usernames, which this change should allow.

See: https://docs.gitlab.com/ee/api/merge_request_approvals.html#create-project-level-rule

Signed-off-by: Jarod Wilson <jarodredhat.com>

- **api**: Add additional parameter to project/group iteration search
([2796](https://github.com/python-gitlab/python-gitlab/pull/2796),
[`623dac9`](https://github.com/python-gitlab/python-gitlab/commit/623dac9c8363c61dbf53f72af58835743e96656b))

Co-authored-by: Cristiano Casella <cristiano.casellaseacom.it>

Co-authored-by: Nejc Habjan <hab.nejcgmail.com>

- **api**: Add support for gitlab service account
([2851](https://github.com/python-gitlab/python-gitlab/pull/2851),
[`b187dea`](https://github.com/python-gitlab/python-gitlab/commit/b187deadabbfdf0326ecd79a3ee64c9de10c53e0))

Co-authored-by: Nejc Habjan <hab.nejcsiemens.com>

Bug Fixes

- Consider `scope` an ArrayAttribute in PipelineJobManager
([`c5d0404`](https://github.com/python-gitlab/python-gitlab/commit/c5d0404ac9edfbfd328e7b4f07f554366377df3f))

List query params like 'scope' were not being handled correctly for pipeline/jobs endpoint. This
change ensures multiple values are appended with '[]', resulting in the correct URL structure.

Signed-off-by: Guilherme Gallo <guilherme.gallocollabora.com>

---

Background: If one queries for pipeline jobs with `scope=["failed", "success"]`

One gets: GET /api/v4/projects/176/pipelines/1113028/jobs?scope=success&scope=failed

But it is supposed to get: GET
/api/v4/projects/176/pipelines/1113028/jobs?scope[]=success&scope[]=failed

The current version only considers the last element of the list argument.

- User.warn() to show correct filename of issue
([`529f1fa`](https://github.com/python-gitlab/python-gitlab/commit/529f1faacee46a88cb0a542306309eb835516796))

Previously would only go to the 2nd level of the stack for determining the offending filename and
line number. When it should be showing the first filename outside of the python-gitlab source
code. As we want it to show the warning for the user of the libraries code.

Update test to show it works as expected.

- **api**: Fix saving merge request approval rules
([`b8b3849`](https://github.com/python-gitlab/python-gitlab/commit/b8b3849b2d4d3f2d9e81e5cf4f6b53368f7f0127))

Closes 2548

- **api**: Update manual job status when playing it
([`9440a32`](https://github.com/python-gitlab/python-gitlab/commit/9440a3255018d6a6e49269caf4c878d80db508a8))

- **cli**: Allow exclusive arguments as optional
([2770](https://github.com/python-gitlab/python-gitlab/pull/2770),
[`7ec3189`](https://github.com/python-gitlab/python-gitlab/commit/7ec3189d6eacdb55925e8be886a44d7ee09eb9ca))

* fix(cli): allow exclusive arguments as optional

The CLI takes its arguments from the RequiredOptional, which has three fields: required, optional,
and exclusive. In practice, the exclusive options are not defined as either required or optional,
and would not be allowed in the CLI. This changes that, so that exclusive options are also added
to the argument parser.

* fix(cli): inform argument parser that options are mutually exclusive

* fix(cli): use correct exclusive options, add unit test

Closes 2769

- **test**: Use different ids for merge request, approval rule, project
([`c23e6bd`](https://github.com/python-gitlab/python-gitlab/commit/c23e6bd5785205f0f4b4c80321153658fc23fb98))

The original bug was that the merge request identifier was used instead of the approval rule
identifier. The test didn't notice that because it used `1` for all identifiers. Make these
identifiers different so that a mixup will become apparent.

Build System

- Add "--no-cache-dir" to pip commands in Dockerfile
([`4ef94c8`](https://github.com/python-gitlab/python-gitlab/commit/4ef94c8260e958873bb626e86d3241daa22f7ce6))

This would not leave cache files in the built docker image.

Additionally, also only build the wheel in the build phase.

On my machine, before this PR, size is 74845395; after this PR, size is 72617713.

Chores

- Adapt style for black v24
([`4e68d32`](https://github.com/python-gitlab/python-gitlab/commit/4e68d32c77ed587ab42d229d9f44c3bc40d1d0e5))

- Add py312 & py313 to tox environment list
([`679ddc7`](https://github.com/python-gitlab/python-gitlab/commit/679ddc7587d2add676fd2398cb9673bd1ca272e3))

Even though there isn't a Python 3.13 at this time, this is done for the future. tox is already
configured to just warn about missing Python versions, but not fail if they don't exist.

- Add tox `labels` to enable running groups of environments
([`d7235c7`](https://github.com/python-gitlab/python-gitlab/commit/d7235c74f8605f4abfb11eb257246864c7dcf709))

tox now has a feature of `labels` which allows running groups of environments using the command `tox
-m LABEL_NAME`. For example `tox -m lint` which has been setup to run the linters.

Bumped the minimum required version of tox to be 4.0, which was released over a year ago.

- Update `mypy` to 1.9.0 and resolve one issue
([`dd00bfc`](https://github.com/python-gitlab/python-gitlab/commit/dd00bfc9c832aba0ed377573fe2e9120b296548d))

mypy 1.9.0 flagged one issue in the code. Resolve the issue. Current unit tests already check that a
`None` value returns `text/plain`. So function is still working as expected.

- Update version of `black` for `pre-commit`
([`3501716`](https://github.com/python-gitlab/python-gitlab/commit/35017167a80809a49351f9e95916fafe61c7bfd5))

The version of `black` needs to be updated to be in sync with what is in `requirements-lint.txt`

- **deps**: Update all non-major dependencies
([`4f338ae`](https://github.com/python-gitlab/python-gitlab/commit/4f338aed9c583a20ff5944e6ccbba5737c18b0f4))

- **deps**: Update all non-major dependencies
([`65d0e65`](https://github.com/python-gitlab/python-gitlab/commit/65d0e6520dcbcf5a708a87960c65fdcaf7e44bf3))

- **deps**: Update all non-major dependencies
([`1f0343c`](https://github.com/python-gitlab/python-gitlab/commit/1f0343c1154ca8ae5b1f61de1db2343a2ad652ec))

- **deps**: Update all non-major dependencies
([`0e9f4da`](https://github.com/python-gitlab/python-gitlab/commit/0e9f4da30cea507fcf83746008d9de2ee5a3bb9d))

- **deps**: Update all non-major dependencies
([`d5b5fb0`](https://github.com/python-gitlab/python-gitlab/commit/d5b5fb00d8947ed9733cbb5a273e2866aecf33bf))

- **deps**: Update all non-major dependencies
([`14a3ffe`](https://github.com/python-gitlab/python-gitlab/commit/14a3ffe4cc161be51a39c204350b5cd45c602335))

- **deps**: Update all non-major dependencies
([`3c4dcca`](https://github.com/python-gitlab/python-gitlab/commit/3c4dccaf51695334a5057b85d5ff4045739d1ad1))

- **deps**: Update all non-major dependencies
([`04c569a`](https://github.com/python-gitlab/python-gitlab/commit/04c569a2130d053e35c1f2520ef8bab09f2f9651))

- **deps**: Update all non-major dependencies
([`3c4b27e`](https://github.com/python-gitlab/python-gitlab/commit/3c4b27e64f4b51746b866f240a1291c2637355cc))

- **deps**: Update all non-major dependencies
([`7dc2fa6`](https://github.com/python-gitlab/python-gitlab/commit/7dc2fa6e632ed2c9adeb6ed32c4899ec155f6622))

- **deps**: Update all non-major dependencies
([`48726fd`](https://github.com/python-gitlab/python-gitlab/commit/48726fde9b3c2424310ff590b366b9fdefa4a146))

- **deps**: Update codecov/codecov-action action to v4
([`d2be1f7`](https://github.com/python-gitlab/python-gitlab/commit/d2be1f7608acadcc2682afd82d16d3706b7f7461))

- **deps**: Update dependency black to v24
([`f59aee3`](https://github.com/python-gitlab/python-gitlab/commit/f59aee3ddcfaeeb29fcfab4cc6768dff6b5558cb))

- **deps**: Update dependency black to v24.3.0 [security]
([`f6e8692`](https://github.com/python-gitlab/python-gitlab/commit/f6e8692cfc84b5af2eb6deec4ae1c4935b42e91c))

- **deps**: Update dependency furo to v2024
([`f6fd02d`](https://github.com/python-gitlab/python-gitlab/commit/f6fd02d956529e2c4bce261fe7b3da1442aaea12))

- **deps**: Update dependency jinja2 to v3.1.4 [security]
([`8ea10c3`](https://github.com/python-gitlab/python-gitlab/commit/8ea10c360175453c721ad8e27386e642c2b68d88))

- **deps**: Update dependency myst-parser to v3
([`9289189`](https://github.com/python-gitlab/python-gitlab/commit/92891890eb4730bc240213a212d392bcb869b800))

- **deps**: Update dependency pytest to v8
([`253babb`](https://github.com/python-gitlab/python-gitlab/commit/253babb9a7f8a7d469440fcfe1b2741ddcd8475e))

- **deps**: Update dependency pytest-cov to v5
([`db32000`](https://github.com/python-gitlab/python-gitlab/commit/db3200089ea83588ea7ad8bd5a7175d81f580630))

- **deps**: Update dependency pytest-docker to v3
([`35d2aec`](https://github.com/python-gitlab/python-gitlab/commit/35d2aec04532919d6dd7b7090bc4d5209eddd10d))

- **deps**: Update gitlab/gitlab-ee docker tag to v16
([`ea8c4c2`](https://github.com/python-gitlab/python-gitlab/commit/ea8c4c2bc9f17f510415a697e0fb19cabff4135e))

- **deps**: Update gitlab/gitlab-ee docker tag to v16.11.1-ee.0
([`1ed8d6c`](https://github.com/python-gitlab/python-gitlab/commit/1ed8d6c21d3463b2ad09eb553871042e98090ffd))

- **deps**: Update gitlab/gitlab-ee docker tag to v16.11.2-ee.0
([`9be48f0`](https://github.com/python-gitlab/python-gitlab/commit/9be48f0bcc2d32b5e8489f62f963389d5d54b2f2))

- **deps**: Update python-semantic-release/python-semantic-release action to v9
([`e11d889`](https://github.com/python-gitlab/python-gitlab/commit/e11d889cd19ec1555b2bbee15355a8cdfad61d5f))

Documentation

- Add FAQ about conflicting parameters
([`683ce72`](https://github.com/python-gitlab/python-gitlab/commit/683ce723352cc09e1a4b65db28be981ae6bb9f71))

We have received multiple issues lately about this. Add it to the FAQ.

- Correct rotate token example
([`c53e695`](https://github.com/python-gitlab/python-gitlab/commit/c53e6954f097ed10d52b40660d2fba73c2e0e300))

Rotate token returns a dict. Change example to print the entire dict.

Closes: 2836

- How to run smoke tests
([`2d1f487`](https://github.com/python-gitlab/python-gitlab/commit/2d1f4872390df10174f865f7a935bc73f7865fec))

Signed-off-by: Tim Knight <tim.knight1engineering.digital.dwp.gov.uk>

- Note how to use the Docker image from within GitLab CI
([`6d4bffb`](https://github.com/python-gitlab/python-gitlab/commit/6d4bffb5aaa676d32fc892ef1ac002973bc040cb))

Ref: 2823

- **artifacts**: Fix argument indentation
([`c631eeb`](https://github.com/python-gitlab/python-gitlab/commit/c631eeb55556920f5975b1fa2b1a0354478ce3c0))

- **objects**: Minor rst formatting typo
([`57dfd17`](https://github.com/python-gitlab/python-gitlab/commit/57dfd1769b4e22b43dc0936aa3600cd7e78ba289))

To correctly format a code block have to use `::`

- **README**: Tweak GitLab CI usage docs
([`d9aaa99`](https://github.com/python-gitlab/python-gitlab/commit/d9aaa994568ad4896a1e8a0533ef0d1d2ba06bfa))

Features

- **api**: Allow updating protected branches
([2771](https://github.com/python-gitlab/python-gitlab/pull/2771),
[`a867c48`](https://github.com/python-gitlab/python-gitlab/commit/a867c48baa6f10ffbfb785e624a6e3888a859571))

* feat(api): allow updating protected branches

Closes 2390

- **cli**: Allow skipping initial auth calls
([`001e596`](https://github.com/python-gitlab/python-gitlab/commit/001e59675f4a417a869f813d79c298a14268b87d))

- **job_token_scope**: Support Groups in job token allowlist API
([2816](https://github.com/python-gitlab/python-gitlab/pull/2816),
[`2d1b749`](https://github.com/python-gitlab/python-gitlab/commit/2d1b7499a93db2c9600b383e166f7463a5f22085))

* feat(job_token_scope): support job token access allowlist API

Signed-off-by: Tim Knight <tim.knight1engineering.digital.dwp.gov.uk>

l.dwp.gov.uk> Co-authored-by: Nejc Habjan <nejc.habjansiemens.com>

Testing

- Don't use weak passwords
([`c64d126`](https://github.com/python-gitlab/python-gitlab/commit/c64d126142cc77eae4297b8deec27bb1d68b7a13))

Newer versions of GitLab will refuse to create a user with a weak password. In order for us to move
to a newer GitLab version in testing use a stronger password for the tests that create a user.

- Remove approve step
([`48a6705`](https://github.com/python-gitlab/python-gitlab/commit/48a6705558c5ab6fb08c62a18de350a5985099f8))

Signed-off-by: Tim Knight <tim.knight1engineering.digital.dwp.gov.uk>

- Tidy up functional tests
([`06266ea`](https://github.com/python-gitlab/python-gitlab/commit/06266ea5966c601c035ad8ce5840729e5f9baa57))

Signed-off-by: Tim Knight <tim.knight1engineering.digital.dwp.gov.uk>

- Update api tests for GL 16.10
([`4bef473`](https://github.com/python-gitlab/python-gitlab/commit/4bef47301342703f87c1ce1d2920d54f9927a66a))

- Make sure we're testing python-gitlab functionality, make sure we're not awaiting on Gitlab Async
functions - Decouple and improve test stability

Signed-off-by: Tim Knight <tim.knight1engineering.digital.dwp.gov.uk>

- Update tests for gitlab 16.8 functionality
([`f8283ae`](https://github.com/python-gitlab/python-gitlab/commit/f8283ae69efd86448ae60d79dd8321af3f19ba1b))

- use programmatic dates for expires_at in tokens tests - set PAT for 16.8 into tests

Signed-off-by: Tim Knight <tim.knight1engineering.digital.dwp.gov.uk>

- **functional**: Enable bulk import feature flag before test
([`b81da2e`](https://github.com/python-gitlab/python-gitlab/commit/b81da2e66ce385525730c089dbc2a5a85ba23287))

- **smoke**: Normalize all dist titles for smoke tests
([`ee013fe`](https://github.com/python-gitlab/python-gitlab/commit/ee013fe1579b001b4b30bae33404e827c7bdf8c1))

Bug Fixes

- **cli**: Support binary files with `` notation
([`57749d4`](https://github.com/python-gitlab/python-gitlab/commit/57749d46de1d975aacb82758c268fc26e5e6ed8b))

Support binary files being used in the CLI with arguments using the `` notation. For example
`--avatar /path/to/avatar.png`

Also explicitly catch the common OSError exception, which is the parent exception for things like:
FileNotFoundError, PermissionError and more exceptions.

Remove the bare exception handling. We would rather have the full traceback of any exceptions that
we don't know about and add them later if needed.

Closes: 2752

Chores

- **ci**: Add Python 3.13 development CI job
([`ff0c11b`](https://github.com/python-gitlab/python-gitlab/commit/ff0c11b7b75677edd85f846a4dbdab08491a6bd7))

Add a job to test the development versions of Python 3.13.

- **ci**: Align upload and download action versions
([`dcca59d`](https://github.com/python-gitlab/python-gitlab/commit/dcca59d1a5966283c1120cfb639c01a76214d2b2))

- **deps**: Update actions/upload-artifact action to v4
([`7114af3`](https://github.com/python-gitlab/python-gitlab/commit/7114af341dd12b7fb63ffc08650c455ead18ab70))

- **deps**: Update all non-major dependencies
([`550f935`](https://github.com/python-gitlab/python-gitlab/commit/550f9355d29a502bb022f68dab6c902bf6913552))

- **deps**: Update all non-major dependencies
([`cbc13a6`](https://github.com/python-gitlab/python-gitlab/commit/cbc13a61e0f15880b49a3d0208cc603d7d0b57e3))

- **deps**: Update all non-major dependencies
([`369a595`](https://github.com/python-gitlab/python-gitlab/commit/369a595a8763109a2af8a95a8e2423ebb30b9320))

- **deps**: Update dependency flake8 to v7
([`20243c5`](https://github.com/python-gitlab/python-gitlab/commit/20243c532a8a6d28eee0caff5b9c30cc7376a162))

- **deps**: Update dependency jinja2 to v3.1.3 [security]
([`880913b`](https://github.com/python-gitlab/python-gitlab/commit/880913b67cce711d96e89ce6813e305e4ba10908))

- **deps**: Update pre-commit hook pycqa/flake8 to v7
([`9a199b6`](https://github.com/python-gitlab/python-gitlab/commit/9a199b6089152e181e71a393925e0ec581bc55ca))

Features

- **api**: Add reviewer_details manager for mergrequest to get reviewers of merge request
([`adbd90c`](https://github.com/python-gitlab/python-gitlab/commit/adbd90cadffe1d9e9716a6e3826f30664866ad3f))

Those changes implements 'GET /projects/:id/merge_requests/:merge_request_iid/reviewers' gitlab API
call. Naming for call is not reviewers because reviewers atribute already presen in merge request
response

- **api**: Support access token rotate API
([`b13971d`](https://github.com/python-gitlab/python-gitlab/commit/b13971d5472cb228f9e6a8f2fa05a7cc94d03ebe))

- **api**: Support single resource access token get API
([`dae9e52`](https://github.com/python-gitlab/python-gitlab/commit/dae9e522a26041f5b3c6461cc8a5e284f3376a79))

Bug Fixes

- **cli**: Add ability to disable SSL verification
([`3fe9fa6`](https://github.com/python-gitlab/python-gitlab/commit/3fe9fa64d9a38bc77950046f2950660d8d7e27a6))

Add a `--no-ssl-verify` option to disable SSL verification

Closes: 2714

Chores

- **deps**: Update actions/setup-python action to v5
([`fad1441`](https://github.com/python-gitlab/python-gitlab/commit/fad14413f4f27f1b6f902703b5075528aac52451))

- **deps**: Update actions/stale action to v9
([`c01988b`](https://github.com/python-gitlab/python-gitlab/commit/c01988b12c7745929d0c591f2fa265df2929a859))

- **deps**: Update all non-major dependencies
([`d7bdb02`](https://github.com/python-gitlab/python-gitlab/commit/d7bdb0257a5587455c3722f65c4a632f24d395be))

- **deps**: Update all non-major dependencies
([`9e067e5`](https://github.com/python-gitlab/python-gitlab/commit/9e067e5c67dcf9f5e6c3408b30d9e2525c768e0a))

- **deps**: Update all non-major dependencies
([`bb2af7b`](https://github.com/python-gitlab/python-gitlab/commit/bb2af7bfe8aa59ea8b9ad7ca2d6e56f4897b704a))

- **deps**: Update all non-major dependencies
([`5ef1b4a`](https://github.com/python-gitlab/python-gitlab/commit/5ef1b4a6c8edd34c381c6e08cd3893ef6c0685fd))

- **deps**: Update dependency types-setuptools to v69
([`de11192`](https://github.com/python-gitlab/python-gitlab/commit/de11192455f1c801269ecb3bdcbc7c5b769ff354))

Documentation

- Fix rst link typo in CONTRIBUTING.rst
([`2b6da6e`](https://github.com/python-gitlab/python-gitlab/commit/2b6da6e63c82a61b8e21d193cfd46baa3fcf8937))

Features

- **api**: Add support for the Draft notes API
([2728](https://github.com/python-gitlab/python-gitlab/pull/2728),
[`ebf9d82`](https://github.com/python-gitlab/python-gitlab/commit/ebf9d821cfc36071fca05d38b82c641ae30c974c))

* feat(api): add support for the Draft notes API

* fix(client): handle empty 204 reponses in PUT requests