tango-python 0.4.1__py3-none-any.whl → 0.4.2__py3-none-any.whl

tango/client.py

@@ -31,6 +31,7 @@ from tango.models import (
     Opportunity,
     Organization,
     PaginatedResponse,
+    Protest,
     SearchFilters,
     ShapeConfig,
     Subaward,
@@ -943,32 +944,6 @@ class TangoClient:
             page_metadata=data.get("page_metadata"),
         )
 
-    def get_idv_summary(self, identifier: str) -> dict[str, Any]:
-        """Get a summary for an IDV solicitation identifier (`/api/idvs/{identifier}/summary/`)."""
-        return self._get(f"/api/idvs/{identifier}/summary/")
-
-    def list_idv_summary_awards(
-        self,
-        identifier: str,
-        limit: int = 25,
-        cursor: str | None = None,
-        ordering: str | None = None,
-    ) -> PaginatedResponse:
-        """List awards under an IDV summary (`/api/idvs/{identifier}/summary/awards/`)."""
-        params: dict[str, Any] = {"limit": min(limit, 100)}
-        if cursor:
-            params["cursor"] = cursor
-        if ordering:
-            params["ordering"] = ordering
-        data = self._get(f"/api/idvs/{identifier}/summary/awards/", params)
-        return PaginatedResponse(
-            count=int(data.get("count") or len(data.get("results") or [])),
-            next=data.get("next"),
-            previous=data.get("previous"),
-            results=data.get("results") or [],
-            page_metadata=data.get("page_metadata"),
-        )
-
     def list_otas(
         self,
         limit: int = 25,
@@ -1859,6 +1834,129 @@ class TangoClient:
             results=results,
         )
 
+    # Protest endpoints
+    # See https://tango.makegov.com/docs/api-reference/protests.md
+    # Note: Protests API does not support ordering (returns 400 if provided).
+    # Use shape=...,dockets(...) to request nested dockets.
+    def list_protests(
+        self,
+        page: int = 1,
+        limit: int = 25,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+        source_system: str | None = None,
+        outcome: str | None = None,
+        case_type: str | None = None,
+        agency: str | None = None,
+        case_number: str | None = None,
+        solicitation_number: str | None = None,
+        protester: str | None = None,
+        filed_date_after: str | None = None,
+        filed_date_before: str | None = None,
+        decision_date_after: str | None = None,
+        decision_date_before: str | None = None,
+        search: str | None = None,
+    ) -> PaginatedResponse:
+        """
+        List bid protests.
+
+        Returns case-level protest records. Use shape=...,dockets(...) to include
+        nested dockets. API reference: https://tango.makegov.com/docs/api-reference/protests.md
+
+        Args:
+            page: Page number
+            limit: Results per page (max 100)
+            shape: Response shape string (defaults to minimal shape)
+            flat: If True, flatten nested objects in shaped response
+            flat_lists: If True, flatten arrays using indexed keys
+            source_system: Filter by source system (e.g. gao)
+            outcome: Filter by outcome (e.g. Denied, Dismissed, Withdrawn, Sustained)
+            case_type: Filter by case type
+            agency: Filter by protested agency text
+            case_number: Filter by case number (e.g. b-423274)
+            solicitation_number: Filter by exact solicitation number
+            protester: Filter by protester name text
+            filed_date_after: Filed date on or after
+            filed_date_before: Filed date on or before
+            decision_date_after: Decision date on or after
+            decision_date_before: Decision date on or before
+            search: Full-text search over protest searchable fields
+        """
+        params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
+
+        if shape is None:
+            shape = ShapeConfig.PROTESTS_MINIMAL
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
+
+        for key, val in (
+            ("source_system", source_system),
+            ("outcome", outcome),
+            ("case_type", case_type),
+            ("agency", agency),
+            ("case_number", case_number),
+            ("solicitation_number", solicitation_number),
+            ("protester", protester),
+            ("filed_date_after", filed_date_after),
+            ("filed_date_before", filed_date_before),
+            ("decision_date_after", decision_date_after),
+            ("decision_date_before", decision_date_before),
+            ("search", search),
+        ):
+            if val is not None:
+                params[key] = val
+
+        data = self._get("/api/protests/", params)
+
+        results = [
+            self._parse_response_with_shape(item, shape, Protest, flat, flat_lists)
+            for item in data["results"]
+        ]
+
+        return PaginatedResponse(
+            count=data["count"],
+            next=data.get("next"),
+            previous=data.get("previous"),
+            results=results,
+        )
+
+    def get_protest(
+        self,
+        case_id: str,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+    ) -> Any:
+        """
+        Get a single protest by case_id (RFC 4122 UUID).
+
+        Use shape=...,dockets(...) to include nested dockets.
+        API reference: https://tango.makegov.com/docs/api-reference/protests.md
+
+        Args:
+            case_id: Deterministic case UUID (from source_system + base_case_number)
+            shape: Response shape string (defaults to minimal shape)
+            flat: If True, flatten nested objects in shaped response
+            flat_lists: If True, flatten arrays using indexed keys
+        """
+        params: dict[str, Any] = {}
+        if shape is None:
+            shape = ShapeConfig.PROTESTS_MINIMAL
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
+
+        data = self._get(f"/api/protests/{case_id}/", params)
+        return self._parse_response_with_shape(data, shape, Protest, flat, flat_lists)
+
     # Grant endpoints
     def list_grants(
         self,
@@ -1945,47 +2043,6 @@ class TangoClient:
             results=results,
         )
 
-    def list_assistance(
-        self,
-        limit: int = 25,
-        cursor: str | None = None,
-        assistance_type: str | None = None,
-        award_key: str | None = None,
-        fiscal_year: int | None = None,
-        fiscal_year_gte: int | None = None,
-        fiscal_year_lte: int | None = None,
-        highly_compensated_officers: str | None = None,
-        recipient: str | None = None,
-        recipient_address: str | None = None,
-        search: str | None = None,
-    ) -> PaginatedResponse:
-        """List assistance (financial assistance) transactions (`/api/assistance/`). Keyset pagination."""
-        params: dict[str, Any] = {"limit": min(limit, 100)}
-        if cursor:
-            params["cursor"] = cursor
-        for key, val in (
-            ("assistance_type", assistance_type),
-            ("award_key", award_key),
-            ("fiscal_year", fiscal_year),
-            ("fiscal_year_gte", fiscal_year_gte),
-            ("fiscal_year_lte", fiscal_year_lte),
-            ("highly_compensated_officers", highly_compensated_officers),
-            ("recipient", recipient),
-            ("recipient_address", recipient_address),
-            ("search", search),
-        ):
-            if val is not None:
-                params[key] = val
-        data = self._get("/api/assistance/", params)
-        return PaginatedResponse(
-            count=int(data.get("count") or len(data.get("results") or [])),
-            next=data.get("next"),
-            previous=data.get("previous"),
-            results=data.get("results", []),
-            cursor=data.get("cursor"),
-            page_metadata=data.get("page_metadata"),
-        )
-
     # ============================================================================
     # Webhooks (v2)
     # ============================================================================

tango/models.py

@@ -433,6 +433,33 @@ class Notice:
     naics_code: str | None = None
 
 
+@dataclass
+class Protest:
+    """Schema definition for Protest (not used for instances)
+
+    Bid protest records at /api/protests/. Case-level object identified by case_id (UUID).
+    See https://tango.makegov.com/docs/api-reference/protests.md.
+    """
+
+    case_id: str
+    case_number: str | None = None
+    title: str | None = None
+    source_system: str | None = None
+    outcome: str | None = None
+    agency: str | None = None
+    protester: str | None = None
+    solicitation_number: str | None = None
+    case_type: str | None = None
+    filed_date: datetime | None = None
+    posted_date: datetime | None = None
+    decision_date: datetime | None = None
+    due_date: datetime | None = None
+    docket_url: str | None = None
+    decision_url: str | None = None
+    digest: str | None = None
+    dockets: list[dict[str, Any]] | None = None
+
+
 @dataclass
 class AssistanceListing:
     """Schema definition for Assistance Listing (not used for instances)"""
@@ -575,7 +602,7 @@ class ShapeConfig:
         "business_types,primary_naics,naics_codes,psc_codes,"
         "email_address,entity_url,description,capabilities,keywords,"
         "physical_address,mailing_address,"
-        "federal_obligations,congressional_district"
+        "federal_obligations(*),congressional_district"
     )
 
     # Default for list_forecasts()
@@ -589,6 +616,9 @@ class ShapeConfig:
     # Default for list_notices()
     NOTICES_MINIMAL: Final = "notice_id,title,solicitation_number,posted_date"
 
