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

tango/__init__.py

@@ -11,6 +11,9 @@ from .exceptions import (
 )
 from .models import (
     BudgetAccount,
+    BudgetAccountAnomalySource,
+    BudgetAccountAnomalySourceRow,
+    BudgetAccountSourceAnomaly,
     ContractAppeal,
     DibbsAward,
     DibbsRfp,
@@ -59,7 +62,7 @@ from .webhooks import (
 )
 from .webhooks.receiver import Delivery, WebhookReceiver
 
-__version__ = "1.11.0"
+__version__ = "1.13.0"
 __all__ = [
     "TangoClient",
     "TangoAPIError",
@@ -72,6 +75,9 @@ __all__ = [
     "ResolveCandidate",
     "ResolveResult",
     "BudgetAccount",
+    "BudgetAccountAnomalySource",
+    "BudgetAccountAnomalySourceRow",
+    "BudgetAccountSourceAnomaly",
     "ContractAppeal",
     "FederalRegisterDocument",
     "EbuyAccess",

tango/client.py

@@ -986,6 +986,7 @@ class TangoClient:
             next=data.get("next"),
             previous=data.get("previous"),
             results=results,
+            cursor=data.get("cursor"),
             page_metadata=data.get("page_metadata"),
             meta=data.get("meta"),
         )
@@ -1088,6 +1089,7 @@ class TangoClient:
             next=data.get("next"),
             previous=data.get("previous"),
             results=results,
+            cursor=data.get("cursor"),
             page_metadata=data.get("page_metadata"),
             meta=data.get("meta"),
         )
@@ -1133,6 +1135,7 @@ class TangoClient:
             next=data.get("next"),
             previous=data.get("previous"),
             results=results,
+            cursor=data.get("cursor"),
             page_metadata=data.get("page_metadata"),
             meta=data.get("meta"),
         )
@@ -1150,6 +1153,7 @@ class TangoClient:
             next=data.get("next"),
             previous=data.get("previous"),
             results=data.get("results") or [],
+            cursor=data.get("cursor"),
             page_metadata=data.get("page_metadata"),
             meta=data.get("meta"),
         )
@@ -4444,6 +4448,12 @@ class TangoClient:
         bea_category: str | None = None,
         on_off_budget: str | None = None,
         subfunction_code: str | None = None,
+        account_category: str | None = None,
+        account_category_in: str | None = None,
+        data_through_period: int | None = None,
+        data_through_period_gte: int | None = None,
+        data_through_period_lte: int | None = None,
+        data_through_period_isnull: bool | None = None,
         # Range-numeric filters: each field also accepts ``__gte`` / ``__lte``.
         requested_ba: float | None = None,
         requested_ba_gte: float | None = None,
@@ -4550,6 +4560,13 @@ class TangoClient:
             bea_category: BEA category (exact).
             on_off_budget: On/off budget flag (exact).
             subfunction_code: Subfunction code (exact).
+            account_category: Account category (exact), e.g. ``budgetary`` or
+                ``credit_financing``. Treat the value as an open string; new
+                categories may be added.
+            account_category_in: Comma-separated account categories to match
+                any of, e.g. ``"budgetary,credit_financing"``.
+            data_through_period: File A period (1-12) the account-year's figures run through (exact). Also ``data_through_period_gte`` / ``data_through_period_lte``; a value below 12 means a partial year.
+            data_through_period_isnull: ``True`` for accounts with no File A data, ``False`` for accounts with it.
             requested_ba: President's-budget requested BA (exact). Also
                 ``requested_ba_gte`` / ``requested_ba_lte`` for range queries.
             enacted_ba: Enacted budget authority (exact / gte / lte).
@@ -4592,7 +4609,9 @@ class TangoClient:
             ordering: Sort field (prefix with '-' for descending). Any of the
                 numeric fields above is a valid ordering target — e.g.
                 ``ordering="-unobligated_balance"`` to rank by largest
