Customise reporting

[StefanBRas]

Hey!

I'm trying out diff_cover in Github Actions. Github Actions supports annotations where If I in a job run print out something like

::warning file=my_file,line=2,title=Missing Coverage::Line XXX is missing coverage

I will get these in the job logs:

And in the Pull request view it will show this:

Which is very neat.

However right now, I need to use diif_cover to create a json and the parse that to print out the annotations. I think it would make sense to have it as an option in diff_cover, but to me it looks like there's no way to inject custom reporting.

I think this could be done either using a hook system like with violations or by letting users specify "--format" or something.

I can contribute the PR, just wanted to hear what way you think it should be implemented

[wyardley]

Similar issue here. In the case of sqlfluff, it already has a native github annotations output format, but in the case where I'm using diff-quality --compare-branch origin/main --violations sqlfluff, I can't get the annotations for findings only.

I've seen multiple tools (sqlfluff, pylint, etc.), either directly or with plugins have a --format github or --format github-native or similar.

In this case, the format would look something like

::warning title=SQLFluff,file=path/to/file.sql,line=189,col=1,endLine=189,endColumn=9::LT02: Expected indent of 12 spaces. [layout.indent]

vs something like

path/to/file.sql:14: Unnecessary trailing whitespace.

[Bachmann1234]

I'm open to the idea. I'll take a look at a pr if one comes in. Sorry this issue must had gotten lost in the shuffle.

[timkrins]

I also have this requirement, and have created #432 as an example of the report generator for this use case.

A hook / plugin system would be cool - the logic does not feel very extendable right now.