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

tango/__init__.py

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

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
@@ -1352,6 +1365,10 @@ class EbuyAttachment:
     """Schema definition for one entry in an eBuy request's ``attachments`` (not used for instances).
 
     ``is_link=True`` means the entry is an outbound URL in ``doc_path`` with no stored document behind it, so ``get_ebuy_attachment_url()`` raises ``TangoAttachmentLinkError`` for it.
+
+    ``extracted_text`` (Tango API 5.9.1) is the text extracted from the attachment's document.
+    It must be named, e.g. ``attachments(doc_seq_num,doc_name,extracted_text)``, because neither the default response nor ``attachments(*)`` includes it.
+    An attachment with no text (a link, an empty scan, or a document not yet extracted) omits the key from the API response rather than returning null; the SDK's shaped result reads that as ``None``.
     """
 
     doc_seq_num: int | None = None
@@ -1360,6 +1377,7 @@ class EbuyAttachment:
     doc_path: str | None = None
     is_link: bool | None = None
     doc_session_date: datetime | None = None
+    extracted_text: str | None = None
 
 
 class EbuyRequest:
@@ -1454,11 +1472,10 @@ 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.
@@ -1648,7 +1665,7 @@ class ShapeConfig:
         "link_count,last_seen"
     )
 
-    # Default for get_ebuy_request(). Mirrors the API's own retrieve default; the attachment fields are named rather than `attachments(*)` so their dates parse.
+    # Default for get_ebuy_request(). Mirrors the API's own retrieve default; the attachment fields are named rather than `attachments(*)` so their dates parse. `extracted_text` is left out because document bodies are large and the API serves them only when named.
     EBUY_REQUESTS_COMPREHENSIVE: Final = (
         "rfq_id,request_type,title,description,schedule,sin,status,buyer_name,"
         "buyer_agency,buyer_agency_code,buyer_email,buyer_user_id,reference_number,"

tango/shapes/explicit_schemas.py

@@ -886,6 +886,8 @@ EBUY_ATTACHMENT_SCHEMA: dict[str, FieldSchema] = {
     "doc_session_date": FieldSchema(
         name="doc_session_date", type=datetime, is_optional=True, is_list=False
     ),
+    # Only when named in the shape; the API omits the key for an attachment with no text.
+    "extracted_text": FieldSchema(name="extracted_text", type=str, is_optional=True, is_list=False),
 }
 
 

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"
         ),

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

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

@@ -1,11 +1,11 @@
-tango/__init__.py,sha256=XZv0Q3i4cb0rMu4DTMvB6vthWIQsgfmgnTt5EVnqdac,2739
+tango/__init__.py,sha256=_eYomSjLflugfMOs-MzscP6WX7UWlC63YvuwqX87PU4,2739
 tango/client.py,sha256=1Z748iPEPdVi8_Sq9XPES8RnPdnugEwL3yAgV7Cvvt0,243419
 tango/exceptions.py,sha256=oPiLCccBoWLK5SjHkzP-oI6mUD9twEeKSvEuLV5h01I,4224
-tango/models.py,sha256=Is7HRH3xLy8k82aeRqaJU6zaxZ7CSui4D5Pg9q7Pr9Y,70257
+tango/models.py,sha256=2kyX6ogMWVNfsBbh1ah5hUgWFH1EQuArwUCHzrHRY4Y,72598
 tango/shapes/__init__.py,sha256=7ea1WU74jp4znhNw-gXruag6m6eyPZtbVgbDFmFUWro,1072
-tango/shapes/explicit_schemas.py,sha256=tqGitlPoXN4VDfwCU5T4KfzLfQTyZ2Ephap56bDbB3c,84334
+tango/shapes/explicit_schemas.py,sha256=RCsUOVKe89WYPORVSAPKWX6u3If1DdI_7a94VTAbzrI,84525
 tango/shapes/factory.py,sha256=uDPhnp6VVzrLBKodxteZy5AcU43juEv-qKVRWth51j0,31550
-tango/shapes/generated_overlay.py,sha256=fyCgKDueIKUcTMtij793mtJcAsC8RynMhU5FXI_9hG0,140860
+tango/shapes/generated_overlay.py,sha256=7UwqTeqNW4NIuwsQlKVZgBlH2biEVBdEZ4z2IwiS1k4,141244
 tango/shapes/generator.py,sha256=xzakpwTwqTMUr89I06hp54-FIYZziviWHk2Glscg-LM,22775
 tango/shapes/models.py,sha256=h3pIhOqrrdlN953Y6r0oney5HFbKPOD-frRndRWimJ0,3018
 tango/shapes/parser.py,sha256=AecNx5oT_hV_pf2AWZnsR8Y2aLmCtjfgS9-znA2Pesc,27429
@@ -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.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,,
+tango_python-1.16.0.dist-info/METADATA,sha256=cAmejqQdWIlO6x7flbQye3-EktIp4eN2Kjdyp4sqlyQ,22824
+tango_python-1.16.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+tango_python-1.16.0.dist-info/entry_points.txt,sha256=kGLUbglUjuaAqEFvOZ1QuSW0vWb6VeSpCIFKaOFkKoQ,50
+tango_python-1.16.0.dist-info/licenses/LICENSE,sha256=j2kYVHMwTkoGn3ZNScnrdIueG0k2XzB_LCPFoyBc2wk,1064
+tango_python-1.16.0.dist-info/RECORD,,