tango-python 1.7.0__tar.gz → 1.9.0__tar.gz

{tango_python-1.7.0 → tango_python-1.9.0}/CHANGELOG.md

@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.9.0] - 2026-09-28
+
+### Added
+- **GSA eBuy requests** (Tango API 5.1.0). Four methods over the `/api/ebuy/` resource: `list_ebuy_requests()`, `get_ebuy_request()`, `get_ebuy_attachment_url()` and `get_ebuy_access()`, plus `EbuyRequest` / `EbuyAttachment` schemas, an `EbuyAccess` result type, and the `EBUY_REQUESTS_MINIMAL` / `EBUY_REQUESTS_COMPREHENSIVE` defaults. These are the RFQs, RFPs and RFIs posted to GSA eBuy. All fourteen of the API's filters are explicit named parameters, including `search` (which also matches attachment text), `reference_number`, `sin`, `agency` and `contract_number`.
+
+  Access is scoped to your account: you see only requests posted under the GSA schedule contracts linked to it, and the endpoints require the Pro tier or above. With no linked contract, `list_ebuy_requests()` returns an empty page rather than an error, so `get_ebuy_access()` reports whether access is enabled, why not (`tier_required` or `no_contract_grant`), and which contracts are linked. `status` is frozen at the last state a request was seen in, because a request that closes stops appearing rather than getting a final row; read `last_seen` for staleness. `get_ebuy_attachment_url()` returns the short-lived signed URL the API redirects to without downloading the document, and raises the new `TangoAttachmentLinkError` (a `TangoValidationError`) with the link on `.url` when the entry is an external link rather than a stored document. The `agency` filter requires Tango API 5.3.0.
+- **`alerts.ebuy_request.match` is an alertable event type.** `create_webhook_alert(query_type="ebuy_request", ...)` works.
+
+## [1.8.0] - 2026-09-28
+
+### Added
+- **Federal Register documents** (Tango API 5.3.0). Two methods over the new `/api/federal_register/` resource: `list_federal_register_documents()` and `get_federal_register_document()`, plus a `FederalRegisterDocument` schema and the `FEDERAL_REGISTER_MINIMAL` / `FEDERAL_REGISTER_COMPREHENSIVE` defaults. These are the rules, proposed rules, notices and presidential documents published in the Federal Register since 1994. All seventeen of the API's filters are explicit named parameters, including `comments_open`, `cfr_title` / `cfr_part`, `rin`, and both `agency` (a Tango organization, including its sub-agencies) and `fr_agency` (the Federal Register's own agency slug).
+
+  `get_federal_register_document()` takes the document's `uuid`, not its `document_number`, because a document number is not unique on its own: the Federal Register reused some before 2016. Look a document up by number with `list_federal_register_documents(document_number=...)`. `full_text` is available on the detail method only when named in `shape`, and neither default shape includes it, since it can run to several MB. `ordering="rank"` requires a non-empty `search`, matching the API.
+- **`alerts.federal_register.match` is an alertable event type.** `create_webhook_alert(query_type="federal_register", ...)` works.
+- **`agency` filter on `list_budget_accounts()`, `list_exclusions()` and `list_itdashboard_investments()`** (Tango API 5.3.0). It takes a Tango agency name, abbreviation, code or organization key (e.g. `EPA`) and matches the whole organization subtree, so a department includes its sub-agencies; OR several with `|`. On exclusions it scopes by the excluding agency. On IT Dashboard it is available at every plan.
+- **The `organization` expand is accepted on budget accounts, exclusions, SBIR topics and SBIR solicitations**, along with the `organization_id` field on budget accounts and exclusions. `organization(...)` carries `agency_code`, `agency_name`, `department_code`, `department_name`, `office_code`, `office_name` and `organization_id`. The SDK rejected these shapes client-side before. The default shapes are unchanged.
+
+### Fixed
+- **`list_itdashboard_investments()` documents the API's current filter tiers.** `agency_name` is available at every plan, not Business+ only.
+
 ## [1.7.0] - 2026-09-23
 
 ### Added