-                headroom first.
+                headroom first. The default ordering is the latest fiscal year
+                first, then largest ``enacted_ba`` first, with accounts that
+                have no ``enacted_ba`` sorted last.
         """
         params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
         if shape is None:
@@ -4615,11 +4634,19 @@ class TangoClient:
             ("bea_category", bea_category),
             ("on_off_budget", on_off_budget),
             ("subfunction_code", subfunction_code),
+            ("account_category", account_category),
+            ("account_category__in", account_category_in),
+            ("data_through_period", data_through_period),
+            ("data_through_period__gte", data_through_period_gte),
+            ("data_through_period__lte", data_through_period_lte),
+            ("data_through_period__isnull", data_through_period_isnull),
             ("search", search),
             ("ordering", ordering),
         )
         for key, val in scalar_filters:
-            if val is not None:
+            if isinstance(val, bool):
+                params[key] = "true" if val else "false"
+            elif val is not None:
                 params[key] = val
         # Range-numeric filters: each field has exact / __gte / __lte forms.
         range_filters: tuple[tuple[str, float | None, float | None, float | None], ...] = (

tango/models.py

@@ -489,6 +489,8 @@ class Vehicle:
     program_acronym: str | None = None
     description: str | None = None
     idv_count: int | None = None
+    holder_count: int | None = None
+    order_winner_count: int | None = None
     total_obligated: Decimal | None = None
     latest_award_date: date | None = None
     solicitation_title: str | None = None
@@ -786,6 +788,55 @@ class ValidateResult:
     errors: list[str] | None = None
 
 
+class BudgetAccountAnomalySourceRow(TypedDict, total=False):
+    """One source record behind a budget-account source anomaly.
+
+    Every key is optional and any value may be ``None``.
+    """
+
+    fiscal_period: int | None
+    piid: str | None
+    parent_piid: str | None
+    tas: str | None
+    reporting_agency_id: str | None
+    transaction_obligated_amount: float | str | None
+    file_c_source: str | None
+
+
+class BudgetAccountAnomalySource(TypedDict, total=False):
+    """Where a budget-account source anomaly was found.
+
+    Every key is optional and any value may be ``None``.
+    """
+
+    dataset: str | None
+    fiscal_year: int | None
+    rows: list[BudgetAccountAnomalySourceRow] | None
+
+
+class BudgetAccountSourceAnomaly(TypedDict, total=False):
+    """One problem found in the source data behind a budget account.
+
+    An element of ``BudgetAccount.source_anomalies``. Every key is optional and
+    any value may be ``None``, so read keys with ``.get()``. ``code`` and
+    ``action`` are open strings: today ``code`` is one of
+    ``contract_exceeds_obligations``, ``assistance_exceeds_obligations`` or
+    ``contract_without_obligations``, and ``action`` is ``capped`` or
+    ``flagged``, but new values may appear.
+    """
+
+    code: str | None
+    field: str | None
+    bound_field: str | None
+    action: str | None
+    reported_value: float | str | None
+    served_value: float | str | None
+    likely_cause: str | None
+    affected_fields: list[str] | None
+    message: str | None
+    source: BudgetAccountAnomalySource | None
+
+
 @dataclass
 class BudgetAccount:
     """Schema definition for BudgetAccount (not used for instances).
@@ -798,6 +849,8 @@ class BudgetAccount:
     id: int | None = None
     federal_account_symbol: str | None = None
     fiscal_year: int | None = None
+    # File A period (1-12) this account-year's figures run through; below 12 the year is partial, and `None` means no File A data.
+    data_through_period: int | None = None
     agency_code: str | None = None
     agency_name: str | None = None
     bureau_name: str | None = None
@@ -805,6 +858,8 @@ class BudgetAccount:
     bea_category: str | None = None
     on_off_budget: str | None = None
     subfunction_code: str | None = None
+    # ``budgetary`` or ``credit_financing`` today; treat as an open string.
+    account_category: str | None = None
     # Lifecycle
     requested_ba: Decimal | None = None
     enacted_ba: Decimal | None = None
