docs(sdk): add grants.gov custom-filters search examples (Py + TS)#1003
Open
SnowboardTechie wants to merge 6 commits into
Open
docs(sdk): add grants.gov custom-filters search examples (Py + TS)#1003SnowboardTechie wants to merge 6 commits into
SnowboardTechie wants to merge 6 commits into
Conversation
Add examples/grants_gov_custom_filters.py demonstrating a Simpler.Grants.gov opportunity search with the cg-grants-gov plugin's custom filters (agency, applicantType, fundingInstrument, costSharing) via get_client + search(filters=).
…example classify_filters now returns the OppFilters request body directly (ClassifyResult retired) and raises FilterError on a bad value. Drop the .result unwrap and the collected-errors check.
Add examples/grants-gov-custom-filters.ts + example:grants-gov-custom-filters script, mirroring the Python grants_gov_custom_filters.py: import the cg-grants-gov plugin, show the classified customFilters request body, then getClient + search. Same 4 SGG filters as the Python side (contract parity).
github-actions
Bot
added
dependencies
The TS example passed the text query as 'search', but SearchOptions names it 'query' (the client maps it to the wire body's 'search' field). tsx does not typecheck, so the example ran with the term silently dropped; tsc catches it as TS2353. Also apply black to the Python example. The remaining red on the Python type check is release-ordering: the installed cg-grants-gov predates the filters release, so get_client still types filters as the core OpportunityFilters. It clears when the plugin publishes and the pin bumps.
The client's search(filters=...) is typed by the plugin's registered route TypedDict, so the flat dict literal needs the OppSearchFilters annotation to typecheck. Annotation-only; no runtime change.
This was
linked to
issues
Jul 13, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Changes proposed
lib/python-sdk/examples/grants_gov_custom_filters.py— imports thegrants.govplugin, classifies a filter set through its registered routes into the three-bucket wire body, and runs a search via the SDK client.lib/ts-sdk/examples/grants-gov-custom-filters.ts— the TypeScript counterpart, plus anexample:grants-gov-custom-filterspnpm script.Context for reviewers
Mirrors the existing
grants_gov_transforms.py/grants-gov-transforms.tsexamples (#900) one-for-one — same structure, same "consume the real plugin" shape. The Python example uses the SDK's fail-fastclassify_filters(returns the classified body directly, raisesFilterErroron a bad value).Targets
HOLD-filtersbecause the examples need the SDK's filters API, which rides #918 to main.Verified locally against the
HOLD-filtersSDK build and the plugin's registered filter routes (#901 / #903).Release ordering: the examples import the published plugin, so the
cg-grants-gov/@common-grants/cg-grants-govpins bump to the plugin's filters release at merge time. CI stays red until the plugin publishes; verified locally in the meantime.Additional information
Filter set exercised:
agency,applicantType,fundingInstrument,costSharing— matching the plugin registration and the Simpler.Grants.gov deployment's honored customFilters.