Merge pull request #1101 from tsutterley/granule_name

Allow `granule_name` to be `Iterable[str]`

Author: chuckwondo

earthaccess/search.py

@@ -5,6 +5,7 @@
 import requests
 from typing_extensions import (
     Any,
+    Iterable,
     List,
     Optional,
     Self,
@@ -625,7 +626,7 @@ def cloud_hosted(self, cloud_hosted: bool = True) -> Self:
                 self.params["provider"] = provider
         return self
 
-    def granule_name(self, granule_name: str) -> Self:
+    def granule_name(self, granule_name: str | Iterable[str]) -> Self:
         """Find granules matching either granule ur or producer granule id,
         queries using the readable_granule_name metadata field.
 
@@ -640,10 +641,17 @@ def granule_name(self, granule_name: str) -> Self:
             self
 
         Raises:
-            TypeError: if `granule_name` is not of type `str`
+            TypeError: if `granule_name` is not of type `str` or `Iterable[str]`.
         """
+        if not isinstance(granule_name, Iterable):
+            raise TypeError(
+                "granule_name must be of type string or Iterable of strings"
+            )
         if not isinstance(granule_name, str):
-            raise TypeError("granule_name must be of type string")
+            # Convert iterable to list of strings. Since str is also Iterable, make
+            # sure we don't do this when granule_name is a string, otherwise
+            # we would get a list of individual characters.
+            granule_name = [str(name) for name in granule_name]
 
         self.params["readable_granule_name"] = granule_name
         self.params["options[readable_granule_name][pattern]"] = True