+    # Default for list_protests()
+    PROTESTS_MINIMAL: Final = "case_id,case_number,title,source_system,outcome,filed_date"
+
     # Default for list_grants()
     GRANTS_MINIMAL: Final = "grant_id,opportunity_number,title,status(*),agency_code"
 

tango/shapes/explicit_schemas.py

@@ -637,6 +637,57 @@ NOTICE_SCHEMA: dict[str, FieldSchema] = {
 }
 
 
+# Docket-level fields for Protest dockets expansion: dockets(docket_number, filed_date, ...)
+PROTEST_DOCKET_SCHEMA: dict[str, FieldSchema] = {
+    "source_system": FieldSchema(name="source_system", type=str, is_optional=True, is_list=False),
+    "case_number": FieldSchema(name="case_number", type=str, is_optional=True, is_list=False),
+    "docket_number": FieldSchema(name="docket_number", type=str, is_optional=True, is_list=False),
+    "title": FieldSchema(name="title", type=str, is_optional=True, is_list=False),
+    "protester": FieldSchema(name="protester", type=str, is_optional=True, is_list=False),
+    "agency": FieldSchema(name="agency", type=str, is_optional=True, is_list=False),
+    "solicitation_number": FieldSchema(
+        name="solicitation_number", type=str, is_optional=True, is_list=False
+    ),
+    "case_type": FieldSchema(name="case_type", type=str, is_optional=True, is_list=False),
+    "outcome": FieldSchema(name="outcome", type=str, is_optional=True, is_list=False),
+    "filed_date": FieldSchema(name="filed_date", type=datetime, is_optional=True, is_list=False),
+    "posted_date": FieldSchema(name="posted_date", type=datetime, is_optional=True, is_list=False),
+    "decision_date": FieldSchema(
+        name="decision_date", type=datetime, is_optional=True, is_list=False
+    ),
+    "due_date": FieldSchema(name="due_date", type=datetime, is_optional=True, is_list=False),
+    "docket_url": FieldSchema(name="docket_url", type=str, is_optional=True, is_list=False),
+    "decision_url": FieldSchema(name="decision_url", type=str, is_optional=True, is_list=False),
+    "digest": FieldSchema(name="digest", type=str, is_optional=True, is_list=False),
+}
+
+PROTEST_SCHEMA: dict[str, FieldSchema] = {
+    "case_id": FieldSchema(name="case_id", type=str, is_optional=False, is_list=False),
+    "case_number": FieldSchema(name="case_number", type=str, is_optional=True, is_list=False),
+    "title": FieldSchema(name="title", type=str, is_optional=True, is_list=False),
+    "source_system": FieldSchema(name="source_system", type=str, is_optional=True, is_list=False),
+    "outcome": FieldSchema(name="outcome", type=str, is_optional=True, is_list=False),
+    "agency": FieldSchema(name="agency", type=str, is_optional=True, is_list=False),
+    "protester": FieldSchema(name="protester", type=str, is_optional=True, is_list=False),
+    "solicitation_number": FieldSchema(
+        name="solicitation_number", type=str, is_optional=True, is_list=False
+    ),
+    "case_type": FieldSchema(name="case_type", type=str, is_optional=True, is_list=False),
+    "filed_date": FieldSchema(name="filed_date", type=datetime, is_optional=True, is_list=False),
+    "posted_date": FieldSchema(name="posted_date", type=datetime, is_optional=True, is_list=False),
+    "decision_date": FieldSchema(
+        name="decision_date", type=datetime, is_optional=True, is_list=False
+    ),
+    "due_date": FieldSchema(name="due_date", type=datetime, is_optional=True, is_list=False),
+    "docket_url": FieldSchema(name="docket_url", type=str, is_optional=True, is_list=False),
+    "decision_url": FieldSchema(name="decision_url", type=str, is_optional=True, is_list=False),
+    "digest": FieldSchema(name="digest", type=str, is_optional=True, is_list=False),
+    "dockets": FieldSchema(
+        name="dockets", type=dict, is_optional=True, is_list=True, nested_model="ProtestDocket"
+    ),
+}
+
+
 AGENCY_SCHEMA: dict[str, FieldSchema] = {
     "abbreviation": FieldSchema(name="abbreviation", type=str, is_optional=True, is_list=False),
     "code": FieldSchema(name="code", type=str, is_optional=False, is_list=False),
@@ -1105,6 +1156,8 @@ EXPLICIT_SCHEMAS: dict[str, dict[str, FieldSchema]] = {
     "Forecast": FORECAST_SCHEMA,
     "Opportunity": OPPORTUNITY_SCHEMA,
     "Notice": NOTICE_SCHEMA,
+    "Protest": PROTEST_SCHEMA,
+    "ProtestDocket": PROTEST_DOCKET_SCHEMA,
     "Agency": AGENCY_SCHEMA,
     "Grant": GRANT_SCHEMA,
     # Vehicles (Awards)

{tango_python-0.4.1.dist-info → tango_python-0.4.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tango-python
-Version: 0.4.1
+Version: 0.4.2
 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
@@ -61,7 +61,7 @@ A modern Python SDK for the [Tango API](https://tango.makegov.com) by MakeGov, f
 
 - **Dynamic Response Shaping** - Request only the fields you need, reducing payload sizes by 60-80%
 - **Full Type Safety** - Runtime-generated TypedDict types with accurate type hints for IDE autocomplete
-- **Comprehensive API Coverage** - All major Tango API endpoints (contracts, entities, forecasts, opportunities, notices, grants, webhooks) [Note: the current version does NOT implement all endpoints, we will be adding them incrementally]
+- **Comprehensive API Coverage** - All major Tango API endpoints (contracts, IDVs, OTAs, entities, forecasts, opportunities, notices, grants, protests, webhooks, and more)
 - **Flexible Data Access** - Dictionary-based response objects with validation
 - **Modern Python** - Built for Python 3.12+ using modern async-ready patterns
 - **Production-Ready** - Comprehensive test suite with VCR.py-based integration tests
@@ -207,14 +207,33 @@ contracts = client.list_contracts(
 **Response Options:**
 - `shape`, `flat`, `flat_lists` - Response shaping options
 
+### IDVs, OTAs, OTIDVs
+
+```python
+# List IDVs (keyset pagination)
+idvs = client.list_idvs(limit=25, awarding_agency="4700")
+
+# Get single IDV with shaping
+idv = client.get_idv("IDV_KEY", shape=ShapeConfig.IDVS_COMPREHENSIVE)
+
+# OTAs and OTIDVs follow the same pattern
+otas = client.list_otas(limit=25)
+otidvs = client.list_otidvs(limit=25)
+```
+
+### Vehicles
+
+```python
+vehicles = client.list_vehicles(search="GSA schedule", shape=ShapeConfig.VEHICLES_MINIMAL)
+vehicle = client.get_vehicle("UUID", shape=ShapeConfig.VEHICLES_COMPREHENSIVE)
+awardees = client.list_vehicle_awardees("UUID")
+```
+
 ### Entities (Vendors/Recipients)
 
 ```python
-# List entities
-entities = client.list_entities(
-    page=1,
-    limit=25
-)
+# List entities with filters
+entities = client.list_entities(search="Booz Allen", state="VA", limit=25)
 
 # Get specific entity by UEI or CAGE code
 entity = client.get_entity("ZQGGHJH74DW7")
@@ -223,47 +242,49 @@ entity = client.get_entity("ZQGGHJH74DW7")
 ### Forecasts
 
 ```python
-# List contract forecasts
-forecasts = client.list_forecasts(
-    agency="GSA",
-    limit=25
-)
+forecasts = client.list_forecasts(agency="GSA", fiscal_year=2025, limit=25)
 ```
 
 ### Opportunities
 
 ```python
-# List opportunities/solicitations
-opportunities = client.list_opportunities(
-    agency="DOD",
-    limit=25
-)
+opportunities = client.list_opportunities(agency="DOD", active=True, limit=25)
 ```
 
 ### Notices
 
 ```python
-# List contract notices
-notices = client.list_notices(
-    agency="DOD",
-    limit=25
-)
+notices = client.list_notices(agency="DOD", notice_type="award", limit=25)
 ```
 
 ### Grants
 
 ```python
-# List grant opportunities
-grants = client.list_grants(
-    agency_code="HHS",
-    limit=25
-)
+grants = client.list_grants(agency="HHS", status="forecasted", limit=25)
+```
+
+### Protests
+
+```python
+protests = client.list_protests(source_system="gao", outcome="Sustained", limit=25)
+protest = client.get_protest("CASE_UUID")
+```
+
+### GSA eLibrary Contracts
+
+```python
+contracts = client.list_gsa_elibrary_contracts(schedule="MAS", limit=25)
+contract = client.get_gsa_elibrary_contract("UUID")
 ```
 
-### Business Types
+### Reference Data
 
 ```python
-# List business types
+# Offices, organizations, NAICS, subawards, business types
+offices = client.list_offices(search="acquisitions")
+organizations = client.list_organizations(level=1)
+naics = client.list_naics(search="software")
+subawards = client.list_subawards(prime_uei="UEI123")
 business_types = client.list_business_types()
 ```
 
@@ -476,9 +497,16 @@ tango-python/
 │       ├── test_entities_integration.py
 │       ├── test_forecasts_integration.py
 │       ├── test_grants_integration.py
+│       ├── test_naics_integration.py
 │       ├── test_notices_integration.py
+│       ├── test_offices_integration.py
 │       ├── test_opportunities_integration.py
+│       ├── test_organizations_integration.py
+│       ├── test_otas_otidvs_integration.py
+│       ├── test_protests_integration.py
 │       ├── test_reference_data_integration.py
+│       ├── test_subawards_integration.py
+│       ├── test_vehicles_idvs_integration.py
 │       └── test_edge_cases_integration.py
 ├── docs/                     # Documentation
 │   ├── API_REFERENCE.md     # Complete API reference

{tango_python-0.4.1.dist-info → tango_python-0.4.2.dist-info}/RECORD

@@ -1,16 +1,16 @@
 tango/__init__.py,sha256=7EdEUgCcK0lDNJWWDgdSWxx8xxryO-fHL-iml9PaYLw,1102
-tango/client.py,sha256=ykeTSh4rI4P3LZFALLfGkl2Yr6jM7NWrq_E4V5vY0nc,84112
+tango/client.py,sha256=HvS-ss9QOeajLOkP2IsX9gTF_KvOb9_NOlLUphd8gSc,86111
 tango/exceptions.py,sha256=JmtbOY0ofBnX24pUErh2XFlTj9dim2ngyboserEGRFw,2226
-tango/models.py,sha256=E5jbcQ1CHevTJBD1KOREAqql9bTkft91WaNsL8qbnuA,19575
+tango/models.py,sha256=4sLmWjyqsCU7-b8lr9ZRRG_ElBKz-5txibcOFcScEDY,20555
 tango/shapes/__init__.py,sha256=7ea1WU74jp4znhNw-gXruag6m6eyPZtbVgbDFmFUWro,1072
-tango/shapes/explicit_schemas.py,sha256=iKvmpmeFU8pr4PpTenlpXDKxNbLkuyfUdDc8IV7p4zk,51734
+tango/shapes/explicit_schemas.py,sha256=H4pYs0LCTSV5msRCxftmgiM_-3sc4LsqpDPgj36DkPY,55202
 tango/shapes/factory.py,sha256=ytpMi5Uw72XZ8MimhuSsLDVXF3zO_Zt3_tAL6NF7LnU,34318
 tango/shapes/generator.py,sha256=61V1T3lm8Ps_KSMJAezQJLQVFbNKt1jtoLyhiqNtFTs,23380
 tango/shapes/models.py,sha256=h3pIhOqrrdlN953Y6r0oney5HFbKPOD-frRndRWimJ0,3018
 tango/shapes/parser.py,sha256=k6OsI2w3GH6-IBbc-XTLgL1mWH7bMf7A_dA6pr1xKfw,24619
 tango/shapes/schema.py,sha256=VRPOB1sBdjFyimNchrZKIpTHn83CyX4RfU9077aQtIU,14136
 tango/shapes/types.py,sha256=27jrAE0VIdrKaLjR_FK71hfIIGX2Tg3ex7REEBV1TFE,1301
-tango_python-0.4.1.dist-info/METADATA,sha256=QTa_gFDGAc9jj23jv35_0Zy9Js3bXlzK6FV-9OnjLFg,16210
-tango_python-0.4.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-tango_python-0.4.1.dist-info/licenses/LICENSE,sha256=j2kYVHMwTkoGn3ZNScnrdIueG0k2XzB_LCPFoyBc2wk,1064
-tango_python-0.4.1.dist-info/RECORD,,
+tango_python-0.4.2.dist-info/METADATA,sha256=h3QpwadNjsoHnMuXXpFj6BScFCvx61NGGOM43gG6GLQ,17595
+tango_python-0.4.2.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+tango_python-0.4.2.dist-info/licenses/LICENSE,sha256=j2kYVHMwTkoGn3ZNScnrdIueG0k2XzB_LCPFoyBc2wk,1064
+tango_python-0.4.2.dist-info/RECORD,,