fix docstrings

pipestat/backends/abstract.py

@@ -191,6 +191,14 @@ def retrieve_multiple(
         limit: Optional[int] = 1000,
         offset: Optional[int] = 0,
     ) -> Union[Any, Dict[str, Any]]:
+        """
+        :param List[str] record_identifier: list of record identifiers
+        :param List[str] result_identifier: list of result identifiers to be retrieved
+        :param int limit: limit number of records to this amount
+        :param int offset: offset records by this amount
+        :return Dict[str, any]: a mapping with filtered results reported for the record
+        """
+
         _LOGGER.warning("Not implemented yet for this backend")
         pass
 

pipestat/backends/dbbackend.py

@@ -508,6 +508,14 @@ def retrieve_multiple(
         limit: Optional[int] = 1000,
         offset: Optional[int] = 0,
     ) -> Union[Any, Dict[str, Any]]:
+        """
+        :param List[str] record_identifier: list of record identifiers
+        :param List[str] result_identifier: list of result identifiers to be retrieved
+        :param int limit: limit number of records to this amount
+        :param int offset: offset records by this amount
+        :return Dict[str, any]: a mapping with filtered results reported for the record
+        """
+
         record_list = []
 
         if result_identifier == []:

pipestat/backends/filebackend.py

@@ -462,6 +462,14 @@ def retrieve_multiple(
         limit: Optional[int] = 1000,
         offset: Optional[int] = 0,
     ) -> Union[Any, Dict[str, Any]]:
+        """
+        :param List[str] record_identifier: list of record identifiers
+        :param List[str] result_identifier: list of result identifiers to be retrieved
+        :param int limit: limit number of records to this amount
+        :param int offset: offset records by this amount
+        :return Dict[str, any]: a mapping with filtered results reported for the record
+        """
+
         record_list = []
 
         if result_identifier == []:

pipestat/pipestat.py

@@ -497,8 +497,8 @@ def retrieve_distinct(
     @require_backend
     def retrieve(
         self,
-        record_identifier: Optional[str] = None,
-        result_identifier: Optional[str] = None,
+        record_identifier: Optional[Union[str, List[str]]] = None,
+        result_identifier: Optional[Union[str, List[str]]] = None,
         limit: Optional[int] = 1000,
         offset: Optional[int] = 0,
     ) -> Union[Any, Dict[str, Any]]:
@@ -508,11 +508,11 @@ def retrieve(
         If no result ID specified, results for the entire record will
         be returned.
 
-        :param str record_identifier: name of the sample_level record
-        :param str result_identifier: name of the result to be retrieved
+        :param str | List[str] record_identifier: name of the sample_level record
+        :param str | List[str] result_identifier: name of the result to be retrieved
         :param int limit: limit number of records to this amount
         :param int offset: offset records by this amount
-        :return any | Dict[str, any]: a single result or a mapping with all the
+        :return any | Dict[str, any]: a single result or a mapping with filtered
             results reported for the record
         """
         if record_identifier is None and result_identifier is None: