tango-python 1.13.0__tar.gz → 1.15.0__tar.gz

{tango_python-1.13.0 → tango_python-1.15.0}/CHANGELOG.md

@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.15.0] - 2026-10-06
+
+### Added
+
+- **`matched_by` on agency-filter diagnostics** (Tango API 5.9.0). Each entry of `PaginatedResponse.meta["resolved_filters"][<filter name>]` that resolved now says how its token matched: `key` (an organization UUID), `code` (a 3-digit CGAC or 4-digit FPDS code), `name` (the organization's name, including a department's everyday name, a spelling variant or a rename), `alias` (an abbreviation or the organization's own alias) or `fuzzy` (a looser text match, worth checking against the resolved name). An entry that did not resolve has no `matched_by`. `meta` is passed through as the API sends it, so no code change was needed to receive the field; this release documents it and pins it with a test. `agency_warnings`, `unresolved_agency_tokens` and `resolved_agencies` are unchanged.
+- **File and link counts on opportunities and notices** (Tango API 5.9.0). An attachment's `type` is `file` (a document attached to the notice; only files have extracted text) or `link` (a URL the notice lists), and the new fields count each: `meta.files_count` and `meta.links_count` on opportunities, `file_count` and `link_count` on notices. The existing `meta.attachments_count` and `attachment_count` still count every attachment, links included, and an attachment of any other type counts only there, so files plus links need not equal the total. The new fields are `None` until a record has been counted, so treat `None` as unknown, not zero. All four are accepted in custom shapes, as is `opportunity(meta(files_count,links_count))` on vehicles; no default SDK shape names them.
+
+### Changed
+
+- Re-vendored `contracts/filter_shape_contract.json` (Tango API 5.9.0) and regenerated `tango/shapes/generated_overlay.py`.
+
+## [1.14.0] - 2026-10-02
+
+### Added
+
+- **`PaginatedResponse.count_type`**: `"exact"` or `"approximate"`, read from the API's `X-Results-CountType` header on every list method (`None` when the API doesn't send it). Past 1,000 matches the contract, IDV, opportunity and notice lists may return a query-planner estimate as `count`, which can be well off; this is how a caller tells the two apart. It is taken from each response itself, so concurrent calls on one client can't see each other's value the way `last_response_headers` can.
+
 ## [1.13.0] - 2026-10-02
 
 ### Added

{tango_python-1.13.0 → tango_python-1.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: tango-python
-Version: 1.13.0
+Version: 1.15.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
@@ -219,6 +219,15 @@ for warning in response.agency_warnings:
     print(warning)
 ```
 
+Each entry of `response.meta["resolved_filters"][<filter name>]` that resolved also says how its token matched, in `matched_by` (Tango API 5.9.0+): `key` (an organization UUID), `code` (a 3-digit CGAC or 4-digit FPDS code), `name` (the organization's name, including a department's everyday name, a spelling variant or a rename), `alias` (an abbreviation or the organization's own alias) or `fuzzy` (a looser text match).
+A `fuzzy` match is the one worth checking against the resolved name:
+
+```python
+for entry in response.meta["resolved_filters"].get("awarding_agency", []):
+    if entry.get("matched_by") == "fuzzy":
+        print(f"{entry['token']!r} loosely matched {entry['resolved']['name']}")
+```
+
 If *every* token for a filter fails to resolve, the API returns `400` and the SDK raises
 `TangoValidationError` naming the offending value, rather than an empty page.
 

{tango_python-1.13.0 → tango_python-1.15.0}/README.md

@@ -165,6 +165,15 @@ for warning in response.agency_warnings:
     print(warning)
 ```
 
+Each entry of `response.meta["resolved_filters"][<filter name>]` that resolved also says how its token matched, in `matched_by` (Tango API 5.9.0+): `key` (an organization UUID), `code` (a 3-digit CGAC or 4-digit FPDS code), `name` (the organization's name, including a department's everyday name, a spelling variant or a rename), `alias` (an abbreviation or the organization's own alias) or `fuzzy` (a looser text match).
+A `fuzzy` match is the one worth checking against the resolved name:
+
+```python
+for entry in response.meta["resolved_filters"].get("awarding_agency", []):
+    if entry.get("matched_by") == "fuzzy":
+        print(f"{entry['token']!r} loosely matched {entry['resolved']['name']}")
+```
+
 If *every* token for a filter fails to resolve, the API returns `400` and the SDK raises
 `TangoValidationError` naming the offending value, rather than an empty page.
 

{tango_python-1.13.0 → tango_python-1.15.0}/docs/API_REFERENCE.md

@@ -981,6 +981,27 @@ awarded = client.list_opportunities(
 - The `awarded` and `awardee_uei` filters search every opportunity, not just active ones, so pass `active=True` to narrow to open opportunities.
 - Notices accept `award_date`, `award_amount`, `awardee` and `awardee_uei` in `shape` too.
 
+**Attachment counts — `meta(attachments_count, files_count, links_count)`:**
+
+Tango API 5.9.0 splits an opportunity's attachment count by attachment `type`.
+A `file` is a document attached to the notice, and only files have extracted text; a `link` is a URL the notice lists.
+
+```python
+opp = client.get_opportunity(
+    opportunity_id,
+    shape="opportunity_id,title,meta(attachments_count,files_count,links_count)",
+)
+files = opp["meta"]["files_count"]
+if files is None:
+    print("not counted yet")
+```
+
+- `meta.files_count` counts the files and `meta.links_count` counts the links.
+- `meta.attachments_count` still counts every attachment, links included. An attachment of any other type counts only there, so `files_count + links_count` need not equal it.
+- **`None` means unknown, not zero.** Both new fields are null until the record has been counted.
+- None of the three is in the SDK's default shape, so name the ones you want.
+- The opportunity embedded in a vehicle accepts them too: `opportunity(meta(files_count,links_count))`.
+
 ---
 
 ## Notices
@@ -1053,6 +1074,23 @@ for notice in notices.results:
 - `posted_date` - Date posted
 - `naics_code` - Industry code
 
+**Attachment counts — `attachment_count`, `file_count`, `link_count`:**
+
+Tango API 5.9.0 splits a notice's attachment count by attachment `type`.
+A `file` is a document attached to the notice, and only files have extracted text; a `link` is a URL the notice lists.
+
+```python
+notices = client.list_notices(
+    agency="GSA",
+    shape="notice_id,title,attachment_count,file_count,link_count",
+)
+```
+
+- `file_count` counts the files and `link_count` counts the links.
+- `attachment_count` still counts every attachment, links included. An attachment of any other type counts only there, so `file_count + link_count` need not equal it.
+- **`None` means unknown, not zero.** Both new fields are null until the notice has been counted.
+- The API returns all three when no `shape` is sent, but the SDK's default `NOTICES_MINIMAL` shape does not name them, so ask for them.
+
 ---
 
 ## Grants

{tango_python-1.13.0 → tango_python-1.15.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tango-python"
-version = "1.13.0"
+version = "1.15.0"
 description = "Python SDK for the Tango API"
 readme = "README.md"
 requires-python = ">=3.12"

{tango_python-1.13.0 → tango_python-1.15.0}/tango/__init__.py

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

{tango_python-1.13.0 → tango_python-1.15.0}/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_python-1.13.0 → tango_python-1.15.0}/tango/models.py

@@ -571,6 +571,12 @@ class Opportunity:
     The award fields (``award_date``, ``award_amount``, ``awardee``, ``awardee_uei``) are filled only where SAM.gov posted an award notice, and ``award_amount`` is the text SAM.gov published, not a number.
     SAM.gov often posts an award as its own opportunity; when that award notice references its solicitation, ``solicitation_opportunity_id`` points back to it, and the solicitation's ``awards(...)`` expand lists up to ten of the most recent linked awards, with ``award_count`` giving the full count.
     An award notice that does not reference its solicitation is not linked.
+
+    The ``meta(...)`` expand counts an opportunity's attachments three ways (Tango API 5.9.0).
+    An attachment's ``type`` is ``file`` (a document attached to the notice; only files have extracted text) or ``link`` (a URL the notice lists).
+    ``meta.files_count`` and ``meta.links_count`` count each, and ``meta.attachments_count`` counts every attachment, links included.
+    An attachment of any other type counts only in the total, so files plus links need not equal it.
+    ``files_count`` and ``links_count`` are null until the record has been counted, so treat null as unknown, not zero.
     """
 
     opportunity_id: str
@@ -600,6 +606,10 @@ class Notice:
     Both must be named, e.g. ``attachments(name,url,doc_role,doc_role_alt)``, because ``attachments(*)`` does not include them.
     An attachment Tango has not classified omits both keys rather than returning null, so read them with ``.get()``.
     A Free-plan request that names them gets the response without them, plus an entry in ``meta.upgrade_hints``.
+
+    ``file_count`` and ``link_count`` (Tango API 5.9.0) split ``attachment_count`` by attachment ``type``: ``file`` is a document attached to the notice (only files have extracted text) and ``link`` is a URL the notice lists.
+    ``attachment_count`` still counts every attachment, links included, and an attachment of any other type counts only there, so files plus links need not equal it.
+    ``file_count`` and ``link_count`` are null until the notice has been counted, so treat null as unknown, not zero.
     """
 
     notice_id: str
@@ -613,6 +623,9 @@ class Notice:
     award_amount: str | None = None
     awardee: str | None = None
     awardee_uei: str | None = None
+    attachment_count: int | None = None
+    file_count: int | None = None
+    link_count: int | None = None
 
 
 @dataclass
@@ -1454,14 +1467,15 @@ class PaginatedResponse[T]:
         results: List of result items (type depends on shape parameter)
         cursor: Cursor token for cursor-based pagination (None if not available)
         meta: Response-level metadata the API attached to this page, when present.
-            Currently carries agency-filter diagnostics: ``resolved_filters`` maps
-            each agency filter to the organizations its ``|``-separated tokens
-            resolved to (or ``None``), and ``warnings`` lists human-readable notes
-            about tokens that were dropped or matched loosely. See
-            :meth:`agency_warnings` and :meth:`unresolved_agency_tokens`.
+            Currently carries agency-filter diagnostics: ``resolved_filters`` maps each agency filter to the organizations its ``|``-separated tokens resolved to (or ``None``), and ``warnings`` lists human-readable notes about tokens that were dropped or matched loosely.
+            Each ``resolved_filters`` entry that resolved also carries ``matched_by`` (Tango API 5.9.0+), saying how the token matched: ``"key"`` (an organization UUID), ``"code"`` (a 3-digit CGAC or 4-digit FPDS code), ``"name"`` (the organization's name, including a department's everyday name, a spelling variant or a rename), ``"alias"`` (an abbreviation or the organization's own alias) or ``"fuzzy"`` (a looser text match, worth checking against the resolved ``name``).
+            An entry that did not resolve has no ``matched_by``.
+            See :meth:`agency_warnings`, :meth:`unresolved_agency_tokens` and :meth:`resolved_agencies`.
         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 +1496,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 → tango_python-1.15.0}/tango/shapes/generated_overlay.py

@@ -641,6 +641,8 @@ META2_SCHEMA: dict[str, FieldSchema] = {
     "attachments_count": FieldSchema(
         name="attachments_count", type=int, is_optional=True, is_list=False
     ),
+    "files_count": FieldSchema(name="files_count", type=int, is_optional=True, is_list=False),
+    "links_count": FieldSchema(name="links_count", type=int, is_optional=True, is_list=False),
     "notice_type": FieldSchema(
         name="notice_type", type=dict, is_optional=True, is_list=False, nested_model="NoticeType"
     ),
@@ -2252,6 +2254,8 @@ GENERATED_OVERLAY: dict[str, dict[str, FieldSchema]] = {
         "award_date": FieldSchema(name="award_date", type=date, is_optional=True, is_list=False),
         "awardee": FieldSchema(name="awardee", type=str, is_optional=True, is_list=False),
         "awardee_uei": FieldSchema(name="awardee_uei", type=str, is_optional=True, is_list=False),
+        "file_count": FieldSchema(name="file_count", type=int, is_optional=True, is_list=False),
+        "link_count": FieldSchema(name="link_count", type=int, is_optional=True, is_list=False),
         "meta": FieldSchema(
             name="meta", type=dict, is_optional=True, is_list=False, nested_model="Meta"
         ),