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

gitlab/v4/objects/draft_notes.py

@@ -1,13 +1,10 @@
-from typing import Any, cast, Union
+from typing import Any
 
-from gitlab.base import RESTManager, RESTObject
+from gitlab.base import RESTObject
 from gitlab.mixins import CRUDMixin, ObjectDeleteMixin, SaveMixin
 from gitlab.types import RequiredOptional
 
-__all__ = [
-    "ProjectMergeRequestDraftNote",
-    "ProjectMergeRequestDraftNoteManager",
-]
+__all__ = ["ProjectMergeRequestDraftNote", "ProjectMergeRequestDraftNoteManager"]
 
 
 class ProjectMergeRequestDraftNote(ObjectDeleteMixin, SaveMixin, RESTObject):
@@ -16,7 +13,7 @@ class ProjectMergeRequestDraftNote(ObjectDeleteMixin, SaveMixin, RESTObject):
         self.manager.gitlab.http_put(path, **kwargs)
 
 
-class ProjectMergeRequestDraftNoteManager(CRUDMixin, RESTManager):
+class ProjectMergeRequestDraftNoteManager(CRUDMixin[ProjectMergeRequestDraftNote]):
     _path = "/projects/{project_id}/merge_requests/{mr_iid}/draft_notes"
     _obj_cls = ProjectMergeRequestDraftNote
     _from_parent_attrs = {"project_id": "project_id", "mr_iid": "iid"}
@@ -31,13 +28,6 @@ class ProjectMergeRequestDraftNoteManager(CRUDMixin, RESTManager):
     )
     _update_attrs = RequiredOptional(optional=("position",))
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectMergeRequestDraftNote:
-        return cast(
-            ProjectMergeRequestDraftNote, super().get(id=id, lazy=lazy, **kwargs)
-        )
-
     def bulk_publish(self, **kwargs: Any) -> None:
         path = f"{self.path}/bulk_publish"
         self.gitlab.http_post(path, **kwargs)

gitlab/v4/objects/environments.py

@@ -1,10 +1,12 @@
-from typing import Any, cast, Dict, Union
+from __future__ import annotations
+
+from typing import Any
 
 import requests
 
 from gitlab import cli
 from gitlab import exceptions as exc
