add support for version 2018-05-22 (#121)

* add api versioning

* make arguments consistent between http_request and _requests_http_request

Author: r-ohan

plaid/client.py

@@ -33,7 +33,8 @@ def __init__(self,
                  public_key,
                  environment,
                  suppress_warnings=False,
-                 timeout=DEFAULT_TIMEOUT):
+                 timeout=DEFAULT_TIMEOUT,
+                 api_version=None):
         '''
         Initialize a client with credentials.
 
@@ -52,6 +53,7 @@ def __init__(self,
         self.environment = environment
         self.suppress_warnings = suppress_warnings
         self.timeout = timeout
+        self.api_version = api_version
 
         if self.environment == 'development' and not self.suppress_warnings:
             warnings.warn('''
@@ -95,8 +97,12 @@ def post_public_key(self, path, data):
         return self._post(path, post_data)
 
     def _post(self, path, data):
+        headers = {}
+        if self.api_version is not None:
+            headers = {'Plaid-Version': self.api_version}
         return post_request(
             urljoin('https://' + self.environment + '.plaid.com', path),
             data=data,
-            timeout=self.timeout
+            timeout=self.timeout,
+            headers=headers,
         )

plaid/requester.py

@@ -17,15 +17,19 @@
     JSONDecodeError = ValueError
 
 
-def _requests_http_request(url, method, data, timeout=DEFAULT_TIMEOUT):
+def _requests_http_request(
+        url,
+        method,
+        data,
+        headers,
+        timeout=DEFAULT_TIMEOUT):
     normalized_method = method.lower()
+    headers.update({'User-Agent': 'Plaid Python v{}'.format(__version__)})
     if normalized_method in ALLOWED_METHODS:
         return getattr(requests, normalized_method)(
             url,
             json=data,
-            headers={
-                'User-Agent': 'Plaid Python v{}'.format(__version__),
-            },
+            headers=headers,
             timeout=timeout,
         )
     else:
@@ -34,8 +38,18 @@ def _requests_http_request(url, method, data, timeout=DEFAULT_TIMEOUT):
         )
 
 
-def http_request(url, method=None, data=None, timeout=DEFAULT_TIMEOUT):
-    response = _requests_http_request(url, method, data or {}, timeout)
+def http_request(
+        url,
+        method=None,
+        data=None,
+        headers=None,
+        timeout=DEFAULT_TIMEOUT):
+    response = _requests_http_request(
+        url,
+        method,
+        data or {},
+        headers or {},
+        timeout)
     try:
         response_body = json.loads(response.text)
     except JSONDecodeError:

tests/integration/util.py

@@ -10,7 +10,8 @@ def create_client():
     return Client(os.environ['CLIENT_ID'],
                   os.environ['SECRET'],
                   os.environ['PUBLIC_KEY'],
-                  'sandbox')
+                  'sandbox',
+                  api_version="2017-03-08")
 
 CREDENTIALS = {
     'username': 'user_good',