Jac/user import (#1086)

* Include the url of the request that got an error in the response. Makes it much easier to debug.
* Add user import logic, and user import example in samples

Author: jacalata

tableauserverclient/server/endpoint/exceptions.py

@@ -6,29 +6,34 @@ class TableauError(Exception):
 
 
 class ServerResponseError(TableauError):
-    def __init__(self, code, summary, detail):
+    def __init__(self, code, summary, detail, url=None):
         self.code = code
         self.summary = summary
         self.detail = detail
+        self.url = url
         super(ServerResponseError, self).__init__(str(self))
 
     def __str__(self):
         return "\n\n\t{0}: {1}\n\t\t{2}".format(self.code, self.summary, self.detail)
 
     @classmethod
-    def from_response(cls, resp, ns):
+    def from_response(cls, resp, ns, url=None):
         # Check elements exist before .text
         parsed_response = fromstring(resp)
-        error_response = cls(
-            parsed_response.find("t:error", namespaces=ns).get("code", ""),
-            parsed_response.find(".//t:summary", namespaces=ns).text,
-            parsed_response.find(".//t:detail", namespaces=ns).text,
-        )
+        try:
+            error_response = cls(
+                parsed_response.find("t:error", namespaces=ns).get("code", ""),
+                parsed_response.find(".//t:summary", namespaces=ns).text,
+                parsed_response.find(".//t:detail", namespaces=ns).text,
+                url,
+            )
+        except Exception as e:
+            raise NonXMLResponseError(resp)
         return error_response
 
 
 class InternalServerError(TableauError):
-    def __init__(self, server_response, request_url):
+    def __init__(self, server_response, request_url: str = None):
         self.code = server_response.status_code
         self.content = server_response.content
         self.url = request_url or "server"