Add GitCommit and Commit changes abstracts

Signed-off-by: Cristian Le <git@lecris.dev>

Author: LecrisUT

ogr/abstract.py

@@ -648,6 +648,11 @@ def labels(self) -> Union[list["PRLabel"], Iterable["PRLabel"]]:
         """Labels of the pull request."""
         raise NotImplementedError()
 
+    @property
+    def changes(self) -> "PullRequestChanges":
+        """Commit-like change information."""
+        raise NotImplementedError()
+
     @property
     def diff_url(self) -> str:
         """Web URL to the diff of the pull request."""
@@ -1097,6 +1102,89 @@ def __str__(self) -> str:
         )
 
 
+class CommitLikeChanges(OgrAbstractClass):
+    """
+    Class representing a commit-like changes.
+
+    Can be from a single commit or aggregated like from a PR.
+    """
+
+    @property
+    def parent(self) -> Union["GitCommit", "PullRequest"]:
+        """Parent object containing the changes."""
+        raise NotImplementedError
+
+    @property
+    def files(self) -> Union[list[str], Iterable[str]]:
+        """Files changed by the current change."""
+        raise NotImplementedError
+
+    @property
+    def patch(self) -> bytes:
+        """Patch of the changes."""
+        raise NotImplementedError
+
+    @property
+    def diff_url(self) -> str:
+        """Web URL to the diff of the pull request."""
+        raise NotImplementedError()
+
+
+class CommitChanges(CommitLikeChanges):
+    """
+    Class representing a Commit's change
+
+    Attributes:
+        commit (GitCommit): Parent commit.
+    """
+
+    def __init__(self, commit: "GitCommit") -> None:
+        self.commit = commit
+
+    @property
+    def parent(self) -> "GitCommit":
+        return self.commit
+
+
+class PullRequestChanges(CommitLikeChanges):
+    """
+    Class representing a PullRequest's changes
+
+    Attributes:
+        pull_request (PullRequest): Parent pull request.
+    """
+
+    def __init__(self, pull_request: "PullRequest") -> None:
+        self.pull_request = pull_request
+
+    @property
+    def parent(self) -> "PullRequest":
+        return self.pull_request
+
+
+class GitCommit(OgrAbstractClass):
+    """
+    Class representing a git commit
+
+    Attributes:
+        project (GitProject): Git project where the commit belongs to.
+    """
+
+    def __init__(self, raw_commit: Any, project: "GitProject") -> None:
+        self._raw_commit = raw_commit
+        self.project = project
+
+    @property
+    def sha(self) -> str:
+        """Commit hash."""
+        raise NotImplementedError
+
+    @property
+    def changes(self) -> "CommitChanges":
+        """Commit change information."""
+        raise NotImplementedError()
+
+
 class GitTag(OgrAbstractClass):
     """
     Class representing a git tag.
@@ -1514,6 +1602,16 @@ def default_branch(self) -> str:
         """Default branch (usually `main`, `master` or `trunk`)."""
         raise NotImplementedError()
 
+    def get_commit(self, sha: str) -> "GitCommit":
+        """
+        Get a specific commit information.
+
+        Args:
+            sha: Specific sha of the commit
+
+        """
+        raise NotImplementedError()
+
     def get_commits(self, ref: Optional[str] = None) -> Union[list[str], Iterable[str]]:
         """
         Get list of commits for the project.

ogr/services/base.py

@@ -9,6 +9,7 @@
 from ogr.abstract import (
     CommitFlag,
     CommitStatus,
+    GitCommit,
     GitProject,
     GitService,
     GitUser,
@@ -86,6 +87,10 @@ def get_statuses(self) -> Union[list[CommitFlag], Iterable[CommitFlag]]:
         return self.target_project.get_commit_statuses(commit)
 
 
+class BaseGitCommit(GitCommit):
+    pass
+
+
 class BaseGitUser(GitUser):
     pass