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
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.

1 participant