python-gitlab 6.0.0__tar.gz → 6.1.0__tar.gz

{python_gitlab-6.0.0 → python_gitlab-6.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-gitlab
-Version: 6.0.0
+Version: 6.1.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>

{python_gitlab-6.0.0 → python_gitlab-6.1.0}/docs/gl_objects/protected_branches.rst

@@ -2,8 +2,8 @@
 Protected branches
 ##################
 
-You can define a list of protected branch names on a repository. Names can use
-wildcards (``*``).
+You can define a list of protected branch names on a repository or group.
+Names can use wildcards (``*``).
 
 References
 ----------
@@ -13,19 +13,24 @@ References
   + :class:`gitlab.v4.objects.ProjectProtectedBranch`
   + :class:`gitlab.v4.objects.ProjectProtectedBranchManager`
   + :attr:`gitlab.v4.objects.Project.protectedbranches`
+  + :class:`gitlab.v4.objects.GroupProtectedBranch`
+  + :class:`gitlab.v4.objects.GroupProtectedBranchManager`
+  + :attr:`gitlab.v4.objects.Group.protectedbranches`
 
 * GitLab API: https://docs.gitlab.com/api/protected_branches#protected-branches-api
 
 Examples
 --------
 
-Get the list of protected branches for a project::
+Get the list of protected branches for a project or group::
 
-    p_branches = project.protectedbranches.list(get_all=True)
+    p_branches = project.protectedbranches.list()
+    p_branches = group.protectedbranches.list()
 
 Get a single protected branch::
 
     p_branch = project.protectedbranches.get('main')
+    p_branch = group.protectedbranches.get('main')
 
 Update a protected branch::
 

{python_gitlab-6.0.0 → python_gitlab-6.1.0}/docs/gl_objects/users.rst

@@ -107,6 +107,10 @@ Get the followings of a user::
 
     user.following_users.list(get_all=True)
 
+List a user's contributed projects::
+
+    user.contributed_projects.list(get_all=True)
+
 List a user's starred projects::
 
     user.starred_projects.list(get_all=True)

{python_gitlab-6.0.0 → python_gitlab-6.1.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__ = "6.0.0"
+__version__ = "6.1.0"

{python_gitlab-6.0.0 → python_gitlab-6.1.0}/gitlab/cli.py

@@ -107,7 +107,7 @@ def gitlab_resource_to_cls(
     return class_type
 
 
-def cls_to_gitlab_resource(cls: RESTObject) -> str:
+def cls_to_gitlab_resource(cls: type[RESTObject]) -> str:
     dasherized_uppercase = camel_upperlower_regex.sub(r"\1-\2", cls.__name__)
     dasherized_lowercase = camel_lowerupper_regex.sub(r"\1-\2", dasherized_uppercase)
     return dasherized_lowercase.lower()

{python_gitlab-6.0.0 → python_gitlab-6.1.0}/gitlab/const.py

@@ -93,6 +93,7 @@ DEFAULT_URL: str = "https://gitlab.com"
 NO_ACCESS = AccessLevel.NO_ACCESS.value
 MINIMAL_ACCESS = AccessLevel.MINIMAL_ACCESS.value
 GUEST_ACCESS = AccessLevel.GUEST.value
+PLANNER_ACCESS = AccessLevel.PLANNER.value
 REPORTER_ACCESS = AccessLevel.REPORTER.value
 DEVELOPER_ACCESS = AccessLevel.DEVELOPER.value
 MAINTAINER_ACCESS = AccessLevel.MAINTAINER.value
@@ -151,6 +152,7 @@ __all__ = [
     "NOTIFICATION_LEVEL_PARTICIPATING",
     "NOTIFICATION_LEVEL_WATCH",
     "OWNER_ACCESS",
+    "PLANNER_ACCESS",
     "REPORTER_ACCESS",
     "SEARCH_SCOPE_BLOBS",
     "SEARCH_SCOPE_COMMITS",

{python_gitlab-6.0.0 → python_gitlab-6.1.0}/gitlab/v4/cli.py

@@ -394,7 +394,7 @@ def extend_parser(parser: argparse.ArgumentParser) -> argparse.ArgumentParser:
     subparsers.required = True
 
     # populate argparse for all Gitlab Object
-    classes = set()
+    classes: set[type[gitlab.base.RESTObject]] = set()
     for cls in gitlab.v4.objects.__dict__.values():
         if not isinstance(cls, type):
             continue

{python_gitlab-6.0.0 → python_gitlab-6.1.0}/gitlab/v4/objects/branches.py

@@ -49,3 +49,27 @@ class ProjectProtectedBranchManager(CRUDMixin[ProjectProtectedBranch]):
         ),
     )
     _update_method = UpdateMethod.PATCH
+
+
+class GroupProtectedBranch(SaveMixin, ObjectDeleteMixin, RESTObject):
+    _id_attr = "name"
+
+
+class GroupProtectedBranchManager(CRUDMixin[GroupProtectedBranch]):
+    _path = "/groups/{group_id}/protected_branches"
+    _obj_cls = GroupProtectedBranch
+    _from_parent_attrs = {"group_id": "id"}
+    _create_attrs = RequiredOptional(
+        required=("name",),
+        optional=(
+            "push_access_level",
+            "merge_access_level",
+            "unprotect_access_level",
+            "allow_force_push",
+            "allowed_to_push",
+            "allowed_to_merge",
+            "allowed_to_unprotect",
+            "code_owner_approval_required",
+        ),
+    )
+    _update_method = UpdateMethod.PATCH

{python_gitlab-6.0.0 → python_gitlab-6.1.0}/gitlab/v4/objects/groups.py

@@ -24,6 +24,7 @@ from .access_requests import GroupAccessRequestManager  # noqa: F401
 from .audit_events import GroupAuditEventManager  # noqa: F401
 from .badges import GroupBadgeManager  # noqa: F401
 from .boards import GroupBoardManager  # noqa: F401
+from .branches import GroupProtectedBranchManager  # noqa: F401
 from .clusters import GroupClusterManager  # noqa: F401
 from .container_registry import GroupRegistryRepositoryManager  # noqa: F401
 from .custom_attributes import GroupCustomAttributeManager  # noqa: F401
@@ -102,6 +103,7 @@ class Group(SaveMixin, ObjectDeleteMixin, RESTObject):
     packages: GroupPackageManager
     projects: GroupProjectManager
     shared_projects: SharedProjectManager
+    protectedbranches: GroupProtectedBranchManager
     pushrules: GroupPushRulesManager
     registry_repositories: GroupRegistryRepositoryManager
     runners: GroupRunnerManager

{python_gitlab-6.0.0 → python_gitlab-6.1.0}/gitlab/v4/objects/projects.py

@@ -429,6 +429,7 @@ class Project(
         ref: str,
         token: str,
         variables: dict[str, Any] | None = None,
+        inputs: dict[str, Any] | None = None,
         **kwargs: Any,
     ) -> ProjectPipeline:
         """Trigger a CI build.
@@ -439,6 +440,7 @@ class Project(
             ref: Commit to build; can be a branch name or a tag
             token: The trigger token
             variables: Variables passed to the build script
+            inputs: Inputs passed to the build script
             **kwargs: Extra options to send to the server (e.g. sudo)
 
         Raises:
@@ -446,8 +448,14 @@ class Project(
             GitlabCreateError: If the server failed to perform the request
         """
         variables = variables or {}
+        inputs = inputs or {}
         path = f"/projects/{self.encoded_id}/trigger/pipeline"
-        post_data = {"ref": ref, "token": token, "variables": variables}
+        post_data = {
+            "ref": ref,
+            "token": token,
+            "variables": variables,
+            "inputs": inputs,
+        }
         attrs = self.manager.gitlab.http_post(path, post_data=post_data, **kwargs)
         if TYPE_CHECKING:
             assert isinstance(attrs, dict)

{python_gitlab-6.0.0 → python_gitlab-6.1.0}/gitlab/v4/objects/tags.py

@@ -19,6 +19,7 @@ class ProjectTagManager(NoUpdateMixin[ProjectTag]):
     _path = "/projects/{project_id}/repository/tags"
     _obj_cls = ProjectTag
     _from_parent_attrs = {"project_id": "id"}
+    _list_filters = ("order_by", "sort", "search")
     _create_attrs = RequiredOptional(
         required=("tag_name", "ref"), optional=("message",)
     )

{python_gitlab-6.0.0 → python_gitlab-6.1.0}/gitlab/v4/objects/users.py

@@ -68,6 +68,8 @@ __all__ = [
     "UserMembershipManager",
     "UserProject",
     "UserProjectManager",
+    "UserContributedProject",
+    "UserContributedProjectManager",
 ]
 
 
@@ -182,6 +184,7 @@ class User(SaveMixin, ObjectDeleteMixin, RESTObject):
     memberships: UserMembershipManager
     personal_access_tokens: UserPersonalAccessTokenManager
     projects: UserProjectManager
+    contributed_projects: UserContributedProjectManager
     starred_projects: StarredProjectManager
     status: UserStatusManager
 
@@ -665,6 +668,17 @@ class UserProjectManager(ListMixin[UserProject], CreateMixin[UserProject]):
         return super().list(path=path, iterator=iterator, **kwargs)
 
 
+class UserContributedProject(RESTObject):
+    _id_attr = "id"
+    _repr_attr = "path_with_namespace"
+
+
+class UserContributedProjectManager(ListMixin[UserContributedProject]):
+    _path = "/users/{user_id}/contributed_projects"
+    _obj_cls = UserContributedProject
+    _from_parent_attrs = {"user_id": "id"}
+
+
 class StarredProject(RESTObject):
     pass
 

{python_gitlab-6.0.0 → python_gitlab-6.1.0}/python_gitlab.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-gitlab
-Version: 6.0.0
+Version: 6.1.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>

{python_gitlab-6.0.0 → python_gitlab-6.1.0}/requirements-docker.txt

@@ -1,3 +1,3 @@
 -r requirements.txt
 -r requirements-test.txt
-pytest-docker==3.2.1
+pytest-docker==3.2.2

{python_gitlab-6.0.0 → python_gitlab-6.1.0}/requirements-lint.txt

@@ -1,14 +1,14 @@
 -r requirements.txt
 argcomplete==2.0.0
 black==25.1.0
-commitizen==4.8.2
+commitizen==4.8.3
 flake8==7.2.0
 isort==6.0.1
-mypy==1.15.0
+mypy==1.16.0
 pylint==3.3.7
-pytest==8.3.5
+pytest==8.4.0
 responses==0.25.7
 respx==0.22.0
 types-PyYAML==6.0.12.20250516
-types-requests==2.32.0.20250515
-types-setuptools==80.8.0.20250521
+types-requests==2.32.4.20250611
+types-setuptools==80.9.0.20250529

{python_gitlab-6.0.0 → python_gitlab-6.1.0}/requirements-test.txt

@@ -1,11 +1,11 @@
 -r requirements.txt
 anyio==4.9.0
 build==1.2.2.post1
-coverage==7.8.2
+coverage==7.9.1
 pytest-console-scripts==1.4.1
-pytest-cov==6.1.1
+pytest-cov==6.2.1
 pytest-github-actions-annotate-failures==0.3.0
-pytest==8.3.5
+pytest==8.4.0
 PyYaml==6.0.2
 responses==0.25.7
 respx==0.22.0

{python_gitlab-6.0.0 → python_gitlab-6.1.0}/requirements.txt

@@ -1,4 +1,4 @@
 gql==3.5.3
 httpx==0.28.1
-requests==2.32.3
+requests==2.32.4
 requests-toolbelt==1.0.0

{python_gitlab-6.0.0 → python_gitlab-6.1.0}/tests/functional/api/test_groups.py

@@ -312,6 +312,31 @@ def test_group_hooks(group):
     hook.delete()
 
 
+def test_group_protected_branches(group, gitlab_version):
+    # Updating a protected branch at the group level is possible from Gitlab 15.9
+    # https://docs.gitlab.com/api/group_protected_branches/
+    can_update_prot_branch = gitlab_version.major > 15 or (
+        gitlab_version.major == 15 and gitlab_version.minor >= 9
+    )
+
+    p_b = group.protectedbranches.create(
+        {"name": "*-stable", "allow_force_push": False}
+    )
+    assert p_b.name == "*-stable"
+    assert not p_b.allow_force_push
+    assert p_b in group.protectedbranches.list()
+
+    if can_update_prot_branch:
+        p_b.allow_force_push = True
+        p_b.save()
+
+    p_b = group.protectedbranches.get("*-stable")
+    if can_update_prot_branch:
+        assert p_b.allow_force_push
+
+        p_b.delete()
+
+
 def test_group_transfer(gl, group):
     transfer_group = gl.groups.create(
         {"name": "transfer-test-group", "path": "transfer-test-group"}

{python_gitlab-6.0.0 → python_gitlab-6.1.0}/tests/unit/objects/test_users.py

@@ -7,7 +7,13 @@ https://docs.gitlab.com/ee/api/projects.html#list-projects-starred-by-a-user
 import pytest
 import responses
 
-from gitlab.v4.objects import StarredProject, User, UserMembership, UserStatus
+from gitlab.v4.objects import (
+    StarredProject,
+    User,
+    UserContributedProject,
+    UserMembership,
+    UserStatus,
+)
 
 from .test_projects import project_content
 
@@ -242,6 +248,19 @@ def resp_starred_projects():
         yield rsps
 
 
+@pytest.fixture
+def resp_contributed_projects():
+    with responses.RequestsMock() as rsps:
+        rsps.add(
+            method=responses.GET,
+            url="http://localhost/api/v4/users/1/contributed_projects",
+            json=[project_content],
+            content_type="application/json",
+            status=200,
+        )
+        yield rsps
+
+
 @pytest.fixture
 def resp_runner_create():
     with responses.RequestsMock() as rsps:
@@ -314,6 +333,12 @@ def test_list_followers(user, resp_followers_following):
     assert followings[1].id == 4
 
 
+def test_list_contributed_projects(user, resp_contributed_projects):
+    projects = user.contributed_projects.list()
+    assert isinstance(projects[0], UserContributedProject)
+    assert projects[0].id == project_content["id"]
+
+
 def test_list_starred_projects(user, resp_starred_projects):
     projects = user.starred_projects.list()
     assert isinstance(projects[0], StarredProject)

{python_gitlab-6.0.0 → python_gitlab-6.1.0}/tests/unit/test_cli.py

@@ -161,7 +161,7 @@ def test_extend_parser():
             "Raise error instead of exiting on invalid arguments, to make testing easier"
             raise ValueError(message)
 
-    class Fake:
+    class Fake(gitlab.base.RESTObject):
         _id_attr = None
 
     class FakeManager(CreateMixin, UpdateMixin, gitlab.base.RESTManager):