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

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

@@ -7,6 +7,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.17.0] - 2026-10-16
+
+### Added
+
+- **`commercial_item_acquisition_procedures` filter on `list_contracts()` and `list_idvs()`** (Tango API 5.10.0). Filters by the FPDS commercial item acquisition procedures code: `A` (commercial products/services), `B` (products or services pursuant to FAR 12.102(f)), `C` (services pursuant to FAR 12.102(g)), `D` (commercial procedures not used) or `E` (DoD Section 803 Commercial Solutions Opening). Codes are case-insensitive and pipe-separated for OR, e.g. `"A|E"`; an unknown or multi-character code matches nothing. The API does not offer it on OTAs or OTIDVs, so `list_otas()` and `list_otidvs()` do not take it. The field itself was already returned in responses.
+
+### Changed
+
+- Re-vendored `contracts/filter_shape_contract.json` (Tango API 5.10.0).
+
+## [1.16.0] - 2026-10-10
+
+### Added
+
+- **Extracted text on eBuy request attachments** (Tango API 5.9.1). `attachments(extracted_text)` on eBuy requests returns the text extracted from an attachment's document. It is returned only when named: the default `get_ebuy_request()` shape and `attachments(*)` leave it out. An attachment with no text (an external link, an empty scan, or a document not yet extracted) is sent by the API without the key rather than with a null; the SDK's shaped result reads that as `None`.
+
+### Changed
+
+- Re-vendored `contracts/filter_shape_contract.json` (Tango API 5.9.1).
+
 ## [1.15.0] - 2026-10-06
 
 ### Added

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: tango-python
-Version: 1.15.0
+Version: 1.17.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.15.0 → tango_python-1.17.0}/docs/API_REFERENCE.md

