tango-python 0.3.0__py3-none-any.whl → 0.4.0__py3-none-any.whl

tango/__init__.py

@@ -26,7 +26,7 @@ from .shapes import (
     TypeGenerator,
 )
 
-__version__ = "0.3.0"
+__version__ = "0.4.0"
 __all__ = [
     "TangoClient",
     "TangoAPIError",

tango/client.py

@@ -17,6 +17,8 @@ from tango.exceptions import (
 )
 from tango.models import (
     IDV,
+    OTA,
+    OTIDV,
     Agency,
     BusinessType,
     Contract,
@@ -26,9 +28,11 @@ from tango.models import (
     Location,
     Notice,
     Opportunity,
+    Organization,
     PaginatedResponse,
     SearchFilters,
     ShapeConfig,
+    Subaward,
     Vehicle,
     WebhookEndpoint,
     WebhookEventType,
@@ -362,9 +366,13 @@ class TangoClient:
     # ============================================================================
 
     # Agency endpoints
-    def list_agencies(self, page: int = 1, limit: int = 25) -> PaginatedResponse:
+    def list_agencies(
+        self, page: int = 1, limit: int = 25, search: str | None = None
+    ) -> PaginatedResponse:
         """List all agencies"""
-        params = {"page": page, "limit": min(limit, 100)}
+        params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
+        if search:
+            params["search"] = search
         data = self._get("/api/agencies/", params)
         return PaginatedResponse(
             count=data["count"],
@@ -389,6 +397,96 @@ class TangoClient:
             raise TangoNotFoundError(f"Agency '{code}' not found", 404)
         return agency
 
+    def list_offices(
+        self,
+        page: int = 1,
+        limit: int = 25,
+        search: str | None = None,
+    ) -> PaginatedResponse:
+        """List offices (`/api/offices/`)."""
+        params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
+        if search is not None:
+            params["search"] = search
+        data = self._get("/api/offices/", params)
+        return PaginatedResponse(
+            count=data.get("count", 0),
+            next=data.get("next"),
+            previous=data.get("previous"),
+            results=data.get("results", []),
+        )
+
+    def get_office(self, code: str) -> dict[str, Any]:
+        """Get a single office by code (`/api/offices/{code}/`)."""
+        return self._get(f"/api/offices/{code}/")
+
+    def list_organizations(
+        self,
+        page: int = 1,
+        limit: int = 25,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+        cgac: str | None = None,
+        include_inactive: bool | None = None,
+        level: int | None = None,
+        parent: str | None = None,
+        search: str | None = None,
+        type: str | None = None,
+    ) -> PaginatedResponse:
+        """List organizations (`/api/organizations/`)."""
+        params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
+        if shape is None:
+            shape = ShapeConfig.ORGANIZATIONS_MINIMAL
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
+        if cgac is not None:
+            params["cgac"] = cgac
+        if include_inactive is not None:
+            params["include_inactive"] = include_inactive
+        if level is not None:
+            params["level"] = level
+        if parent is not None:
+            params["parent"] = parent
+        if search is not None:
+            params["search"] = search
+        if type is not None:
+            params["type"] = type
+        data = self._get("/api/organizations/", params)
+        results = [
+            self._parse_response_with_shape(obj, shape, Organization, flat, flat_lists)
+            for obj in data.get("results", [])
+        ]
+        return PaginatedResponse(
+            count=data.get("count", 0),
+            next=data.get("next"),
+            previous=data.get("previous"),
+            results=results,
+        )
+
+    def get_organization(
+        self,
+        fh_key: str,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+    ) -> Any:
+        """Get a single organization by fh_key (`/api/organizations/{fh_key}/`)."""
+        params: dict[str, Any] = {}
+        if shape is None:
+            shape = ShapeConfig.ORGANIZATIONS_MINIMAL
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
+        data = self._get(f"/api/organizations/{fh_key}/", params)
+        return self._parse_response_with_shape(data, shape, Organization, flat, flat_lists)
+
     # Contract endpoints
     def list_contracts(
         self,
@@ -398,7 +496,7 @@ class TangoClient:
         flat: bool = False,
         flat_lists: bool = False,
         filters: SearchFilters | dict[str, Any] | None = None,
-        **kwargs,
+        **kwargs: Any,
     ) -> PaginatedResponse:
         """
         List contracts with optional filtering
@@ -600,7 +698,7 @@ class TangoClient:
         flat: bool = False,
         flat_lists: bool = False,
         joiner: str = ".",
-        **filters,
+        **filters: Any,
     ) -> PaginatedResponse:
         """
         List IDVs (indefinite delivery vehicles) with keyset pagination.
@@ -675,7 +773,7 @@ class TangoClient:
         flat_lists: bool = False,
         joiner: str = ".",
         filters: SearchFilters | dict[str, Any] | None = None,
-        **kwargs,
+        **kwargs: Any,
     ) -> PaginatedResponse:
         """
         List child awards (contracts) under an IDV (`/api/idvs/{key}/awards/`).
@@ -751,7 +849,7 @@ class TangoClient:
         flat: bool = False,
         flat_lists: bool = False,
         joiner: str = ".",
-        **filters,
+        **filters: Any,
     ) -> PaginatedResponse:
         """List child IDVs under an IDV (`/api/idvs/{key}/idvs/`)."""
         params: dict[str, Any] = {"limit": min(limit, 100)}
@@ -828,6 +926,268 @@ class TangoClient:
             page_metadata=data.get("page_metadata"),
         )
 
+    def list_otas(
+        self,
+        limit: int = 25,
+        cursor: str | None = None,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+        joiner: str = ".",
+        award_date: str | None = None,
+        award_date_gte: str | None = None,
+        award_date_lte: str | None = None,
+        awarding_agency: str | None = None,
+        expiring_gte: str | None = None,
+        expiring_lte: str | None = None,
+        fiscal_year: int | None = None,
+        fiscal_year_gte: int | None = None,
+        fiscal_year_lte: int | None = None,
+        funding_agency: str | None = None,
+        ordering: str | None = None,
+        piid: str | None = None,
+        pop_end_date_gte: str | None = None,
+        pop_end_date_lte: str | None = None,
+        pop_start_date_gte: str | None = None,
+        pop_start_date_lte: str | None = None,
+        psc: str | None = None,
+        recipient: str | None = None,
+        search: str | None = None,
+        uei: str | None = None,
+    ) -> PaginatedResponse:
+        """List OTAs (Other Transaction Agreements) (`/api/otas/`). Keyset pagination."""
+        params: dict[str, Any] = {"limit": min(limit, 100)}
+        if cursor:
+            params["cursor"] = cursor
+        if shape is None:
+            shape = ShapeConfig.OTAS_MINIMAL
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+                if joiner:
+                    params["joiner"] = joiner
+            if flat_lists:
+                params["flat_lists"] = "true"
+        for key, val in (
+            ("award_date", award_date),
+            ("award_date_gte", award_date_gte),
+            ("award_date_lte", award_date_lte),
+            ("awarding_agency", awarding_agency),
+            ("expiring_gte", expiring_gte),
+            ("expiring_lte", expiring_lte),
+            ("fiscal_year", fiscal_year),
+            ("fiscal_year_gte", fiscal_year_gte),
+            ("fiscal_year_lte", fiscal_year_lte),
+            ("funding_agency", funding_agency),
+            ("ordering", ordering),
+            ("piid", piid),
+            ("pop_end_date_gte", pop_end_date_gte),
+            ("pop_end_date_lte", pop_end_date_lte),
+            ("pop_start_date_gte", pop_start_date_gte),
+            ("pop_start_date_lte", pop_start_date_lte),
+            ("psc", psc),
+            ("recipient", recipient),
+            ("search", search),
+            ("uei", uei),
+        ):
+            if val is not None:
+                params[key] = val
+        data = self._get("/api/otas/", params)
+        raw_results = data.get("results") or []
+        results = [
+            self._parse_response_with_shape(obj, shape, OTA, flat, flat_lists, joiner=joiner)
+            for obj in raw_results
+        ]
+        return PaginatedResponse(
+            count=int(data.get("count") or len(results)),
+            next=data.get("next"),
+            previous=data.get("previous"),
+            results=results,
+            cursor=data.get("cursor"),
+            page_metadata=data.get("page_metadata"),
+        )
+
+    def get_ota(
+        self,
+        key: str,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+        joiner: str = ".",
+    ) -> Any:
+        """Get a single OTA by key (`/api/otas/{key}/`)."""
+        params: dict[str, Any] = {}
+        if shape is None:
+            shape = ShapeConfig.OTAS_MINIMAL
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+                if joiner:
+                    params["joiner"] = joiner
+            if flat_lists:
+                params["flat_lists"] = "true"
+        data = self._get(f"/api/otas/{key}/", params)
+        return self._parse_response_with_shape(data, shape, OTA, flat, flat_lists, joiner=joiner)
+
+    def list_otidvs(
+        self,
+        limit: int = 25,
+        cursor: str | None = None,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+        joiner: str = ".",
+        award_date: str | None = None,
+        award_date_gte: str | None = None,
+        award_date_lte: str | None = None,
+        awarding_agency: str | None = None,
+        expiring_gte: str | None = None,
+        expiring_lte: str | None = None,
+        fiscal_year: int | None = None,
+        fiscal_year_gte: int | None = None,
+        fiscal_year_lte: int | None = None,
+        funding_agency: str | None = None,
+        ordering: str | None = None,
+        piid: str | None = None,
+        pop_end_date_gte: str | None = None,
+        pop_end_date_lte: str | None = None,
+        pop_start_date_gte: str | None = None,
+        pop_start_date_lte: str | None = None,
+        psc: str | None = None,
+        recipient: str | None = None,
+        search: str | None = None,
+        uei: str | None = None,
+    ) -> PaginatedResponse:
+        """List OTIDVs (Other Transaction IDVs) (`/api/otidvs/`). Keyset pagination."""
+        params: dict[str, Any] = {"limit": min(limit, 100)}
+        if cursor:
+            params["cursor"] = cursor
+        if shape is None:
+            shape = ShapeConfig.OTIDVS_MINIMAL
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+                if joiner:
+                    params["joiner"] = joiner
+            if flat_lists:
+                params["flat_lists"] = "true"
+        for key, val in (
+            ("award_date", award_date),
+            ("award_date_gte", award_date_gte),
+            ("award_date_lte", award_date_lte),
+            ("awarding_agency", awarding_agency),
+            ("expiring_gte", expiring_gte),
+            ("expiring_lte", expiring_lte),
+            ("fiscal_year", fiscal_year),
+            ("fiscal_year_gte", fiscal_year_gte),
+            ("fiscal_year_lte", fiscal_year_lte),
+            ("funding_agency", funding_agency),
+            ("ordering", ordering),
+            ("piid", piid),
+            ("pop_end_date_gte", pop_end_date_gte),
+            ("pop_end_date_lte", pop_end_date_lte),
+            ("pop_start_date_gte", pop_start_date_gte),
+            ("pop_start_date_lte", pop_start_date_lte),
+            ("psc", psc),
+            ("recipient", recipient),
+            ("search", search),
+            ("uei", uei),
+        ):
+            if val is not None:
+                params[key] = val
+        data = self._get("/api/otidvs/", params)
+        raw_results = data.get("results") or []
+        results = [
+            self._parse_response_with_shape(obj, shape, OTIDV, flat, flat_lists, joiner=joiner)
+            for obj in raw_results
+        ]
+        return PaginatedResponse(
+            count=int(data.get("count") or len(results)),
+            next=data.get("next"),
+            previous=data.get("previous"),
+            results=results,
+            cursor=data.get("cursor"),
+            page_metadata=data.get("page_metadata"),
+        )
+
+    def get_otidv(
+        self,
+        key: str,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+        joiner: str = ".",
+    ) -> Any:
+        """Get a single OTIDV by key (`/api/otidvs/{key}/`)."""
+        params: dict[str, Any] = {}
+        if shape is None:
+            shape = ShapeConfig.OTIDVS_MINIMAL
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+                if joiner:
+                    params["joiner"] = joiner
+            if flat_lists:
+                params["flat_lists"] = "true"
+        data = self._get(f"/api/otidvs/{key}/", params)
+        return self._parse_response_with_shape(data, shape, OTIDV, flat, flat_lists, joiner=joiner)
+
+    def list_subawards(
+        self,
+        page: int = 1,
+        limit: int = 25,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+        award_key: str | None = None,
+        awarding_agency: str | None = None,
+        fiscal_year: int | None = None,
+        fiscal_year_gte: int | None = None,
+        fiscal_year_lte: int | None = None,
+        funding_agency: str | None = None,
+        prime_uei: str | None = None,
+        recipient: str | None = None,
+        sub_uei: str | None = None,
+    ) -> PaginatedResponse:
+        """List subawards (`/api/subawards/`)."""
+        params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
+        if shape is None:
+            shape = ShapeConfig.SUBAWARDS_MINIMAL
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
+        for key, val in (
+            ("award_key", award_key),
+            ("awarding_agency", awarding_agency),
+            ("fiscal_year", fiscal_year),
+            ("fiscal_year_gte", fiscal_year_gte),
+            ("fiscal_year_lte", fiscal_year_lte),
+            ("funding_agency", funding_agency),
+            ("prime_uei", prime_uei),
+            ("recipient", recipient),
+            ("sub_uei", sub_uei),
+        ):
+            if val is not None:
+                params[key] = val
+        data = self._get("/api/subawards/", params)
+        results = [
+            self._parse_response_with_shape(obj, shape, Subaward, flat, flat_lists)
+            for obj in data.get("results", [])
+        ]
+        return PaginatedResponse(
+            count=data.get("count", 0),
+            next=data.get("next"),
+            previous=data.get("previous"),
+            results=results,
+        )
+
     # ============================================================================
     # Vehicles (Awards)
     # ============================================================================
@@ -957,6 +1317,42 @@ class TangoClient:
             results=[BusinessType(**btype) for btype in data["results"]],
         )
 
+    def list_naics(
+        self,
+        page: int = 1,
+        limit: int = 25,
+        employee_limit: int | None = None,
+        employee_limit_gte: int | None = None,
+        employee_limit_lte: int | None = None,
+        revenue_limit: int | None = None,
+        revenue_limit_gte: int | None = None,
+        revenue_limit_lte: int | None = None,
+        search: str | None = None,
+    ) -> PaginatedResponse:
+        """List NAICS codes (`/api/naics/`)."""
+        params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
+        if employee_limit is not None:
+            params["employee_limit"] = employee_limit
+        if employee_limit_gte is not None:
+            params["employee_limit_gte"] = employee_limit_gte
+        if employee_limit_lte is not None:
+            params["employee_limit_lte"] = employee_limit_lte
+        if revenue_limit is not None:
+            params["revenue_limit"] = revenue_limit
+        if revenue_limit_gte is not None:
+            params["revenue_limit_gte"] = revenue_limit_gte
+        if revenue_limit_lte is not None:
+            params["revenue_limit_lte"] = revenue_limit_lte
+        if search is not None:
+            params["search"] = search
+        data = self._get("/api/naics/", params)
+        return PaginatedResponse(
+            count=data.get("count", 0),
+            next=data.get("next"),
+            previous=data.get("previous"),
+            results=data.get("results", []),
+        )
+
     # Entity endpoints
     def list_entities(
         self,
@@ -966,7 +1362,7 @@ class TangoClient:
         flat: bool = False,
         flat_lists: bool = False,
         search: str | None = None,
-        **filters,
+        **filters: Any,
     ) -> PaginatedResponse:
         """
         List entities (vendors/recipients)
@@ -980,7 +1376,7 @@ class TangoClient:
             search: Search query (maps to 'q' parameter)
             **filters: Additional filter parameters (uei, cage_code, etc.)
         """
-        params = {"page": page, "limit": min(limit, 100)}
+        params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
 
         # Add shape parameter with default minimal shape
         if shape is None:
@@ -1046,7 +1442,7 @@ class TangoClient:
         shape: str | None = None,
         flat: bool = False,
         flat_lists: bool = False,
-        **filters,
+        **filters: Any,
     ) -> PaginatedResponse:
         """
         List contract forecasts
@@ -1059,7 +1455,7 @@ class TangoClient:
             flat_lists: If True, flatten arrays using indexed keys
             **filters: Additional filter parameters
         """
-        params = {"page": page, "limit": min(limit, 100)}
+        params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
 
         # Add shape parameter with default minimal shape
         if shape is None:
@@ -1096,7 +1492,7 @@ class TangoClient:
         shape: str | None = None,
         flat: bool = False,
         flat_lists: bool = False,
-        **filters,
+        **filters: Any,
     ) -> PaginatedResponse:
         """
         List contract opportunities/solicitations
@@ -1109,7 +1505,7 @@ class TangoClient:
             flat_lists: If True, flatten arrays using indexed keys
             **filters: Additional filter parameters
         """
-        params = {"page": page, "limit": min(limit, 100)}
+        params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
 
         # Add shape parameter with default minimal shape
         if shape is None:
@@ -1146,7 +1542,7 @@ class TangoClient:
         shape: str | None = None,
         flat: bool = False,
         flat_lists: bool = False,
-        **filters,
+        **filters: Any,
     ) -> PaginatedResponse:
         """
         List contract notices
@@ -1161,7 +1557,7 @@ class TangoClient:
             flat_lists: If True, flatten arrays using indexed keys
             **filters: Additional filter parameters
         """
-        params = {"page": page, "limit": min(limit, 100)}
+        params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
 
         # Add shape parameter with default minimal shape
         if shape is None:
@@ -1198,7 +1594,7 @@ class TangoClient:
         shape: str | None = None,
         flat: bool = False,
         flat_lists: bool = False,
-        **filters,
+        **filters: Any,
     ) -> PaginatedResponse:
         """
         List grants
@@ -1213,7 +1609,7 @@ class TangoClient:
             flat_lists: If True, flatten arrays using indexed keys
             **filters: Additional filter parameters
         """
-        params = {"page": page, "limit": min(limit, 100)}
+        params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
 
         # Add shape parameter with default minimal shape
         if shape is None:
@@ -1242,6 +1638,47 @@ 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

@@ -295,6 +295,50 @@ class IDV:
     recipient: RecipientProfile | None = None
 
 
+@dataclass
+class Organization:
+    """Schema definition for Organization (not used for instances)"""
+
+    key: str
+    fh_key: str | None = None
+    name: str | None = None
+    level: int | None = None
+    type: str | None = None
+
+
+@dataclass
+class OTA:
+    """Schema definition for OTA / Other Transaction Agreement (not used for instances)"""
+
+    key: str
+    piid: str | None = None
+    award_date: date | None = None
+    description: str | None = None
+    recipient: RecipientProfile | None = None
+
+
+@dataclass
+class OTIDV:
+    """Schema definition for OTIDV / Other Transaction IDV (not used for instances)"""
+
+    key: str
+    piid: str | None = None
+    award_date: date | None = None
+    description: str | None = None
+    recipient: RecipientProfile | None = None
+
+
+@dataclass
+class Subaward:
+    """Schema definition for Subaward (not used for instances)"""
+
+    id: str | None = None
+    award_key: str | None = None
+    prime_uei: str | None = None
+    sub_uei: str | None = None
+    amount: Decimal | None = None
+
+
 @dataclass
 class Vehicle:
     """Schema definition for Vehicle (not used for instances)"""
@@ -563,3 +607,20 @@ class ShapeConfig:
 
     # Default for list_vehicle_awardees()
     VEHICLE_AWARDEES_MINIMAL: Final = "uuid,key,piid,award_date,title,order_count,idv_obligations,idv_contracts_value,recipient(display_name,uei)"
+
+    # Default for list_organizations()
+    ORGANIZATIONS_MINIMAL: Final = "key,fh_key,name,level,type,short_name"
+
+    # Default for list_otas()
+    OTAS_MINIMAL: Final = (
+        "key,piid,award_date,recipient(display_name,uei),description,total_contract_value,obligated"
+    )
+
+    # Default for list_otidvs()
+    OTIDVS_MINIMAL: Final = "key,piid,award_date,recipient(display_name,uei),description,total_contract_value,obligated,idv_type"
+
+    # Default for list_subawards()
+    # Note: API does not accept "id" or "amount" in shape (unknown_field). Use only accepted fields.
+    SUBAWARDS_MINIMAL: Final = (
+        "award_key,prime_recipient(uei,display_name),subaward_recipient(uei,display_name)"
+    )

tango/shapes/explicit_schemas.py

@@ -975,6 +975,76 @@ VEHICLE_SCHEMA: dict[str, FieldSchema] = {
 }
 
 
+# Organization (agencies hierarchy)
+ORGANIZATION_SCHEMA: dict[str, FieldSchema] = {
+    "key": FieldSchema(name="key", type=str, is_optional=True, is_list=False),
+    "fh_key": FieldSchema(name="fh_key", type=str, is_optional=False, is_list=False),
+    "name": FieldSchema(name="name", type=str, is_optional=True, is_list=False),
+    "short_name": FieldSchema(name="short_name", type=str, is_optional=True, is_list=False),
+    "level": FieldSchema(name="level", type=int, is_optional=True, is_list=False),
+    "type": FieldSchema(name="type", type=str, is_optional=True, is_list=False),
+}
+
+# OTA (Other Transaction Agreement) - IDV-like
+OTA_SCHEMA: dict[str, FieldSchema] = {
+    "key": FieldSchema(name="key", type=str, is_optional=False, is_list=False),
+    "piid": FieldSchema(name="piid", type=str, is_optional=True, is_list=False),
+    "award_date": FieldSchema(name="award_date", type=date, is_optional=True, is_list=False),
+    "description": FieldSchema(name="description", type=str, is_optional=True, is_list=False),
+    "total_contract_value": FieldSchema(
+        name="total_contract_value", type=Decimal, is_optional=True, is_list=False
+    ),
+    "obligated": FieldSchema(name="obligated", type=Decimal, is_optional=True, is_list=False),
+    "recipient": FieldSchema(
+        name="recipient",
+        type=dict,
+        is_optional=True,
+        is_list=False,
+        nested_model="RecipientProfile",
+    ),
+}
+
+# OTIDV (Other Transaction IDV) - IDV-like
+OTIDV_SCHEMA: dict[str, FieldSchema] = {
+    "key": FieldSchema(name="key", type=str, is_optional=False, is_list=False),
+    "piid": FieldSchema(name="piid", type=str, is_optional=True, is_list=False),
+    "award_date": FieldSchema(name="award_date", type=date, is_optional=True, is_list=False),
+    "description": FieldSchema(name="description", type=str, is_optional=True, is_list=False),
+    "total_contract_value": FieldSchema(
+        name="total_contract_value", type=Decimal, is_optional=True, is_list=False
+    ),
+    "obligated": FieldSchema(name="obligated", type=Decimal, is_optional=True, is_list=False),
+    "idv_type": FieldSchema(name="idv_type", type=dict, is_optional=True, is_list=False),
+    "recipient": FieldSchema(
+        name="recipient",
+        type=dict,
+        is_optional=True,
+        is_list=False,
+        nested_model="RecipientProfile",
+    ),
+}
+
+# Subaward (prime/sub awards)
+SUBAWARD_SCHEMA: dict[str, FieldSchema] = {
+    "id": FieldSchema(name="id", type=str, is_optional=True, is_list=False),
+    "award_key": FieldSchema(name="award_key", type=str, is_optional=True, is_list=False),
+    "amount": FieldSchema(name="amount", type=Decimal, is_optional=True, is_list=False),
+    "prime_recipient": FieldSchema(
+        name="prime_recipient",
+        type=dict,
+        is_optional=True,
+        is_list=False,
+        nested_model="RecipientProfile",
+    ),
+    "subaward_recipient": FieldSchema(
+        name="subaward_recipient",
+        type=dict,
+        is_optional=True,
+        is_list=False,
+        nested_model="RecipientProfile",
+    ),
+}
+
 # ============================================================================
 # SCHEMA REGISTRY MAPPING
 # ============================================================================
@@ -1009,6 +1079,11 @@ EXPLICIT_SCHEMAS: dict[str, dict[str, FieldSchema]] = {
     "CFDANumber": CFDA_NUMBER_SCHEMA,
     "CodeDescription": CODE_DESCRIPTION_SCHEMA,
     "GrantAttachment": GRANT_ATTACHMENT_SCHEMA,
+    # Additional list endpoints
+    "Organization": ORGANIZATION_SCHEMA,
+    "OTA": OTA_SCHEMA,
+    "OTIDV": OTIDV_SCHEMA,
+    "Subaward": SUBAWARD_SCHEMA,
 }
 
 

{tango_python-0.3.0.dist-info → tango_python-0.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tango-python
-Version: 0.3.0
+Version: 0.4.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
@@ -487,8 +487,10 @@ tango-python/
 │   └── quick_start.ipynb    # Interactive quick start
 ├── scripts/                  # Utility scripts
 │   ├── README.md
+│   ├── check_filter_shape_conformance.py  # Filter + shape conformance (CI)
 │   ├── fetch_api_schema.py
-│   └── generate_schemas_from_api.py
+│   ├── generate_schemas_from_api.py
+│   └── pr_review.py          # PR validation (lint, types, tests, conformance)
 ├── pyproject.toml           # Project configuration
 ├── uv.lock                  # Dependency lock file
 ├── LICENSE                  # MIT License
@@ -526,7 +528,12 @@ Contributions are welcome! Please feel free to submit a Pull Request.
 
 1. Fork the repository
 2. Create your feature branch (`git checkout -b feature/amazing-feature`)
-3. Run tests (`uv run pytest`)
-4. Commit your changes (`git commit -m 'Add amazing feature'`)
-5. Push to the branch (`git push origin feature/amazing-feature`)
-6. Open a Pull Request
+3. Run lint and format: `uv run ruff format tango/ && uv run ruff check tango/`
+4. Run type checking: `uv run mypy tango/`
+5. Run tests: `uv run pytest`
+6. (Optional) Run [filter and shape conformance](scripts/README.md#filter-and-shape-conformance) if you have the tango API manifest; CI will run it on push/PR
+7. Commit your changes (`git commit -m 'Add amazing feature'`)
+8. Push to the branch (`git push origin feature/amazing-feature`)
+9. Open a Pull Request
+
+For a single command that runs formatting, linting, type checking, and tests (and conformance when the manifest is present), use: `uv run python scripts/pr_review.py --mode full`

{tango_python-0.3.0.dist-info → tango_python-0.4.0.dist-info}/RECORD

@@ -1,16 +1,16 @@
-tango/__init__.py,sha256=Pf_z5e6houpE5uwd6-UBvWH8geraP0XdvkIQ6ImyDkk,1050
-tango/client.py,sha256=BvccO-iHQHMA5xjps8IZbaG1IWXchEBWH2wxZZvnLXs,55501
+tango/__init__.py,sha256=PahQcpEfXRycCJhXaWm2-9AbfcdUKB8CC6EcN3AsBqc,1050
+tango/client.py,sha256=Y3ZsOCHX3zhrx7qjHWnQNIfLXidffxty1pBvY0yVrH0,71719
 tango/exceptions.py,sha256=JmtbOY0ofBnX24pUErh2XFlTj9dim2ngyboserEGRFw,2226
-tango/models.py,sha256=aArNNK_qH-P1diq_boAGBCKSdrNxLEjP0T0IjrpFfaM,17268
+tango/models.py,sha256=uEdNdEN40BAJ9OSZyoRE7L0UemSPzrQto80OZYeCVYE,19008
 tango/shapes/__init__.py,sha256=7ea1WU74jp4znhNw-gXruag6m6eyPZtbVgbDFmFUWro,1072
-tango/shapes/explicit_schemas.py,sha256=KDU5Xlvs2pM285ZLd-7lOJB7YcB38f8RHQwmRaUgH9o,47003
+tango/shapes/explicit_schemas.py,sha256=32g47TIdrJpNzlJfxg_OKu5H2o1l_3Z7JTDVf2bA4N8,50219
 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.3.0.dist-info/METADATA,sha256=XN1DvdP2s1y_S-nwFPiZH43bhTWxSLJkZILuOe4Y5P8,15576
-tango_python-0.3.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-tango_python-0.3.0.dist-info/licenses/LICENSE,sha256=j2kYVHMwTkoGn3ZNScnrdIueG0k2XzB_LCPFoyBc2wk,1064
-tango_python-0.3.0.dist-info/RECORD,,
+tango_python-0.4.0.dist-info/METADATA,sha256=WKMs-pFRxK6ENOUlI8mb6rUbNF95SuZtcVF5io9wSOQ,16210
+tango_python-0.4.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+tango_python-0.4.0.dist-info/licenses/LICENSE,sha256=j2kYVHMwTkoGn3ZNScnrdIueG0k2XzB_LCPFoyBc2wk,1064
+tango_python-0.4.0.dist-info/RECORD,,

{tango_python-0.3.0.dist-info → tango_python-0.4.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.28.0
+Generator: hatchling 1.29.0
 Root-Is-Purelib: true
 Tag: py3-none-any