@@ -828,6 +883,8 @@ class BudgetAccount:
     assistance_share_of_obligated: Decimal | None = None
     assistance_share_of_obligated_capped: Decimal | None = None
     assistance_share_capped_flag: bool | None = None
+    # Problems found in the source data; ``[]`` when there are none.
+    source_anomalies: list[BudgetAccountSourceAnomaly] | None = None
     # Forward-look
     next_year_requested_ba: Decimal | None = None
     ba_growth_next_year: Decimal | None = None
@@ -1699,7 +1756,7 @@ class ShapeConfig:
     VEHICLES_MINIMAL: Final = (
         "uuid,solicitation_identifier,is_synthetic_solicitation,program_acronym,"
         "organization_id,organization,vehicle_type,description,"
-        "idv_count,awardee_count,order_count,total_obligated,"
+        "idv_count,holder_count,order_winner_count,awardee_count,order_count,total_obligated,"
         "vehicle_obligations,vehicle_contracts_value,latest_award_date,"
         "solicitation_title,solicitation_date"
     )
@@ -1711,7 +1768,8 @@ class ShapeConfig:
         "solicitation_title,solicitation_description,solicitation_date,opportunity_id,"
         "naics_code,psc_code,set_aside,"
         "fiscal_year,award_date,latest_award_date,last_date_to_order,"
-        "description,idv_count,awardee_count,order_count,total_obligated,"
+        "description,idv_count,holder_count,order_winner_count,awardee_count,order_count,"
+        "total_obligated,"
         "vehicle_obligations,vehicle_contracts_value,"
         "type_of_idc,contract_type,metrics(*)"
     )
@@ -1727,13 +1785,14 @@ class ShapeConfig:
     # Default for list_budget_accounts() / get_budget_account()
     # Mirrors the API's BUDGET_ACCOUNT_DEFAULT_SHAPE.
     BUDGET_ACCOUNTS_MINIMAL: Final = (
-        "id,federal_account_symbol,fiscal_year,agency_code,agency_name,bureau_name,"
-        "account_title,bea_category,on_off_budget,subfunction_code,"
+        "id,federal_account_symbol,fiscal_year,data_through_period,agency_code,agency_name,"
+        "bureau_name,"
+        "account_title,bea_category,on_off_budget,subfunction_code,account_category,"
         "requested_ba,enacted_ba,apportioned,obligated_total,outlayed_total,"
         "unobligated_balance,contract_obligated,contract_share_of_obligated_capped,"
         "assistance_obligated,obligated_to_apportioned_pct_capped,"
         "obligated_to_enacted_pct_capped,outlayed_to_obligated_pct_capped,"
-        "ba_growth_next_year_pct"
+        "ba_growth_next_year_pct,source_anomalies"
     )
 
     # Default for list_organizations()

tango/shapes/explicit_schemas.py

@@ -1337,6 +1337,11 @@ VEHICLE_SCHEMA: dict[str, FieldSchema] = {
     ),
     # Denormalized rollups
     "idv_count": FieldSchema(name="idv_count", type=int, is_optional=True, is_list=False),
