looker-sdk 24.2.0__tar.gz → 24.4.0__tar.gz

{looker_sdk-24.2.0 → looker_sdk-24.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: looker_sdk
-Version: 24.2.0
+Version: 24.4.0
 Summary: Looker REST API
 Home-page: https://pypi.python.org/pypi/looker_sdk
 Author: Looker Data Sciences, Inc.

looker_sdk-24.4.0/looker_sdk/error.py

@@ -0,0 +1,148 @@
+# The MIT License (MIT)
+#
+# Copyright (c) 2019 Looker Data Sciences, Inc.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+import attr
+from typing import cast, Dict, Optional, Sequence, Tuple
+import requests
+import json
+import re
+
+"""API error class
+"""
+
+
+@attr.s(auto_attribs=True, kw_only=True)
+class ErrorDetail:
+    """Error detail:
+    documentation_url: documentation link
+    field: field with error
+    code: error code
+    message: error info message
+    error_doc_url: URL that may point to additional useful information
+    error_doc: Markdown doc that may contain additional useful information
+    """
+
+    documentation_url: str
+    field: Optional[str] = ""
+    code: Optional[str] = ""
+    message: Optional[str] = ""
+    error_doc_url: str = ""
+    error_doc: str = ""
+
+    def __str__(self):
+        return f"""
+        *****
+        documentation_url: {self.documentation_url}
+        field:             {self.field}
+        code:              {self.code}
+        message:           {self.message}
+        error_doc_url:     {self.error_doc_url}
+        """
+
+
+@attr.s(auto_attribs=True)
+class SDKError(Exception):
+    """API error class:
+    message: main error info message
+    errors: array of error details
+    documentation_url: documentation link
+    error_doc_url: URL that may point to additional useful information
+    error_doc: Markdown doc that may contain additional useful information
+    """
+
+    message: str
+    errors: Sequence[ErrorDetail] = attr.ib(default=[], kw_only=True)
+    documentation_url: str = attr.ib(default="", kw_only=True)
+    error_doc_url: str = ""
+    error_doc: str = ""
+
+    def __str__(self):
+        sep = "****\n"
+        return f"""
+    message:           {self.message}
+    documentation_url: {self.documentation_url}
+    error_doc_url:     {self.error_doc_url}
+    error details:
+    {sep.join(self.errors)}
+    """
+
+
+"""Error Doc Helper class
+"""
+
+
+@attr.s(auto_attribs=True, kw_only=True)
+class ErrorDocHelper:
+    """Error Doc Helper:
+    error_doc_url: link
+    """
+
+    ERROR_CODES_URL: str = "https://static-a.cdn.looker.app/errorcodes/"
+    lookup_dict: Dict[str, Dict[str, str]] = {}
+    RE_PATTERN: str = (
+        """(https://docs\.looker\.com/r/err/|https://cloud\.google\.com/looker/docs/r/err/)(.*)/(\d{3})(.*)"""
+    )
+    pattern = re.compile(RE_PATTERN, flags=re.IGNORECASE)
+
+    def get_index(self, url: str = ERROR_CODES_URL) -> None:
+        r = requests.get(f"{url}index.json")
+        self.lookup_dict = json.loads(r.text)
+
+    def lookup(
+        self, url: str = ERROR_CODES_URL, code: str = "", path: str = ""
+    ) -> Tuple[str, str]:
+        if len(self.lookup_dict) == 0:
+            self.get_index(url=url)
+
+        error_doc_url: str = ""
+        error_doc: str = ""
+        if path:
+            try:
+                error_doc_url = self.lookup_dict[f"{code}{path}"]["url"]
+            except KeyError:
+                error_doc = f"### No documentation found for {code}{path}"
+        if not error_doc_url:
+            try:
+                error_doc_url = self.lookup_dict[code]["url"]
+            except KeyError:
+                if not error_doc:
+                    error_doc = f"### No documentation found for {code}"
+
+        if error_doc_url:
+            r = requests.get(f"{self.ERROR_CODES_URL}{error_doc_url}")
+            error_doc = r.text
+
+        return (f"{self.ERROR_CODES_URL}{error_doc_url}", error_doc)
+
+    def parse_and_lookup(
+        self, error_url: str, url: str = ERROR_CODES_URL
+    ) -> Tuple[str, str]:
+        m = re.search(self.RE_PATTERN, error_url)
+        if not m:
+            return ("", "")
+
+        code: str = cast(Tuple[str, str, str, str], m.groups())[2]
+        path: str = cast(Tuple[str, str, str, str], m.groups())[3]
+        try:
+            return self.lookup(url=url, code=code, path=path)
+        except requests.exceptions.RequestException:
+            return ("", "")

{looker_sdk-24.2.0 → looker_sdk-24.4.0}/looker_sdk/rtl/api_methods.py

@@ -87,7 +87,15 @@ class APIMethods:
             value = response.value.decode(encoding=encoding)
             sdk_error: error.SDKError
             try:
-                sdk_error = self.deserialize(data=value, structure=error.SDKError) # type: ignore
+                sdk_error = self.deserialize(data=value, structure=error.SDKError)  # type: ignore
+                helper = error.ErrorDocHelper()
+                (sdk_error.error_doc_url, sdk_error.error_doc) = (
+                    helper.parse_and_lookup(sdk_error.documentation_url)
+                )
+                for e in sdk_error.errors:
+                    (e.error_doc_url, e.error_doc) = helper.parse_and_lookup(
+                        e.documentation_url
+                    )
             except serialize.DeserializeError:
                 raise error.SDKError(value)
             raise sdk_error

{looker_sdk-24.2.0 → looker_sdk-24.4.0}/looker_sdk/sdk/api40/models.py

@@ -21,7 +21,7 @@
 # SOFTWARE.
 #
 
-# 339 API models: 256 Spec, 0 Request, 61 Write, 22 Enum
+# 340 API models: 257 Spec, 0 Request, 61 Write, 22 Enum
 
 
 # NOTE: Do not edit this file generated by Looker SDK Codegen for API 4.0
@@ -5778,65 +5778,17 @@ InvestigativeContentType.__new__ = model.safe_enum__new__  # type: ignore
 class JsonBi(model.Model):
     """
     Attributes:
-        big_query_metadata:
-        fields:
-        pivots: Pivots
-        has_subtotals: If the query has subtotals
-        has_totals: If the query has totals
-        columns_truncated: If the query results hit the maximum column limit and additional columns were truncated
-        filter_expression: Filter expression applied to the query results
-        filters: Filters applied to the query results
-        sql: Raw sql query. Null if user does not have permission to view sql
-        data: Json query results
+        metadata:
+        rows: Json query results
     """
 
-    big_query_metadata: "JsonBiBigQueryMetadata"
-    fields: "JsonBiFields"
-    pivots: Sequence["JsonBiPivots"]
-    has_subtotals: bool
-    has_totals: bool
-    columns_truncated: str
-    filter_expression: str
-    filters: MutableMapping[str, Any]
-    sql: str
-    data: Sequence[str]
-    __annotations__ = {
-        "big_query_metadata": ForwardRef("JsonBiBigQueryMetadata"),
-        "fields": ForwardRef("JsonBiFields"),
-        "pivots": Sequence["JsonBiPivots"],
-        "has_subtotals": bool,
-        "has_totals": bool,
-        "columns_truncated": str,
-        "filter_expression": str,
-        "filters": MutableMapping[str, Any],
-        "sql": str,
-        "data": Sequence[str],
-    }
+    metadata: "JsonBiMetadata"
+    rows: Sequence[str]
+    __annotations__ = {"metadata": ForwardRef("JsonBiMetadata"), "rows": Sequence[str]}
 
-    def __init__(
-        self,
-        *,
-        big_query_metadata: "JsonBiBigQueryMetadata",
-        fields: "JsonBiFields",
-        pivots: Sequence["JsonBiPivots"],
-        has_subtotals: bool,
-        has_totals: bool,
-        columns_truncated: str,
-        filter_expression: str,
-        filters: MutableMapping[str, Any],
-        sql: str,
-        data: Sequence[str]
-    ):
-        self.big_query_metadata = big_query_metadata
-        self.fields = fields
-        self.pivots = pivots
-        self.has_subtotals = has_subtotals
-        self.has_totals = has_totals
-        self.columns_truncated = columns_truncated
-        self.filter_expression = filter_expression
-        self.filters = filters
-        self.sql = sql
-        self.data = data
+    def __init__(self, *, metadata: "JsonBiMetadata", rows: Sequence[str]):
+        self.metadata = metadata
+        self.rows = rows
 
 
 @attr.s(auto_attribs=True, init=False)
@@ -5941,6 +5893,66 @@ class JsonBiFields(model.Model):
         self.pivots = pivots
 
 
+@attr.s(auto_attribs=True, init=False)
+class JsonBiMetadata(model.Model):
+    """
+    Attributes:
+        big_query_metadata:
+        fields:
+        pivots: Pivots
+        has_subtotals: If the query has subtotals
+        has_totals: If the query has totals
+        columns_truncated: If the query results hit the maximum column limit and additional columns were truncated
+        filter_expression: Filter expression applied to the query results
+        filters: Filters applied to the query results
+        sql: Raw sql query. Null if user does not have permission to view sql
+    """
+
+    big_query_metadata: "JsonBiBigQueryMetadata"
+    fields: "JsonBiFields"
+    pivots: Sequence["JsonBiPivots"]
+    has_subtotals: bool
+    has_totals: bool
+    columns_truncated: str
+    filter_expression: str
+    filters: MutableMapping[str, Any]
+    sql: str
+    __annotations__ = {
+        "big_query_metadata": ForwardRef("JsonBiBigQueryMetadata"),
+        "fields": ForwardRef("JsonBiFields"),
+        "pivots": Sequence["JsonBiPivots"],
+        "has_subtotals": bool,
+        "has_totals": bool,
+        "columns_truncated": str,
+        "filter_expression": str,
+        "filters": MutableMapping[str, Any],
+        "sql": str,
+    }
+
+    def __init__(
+        self,
+        *,
+        big_query_metadata: "JsonBiBigQueryMetadata",
+        fields: "JsonBiFields",
+        pivots: Sequence["JsonBiPivots"],
+        has_subtotals: bool,
+        has_totals: bool,
+        columns_truncated: str,
+        filter_expression: str,
+        filters: MutableMapping[str, Any],
+        sql: str
+    ):
+        self.big_query_metadata = big_query_metadata
+        self.fields = fields
+        self.pivots = pivots
+        self.has_subtotals = has_subtotals
+        self.has_totals = has_totals
+        self.columns_truncated = columns_truncated
+        self.filter_expression = filter_expression
+        self.filters = filters
+        self.sql = sql
+
+
 @attr.s(auto_attribs=True, init=False)
 class JsonBiPivots(model.Model):
     """

{looker_sdk-24.2.0 → looker_sdk-24.4.0}/looker_sdk/sdk/constants.py

@@ -20,5 +20,5 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 # THE SOFTWARE.
 
-sdk_version = "24.2"
+sdk_version = "24.4"
 environment_prefix = "LOOKERSDK"

{looker_sdk-24.2.0 → looker_sdk-24.4.0}/looker_sdk/version.py

@@ -20,4 +20,4 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 # THE SOFTWARE.
 
-__version__ = "24.2.0"
+__version__ = "24.4.0"

{looker_sdk-24.2.0 → looker_sdk-24.4.0}/looker_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: looker-sdk
-Version: 24.2.0
+Version: 24.4.0
 Summary: Looker REST API
 Home-page: https://pypi.python.org/pypi/looker_sdk
 Author: Looker Data Sciences, Inc.

looker_sdk-24.2.0/looker_sdk/error.py

@@ -1,53 +0,0 @@
-# The MIT License (MIT)
-#
-# Copyright (c) 2019 Looker Data Sciences, Inc.
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-import attr
-from typing  import Optional, Sequence
-
-"""API error class
-"""
-
-@attr.s(auto_attribs=True, kw_only=True)
-class ErrorDetail():
-    """Error detail:
-        documentation_url: documentation link
-        field: field with error
-        code: error code
-        message: error info message
-    """
-    documentation_url: str
-    field: Optional[str] = ""
-    code: Optional[str] = ""
-    message: Optional[str] = ""
-
-
-@attr.s(auto_attribs=True)
-class SDKError(Exception):
-    """API error class:
-        message: main error info message
-        errors: array of error details
-        documentation_url: documentation link
-    """
-
-    message: str
-    errors: Optional[Sequence[ErrorDetail]] = attr.ib(default=[], kw_only=True)
-    documentation_url: Optional[str] = attr.ib(default="", kw_only=True)