[FEA]: `if_not_found` flag for all pathfinder APIs?

[isVoid]

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

[rwgk]

Writing the custom error message for the library isn't particularly easy (basically directing user to install the right package)

Yes, that's why I didn't want to get into it when I was first adding the header directory search. Currently we're not keeping track of where we're searching. It's indeed a non-trivial project to produce meaningful exceptions. I'll revisit this after I'm done with the compatibility check work (similar to #1038).