VersaLog 2.0.0

Versatile logging library.

What is VersaLog.py?

What is VersaLog.py? VersaLog is a powerful and flexible logging library for Python. It supports everything from simple usage to advanced, highly customizable configurations to meet a wide range of needs.

Support

Join our Discord server for support, questions, and community discussions:

Installation

pip install VersaLog

Enum

Enum	Description
detailed	Logs including execution time and log levels
file	Logs with filename and line number
simple	Simple and easy-to-read logs
simple2	Simple and easy-to-read log format. The timestamp is automatically included.

Options

Options	Description
show_file	True : Display filename and line number (for simple and detailed modes)
show_tag	True : Show self.tag if no explicit tag is provided
tag	Default tag to use when show_tag is enabled
enable_all	Shortcut to enable both show_file and show_tag
notice	True : When an error or critical level log is output, a desktop notification (using plyer.notification) will be displayed. The notification includes the log level and message.
all_save	True : When an error or critical level log is output, the log will be saved to a file.
save_levels	A list of log levels to save. Defaults to ["INFO", "ERROR", "WARNING", "DEBUG", "CRITICAL"].
silent	True : Suppress standard output (print)
catch_exceptions	True : Automatically catch unhandled exceptions and log them as critical

Tag set

# one tag
logger = VersaLog(enum="detailed", tag="a", show_tag=True)

# two tag
logger = VersaLog(enum="detailed", tag=["a", "a"], show_tag=True)
```                                                                                                    |

## Log save

[2025-08-06 04:10:36][INFO] : ok

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
  <tbody>
    <tr>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/kaedeek"><img src="https://avatars.githubusercontent.com/u/170544738?v=4?s=100" width="100px;" alt="ₖₐₑ𝒹ₑ"/><br /><sub><b>ₖₐₑ𝒹ₑ</b></sub></a><br /><a href="https://github.com/kayu0514/VersaLog.py/commits?author=kaedeek" title="Code">💻</a></td>
    </tr>
  </tbody>
</table>

<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->

<!-- ALL-CONTRIBUTORS-LIST:END -->

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!