pr comments

Author: jacobmanderson

indico/client/client.py

@@ -82,16 +82,20 @@ def call(self, request: Union[HTTPRequest, RequestChain]):
 
     def call_concurrent(self, requests: list[HTTPRequest]) -> list[dict]:
         """
-        Make batched calls to Indico IPA Platform with thread pool.
+            Make batched calls to Indico IPA Platform with thread pool.
 
-        Args:
-            request (GraphQLRequest or RequestChain): GraphQL request to send to the Indico Platform
+            Args:
+                request (GraphQLRequest or RequestChain): GraphQL request to send to the Indico Platform
 
-        Returns:
-            Response appropriate to the class of the provided request parameter. Often JSON but not always.
+            Returns:
+                Response appropriate to the class of the provided request parameter. Often JSON but not always.
 
-        Raises:
-            IndicoRequestError: With errors in processing the request
+            Raises:
+                IndicoRequestError: With errors in processing the request
+
+            Example: uploaded_files = client.call_concurrent(
+            [UploadSigned(f) for f in dataset_filepaths]
+        )
         """
         data: list[dict] = []
         with THREAD_POOL as executor:

indico/queries/storage.py

@@ -188,7 +188,7 @@ class GetUploadURL(GraphQLRequest):
     def __init__(self):
         super().__init__(self.query)
 
-    def process_response(self, response: dict) -> dict:
+    def process_response(self, response: dict) -> dict[str, str]:
         response = super().process_response(response)
 
         return {
@@ -228,7 +228,7 @@ class UploadSigned(RequestChain):
     def __init__(self, file: str):
         self.file = file
 
-    def requests(self) -> list[dict]:
+    def requests(self) -> list[dict[str, dict]]:
         self.result: dict = {}
         yield GetUploadURL()