tango-python 1.10.0__tar.gz → 1.12.0__tar.gz

{tango_python-1.10.0 → tango_python-1.12.0}/CHANGELOG.md

@@ -7,6 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.12.0] - 2026-10-02
+
+### Added
+
+- **`account_category` and `source_anomalies` on budget accounts** (Tango API 5.7.0). Both are in the default `BUDGET_ACCOUNTS_MINIMAL` shape and accepted in custom shapes. `account_category` is `budgetary` or `credit_financing` today. `source_anomalies` lists the problems found in the source data behind an account, and is `[]` when there are none. Each element is typed as the new `BudgetAccountSourceAnomaly` `TypedDict` (with `BudgetAccountAnomalySource` and `BudgetAccountAnomalySourceRow` for its nested `source`), and every key is optional. Treat `account_category` and an anomaly's `code` as open strings, since new values may appear.
+- **`list_budget_accounts(account_category=..., account_category_in=...)`** filters by account category, exactly or against a comma-separated list.
+
+### Changed
+
+- **`list_budget_accounts()` documents the API's default ordering**: the latest fiscal year first, then largest `enacted_ba` first, with accounts that have no `enacted_ba` last.
+- Re-vendored `contracts/filter_shape_contract.json` (Tango API 5.7.0) and regenerated `tango/shapes/generated_overlay.py`.
+
+### Fixed
+
+- **`list_idvs()`, `list_idv_awards()`, `list_idv_child_idvs()` and `list_idv_transactions()` now return the API's pagination `cursor`.** They dropped it, so `response.cursor` was always `None` and a caller following the cursor stopped after the first page.
+
+## [1.11.0] - 2026-09-29
+
+### Added
+
+- **Award fields on opportunities and notices** (Tango API 5.5.0) — new `awarded` / `awardee_uei` filters on `list_opportunities()`, plus award leaves and an `awards(...)` expand in the opportunity and notice shapes (see `docs/API_REFERENCE.md`).
+
 ## [1.10.0] - 2026-09-29
 
 ### Added

{tango_python-1.10.0 → tango_python-1.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: tango-python
-Version: 1.10.0
+Version: 1.12.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.10.0 → tango_python-1.12.0}/docs/API_REFERENCE.md

