tango-python 1.8.0__py3-none-any.whl → 1.10.0__py3-none-any.whl

tango/__init__.py

@@ -3,6 +3,7 @@
 from .client import TangoClient
 from .exceptions import (
     TangoAPIError,
+    TangoAttachmentLinkError,
     TangoAuthError,
     TangoNotFoundError,
     TangoRateLimitError,
@@ -14,6 +15,9 @@ from .models import (
     DibbsAward,
     DibbsRfp,
     DibbsRfq,
+    EbuyAccess,
+    EbuyAttachment,
+    EbuyRequest,
     Exclusion,
     FederalRegisterDocument,
     GsaElibraryContract,
@@ -55,13 +59,14 @@ from .webhooks import (
 )
 from .webhooks.receiver import Delivery, WebhookReceiver
 
-__version__ = "1.8.0"
+__version__ = "1.10.0"
 __all__ = [
     "TangoClient",
     "TangoAPIError",
     "TangoAuthError",
     "TangoNotFoundError",
     "TangoValidationError",
+    "TangoAttachmentLinkError",
     "TangoRateLimitError",
     "RateLimitInfo",
     "ResolveCandidate",
@@ -69,6 +74,9 @@ __all__ = [
     "BudgetAccount",
     "ContractAppeal",
     "FederalRegisterDocument",
+    "EbuyAccess",
+    "EbuyAttachment",
+    "EbuyRequest",
     "DibbsAward",
     "DibbsRfp",
     "DibbsRfq",

tango/client.py

@@ -5,12 +5,13 @@ import warnings
 from datetime import date, datetime
 from decimal import Decimal
 from typing import Any, Literal, cast
-from urllib.parse import urljoin
+from urllib.parse import quote, urljoin
 
 import httpx
 
 from tango.exceptions import (
     TangoAPIError,
+    TangoAttachmentLinkError,
     TangoAuthError,
     TangoNotFoundError,
     TangoRateLimitError,
@@ -28,6 +29,8 @@ from tango.models import (
     DibbsAward,
     DibbsRfp,
     DibbsRfq,
+    EbuyAccess,
+    EbuyRequest,
     Entity,
     Exclusion,
     FederalRegisterDocument,
@@ -175,55 +178,57 @@ class TangoClient:
             self._last_response_headers = response.headers
             self._last_rate_limit_info = self._parse_rate_limit_headers(response.headers)
 
-            if response.status_code == 401:
-                raise TangoAuthError(
-                    "Invalid API key or authentication required", response.status_code
-                )
-            elif response.status_code == 404:
-                raise TangoNotFoundError("Resource not found", response.status_code)
-            elif response.status_code == 400:
-                error_data = response.json() if response.content else {}
-                error_msg = "Invalid request parameters"
-                if error_data:
-                    # Try to extract a more specific error message
-                    if isinstance(error_data, dict):
-                        detail = (
-                            error_data.get("detail")
-                            or error_data.get("message")
-                            or error_data.get("error")
-                        )
-                        if detail:
-                            error_msg = f"Invalid request parameters: {detail}"
-                        issues = error_data.get("issues")
-                        if isinstance(issues, list):
-                            rejected = [
-                                f"{issue['path']} ({issue['reason']})"
-                                if issue.get("reason")
-                                else str(issue["path"])
-                                for issue in issues
-                                if isinstance(issue, dict) and issue.get("path")
-                            ]
-                            if rejected:
-                                error_msg = f"{error_msg}: {', '.join(rejected)}"
-                raise TangoValidationError(
-                    error_msg,
-                    response.status_code,
-                    error_data,
-                )
-            elif response.status_code == 429:
-                error_data = response.json() if response.content else {}
-                detail = error_data.get("detail", "Rate limit exceeded")
-                raise TangoRateLimitError(detail, response.status_code, error_data)
-            elif not response.is_success:
-                raise TangoAPIError(
-                    f"API request failed with status {response.status_code}", response.status_code
-                )
+            self._raise_for_status(response)
 
             return response.json() if response.content else {}
 
         except httpx.HTTPError as e:
             raise TangoAPIError(f"Request failed: {str(e)}") from e
 
+    def _raise_for_status(self, response: httpx.Response) -> None:
+        """Raise the SDK exception matching a non-success response; return quietly on success."""
+        if response.status_code == 401:
+            raise TangoAuthError("Invalid API key or authentication required", response.status_code)
+        elif response.status_code == 404:
+            raise TangoNotFoundError("Resource not found", response.status_code)
+        elif response.status_code == 400:
+            error_data = response.json() if response.content else {}
+            error_msg = "Invalid request parameters"
+            if error_data:
+                # Try to extract a more specific error message
+                if isinstance(error_data, dict):
+                    detail = (
+                        error_data.get("detail")
+                        or error_data.get("message")
+                        or error_data.get("error")
+                    )
+                    if detail:
+                        error_msg = f"Invalid request parameters: {detail}"
+                    issues = error_data.get("issues")
+                    if isinstance(issues, list):
+                        rejected = [
+                            f"{issue['path']} ({issue['reason']})"
+                            if issue.get("reason")
+                            else str(issue["path"])
+                            for issue in issues
+                            if isinstance(issue, dict) and issue.get("path")
+                        ]
+                        if rejected:
+                            error_msg = f"{error_msg}: {', '.join(rejected)}"
+            raise TangoValidationError(
+                error_msg,
+                response.status_code,
+                error_data,
+            )
+        elif response.status_code == 429:
+            error_data = response.json() if response.content else {}
+            detail = error_data.get("detail", "Rate limit exceeded")
+            raise TangoRateLimitError(detail, response.status_code, error_data)
+        elif not response.is_success:
+            raise TangoAPIError(
+                f"API request failed with status {response.status_code}", response.status_code
+            )
+
     def _get(self, endpoint: str, params: dict[str, Any] | None = None) -> dict[str, Any]:
         """Make a GET request"""
         return self._request("GET", endpoint, params=params)
@@ -2963,6 +2968,215 @@ class TangoClient:
             data, shape, FederalRegisterDocument, flat, flat_lists
         )
 
+    # ============================================================================
+    # GSA eBuy requests
+    # ============================================================================
+
+    def list_ebuy_requests(
+        self,
+        page: int = 1,
+        limit: int = 25,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+        search: str | None = None,
+        rfq_id: str | None = None,
+        reference_number: str | None = None,
+        request_type: str | None = None,
+        status: str | None = None,
+        sin: str | None = None,
+        schedule: str | None = None,
+        buyer_agency: str | None = None,
+        agency: str | None = None,
+        contract_number: str | None = None,
+        issue_date_after: str | None = None,
+        issue_date_before: str | None = None,
+        close_date_after: str | None = None,
+        close_date_before: str | None = None,
+        ordering: str | None = None,
+    ) -> PaginatedResponse:
+        """
+        List GSA eBuy requests (RFQs, RFPs and RFIs).
+
+        Requires the Pro tier or above; below it the API returns 403.
+        Results are scoped to your account: you see only requests posted under the GSA schedule contracts linked to it.
+        With no linked contract the page is empty rather than an error, so use ``get_ebuy_access()`` to tell "no access" from "no matches".
+
+        ``status`` is frozen at the last state the request was seen in.
+        Only currently-active requests are carried, so a request that closes stops appearing rather than getting a final row, and ``Open`` means "open the last time it was seen".
+        Read ``last_seen`` for staleness.
+
+        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
+            search: Full-text search over the title, description, reference number, request id and attachment text. Results rank by relevance unless ``ordering`` is given
+            rfq_id: Exact request id, e.g. ``RFQ1835158``. OR several with ``|``
+            reference_number: The buyer's own solicitation number; dashes are ignored
+            request_type: ``RFQ``, ``RFP`` or ``RFI``. OR several with ``|``
+            status: ``Open`` or ``Cancelled``, as last seen. OR several with ``|``
+            sin: Special Item Number, e.g. ``54151S``. OR several with ``|``
+            schedule: GSA schedule. OR several with ``|``
+            buyer_agency: The buyer agency as eBuy names it (free text). OR several with ``|``
+            agency: A Tango agency name, abbreviation, code or organization key, e.g. ``GSA``. Matches the whole organization subtree, so a department includes its sub-agencies. OR several with ``|``. Requires Tango API 5.3.0
+            contract_number: Narrow to requests posted under one of your own linked contracts. A contract not linked to your account returns an empty page, not an error
+            issue_date_after: Issued on or after (YYYY-MM-DD)
+            issue_date_before: Issued on or before (YYYY-MM-DD)
+            close_date_after: Closes on or after (YYYY-MM-DD)
+            close_date_before: Closes on or before (YYYY-MM-DD)
+            ordering: Sort field — ``issue_date`` (the default, as ``-issue_date``), ``close_date``, ``last_seen`` or ``modified``. Prefix ``-`` for descending
+        """
+        params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
+
+        if shape is None:
+            shape = ShapeConfig.EBUY_REQUESTS_MINIMAL
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
+
+        for key, val in (
+            ("search", search),
+            ("rfq_id", rfq_id),
+            ("reference_number", reference_number),
+            ("request_type", request_type),
+            ("status", status),
+            ("sin", sin),
+            ("schedule", schedule),
+            ("buyer_agency", buyer_agency),
+            ("agency", agency),
+            ("contract_number", contract_number),
+            ("issue_date_after", issue_date_after),
+            ("issue_date_before", issue_date_before),
+            ("close_date_after", close_date_after),
+            ("close_date_before", close_date_before),
+            ("ordering", ordering),
+        ):
+            if val is not None:
+                params[key] = val
+
+        data = self._get("/api/ebuy/requests/", params)
+
+        results = [
+            self._parse_response_with_shape(item, shape, EbuyRequest, flat, flat_lists)
+            for item in data["results"]
+        ]
+
+        return PaginatedResponse(
+            count=data["count"],
+            next=data.get("next"),
+            previous=data.get("previous"),
+            results=results,
+            meta=data.get("meta"),
+        )
+
+    def get_ebuy_request(
+        self,
+        rfq_id: str,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+    ) -> Any:
+        """
+        Get a single GSA eBuy request by its request id.
+
+        A request outside your account's scope raises ``TangoNotFoundError``, the same as an id that does not exist.
+
+        Args:
+            rfq_id: Request id, e.g. ``RFQ1835158``
+            shape: Response shape string (defaults to the comprehensive shape: every field plus the ``organization`` and ``attachments`` expands)
+            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.EBUY_REQUESTS_COMPREHENSIVE
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
+
+        data = self._get(f"/api/ebuy/requests/{quote(rfq_id, safe='')}/", params)
+        return self._parse_response_with_shape(data, shape, EbuyRequest, flat, flat_lists)
+
+    def get_ebuy_attachment_url(self, rfq_id: str, doc_seq_num: int) -> str:
+        """
+        Get a short-lived download URL for one attachment on a GSA eBuy request.
+
+        The API answers with a redirect to a signed URL that expires after about five minutes; this returns that URL without downloading the document.
+        Fetch it promptly, and call this again rather than storing it.
+
+        Args:
+            rfq_id: Request id, e.g. ``RFQ1835158``
+            doc_seq_num: The attachment's ``doc_seq_num`` from ``get_ebuy_request()``
+
+        Raises:
+            TangoAttachmentLinkError: The entry is an external link (``is_link``), not a stored document. The link is on ``.url`` and in the message. Subclasses ``TangoValidationError``.
+            TangoNotFoundError: The request is unknown or outside your scope, the attachment does not exist, or its document has not been captured yet.
+        """
+        endpoint = (
+            f"/api/ebuy/requests/{quote(rfq_id, safe='')}/attachments/{int(doc_seq_num)}/download/"
+        )
+        url = urljoin(f"{self.base_url}/", endpoint.lstrip("/"))
+
+        try:
+            response = self.client.request(method="GET", url=url, follow_redirects=False)
+        except httpx.HTTPError as e:
+            raise TangoAPIError(f"Request failed: {str(e)}") from e
+        self._last_response_headers = response.headers
+        self._last_rate_limit_info = self._parse_rate_limit_headers(response.headers)
+
+        location = response.headers.get("Location")
+        if response.is_redirect and location:
+            return str(location)
+
+        if response.status_code in (400, 404):
+            try:
+                error_data = response.json() if response.content else {}
+            except ValueError:
+                error_data = {}
+            if not isinstance(error_data, dict):
+                error_data = {}
+            if response.status_code == 400 and error_data.get("url"):
+                raise TangoAttachmentLinkError(
+                    f"Attachment {doc_seq_num} on {rfq_id} is an external link, not a stored document: {error_data['url']}",
+                    response.status_code,
+                    error_data,
+                )
+            if response.status_code == 404:
+                raise TangoNotFoundError(
+                    error_data.get("detail") or "Resource not found",
+                    response.status_code,
+                    error_data,
+                )
+
+        self._raise_for_status(response)
+        raise TangoAPIError(
+            f"Expected a redirect to the attachment, got status {response.status_code}",
+            response.status_code,
+        )
+
+    def get_ebuy_access(self) -> EbuyAccess:
+        """
+        Check whether your account can read GSA eBuy requests.
+
+        ``list_ebuy_requests()`` returns an empty page, not an error, when no contract is linked; this tells the two apart.
+        ``reason`` is ``"tier_required"`` below the Pro tier (it wins when both apply), ``"no_contract_grant"`` when no contract is linked, and ``None`` when ``enabled`` is true.
+        ``contracts`` lists your own linked contracts, sorted.
+        """
+        data = self._get("/api/ebuy/access/")
+        return EbuyAccess(
+            enabled=bool(data.get("enabled")),
+            reason=data.get("reason"),
+            contracts=list(data.get("contracts") or []),
+        )
+
     # ============================================================================
     # DLA DIBBS (RFQs, RFPs, awards)
     # ============================================================================
@@ -3519,6 +3733,7 @@ class TangoClient:
         flat_lists: bool = False,
         topic_number: str | None = None,
         solicitation_number: str | None = None,
+        cycle_name: str | None = None,
         agency: str | None = None,
         activity: str | None = None,
         year: int | None = None,
@@ -3545,6 +3760,7 @@ class TangoClient:
             flat_lists: If True, flatten arrays using indexed keys
             topic_number: Filter by topic number
             solicitation_number: Filter by solicitation number
+            cycle_name: Filter by DSIP solicitation cycle, exact (e.g. "DOD_SBIR_2026_P1_CBZ"; requires Tango API 5.3.1)
             agency: Filter by agency
             activity: Filter by activity (component/branch)
             year: Filter by solicitation year
@@ -3572,6 +3788,7 @@ class TangoClient:
         for key, val in (
             ("topic_number", topic_number),
             ("solicitation_number", solicitation_number),
+            ("cycle_name", cycle_name),
             ("agency", agency),
             ("activity", activity),
             ("year", year),
@@ -5022,7 +5239,7 @@ class TangoClient:
             query_type: One of ``opportunity``, ``contract``, ``idv``, ``ota``,
                 ``otidv``, ``entity``, ``grant``, ``forecast``, ``exclusion``,
                 ``dibbs_rfq``, ``dibbs_rfp``, ``sled_opportunity``,
-                ``contract_appeal`` or ``federal_register``. :meth:`list_webhook_event_types` is the
+                ``contract_appeal``, ``federal_register`` or ``ebuy_request``. :meth:`list_webhook_event_types` is the
                 current authority — this list can only go stale.
             filters: Dict of query parameters that the alert matches against
                 (e.g. ``{"naics": "541330", "set_aside": "SBA"}``).

tango/exceptions.py

@@ -53,6 +53,16 @@ class TangoValidationError(TangoAPIError):
         return val if isinstance(val, dict) else None
 
 
+class TangoAttachmentLinkError(TangoValidationError):
+    """The requested attachment is an external link, not a stored document, so there is nothing to download."""
+
+    @property
+    def url(self) -> str | None:
+        """The external link the entry points at."""
+        val = self.response_data.get("url")
+        return val if isinstance(val, str) else None
+
+
 class TangoRateLimitError(TangoAPIError):
     """Rate limit exceeded error"""
 

tango/models.py

@@ -1000,6 +1000,7 @@ class SbirTopic:
     activity: str | None = None
     year: int | None = None
     solicitation_number: str | None = None
+    cycle_name: str | None = None
     solicitation_status: str | None = None
     release_date: str | None = None
     open_date: str | None = None
@@ -1272,6 +1273,97 @@ class FederalRegisterDocument:
     full_text: str | None = None
 
 
+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.
+    """
+
+    doc_seq_num: int | None = None
+    doc_name: str | None = None
+    doc_type: int | None = None
+    doc_path: str | None = None
+    is_link: bool | None = None
+    doc_session_date: datetime | None = None
+
+
+class EbuyRequest:
+    """Schema definition for EbuyRequest (not used for instances).
+
+    GSA eBuy requests (RFQs, RFPs, RFIs) at ``/api/ebuy/requests/``, keyed by ``rfq_id``.
+    Shape-on-demand, so every field is optional.
+
+    The resource is scoped to your account: you see only requests posted under the GSA schedule contracts linked to it.
+
+    ``status`` is frozen at the last state the request was seen in.
+    Only currently-active requests are carried, so a request that closes stops appearing rather than getting a final row, and ``Open`` means "open the last time it was seen".
+    Read ``last_seen`` for staleness.
+
+    ``buyer_agency_code`` and some other buyer and contact fields are sparse on older requests.
+    The contract number a request was posted under is never returned.
+    """
+
+    rfq_id: str | None = None
+    request_type: str | None = None
+    title: str | None = None
+    description: str | None = None
+    schedule: str | None = None
+    sin: str | None = None
+    status: str | None = None
+    buyer_name: str | None = None
+    buyer_agency: str | None = None
+    buyer_agency_code: str | None = None
+    buyer_email: str | None = None
+    buyer_user_id: str | None = None
+    reference_number: str | None = None
+    award_method: str | None = None
+    contract_type: str | None = None
+    commercial_type: str | None = None
+    follow_on: bool | None = None
+    source_sought: bool | None = None
+    issue_date: datetime | None = None
+    close_date: datetime | None = None
+    cancel_date: datetime | None = None
+    last_mod_date: datetime | None = None
+    pop_start_date: datetime | None = None
+    pop_end_date: datetime | None = None
+    oco_name: str | None = None
+    oco_title: str | None = None
+    oco_agency: str | None = None
+    oco_phone: str | None = None
+    oco_aac: str | None = None
+    ocs_name: str | None = None
+    ocs_title: str | None = None
+    ocs_agency: str | None = None
+    ocs_phone: str | None = None
+    ocs_aac: str | None = None
+    amendment_count: int | None = None
+    mod_version: int | None = None
+    qa_document_count: int | None = None
+    attachment_count: int | None = None
+    link_count: int | None = None
+    amendments: list[dict[str, Any]] | None = None
+    line_items: list[dict[str, Any]] | None = None
+    addresses: list[dict[str, Any]] | None = None
+    detail_fetched: bool | None = None
+    first_seen: datetime | None = None
+    last_seen: datetime | None = None
+    organization: dict[str, Any] | None = None
+    attachments: list[EbuyAttachment] | None = None
+
+
+@dataclass
+class EbuyAccess:
+    """Result of ``GET /api/ebuy/access/``: whether your account can read eBuy requests.
+
+    ``list_ebuy_requests()`` returns an empty page, not an error, when no contract is linked, so this is how to tell "no access" from "no matches".
+    """
+
+    enabled: bool
+    reason: Literal["tier_required", "no_contract_grant"] | None
+    contracts: list[str]
+
+
 @dataclass
 class PaginatedResponse[T]:
     """Paginated API response
@@ -1471,6 +1563,26 @@ class ShapeConfig:
         "comment_url,regulations_dot_gov_url,raw_text_url,body_html_url"
     )
 
+    # Default for list_ebuy_requests(). Mirrors the API's own list default.
+    EBUY_REQUESTS_MINIMAL: Final = (
+        "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"
+    )
+
+    # Default for get_ebuy_request(). Mirrors the API's own retrieve default; the attachment fields are named rather than `attachments(*)` so their dates parse.
+    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,"
+        "award_method,contract_type,commercial_type,follow_on,source_sought,issue_date,"
+        "close_date,cancel_date,last_mod_date,pop_start_date,pop_end_date,oco_name,"
+        "oco_title,oco_agency,oco_phone,oco_aac,ocs_name,ocs_title,ocs_agency,ocs_phone,"
+        "ocs_aac,amendment_count,mod_version,qa_document_count,attachment_count,"
+        "link_count,amendments,line_items,addresses,detail_fetched,first_seen,last_seen,"
+        "organization(*),"
+        "attachments(doc_seq_num,doc_name,doc_type,doc_path,is_link,doc_session_date)"
+    )
+
     # Default for list_dibbs_rfqs()
     DIBBS_RFQS_MINIMAL: Final = (
         "uuid,solicitation,nsn,part_number,nomenclature,quantity,issue_date,return_by_date,is_open"

tango/shapes/explicit_schemas.py

@@ -877,6 +877,97 @@ FEDERAL_REGISTER_DOCUMENT_SCHEMA: dict[str, FieldSchema] = {
 }
 
 
+EBUY_ATTACHMENT_SCHEMA: dict[str, FieldSchema] = {
+    "doc_seq_num": FieldSchema(name="doc_seq_num", type=int, is_optional=True, is_list=False),
+    "doc_name": FieldSchema(name="doc_name", type=str, is_optional=True, is_list=False),
+    "doc_type": FieldSchema(name="doc_type", type=int, is_optional=True, is_list=False),
+    "doc_path": FieldSchema(name="doc_path", type=str, is_optional=True, is_list=False),
+    "is_link": FieldSchema(name="is_link", type=bool, is_optional=True, is_list=False),
+    "doc_session_date": FieldSchema(
+        name="doc_session_date", type=datetime, is_optional=True, is_list=False
+    ),
+}
+
+
+EBUY_REQUEST_SCHEMA: dict[str, FieldSchema] = {
+    "rfq_id": FieldSchema(name="rfq_id", type=str, is_optional=True, is_list=False),
+    "request_type": FieldSchema(name="request_type", type=str, is_optional=True, is_list=False),
+    "title": FieldSchema(name="title", type=str, is_optional=True, is_list=False),
+    "description": FieldSchema(name="description", type=str, is_optional=True, is_list=False),
+    "schedule": FieldSchema(name="schedule", type=str, is_optional=True, is_list=False),
+    "sin": FieldSchema(name="sin", type=str, is_optional=True, is_list=False),
+    "status": FieldSchema(name="status", type=str, is_optional=True, is_list=False),
+    "buyer_name": FieldSchema(name="buyer_name", type=str, is_optional=True, is_list=False),
+    "buyer_agency": FieldSchema(name="buyer_agency", type=str, is_optional=True, is_list=False),
+    "buyer_agency_code": FieldSchema(
+        name="buyer_agency_code", type=str, is_optional=True, is_list=False
+    ),
+    "buyer_email": FieldSchema(name="buyer_email", type=str, is_optional=True, is_list=False),
+    "buyer_user_id": FieldSchema(name="buyer_user_id", type=str, is_optional=True, is_list=False),
+    "reference_number": FieldSchema(
+        name="reference_number", type=str, is_optional=True, is_list=False
+    ),
+    "award_method": FieldSchema(name="award_method", type=str, is_optional=True, is_list=False),
+    "contract_type": FieldSchema(name="contract_type", type=str, is_optional=True, is_list=False),
+    "commercial_type": FieldSchema(
+        name="commercial_type", type=str, is_optional=True, is_list=False
+    ),
+    "follow_on": FieldSchema(name="follow_on", type=bool, is_optional=True, is_list=False),
+    "source_sought": FieldSchema(name="source_sought", type=bool, is_optional=True, is_list=False),
+    "issue_date": FieldSchema(name="issue_date", type=datetime, is_optional=True, is_list=False),
+    "close_date": FieldSchema(name="close_date", type=datetime, is_optional=True, is_list=False),
+    "cancel_date": FieldSchema(name="cancel_date", type=datetime, is_optional=True, is_list=False),
+    "last_mod_date": FieldSchema(
+        name="last_mod_date", type=datetime, is_optional=True, is_list=False
+    ),
+    "pop_start_date": FieldSchema(
+        name="pop_start_date", type=datetime, is_optional=True, is_list=False
+    ),
+    "pop_end_date": FieldSchema(
+        name="pop_end_date", type=datetime, is_optional=True, is_list=False
+    ),
+    "oco_name": FieldSchema(name="oco_name", type=str, is_optional=True, is_list=False),
+    "oco_title": FieldSchema(name="oco_title", type=str, is_optional=True, is_list=False),
+    "oco_agency": FieldSchema(name="oco_agency", type=str, is_optional=True, is_list=False),
+    "oco_phone": FieldSchema(name="oco_phone", type=str, is_optional=True, is_list=False),
+    "oco_aac": FieldSchema(name="oco_aac", type=str, is_optional=True, is_list=False),
+    "ocs_name": FieldSchema(name="ocs_name", type=str, is_optional=True, is_list=False),
+    "ocs_title": FieldSchema(name="ocs_title", type=str, is_optional=True, is_list=False),
+    "ocs_agency": FieldSchema(name="ocs_agency", type=str, is_optional=True, is_list=False),
+    "ocs_phone": FieldSchema(name="ocs_phone", type=str, is_optional=True, is_list=False),
+    "ocs_aac": FieldSchema(name="ocs_aac", type=str, is_optional=True, is_list=False),
+    "amendment_count": FieldSchema(
+        name="amendment_count", type=int, is_optional=True, is_list=False
+    ),
+    "mod_version": FieldSchema(name="mod_version", type=int, is_optional=True, is_list=False),
+    "qa_document_count": FieldSchema(
+        name="qa_document_count", type=int, is_optional=True, is_list=False
+    ),
+    "attachment_count": FieldSchema(
+        name="attachment_count", type=int, is_optional=True, is_list=False
+    ),
+    "link_count": FieldSchema(name="link_count", type=int, is_optional=True, is_list=False),
+    "amendments": FieldSchema(name="amendments", type=dict, is_optional=True, is_list=True),
+    "line_items": FieldSchema(name="line_items", type=dict, is_optional=True, is_list=True),
+    "addresses": FieldSchema(name="addresses", type=dict, is_optional=True, is_list=True),
+    "detail_fetched": FieldSchema(
+        name="detail_fetched", type=bool, is_optional=True, is_list=False
+    ),
+    "first_seen": FieldSchema(name="first_seen", type=datetime, is_optional=True, is_list=False),
+    "last_seen": FieldSchema(name="last_seen", type=datetime, is_optional=True, is_list=False),
+    "organization": FieldSchema(
+        name="organization",
+        type=dict,
+        is_optional=True,
+        is_list=False,
+        nested_model="OrganizationOffice",
+    ),
+    "attachments": FieldSchema(
+        name="attachments", type=dict, is_optional=True, is_list=True, nested_model="EbuyAttachment"
+    ),
+}
+
+
 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),
@@ -1623,6 +1714,8 @@ EXPLICIT_SCHEMAS: dict[str, dict[str, FieldSchema]] = {
     "ProtestDocket": PROTEST_DOCKET_SCHEMA,
     "ContractAppeal": CONTRACT_APPEAL_SCHEMA,
     "FederalRegisterDocument": FEDERAL_REGISTER_DOCUMENT_SCHEMA,
+    "EbuyRequest": EBUY_REQUEST_SCHEMA,
+    "EbuyAttachment": EBUY_ATTACHMENT_SCHEMA,
     "Agency": AGENCY_SCHEMA,
     "Grant": GRANT_SCHEMA,
     # Vehicles (Awards)

tango/shapes/generated_overlay.py

@@ -81,17 +81,6 @@ ARCHIVE_SCHEMA: dict[str, FieldSchema] = {
 }
 
 ATTACHMENTS_SCHEMA: dict[str, FieldSchema] = {
-    "doc_name": FieldSchema(name="doc_name", type=str, is_optional=True, is_list=False),
-    "doc_path": FieldSchema(name="doc_path", type=str, is_optional=True, is_list=False),
-    "doc_seq_num": FieldSchema(name="doc_seq_num", type=str, is_optional=True, is_list=False),
-    "doc_session_date": FieldSchema(
-        name="doc_session_date", type=date, is_optional=True, is_list=False
-    ),
-    "doc_type": FieldSchema(name="doc_type", type=str, is_optional=True, is_list=False),
-    "is_link": FieldSchema(name="is_link", type=bool, is_optional=True, is_list=False),
-}
-
-ATTACHMENTS2_SCHEMA: dict[str, FieldSchema] = {
     "attachment_id": FieldSchema(name="attachment_id", type=str, is_optional=True, is_list=False),
     "doc_role": FieldSchema(name="doc_role", type=str, is_optional=True, is_list=False),
     "doc_role_alt": FieldSchema(name="doc_role_alt", type=str, is_optional=True, is_list=False),
@@ -105,7 +94,7 @@ ATTACHMENTS2_SCHEMA: dict[str, FieldSchema] = {
     "url": FieldSchema(name="url", type=str, is_optional=True, is_list=False),
 }
 
-ATTACHMENTS3_SCHEMA: dict[str, FieldSchema] = {
+ATTACHMENTS2_SCHEMA: dict[str, FieldSchema] = {
     "attachment_id": FieldSchema(name="attachment_id", type=str, is_optional=True, is_list=False),
     "doc_role": FieldSchema(name="doc_role", type=str, is_optional=True, is_list=False),
     "doc_role_alt": FieldSchema(name="doc_role_alt", type=str, is_optional=True, is_list=False),
@@ -119,7 +108,7 @@ ATTACHMENTS3_SCHEMA: dict[str, FieldSchema] = {
     "url": FieldSchema(name="url", type=str, is_optional=True, is_list=False),
 }
 
-ATTACHMENTS4_SCHEMA: dict[str, FieldSchema] = {
+ATTACHMENTS3_SCHEMA: dict[str, FieldSchema] = {
     "char_count": FieldSchema(name="char_count", type=int, is_optional=True, is_list=False),
     "checksum": FieldSchema(name="checksum", type=str, is_optional=True, is_list=False),
     "download_status": FieldSchema(
@@ -144,7 +133,7 @@ ATTACHMENTS4_SCHEMA: dict[str, FieldSchema] = {
     "word_count": FieldSchema(name="word_count", type=int, is_optional=True, is_list=False),
 }
 
-ATTACHMENTS5_SCHEMA: dict[str, FieldSchema] = {
+ATTACHMENTS4_SCHEMA: dict[str, FieldSchema] = {
     "attachment_id": FieldSchema(name="attachment_id", type=str, is_optional=True, is_list=False),
     "file_size": FieldSchema(name="file_size", type=str, is_optional=True, is_list=False),
     "mime_type": FieldSchema(name="mime_type", type=str, is_optional=True, is_list=False),
@@ -155,7 +144,7 @@ ATTACHMENTS5_SCHEMA: dict[str, FieldSchema] = {
     "url": FieldSchema(name="url", type=str, is_optional=True, is_list=False),
 }
 
-ATTACHMENTS6_SCHEMA: dict[str, FieldSchema] = {
+ATTACHMENTS5_SCHEMA: dict[str, FieldSchema] = {
     "attachment_id": FieldSchema(name="attachment_id", type=str, is_optional=True, is_list=False),
     "doc_role": FieldSchema(name="doc_role", type=str, is_optional=True, is_list=False),
     "doc_role_alt": FieldSchema(name="doc_role_alt", type=str, is_optional=True, is_list=False),
@@ -1119,7 +1108,6 @@ GENERATED_NESTED: dict[str, dict[str, FieldSchema]] = {
     "Attachments3": ATTACHMENTS3_SCHEMA,
     "Attachments4": ATTACHMENTS4_SCHEMA,
     "Attachments5": ATTACHMENTS5_SCHEMA,
-    "Attachments6": ATTACHMENTS6_SCHEMA,
     "Awardee": AWARDEE_SCHEMA,
     "AwardingOffice": AWARDING_OFFICE_SCHEMA,
     "AwardingOffice2": AWARDING_OFFICE2_SCHEMA,
@@ -2238,7 +2226,7 @@ GENERATED_OVERLAY: dict[str, dict[str, FieldSchema]] = {
             type=dict,
             is_optional=True,
             is_list=True,
-            nested_model="Attachments2",
+            nested_model="Attachments",
         ),
         "meta": FieldSchema(
             name="meta", type=dict, is_optional=True, is_list=False, nested_model="Meta"
@@ -2486,7 +2474,7 @@ GENERATED_OVERLAY: dict[str, dict[str, FieldSchema]] = {
             type=dict,
             is_optional=True,
             is_list=False,
-            nested_model="Attachments6",
+            nested_model="Attachments5",
         ),
         "department": FieldSchema(
             name="department",
@@ -2743,6 +2731,7 @@ GENERATED_OVERLAY: dict[str, dict[str, FieldSchema]] = {
         "activity": FieldSchema(name="activity", type=str, is_optional=True, is_list=False),
         "agency": FieldSchema(name="agency", type=str, is_optional=True, is_list=False),
         "close_date": FieldSchema(name="close_date", type=date, is_optional=True, is_list=False),
+        "cycle_name": FieldSchema(name="cycle_name", type=str, is_optional=True, is_list=False),
         "description": FieldSchema(name="description", type=str, is_optional=True, is_list=False),
         "doc_source": FieldSchema(name="doc_source", type=str, is_optional=True, is_list=False),
         "due_dates_text": FieldSchema(
@@ -2873,7 +2862,7 @@ GENERATED_OVERLAY: dict[str, dict[str, FieldSchema]] = {
             type=dict,
             is_optional=True,
             is_list=True,
-            nested_model="Attachments4",
+            nested_model="Attachments3",
         ),
         "bid_opening_date": FieldSchema(
             name="bid_opening_date", type=datetime, is_optional=True, is_list=False

{tango_python-1.8.0.dist-info → tango_python-1.10.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: tango-python
-Version: 1.8.0
+Version: 1.10.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
@@ -308,6 +308,15 @@ protests = client.list_protests(source_system="gao", outcome="Sustained", limit=
 protest = client.get_protest("CASE_UUID")
 ```
 
+### GSA eBuy
+
+```python
+access = client.get_ebuy_access()  # scoped to the schedule contracts linked to your account
+requests = client.list_ebuy_requests(status="Open", sin="54151S", limit=25)
+request = client.get_ebuy_request("RFQ1835158")
+url = client.get_ebuy_attachment_url("RFQ1835158", doc_seq_num=1)  # short-lived signed URL
+```
+
 ### GSA eLibrary Contracts
 
 ```python

{tango_python-1.8.0.dist-info → tango_python-1.10.0.dist-info}/RECORD

@@ -1,11 +1,11 @@
-tango/__init__.py,sha256=uUcnPf4IZjC6ldsu-8CBI6gJMrvg1_EfbTILjLYevW4,2360
-tango/client.py,sha256=hLYbP-lBIBVzSVamOJwSATHqi6ijba6-XtMAB-XTyyo,228019
-tango/exceptions.py,sha256=B1t27BBxHcPglAfJQyan5khNEYNAyF6Wkp2EmPMdRxM,3858
-tango/models.py,sha256=KI0I9I9LBetpRUkl0YS7hHbsM2vrOflN83crNSVBUiY,61897
+tango/__init__.py,sha256=rSPFjxFs-K1mVSICHc9nU94SvN5N2dhBEDVrD9y2BII,2535
+tango/client.py,sha256=Srf-68uv9VvO5Dv0hi9SP-bHorOQl97zOysmX1owTeA,237960
+tango/exceptions.py,sha256=oPiLCccBoWLK5SjHkzP-oI6mUD9twEeKSvEuLV5h01I,4224
+tango/models.py,sha256=MwloM-gYq0ng9obnDn_lqYFG_cJ5aQZq6OvDqrW7S2s,66647
 tango/shapes/__init__.py,sha256=7ea1WU74jp4znhNw-gXruag6m6eyPZtbVgbDFmFUWro,1072
-tango/shapes/explicit_schemas.py,sha256=41k6rOBMFz-6imGIZ5mXeK26M0s-nmIUZJXQeDjQFH0,78508
+tango/shapes/explicit_schemas.py,sha256=spYyMmWKOiMJygz9yViBQrjIxUPFfv7HpVkJcWy13x8,84021
 tango/shapes/factory.py,sha256=uDPhnp6VVzrLBKodxteZy5AcU43juEv-qKVRWth51j0,31550
-tango/shapes/generated_overlay.py,sha256=OuwuyixXplySy5SM0FqQ0KKPOJJ490zyOi3wzP3DEOQ,139031
+tango/shapes/generated_overlay.py,sha256=udDQ1vQ9d4DpAOyhjRhsTD_8gx9QqhZfwk_PKXwZUJE,138465
 tango/shapes/generator.py,sha256=xzakpwTwqTMUr89I06hp54-FIYZziviWHk2Glscg-LM,22775
 tango/shapes/models.py,sha256=h3pIhOqrrdlN953Y6r0oney5HFbKPOD-frRndRWimJ0,3018
 tango/shapes/parser.py,sha256=AecNx5oT_hV_pf2AWZnsR8Y2aLmCtjfgS9-znA2Pesc,27429
@@ -16,8 +16,8 @@ tango/webhooks/cli.py,sha256=f_vQbJ2AeSQjKnQo7MxHFyUB2SAKcgHYmGQULS0isqQ,13858
 tango/webhooks/receiver.py,sha256=5yhsVhlLyoxmOCGvmbynWAIlDB2OaCPVf1H4GA1SxmU,9279
 tango/webhooks/signing.py,sha256=92Ee-0B6PR7ZkvY3Np3gzl88-mtfKkh-I7lxqCe2lGw,2374
 tango/webhooks/simulate.py,sha256=g2Osa0FYU5mJuon07T2aUCtmkUoTEzsY261tlp76fF0,3165
-tango_python-1.8.0.dist-info/METADATA,sha256=46doMnyaajvAdOUSTAHyjznVIKJ6Nepwgu4CpEn8SuQ,21779
-tango_python-1.8.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-tango_python-1.8.0.dist-info/entry_points.txt,sha256=kGLUbglUjuaAqEFvOZ1QuSW0vWb6VeSpCIFKaOFkKoQ,50
-tango_python-1.8.0.dist-info/licenses/LICENSE,sha256=j2kYVHMwTkoGn3ZNScnrdIueG0k2XzB_LCPFoyBc2wk,1064
-tango_python-1.8.0.dist-info/RECORD,,
+tango_python-1.10.0.dist-info/METADATA,sha256=GhxRXx0J567G_IXyAKx2JcDMXoyFFUbqezsYjNjvFig,22118
+tango_python-1.10.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+tango_python-1.10.0.dist-info/entry_points.txt,sha256=kGLUbglUjuaAqEFvOZ1QuSW0vWb6VeSpCIFKaOFkKoQ,50
+tango_python-1.10.0.dist-info/licenses/LICENSE,sha256=j2kYVHMwTkoGn3ZNScnrdIueG0k2XzB_LCPFoyBc2wk,1064
+tango_python-1.10.0.dist-info/RECORD,,