-from gitlab.base import RESTManager, RESTObject
+from gitlab.base import RESTObject
 from gitlab.mixins import (
     CreateMixin,
     DeleteMixin,
@@ -26,7 +28,7 @@ __all__ = [
 class ProjectEnvironment(SaveMixin, ObjectDeleteMixin, RESTObject):
     @cli.register_custom_action(cls_names="ProjectEnvironment")
     @exc.on_http_error(exc.GitlabStopError)
-    def stop(self, **kwargs: Any) -> Union[Dict[str, Any], requests.Response]:
+    def stop(self, **kwargs: Any) -> dict[str, Any] | requests.Response:
         """Stop the environment.
 
         Args:
@@ -44,7 +46,10 @@ class ProjectEnvironment(SaveMixin, ObjectDeleteMixin, RESTObject):
 
 
 class ProjectEnvironmentManager(
-    RetrieveMixin, CreateMixin, UpdateMixin, DeleteMixin, RESTManager
+    RetrieveMixin[ProjectEnvironment],
+    CreateMixin[ProjectEnvironment],
+    UpdateMixin[ProjectEnvironment],
+    DeleteMixin[ProjectEnvironment],
 ):
     _path = "/projects/{project_id}/environments"
     _obj_cls = ProjectEnvironment
@@ -53,11 +58,6 @@ class ProjectEnvironmentManager(
     _update_attrs = RequiredOptional(optional=("name", "external_url"))
     _list_filters = ("name", "search", "states")
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectEnvironment:
-        return cast(ProjectEnvironment, super().get(id=id, lazy=lazy, **kwargs))
-
 
 class ProjectProtectedEnvironment(ObjectDeleteMixin, RESTObject):
     _id_attr = "name"
@@ -65,23 +65,15 @@ class ProjectProtectedEnvironment(ObjectDeleteMixin, RESTObject):
 
 
 class ProjectProtectedEnvironmentManager(
-    RetrieveMixin, CreateMixin, DeleteMixin, RESTManager
+    RetrieveMixin[ProjectProtectedEnvironment],
+    CreateMixin[ProjectProtectedEnvironment],
+    DeleteMixin[ProjectProtectedEnvironment],
 ):
     _path = "/projects/{project_id}/protected_environments"
     _obj_cls = ProjectProtectedEnvironment
     _from_parent_attrs = {"project_id": "id"}
     _create_attrs = RequiredOptional(
-        required=(
-            "name",
-            "deploy_access_levels",
-        ),
+        required=("name", "deploy_access_levels"),
         optional=("required_approval_count", "approval_rules"),
     )
     _types = {"deploy_access_levels": ArrayAttribute, "approval_rules": ArrayAttribute}
-
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectProtectedEnvironment:
-        return cast(
-            ProjectProtectedEnvironment, super().get(id=id, lazy=lazy, **kwargs)
-        )

gitlab/v4/objects/epics.py

@@ -1,8 +1,10 @@
-from typing import Any, cast, Dict, Optional, TYPE_CHECKING, Union
+from __future__ import annotations
+
+from typing import Any, TYPE_CHECKING
 
 from gitlab import exceptions as exc
 from gitlab import types
-from gitlab.base import RESTManager, RESTObject
+from gitlab.base import RESTObject
 from gitlab.mixins import (
     CreateMixin,
     CRUDMixin,
@@ -17,23 +19,18 @@ from gitlab.types import RequiredOptional
 from .events import GroupEpicResourceLabelEventManager  # noqa: F401
 from .notes import GroupEpicNoteManager  # noqa: F401
 
-__all__ = [
-    "GroupEpic",
-    "GroupEpicManager",
-    "GroupEpicIssue",
-    "GroupEpicIssueManager",
-]
+__all__ = ["GroupEpic", "GroupEpicManager", "GroupEpicIssue", "GroupEpicIssueManager"]
 
 
 class GroupEpic(ObjectDeleteMixin, SaveMixin, RESTObject):
     _id_attr = "iid"
 
-    issues: "GroupEpicIssueManager"
+    issues: GroupEpicIssueManager
     resourcelabelevents: GroupEpicResourceLabelEventManager
     notes: GroupEpicNoteManager
 
 
-class GroupEpicManager(CRUDMixin, RESTManager):
+class GroupEpicManager(CRUDMixin[GroupEpic]):
     _path = "/groups/{group_id}/epics"
     _obj_cls = GroupEpic
     _from_parent_attrs = {"group_id": "id"}
@@ -43,19 +40,16 @@ class GroupEpicManager(CRUDMixin, RESTManager):
         optional=("labels", "description", "start_date", "end_date"),
     )
     _update_attrs = RequiredOptional(
-        optional=("title", "labels", "description", "start_date", "end_date"),
+        optional=("title", "labels", "description", "start_date", "end_date")
     )
     _types = {"labels": types.CommaSeparatedListAttribute}
 
-    def get(self, id: Union[str, int], lazy: bool = False, **kwargs: Any) -> GroupEpic:
-        return cast(GroupEpic, super().get(id=id, lazy=lazy, **kwargs))
-
 
 class GroupEpicIssue(ObjectDeleteMixin, SaveMixin, RESTObject):
     _id_attr = "epic_issue_id"
     # Define type for 'manager' here So mypy won't complain about
     # 'self.manager.update()' call in the 'save' method.
-    manager: "GroupEpicIssueManager"
+    manager: GroupEpicIssueManager
 
     def save(self, **kwargs: Any) -> None:
         """Save the changes made to the object to the server.
@@ -80,7 +74,10 @@ class GroupEpicIssue(ObjectDeleteMixin, SaveMixin, RESTObject):
 
 
 class GroupEpicIssueManager(
-    ListMixin, CreateMixin, UpdateMixin, DeleteMixin, RESTManager
+    ListMixin[GroupEpicIssue],
+    CreateMixin[GroupEpicIssue],
+    UpdateMixin[GroupEpicIssue],
+    DeleteMixin[GroupEpicIssue],
 ):
     _path = "/groups/{group_id}/epics/{epic_iid}/issues"
     _obj_cls = GroupEpicIssue
@@ -90,7 +87,7 @@ class GroupEpicIssueManager(
 
     @exc.on_http_error(exc.GitlabCreateError)
     def create(
-        self, data: Optional[Dict[str, Any]] = None, **kwargs: Any
+        self, data: dict[str, Any] | None = None, **kwargs: Any
     ) -> GroupEpicIssue:
         """Create a new object.
 

gitlab/v4/objects/events.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 ListMixin, RetrieveMixin
 
 __all__ = [
@@ -36,7 +34,7 @@ class Event(RESTObject):
     _repr_attr = "target_title"
 
 
-class EventManager(ListMixin, RESTManager):
+class EventManager(ListMixin[Event]):
     _path = "/events"
     _obj_cls = Event
     _list_filters = ("action", "target_type", "before", "after", "sort", "scope")
@@ -46,18 +44,11 @@ class GroupEpicResourceLabelEvent(RESTObject):
     pass
 
 
-class GroupEpicResourceLabelEventManager(RetrieveMixin, RESTManager):
+class GroupEpicResourceLabelEventManager(RetrieveMixin[GroupEpicResourceLabelEvent]):
     _path = "/groups/{group_id}/epics/{epic_id}/resource_label_events"
     _obj_cls = GroupEpicResourceLabelEvent
     _from_parent_attrs = {"group_id": "group_id", "epic_id": "id"}
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> GroupEpicResourceLabelEvent:
-        return cast(
-            GroupEpicResourceLabelEvent, super().get(id=id, lazy=lazy, **kwargs)
-        )
-
 
 class ProjectEvent(Event):
     pass
@@ -73,140 +64,97 @@ class ProjectIssueResourceLabelEvent(RESTObject):
     pass
 
 
-class ProjectIssueResourceLabelEventManager(RetrieveMixin, RESTManager):
+class ProjectIssueResourceLabelEventManager(
+    RetrieveMixin[ProjectIssueResourceLabelEvent]
+):
     _path = "/projects/{project_id}/issues/{issue_iid}/resource_label_events"
     _obj_cls = ProjectIssueResourceLabelEvent
     _from_parent_attrs = {"project_id": "project_id", "issue_iid": "iid"}
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectIssueResourceLabelEvent:
-        return cast(
-            ProjectIssueResourceLabelEvent, super().get(id=id, lazy=lazy, **kwargs)
-        )
-
 
 class ProjectIssueResourceMilestoneEvent(RESTObject):
     pass
 
 
-class ProjectIssueResourceMilestoneEventManager(RetrieveMixin, RESTManager):
+class ProjectIssueResourceMilestoneEventManager(
+    RetrieveMixin[ProjectIssueResourceMilestoneEvent]
+):
     _path = "/projects/{project_id}/issues/{issue_iid}/resource_milestone_events"
     _obj_cls = ProjectIssueResourceMilestoneEvent
     _from_parent_attrs = {"project_id": "project_id", "issue_iid": "iid"}
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectIssueResourceMilestoneEvent:
-        return cast(
-            ProjectIssueResourceMilestoneEvent, super().get(id=id, lazy=lazy, **kwargs)
-        )
-
 
 class ProjectIssueResourceStateEvent(RESTObject):
     pass
 
 
-class ProjectIssueResourceStateEventManager(RetrieveMixin, RESTManager):
+class ProjectIssueResourceStateEventManager(
+    RetrieveMixin[ProjectIssueResourceStateEvent]
+):
     _path = "/projects/{project_id}/issues/{issue_iid}/resource_state_events"
     _obj_cls = ProjectIssueResourceStateEvent
     _from_parent_attrs = {"project_id": "project_id", "issue_iid": "iid"}
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectIssueResourceStateEvent:
-        return cast(
-            ProjectIssueResourceStateEvent, super().get(id=id, lazy=lazy, **kwargs)
-        )
-
 
 class ProjectIssueResourceIterationEvent(RESTObject):
     pass
 
 
-class ProjectIssueResourceIterationEventManager(RetrieveMixin, RESTManager):
+class ProjectIssueResourceIterationEventManager(
+    RetrieveMixin[ProjectIssueResourceIterationEvent]
+):
     _path = "/projects/{project_id}/issues/{issue_iid}/resource_iteration_events"
     _obj_cls = ProjectIssueResourceIterationEvent
     _from_parent_attrs = {"project_id": "project_id", "issue_iid": "iid"}
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectIssueResourceIterationEvent:
-        return cast(
-            ProjectIssueResourceIterationEvent, super().get(id=id, lazy=lazy, **kwargs)
-        )
-
 
 class ProjectIssueResourceWeightEvent(RESTObject):
     pass
 
 
-class ProjectIssueResourceWeightEventManager(RetrieveMixin, RESTManager):
+class ProjectIssueResourceWeightEventManager(
+    RetrieveMixin[ProjectIssueResourceWeightEvent]
+):
     _path = "/projects/{project_id}/issues/{issue_iid}/resource_weight_events"
     _obj_cls = ProjectIssueResourceWeightEvent
     _from_parent_attrs = {"project_id": "project_id", "issue_iid": "iid"}
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectIssueResourceWeightEvent:
-        return cast(
-            ProjectIssueResourceWeightEvent, super().get(id=id, lazy=lazy, **kwargs)
-        )
-
 
 class ProjectMergeRequestResourceLabelEvent(RESTObject):
     pass
 
 
-class ProjectMergeRequestResourceLabelEventManager(RetrieveMixin, RESTManager):
+class ProjectMergeRequestResourceLabelEventManager(
+    RetrieveMixin[ProjectMergeRequestResourceLabelEvent]
+):
     _path = "/projects/{project_id}/merge_requests/{mr_iid}/resource_label_events"
     _obj_cls = ProjectMergeRequestResourceLabelEvent
     _from_parent_attrs = {"project_id": "project_id", "mr_iid": "iid"}
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectMergeRequestResourceLabelEvent:
-        return cast(
-            ProjectMergeRequestResourceLabelEvent,
-            super().get(id=id, lazy=lazy, **kwargs),
-        )
-
 
 class ProjectMergeRequestResourceMilestoneEvent(RESTObject):
     pass
 
 
-class ProjectMergeRequestResourceMilestoneEventManager(RetrieveMixin, RESTManager):
+class ProjectMergeRequestResourceMilestoneEventManager(
+    RetrieveMixin[ProjectMergeRequestResourceMilestoneEvent]
+):
     _path = "/projects/{project_id}/merge_requests/{mr_iid}/resource_milestone_events"
     _obj_cls = ProjectMergeRequestResourceMilestoneEvent
     _from_parent_attrs = {"project_id": "project_id", "mr_iid": "iid"}
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectMergeRequestResourceMilestoneEvent:
-        return cast(
-            ProjectMergeRequestResourceMilestoneEvent,
-            super().get(id=id, lazy=lazy, **kwargs),
-        )
-
 
 class ProjectMergeRequestResourceStateEvent(RESTObject):
     pass
 
 
-class ProjectMergeRequestResourceStateEventManager(RetrieveMixin, RESTManager):
+class ProjectMergeRequestResourceStateEventManager(
+    RetrieveMixin[ProjectMergeRequestResourceStateEvent]
+):
     _path = "/projects/{project_id}/merge_requests/{mr_iid}/resource_state_events"
     _obj_cls = ProjectMergeRequestResourceStateEvent
     _from_parent_attrs = {"project_id": "project_id", "mr_iid": "iid"}
 
-    def get(
-        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
-    ) -> ProjectMergeRequestResourceStateEvent:
-        return cast(
-            ProjectMergeRequestResourceStateEvent,
-            super().get(id=id, lazy=lazy, **kwargs),
-        )
-
 
 class UserEvent(Event):
     pass

gitlab/v4/objects/export_import.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 CreateMixin, DownloadMixin, GetWithoutIdMixin, RefreshMixin
 from gitlab.types import RequiredOptional
 
@@ -20,50 +18,40 @@ class GroupExport(DownloadMixin, RESTObject):
     _id_attr = None
 
 
-class GroupExportManager(GetWithoutIdMixin, CreateMixin, RESTManager):
+class GroupExportManager(GetWithoutIdMixin[GroupExport], CreateMixin[GroupExport]):
     _path = "/groups/{group_id}/export"
     _obj_cls = GroupExport
     _from_parent_attrs = {"group_id": "id"}
 
-    def get(self, **kwargs: Any) -> GroupExport:
-        return cast(GroupExport, super().get(**kwargs))
-
 
 class GroupImport(RESTObject):
     _id_attr = None
 
 
-class GroupImportManager(GetWithoutIdMixin, RESTManager):
+class GroupImportManager(GetWithoutIdMixin[GroupImport]):
     _path = "/groups/{group_id}/import"
     _obj_cls = GroupImport
     _from_parent_attrs = {"group_id": "id"}
 
-    def get(self, **kwargs: Any) -> GroupImport:
-        return cast(GroupImport, super().get(**kwargs))
-
 
 class ProjectExport(DownloadMixin, RefreshMixin, RESTObject):
     _id_attr = None
 
 
-class ProjectExportManager(GetWithoutIdMixin, CreateMixin, RESTManager):
+class ProjectExportManager(
+    GetWithoutIdMixin[ProjectExport], CreateMixin[ProjectExport]
+):
     _path = "/projects/{project_id}/export"
     _obj_cls = ProjectExport
     _from_parent_attrs = {"project_id": "id"}
     _create_attrs = RequiredOptional(optional=("description",))
 
-    def get(self, **kwargs: Any) -> ProjectExport:
-        return cast(ProjectExport, super().get(**kwargs))
-
 
 class ProjectImport(RefreshMixin, RESTObject):
     _id_attr = None
 
 
-class ProjectImportManager(GetWithoutIdMixin, RESTManager):
+class ProjectImportManager(GetWithoutIdMixin[ProjectImport]):
     _path = "/projects/{project_id}/import"
     _obj_cls = ProjectImport
     _from_parent_attrs = {"project_id": "id"}
-
-    def get(self, **kwargs: Any) -> ProjectImport:
-        return cast(ProjectImport, super().get(**kwargs))

gitlab/v4/objects/features.py

@@ -3,24 +3,23 @@ GitLab API:
 https://docs.gitlab.com/ee/api/features.html
 """
 
-from typing import Any, Optional, TYPE_CHECKING, Union
+from __future__ import annotations
+
+from typing import Any, TYPE_CHECKING
 
 from gitlab import exceptions as exc
 from gitlab import utils
-from gitlab.base import RESTManager, RESTObject
+from gitlab.base import RESTObject
 from gitlab.mixins import DeleteMixin, ListMixin, ObjectDeleteMixin
 
-__all__ = [
-    "Feature",
-    "FeatureManager",
-]
+__all__ = ["Feature", "FeatureManager"]
 
 
 class Feature(ObjectDeleteMixin, RESTObject):
     _id_attr = "name"
 
 
-class FeatureManager(ListMixin, DeleteMixin, RESTManager):
+class FeatureManager(ListMixin[Feature], DeleteMixin[Feature]):
     _path = "/features/"
     _obj_cls = Feature
 
@@ -28,11 +27,11 @@ class FeatureManager(ListMixin, DeleteMixin, RESTManager):
     def set(
         self,
         name: str,
-        value: Union[bool, int],
-        feature_group: Optional[str] = None,
-        user: Optional[str] = None,
-        group: Optional[str] = None,
-        project: Optional[str] = None,
+        value: bool | int,
+        feature_group: str | None = None,
+        user: str | None = None,
+        group: str | None = None,
+        project: str | None = None,
         **kwargs: Any,
     ) -> Feature:
         """Create or update the object.

gitlab/v4/objects/files.py

@@ -1,24 +1,14 @@
+from __future__ import annotations
+
 import base64
-from typing import (
-    Any,
-    Callable,
-    Dict,
-    Iterator,
-    List,
-    Literal,
-    Optional,
-    overload,
-    Tuple,
-    TYPE_CHECKING,
-    Union,
-)
+from typing import Any, Callable, Iterator, Literal, overload, TYPE_CHECKING
 
 import requests
 
 from gitlab import cli
 from gitlab import exceptions as exc
 from gitlab import utils
-from gitlab.base import RESTManager, RESTObject
+from gitlab.base import RESTObject
 from gitlab.mixins import (
     CreateMixin,
     DeleteMixin,
@@ -28,10 +18,7 @@ from gitlab.mixins import (
 )
 from gitlab.types import RequiredOptional
 
-__all__ = [
-    "ProjectFile",
-    "ProjectFileManager",
-]
+__all__ = ["ProjectFile", "ProjectFileManager"]
 
 
 class ProjectFile(SaveMixin, ObjectDeleteMixin, RESTObject):
@@ -40,7 +27,7 @@ class ProjectFile(SaveMixin, ObjectDeleteMixin, RESTObject):
     branch: str
     commit_message: str
     file_path: str
-    manager: "ProjectFileManager"
+    manager: ProjectFileManager
     content: str  # since the `decode()` method uses `self.content`
 
     def decode(self) -> bytes:
@@ -97,11 +84,13 @@ class ProjectFile(SaveMixin, ObjectDeleteMixin, RESTObject):
         self.manager.delete(file_path, branch, commit_message, **kwargs)
 
 
-class ProjectFileManager(CreateMixin, UpdateMixin, DeleteMixin, RESTManager):
+class ProjectFileManager(
+    CreateMixin[ProjectFile], UpdateMixin[ProjectFile], DeleteMixin[ProjectFile]
+):
     _path = "/projects/{project_id}/repository/files"
     _obj_cls = ProjectFile
     _from_parent_attrs = {"project_id": "id"}
-    _optional_get_attrs: Tuple[str, ...] = ()
+    _optional_get_attrs: tuple[str, ...] = ()
     _create_attrs = RequiredOptional(
         required=("file_path", "branch", "content", "commit_message"),
         optional=(
@@ -155,7 +144,7 @@ class ProjectFileManager(CreateMixin, UpdateMixin, DeleteMixin, RESTManager):
     @exc.on_http_error(exc.GitlabHeadError)
     def head(
         self, file_path: str, ref: str, **kwargs: Any
-    ) -> "requests.structures.CaseInsensitiveDict[Any]":
+    ) -> requests.structures.CaseInsensitiveDict[Any]:
         """Retrieve just metadata for a single file.
 
         Args:
@@ -188,9 +177,7 @@ class ProjectFileManager(CreateMixin, UpdateMixin, DeleteMixin, RESTManager):
         ),
     )
     @exc.on_http_error(exc.GitlabCreateError)
-    def create(
-        self, data: Optional[Dict[str, Any]] = None, **kwargs: Any
-    ) -> ProjectFile:
+    def create(self, data: dict[str, Any] | None = None, **kwargs: Any) -> ProjectFile:
         """Create a new object.
 
         Args:
@@ -222,8 +209,8 @@ class ProjectFileManager(CreateMixin, UpdateMixin, DeleteMixin, RESTManager):
     # NOTE(jlvillal): Signature doesn't match UpdateMixin.update() so ignore
     # type error
     def update(  # type: ignore[override]
-        self, file_path: str, new_data: Optional[Dict[str, Any]] = None, **kwargs: Any
-    ) -> Dict[str, Any]:
+        self, file_path: str, new_data: dict[str, Any] | None = None, **kwargs: Any
+    ) -> dict[str, Any]:
         """Update an object on the server.
 
         Args:
@@ -280,7 +267,7 @@ class ProjectFileManager(CreateMixin, UpdateMixin, DeleteMixin, RESTManager):
     def raw(
         self,
         file_path: str,
-        ref: Optional[str] = None,
+        ref: str | None = None,
         streamed: Literal[False] = False,
         action: None = None,
         chunk_size: int = 1024,
@@ -293,7 +280,7 @@ class ProjectFileManager(CreateMixin, UpdateMixin, DeleteMixin, RESTManager):
     def raw(
         self,
         file_path: str,
-        ref: Optional[str] = None,
+        ref: str | None = None,
         streamed: bool = False,
         action: None = None,
         chunk_size: int = 1024,
@@ -306,9 +293,9 @@ class ProjectFileManager(CreateMixin, UpdateMixin, DeleteMixin, RESTManager):
     def raw(
         self,
         file_path: str,
-        ref: Optional[str] = None,
+        ref: str | None = None,
         streamed: Literal[True] = True,
-        action: Optional[Callable[[bytes], Any]] = None,
+        action: Callable[[bytes], Any] | None = None,
         chunk_size: int = 1024,
         *,
         iterator: Literal[False] = False,
@@ -316,22 +303,20 @@ class ProjectFileManager(CreateMixin, UpdateMixin, DeleteMixin, RESTManager):
     ) -> None: ...
 
     @cli.register_custom_action(
-        cls_names="ProjectFileManager",
-        required=("file_path",),
-        optional=("ref",),
+        cls_names="ProjectFileManager", required=("file_path",), optional=("ref",)
     )
     @exc.on_http_error(exc.GitlabGetError)
     def raw(
         self,
         file_path: str,
-        ref: Optional[str] = None,
+        ref: str | None = None,
         streamed: bool = False,
-        action: Optional[Callable[..., Any]] = None,
+        action: Callable[..., Any] | None = None,
         chunk_size: int = 1024,
         *,
         iterator: bool = False,
         **kwargs: Any,
-    ) -> Optional[Union[bytes, Iterator[Any]]]:
+    ) -> bytes | Iterator[Any] | None:
         """Return the content of a file for a commit.
 
         Args:
@@ -373,7 +358,7 @@ class ProjectFileManager(CreateMixin, UpdateMixin, DeleteMixin, RESTManager):
         cls_names="ProjectFileManager", required=("file_path", "ref")
     )
     @exc.on_http_error(exc.GitlabListError)
-    def blame(self, file_path: str, ref: str, **kwargs: Any) -> List[Dict[str, Any]]:
+    def blame(self, file_path: str, ref: str, **kwargs: Any) -> list[dict[str, Any]]:
         """Return the content of a file for a commit.
 
         Args: