Merge pull request #20 from alyssacgoins/py-script

Add python script.

Author: alyssacgoins

.github/scripts/verify-linked-issue.py

@@ -0,0 +1,63 @@
+#!/usr/bin/env python3
+import os
+import re
+import sys
+
+from github import Auth, Github
+
+# removes hidden section of PR body.
+def clean_pr_body(body: str) -> str:
+    if not body:
+        return ""
+    clean_text = re.sub(r'<!--.*?-->', '', body, flags=re.DOTALL)
+    return clean_text.strip()
+
+
+def main() -> int:
+    # Retrieve env vars provided by GH Action workflow
+    token = os.getenv("GITHUB_TOKEN")
+    pr_num = int(os.getenv("PR_NUMBER"))
+    #todo: this var necessary for testing purposes and can utlimately be removed.
+    repo_name = os.getenv("GITHUB_REPOSITORY")
+    print(f"Verifying linked issues for PR #{pr_num} in {repo_name}")
+
+    g = Github(auth=Auth.Token(token))
+    repo = g.get_repo(repo_name)
+    pr = repo.get_pull(pr_num)
+
+    # 1. Parse PR body for linked issues (e.g., #123 or Fixes #123)
+    pr_body_original = pr.body or ""
+    pr_body = clean_pr_body(pr_body_original)
+
+    issue_numbers = re.findall(r"(?:#|issues\/)(\d+)", pr_body)
+    print(f"Found issue numbers: {issue_numbers}")
+
+    if not issue_numbers:
+        print('ERROR: No linked issues found in the PR description.')
+        return 1
+
+    #2: Check each linked issue for the "ready" command.
+    # If there is more than one issue linked, each issue must be marked /ready
+    found_ready = False
+    for issue_num in issue_numbers:
+        issue = repo.get_issue(int(issue_num))
+        comments = issue.get_comments()
+
+        # Check if the issue contains a comment with /ready command
+        for comment in comments:
+            if "/ready" in comment.body:
+                print(f"Found '/ready' command in issue #{issue_num}")
+                found_ready = True
+                break
+        #todo: is there ever a case in which "/ready" is canceled out by a later comment? (ie do not exit here)
+        if found_ready: break
+
+    if not found_ready:
+        print("ERROR: The linked issue(s) must have a '/ready' command.")
+        return 1
+
+    print(f'Successfully verified linked issues: {issue_numbers}')
+    return 0
+
+if __name__ == "__main__":
+    sys.exit(main())