@@ -868,6 +868,8 @@ opportunities = client.list_opportunities(
     # Filter parameters (all optional)
     active=None,
     agency=None,
+    awarded=None,
+    awardee_uei=None,
     first_notice_date_after=None,
     first_notice_date_before=None,
     last_notice_date_after=None,
@@ -894,6 +896,8 @@ opportunities = client.list_opportunities(
 **Filter Parameters:**
 - `active` - Filter by active status (bool)
 - `agency` - Filter by agency code
+- `awarded` - Whether the opportunity has an award, either posted on it or linked to it (bool). Requires Tango API 5.5.0
+- `awardee_uei` - Awardee UEI, case-insensitive; OR several with `|`. Requires Tango API 5.5.0
 - `first_notice_date_after` / `first_notice_date_before` - First notice date range
 - `last_notice_date_after` / `last_notice_date_before` - Last notice date range
 - `naics` - NAICS code
@@ -947,6 +951,33 @@ for attachment in opp["attachments"]:
 - A Free-plan request that names them gets the response without them, plus an entry in `meta.upgrade_hints`.
 - There is no filter on document role.
 
+**Award fields:**
+
+Tango API 5.5.0 adds award information to opportunities.
+None of it is in the SDK's default shape, so name the fields you want.
+
+```python
+opp = client.get_opportunity(
+    opportunity_id,
+    shape=(
+        "opportunity_id,title,awarded,award_date,award_amount,awardee,awardee_uei,"
+        "award_count,solicitation_opportunity_id,"
+        "awards(opportunity_id,notice_id,award_number,award_date,award_amount,awardee,awardee_uei)"
+    ),
+)
+
+awarded = client.list_opportunities(
+    awardee_uei="ABCDEF123456",
+    shape="opportunity_id,title,award_date,awardee",
+)
+```
+
+- `award_date`, `award_amount`, `awardee` and `awardee_uei` are filled only where SAM.gov posted an award notice; elsewhere they are null. `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, the award's `solicitation_opportunity_id` points back to the solicitation, and the solicitation's `awards(...)` lists up to ten of the most recent linked awards; `award_count` is the full count. An award notice that does not reference its solicitation is not linked.
+- `awarded` is true when the opportunity has an award of its own or has linked awards.
+- 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.
+
 ---
 
 ## Notices
@@ -1739,6 +1770,8 @@ accounts = client.list_budget_accounts(
     bea_category=None,
     on_off_budget=None,
     subfunction_code=None,
+    account_category=None,
+    account_category_in=None,
     search=None,
     ordering=None,
 )
@@ -1754,8 +1787,18 @@ accounts = client.list_budget_accounts(
 - `bea_category` - BEA category (exact)
 - `on_off_budget` - On/off budget flag (exact)
 - `subfunction_code` - Subfunction code (exact)
+- `account_category` - Account category (exact): `budgetary` or `credit_financing` today; treat it as an open string
+- `account_category_in` - Comma-separated account categories to match any of (e.g. `"budgetary,credit_financing"`)
 - `search` - Full-text search over `account_title`, `agency_name`, `bureau_name`
-- `ordering` - Sort field; prefix with `-` for descending
+- `ordering` - Sort field; prefix with `-` for descending. The default is the latest fiscal year first, then largest `enacted_ba` first, with accounts that have no `enacted_ba` last.
+
+**Source anomalies:** the default shape includes `account_category` and `source_anomalies`. `source_anomalies` is a list of problems found in the source data behind the account, and `[]` when there are none. Each element is a `BudgetAccountSourceAnomaly` (a `TypedDict`; every key is optional and may be `None`, so read keys with `.get()`): `code`, `field`, `bound_field`, `action` (`capped` or `flagged`), `reported_value`, `served_value`, `likely_cause`, `affected_fields`, `message`, and `source` (`dataset`, `fiscal_year`, and `rows` of `fiscal_period`, `piid`, `parent_piid`, `tas`, `reporting_agency_id`, `transaction_obligated_amount`, `file_c_source`). Today `code` is one of `contract_exceeds_obligations`, `assistance_exceeds_obligations` or `contract_without_obligations`; treat it as an open string. There is no filter on anomalies.
+
+```python
+for acct in client.list_budget_accounts(fiscal_year=2025).results:
+    for anomaly in acct["source_anomalies"] or []:
+        print(acct["federal_account_symbol"], anomaly.get("code"), anomaly.get("action"))
+```
 
 **Returns:** [PaginatedResponse](#paginatedresponse) of `BudgetAccount` records (see [ShapeConfig](#shapeconfig-predefined-shapes) for the default shape).
 
@@ -2516,7 +2559,7 @@ entity = client.get_entity("UEI_KEY", shape=ShapeConfig.ENTITIES_COMPREHENSIVE)
 | `FEDERAL_REGISTER_COMPREHENSIVE` | `get_federal_register_document` | The list fields plus dates, signing_date, start_page, end_page, volume, docket_ids, dockets, regulation_id_numbers, topics, correction_of, corrections, executive_order_number, presidential_document_number, proclamation_number, comment_url, regulations_dot_gov_url, raw_text_url, body_html_url (omits `full_text`) |
 | `EBUY_REQUESTS_MINIMAL` | `list_ebuy_requests` | rfq_id, request_type, title, schedule, sin, status, buyer_name, buyer_agency, buyer_agency_code, reference_number, issue_date, close_date, attachment_count, link_count, last_seen |
 | `EBUY_REQUESTS_COMPREHENSIVE` | `get_ebuy_request` | Every field, plus the `organization` and `attachments` expands |
-| `BUDGET_ACCOUNTS_MINIMAL` | `list_budget_accounts`, `get_budget_account` | id, federal_account_symbol, fiscal_year, agency_code/name, bureau_name, account_title, bea_category, on_off_budget, subfunction_code, lifecycle (requested/enacted/apportioned/obligated/outlayed/unobligated), contract & assistance rollups, key ratios, next-year growth |
+| `BUDGET_ACCOUNTS_MINIMAL` | `list_budget_accounts`, `get_budget_account` | id, federal_account_symbol, fiscal_year, agency_code/name, bureau_name, account_title, bea_category, on_off_budget, subfunction_code, account_category, lifecycle (requested/enacted/apportioned/obligated/outlayed/unobligated), contract & assistance rollups, key ratios, next-year growth, source_anomalies |
 | `VEHICLE_ORDERS_MINIMAL` | `list_vehicle_orders` | key, piid, award_date, recipient(display_name,uei), total_contract_value, obligated |
 | `ITDASHBOARD_INVESTMENTS_MINIMAL` | `list_itdashboard_investments` | Minimal IT Dashboard investment fields |
 | `ITDASHBOARD_INVESTMENTS_COMPREHENSIVE` | `get_itdashboard_investment` | Full investment fields: uii, agency_code, agency_name, bureau_code, bureau_name, investment_title, type_of_investment, part_of_it_portfolio, updated_time, url |

{tango_python-1.10.0 → tango_python-1.12.0}/pyproject.toml

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

{tango_python-1.10.0 → tango_python-1.12.0}/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.10.0"
+__version__ = "1.12.0"
 __all__ = [
     "TangoClient",
     "TangoAPIError",
@@ -72,6 +75,9 @@ __all__ = [
     "ResolveCandidate",
     "ResolveResult",
     "BudgetAccount",
+    "BudgetAccountAnomalySource",
+    "BudgetAccountAnomalySourceRow",
+    "BudgetAccountSourceAnomaly",
     "ContractAppeal",
     "FederalRegisterDocument",
     "EbuyAccess",

{tango_python-1.10.0 → tango_python-1.12.0}/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"),
         )
@@ -2346,6 +2350,9 @@ class TangoClient:
         search: str | None = None,
         set_aside: str | None = None,
         solicitation_number: str | None = None,
+        *,
+        awarded: bool | None = None,
+        awardee_uei: str | None = None,
     ) -> PaginatedResponse:
         """
         List contract opportunities/solicitations
@@ -2358,6 +2365,8 @@ class TangoClient:
             flat_lists: If True, flatten arrays using indexed keys
             active: Filter by active status
             agency: Agency filter
+            awarded: Filter by whether the opportunity has an award, either posted on it or linked to it from a separate award notice. Searches every opportunity rather than only active ones. Requires Tango API 5.5.0
+            awardee_uei: Filter by the awardee's UEI (case-insensitive). OR several with ``|``. Searches every opportunity rather than only active ones. Requires Tango API 5.5.0
             first_notice_date_after: First notice date after
             first_notice_date_before: First notice date before
             last_notice_date_after: Last notice date after
@@ -2387,6 +2396,8 @@ class TangoClient:
         for key, val in (
             ("active", active),
             ("agency", agency),
+            ("awarded", awarded),
+            ("awardee_uei", awardee_uei),
             ("first_notice_date_after", first_notice_date_after),
             ("first_notice_date_before", first_notice_date_before),
             ("last_notice_date_after", last_notice_date_after),
@@ -4437,6 +4448,8 @@ 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,
         # Range-numeric filters: each field also accepts ``__gte`` / ``__lte``.
         requested_ba: float | None = None,
         requested_ba_gte: float | None = None,
@@ -4543,6 +4556,11 @@ 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"``.
             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).
@@ -4585,7 +4603,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:
@@ -4608,6 +4628,8 @@ 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),
             ("search", search),
             ("ordering", ordering),
         )

{tango_python-1.10.0 → tango_python-1.12.0}/tango/models.py

@@ -565,6 +565,10 @@ class Opportunity:
     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``.
+
+    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.
     """
 
     opportunity_id: str
@@ -575,6 +579,15 @@ class Opportunity:
     active: bool | None = None
     naics_code: str | None = None
     psc_code: str | None = None
+    award_number: str | None = None
+    awarded: bool | None = None
+    award_date: date | None = None
+    award_amount: str | None = None
+    awardee: str | None = None
+    awardee_uei: str | None = None
+    award_count: int | None = None
+    solicitation_opportunity_id: str | None = None
+    awards: list[dict[str, Any]] | None = None
 
 
 @dataclass
@@ -593,6 +606,11 @@ class Notice:
     description: str | None = None
     posted_date: datetime | None = None
     naics_code: str | None = None
+    award_number: str | None = None
+    award_date: date | None = None
+    award_amount: str | None = None
+    awardee: str | None = None
+    awardee_uei: str | None = None
 
 
 @dataclass
@@ -768,6 +786,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).
@@ -787,6 +854,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
@@ -810,6 +879,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
@@ -1710,12 +1781,12 @@ class ShapeConfig:
     # 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,"
+        "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_python-1.10.0 → tango_python-1.12.0}/tango/shapes/generated_overlay.py

@@ -213,6 +213,16 @@ AWARDS_SCHEMA: dict[str, FieldSchema] = {
     "transactions": FieldSchema(name="transactions", type=str, is_optional=True, is_list=False),
 }
 
+AWARDS2_SCHEMA: dict[str, FieldSchema] = {
+    "award_amount": FieldSchema(name="award_amount", type=str, is_optional=True, is_list=False),
+    "award_date": FieldSchema(name="award_date", type=date, is_optional=True, is_list=False),
+    "award_number": FieldSchema(name="award_number", type=str, 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),
+    "notice_id": FieldSchema(name="notice_id", type=str, is_optional=True, is_list=False),
+    "opportunity_id": FieldSchema(name="opportunity_id", type=str, is_optional=True, is_list=False),
+}
+
 BUDGET_APPROPRIATION_SCHEMA: dict[str, FieldSchema] = {
     "cgac": FieldSchema(name="cgac", type=int, is_optional=True, is_list=False),
     "fiscal_year": FieldSchema(name="fiscal_year", type=int, is_optional=True, is_list=False),
@@ -1112,6 +1122,7 @@ GENERATED_NESTED: dict[str, dict[str, FieldSchema]] = {
     "AwardingOffice": AWARDING_OFFICE_SCHEMA,
     "AwardingOffice2": AWARDING_OFFICE2_SCHEMA,
     "Awards": AWARDS_SCHEMA,
+    "Awards2": AWARDS2_SCHEMA,
     "BudgetAppropriation": BUDGET_APPROPRIATION_SCHEMA,
     "BudgetSpending": BUDGET_SPENDING_SCHEMA,
     "Children": CHILDREN_SCHEMA,
@@ -1214,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
         ),
@@ -1399,6 +1413,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
         ),
@@ -2228,6 +2245,10 @@ GENERATED_OVERLAY: dict[str, dict[str, FieldSchema]] = {
             is_list=True,
             nested_model="Attachments",
         ),
+        "award_amount": FieldSchema(name="award_amount", type=str, is_optional=True, is_list=False),
+        "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),
         "meta": FieldSchema(
             name="meta", type=dict, is_optional=True, is_list=False, nested_model="Meta"
         ),
@@ -2476,6 +2497,15 @@ GENERATED_OVERLAY: dict[str, dict[str, FieldSchema]] = {
             is_list=False,
             nested_model="Attachments5",
         ),
+        "award_amount": FieldSchema(name="award_amount", type=str, is_optional=True, is_list=False),
+        "award_count": FieldSchema(name="award_count", type=int, is_optional=True, is_list=False),
+        "award_date": FieldSchema(name="award_date", type=date, is_optional=True, is_list=False),
+        "awarded": FieldSchema(name="awarded", type=bool, 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),
+        "awards": FieldSchema(
+            name="awards", type=dict, is_optional=True, is_list=True, nested_model="Awards2"
+        ),
         "department": FieldSchema(
             name="department",
             type=dict,
@@ -2529,6 +2559,9 @@ GENERATED_OVERLAY: dict[str, dict[str, FieldSchema]] = {
             nested_model="CodeDescription",
         ),
         "snippet": FieldSchema(name="snippet", type=str, is_optional=True, is_list=False),
+        "solicitation_opportunity_id": FieldSchema(
+            name="solicitation_opportunity_id", type=str, is_optional=True, is_list=False
+        ),
     },
     "Organization": {
         "aac_code": FieldSchema(name="aac_code", type=str, is_optional=True, is_list=False),

{tango_python-1.10.0 → tango_python-1.12.0}/tests/test_client.py

@@ -271,6 +271,34 @@ class TestTangoClient:
         assert otas.results[0]["key"] == "OTA-1"
         assert otas.cursor == "next-page-token"
 
+    @pytest.mark.parametrize(
+        ("method", "args"),
+        [
+            ("list_idvs", ()),
+            ("list_idv_awards", ("IDV-1",)),
+            ("list_idv_child_idvs", ("IDV-1",)),
+            ("list_idv_transactions", ("IDV-1",)),
+        ],
+    )
+    @patch("tango.client.httpx.Client.request")
+    def test_idv_list_methods_return_cursor(self, mock_request, method, args):
+        mock_response = Mock()
+        mock_response.is_success = True
+        mock_response.json.return_value = {
+            "count": 250,
+            "next": "https://tango.makegov.com/api/idvs/?cursor=next-page-token",
+            "previous": None,
+            "results": [{"key": "IDV-1"}],
+            "cursor": "next-page-token",
+        }
+        mock_response.content = b'{"count": 250}'
+        mock_request.return_value = mock_response
+
+        client = TangoClient(api_key="test-key")
+        page = getattr(client, method)(*args, limit=1)
+
+        assert page.cursor == "next-page-token"
+
     @patch("tango.client.httpx.Client.request")
     def test_list_otidvs_with_default_shape(self, mock_request):
         """Test list_otidvs uses default minimal shape"""
@@ -573,6 +601,113 @@ class TestTangoClient:
         ]
         assert leaked == [], f"unexpected filter keys sent: {leaked}"
 
+    @patch("tango.client.httpx.Client.request")
+    def test_list_budget_accounts_account_category_filters(self, mock_request):
+        mock_response = Mock()
+        mock_response.is_success = True
+        mock_response.json.return_value = {
+            "count": 0,
+            "next": None,
+            "previous": None,
+            "results": [],
+        }
+        mock_response.content = b'{"count": 0, "results": []}'
+        mock_request.return_value = mock_response
+
+        client = TangoClient(api_key="test-key")
+        client.list_budget_accounts(
+            account_category="credit_financing",
+            account_category_in="budgetary,credit_financing",
+        )
+
+        params = mock_request.call_args[1]["params"]
+        assert params["account_category"] == "credit_financing"
+        assert params["account_category__in"] == "budgetary,credit_financing"
+
+    @patch("tango.client.httpx.Client.request")
+    def test_list_budget_accounts_default_shape_parses_source_anomalies(self, mock_request):
+        anomaly = {
+            "code": "contract_exceeds_obligations",
+            "field": "contract_obligated",
+            "bound_field": "obligated_total",
+            "action": "capped",
+            "reported_value": 1250.0,
+            "served_value": 1000.0,
+            "likely_cause": None,
+            "affected_fields": ["contract_obligated", "contract_share_of_obligated"],
+            "message": "Contract obligations exceed total obligations.",
+            "source": {
+                "dataset": "file_c",
+                "fiscal_year": 2025,
+                "rows": [
+                    {
+                        "fiscal_period": 12,
+                        "piid": "ABC123",
+                        "parent_piid": None,
+                        "tas": "012-1234",
+                        "reporting_agency_id": "012",
+                        "transaction_obligated_amount": 1250.0,
+                        "file_c_source": "award",
+                    }
+                ],
+            },
+        }
+        mock_response = Mock()
+        mock_response.is_success = True
+        mock_response.json.return_value = {
+            "count": 2,
+            "next": None,
+            "previous": None,
+            "results": [
+                {
+                    "id": 1,
+                    "fiscal_year": 2025,
+                    "account_category": "budgetary",
+                    "source_anomalies": [anomaly],
+                },
+                {
+                    "id": 2,
+                    "fiscal_year": 2025,
+                    "account_category": "credit_financing",
+                    "enacted_ba": None,
+                    "source_anomalies": [],
+                },
+            ],
+        }
+        mock_response.content = b"{}"
+        mock_request.return_value = mock_response
+
+        client = TangoClient(api_key="test-key")
+        page = client.list_budget_accounts()
+
+        shape_fields = mock_request.call_args[1]["params"]["shape"].split(",")
+        assert "account_category" in shape_fields
+        assert "source_anomalies" in shape_fields
+        first, second = page.results
+        assert first["account_category"] == "budgetary"
+        assert first["source_anomalies"] == [anomaly]
+        assert first["source_anomalies"][0]["source"]["rows"][0]["piid"] == "ABC123"
+        assert second["account_category"] == "credit_financing"
+        assert second["source_anomalies"] == []
+
+    @patch("tango.client.httpx.Client.request")
+    def test_get_budget_account_accepts_explicit_anomaly_shape(self, mock_request):
+        mock_response = Mock()
+        mock_response.is_success = True
+        mock_response.json.return_value = {
+            "id": 7,
+            "account_category": "budgetary",
+            "source_anomalies": [{"code": "some_future_code"}],
+        }
+        mock_response.content = b"{}"
+        mock_request.return_value = mock_response
+
+        client = TangoClient(api_key="test-key")
+        account = client.get_budget_account(7, shape="id,account_category,source_anomalies")
+
+        assert account["source_anomalies"] == [{"code": "some_future_code"}]
+        assert account["account_category"] == "budgetary"
+
 
 class TestShapeConfig:
     """Test ShapeConfig class"""