Allow output to be logged but hide warnings

[geographika]

When the --quiet parameter is used, it seems to hide all output from docstub apart from errors (tried with both q and qq and they appear to have the same output).

E.g. docstub run osgeo --no-cache --config pyproject.toml --quiet

If there are no errors, there is no logged output. Removing --quiet lists over 3,000 warnings that were not logged in v0.4.0 (it seems these were added in #79). It would be good to be able to hide warnings but keep the summary output that was available in version 0.4.0:

1423 matched annotations
0 total errors

Finished in 15.446 s

See OSGeo/gdal#13356 for some more details.

Ideally we'd fix the warnings in the GDAL project, but if I understand correctly it would require adding annotations to every parameter including *args, **kwargs and all global variables.

Testing on the latest 0.6.0 release (currently on Windows).

[lagru]

Yes, I caught a few cases where docstub wrongly didn't warn about missing annotations. But I totally get that that can be annoying. As you already pointed out these warnings can be hidden by adding the --quiet option one or more times, but that also hides the statistics at the end because those are debug level "information (I)".

I'm not sure if you see this as a bug?

I plan to add a --stats option or something like that, that will print statistics regardless of the logging level set by the --quiet option. And I also plan to assign unique IDs to each warning and error category – not unlike a linter. That way people could selectively ignore warnings they don't care about...

[geographika]

@lagru - thanks for the explanation. Feel free to close this issue.
After updating to the new version and hiding the warnings, I just wasn't sure if the tool was running successfully, as the CI logs were empty. I also wasn't sure what the difference between q and qq is.

[lagru]

Okay. I'll keep it open for now as a reminder for myself.

Just to make sure, are you aware of the -g/-group-errors option? That can reduce the size of the log somewhat by grouping identical warnings together.