Add support for widget image

discord/guild.py

@@ -93,6 +93,7 @@
 from .welcome_screen import WelcomeScreen, WelcomeChannel
 from .automod import AutoModRule, AutoModTrigger, AutoModRuleAction
 from .partial_emoji import _EmojiTag, PartialEmoji
+from .http import Route
 
 
 __all__ = (
@@ -3931,6 +3932,38 @@ async def widget(self) -> Widget:
 
         return Widget(state=self._state, data=data)
 
+    WidgetStyle = Literal['shield', 'banner1', 'banner2', 'banner3', 'banner4']
+
+    def widget_image_url(self, style: WidgetStyle = 'shield') -> Optional[str]:
+        """
+
+        Returns the widget image url of the guild.
+
+        .. note::
+
+            The guild must have the widget enabled to get this information.
+
+        Parameters
+        -----------
+        style: :class:`str`
+            The style which should be applied for the widget.
+            Default to ``shield``. Returns ``None`` if widget is not enabled.
+
+        Raises
+        -------
+        HTTPException
+            Retrieving the widget image url failed.
+
+        Returns
+        --------
+        Optional[:class:`str`]
+            The widget image url in the given style.
+        """
+        if not self.widget_enabled:
+            return None
+
+        return f"{Route.BASE}/guilds/{self.id}/widget.png?style={style}"
+
     async def edit_widget(
         self,
         *,