python-gitlab 7.0.0__tar.gz → 8.0.0__tar.gz

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/CHANGELOG.md

@@ -2,6 +2,57 @@
 
 All versions below are listed in reverse chronological order.
 
+## v8.0.0 (2026-01-28)
+
+### Bug Fixes
+
+- Actually define project repr_attr
+  ([`4187a69`](https://github.com/python-gitlab/python-gitlab/commit/4187a69420dd7b2e60c2d833ab246aec745d35cb))
+
+- File save start_branch as a body attribute
+  ([`1001d93`](https://github.com/python-gitlab/python-gitlab/commit/1001d934e8c36cc3b14408b46b41030bf705a294))
+
+### Chores
+
+- **black**: Run black v26 on code
+  ([`4a8d82b`](https://github.com/python-gitlab/python-gitlab/commit/4a8d82bec8f09fa142e8134589a0f40ef4f9c3be))
+
+- **precommit**: Update dependency black to v26
+  ([`ad43b76`](https://github.com/python-gitlab/python-gitlab/commit/ad43b763acdcd8d7db832972921fb071ea0a826f))
+
+### Features
+
+- **graphql**: Update to gql 4.0.0
+  ([`6f0da67`](https://github.com/python-gitlab/python-gitlab/commit/6f0da671b4586b23232ae89d57622254fa8a7945))
+
+### Breaking Changes
+
+- **graphql**: GraphQL.execute() no longer accepts graphql.Source
+
+
+## v7.1.0 (2025-12-28)
+
+### Bug Fixes
+
+- **utils**: Prevent negative sleep time in rate limit retry
+  ([`4221195`](https://github.com/python-gitlab/python-gitlab/commit/422119576287de30e1b70411c7ab0bbe39231af7))
+
+### Continuous Integration
+
+- **release**: Use the correct token for publish to GitHub
+  ([`614a74c`](https://github.com/python-gitlab/python-gitlab/commit/614a74c00f027f70b8e48a6b2a2ddcd3f823bffa))
+
+### Features
+
+- **registry-protection**: Add support for registry protection rule deletion
+  ([`9dd62c3`](https://github.com/python-gitlab/python-gitlab/commit/9dd62c3f5bcf3e082c2733bd4edc068f993c22ec))
+
+### Testing
+
+- **functional**: Update to GitLab 18.6 and resolve issues found
+  ([`c7c139b`](https://github.com/python-gitlab/python-gitlab/commit/c7c139b9e7823ec1800a819233aee469355ee8d1))
+
+
 ## v7.0.0 (2025-10-29)
 
 ### Features

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-gitlab
-Version: 7.0.0
+Version: 8.0.0
 Summary: The python wrapper for the GitLab REST and GraphQL APIs.
 Author-email: Gauvain Pocentek <gauvain@pocentek.net>
 Maintainer-email: John Villalovos <john@sodarock.com>, Max Wittig <max.wittig@siemens.com>, Nejc Habjan <nejc.habjan@siemens.com>, Roger Meier <r.meier@siemens.com>
@@ -35,7 +35,7 @@ Requires-Dist: argcomplete<3,>=1.10.0; extra == "autocompletion"
 Provides-Extra: yaml
 Requires-Dist: PyYaml>=6.0.1; extra == "yaml"
 Provides-Extra: graphql
-Requires-Dist: gql[httpx]<4,>=3.5.0; extra == "graphql"
+Requires-Dist: gql[httpx]<5,>=3.5.0; extra == "graphql"
 Dynamic: license-file
 
 python-gitlab

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/gitlab/_version.py

@@ -3,4 +3,4 @@ __copyright__ = "Copyright 2013-2019 Gauvain Pocentek, 2019-2023 python-gitlab t
 __email__ = "gauvainpocentek@gmail.com"
 __license__ = "LGPL3"
 __title__ = "python-gitlab"
-__version__ = "7.0.0"
+__version__ = "8.0.0"

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/gitlab/cli.py

@@ -334,7 +334,7 @@ def main() -> None:
     # This first parsing step is used to find the gitlab config to use, and
     # load the propermodule (v3 or v4) accordingly. At that point we don't have
     # any subparser setup
-    (options, _) = parser.parse_known_args(sys.argv)
+    options, _ = parser.parse_known_args(sys.argv)
     try:
         config = gitlab.config.GitlabConfigParser(options.gitlab, options.config_file)
     except gitlab.config.ConfigError as e:

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/gitlab/client.py

@@ -18,7 +18,6 @@ from gitlab import _backends, utils
 try:
     import gql
     import gql.transport.exceptions
-    import graphql
     import httpx
 
     from ._backends.graphql import GitlabAsyncTransport, GitlabTransport
@@ -1350,7 +1349,7 @@ class GraphQL(_BaseGraphQL):
     def __exit__(self, *args: Any) -> None:
         self._http_client.close()
 
-    def execute(self, request: str | graphql.Source, *args: Any, **kwargs: Any) -> Any:
+    def execute(self, request: str, *args: Any, **kwargs: Any) -> Any:
         parsed_document = self._gql(request)
         retry = utils.Retry(
             max_retries=self._max_retries,
@@ -1420,9 +1419,7 @@ class AsyncGraphQL(_BaseGraphQL):
     async def __aexit__(self, *args: Any) -> None:
         await self._http_client.aclose()
 
-    async def execute(
-        self, request: str | graphql.Source, *args: Any, **kwargs: Any
-    ) -> Any:
+    async def execute(self, request: str, *args: Any, **kwargs: Any) -> Any:
         parsed_document = self._gql(request)
         retry = utils.Retry(
             max_retries=self._max_retries,

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/gitlab/utils.py

@@ -133,7 +133,7 @@ class Retry:
             if "Retry-After" in headers:
                 wait_time = int(headers["Retry-After"])
             elif "RateLimit-Reset" in headers:
-                wait_time = int(headers["RateLimit-Reset"]) - time.time()
+                wait_time = max(0, int(headers["RateLimit-Reset"]) - time.time())
             self.cur_retries += 1
             time.sleep(wait_time)
             return True

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/gitlab/v4/objects/files.py

@@ -29,6 +29,7 @@ class ProjectFile(SaveMixin, ObjectDeleteMixin, RESTObject):
     file_path: str
     manager: ProjectFileManager
     content: str  # since the `decode()` method uses `self.content`
+    start_branch: str | None = None
 
     def decode(self) -> bytes:
         """Returns the decoded content of the file.
@@ -41,7 +42,11 @@ class ProjectFile(SaveMixin, ObjectDeleteMixin, RESTObject):
     # NOTE(jlvillal): Signature doesn't match SaveMixin.save() so ignore
     # type error
     def save(  # type: ignore[override]
-        self, branch: str, commit_message: str, **kwargs: Any
+        self,
+        branch: str,
+        commit_message: str,
+        start_branch: str | None = None,
+        **kwargs: Any,
     ) -> None:
         """Save the changes made to the file to the server.
 
@@ -50,6 +55,7 @@ class ProjectFile(SaveMixin, ObjectDeleteMixin, RESTObject):
         Args:
             branch: Branch in which the file will be updated
             commit_message: Message to send with the commit
+            start_branch: Name of the branch to start the new branch from
             **kwargs: Extra options to send to the server (e.g. sudo)
 
         Raises:
@@ -58,6 +64,7 @@ class ProjectFile(SaveMixin, ObjectDeleteMixin, RESTObject):
         """
         self.branch = branch
         self.commit_message = commit_message
+        self.start_branch = start_branch
         self.file_path = utils.EncodedId(self.file_path)
         super().save(**kwargs)
 

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/gitlab/v4/objects/projects.py

@@ -178,6 +178,8 @@ class Project(
     _repr_attr = "path_with_namespace"
     _upload_path = "/projects/{id}/uploads"
 
+    path_with_namespace: str
+
     access_tokens: ProjectAccessTokenManager
     accessrequests: ProjectAccessRequestManager
     additionalstatistics: ProjectAdditionalStatisticsManager

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/gitlab/v4/objects/registry_protection_repository_rules.py

@@ -1,5 +1,12 @@
 from gitlab.base import RESTObject
-from gitlab.mixins import CreateMixin, ListMixin, SaveMixin, UpdateMethod, UpdateMixin
+from gitlab.mixins import (
+    CreateMixin,
+    DeleteMixin,
+    ListMixin,
+    SaveMixin,
+    UpdateMethod,
+    UpdateMixin,
+)
 from gitlab.types import RequiredOptional
 
 __all__ = [
@@ -16,6 +23,7 @@ class ProjectRegistryRepositoryProtectionRuleManager(
     ListMixin[ProjectRegistryRepositoryProtectionRule],
     CreateMixin[ProjectRegistryRepositoryProtectionRule],
     UpdateMixin[ProjectRegistryRepositoryProtectionRule],
+    DeleteMixin[ProjectRegistryRepositoryProtectionRule],
 ):
     _path = "/projects/{project_id}/registry/protection/repository/rules"
     _obj_cls = ProjectRegistryRepositoryProtectionRule

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/pyproject.toml

@@ -43,7 +43,7 @@ dynamic = ["version"]
 [project.optional-dependencies]
 autocompletion = ["argcomplete>=1.10.0,<3"]
 yaml = ["PyYaml>=6.0.1"]
-graphql = ["gql[httpx]>=3.5.0,<4"]
+graphql = ["gql[httpx]>=3.5.0,<5"]
 
 [project.scripts]
 gitlab = "gitlab.cli:main"

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/python_gitlab.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-gitlab
-Version: 7.0.0
+Version: 8.0.0
 Summary: The python wrapper for the GitLab REST and GraphQL APIs.
 Author-email: Gauvain Pocentek <gauvain@pocentek.net>
 Maintainer-email: John Villalovos <john@sodarock.com>, Max Wittig <max.wittig@siemens.com>, Nejc Habjan <nejc.habjan@siemens.com>, Roger Meier <r.meier@siemens.com>
@@ -35,7 +35,7 @@ Requires-Dist: argcomplete<3,>=1.10.0; extra == "autocompletion"
 Provides-Extra: yaml
 Requires-Dist: PyYaml>=6.0.1; extra == "yaml"
 Provides-Extra: graphql
-Requires-Dist: gql[httpx]<4,>=3.5.0; extra == "graphql"
+Requires-Dist: gql[httpx]<5,>=3.5.0; extra == "graphql"
 Dynamic: license-file
 
 python-gitlab

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/python_gitlab.egg-info/requires.txt

@@ -5,7 +5,7 @@ requests-toolbelt>=1.0.0
 argcomplete<3,>=1.10.0
 
 [graphql]
-gql[httpx]<4,>=3.5.0
+gql[httpx]<5,>=3.5.0
 
 [yaml]
 PyYaml>=6.0.1

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/requirements-docker.txt

@@ -1,3 +1,3 @@
 -r requirements.txt
 -r requirements-test.txt
-pytest-docker==3.2.3
+pytest-docker==3.2.5

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/requirements-docs.txt

@@ -1,7 +1,7 @@
 -r requirements.txt
-furo==2025.9.25
+furo==2025.12.19
 jinja2==3.1.6
-myst-parser==4.0.1
-sphinx==8.2.3
+myst-parser==5.0.0
+sphinx==9.1.0
 sphinxcontrib-autoprogram==0.1.9
 sphinx-autobuild==2025.8.25

python_gitlab-8.0.0/requirements-lint.txt

@@ -0,0 +1,14 @@
+-r requirements.txt
+argcomplete==2.0.0
+black==26.1.0
+commitizen==4.12.1
+flake8==7.3.0
+isort==7.0.0
+mypy==1.19.1
+pylint==4.0.4
+pytest==9.0.2
+responses==0.25.8
+respx==0.22.0
+types-PyYAML==6.0.12.20250915
+types-requests==2.32.4.20260107
+types-setuptools==80.10.0.20260124

python_gitlab-8.0.0/requirements-precommit.txt

@@ -0,0 +1 @@
+pre-commit==4.5.1

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/requirements-test.txt

@@ -1,13 +1,13 @@
 -r requirements.txt
-anyio==4.11.0
-build==1.3.0
-coverage==7.11.0
+anyio==4.12.1
+build==1.4.0
+coverage==7.13.2
 pytest-console-scripts==1.4.1
 pytest-cov==7.0.0
 pytest-github-actions-annotate-failures==0.3.0
-pytest==8.4.2
+pytest==9.0.2
 PyYaml==6.0.3
 responses==0.25.8
 respx==0.22.0
-trio==0.31.0
-wheel==0.45.1
+trio==0.32.0
+wheel==0.46.3

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/requirements.txt

@@ -1,4 +1,4 @@
-gql==3.5.3
+gql==4.0.0
 httpx==0.28.1
 requests==2.32.5
 requests-toolbelt==1.0.0

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/tests/functional/api/test_epics.py

@@ -15,18 +15,20 @@ def test_epics(group):
     assert group.epics.list()
 
 
-@pytest.mark.xfail(reason="404 on issue.id")
 def test_epic_issues(epic, issue):
     assert not epic.issues.list()
 
+    # FYI: Creating an issue causes a note to be created
     epic_issue = epic.issues.create({"issue_id": issue.id})
     assert epic.issues.list()
 
+    # FYI: Deleting an issue causes a note to be created
     epic_issue.delete()
 
 
 def test_epic_notes(epic):
-    assert not epic.notes.list()
+    notes = epic.notes.list(get_all=True)
 
     epic.notes.create({"body": "Test note"})
-    assert epic.notes.list()
+    new_notes = epic.notes.list(get_all=True)
+    assert len(new_notes) == (len(notes) + 1), f"{new_notes} {notes}"

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/tests/functional/api/test_keys.py

@@ -38,6 +38,14 @@ def test_keys_deploy(gl, project, DEPLOY_KEY):
     key_by_fingerprint = gl.keys.get(fingerprint=fingerprint)
     assert key_by_fingerprint.title == key.title
     assert key_by_fingerprint.key == key.key
-    assert len(key_by_fingerprint.deploy_keys_projects) == 1
+
+    if not any(
+        key_project.get("project_id") == project.id
+        for key_project in key_by_fingerprint.deploy_keys_projects
+    ):
+        raise AssertionError(
+            f"Project {project} not found in 'deploy_keys_projects' "
+            f"{key_by_fingerprint.pformat()}"
+        )
 
     key.delete()

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/tests/functional/api/test_project_job_token_scope.py

@@ -1,3 +1,6 @@
+import pytest
+
+
 # https://docs.gitlab.com/ee/ci/jobs/ci_job_token.html#allow-any-project-to-access-your-project
 def test_enable_limit_access_to_this_project(gl, project):
     scope = project.job_token_scope.get()
@@ -10,6 +13,7 @@ def test_enable_limit_access_to_this_project(gl, project):
     assert scope.inbound_enabled
 
 
+@pytest.mark.xfail(reason="https://gitlab.com/gitlab-org/gitlab/-/issues/582271")
 def test_disable_limit_access_to_this_project(gl, project):
     scope = project.job_token_scope.get()
 

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/tests/functional/api/test_projects.py

@@ -26,9 +26,9 @@ def test_create_project(gl, user):
 
     sudo_project = gl.projects.create({"name": "sudo_project"}, sudo=user.id)
 
-    created = gl.projects.list()
+    created = gl.projects.list(get_all=True)
     created_gen = gl.projects.list(iterator=True)
-    owned = gl.projects.list(owned=True)
+    owned = gl.projects.list(owned=True, get_all=True)
 
     assert admin_project in created and sudo_project in created
     assert admin_project in owned and sudo_project not in owned

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/tests/functional/api/test_registry.py

@@ -26,3 +26,8 @@ def test_project_protected_registry(project: Project):
     protected_registry.minimum_access_level_for_push = "owner"
     protected_registry.save()
     assert protected_registry.minimum_access_level_for_push == "owner"
+
+    protected_registry.delete()
+
+    rules = project.registry_protection_repository_rules.list()
+    assert rules == []

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/tests/functional/cli/test_cli_artifacts.py

@@ -7,14 +7,12 @@ from zipfile import is_zipfile
 
 import pytest
 
-content = textwrap.dedent(
-    """\
+content = textwrap.dedent("""\
     test-artifact:
       script: echo "test" > artifact.txt
       artifacts:
         untracked: true
-    """
-)
+    """)
 data = {
     "file_path": ".gitlab-ci.yml",
     "branch": "main",

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/tests/functional/fixtures/.env

@@ -1,4 +1,4 @@
 GITLAB_IMAGE=gitlab/gitlab-ee
-GITLAB_TAG=17.8.2-ee.0
+GITLAB_TAG=18.8.2-ee.0
 GITLAB_RUNNER_IMAGE=gitlab/gitlab-runner
 GITLAB_RUNNER_TAG=96856197

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/tests/functional/fixtures/docker-compose.yml

@@ -34,7 +34,7 @@ services:
     entrypoint:
       - /bin/sh
       - -c
-      - ruby /create_license.rb && /assets/wrapper
+      - ruby /create_license.rb && /assets/init-container
     volumes:
       - ${PWD}/tests/functional/fixtures/create_license.rb:/create_license.rb
     ports:

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/tests/functional/helpers.py

@@ -9,6 +9,7 @@ import pytest
 import gitlab
 import gitlab.base
 import gitlab.exceptions
+import gitlab.v4.objects
 
 SLEEP_INTERVAL = 0.5
 TIMEOUT = 60  # seconds before timeout will occur
@@ -37,6 +38,11 @@ def safe_delete(object: gitlab.base.RESTObject) -> None:
             object = manager.get(object.get_id())  # type: ignore[attr-defined]
         except gitlab.exceptions.GitlabGetError:
             return
+        # If object is already marked for deletion we have succeeded
+        if getattr(object, "marked_for_deletion_on", None) is not None:
+            # 'Group' and 'Project' objects have a 'marked_for_deletion_on' attribute
+            logging.info(f"{object!r} is marked for deletion.")
+            return
 
         if index:
             logging.info(f"Attempt {index + 1} to delete {object!r}.")
@@ -52,22 +58,16 @@ def safe_delete(object: gitlab.base.RESTObject) -> None:
                     # we shouldn't cause test to fail if it still exists
                     return
             elif isinstance(object, gitlab.v4.objects.Project):
-                # Immediately delete rather than waiting for at least 1day
-                # https://docs.gitlab.com/ee/api/projects.html#delete-project
-                object.delete(permanently_remove=True)
-                pass
+                # Starting in GitLab 18, projects can't be immediately deleted.
+                # So this will mark it for deletion.
+                object.delete()
             else:
                 # We only attempt to delete parent groups to prevent dangling sub-groups
-                # However parent groups can only be deleted on a delay in Gl 16
+                # However parent groups can only be deleted on a delay in GitLab 16
                 # https://docs.gitlab.com/ee/api/groups.html#remove-group
                 object.delete()
         except gitlab.exceptions.GitlabDeleteError:
-            logging.info(f"{object!r} already deleted or scheduled for deletion.")
-            if isinstance(object, gitlab.v4.objects.Group):
-                # Parent groups can never be immediately deleted in GL 16,
-                # so don't cause test to fail if it still exists
-                return
-            pass
+            logging.exception(f"Error attempting to delete: {object.pformat()}")
 
         time.sleep(SLEEP_INTERVAL)
     pytest.fail(f"{object!r} was not deleted")

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/tests/unit/objects/test_registry_protection_rules.py

@@ -58,6 +58,17 @@ def resp_update_protected_registry():
         yield rsps
 
 
+@pytest.fixture
+def resp_delete_protected_registry():
+    with responses.RequestsMock() as rsps:
+        rsps.add(
+            method=responses.DELETE,
+            url="http://localhost/api/v4/projects/1/registry/protection/repository/rules/1",
+            status=204,
+        )
+        yield rsps
+
+
 def test_list_project_protected_registries(project, resp_list_protected_registries):
     protected_registry = project.registry_protection_repository_rules.list()[0]
     assert isinstance(protected_registry, ProjectRegistryRepositoryProtectionRule)
@@ -80,3 +91,7 @@ def test_update_project_protected_registry(project, resp_update_protected_regist
         1, {"repository_path_pattern": "abc*"}
     )
     assert updated["repository_path_pattern"] == "abc*"
+
+
+def test_delete_project_protected_registry(project, resp_delete_protected_registry):
+    project.registry_protection_repository_rules.delete(1)

{python_gitlab-7.0.0 → python_gitlab-8.0.0}/tests/unit/test_config.py

@@ -268,28 +268,22 @@ def test_ssl_verify_as_str(m_open, monkeypatch):
 def test_data_from_helper(m_open, monkeypatch, tmp_path):
     helper = tmp_path / "helper.sh"
     helper.write_text(
-        dedent(
-            """\
+        dedent("""\
             #!/bin/sh
             echo "secret"
-            """
-        ),
+            """),
         encoding="utf-8",
     )
     helper.chmod(0o755)
 
-    fd = io.StringIO(
-        dedent(
-            f"""\
+    fd = io.StringIO(dedent(f"""\
             [global]
             default = helper
 
             [helper]
             url = https://helper.url
             oauth_token = helper: {helper}
-            """
-        )
-    )
+            """))
 
     fd.close = mock.Mock(return_value=None)
     m_open.return_value = fd
@@ -306,18 +300,14 @@ def test_data_from_helper(m_open, monkeypatch, tmp_path):
 @pytest.mark.skipif(sys.platform.startswith("win"), reason="Not supported on Windows")
 def test_from_helper_subprocess_error_raises_error(m_open, monkeypatch):
     # using false here to force a non-zero return code
-    fd = io.StringIO(
-        dedent(
-            """\
+    fd = io.StringIO(dedent("""\
             [global]
             default = helper
 
             [helper]
             url = https://helper.url
             oauth_token = helper: false
-            """
-        )
-    )
+            """))
 
     fd.close = mock.Mock(return_value=None)
     m_open.return_value = fd

python_gitlab-7.0.0/requirements-lint.txt

@@ -1,14 +0,0 @@
--r requirements.txt
-argcomplete==2.0.0
-black==25.9.0
-commitizen==4.9.1
-flake8==7.3.0
-isort==7.0.0
-mypy==1.18.2
-pylint==4.0.1
-pytest==8.4.2
-responses==0.25.8
-respx==0.22.0
-types-PyYAML==6.0.12.20250915
-types-requests==2.32.4.20250913
-types-setuptools==80.9.0.20250822

python_gitlab-7.0.0/requirements-precommit.txt

@@ -1 +0,0 @@
-pre-commit==4.3.0