Entities: federal_obligations as expansion; edge-case test fixes; CHANGELOG

- ENTITIES_COMPREHENSIVE uses federal_obligations(*) expansion (API change)
- SHAPES.md: document federal_obligations(*) as expansion
- test_parsing_nested_objects_with_missing_data: accept office_code/agency_code and empty nested objects
- CHANGELOG: unreleased changes
- Cassette updates (incl. comprehensive entities shape)

Made-with: Cursor

Author: vdavez

CHANGELOG.md

@@ -15,6 +15,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 - Lint CI workflow disabled for push/PR (runs only on manual trigger) until the private `makegov/tango` repo is accessible to the workflow.
 - Updated documents to reflect changes since v0.4.0
+- Entities: `ENTITIES_COMPREHENSIVE` now uses `federal_obligations(*)` expansion; the API treats federal obligations as an expansion rather than a plain shape field.
+- Docs: `SHAPES.md` documents `federal_obligations(*)` as an expansion for entity shaping.
+- Integration tests: `test_parsing_nested_objects_with_missing_data` accepts award office fields (`office_code`, `agency_code`, `department_code`) and empty nested objects when the API returns partial data.
 
 ## [0.4.1] - 2026-03-03
 

docs/SHAPES.md

@@ -371,7 +371,7 @@ contracts = client.list_contracts(shape=DASHBOARD_SHAPE, limit=50)
 - `mailing_address(...)` - Mailing address
 
 **Financial:**
-- `federal_obligations` - Total federal obligations
+- `federal_obligations(*)` - Expansion for total/active federal obligations
 
 ## Performance Comparison
 

tango/models.py

@@ -602,7 +602,7 @@ class ShapeConfig:
         "business_types,primary_naics,naics_codes,psc_codes,"
         "email_address,entity_url,description,capabilities,keywords,"
         "physical_address,mailing_address,"
-        "federal_obligations,congressional_district"
+        "federal_obligations(*),congressional_district"
     )
 
     # Default for list_forecasts()

tests/cassettes/TestAgenciesIntegration.test_get_agency

@@ -16,69 +16,61 @@ interactions:
     uri: https://tango.makegov.com/api/agencies/4700/
   response:
     body:
-      string: '{"code":"4700","name":"General Services Administration","abbreviation":"GSA","department":{"name":"General
-        Services Administration","code":47}}'
+      string: '{"code":"4700","name":"General Services Administration","abbreviation":"GSA","department":{"code":47,"name":"General
+        Services Administration"}}'
     headers:
-      Age:
-      - '962'
       CF-RAY:
-      - 99f88c10fadea1c5-MSP
-      Cache-Control:
-      - max-age=86400
+      - 9d71a552ba805108-MSP
       Connection:
       - keep-alive
       Content-Type:
       - application/json
       Date:
-      - Sun, 16 Nov 2025 17:00:53 GMT
+      - Wed, 04 Mar 2026 14:42:08 GMT
       Nel:
       - '{"report_to":"cf-nel","success_fraction":0.0,"max_age":604800}'
       Report-To:
-      - '{"group":"cf-nel","max_age":604800,"endpoints":[{"url":"https://a.nel.cloudflare.com/report/v4?s=mO7vhOOg6oeZRYvsMT7JOAtLlc23jY0g%2Fv8r9f581zD7bWlvQObVkPrKUh8r8hmkVrtXtudyMLwe0u%2BLO4dG9PBdOfT1nlVgCodcUAuoyj21xGBKaZRH93jY2g%3D%3D"}]}'
+      - '{"group":"cf-nel","max_age":604800,"endpoints":[{"url":"https://a.nel.cloudflare.com/report/v4?s=ll0O3siCO5da%2BBb4BrJq0tr%2BL%2FWVg2%2BcmVFoij0a7qBl2Nb1%2FD5dkRDUDBFjqoIgBwXn7ob3ra7UkW5XpoGNvYi74p0RSxBcC%2B4X8AyjmaqRapK%2FtEapFRgO"}]}'
       Server:
       - cloudflare
       Transfer-Encoding:
       - chunked
       allow:
       - GET, HEAD, OPTIONS
