Add type annotations for fields. Add single field (str) as option to fields parameter.

Author: fkdosilovic

src/judge0/clients.py

@@ -1,3 +1,5 @@
+from typing import Iterable, Union
+
 import requests
 
 from .submission import Submission
@@ -76,15 +78,25 @@ def create_submission(self, submission: Submission) -> None:
 
         submission.set_attributes(resp.json())
 
-    def get_submission(self, submission: Submission, *, fields=None) -> None:
+    def get_submission(
+        self,
+        submission: Submission,
+        *,
+        fields: Union[str, Iterable[str], None] = None,
+    ) -> None:
         """Check the submission status."""
 
         params = {
             "base64_encoded": "true",
         }
 
+        if isinstance(fields, str):
+            fields = [fields]
+
         if fields is not None:
             params["fields"] = ",".join(fields)
+        else:
+            params["fields"] = "*"
 
         resp = requests.get(
             f"{self.endpoint}/submissions/{submission.token}",
@@ -117,15 +129,25 @@ def create_submissions(self, submissions: list[Submission]) -> None:
         for submission, attrs in zip(submissions, resp.json()):
             submission.set_attributes(attrs)
 
-    def get_submissions(self, submissions: list[Submission], *, fields=None) -> None:
+    def get_submissions(
+        self,
+        submissions: list[Submission],
+        *,
+        fields: Union[str, Iterable[str], None] = None,
+    ) -> None:
         params = {
             "base64_encoded": "true",
         }
 
+        if isinstance(fields, str):
+            fields = [fields]
+
         if fields is not None:
             params["fields"] = ",".join(fields)
+        else:
+            params["fields"] = "*"
 
-        tokens = ",".join((submission.token for submission in submissions))
+        tokens = ",".join(submission.token for submission in submissions)
         params["tokens"] = tokens
 
         resp = requests.get(
@@ -199,15 +221,25 @@ def create_submission(self, submission: Submission) -> None:
         self._update_endpoint_header(self.DEFAULT_CREATE_SUBMISSION_ENDPOINT)
         return super().create_submission(submission)
 
-    def get_submission(self, submission: Submission, *, fields=None) -> None:
+    def get_submission(
+        self,
+        submission: Submission,
+        *,
+        fields: Union[str, Iterable[str], None] = None,
+    ) -> None:
         self._update_endpoint_header(self.DEFAULT_GET_SUBMISSION_ENDPOINT)
         return super().get_submission(submission, fields=fields)
 
     def create_submissions(self, submissions: list[Submission]) -> None:
         self._update_endpoint_header(self.DEFAULT_CREATE_SUBMISSIONS_ENDPOINT)
         return super().create_submissions(submissions)
 
-    def get_submissions(self, submissions: list[Submission], *, fields=None) -> None:
+    def get_submissions(
+        self,
+        submissions: list[Submission],
+        *,
+        fields: Union[str, Iterable[str], None] = None,
+    ) -> None:
         self._update_endpoint_header(self.DEFAULT_GET_SUBMISSIONS_ENDPOINT)
         return super().get_submissions(submissions, fields=fields)
 
@@ -257,17 +289,27 @@ def create_submission(self, submission: Submission):
         self._update_endpoint_header(self.DEFAULT_CREATE_SUBMISSION_ENDPOINT)
         return super().create_submission(submission)
 
-    def get_submission(self, submission: Submission, *, fields=None):
+    def get_submission(
+        self,
+        submission: Submission,
+        *,
+        fields: Union[str, Iterable[str], None] = None,
+    ):
         self._update_endpoint_header(self.DEFAULT_GET_SUBMISSION_ENDPOINT)
         return super().get_submission(submission, fields=fields)
 
-    def create_submissions(self, submission: list[Submission]) -> None:
+    def create_submissions(self, submissions: list[Submission]) -> None:
         self._update_endpoint_header(self.DEFAULT_CREATE_SUBMISSIONS_ENDPOINT)
-        return super().create_submissions(submission)
+        return super().create_submissions(submissions)
 
-    def get_submissions(self, submission: list[Submission], *, fields=None) -> None:
+    def get_submissions(
+        self,
+        submissions: list[Submission],
+        *,
+        fields: Union[str, Iterable[str], None] = None,
+    ) -> None:
         self._update_endpoint_header(self.DEFAULT_GET_SUBMISSIONS_ENDPOINT)
-        return super().get_submissions(submission, fields=fields)
+        return super().get_submissions(submissions, fields=fields)
 
 
 class Rapid(Client):

src/judge0/submission.py

@@ -117,7 +117,7 @@ def __init__(
         self.status = None
         self.created_at = None
         self.finished_at = None
-        self.token = None
+        self.token = ""
         self.time = None
         self.wall_time = None
         self.memory = None