Logging Settings
wiki-tui writes everything it does (logs) into a so-called logfile. These logs are useful for debugging (so we as the developers can understand what wiki-tui was trying to do before it failed) and deliver some interesting insight into how wiki-tui works.
Enable / Disable logging entirely
0.3.0 ·
Default: true
With this option, you can disable logging entirely if you don't want it.
logging.enabled = true
About Logging
Logging helps us understand what wiki-tui was doing when it failed or more importantly why it failed. When wiki-tui crashes it puts the logs into the crash report and gives us more detailed crash information.
Why you should keep logging enabled
When a crash occurs or you encounter a bug, without the log file we cannot do very much if we cannot reproduce it. But even if we can reproduce your bug or crash, we can usually fix it much faster with the logs.
You don't need to have your log_level set to INFO (altough, we would appreciate it :)). Even if you only have the log_level set to WARN, it helps us so much more than no logs at all. So please, for you it is only a single file that gets overwritten when you start wiki-tui again. But for us, it means so much more.
Changing the Logging Path
0.3.0 ·
Default: wiki_tui.log
You can change the path the logfile gets written to. It is relative to the current working directory. With this you can, for example, rename the file
logging.log_dir = "wiki_tui.log"
Adjusting the Log Level
0.3.0 ·
Default: Info
Changing the log level reduces the number of logs that get written to the log file. Higher levels mean only more severe logs get written. Available levels are:
| Level | Description | Note |
|---|---|---|
| Debug | A log level that is used for events considered to be useful during the software debugging when more granular information is needed. | This slows down the application and should only be used for development |
| Info | An event happened, the event is purely informative and can be ignored during normal operations. | The default and also recommended log level |
| Warn | Unexpected behavior happened inside the application, but it is continuing its work and the key features are operating as expected. | |
| Error | Basically: Something has really gone wrong and the program only knows one way to get out of this, crash |
Credit to sematext.com for the descriptions of the log levels
logging.log_level = "Info"