Update q param to take list of str (#85)

* Update client and utils so q can take list of strings

* Bump version

* Update error strings

Author: jonnymaserati

newsapi/newsapi_client.py

@@ -5,7 +5,9 @@
 from newsapi import const
 from newsapi.newsapi_auth import NewsApiAuth
 from newsapi.newsapi_exception import NewsAPIException
-from newsapi.utils import is_valid_string, stringify_date_param
+from newsapi.utils import (
+    is_valid_string, is_valid_string_or_list, stringify_date_param
+)
 
 
 class NewsApiClient(object):
@@ -88,10 +90,10 @@ def get_top_headlines(  # noqa: C901
 
         # Keyword/Phrase
         if q is not None:
-            if is_valid_string(q):
+            if is_valid_string_or_list(q):
                 payload["q"] = q
             else:
-                raise TypeError("keyword/phrase q param should be of type str")
+                raise TypeError("keyword/phrase q param should be of type str or list of type str")
 
         # Keyword/Phrase in Title
         if qintitle is not None:
@@ -246,10 +248,10 @@ def get_everything(  # noqa: C901
 
         # Keyword/Phrase
         if q is not None:
-            if is_valid_string(q):
+            if is_valid_string_or_list(q):
                 payload["q"] = q
             else:
-                raise TypeError("keyword/phrase q param should be of type str")
+                raise TypeError("keyword/phrase q param should be of type str or list of type str")
 
         # Keyword/Phrase in Title
         if qintitle is not None:

newsapi/utils.py

@@ -54,6 +54,13 @@ def validate_datetime_str(datetimestr):
 
 if PY3:
 
+    def is_valid_string_or_list(var):
+        if isinstance(var, list):
+            return all((is_valid_string(item) for item in var))
+
+        else:
+            return is_valid_string(var)
+
     def is_valid_string(var):
         return isinstance(var, str)
 
@@ -63,6 +70,13 @@ def is_valid_num(var):
 
 elif PY2:
 
+    def is_valid_string_or_list(var):
+        if isinstance(var, list):
+            return all((is_valid_string(item) for item in var))
+
+        else:
+            return is_valid_string(var)
+
     def is_valid_string(var):
         return isinstance(var, basestring)  # noqa
 

setup.py

@@ -12,7 +12,7 @@
 
 from setuptools import setup
 
-VERSION = "0.2.6"
+VERSION = "0.2.7"
 INSTALL_REQUIRES = ["requests<3.0.0"]
 TESTS_REQUIRE = ["pytest"]