tango-python 1.13.0__py3-none-any.whl → 1.14.0__py3-none-any.whl

tango/__init__.py

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

tango/client.py

@@ -71,6 +71,9 @@ from tango.shapes import (
     build_parser_registry_from_client,
 )
 
+# Where `_request` stores a list response's `X-Results-CountType` header so each `PaginatedResponse` reads its own, not the shared `last_response_headers`.
+_COUNT_TYPE_KEY = "_tango_count_type"
+
 
 class TangoClient:
     """Tango API Client"""
@@ -180,7 +183,11 @@ class TangoClient:
 
             self._raise_for_status(response)
 
-            return response.json() if response.content else {}
+            data = response.json() if response.content else {}
+            count_type = response.headers.get("X-Results-CountType")
+            if isinstance(count_type, str) and isinstance(data, dict) and "count" in data:
+                data[_COUNT_TYPE_KEY] = count_type.lower()
+            return data
 
         except httpx.HTTPError as e:
             raise TangoAPIError(f"Request failed: {str(e)}") from e
@@ -495,6 +502,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=[
                 ag
@@ -530,6 +538,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data.get("count", 0),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=data.get("results", []),
             meta=data.get("meta"),
@@ -583,6 +592,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data.get("count", 0),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -795,6 +805,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             cursor=data.get("cursor"),
@@ -857,6 +868,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count") or len(results)),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             cursor=data.get("cursor"),
@@ -880,6 +892,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count") or len(data.get("results") or [])),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=data.get("results") or [],
             cursor=data.get("cursor"),
@@ -984,6 +997,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count") or len(results)),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             cursor=data.get("cursor"),
@@ -1087,6 +1101,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count") or len(results)),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             cursor=data.get("cursor"),
@@ -1133,6 +1148,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count") or len(results)),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             cursor=data.get("cursor"),
@@ -1151,6 +1167,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count") or len(data.get("results") or [])),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=data.get("results") or [],
             cursor=data.get("cursor"),
@@ -1234,6 +1251,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count") or len(results)),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             cursor=data.get("cursor"),
@@ -1340,6 +1358,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count") or len(results)),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             cursor=data.get("cursor"),
@@ -1417,6 +1436,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count") or len(results)),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             cursor=data.get("cursor"),
@@ -1474,6 +1494,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data.get("count", 0),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -1559,6 +1580,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data.get("count", 0),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -1671,6 +1693,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data.get("count", 0),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -1841,6 +1864,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -1923,6 +1947,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -1972,6 +1997,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -2007,6 +2033,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -2059,6 +2086,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data.get("count", 0),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=data.get("results", []),
             meta=data.get("meta"),
@@ -2146,6 +2174,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -2203,6 +2232,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count", 0)),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=list(data.get("results") or []),
             meta=data.get("meta"),
@@ -2296,6 +2326,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -2427,6 +2458,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -2542,6 +2574,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -2664,6 +2697,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -2802,6 +2836,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -2940,6 +2975,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -3080,6 +3116,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -3288,6 +3325,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -3408,6 +3446,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -3546,6 +3585,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -3695,6 +3735,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -3826,6 +3867,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -3947,6 +3989,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -4155,6 +4198,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -4267,6 +4311,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -4391,6 +4436,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -4792,6 +4838,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data.get("count", 0),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -4844,6 +4891,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count") or len(data.get("results") or [])),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=data.get("results") or [],
             meta=data.get("meta"),
@@ -4872,6 +4920,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count") or len(data.get("results") or [])),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=data.get("results") or [],
             meta=data.get("meta"),
@@ -4966,6 +5015,7 @@ class TangoClient:
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -5059,6 +5109,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count", len(results))),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -5244,6 +5295,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count", len(results))),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -5462,6 +5514,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count", 0)),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=list(data.get("results") or []),
             meta=data.get("meta"),
@@ -5500,6 +5553,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count", 0)),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=list(data.get("results") or []),
             meta=data.get("meta"),
@@ -5601,6 +5655,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count", 0)),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=list(data.get("results") or []),
             meta=data.get("meta"),
@@ -5648,6 +5703,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count", 0)),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=list(data.get("results") or []),
             meta=data.get("meta"),
@@ -5716,6 +5772,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count") or len(results)),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             cursor=data.get("cursor"),
@@ -5894,6 +5951,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count", 0)),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             meta=data.get("meta"),
@@ -5925,6 +5983,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count", 0)),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=list(data.get("results") or []),
             meta=data.get("meta"),