-      alt-svc:
-      - h3=":443"; ma=86400
       cf-cache-status:
       - DYNAMIC
       content-length:
       - '143'
       cross-origin-opener-policy:
       - same-origin
-      expires:
-      - Mon, 17 Nov 2025 16:44:51 GMT
       referrer-policy:
       - same-origin
       vary:
       - Accept, Cookie
       x-content-type-options:
       - nosniff
       x-execution-time:
-      - 0.009s
+      - 0.022s
       x-frame-options:
       - DENY
       x-ratelimit-burst-limit:
-      - '10'
+      - '1000'
       x-ratelimit-burst-remaining:
-      - '10'
+      - '966'
       x-ratelimit-burst-reset:
-      - '0'
+      - '6'
       x-ratelimit-daily-limit:
-      - '100'
+      - '2000000'
       x-ratelimit-daily-remaining:
-      - '86'
+      - '1999778'
       x-ratelimit-daily-reset:
-      - '73237'
+      - '85060'
       x-ratelimit-limit:
-      - '10'
+      - '1000'
       x-ratelimit-remaining:
-      - '10'
+      - '966'
       x-ratelimit-reset:
-      - '0'
+      - '6'
     status:
       code: 200
       message: OK

tests/cassettes/TestAgenciesIntegration.test_list_agencies

@@ -16,82 +16,73 @@ interactions:
     uri: https://tango.makegov.com/api/agencies/?page=1&limit=10
   response:
     body:
-      string: '{"count":1496,"next":"http://tango.makegov.com/api/agencies/?limit=10&page=2","previous":null,"results":[{"code":"21EB","name":"1st
-        Personnel Command","abbreviation":"","department":{"name":"Department of Defense","code":97}},{"code":"21E2","name":"21st
-        Theater Army Area Command","abbreviation":"","department":{"name":"Department
-        of Defense","code":97}},{"code":"21EO","name":"59th Ordnance Brigade","abbreviation":"","department":{"name":"Department
-        of Defense","code":97}},{"code":"21EN","name":"7th Army Training Command","abbreviation":"","department":{"name":"Department
-        of Defense","code":97}},{"code":"21P8","name":"8th U.S. Army","abbreviation":"","department":{"name":"Department
-        of Defense","code":97}},{"code":"0938","name":"Abraham Lincoln Bicentennial
-        Commission","abbreviation":"ALBC","department":{"name":"Abraham Lincoln Bicentennial
-        Commission","code":289}},{"code":"9147","name":"Academic Improvement and Teacher
-        Quality Programs","abbreviation":"AITQ","department":{"name":"Department of
-        Education","code":91}},{"code":"9532","name":"Access Board","abbreviation":"USAB","department":{"name":"Access
-        Board","code":310}},{"code":"21AE","name":"Acquisition Executive Support Command
-        Agency","abbreviation":"","department":{"name":"Department of Defense","code":97}},{"code":"3621","name":"Actuarial
-        Analysis and Data Development Service","abbreviation":"","department":{"name":"Department
-        of Veterans Affairs","code":36}}]}'
+      string: '{"count":1496,"next":"https://tango.makegov.com/api/agencies/?limit=10&page=2","previous":null,"results":[{"code":"21EB","name":"1st
+        Personnel Command","abbreviation":"","department":{"code":97,"name":"Department
+        of Defense"}},{"code":"21E2","name":"21st Theater Army Area Command","abbreviation":"","department":{"code":97,"name":"Department
+        of Defense"}},{"code":"21EO","name":"59th Ordnance Brigade","abbreviation":"","department":{"code":97,"name":"Department
+        of Defense"}},{"code":"21EN","name":"7th Army Training Command","abbreviation":"","department":{"code":97,"name":"Department
+        of Defense"}},{"code":"21P8","name":"8th U.S. Army","abbreviation":"","department":{"code":97,"name":"Department
+        of Defense"}},{"code":"0938","name":"Abraham Lincoln Bicentennial Commission","abbreviation":"ALBC","department":{"code":289,"name":"Abraham
+        Lincoln Bicentennial Commission"}},{"code":"9147","name":"Academic Improvement
+        and Teacher Quality Programs","abbreviation":"AITQ","department":{"code":91,"name":"Department
+        of Education"}},{"code":"9532","name":"Access Board","abbreviation":"USAB","department":{"code":310,"name":"Access
+        Board"}},{"code":"21AE","name":"Acquisition Executive Support Command Agency","abbreviation":"","department":{"code":97,"name":"Department
+        of Defense"}},{"code":"3621","name":"Actuarial Analysis and Data Development
+        Service","abbreviation":"","department":{"code":36,"name":"Department of Veterans
+        Affairs"}}]}'
     headers:
-      Age:
-      - '962'
       CF-RAY:
-      - 99f88c0fd8a4a22a-MSP
-      Cache-Control:
-      - max-age=86400
+      - 9d71a5518ca3a225-MSP
       Connection:
       - keep-alive
       Content-Type:
       - application/json
       Date:
-      - Sun, 16 Nov 2025 17:00:53 GMT
+      - Wed, 04 Mar 2026 14:42:08 GMT
       Nel:
       - '{"report_to":"cf-nel","success_fraction":0.0,"max_age":604800}'
       Report-To:
-      - '{"group":"cf-nel","max_age":604800,"endpoints":[{"url":"https://a.nel.cloudflare.com/report/v4?s=29%2FzmYVGPWUoxUAiX9%2BwP7Lab2WSYHUIyl8XgOF%2BdxdxldrCYATc9I9k9yko%2Bm5MDHkpoS6OMYDeGkezCurBAMCGQl8XjM4HXyC%2Fv6WYtQc5pSXM%2FFqLxRLGBQ%3D%3D"}]}'
+      - '{"group":"cf-nel","max_age":604800,"endpoints":[{"url":"https://a.nel.cloudflare.com/report/v4?s=dnKLRpygVGBZTkoknxVFAZbvTEAI%2B%2FYRjjRIc1UARxTZ8epk1G4iwniTL58ilXKuA3y7zqmFgVn%2FdCVxia6ZPFRD7u5HBifLxQ1M1sKPDmsmA3mSQrxejWNR"}]}'
       Server:
       - cloudflare
       Transfer-Encoding:
       - chunked
       allow:
       - GET, HEAD, OPTIONS
-      alt-svc:
-      - h3=":443"; ma=86400
       cf-cache-status:
       - DYNAMIC
       content-length:
-      - '1441'
+      - '1442'
       cross-origin-opener-policy:
       - same-origin
-      expires:
-      - Mon, 17 Nov 2025 16:44:51 GMT
       referrer-policy:
       - same-origin
       vary:
       - Accept, Cookie
       x-content-type-options:
       - nosniff
       x-execution-time:
-      - 0.009s
+      - 0.015s
       x-frame-options:
       - DENY
       x-ratelimit-burst-limit:
-      - '10'
+      - '1000'
       x-ratelimit-burst-remaining:
-      - '10'
+      - '967'
       x-ratelimit-burst-reset:
-      - '0'
+      - '6'
       x-ratelimit-daily-limit:
-      - '100'
+      - '2000000'
       x-ratelimit-daily-remaining:
-      - '86'
+      - '1999779'
       x-ratelimit-daily-reset:
-      - '73237'
+      - '85060'
       x-ratelimit-limit:
-      - '10'
+      - '1000'
       x-ratelimit-remaining:
-      - '10'
+      - '967'
       x-ratelimit-reset:
-      - '0'
+      - '6'
     status:
       code: 200
       message: OK