@@ -244,6 +244,7 @@ contracts = client.list_contracts(
     naics_code=None,  # Mapped to 'naics' API param
     psc_code=None,  # Mapped to 'psc' API param
     set_aside_type=None,  # Mapped to 'set_aside' API param
+    commercial_item_acquisition_procedures=None,  # FPDS code A-E, e.g. "A|E"
     # Type filters
     fiscal_year=None,
     fiscal_year_gte=None,
@@ -290,6 +291,7 @@ contracts = client.list_contracts(
 - `naics_code` - NAICS industry code (mapped to 'naics' API param)
 - `psc_code` - Product/Service code (mapped to 'psc' API param)
 - `set_aside_type` - Set-aside type (mapped to 'set_aside' API param)
+- `commercial_item_acquisition_procedures` - FPDS commercial item acquisition procedures code, case-insensitive: `A` (commercial products/services), `B` (products or services pursuant to FAR 12.102(f)), `C` (services pursuant to FAR 12.102(g)), `D` (commercial procedures not used) or `E` (DoD Section 803 Commercial Solutions Opening). Multi-value OR via `|`, e.g. `"A|E"`. An unknown or multi-character code matches nothing.
 
 **Type Filters:**
 - `fiscal_year` - Federal fiscal year (exact match)
@@ -420,7 +422,7 @@ otas = client.list_otas(
 
 **Notes:**
 - Uses **keyset pagination** (`cursor` + `limit`) rather than page numbers.
-- Filter parameters mirror those on `list_contracts`.
+- Filter parameters mirror those on `list_contracts`, except `commercial_item_acquisition_procedures`, which the API does not offer on OTAs or OTIDVs.
 
 **Returns:** [PaginatedResponse](#paginatedresponse) with OTA dictionaries
 
@@ -638,12 +640,14 @@ idvs = client.list_idvs(
     cursor=None,
     shape=ShapeConfig.IDVS_MINIMAL,
     awarding_agency="4700",
+    commercial_item_acquisition_procedures="E",  # DoD Section 803 CSO
 )
 ```
 
 Notes:
 
 - This endpoint uses **keyset pagination** (`cursor` + `limit`) rather than page numbers.
+- `commercial_item_acquisition_procedures` takes the same FPDS codes `A`–`E` as on `list_contracts()`, with `|` for OR.
 
 ### get_idv()
 
@@ -1758,6 +1762,24 @@ for attachment in request["attachments"]:
 
 The default shape returns every field plus two expands: `organization` (the buyer office, with the same seven keys as other resources' `organization` expand) and `attachments`. Each attachment carries `doc_seq_num`, `doc_name`, `doc_type`, `doc_path`, `is_link` and `doc_session_date`. `is_link=True` means `doc_path` is an outbound URL with no stored document behind it. `amendments`, `line_items` and `addresses` are lists of objects, served as eBuy publishes them.
 
+**Reading a document's text — `attachments(extracted_text)`** (Tango API 5.9.1):
+
+```python
+request = client.get_ebuy_request(
+    "RFQ1835158",
+    shape="rfq_id,attachments(doc_seq_num,doc_name,extracted_text)",
+)
+
+for attachment in request["attachments"]:
+    text = attachment.get("extracted_text")
+    if text:
+        print(attachment["doc_name"], len(text))
+```
+
+- `extracted_text` is the text extracted from the attachment's document.
+- **It is returned only when you name it.** The default shape does not include it, and neither does `attachments(*)`.
+- **The API omits the key, rather than sending null**, for an attachment with no text: an external link, an empty scan, or a document that has not been extracted yet. The SDK's shaped result reads an omitted key as `None`, so treat `None` as "no text", not as an error.
+
 ### get_ebuy_attachment_url()
 
 Get a short-lived download URL for one stored attachment.
@@ -2606,7 +2628,7 @@ entity = client.get_entity("UEI_KEY", shape=ShapeConfig.ENTITIES_COMPREHENSIVE)
 | `FEDERAL_REGISTER_MINIMAL` | `list_federal_register_documents` | uuid, document_number, publication_date, type, subtype, title, abstract, action, agencies, cfr_references, citation, significant, comments_close_on, effective_on, html_url, pdf_url |
 | `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 |
+| `EBUY_REQUESTS_COMPREHENSIVE` | `get_ebuy_request` | Every field, plus the `organization` and `attachments` expands (without `extracted_text`, which must be named) |
 | `BUDGET_ACCOUNTS_MINIMAL` | `list_budget_accounts`, `get_budget_account` | id, federal_account_symbol, fiscal_year, data_through_period, 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 |

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

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

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

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

{tango_python-1.15.0 → tango_python-1.17.0}/tango/client.py

@@ -632,6 +632,7 @@ class TangoClient:
         award_date_lte: str | None = None,
         award_type: str | None = None,
         awarding_agency: str | None = None,
+        commercial_item_acquisition_procedures: str | None = None,
         expiring_gte: str | None = None,
         expiring_lte: str | None = None,
         fiscal_year: int | None = None,
@@ -674,6 +675,7 @@ class TangoClient:
             award_date_lte: Award date <= (YYYY-MM-DD)
             award_type: Award type code
             awarding_agency: Awarding agency code (e.g., "4700" for GSA)
+            commercial_item_acquisition_procedures: FPDS commercial item acquisition procedures code, case-insensitive: "A" (commercial products/services), "B" (products or services pursuant to FAR 12.102(f)), "C" (services pursuant to FAR 12.102(g)), "D" (commercial procedures not used) or "E" (DoD Section 803 Commercial Solutions Opening). Pipe-separate codes for OR, e.g. "A|E"; an unknown code matches nothing.
             expiring_gte: Expiring on or after date
             expiring_lte: Expiring on or before date
             fiscal_year: Fiscal year (exact match)
@@ -751,6 +753,7 @@ class TangoClient:
             ("award_date_lte", award_date_lte),
             ("award_type", award_type),
             ("awarding_agency", awarding_agency),
+            ("commercial_item_acquisition_procedures", commercial_item_acquisition_procedures),
             ("expiring_gte", expiring_gte),
             ("expiring_lte", expiring_lte),
             ("fiscal_year", fiscal_year),
@@ -915,6 +918,7 @@ class TangoClient:
         award_date_gte: str | None = None,
         award_date_lte: str | None = None,
         awarding_agency: str | None = None,
+        commercial_item_acquisition_procedures: str | None = None,
         expiring_gte: str | None = None,
         expiring_lte: str | None = None,
         fiscal_year: int | None = None,
@@ -941,6 +945,8 @@ class TangoClient:
 
         This mirrors `/api/idvs/` and supports the same filter parameters as the API,
         plus shaping via `shape`.
+
+        `commercial_item_acquisition_procedures` takes an FPDS commercial item acquisition procedures code `A`–`E` (case-insensitive; `E` is DoD Section 803 Commercial Solutions Opening), pipe-separated for OR, e.g. `"A|E"`; an unknown code matches nothing.
         """
         params: dict[str, Any] = {"limit": min(limit, 100)}
         if cursor:
@@ -962,6 +968,7 @@ class TangoClient:
             ("award_date_gte", award_date_gte),
             ("award_date_lte", award_date_lte),
             ("awarding_agency", awarding_agency),
+            ("commercial_item_acquisition_procedures", commercial_item_acquisition_procedures),
             ("expiring_gte", expiring_gte),
             ("expiring_lte", expiring_lte),
             ("fiscal_year", fiscal_year),

{tango_python-1.15.0 → tango_python-1.17.0}/tango/models.py

@@ -1365,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
@@ -1373,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:
@@ -1660,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_python-1.15.0 → tango_python-1.17.0}/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_python-1.15.0 → tango_python-1.17.0}/tests/test_client.py

@@ -2247,6 +2247,33 @@ class TestEntityFilters:
         assert "socioeconomic" not in mock_request.call_args[1]["params"]
 
 
+class TestCommercialItemAcquisitionProceduresFilter:
+    @pytest.mark.parametrize("method", ["list_contracts", "list_idvs"])
+    @patch("tango.client.httpx.Client.request")
+    def test_forwards_pipe_separated_codes_verbatim(self, mock_request, method):
+        _stub_empty_page(mock_request)
+        getattr(TangoClient(api_key="test-key"), method)(
+            commercial_item_acquisition_procedures="a|E"
+        )
+        assert (
+            mock_request.call_args[1]["params"]["commercial_item_acquisition_procedures"] == "a|E"
+        )
+
+    @pytest.mark.parametrize("method", ["list_contracts", "list_idvs"])
+    @patch("tango.client.httpx.Client.request")
+    def test_omits_unset_filter(self, mock_request, method):
+        _stub_empty_page(mock_request)
+        getattr(TangoClient(api_key="test-key"), method)()
+        assert "commercial_item_acquisition_procedures" not in mock_request.call_args[1]["params"]
+
+    @pytest.mark.parametrize("method", ["list_otas", "list_otidvs"])
+    def test_not_accepted_on_other_transaction_lists(self, method):
+        with pytest.raises(TypeError, match="commercial_item_acquisition_procedures"):
+            getattr(TangoClient(api_key="test-key"), method)(
+                commercial_item_acquisition_procedures="E"
+            )
+
+
 class TestAgencyFilterDiagnostics:
     """`meta` from the API's agency-filter diagnostics.
 

{tango_python-1.15.0 → tango_python-1.17.0}/tests/test_ebuy.py

@@ -212,6 +212,26 @@ class TestGetEbuyRequest:
         assert row["attachments"][1]["is_link"] is True
         assert isinstance(row["attachments"][0]["doc_session_date"], datetime)
 
+    @patch("tango.client.httpx.Client.request")
+    def test_extracted_text_is_read_when_named_and_none_without_text(self, mock_request):
+        shape = "rfq_id,attachments(doc_seq_num,is_link,extracted_text)"
+        _mock(
+            mock_request,
+            {
+                "rfq_id": RFQ_ID,
+                "attachments": [
+                    {"doc_seq_num": 1, "is_link": False, "extracted_text": "Statement of work"},
+                    {"doc_seq_num": 2, "is_link": True},
+                ],
+            },
+        )
+        row = TangoClient(api_key="k").get_ebuy_request(RFQ_ID, shape=shape)
+
+        assert _call_params(mock_request)["shape"] == shape
+        assert row["attachments"][0]["extracted_text"] == "Statement of work"
+        assert row["attachments"][1].get("extracted_text") is None
+        assert row["attachments"][1]["extracted_text"] is None
+
     @patch("tango.client.httpx.Client.request")
     def test_out_of_scope_request_is_not_found(self, mock_request):
         mock_request.return_value = _response(404, {"detail": "No EbuyRequest matches."})
@@ -310,12 +330,22 @@ class TestEbuyShapes:
             ShapeConfig.EBUY_REQUESTS_COMPREHENSIVE,
             "rfq_id,organization(agency_code,office_name),attachments(doc_seq_num,is_link)",
             "rfq_id,amendments,line_items,addresses,oco_aac,ocs_phone",
+            "rfq_id,attachments(extracted_text)",
+            "rfq_id,attachments(doc_seq_num,doc_name,extracted_text)",
         ],
     )
     def test_shape_validates(self, shape):
         parser = ShapeParser(cache_enabled=True)
         parser.validate(parser.parse(shape), EbuyRequest)
 
+    @pytest.mark.parametrize(
+        "shape",
+        [ShapeConfig.EBUY_REQUESTS_MINIMAL, ShapeConfig.EBUY_REQUESTS_COMPREHENSIVE],
+    )
+    def test_default_shapes_leave_extracted_text_opt_in(self, shape):
+        assert "extracted_text" not in shape
+        assert "attachments(*)" not in shape
+
     def test_contract_number_is_a_filter_not_a_response_field(self):
         parser = ShapeParser(cache_enabled=True)
         with pytest.raises(ShapeValidationError):