week06

env/lib/python3.12/site-packages/gitlab/v4/objects/discussions.py

@@ -0,0 +1,94 @@
+from typing import Any, cast, Union
+
+from gitlab.base import RESTManager, RESTObject
+from gitlab.mixins import CreateMixin, RetrieveMixin, SaveMixin, UpdateMixin
+from gitlab.types import RequiredOptional
+
+from .notes import (  # noqa: F401
+    ProjectCommitDiscussionNoteManager,
+    ProjectIssueDiscussionNoteManager,
+    ProjectMergeRequestDiscussionNoteManager,
+    ProjectSnippetDiscussionNoteManager,
+)
+
+__all__ = [
+    "ProjectCommitDiscussion",
+    "ProjectCommitDiscussionManager",
+    "ProjectIssueDiscussion",
+    "ProjectIssueDiscussionManager",
+    "ProjectMergeRequestDiscussion",
+    "ProjectMergeRequestDiscussionManager",
+    "ProjectSnippetDiscussion",
+    "ProjectSnippetDiscussionManager",
+]
+
+
+class ProjectCommitDiscussion(RESTObject):
+    notes: ProjectCommitDiscussionNoteManager
+
+
+class ProjectCommitDiscussionManager(RetrieveMixin, CreateMixin, RESTManager):
+    _path = "/projects/{project_id}/repository/commits/{commit_id}/discussions"
+    _obj_cls = ProjectCommitDiscussion
+    _from_parent_attrs = {"project_id": "project_id", "commit_id": "id"}
+    _create_attrs = RequiredOptional(required=("body",), optional=("created_at",))
+
+    def get(
+        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
+    ) -> ProjectCommitDiscussion:
+        return cast(ProjectCommitDiscussion, super().get(id=id, lazy=lazy, **kwargs))
+
+
+class ProjectIssueDiscussion(RESTObject):
+    notes: ProjectIssueDiscussionNoteManager
+
+
+class ProjectIssueDiscussionManager(RetrieveMixin, CreateMixin, RESTManager):
+    _path = "/projects/{project_id}/issues/{issue_iid}/discussions"
+    _obj_cls = ProjectIssueDiscussion
+    _from_parent_attrs = {"project_id": "project_id", "issue_iid": "iid"}
+    _create_attrs = RequiredOptional(required=("body",), optional=("created_at",))
+
+    def get(
+        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
+    ) -> ProjectIssueDiscussion:
+        return cast(ProjectIssueDiscussion, super().get(id=id, lazy=lazy, **kwargs))
+
+
+class ProjectMergeRequestDiscussion(SaveMixin, RESTObject):
+    notes: ProjectMergeRequestDiscussionNoteManager
+
+
+class ProjectMergeRequestDiscussionManager(
+    RetrieveMixin, CreateMixin, UpdateMixin, RESTManager
+):
+    _path = "/projects/{project_id}/merge_requests/{mr_iid}/discussions"
+    _obj_cls = ProjectMergeRequestDiscussion
+    _from_parent_attrs = {"project_id": "project_id", "mr_iid": "iid"}
+    _create_attrs = RequiredOptional(
+        required=("body",), optional=("created_at", "position")
+    )
+    _update_attrs = RequiredOptional(required=("resolved",))
+
+    def get(
+        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
+    ) -> ProjectMergeRequestDiscussion:
+        return cast(
+            ProjectMergeRequestDiscussion, super().get(id=id, lazy=lazy, **kwargs)
+        )
+
+
+class ProjectSnippetDiscussion(RESTObject):
+    notes: ProjectSnippetDiscussionNoteManager
+
+
+class ProjectSnippetDiscussionManager(RetrieveMixin, CreateMixin, RESTManager):
+    _path = "/projects/{project_id}/snippets/{snippet_id}/discussions"
+    _obj_cls = ProjectSnippetDiscussion
+    _from_parent_attrs = {"project_id": "project_id", "snippet_id": "id"}
+    _create_attrs = RequiredOptional(required=("body",), optional=("created_at",))
+
+    def get(
+        self, id: Union[str, int], lazy: bool = False, **kwargs: Any
+    ) -> ProjectSnippetDiscussion:
+        return cast(ProjectSnippetDiscussion, super().get(id=id, lazy=lazy, **kwargs))