chore(release): track tags for renovate (d600444)
chore(deps): update python-semantic-release/upload-to-gh-release digest to 17c75b7 (12caaa4)
chore(deps): update dependency types-setuptools to v73 (d55c045)
chore(deps): update all non-major dependencies (2ade0d9)
chore(deps): update gitlab/gitlab-ee docker tag to v17.3.1-ee.0 (3fdd130)
chore(deps): update all non-major dependencies (0578bf0)
chore(deps): update gitlab/gitlab-ee docker tag to v17.3.0-ee.0 (e5a46f5)
chore(deps): update dependency myst-parser to v4 (930d4a2)
chore(deps): update dependency sphinx to v8 (cb65ffb)
chore(deps): update gitlab/gitlab-ee docker tag to v17.2.2-ee.0 (b2275f7)
chore(deps): update all non-major dependencies (31786a6)

Documentation

docs(faq): correct the attribute fetching example

There is an example about object attributes in the FAQ. It shows how to
properly fetch all attributes of all projects, by using list() followed
by a get(id) call.

Unfortunately this example used a wrong variable name, which caused it
not to work and which could have made it slightly confusing to readers.
This commit fixes that, by changing the variable name.

Now the example uses one variable for two Python objects. As they
correspond to the same GitLab object and the intended behavior is to
obtain that very object, just with all attributes, this is fine and is
probably what readers will find most useful in this context. (43a16ac)

Feature

feat(api): project/group hook test triggering

Add the ability to trigger tests of project and group hooks.

Fixes #2924 (9353f54)

Test

test(cli): allow up to 30 seconds for a project export

Before we allowed a maximum of around 15 seconds for the
project-export. Often times the CI was failing with this value.

Change it to a maximum of around 30 seconds. (bdc155b)

Assets 2

06 Aug 12:12

nejch

v4.9.0

8d74b88

v4.9.0

v4.9.0 (2024-08-06)

Chore

chore(deps): update pre-commit hook maxbrunet/pre-commit-renovate to v38 (f13968b)
chore(deps): update all non-major dependencies (f95ca26)
chore(deps): update dependency types-setuptools to v71 (d6a7dba)
chore(deps): update python-semantic-release/upload-to-gh-release digest to 0dcddac (eb5c6f7)
chore(deps): update gitlab/gitlab-ee docker tag to v17.2.1-ee.0 (d13a656)
chore(deps): update all non-major dependencies (7adc86b)
chore(deps): update python-semantic-release/upload-to-gh-release digest to e2355e1 (eb18552)
chore(deps): update all non-major dependencies (e820db0)
chore(ci): make pre-commit check happy

pre-commit incorrectly wants double back-quotes inside the code
section. Rather than fight it, just use single quotes. (67370d8)

Feature

feat(snippets): add support for listing all instance snippets (64ae61e)

Assets 2

16 Jul 14:14

nejch

v4.8.0

18f6be5

v4.8.0

v4.8.0 (2024-07-16)

Chore

chore(deps): update gitlab/gitlab-ee docker tag to v17.1.2-ee.0 (6fedfa5)
chore(deps): update all non-major dependencies (4a2b213)
chore(ci): specify name of "stale" label

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. (44f62c4)

chore(ci): stale: allow issues/PRs that have stale label to be closed

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. (2ab88b2)

chore(ci): use codecov token when available (b74a6fb)
chore(deps): update python-semantic-release/upload-to-gh-release digest to fe6cc89 (3f3ad80)
chore(deps): update all non-major dependencies (0f59069)
chore: add show_caller argument to utils.warn()

This allows us to not add the caller's location to the UserWarning
message. (7d04315)

chore: use correct type-hint for die() (9358640)
chore(deps): update gitlab/gitlab-ee docker tag to v17.1.1-ee.0 (5e98510)
chore(deps): update python-semantic-release/upload-to-gh-release digest to c7c3b69 (23393fa)
chore(deps): update all non-major dependencies (cf87226)

Documentation

docs: document how to use sudo if modifying an object

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 (d509da6)

docs: variables: add note about filter for updating

Add a note about using filter when updating a variable.

Closes: #2835
Closes: #1387
Closes: #1125 (c378817)

Feature

feat(api): add support for project cluster agents (32dbc6f)
feat(api): add support for container registry protection rules (6d31649)
feat(api): add support for package protection rules (6b37811)
feat(api): add support for commit sequence (1f97be2)

Fix

fix: issues closed_by()/related_merge_requests() use http_list

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. (de2e4dd)

fix: Have participants() method use http_list()

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 (d065275)

fix(files): CR: add explicit comparison to None

Co-authored-by: Nejc Habjan <hab.nejc@gmail.com> (51d8f88)

fix(files): make ref parameter optional in get raw file api

The ref parameter was made optional in gitlab v13.11.0. (00640ac)

fix(cli): generate UserWarning if list does not return all entries

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 (e5a4379)

Refactor

refactor(package_protection_rules): add missing attributes (c307dd2)

Test

test(registry): disable functional tests for unavailable endpoints (ee393a1)
test(files): test with and without ref parameter in test case (f316b46)
test(files): omit optional ref parameter in test case (9cb3396)
test(fixtures): remove deprecated config option (2156949)

Assets 2

28 Jun 00:47

nejch

v4.7.0

509e19c

v4.7.0

v4.7.0 (2024-06-28)

Chore

chore(deps): update all non-major dependencies (88de2f0)
chore(deps): update all non-major dependencies (a510f43)
chore(deps): update gitlab/gitlab-ee docker tag to v17.0.2-ee.0 (51779c6)
chore(deps): update python-semantic-release/upload-to-gh-release digest to 6b7558f (fd0f0b0)
chore(deps): update all non-major dependencies (d4fdf90)
chore(deps): update dependency types-setuptools to v70 (7767514)
chore(deps): update gitlab/gitlab-ee docker tag to v17.0.1-ee.0 (df0ff4c)
chore(deps): update python-semantic-release/upload-to-gh-release digest to 477a404 (02a551d)
chore(deps): update all non-major dependencies (d5de288)
chore: add a help message for gitlab project-key enable

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 (1291dbb)

chore: sort CLI behavior-related args to remove

Sort the list of CLI behavior-related args that are to be removed. (9b4b0ef)

Feature

feat(api): add support for latest pipeline (635f5a7)
feat: add --no-mask-credentials CLI argument

This gives the ability to not mask credentials when using the
--debug argument. (18aa1fc)

Fix

fix: add ability to add help to custom_actions

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. (9acd2d2)

Assets 2

28 May 00:46

nejch

v4.6.0

9c1c210

v4.6.0

v4.6.0 (2024-05-28)

Chore

chore(deps): update python-semantic-release/upload-to-gh-release digest to 673709c (1b550ac)
chore(deps): update all non-major dependencies (4c7014c)
chore: update commit reference in git-blame-ignore-revs (d0fd5ad)
chore(cli): add ability to not add _id_attr as an argument

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. (2037352)

chore: create a CustomAction dataclass (61d8679)
chore: add an initial .git-blame-ignore-revs

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 (74db84c)

chore: require keyword arguments for register_custom_action

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

chore: remove typing-extensions from requirements.txt

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

chore(deps): update dependency requests to v2.32.0 [security] (1bc788c)
chore(deps): update all non-major dependencies (ba1eec4)
chore(deps): update gitlab/gitlab-ee docker tag to v17 (5070d07)
chore(cli): on the CLI help show the API endpoint of resources

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> (f1ef565)

chore(cli): add some simple help for the standard operations

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 (5a4a940)

chore: correct type-hint for job.trace()

Closes: #2808 (840572e)

chore: add type info for ProjectFile.content

Closes: #2821 (62fa271)

Feature

feat(api): add additional parameter to project/group iteration search (#2796)

Co-authored-by: Cristiano Casella <cristiano.casella@seacom.it>
Co-authored-by: Nejc Habjan <hab.nejc@gmail.com> (623dac9)

feat(api): add support for gitlab service account (#2851)

Co-authored-by: Nejc Habjan <hab.nejc@siemens.com> (b187dea)

feat: more usernames support for MR approvals

I don't think commit a2b8c8c 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 <jarod@redhat.com> (12d195a)

Fix

fix(deps): update minimum dependency versions in pyproject.toml

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

This is related to PR #2878 (37b5a70)

fix(cli): don't require --id when enabling a deploy key

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

Now only the --project-id and --key-id are required. (98fc578)

fix: don't raise RedirectError for redirected HEAD requests (8fc13b9)
fix: handle large number of approval rules

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 (ef8f0e1)

fix(projects): fix 'import_project' file argument type for typings

Signed-off-by: Adrian DC <radian.dc@gmail.com> (33fbc14)

Assets 2

13 May 22:19

nejch

v4.5.0

58d50f2

v4.5.0

v4.5.0 (2024-05-13)

Build

build: Add "--no-cache-dir" to pip commands in Dockerfile

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. (4ef94c8)

Chore

chore(deps): update all non-major dependencies (4f338ae)
chore(deps): update gitlab/gitlab-ee docker tag to v16.11.2-ee.0 (9be48f0)
chore(deps): update dependency myst-parser to v3 (9289189)
chore(deps): update all non-major dependencies (65d0e65)
chore(deps): update dependency jinja2 to v3.1.4 [security] (8ea10c3)
chore(deps): update all non-major dependencies (1f0343c)
chore(deps): update gitlab/gitlab-ee docker tag to v16.11.1-ee.0 (1ed8d6c)
chore(deps): update all non-major dependencies (0e9f4da)
chore(deps): update gitlab/gitlab-ee docker tag to v16 (ea8c4c2)
chore(deps): update all non-major dependencies (d5b5fb0)
chore(deps): update dependency pytest-cov to v5 (db32000)
chore: update mypy to 1.9.0 and resolve one issue

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. (dd00bfc)

chore(deps): update dependency black to v24.3.0 [security] (f6e8692)
chore(deps): update all non-major dependencies (14a3ffe)
chore(deps): update all non-major dependencies (3c4dcca)
chore(deps): update all non-major dependencies (04c569a)
chore: add tox labels to enable running groups of environments

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. (d7235c7)

chore: add py312 & py313 to tox environment list

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. (679ddc7)

chore(deps): update python-semantic-release/python-semantic-release action to v9 (e11d889)
chore(deps): update all non-major dependencies (3c4b27e)
chore(deps): update dependency furo to v2024 (f6fd02d)
chore(deps): update dependency pytest to v8 (253babb)
chore(deps): update dependency pytest-docker to v3 (35d2aec)
chore: update version of black for pre-commit

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

chore(deps): update all non-major dependencies (7dc2fa6)
chore(deps): update codecov/codecov-action action to v4 (d2be1f7)
chore: adapt style for black v24 (4e68d32)
chore(deps): update dependency black to v24 (f59aee3)
chore(deps): update all non-major dependencies (48726fd)

Documentation

docs: add FAQ about conflicting parameters

We have received multiple issues lately about this. Add it to the FAQ. (683ce72)

docs(README): tweak GitLab CI usage docs (d9aaa99)
docs: how to run smoke tests

Signed-off-by: Tim Knight <tim.knight1@engineering.digital.dwp.gov.uk> (2d1f487)

docs(objects): minor rst formatting typo

To correctly format a code block have to use :: (57dfd17)

docs: correct rotate token example

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

Closes: #2836 (c53e695)

docs: Note how to use the Docker image from within GitLab CI

Ref: #2823 (6d4bffb)

docs(artifacts): Fix argument indentation (c631eeb)

Feature

feat(job_token_scope): support Groups in job token allowlist API (#2816)
feat(job_token_scope): support job token access allowlist API

Signed-off-by: Tim Knight <tim.knight1@engineering.digital.dwp.gov.uk>
l.dwp.gov.uk>
Co-authored-by: Nejc Habjan <nejc.habjan@siemens.com> (2d1b749)

feat(cli): allow skipping initial auth calls (001e596)
feat(api): allow updating protected branches (#2771)
feat(api): allow updating protected branches

Closes #2390 (a867c48)

Fix

fix: Consider scope an ArrayAttribute in PipelineJobManager

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.gallo@collabora.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.

Signed-off-by: Guilherme Gallo <guilherme.gallo@collabora.com> (c5d0404)

fix(test): use different ids for merge request, approval rule, project

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. (c23e6bd)

fix(api): fix saving merge request approval rules

Closes #2548 (b8b3849)

fix: user.warn() to show correct filename of issue

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

Assets 2

15 Jan 08:15

nejch

v4.4.0

72e1aa7

v4.4.0

v4.4.0 (2024-01-15)

Chore

chore(deps): update all non-major dependencies (550f935)
chore(deps): update pre-commit hook pycqa/flake8 to v7 (9a199b6)
chore(deps): update dependency jinja2 to v3.1.3 [security] (880913b)
chore(deps): update dependency flake8 to v7 (20243c5)
chore(deps): update all non-major dependencies (cbc13a6)
chore(ci): align upload and download action versions (dcca59d)
chore(deps): update actions/upload-artifact action to v4 (7114af3)
chore(ci): add Python 3.13 development CI job

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

chore(deps): update all non-major dependencies (369a595)

Feature

feat(api): add reviewer_details manager for mergrequest to get reviewers of merge request

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 (adbd90c)

feat(api): support access token rotate API (b13971d)
feat(api): support single resource access token get API (dae9e52)

Fix

fix(cli): support binary files with @ notation

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 (57749d4)

Assets 2

28 Dec 00:37

nejch

v4.3.0

b8824a6

v4.3.0

v4.3.0 (2023-12-28)

Chore

chore(deps): update all non-major dependencies (d7bdb02)
chore(deps): update actions/stale action to v9 (c01988b)
chore(deps): update all non-major dependencies (9e067e5)
chore(deps): update actions/setup-python action to v5 (fad1441)
chore(deps): update all non-major dependencies (bb2af7b)
chore(deps): update all non-major dependencies (5ef1b4a)
chore(deps): update dependency types-setuptools to v69 (de11192)

Documentation

docs: fix rst link typo in CONTRIBUTING.rst (2b6da6e)

Feature

feat(api): add support for the Draft notes API (#2728)
feat(api): add support for the Draft notes API
fix(client): handle empty 204 reponses in PUT requests (ebf9d82)

Fix

fix(cli): add ability to disable SSL verification

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

Closes: #2714 (3fe9fa6)

Assets 2

Releases: python-gitlab/python-gitlab

v4.11.1

v4.11.1 (2024-09-13)

Fix

v4.11.0

v4.11.0 (2024-09-13)

Chore

Documentation

Feature

Refactor

v4.10.0

v4.10.0 (2024-08-28)

Chore

Documentation

Feature

Test

v4.9.0

v4.9.0 (2024-08-06)

Chore

Feature

v4.8.0

v4.8.0 (2024-07-16)

Chore

Documentation

Feature

Fix

Refactor

Test

v4.7.0

v4.7.0 (2024-06-28)

Chore

Feature

Fix

v4.6.0

v4.6.0 (2024-05-28)

Chore

Feature

Fix

v4.5.0

v4.5.0 (2024-05-13)

Build

Chore

Documentation

Feature

Fix

v4.4.0

v4.4.0 (2024-01-15)

Chore

Feature

Fix

v4.3.0

v4.3.0 (2023-12-28)

Chore

Documentation

Feature

Fix