[FEA]: `if_not_found` flag for all pathfinder APIs?
@rwgk is already working on this.
Since Apr 24, 2026.
- Dominant language
- Cython
- Stars
- 3.4k
- Forks
- 329
- Avg merge
- 1d 23h
- Merged PRs (30d)
- 116
Description
Is this a duplicate?
- I confirmed there appear to be no duplicate issues for this request and that I agree to the Code of Conduct
Area
cuda.pathfinder
Is your feature request related to a problem? Please describe.
If a library / binary / header is not found, the default behavior for pathfinder is to return None. This leaves the exception handling to users. User would either: 1) search on their own, 2) further raise the issue. Writing the custom error message for the library isn't particularly easy (basically directing user to install the right package) so it would be nice to also handle that inside the pathfinder library.
Basically, I suggest a if_not_found={"raise", "return_none"} flag, that either raises or returns None when a library isn't found. When raise is set and a library isn't found, a PathfinderNotFound exception is raised, with specific error message directing user to install the missing package.
Describe the solution you'd like
Mentioned above.
Describe alternatives you've considered
No response
Additional context
No response
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.