{tango_python-1.7.0 → tango_python-1.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: tango-python
-Version: 1.7.0
+Version: 1.9.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.7.0 → tango_python-1.9.0}/README.md

@@ -254,6 +254,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.7.0 → tango_python-1.9.0}/docs/API_REFERENCE.md

@@ -23,6 +23,8 @@ Complete reference for all Tango Python SDK methods and functionality.
 - [GSA eLibrary Contracts](#gsa-elibrary-contracts)
 - [Protests](#protests)
 - [Contract Appeals](#contract-appeals)
+- [Federal Register](#federal-register)
+- [GSA eBuy](#gsa-ebuy)
 - [Budget](#budget)
 - [Business Types](#business-types)
 - [NAICS](#naics)
@@ -1315,6 +1317,93 @@ appeal = client.get_contract_appeal(
 
 ---
 
+## Federal Register
+
+Federal Register documents — rules, proposed rules, notices and presidential documents published since 1994.
+
+A document is identified by `uuid`. `document_number` is not unique on its own: the Federal Register reused some numbers before 2016, so `document_number=` can return more than one document.
+
+### list_federal_register_documents()
+
+List documents with filtering and shaping.
+
+```python
+documents = client.list_federal_register_documents(
+    page=1,
+    limit=25,
+    shape=ShapeConfig.FEDERAL_REGISTER_MINIMAL,
+    # Filter parameters (all optional)
+    search=None,
+    document_number=None,
+    type=None,
+    agency=None,
+    fr_agency=None,
+    publication_date_after=None,
+    publication_date_before=None,
+    effective_on_after=None,
+    effective_on_before=None,
+    comments_close_on_after=None,
+    comments_close_on_before=None,
+    comments_open=None,
+    cfr_title=None,
+    cfr_part=None,
+    significant=None,
+    rin=None,
+    executive_order_number=None,
+    ordering=None,
+)
+```
+
+**Filter Parameters:**
+- `search` - Ranked full-text search over the title, abstract and action; wrap in double quotes for a phrase
+- `document_number` - Exact FR document number, e.g. `"2016-31922"`; OR several with `|`
+- `type` - `"Notice"`, `"Rule"`, `"Proposed Rule"`, `"Presidential Document"`, `"Correction"`, `"Sunshine Act Document"` or `"Uncategorized Document"` (case-insensitive); OR several with `|`. An unknown type is an error, not an empty page. Documents published before 2008 are mostly `Uncategorized Document`, so a type filter undercounts that era
+- `agency` - A Tango agency name, abbreviation, code or organization key, e.g. `"EPA"`. Matches a document when any agency it lists falls within that organization, so a department includes its sub-agencies; OR several with `|`
+- `fr_agency` - The Federal Register's own agency slug, e.g. `"environmental-protection-agency"`; OR several with `|`
+- `publication_date_after` / `publication_date_before` - Publication date range (`YYYY-MM-DD`)
+- `effective_on_after` / `effective_on_before` - Effective date range (`YYYY-MM-DD`)
+- `comments_close_on_after` / `comments_close_on_before` - Comment-deadline range (`YYYY-MM-DD`)
+- `comments_open` - `True` for documents whose comment period closes today or later, `False` for those already closed; documents with no comment deadline match neither
+- `cfr_title` - A CFR title number, e.g. `"40"`
+- `cfr_part` - A CFR part number, e.g. `"52"`. Requires `cfr_title`, and both must match the same CFR reference, so `cfr_title="40", cfr_part="52"` finds 40 CFR 52
+- `significant` - Significant under Executive Order 12866
+- `rin` - A Regulation Identifier Number, e.g. `"2060-AV16"`; OR several with `|`
+- `executive_order_number` - Exact executive order number
+- `ordering` - `publication_date` (the default, as `-publication_date`), `effective_on`, `comments_close_on`, `document_number` or `rank`. `rank` requires a non-empty `search`
+
+**Returns:** [PaginatedResponse](#paginatedresponse) with document dictionaries
+
+**Example:**
+```python
+documents = client.list_federal_register_documents(
+    type="Proposed Rule",
+    comments_open=True,
+    agency="EPA",
+    limit=25,
+)
+
+for doc in documents.results:
+    print(f"{doc['document_number']} ({doc['publication_date']}): {doc['title']}")
+    print(f"  comments close {doc['comments_close_on']}")
+```
+
+### get_federal_register_document()
+
+Get a single document by `uuid`. To look one up by its document number, use `list_federal_register_documents(document_number=...)`.
+
+```python
+document = client.get_federal_register_document(
+    "DOCUMENT_UUID",
+    shape=ShapeConfig.FEDERAL_REGISTER_COMPREHENSIVE,
+)
+```
+
+**Notes:**
+- `agencies`, `cfr_references`, `dockets` and `topics` are the Federal Register's own structures, served as published. `agencies` carries Federal Register agency slugs, not Tango organization keys.
+- `full_text`, the document's plain text, is available on this method only and only when named in `shape` (e.g. `shape="uuid,title,full_text"`). It can run to several MB, so neither default shape includes it.
+
+---
+
 ## State & Local (SLED)
 
 State, local and education procurement — solicitations that never appear on SAM.gov because they were never federal. **Beta**: coverage is partial and grows one jurisdiction at a time.
@@ -1514,6 +1603,118 @@ forecast = client.get_sled_forecast("FORECAST_UUID")
 
 ---
 
+## GSA eBuy
+
+GSA eBuy requests for quotes, proposals and information (RFQs, RFPs, RFIs), keyed by `rfq_id`.
+
+**Access is scoped to your account.** You see only requests posted under the GSA schedule contracts linked to your account, and the endpoints require the Pro tier or above (below it they return 403). With no linked contract, `list_ebuy_requests()` returns an empty page rather than an error, and `get_ebuy_request()` raises `TangoNotFoundError` for a request outside your scope, the same as for an id that does not exist. Use `get_ebuy_access()` to tell "no access" from "no matches".
+
+### list_ebuy_requests()
+
+List requests with filtering and shaping.
+
+```python
+requests = client.list_ebuy_requests(
+    page=1,
+    limit=25,
+    shape=ShapeConfig.EBUY_REQUESTS_MINIMAL,
+    # Filter parameters (all optional)
+    search=None,
+    rfq_id=None,
+    reference_number=None,
+    request_type=None,
+    status=None,
+    sin=None,
+    schedule=None,
+    buyer_agency=None,
+    agency=None,
+    contract_number=None,
+    issue_date_after=None,
+    issue_date_before=None,
+    close_date_after=None,
+    close_date_before=None,
+    ordering=None,
+)
+```
+
+**Filter Parameters:**
+- `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"`
+- `reference_number` - The buyer's own solicitation number; dashes are ignored
+- `request_type` - `"RFQ"`, `"RFP"` or `"RFI"`
+- `status` - `"Open"` or `"Cancelled"`, as last seen (see the note below)
+- `sin` - Special Item Number, e.g. `"54151S"`
+- `schedule` - GSA schedule
+- `buyer_agency` - The buyer agency as eBuy names it (free text)
+- `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. 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` / `issue_date_before` - Issue date range (`YYYY-MM-DD`, inclusive)
+- `close_date_after` / `close_date_before` - Close date range (`YYYY-MM-DD`, inclusive)
+- `ordering` - `issue_date` (the default, as `-issue_date`), `close_date`, `last_seen` or `modified`; prefix `-` for descending
+
+String filters accept several values joined with `|` (OR).
+
+**Returns:** [PaginatedResponse](#paginatedresponse) with request dictionaries
+
+**Example:**
+```python
+requests = client.list_ebuy_requests(status="Open", sin="54151S", ordering="close_date")
+
+for req in requests.results:
+    print(f"{req['rfq_id']} closes {req['close_date']}: {req['title']}")
+    print(f"  last seen {req['last_seen']}")
+```
+
+**Notes:**
+- **`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. `Open` means "open the last time it was seen", not "open now"; read `last_seen` for staleness.
+- The contract number a request was posted under is never returned in any payload.
+- `buyer_agency_code` and some other buyer and contact fields are sparse on older requests.
+
+### get_ebuy_request()
+
+Get a single request by `rfq_id`.
+
+```python
+request = client.get_ebuy_request(
+    "RFQ1835158",
+    shape=ShapeConfig.EBUY_REQUESTS_COMPREHENSIVE,
+)
+
+for attachment in request["attachments"]:
+    print(attachment["doc_seq_num"], attachment["doc_name"], attachment["is_link"])
+```
+
+The default shape returns every field plus two expands: `organization` (the buyer office, with the same seven keys as other resources' `organization` expand) and `attachments`. Each attachment carries `doc_seq_num`, `doc_name`, `doc_type`, `doc_path`, `is_link` and `doc_session_date`. `is_link=True` means `doc_path` is an outbound URL with no stored document behind it. `amendments`, `line_items` and `addresses` are lists of objects, served as eBuy publishes them.
+
+### get_ebuy_attachment_url()
+
+Get a short-lived download URL for one stored attachment.
+
+```python
+url = client.get_ebuy_attachment_url("RFQ1835158", doc_seq_num=1)
+```
+
+**Returns:** The signed URL the API redirects to, as a string. The SDK reads the redirect without following it, so no document is downloaded. The URL expires after about five minutes: fetch it promptly, and call this again rather than storing it.
+
+**Raises:**
+- `TangoAttachmentLinkError` (a `TangoValidationError`) - The entry is an external link (`is_link`), not a stored document. The link is on `error.url`
+- `TangoNotFoundError` - The request is unknown or outside your scope, the attachment does not exist, or its document has not been captured yet
+
+### get_ebuy_access()
+
+Check whether your account can read eBuy requests.
+
+```python
+access = client.get_ebuy_access()
+if not access.enabled:
+    print(access.reason)  # "tier_required" or "no_contract_grant"
+print(access.contracts)   # your own linked contracts, sorted
+```
+
+**Returns:** `EbuyAccess` with `enabled` (bool), `reason` (`"tier_required"`, `"no_contract_grant"` or `None`; `tier_required` wins when both apply) and `contracts` (list of str).
+
+---
+
 ## Budget
 
 Federal account × fiscal year budget rollups, covering the full budget lifecycle (requested → enacted → apportioned → obligated → outlayed), pre-computed ratios and trends, the contract / assistance / unlinked breakdown, and request-vs-actual spend.
@@ -2311,6 +2512,10 @@ entity = client.get_entity("UEI_KEY", shape=ShapeConfig.ENTITIES_COMPREHENSIVE)
 | `PROTESTS_MINIMAL` | `list_protests` | case_id, case_number, title, source_system, outcome, filed_date |
 | `CONTRACT_APPEALS_MINIMAL` | `list_contract_appeals` | uuid, board, docket_numbers, decision_date, appellant, judge, decision_type, url |
 | `CONTRACT_APPEALS_COMPREHENSIVE` | `get_contract_appeal` | The list fields plus docket_raw, docket_source, decision_date_repaired, decision_type_raw, listing_year, first_listed_at, listed, text_status, text_char_count (omits `decision_text`, which needs an Enterprise plan) |
+| `FEDERAL_REGISTER_MINIMAL` | `list_federal_register_documents` | uuid, document_number, publication_date, type, subtype, title, abstract, action, agencies, cfr_references, citation, significant, comments_close_on, effective_on, html_url, pdf_url |
+| `FEDERAL_REGISTER_COMPREHENSIVE` | `get_federal_register_document` | The list fields plus dates, signing_date, start_page, end_page, volume, docket_ids, dockets, regulation_id_numbers, topics, correction_of, corrections, executive_order_number, presidential_document_number, proclamation_number, comment_url, regulations_dot_gov_url, raw_text_url, body_html_url (omits `full_text`) |
+| `EBUY_REQUESTS_MINIMAL` | `list_ebuy_requests` | rfq_id, request_type, title, schedule, sin, status, buyer_name, buyer_agency, buyer_agency_code, reference_number, issue_date, close_date, attachment_count, link_count, last_seen |
+| `EBUY_REQUESTS_COMPREHENSIVE` | `get_ebuy_request` | Every field, plus the `organization` and `attachments` expands |
 | `BUDGET_ACCOUNTS_MINIMAL` | `list_budget_accounts`, `get_budget_account` | id, federal_account_symbol, fiscal_year, agency_code/name, bureau_name, account_title, bea_category, on_off_budget, subfunction_code, lifecycle (requested/enacted/apportioned/obligated/outlayed/unobligated), contract & assistance rollups, key ratios, next-year growth |
 | `VEHICLE_ORDERS_MINIMAL` | `list_vehicle_orders` | key, piid, award_date, recipient(display_name,uei), total_contract_value, obligated |
 | `ITDASHBOARD_INVESTMENTS_MINIMAL` | `list_itdashboard_investments` | Minimal IT Dashboard investment fields |

{tango_python-1.7.0 → tango_python-1.9.0}/docs/WEBHOOKS.md

@@ -89,6 +89,8 @@ tango webhooks list-event-types
 # alerts.dibbs_rfp.match     DLA DIBBS RFP matched a saved alert
 # alerts.sled_opportunity.match  State/local/education solicitation matched a saved alert
 # alerts.contract_appeal.match  CBCA/ASBCA appeal decision matched a saved alert
+# alerts.federal_register.match  Federal Register document matched a saved alert
+# alerts.ebuy_request.match  GSA eBuy request matched a saved alert
 ```
 
 This list is served by the API, so it is always current — the SDK does not hardcode

{tango_python-1.7.0 → tango_python-1.9.0}/pyproject.toml

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

{tango_python-1.7.0 → tango_python-1.9.0}/scripts/check_filter_shape_conformance.py

@@ -78,6 +78,8 @@ RESOURCE_TO_METHOD: dict[str, str | None] = {
     "sled/forecasts": "list_sled_forecasts",
     "protests": "list_protests",
     "contract_appeals": "list_contract_appeals",
+    "federal_register": "list_federal_register_documents",
+    "ebuy/requests": "list_ebuy_requests",
     "offices": "list_offices",
     "psc": "list_psc",
     "mas_sins": "list_mas_sins",

{tango_python-1.7.0 → tango_python-1.9.0}/scripts/check_shape_coverage.py

@@ -69,6 +69,8 @@ RESOURCE_TO_MODEL: dict[str, str] = {
     "budget_accounts": "BudgetAccount",
     "protests": "Protest",
     "contract_appeals": "ContractAppeal",
+    "federal_register": "FederalRegisterDocument",
+    "ebuy/requests": "EbuyRequest",
     "offices": "Office",
     "assistance_listings": "AssistanceListing",
     "business_types": "BusinessType",

{tango_python-1.7.0 → tango_python-1.9.0}/tango/__init__.py

@@ -3,6 +3,7 @@
 from .client import TangoClient
 from .exceptions import (
     TangoAPIError,
+    TangoAttachmentLinkError,
     TangoAuthError,
     TangoNotFoundError,
     TangoRateLimitError,
@@ -14,7 +15,11 @@ from .models import (
     DibbsAward,
     DibbsRfp,
     DibbsRfq,
+    EbuyAccess,
+    EbuyAttachment,
+    EbuyRequest,
     Exclusion,
+    FederalRegisterDocument,
     GsaElibraryContract,
     ITDashboardInvestment,
     PaginatedResponse,
@@ -54,19 +59,24 @@ from .webhooks import (
 )
 from .webhooks.receiver import Delivery, WebhookReceiver
 
-__version__ = "1.7.0"
+__version__ = "1.9.0"
 __all__ = [
     "TangoClient",
     "TangoAPIError",
     "TangoAuthError",
     "TangoNotFoundError",
     "TangoValidationError",
+    "TangoAttachmentLinkError",
     "TangoRateLimitError",
     "RateLimitInfo",
     "ResolveCandidate",
     "ResolveResult",
     "BudgetAccount",
     "ContractAppeal",
+    "FederalRegisterDocument",
+    "EbuyAccess",
+    "EbuyAttachment",
+    "EbuyRequest",
     "DibbsAward",
     "DibbsRfp",
     "DibbsRfq",