+    "holder_count": FieldSchema(name="holder_count", type=int, is_optional=True, is_list=False),
+    "order_winner_count": FieldSchema(
+        name="order_winner_count", type=int, is_optional=True, is_list=False
+    ),
+    # Deprecated: same value as `order_winner_count`; removed at the next major API version.
     "awardee_count": FieldSchema(name="awardee_count", type=int, is_optional=True, is_list=False),
     "order_count": FieldSchema(name="order_count", type=int, is_optional=True, is_list=False),
     "total_obligated": FieldSchema(

tango/shapes/generated_overlay.py

@@ -1225,6 +1225,9 @@ GENERATED_OVERLAY: dict[str, dict[str, FieldSchema]] = {
         ),
     },
     "BudgetAccount": {
+        "account_category": FieldSchema(
+            name="account_category", type=str, is_optional=True, is_list=False
+        ),
         "account_narrative_excerpt": FieldSchema(
             name="account_narrative_excerpt", type=str, is_optional=True, is_list=False
         ),
@@ -1315,6 +1318,9 @@ GENERATED_OVERLAY: dict[str, dict[str, FieldSchema]] = {
             name="contract_share_of_obligated_capped", type=str, is_optional=True, is_list=False
         ),
         "created": FieldSchema(name="created", type=datetime, is_optional=True, is_list=False),
+        "data_through_period": FieldSchema(
+            name="data_through_period", type=int, is_optional=True, is_list=False
+        ),
         "enacted_ba": FieldSchema(name="enacted_ba", type=str, is_optional=True, is_list=False),
         "enacted_ba_5yr_cagr": FieldSchema(
             name="enacted_ba_5yr_cagr", type=str, is_optional=True, is_list=False
@@ -1410,6 +1416,9 @@ GENERATED_OVERLAY: dict[str, dict[str, FieldSchema]] = {
         "requested_personnel_share": FieldSchema(
             name="requested_personnel_share", type=str, is_optional=True, is_list=False
         ),
+        "source_anomalies": FieldSchema(
+            name="source_anomalies", type=dict, is_optional=True, is_list=True
+        ),
         "subfunction_code": FieldSchema(
             name="subfunction_code", type=str, is_optional=True, is_list=False
         ),

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

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

@@ -1,11 +1,11 @@
-tango/__init__.py,sha256=nM2IFpjrIua3MzTAR1bedo7DRmTgJ0DU9YeRQOlDXQA,2535
-tango/client.py,sha256=3jxYp3Dcgy8cVUpy0uK0H_qQbfKrgWMq3k65bm0uadg,238519
+tango/__init__.py,sha256=L5_oz-laG934CX8HE8EOPEPW1a7JHmXo7dsTLwCGC5c,2739
+tango/client.py,sha256=N-EKUT2OquRrjpInxK0ZnWVTuDP5ylEXadshjvxO6ng,240281
 tango/exceptions.py,sha256=oPiLCccBoWLK5SjHkzP-oI6mUD9twEeKSvEuLV5h01I,4224
-tango/models.py,sha256=WkIK_Ym36afRych_EtlGk5Ki3aevL14klk0SCiCDxgU,67741
+tango/models.py,sha256=w7z49WIMcvvEt05J1DpuUPcFWBq_MbCWa4a-f-YLsVs,69936
 tango/shapes/__init__.py,sha256=7ea1WU74jp4znhNw-gXruag6m6eyPZtbVgbDFmFUWro,1072
-tango/shapes/explicit_schemas.py,sha256=spYyMmWKOiMJygz9yViBQrjIxUPFfv7HpVkJcWy13x8,84021
+tango/shapes/explicit_schemas.py,sha256=tqGitlPoXN4VDfwCU5T4KfzLfQTyZ2Ephap56bDbB3c,84334
 tango/shapes/factory.py,sha256=uDPhnp6VVzrLBKodxteZy5AcU43juEv-qKVRWth51j0,31550
-tango/shapes/generated_overlay.py,sha256=RrCqR-iwBnUbr5dtPQ_f78fnrWcfLf_fP9EtfHKIdw4,140461
+tango/shapes/generated_overlay.py,sha256=fyCgKDueIKUcTMtij793mtJcAsC8RynMhU5FXI_9hG0,140860
 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.11.0.dist-info/METADATA,sha256=l9-XAukNLKq3XM_V8zjXOzALwqo6MeGBIFtdEsW9kuY,22118
-tango_python-1.11.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-tango_python-1.11.0.dist-info/entry_points.txt,sha256=kGLUbglUjuaAqEFvOZ1QuSW0vWb6VeSpCIFKaOFkKoQ,50
-tango_python-1.11.0.dist-info/licenses/LICENSE,sha256=j2kYVHMwTkoGn3ZNScnrdIueG0k2XzB_LCPFoyBc2wk,1064
-tango_python-1.11.0.dist-info/RECORD,,
+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,,