Package: dhooks-lite
dhooks-liteAnother simple class wrapper for interacting with Discord webhooks.ContentsOverviewFunctionalityExamplesInstallationDocumentationContributionOverviewdhooks-liteis a library with a set of classes for interacting with Discord webhooks written in Python 3.This library aims to differentiate itself from similar libraries with the following properties:is fully testedsimple to use (only one way of doing things, same name of attributes and objects as in theofficial Discord documentation)has loggingrequests are automatically retried and have sensible timeoutsworks with older Python versionsFunctionalityThis library provides following functionality:Posting messages in Discord channels via webhooks (synchronous calls only)Attaching Embeds to messagesRetrieve send reports and from DiscordRetrieve HTTP status and headers from Discord, e.g. for implementing rate limit handlingExamplesHere are some examples on how to use dhooks-lite in your Python scripts.Note that you also find the source code of all examples in the/examplesfolder of this repo.Hello WorldMinimal example for posting a message.fromdhooks_liteimportWebhookhook=Webhook(DISCORD_WEBHOOK_URL)hook.execute('Hello, World!')Posting with custom avatarIn this example we are setting username and avatar.fromdhooks_liteimportWebhookhook=Webhook(DISCORD_WEBHOOK_URL,username='Bruce Wayne',avatar_url='https://i.imgur.com/thK8erv.png')hook.execute('I am Batman!')Complete example with embedsFinally, here is an example for posting a message with two embeds and using all available features (shortened):importdatetimefromdhooks_liteimportWebhook,Embed,Footer,Image,Thumbnail,Author,Fieldhook=Webhook(DISCORD_WEBHOOK_URL)e1=Embed(description='Only a few years ago, scientists stumbled upon an electrical current of cosmic proportions.(...)',title='Universe\'s highest electric current found',url='https://www.newscientist.com/article/mg21028174-900-universes-highest-electric-current-found/',timestamp=datetime.datetime.utcnow(),color=0x5CDBF0,footer=Footer('Science Department','https://i.imgur.com/Bgsv04h.png'),image=Image('https://i.imgur.com/eis1Y0P.jpg'),thumbnail=Thumbnail('https://i.imgur.com/2A4k28x.jpg'),author=Author('John Scientist',url='https://en.wikipedia.org/wiki/Albert_Einstein',icon_url='https://i.imgur.com/1JoHDw1.png'),fields=[Field('1st Measurement','Failed'),Field('2nd Measurement','Succeeded')])e2=Embed(description="TOP SECRET - Do not distribute!")hook.execute('Checkout this new report from the science department:',username='Bruce Wayne',avatar_url='https://i.imgur.com/thK8erv.png',embeds=[e1,e2],wait_for_response=True)InstallationYou can install this library directly from PyPI:pipinstalldhooks-liteDocumentationFor a full documentation of all classes please see the official docshere.ContributionWe welcome any contribution!If you found a bug or have a feature request please raise an issue.If you want to help further improve this library please feel free to issue a merge request. Please adhere to the following requirements in your change:Code should be compliant withPEP8Full overage by unit testsAll classes should be immutableAll classes and their public methods must have docstring documentationAll changes must be documented in the Change Log