Add region argument to client to connect in EU data center

docs/README.md

@@ -45,6 +45,13 @@ api_key = '83749879bbde395b5fe0cc1a5abf8e5'
 client = recurly.Client(api_key)
 ```
 
+To access Recurly API in Europe, you will need to specify the EU Region in the argument region.
+
+```python
+api_key = '83749879bbde395b5fe0cc1a5abf8e5'
+client = recurly.Client(api_key, region="eu")
+```
+
 ### Operations
 
 The Client contains every `operation` you can perform on the site as a list of methods.

recurly/base_client.py

@@ -10,11 +10,13 @@
 from pydoc import locate
 import urllib.parse
 from datetime import datetime
+from enum import Enum
 
 PORT = 443
-HOST = "v3.recurly.com"
 BINARY_TYPES = ["application/pdf"]
 ALLOWED_OPTIONS = ["body", "params", "headers"]
+API_HOSTS = {"us": "v3.recurly.com", "eu": "v3.eu.recurly.com"}
+HOST = API_HOSTS["us"]
 
 
 def request_converter(value):
@@ -26,10 +28,23 @@ def request_converter(value):
 
 
 class BaseClient:
-    def __init__(self, api_key, timeout=None):
+    def __init__(self, api_key, timeout=None, **options):
         self.__api_key = api_key
         actual_timeout = timeout if timeout is not None else DEFAULT_REQUEST_TIMEOUT
-        self.__conn = http.client.HTTPSConnection(HOST, PORT, timeout=actual_timeout)
+        api_host = HOST
+
+        if "region" in options:
+            if options["region"] not in API_HOSTS:
+                raise TypeError(
+                    "Invalid region type. Expected one of: %s"
+                    % (", ".join(API_HOSTS.keys()))
+                )
+
+            api_host = API_HOSTS[options["region"]]
+
+        self.__conn = http.client.HTTPSConnection(
+            api_host, PORT, timeout=actual_timeout
+        )
 
     def _make_request(self, method, path, body, **options):
         try:

tests/test_base_client.py

@@ -9,6 +9,7 @@
 from unittest.mock import Mock, MagicMock
 from datetime import datetime
 from collections import OrderedDict
+from recurly.base_client import API_HOSTS
 import sys
 
 
@@ -269,3 +270,18 @@ def test_client_can_set_timeout(self):
         timeout = 3
         client = MockClient("apikey", timeout=timeout)
         self.assertEqual(client.__dict__["_BaseClient__conn"].timeout, timeout)
+
+    def test_client_default_region(self):
+        client = MockClient("apikey")
+        self.assertEqual(client.__dict__["_BaseClient__conn"].host, API_HOSTS["us"])
+
+    def test_client_set_region_eu(self):
+        client = MockClient("apikey", region="eu")
+        self.assertEqual(client.__dict__["_BaseClient__conn"].host, API_HOSTS["eu"])
+
+    def test_client_set_invalid_region(self):
+        with self.assertRaises(TypeError) as e:
+            client = MockClient("apikey", region="none")
+
+        err = e.exception
+        self.assertEqual(str(err), "Invalid region type. Expected one of: us, eu")