add reviews to submission queries, add SubmissionReview class

Author: fitzworkhub

indico/queries/submission.py

@@ -62,6 +62,15 @@ class ListSubmissions(PagedRequest):
                     deleted
                     retrieved
                     errors
+                    reviews {
+                        id
+                        createdAt
+                        createdBy
+                        completedAt
+                        rejected
+                        reviewType
+                        notes
+                    }
                 }
                 pageInfo {
                     endCursor
@@ -124,6 +133,15 @@ class GetSubmission(GraphQLRequest):
                 retrieved
                 deleted
                 errors
+                reviews {
+                    id
+                    createdAt
+                    createdBy
+                    completedAt
+                    rejected
+                    reviewType
+                    notes
+                }
             }
         }
     """
@@ -158,6 +176,15 @@ class WaitForSubmissions(RequestChain):
                     retrieved
                     deleted
                     errors
+                    reviews {
+                        id
+                        createdAt
+                        createdBy
+                        completedAt
+                        rejected
+                        reviewType
+                        notes
+                    }
                 }
             }
         }

indico/types/submission.py

@@ -10,6 +10,11 @@
     "PENDING_AUTO_REVIEW",
 ]
 
+VALID_REVIEW_TYPES = [
+    "MANUAL",
+    "AUTO",
+    "ADMIN",
+]
 
 SUBMISSION_RESULT_VERSIONS = ["ONE", "TWO", "THREE", "OLDEST_SUPPORTED", "LATEST"]
 
@@ -32,6 +37,29 @@ class SubmissionRetries(BaseType):
     submission_id: int
 
 
+class SubmissionReviews(BaseType):
+    f"""
+    Information about a submissions Reviews.
+
+    Attributes:
+        id (int): The ID of the review.
+        submission_id (int): The ID of the submission that is being reviewed.
+        created_at (str): Timestamp of when the document was checked out
+        created_by (int): The ID of the User who submitted the review.
+        completed_at (str): Timestamp of when the review was submitted.
+        rejected (bool): Whether a submission has been rejected.
+        review_type (str): Type of review. One of {VALID_REVIEW_TYPES}
+        notes (str): Rejection reasons provided by user.
+    """
+    id: int
+    submission_id: int
+    created_at: str
+    created_by: int
+    completed_at: str
+    rejected: bool
+    review_type: str
+    notes: str
+
 class Submission(BaseType):
     f"""
     A Submission in the Indico Platform.
@@ -71,3 +99,4 @@ class Submission(BaseType):
     deleted: bool
     errors: str
     retries: List[SubmissionRetries]
+    reviews: List[SubmissionReviews]