tango-python 1.17.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.17.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]:
@@ -695,7 +725,7 @@ class TangoClient:
             naics_code: NAICS code (mapped to 'naics' API param)
             psc_code: PSC code (mapped to 'psc' API param)
             recipient_name: Vendor/recipient name (mapped to 'recipient' API param)
-            recipient_uei: Vendor UEI (mapped to 'uei' API param)
+            recipient_uei: Vendor UEI (mapped to 'uei' API param); join several with `|` for OR, up to 500
             set_aside_type: Set-aside type (mapped to 'set_aside' API param)
             sort: Field to sort by (combined with 'order' to produce 'ordering')
             order: Sort order ('asc' or 'desc', default 'asc')

tango/models.py

@@ -281,6 +281,17 @@ class AwardTransaction:
     obligated: Decimal | None = None
 
 
+@dataclass
+class FiscalYearObligation:
+    """Schema definition for FiscalYearObligation (not used for instances).
+
+    One entry of an award's ``obligations_by_fiscal_year``: the obligations dated in one federal fiscal year, rounded to cents.
+    """
+
+    fiscal_year: int
+    obligated: Decimal
+
+
 @dataclass
 class OrganizationOfficePayload:
     """Schema definition for OrganizationOfficePayload (not used for instances).

tango/shapes/explicit_schemas.py

@@ -197,6 +197,12 @@ TRANSACTION_SCHEMA: dict[str, FieldSchema] = {
 }
 
 
+FISCAL_YEAR_OBLIGATION_SCHEMA: dict[str, FieldSchema] = {
+    "fiscal_year": FieldSchema(name="fiscal_year", type=int, is_optional=False, is_list=False),
+    "obligated": FieldSchema(name="obligated", type=Decimal, is_optional=False, is_list=False),
+}
+
+
 DEPARTMENT_SCHEMA: dict[str, FieldSchema] = {
     "abbreviation": FieldSchema(name="abbreviation", type=str, is_optional=True, is_list=False),
     "code": FieldSchema(name="code", type=int, is_optional=True, is_list=False),
@@ -432,6 +438,13 @@ CONTRACT_SCHEMA: dict[str, FieldSchema] = {
         is_list=False,
         nested_model="Vehicle",
     ),
+    "obligations_by_fiscal_year": FieldSchema(
+        name="obligations_by_fiscal_year",
+        type=dict,
+        is_optional=True,
+        is_list=True,
+        nested_model="FiscalYearObligation",
+    ),
 }
 
 
@@ -1290,6 +1303,13 @@ IDV_SCHEMA: dict[str, FieldSchema] = {
     "idv_contracts_value": FieldSchema(
         name="idv_contracts_value", type=Decimal, is_optional=True, is_list=False
     ),
+    "obligations_by_fiscal_year": FieldSchema(
+        name="obligations_by_fiscal_year",
+        type=dict,
+        is_optional=True,
+        is_list=True,
+        nested_model="FiscalYearObligation",
+    ),
 }
 
 
@@ -1439,6 +1459,13 @@ OTA_SCHEMA: dict[str, FieldSchema] = {
         is_list=False,
         nested_model="RecipientProfile",
     ),
+    "obligations_by_fiscal_year": FieldSchema(
+        name="obligations_by_fiscal_year",
+        type=dict,
+        is_optional=True,
+        is_list=True,
+        nested_model="FiscalYearObligation",
+    ),
 }
 
 # OTIDV (Other Transaction IDV) - IDV-like
@@ -1459,6 +1486,13 @@ OTIDV_SCHEMA: dict[str, FieldSchema] = {
         is_list=False,
         nested_model="RecipientProfile",
     ),
+    "obligations_by_fiscal_year": FieldSchema(
+        name="obligations_by_fiscal_year",
+        type=dict,
+        is_optional=True,
+        is_list=True,
+        nested_model="FiscalYearObligation",
+    ),
 }
 
 # Subaward (prime/sub awards)
@@ -1707,6 +1741,7 @@ EXPLICIT_SCHEMAS: dict[str, dict[str, FieldSchema]] = {
     "LegislativeMandates": LEGISLATIVE_MANDATES_SCHEMA,
     "SubawardsSummary": SUBAWARDS_SUMMARY_SCHEMA,
     "Transaction": TRANSACTION_SCHEMA,
+    "FiscalYearObligation": FISCAL_YEAR_OBLIGATION_SCHEMA,
     "Department": DEPARTMENT_SCHEMA,
     "Contact": CONTACT_SCHEMA,
     "RecipientProfile": RECIPIENT_PROFILE_SCHEMA,

tango/shapes/generated_overlay.py

@@ -85,6 +85,9 @@ ATTACHMENTS_SCHEMA: dict[str, FieldSchema] = {
     "doc_role": FieldSchema(name="doc_role", type=str, is_optional=True, is_list=False),
     "doc_role_alt": FieldSchema(name="doc_role_alt", type=str, is_optional=True, is_list=False),
     "extracted_text": FieldSchema(name="extracted_text", type=str, is_optional=True, is_list=False),
+    "extraction_status": FieldSchema(
+        name="extraction_status", type=str, is_optional=True, is_list=False
+    ),
     "file_size": FieldSchema(name="file_size", type=int, is_optional=True, is_list=False),
     "mime_type": FieldSchema(name="mime_type", type=str, is_optional=True, is_list=False),
     "name": FieldSchema(name="name", type=str, is_optional=True, is_list=False),
@@ -99,6 +102,9 @@ ATTACHMENTS2_SCHEMA: dict[str, FieldSchema] = {
     "doc_role": FieldSchema(name="doc_role", type=str, is_optional=True, is_list=False),
     "doc_role_alt": FieldSchema(name="doc_role_alt", type=str, is_optional=True, is_list=False),
     "extracted_text": FieldSchema(name="extracted_text", type=str, is_optional=True, is_list=False),
+    "extraction_status": FieldSchema(
+        name="extraction_status", type=str, is_optional=True, is_list=False
+    ),
     "file_size": FieldSchema(name="file_size", type=int, is_optional=True, is_list=False),
     "mime_type": FieldSchema(name="mime_type", type=str, is_optional=True, is_list=False),
     "name": FieldSchema(name="name", type=str, is_optional=True, is_list=False),
@@ -135,6 +141,9 @@ ATTACHMENTS3_SCHEMA: dict[str, FieldSchema] = {
 
 ATTACHMENTS4_SCHEMA: dict[str, FieldSchema] = {
     "attachment_id": FieldSchema(name="attachment_id", type=str, is_optional=True, is_list=False),
+    "extraction_status": FieldSchema(
+        name="extraction_status", type=str, is_optional=True, is_list=False
+    ),
     "file_size": FieldSchema(name="file_size", type=str, is_optional=True, is_list=False),
     "mime_type": FieldSchema(name="mime_type", type=str, is_optional=True, is_list=False),
     "name": FieldSchema(name="name", type=str, is_optional=True, is_list=False),
@@ -149,6 +158,9 @@ ATTACHMENTS5_SCHEMA: dict[str, FieldSchema] = {
     "doc_role": FieldSchema(name="doc_role", type=str, is_optional=True, is_list=False),
     "doc_role_alt": FieldSchema(name="doc_role_alt", type=str, is_optional=True, is_list=False),
     "extracted_text": FieldSchema(name="extracted_text", type=str, is_optional=True, is_list=False),
+    "extraction_status": FieldSchema(
+        name="extraction_status", type=str, is_optional=True, is_list=False
+    ),
     "file_size": FieldSchema(name="file_size", type=str, is_optional=True, is_list=False),
     "mime_type": FieldSchema(name="mime_type", type=str, is_optional=True, is_list=False),
     "name": FieldSchema(name="name", type=str, is_optional=True, is_list=False),
@@ -758,6 +770,11 @@ NOTICE_TYPE_SCHEMA: dict[str, FieldSchema] = {
     "type": FieldSchema(name="type", type=str, is_optional=True, is_list=False),
 }
 
+OBLIGATIONS_BY_FISCAL_YEAR_SCHEMA: dict[str, FieldSchema] = {
+    "fiscal_year": FieldSchema(name="fiscal_year", type=str, is_optional=True, is_list=False),
+    "obligated": FieldSchema(name="obligated", type=str, is_optional=True, is_list=False),
+}
+
 OFFICERS_SCHEMA: dict[str, FieldSchema] = {
     "highly_compensated_officer_1_amount": FieldSchema(
         name="highly_compensated_officer_1_amount", type=Decimal, is_optional=True, is_list=False
@@ -1161,6 +1178,7 @@ GENERATED_NESTED: dict[str, dict[str, FieldSchema]] = {
     "NoticeHistory": NOTICE_HISTORY_SCHEMA,
     "NoticeHistory2": NOTICE_HISTORY2_SCHEMA,
     "NoticeType": NOTICE_TYPE_SCHEMA,
+    "ObligationsByFiscalYear": OBLIGATIONS_BY_FISCAL_YEAR_SCHEMA,
     "Officers": OFFICERS_SCHEMA,
     "Opportunity": OPPORTUNITY_SCHEMA,
     "Opportunity2": OPPORTUNITY2_SCHEMA,

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

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

@@ -1,11 +1,11 @@
-tango/__init__.py,sha256=hyJnoG92kgW1ylC060yUS0hjSTlNfG55AiwfmdnCPdA,2739
-tango/client.py,sha256=-T4k3sX1EgDF8Bya77lvwM8yqL72nPABYrd_tgtIF1g,244423
+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=2kyX6ogMWVNfsBbh1ah5hUgWFH1EQuArwUCHzrHRY4Y,72598
+tango/models.py,sha256=D9e8_AAAwVi1C4nOqdhWz-8ARBLPRsLGi8TDjucOMEY,72897
 tango/shapes/__init__.py,sha256=7ea1WU74jp4znhNw-gXruag6m6eyPZtbVgbDFmFUWro,1072
-tango/shapes/explicit_schemas.py,sha256=RCsUOVKe89WYPORVSAPKWX6u3If1DdI_7a94VTAbzrI,84525
+tango/shapes/explicit_schemas.py,sha256=fwjHiFLOMpFyNLNM4M6kdK603s-t8gxHYqcSeL3jz7g,85674
 tango/shapes/factory.py,sha256=uDPhnp6VVzrLBKodxteZy5AcU43juEv-qKVRWth51j0,31550
-tango/shapes/generated_overlay.py,sha256=7UwqTeqNW4NIuwsQlKVZgBlH2biEVBdEZ4z2IwiS1k4,141244
+tango/shapes/generated_overlay.py,sha256=vMrv0V_ShmP1-WxEW2o6Bv3IpmPMDl9ABtFj9Mo9YRY,142045
 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.17.0.dist-info/METADATA,sha256=rZoauk0_jIBk6yraVOv_-FgWVcsRPDCFG2USzRdHYEo,22824
-tango_python-1.17.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-tango_python-1.17.0.dist-info/entry_points.txt,sha256=kGLUbglUjuaAqEFvOZ1QuSW0vWb6VeSpCIFKaOFkKoQ,50
-tango_python-1.17.0.dist-info/licenses/LICENSE,sha256=j2kYVHMwTkoGn3ZNScnrdIueG0k2XzB_LCPFoyBc2wk,1064
-tango_python-1.17.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,,