Repository files navigation

Loguru-Discord is a lightweight sink forLoguru that forwards logs toDiscord via the Webhook API.

• Plug-and-play adoption with your existing logging structure
• Highly configurable presentation, from usernames and avatars to rich formatting and truncation
• Fully type-hinted for an excellent developer experience
• Native and performant Webhook API interaction powered byClyde

Install withuv (recommended):

uv add loguru-discord

Alternatively, install with pip:

pip install loguru-discord

You can integrate Loguru-Discord in just two lines:

fromloguru_discordimportDiscordSinklogger.add(DiscordSink("https://discord.com/api/webhooks/00000000/XXXXXXXX"))

All configuration is handled onDiscordSink via optional keyword arguments.

Here’s a complete, end-to-end example using Loguru-Discord:

fromloguruimportloggerfromloguru_discordimportDiscordSink# Construct the Discord handlersink:DiscordSink=DiscordSink("https://discord.com/api/webhooks/00000000/XXXXXXXX")# Add the sink to Logurulogger.add(sink)# Log an exceptiontry:value:float=1/0exceptExceptionase:logger.opt(exception=e).error("Lorem ipsum dolor sit amet")

Loguru-Discord loosely followsSemantic Versioning for consistent, predictable releases.

Contributions are welcome—whether it’s fixing bugs or adding new features.

• SeeCONTRIBUTING.md for guidelines.
• SeeIssues for known bugs and feature requests.

This project is not affiliated with or endorsed by Loguru or Discord in any way.