Expose source spans for errors with error-context

[TzviPM]

Please complete the following tasks

• I have searched the discussions
• I have searched the open and rejected issues

Clap Version

master

Describe your use case

I'm building a compiler front-end and I want to use a common diagnostic format for all of the errors, whether in the input source code with linting or parsing or analysis, and I want this to extend also to the cli arguments. For some kinds of clap errors, such as InvalidValue, it would be nice to show the context around the argument based on the command that the user typed. As far as I can tell, clap does not currently support this use case.

I could write my own parser for the command line, but it would be nice to reuse the work that clap has done, even with my own error display logic.

Describe the solution you'd like

Clap already has a crate feature called error-context that supports most of what I need. I propose adding a new context kind that supplies some sort of source span for errors where that is relevant.

Alternatives, if applicable

No response

Additional Context

I have used clap for many years and love the work you've done. I would be happy to contribute by writing a PR for this feature of the maintainers would be willing to accept it.

[epage]

I know at least #2836 made this more difficult before. With that gone, it is a bit easier.

If we can generally point to an argument, that makes things a bit easier. If we need to point to a substring in the argument (which short flag, the part after a =, etc), that increases the complexity.

A downside this that this pushes extra bookkeeping on everyone, performance and code-size wise with the more complex it is the more it affects things. We have talked about making the parser pluggable (#2468) which could open the door for this being more opt-in