kernelci.build: get data for checkout fields

Add methods to get git commit tags, git commit
message, and if the commit is at tip of the branch
for checkout node.

Signed-off-by: Jeny Sadadia <[email protected]>

kernelci/build.py

@@ -222,6 +222,56 @@ def git_describe_verbose(path):
     return describe.strip()
 
 
+def git_commit_tags(path, commit):
+    """Get the git tags
+
+    *path* is the path to the local git repository
+    *commit* is the current checked out commit
+
+    Returns list of associated git tags if exist otherwise an
+    empty list.
+    """
+    cmd = r"""
+set -e
+cd {path}
+git tag --points-at {commit}
+""".format(path=path, commit=commit)
+    tags = shell_cmd(cmd)
+    return tags if tags else []
+
+
+def git_commit_message(path, commit):
+    """Get the git commit message
+
+    *path* is the path to the local git repository
+    *commit* is the current checked out commit
+
+    Returns the git commit message consists of subject and body.
+    """
+    cmd = r"""
+set -e
+cd {path}
+git show -s --format=%B {commit}
+""".format(path=path, commit=commit)
+    message = shell_cmd(cmd)
+    return message.strip()
+
+
+def git_branch_tip(path, commit):
+    """Get the git commit message
+
+    *path* is the path to the local git repository
+    *commit* is the current checked out commit
+
+    Returns `True`, when the commit being checked out is at the tip of
+    the branch at the moment of the checkout, otherwise `False`
+    """
+    hc = head_commit(path)
+    if hc == commit:
+        return True
+    return False
+
+
 def make_tarball(kdir, tarball_name):
     """Make a kernel source tarball