Before contributing, make sure to read the profound explanation in order to understand how the tool work and its idea.
If you want to contribute but don’t know what to start with, read the issues page, all the tickets and changes are stored there.
All pull requests, ideas and suggestions are welcome!
Logging and CLI output¶
This project standardizes diagnostics on Loguru and keeps user-facing CLI output as prints:
Default CLI behavior: show user-facing
printoutput plus Loguru warnings/errors on stderr.Verbose mode (
--verbose/-v): show bothprintoutput and all Loguru logs (including debug/trace).
Conventions:
Use
printonly for user-facing CLI messages (results, progress, prompts).Use
loguru.loggerfor diagnostics (debug/info/warn/error, stack traces, internal state).Library code should not configure Loguru; the CLI entrypoint wires log sinks and verbosity.
Documentation¶
Make sure to read documentation when making changes. Update documentation when you make changes.