tango-python 1.18.0__py3-none-any.whl → 1.18.1__py3-none-any.whl

tango/__init__.py

@@ -62,7 +62,7 @@ from .webhooks import (
 )
 from .webhooks.receiver import Delivery, WebhookReceiver
 
-__version__ = "1.18.0"
+__version__ = "1.18.1"
 __all__ = [
     "TangoClient",
     "TangoAPIError",

tango/client.py

@@ -75,6 +75,31 @@ from tango.shapes import (
 _COUNT_TYPE_KEY = "_tango_count_type"
 
 
+def _error_body(response: httpx.Response) -> dict[str, Any]:
+    """The JSON object an error response carries, or {} for an empty, non-JSON (a proxy's HTML page) or non-object body."""
+    try:
+        data = response.json() if response.content else {}
+    except ValueError:
+        return {}
+    return data if isinstance(data, dict) else {}
+
+
+def _error_reason(error_data: dict[str, Any]) -> str | None:
+    """The server's own explanation from an error body, e.g. why a 403 refused the request.
+
+    The API sends either ``{"detail": "..."}`` or a structured body such as a tier gate's ``{"error": "...", "code": "tier_required", ...}``, sometimes nested under ``detail``.
+    """
+    for body in (error_data, error_data.get("detail")):
+        if isinstance(body, str) and body:
+            return body
+        if isinstance(body, dict):
+            for key in ("error", "message", "detail"):
+                value = body.get(key)
+                if isinstance(value, str) and value:
+                    return value
+    return None
+
+
 class TangoClient:
     """Tango API Client"""
 
@@ -232,8 +257,13 @@ class TangoClient:
             detail = error_data.get("detail", "Rate limit exceeded")
             raise TangoRateLimitError(detail, response.status_code, error_data)
         elif not response.is_success:
+            error_data = _error_body(response)
+            reason = _error_reason(error_data)
+            message = f"API request failed with status {response.status_code}"
             raise TangoAPIError(
-                f"API request failed with status {response.status_code}", response.status_code
+                f"{message}: {reason}" if reason else message,
+                response.status_code,
+                error_data,
             )
 
     def _get(self, endpoint: str, params: dict[str, Any] | None = None) -> dict[str, Any]:

{tango_python-1.18.0.dist-info → tango_python-1.18.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: tango-python
-Version: 1.18.0
+Version: 1.18.1
 Summary: Python SDK for the Tango API
 Project-URL: Homepage, https://github.com/makegov/tango-python
 Project-URL: Documentation, https://docs.makegov.com/tango-python

{tango_python-1.18.0.dist-info → tango_python-1.18.1.dist-info}/RECORD

@@ -1,5 +1,5 @@
-tango/__init__.py,sha256=KCJAQuPFMIOevwV29hvLdspZrvfMFvj8eNp8CLdZFMU,2739
-tango/client.py,sha256=V7wlznIjQgO0puJcATTLlbB5KK9245TcPUwrK-29X6Q,244464
+tango/__init__.py,sha256=VqhIYcfNI56Lx8iBaT3qGYKpjaHxLWPpTC-fIujYxQA,2739
+tango/client.py,sha256=awauFCq-gd-dCBAvDPeEBBgxwhuc_2ZzIhK-I7ki0U8,245711
 tango/exceptions.py,sha256=oPiLCccBoWLK5SjHkzP-oI6mUD9twEeKSvEuLV5h01I,4224
 tango/models.py,sha256=D9e8_AAAwVi1C4nOqdhWz-8ARBLPRsLGi8TDjucOMEY,72897
 tango/shapes/__init__.py,sha256=7ea1WU74jp4znhNw-gXruag6m6eyPZtbVgbDFmFUWro,1072
@@ -16,8 +16,8 @@ tango/webhooks/cli.py,sha256=f_vQbJ2AeSQjKnQo7MxHFyUB2SAKcgHYmGQULS0isqQ,13858
 tango/webhooks/receiver.py,sha256=5yhsVhlLyoxmOCGvmbynWAIlDB2OaCPVf1H4GA1SxmU,9279
 tango/webhooks/signing.py,sha256=92Ee-0B6PR7ZkvY3Np3gzl88-mtfKkh-I7lxqCe2lGw,2374
 tango/webhooks/simulate.py,sha256=g2Osa0FYU5mJuon07T2aUCtmkUoTEzsY261tlp76fF0,3165
-tango_python-1.18.0.dist-info/METADATA,sha256=JsBA_p7qMZTXV9SqN4XuGZztVFGuAH94kE8ye1LK9rA,22824
-tango_python-1.18.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-tango_python-1.18.0.dist-info/entry_points.txt,sha256=kGLUbglUjuaAqEFvOZ1QuSW0vWb6VeSpCIFKaOFkKoQ,50
-tango_python-1.18.0.dist-info/licenses/LICENSE,sha256=j2kYVHMwTkoGn3ZNScnrdIueG0k2XzB_LCPFoyBc2wk,1064
-tango_python-1.18.0.dist-info/RECORD,,
+tango_python-1.18.1.dist-info/METADATA,sha256=WL8McHrCjg-DuQ2-9FLyb9DyQZge8oSMnNXFCQhY_Nw,22824
+tango_python-1.18.1.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+tango_python-1.18.1.dist-info/entry_points.txt,sha256=kGLUbglUjuaAqEFvOZ1QuSW0vWb6VeSpCIFKaOFkKoQ,50
+tango_python-1.18.1.dist-info/licenses/LICENSE,sha256=j2kYVHMwTkoGn3ZNScnrdIueG0k2XzB_LCPFoyBc2wk,1064
+tango_python-1.18.1.dist-info/RECORD,,