From 1015ba4704b81717f2754a462030c508726253c8 Mon Sep 17 00:00:00 2001
From: R3T4RD3D <r3t.r3t4rd3d@gmail.com>
Date: Tue, 11 Apr 2017 01:49:09 +0200
Subject: [PATCH] Add documentation to MessageEmbed* objects

---
 disco/types/message.py | 110 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 110 insertions(+)

diff --git a/disco/types/message.py b/disco/types/message.py
index 9b33d11..a005337 100644
--- a/disco/types/message.py
+++ b/disco/types/message.py
@@ -51,12 +51,38 @@ class MessageReaction(SlottedModel):
 
 
 class MessageEmbedFooter(SlottedModel):
+    """
+    Message embed footer object.
+
+    Attributes
+    ----------
+    text : str
+        Footer text.
+    icon_url : str
+        URL of footer icon.
+    proxy_icon_url : str
+        Proxied URL of the footer icon.
+    """
     text = Field(text)
     icon_url = Field(text)
     proxy_icon_url = Field(text)
 
 
 class MessageEmbedImage(SlottedModel):
+    """
+    Message embed image object.
+
+    Attributes
+    ----------
+    url : str
+        Source URL of image.
+    proxy_url : str
+        Proxied URL of the image.
+    height : int
+        height of image.
+    width : int
+        width of image.
+    """
     url = Field(text)
     proxy_url = Field(text)
     width = Field(int)
@@ -64,6 +90,20 @@ class MessageEmbedImage(SlottedModel):
 
 
 class MessageEmbedThumbnail(SlottedModel):
+    """
+    Message embed thumbnail object.
+
+    Attributes
+    ----------
+    url : str
+        Source URL of thumbnail.
+    proxy_url : str
+        Proxied URL of the thumbnail.
+    height : int
+        height of thumbnail.
+    width : int
+        width of thumbnail.
+    """
     url = Field(text)
     proxy_url = Field(text)
     width = Field(int)
@@ -71,12 +111,38 @@ class MessageEmbedThumbnail(SlottedModel):
 
 
 class MessageEmbedVideo(SlottedModel):
+    """
+    Message embed video object.
+
+    Attributes
+    ----------
+    url : str
+        Source URL of video.
+    height : int
+        height of video.
+    width : int
+        width of video.
+    """
     url = Field(text)
     height = Field(int)
     width = Field(int)
 
 
 class MessageEmbedAuthor(SlottedModel):
+    """
+    Message embed author object.
+
+    Attributes
+    ----------
+    name : str
+        Name of author.
+    url : str
+        URL of author.
+    icon_url : str
+        URL of author icon.
+    icon_proxy_url : str
+        Proxied URL of the author icon.
+    """
     name = Field(text)
     url = Field(text)
     icon_url = Field(text)
@@ -84,6 +150,18 @@ class MessageEmbedAuthor(SlottedModel):
 
 
 class MessageEmbedField(SlottedModel):
+    """
+    Message embed field object.
+
+    Attributes
+    ----------
+    name : str
+        Name of the field.
+    value : str
+        Value of the field.
+    inline : bool
+        Whether or not this field should display inline.
+    """
     name = Field(text)
     value = Field(text)
     inline = Field(bool)
@@ -103,6 +181,20 @@ class MessageEmbed(SlottedModel):
         Description of the embed.
     url : str
         URL of the embed.
+    timestamp : datetime
+        Timestamp of the embed content.
+    color : int
+        Color code of the embed.
+    footer : :class:`MessageEmbedFooter`
+        Footer information.
+    image : :class:`MessageEmbedImage`
+        Image information.
+    thumbnail : :class:`MessageEmbedThumbnail`
+        Thumbnail information.
+    video : :class:`MessageEmbedVideo`
+        Video information.
+    fields : list(:class:`MessageEmbedField`)
+        Fields information.
     """
     title = Field(text)
     type = Field(str, default='rich')
@@ -118,21 +210,39 @@ class MessageEmbed(SlottedModel):
     fields = ListField(MessageEmbedField)
 
     def set_footer(self, *args, **kwargs):
+        """
+        Adds :class:`MessageEmbedFooter` to the embed.
+        """
         self.footer = MessageEmbedFooter(*args, **kwargs)
 
     def set_image(self, *args, **kwargs):
+        """
+        Adds :class:`MessageEmbedImage` to the embed.
+        """
         self.image = MessageEmbedImage(*args, **kwargs)
 
     def set_thumbnail(self, *args, **kwargs):
+        """
+        Adds :class:`MessageEmbedThumbnail` to the embed.
+        """
         self.thumbnail = MessageEmbedThumbnail(*args, **kwargs)
 
     def set_video(self, *args, **kwargs):
+        """
+        Adds :class:`MessageEmbedVideo` to the embed.
+        """
         self.video = MessageEmbedVideo(*args, **kwargs)
 
     def set_author(self, *args, **kwargs):
+        """
+        Adds :class:`MessageEmbedAuthor` to the embed.
+        """
         self.author = MessageEmbedAuthor(*args, **kwargs)
 
     def add_field(self, *args, **kwargs):
+        """
+        Appends :class:`MessageEmbedField` to the embed.
+        """
         self.fields.append(MessageEmbedField(*args, **kwargs))