Skip to content

Conversation

@lagru
Copy link
Member

@lagru lagru commented Aug 22, 2025

This refactor makes use of Python's native logging which should hopefully be a more robust foundation for future improvements such as parallelization.

Release note

For maintainers and optionally contributors, please refer to changelist's README on how to document this PR for the release notes.

Improve output and error reporting. All output of docstub is now controllable
with the existing `--verbose` option and the new `--quiet` option. Also indicate
the (severity) level of output with a single char, e.g. "I" for information or
"W" for warnings.
{label="enhancement"}
Refactor reporting to use Python's native logging implementation.
{label="maintenance"}

@lagru lagru added this to the v0.5 milestone Aug 22, 2025
@lagru lagru added enhancement New feature or functionality maintenance Keeps the lights on labels Aug 22, 2025
lagru added 5 commits August 22, 2025 09:22
Forgot to remove them again.
And add more (previously missing) annotations and docstrings.
This makes the extra clause to catch `SystemError` and
`KeyboardInterrupt` unnecessary as these are *not* caught by
`Exception` [1].

[1] https://docs.python.org/3/library/exceptions.html#exception-hierarchy
@lagru lagru changed the title Draft logging-based error reporting Add logging-based error reporting Aug 30, 2025
@lagru lagru merged commit 5dead3e into main Oct 1, 2025
17 of 21 checks passed
@lagru lagru deleted the print-errors-with-logging branch October 1, 2025 14:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or functionality maintenance Keeps the lights on

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants