python-gitlab 5.5.0__py3-none-any.whl → 6.0.0__py3-none-any.whl

gitlab/v4/objects/notes.py

@@ -1,6 +1,4 @@
-from typing import Any, cast, Union
-
-from gitlab.base import RESTManager, RESTObject
+from gitlab.base import RESTObject
 from gitlab.mixins import (
     CreateMixin,
     CRUDMixin,
@@ -48,25 +46,23 @@ class GroupEpicNote(SaveMixin, ObjectDeleteMixin, RESTObject):
     awardemojis: GroupEpicNoteAwardEmojiManager
 
 
-class GroupEpicNoteManager(CRUDMixin, RESTManager):
+class GroupEpicNoteManager(CRUDMixin[GroupEpicNote]):
     _path = "/groups/{group_id}/epics/{epic_id}/notes"
     _obj_cls = GroupEpicNote
     _from_parent_attrs = {"group_id": "group_id", "epic_id": "id"}
     _create_attrs = RequiredOptional(required=("body",), optional=("created_at",))
     _update_attrs = RequiredOptional(required=("body",))
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> GroupEpicNote:
-        return cast(GroupEpicNote, super().get(id=id, lazy=lazy, **kwargs))
-
 
 class GroupEpicDiscussionNote(SaveMixin, ObjectDeleteMixin, RESTObject):
     pass
 
 
 class GroupEpicDiscussionNoteManager(
-    GetMixin, CreateMixin, UpdateMixin, DeleteMixin, RESTManager
+    GetMixin[GroupEpicDiscussionNote],
+    CreateMixin[GroupEpicDiscussionNote],
+    UpdateMixin[GroupEpicDiscussionNote],
+    DeleteMixin[GroupEpicDiscussionNote],
 ):
     _path = "/groups/{group_id}/epics/{epic_id}/discussions/{discussion_id}/notes"
     _obj_cls = GroupEpicDiscussionNote
@@ -78,34 +74,27 @@ class GroupEpicDiscussionNoteManager(
     _create_attrs = RequiredOptional(required=("body",), optional=("created_at",))
     _update_attrs = RequiredOptional(required=("body",))
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> GroupEpicDiscussionNote:
-        return cast(GroupEpicDiscussionNote, super().get(id=id, lazy=lazy, **kwargs))
-
 
 class ProjectNote(RESTObject):
     pass
 
 
-class ProjectNoteManager(RetrieveMixin, RESTManager):
+class ProjectNoteManager(RetrieveMixin[ProjectNote]):
     _path = "/projects/{project_id}/notes"
     _obj_cls = ProjectNote
     _from_parent_attrs = {"project_id": "id"}
     _create_attrs = RequiredOptional(required=("body",))
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectNote:
-        return cast(ProjectNote, super().get(id=id, lazy=lazy, **kwargs))
-
 
 class ProjectCommitDiscussionNote(SaveMixin, ObjectDeleteMixin, RESTObject):
     pass
 
 
 class ProjectCommitDiscussionNoteManager(
-    GetMixin, CreateMixin, UpdateMixin, DeleteMixin, RESTManager
+    GetMixin[ProjectCommitDiscussionNote],
+    CreateMixin[ProjectCommitDiscussionNote],
+    UpdateMixin[ProjectCommitDiscussionNote],
+    DeleteMixin[ProjectCommitDiscussionNote],
 ):
     _path = (
         "/projects/{project_id}/repository/commits/{commit_id}/"
@@ -122,37 +111,28 @@ class ProjectCommitDiscussionNoteManager(
     )
     _update_attrs = RequiredOptional(required=("body",))
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectCommitDiscussionNote:
-        return cast(
-            ProjectCommitDiscussionNote, super().get(id=id, lazy=lazy, **kwargs)
-        )
-
 
 class ProjectIssueNote(SaveMixin, ObjectDeleteMixin, RESTObject):
     awardemojis: ProjectIssueNoteAwardEmojiManager
 
 
-class ProjectIssueNoteManager(CRUDMixin, RESTManager):
+class ProjectIssueNoteManager(CRUDMixin[ProjectIssueNote]):
     _path = "/projects/{project_id}/issues/{issue_iid}/notes"
     _obj_cls = ProjectIssueNote
     _from_parent_attrs = {"project_id": "project_id", "issue_iid": "iid"}
     _create_attrs = RequiredOptional(required=("body",), optional=("created_at",))
     _update_attrs = RequiredOptional(required=("body",))
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectIssueNote:
-        return cast(ProjectIssueNote, super().get(id=id, lazy=lazy, **kwargs))
-
 
 class ProjectIssueDiscussionNote(SaveMixin, ObjectDeleteMixin, RESTObject):
     pass
 
 
 class ProjectIssueDiscussionNoteManager(
-    GetMixin, CreateMixin, UpdateMixin, DeleteMixin, RESTManager
+    GetMixin[ProjectIssueDiscussionNote],
+    CreateMixin[ProjectIssueDiscussionNote],
+    UpdateMixin[ProjectIssueDiscussionNote],
+    DeleteMixin[ProjectIssueDiscussionNote],
 ):
     _path = (
         "/projects/{project_id}/issues/{issue_iid}/discussions/{discussion_id}/notes"
@@ -166,35 +146,28 @@ class ProjectIssueDiscussionNoteManager(
     _create_attrs = RequiredOptional(required=("body",), optional=("created_at",))
     _update_attrs = RequiredOptional(required=("body",))
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectIssueDiscussionNote:
-        return cast(ProjectIssueDiscussionNote, super().get(id=id, lazy=lazy, **kwargs))
-
 
 class ProjectMergeRequestNote(SaveMixin, ObjectDeleteMixin, RESTObject):
     awardemojis: ProjectMergeRequestNoteAwardEmojiManager
 
 
-class ProjectMergeRequestNoteManager(CRUDMixin, RESTManager):
+class ProjectMergeRequestNoteManager(CRUDMixin[ProjectMergeRequestNote]):
     _path = "/projects/{project_id}/merge_requests/{mr_iid}/notes"
     _obj_cls = ProjectMergeRequestNote
     _from_parent_attrs = {"project_id": "project_id", "mr_iid": "iid"}
     _create_attrs = RequiredOptional(required=("body",))
     _update_attrs = RequiredOptional(required=("body",))
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectMergeRequestNote:
-        return cast(ProjectMergeRequestNote, super().get(id=id, lazy=lazy, **kwargs))
-
 
 class ProjectMergeRequestDiscussionNote(SaveMixin, ObjectDeleteMixin, RESTObject):
     pass
 
 
 class ProjectMergeRequestDiscussionNoteManager(
-    GetMixin, CreateMixin, UpdateMixin, DeleteMixin, RESTManager
+    GetMixin[ProjectMergeRequestDiscussionNote],
+    CreateMixin[ProjectMergeRequestDiscussionNote],
+    UpdateMixin[ProjectMergeRequestDiscussionNote],
+    DeleteMixin[ProjectMergeRequestDiscussionNote],
 ):
     _path = (
         "/projects/{project_id}/merge_requests/{mr_iid}/"
@@ -209,37 +182,28 @@ class ProjectMergeRequestDiscussionNoteManager(
     _create_attrs = RequiredOptional(required=("body",), optional=("created_at",))
     _update_attrs = RequiredOptional(required=("body",))
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectMergeRequestDiscussionNote:
-        return cast(
-            ProjectMergeRequestDiscussionNote, super().get(id=id, lazy=lazy, **kwargs)
-        )
-
 
 class ProjectSnippetNote(SaveMixin, ObjectDeleteMixin, RESTObject):
     awardemojis: ProjectSnippetNoteAwardEmojiManager
 
 
-class ProjectSnippetNoteManager(CRUDMixin, RESTManager):
+class ProjectSnippetNoteManager(CRUDMixin[ProjectSnippetNote]):
     _path = "/projects/{project_id}/snippets/{snippet_id}/notes"
     _obj_cls = ProjectSnippetNote
     _from_parent_attrs = {"project_id": "project_id", "snippet_id": "id"}
     _create_attrs = RequiredOptional(required=("body",))
     _update_attrs = RequiredOptional(required=("body",))
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectSnippetNote:
-        return cast(ProjectSnippetNote, super().get(id=id, lazy=lazy, **kwargs))
-
 
 class ProjectSnippetDiscussionNote(SaveMixin, ObjectDeleteMixin, RESTObject):
     pass
 
 
 class ProjectSnippetDiscussionNoteManager(
-    GetMixin, CreateMixin, UpdateMixin, DeleteMixin, RESTManager
+    GetMixin[ProjectSnippetDiscussionNote],
+    CreateMixin[ProjectSnippetDiscussionNote],
+    UpdateMixin[ProjectSnippetDiscussionNote],
+    DeleteMixin[ProjectSnippetDiscussionNote],
 ):
     _path = (
         "/projects/{project_id}/snippets/{snippet_id}/"
@@ -253,10 +217,3 @@ class ProjectSnippetDiscussionNoteManager(
     }
     _create_attrs = RequiredOptional(required=("body",), optional=("created_at",))
     _update_attrs = RequiredOptional(required=("body",))
-
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectSnippetDiscussionNote:
-        return cast(
-            ProjectSnippetDiscussionNote, super().get(id=id, lazy=lazy, **kwargs)
-        )

gitlab/v4/objects/notification_settings.py

@@ -1,6 +1,4 @@
-from typing import Any, cast
-
-from gitlab.base import RESTManager, RESTObject
+from gitlab.base import RESTObject
 from gitlab.mixins import GetWithoutIdMixin, SaveMixin, UpdateMixin
 from gitlab.types import RequiredOptional
 
@@ -18,7 +16,9 @@ class NotificationSettings(SaveMixin, RESTObject):
     _id_attr = None
 
 
-class NotificationSettingsManager(GetWithoutIdMixin, UpdateMixin, RESTManager):
+class NotificationSettingsManager(
+    GetWithoutIdMixin[NotificationSettings], UpdateMixin[NotificationSettings]
+):
     _path = "/notification_settings"
     _obj_cls = NotificationSettings
 
@@ -36,12 +36,9 @@ class NotificationSettingsManager(GetWithoutIdMixin, UpdateMixin, RESTManager):
             "close_merge_request",
             "reassign_merge_request",
             "merge_merge_request",
-        ),
+        )
     )
 
-    def get(self, **kwargs: Any) -> NotificationSettings:
-        return cast(NotificationSettings, super().get(**kwargs))
-
 
 class GroupNotificationSettings(NotificationSettings):
     pass
@@ -52,9 +49,6 @@ class GroupNotificationSettingsManager(NotificationSettingsManager):
     _obj_cls = GroupNotificationSettings
     _from_parent_attrs = {"group_id": "id"}
 
-    def get(self, **kwargs: Any) -> GroupNotificationSettings:
-        return cast(GroupNotificationSettings, super().get(id=id, **kwargs))
-
 
 class ProjectNotificationSettings(NotificationSettings):
     pass
@@ -64,6 +58,3 @@ class ProjectNotificationSettingsManager(NotificationSettingsManager):
     _path = "/projects/{project_id}/notification_settings"
     _obj_cls = ProjectNotificationSettings
     _from_parent_attrs = {"project_id": "id"}
-
-    def get(self, **kwargs: Any) -> ProjectNotificationSettings:
-        return cast(ProjectNotificationSettings, super().get(id=id, **kwargs))

gitlab/v4/objects/package_protection_rules.py

@@ -1,4 +1,4 @@
-from gitlab.base import RESTManager, RESTObject
+from gitlab.base import RESTObject
 from gitlab.mixins import (
     CreateMixin,
     DeleteMixin,
@@ -10,10 +10,7 @@ from gitlab.mixins import (
 )
 from gitlab.types import RequiredOptional
 
-__all__ = [
-    "ProjectPackageProtectionRule",
-    "ProjectPackageProtectionRuleManager",
-]
+__all__ = ["ProjectPackageProtectionRule", "ProjectPackageProtectionRuleManager"]
 
 
 class ProjectPackageProtectionRule(ObjectDeleteMixin, SaveMixin, RESTObject):
@@ -21,7 +18,10 @@ class ProjectPackageProtectionRule(ObjectDeleteMixin, SaveMixin, RESTObject):
 
 
 class ProjectPackageProtectionRuleManager(
-    ListMixin, CreateMixin, DeleteMixin, UpdateMixin, RESTManager
+    ListMixin[ProjectPackageProtectionRule],
+    CreateMixin[ProjectPackageProtectionRule],
+    DeleteMixin[ProjectPackageProtectionRule],
+    UpdateMixin[ProjectPackageProtectionRule],
 ):
     _path = "/projects/{project_id}/packages/protection/rules"
     _obj_cls = ProjectPackageProtectionRule
@@ -31,13 +31,13 @@ class ProjectPackageProtectionRuleManager(
             "package_name_pattern",
             "package_type",
             "minimum_access_level_for_push",
-        ),
+        )
     )
     _update_attrs = RequiredOptional(
         optional=(
             "package_name_pattern",
             "package_type",
             "minimum_access_level_for_push",
-        ),
+        )
     )
     _update_method = UpdateMethod.PATCH

gitlab/v4/objects/packages.py

@@ -4,19 +4,10 @@ https://docs.gitlab.com/ee/api/packages.html
 https://docs.gitlab.com/ee/user/packages/generic_packages/
 """
 
+from __future__ import annotations
+
 from pathlib import Path
-from typing import (
-    Any,
-    BinaryIO,
-    Callable,
-    cast,
-    Iterator,
-    Literal,
-    Optional,
-    overload,
-    TYPE_CHECKING,
-    Union,
-)
+from typing import Any, BinaryIO, Callable, Iterator, Literal, overload, TYPE_CHECKING
 
 import requests
 
@@ -44,7 +35,7 @@ class GenericPackage(RESTObject):
     _id_attr = "package_name"
 
 
-class GenericPackageManager(RESTManager):
+class GenericPackageManager(RESTManager[GenericPackage]):
     _path = "/projects/{project_id}/packages/generic"
     _obj_cls = GenericPackage
     _from_parent_attrs = {"project_id": "id"}
@@ -59,9 +50,9 @@ class GenericPackageManager(RESTManager):
         package_name: str,
         package_version: str,
         file_name: str,
-        path: Optional[Union[str, Path]] = None,
-        select: Optional[str] = None,
-        data: Optional[Union[bytes, BinaryIO]] = None,
+        path: str | Path | None = None,
+        select: str | None = None,
+        data: bytes | BinaryIO | None = None,
         **kwargs: Any,
     ) -> GenericPackage:
         """Upload a file as a generic package.
@@ -93,7 +84,7 @@ class GenericPackageManager(RESTManager):
         if path is not None and data is not None:
             raise exc.GitlabUploadError("File contents and file path specified")
 
-        file_data: Optional[Union[bytes, BinaryIO]] = data
+        file_data: bytes | BinaryIO | None = data
 
         if not file_data:
             if TYPE_CHECKING:
@@ -159,7 +150,7 @@ class GenericPackageManager(RESTManager):
         package_version: str,
         file_name: str,
         streamed: Literal[True] = True,
-        action: Optional[Callable[[bytes], Any]] = None,
+        action: Callable[[bytes], Any] | None = None,
         chunk_size: int = 1024,
         *,
         iterator: Literal[False] = False,
@@ -177,12 +168,12 @@ class GenericPackageManager(RESTManager):
         package_version: str,
         file_name: str,
         streamed: bool = False,
-        action: Optional[Callable[[bytes], Any]] = None,
+        action: Callable[[bytes], Any] | None = None,
         chunk_size: int = 1024,
         *,
         iterator: bool = False,
         **kwargs: Any,
-    ) -> Optional[Union[bytes, Iterator[Any]]]:
+    ) -> bytes | Iterator[Any] | None:
         """Download a generic package.
 
         Args:
@@ -219,7 +210,7 @@ class GroupPackage(RESTObject):
     pass
 
 
-class GroupPackageManager(ListMixin, RESTManager):
+class GroupPackageManager(ListMixin[GroupPackage]):
     _path = "/groups/{group_id}/packages"
     _obj_cls = GroupPackage
     _from_parent_attrs = {"group_id": "id"}
@@ -233,32 +224,26 @@ class GroupPackageManager(ListMixin, RESTManager):
 
 
 class ProjectPackage(ObjectDeleteMixin, RESTObject):
-    package_files: "ProjectPackageFileManager"
-    pipelines: "ProjectPackagePipelineManager"
+    package_files: ProjectPackageFileManager
+    pipelines: ProjectPackagePipelineManager
 
 
-class ProjectPackageManager(ListMixin, GetMixin, DeleteMixin, RESTManager):
+class ProjectPackageManager(
+    ListMixin[ProjectPackage], GetMixin[ProjectPackage], DeleteMixin[ProjectPackage]
+):
     _path = "/projects/{project_id}/packages"
     _obj_cls = ProjectPackage
     _from_parent_attrs = {"project_id": "id"}
-    _list_filters = (
-        "order_by",
-        "sort",
-        "package_type",
-        "package_name",
-    )
-
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectPackage:
-        return cast(ProjectPackage, super().get(id=id, lazy=lazy, **kwargs))
+    _list_filters = ("order_by", "sort", "package_type", "package_name")
 
 
 class ProjectPackageFile(ObjectDeleteMixin, RESTObject):
     pass
 
 
-class ProjectPackageFileManager(DeleteMixin, ListMixin, RESTManager):
+class ProjectPackageFileManager(
+    DeleteMixin[ProjectPackageFile], ListMixin[ProjectPackageFile]
+):
     _path = "/projects/{project_id}/packages/{package_id}/package_files"
     _obj_cls = ProjectPackageFile
     _from_parent_attrs = {"project_id": "project_id", "package_id": "id"}
@@ -268,7 +253,7 @@ class ProjectPackagePipeline(RESTObject):
     pass
 
 
-class ProjectPackagePipelineManager(ListMixin, RESTManager):
+class ProjectPackagePipelineManager(ListMixin[ProjectPackagePipeline]):
     _path = "/projects/{project_id}/packages/{package_id}/pipelines"
     _obj_cls = ProjectPackagePipeline
     _from_parent_attrs = {"project_id": "project_id", "package_id": "id"}

gitlab/v4/objects/pages.py

@@ -1,6 +1,4 @@
-from typing import Any, cast, Union
-
-from gitlab.base import RESTManager, RESTObject
+from gitlab.base import RESTObject
 from gitlab.mixins import (
     CRUDMixin,
     DeleteMixin,
@@ -28,7 +26,7 @@ class PagesDomain(RESTObject):
     _id_attr = "domain"
 
 
-class PagesDomainManager(ListMixin, RESTManager):
+class PagesDomainManager(ListMixin[PagesDomain]):
     _path = "/pages/domains"
     _obj_cls = PagesDomain
 
@@ -37,7 +35,7 @@ class ProjectPagesDomain(SaveMixin, ObjectDeleteMixin, RESTObject):
     _id_attr = "domain"
 
 
-class ProjectPagesDomainManager(CRUDMixin, RESTManager):
+class ProjectPagesDomainManager(CRUDMixin[ProjectPagesDomain]):
     _path = "/projects/{project_id}/pages/domains"
     _obj_cls = ProjectPagesDomain
     _from_parent_attrs = {"project_id": "id"}
@@ -46,17 +44,16 @@ class ProjectPagesDomainManager(CRUDMixin, RESTManager):
     )
     _update_attrs = RequiredOptional(optional=("certificate", "key"))
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectPagesDomain:
-        return cast(ProjectPagesDomain, super().get(id=id, lazy=lazy, **kwargs))
-
 
 class ProjectPages(ObjectDeleteMixin, RefreshMixin, RESTObject):
     _id_attr = None
 
 
-class ProjectPagesManager(DeleteMixin, UpdateMixin, GetWithoutIdMixin, RESTManager):
+class ProjectPagesManager(
+    DeleteMixin[ProjectPages],
+    UpdateMixin[ProjectPages],
+    GetWithoutIdMixin[ProjectPages],
+):
     _path = "/projects/{project_id}/pages"
     _obj_cls = ProjectPages
     _from_parent_attrs = {"project_id": "id"}
@@ -64,6 +61,3 @@ class ProjectPagesManager(DeleteMixin, UpdateMixin, GetWithoutIdMixin, RESTManag
         optional=("pages_unique_domain_enabled", "pages_https_only")
     )
     _update_method: UpdateMethod = UpdateMethod.PATCH
-
-    def get(self, **kwargs: Any) -> ProjectPages:
-        return cast(ProjectPages, super().get(**kwargs))

gitlab/v4/objects/personal_access_tokens.py

@@ -1,6 +1,4 @@
-from typing import Any, cast, Union
-
-from gitlab.base import RESTManager, RESTObject
+from gitlab.base import RESTObject
 from gitlab.mixins import (
     CreateMixin,
     DeleteMixin,
@@ -23,22 +21,21 @@ class PersonalAccessToken(ObjectDeleteMixin, ObjectRotateMixin, RESTObject):
     pass
 
 
-class PersonalAccessTokenManager(DeleteMixin, RetrieveMixin, RotateMixin, RESTManager):
+class PersonalAccessTokenManager(
+    DeleteMixin[PersonalAccessToken],
+    RetrieveMixin[PersonalAccessToken],
+    RotateMixin[PersonalAccessToken],
+):
     _path = "/personal_access_tokens"
     _obj_cls = PersonalAccessToken
     _list_filters = ("user_id",)
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> PersonalAccessToken:
-        return cast(PersonalAccessToken, super().get(id=id, lazy=lazy, **kwargs))
-
 
 class UserPersonalAccessToken(RESTObject):
     pass
 
 
-class UserPersonalAccessTokenManager(CreateMixin, RESTManager):
+class UserPersonalAccessTokenManager(CreateMixin[UserPersonalAccessToken]):
     _path = "/users/{user_id}/personal_access_tokens"
     _obj_cls = UserPersonalAccessToken
     _from_parent_attrs = {"user_id": "id"}