@@ -5966,6 +6025,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count", 0)),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=list(data.get("results") or []),
             meta=data.get("meta"),
@@ -6022,6 +6082,7 @@ class TangoClient:
         return PaginatedResponse(
             count=int(data.get("count") or len(results)),
             next=data.get("next"),
+            count_type=data.get(_COUNT_TYPE_KEY),
             previous=data.get("previous"),
             results=results,
             cursor=data.get("cursor"),

tango/models.py

@@ -1462,6 +1462,8 @@ class PaginatedResponse[T]:
         page_metadata: Always ``None`` — the API has never emitted a
             ``page_metadata`` key. Retained so existing attribute access keeps
             working; use ``meta`` instead.
+        count_type: ``"exact"`` or ``"approximate"``, from the API's ``X-Results-CountType`` header; ``None`` when the endpoint doesn't send it.
+            The contract, IDV, opportunity and notice lists can switch to a query-planner estimate past 1,000 matches, which can be well off.
 
     Examples:
         >>> from tango import TangoClient, ShapeConfig
@@ -1482,6 +1484,7 @@ class PaginatedResponse[T]:
     cursor: str | None = None
     meta: dict[str, Any] | None = None
     page_metadata: dict[str, Any] | None = None
+    count_type: str | None = None
 
     @property
     def agency_warnings(self) -> list[str]:

{tango_python-1.13.0.dist-info → tango_python-1.14.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: tango-python
-Version: 1.13.0
+Version: 1.14.0
 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.13.0.dist-info → tango_python-1.14.0.dist-info}/RECORD

@@ -1,7 +1,7 @@
-tango/__init__.py,sha256=L5_oz-laG934CX8HE8EOPEPW1a7JHmXo7dsTLwCGC5c,2739
-tango/client.py,sha256=N-EKUT2OquRrjpInxK0ZnWVTuDP5ylEXadshjvxO6ng,240281
+tango/__init__.py,sha256=XZv0Q3i4cb0rMu4DTMvB6vthWIQsgfmgnTt5EVnqdac,2739
+tango/client.py,sha256=1Z748iPEPdVi8_Sq9XPES8RnPdnugEwL3yAgV7Cvvt0,243419
 tango/exceptions.py,sha256=oPiLCccBoWLK5SjHkzP-oI6mUD9twEeKSvEuLV5h01I,4224
-tango/models.py,sha256=w7z49WIMcvvEt05J1DpuUPcFWBq_MbCWa4a-f-YLsVs,69936
+tango/models.py,sha256=Is7HRH3xLy8k82aeRqaJU6zaxZ7CSui4D5Pg9q7Pr9Y,70257
 tango/shapes/__init__.py,sha256=7ea1WU74jp4znhNw-gXruag6m6eyPZtbVgbDFmFUWro,1072
 tango/shapes/explicit_schemas.py,sha256=tqGitlPoXN4VDfwCU5T4KfzLfQTyZ2Ephap56bDbB3c,84334
 tango/shapes/factory.py,sha256=uDPhnp6VVzrLBKodxteZy5AcU43juEv-qKVRWth51j0,31550
@@ -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.13.0.dist-info/METADATA,sha256=fzPg4uS9gC6BNoxJY3lB0b9-FXrX-6mlkkCq0xIX9Wc,22118
-tango_python-1.13.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-tango_python-1.13.0.dist-info/entry_points.txt,sha256=kGLUbglUjuaAqEFvOZ1QuSW0vWb6VeSpCIFKaOFkKoQ,50
-tango_python-1.13.0.dist-info/licenses/LICENSE,sha256=j2kYVHMwTkoGn3ZNScnrdIueG0k2XzB_LCPFoyBc2wk,1064
-tango_python-1.13.0.dist-info/RECORD,,
+tango_python-1.14.0.dist-info/METADATA,sha256=IMQQV5MA3ekEPPGbdTWW6K0eYMxCXIzarR5DSM3HxZQ,22118
+tango_python-1.14.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+tango_python-1.14.0.dist-info/entry_points.txt,sha256=kGLUbglUjuaAqEFvOZ1QuSW0vWb6VeSpCIFKaOFkKoQ,50
+tango_python-1.14.0.dist-info/licenses/LICENSE,sha256=j2kYVHMwTkoGn3ZNScnrdIueG0k2XzB_LCPFoyBc2wk,1064
+tango_python-1.14.0.dist-info/RECORD,,