Added all classes to autodoc

Author: sQu4rks

docs/images/cards_sample.png

@@ -33,6 +33,7 @@ The User Guide
     user/intro
     user/quickstart
     user/api
+    user/cards
 
 
 The Development Community

docs/index.rst

@@ -277,5 +277,93 @@ Warnings
     :show-inheritance:
     :members:
 
+.. _CardsAPI:
+
+Cards and Buttons
+=================
+
+.. autoclass:: webexteamssdk.cards.card.AdaptiveCard()
+
+Components
+----------
+
+.. autoclass:: webexteamssdk.cards.components.Image()
+   :members:
+
+   .. automethod:: __init__
+
+.. autoclass:: webexteamssdk.cards.components.TextBlock()
+   :members:
+
+   .. automethod:: __init__
+
+.. autoclass:: webexteamssdk.cards.components.Column()
+
+.. autoclass:: webexteamssdk.cards.components.Fact()
+
+.. autoclass:: webexteamssdk.cards.components.Choice()
+
+Options
+-------
+
+.. autoclass:: webexteamssdk.cards.options.VerticalContentAlignment()
+
+.. autoclass:: webexteamssdk.cards.options.Colors()
+
+.. autoclass:: webexteamssdk.cards.options.HorizontalAlignment()
+
+.. autoclass:: webexteamssdk.cards.options.FontSize()
+
+.. autoclass:: webexteamssdk.cards.options.FontWeight()
+
+.. autoclass:: webexteamssdk.cards.options.BlockElementHeight()
+
+.. autoclass:: webexteamssdk.cards.options.Spacing()
+
+.. autoclass:: webexteamssdk.cards.options.ImageSize()
+
+.. autoclass:: webexteamssdk.cards.options.ImageStyle()
+
+.. autoclass:: webexteamssdk.cards.options.ContainerStyle()
+
+.. autoclass:: webexteamssdk.cards.options.TextInputStyle()
+
+.. autoclass:: webexteamssdk.cards.options.ChoiceInputStyle()
+
+
+Container
+---------
+
+.. autoclass:: webexteamssdk.cards.container.Container()
+
+.. autoclass:: webexteamssdk.cards.container.ColumnSet()
+
+.. autoclass:: webexteamssdk.cards.container.FactSet()
+
+.. autoclass:: webexteamssdk.cards.container.ImageSet()
+
+Inputs
+------
+
+.. autoclass:: webexteamssdk.cards.inputs.Text()
+
+.. autoclass:: webexteamssdk.cards.inputs.Number()
+
+.. autoclass:: webexteamssdk.cards.inputs.Date()
+
+.. autoclass:: webexteamssdk.cards.inputs.Time()
+
+.. autoclass:: webexteamssdk.cards.inputs.Toggle()
+
+.. autoclass:: webexteamssdk.cards.inputs.Choices()
+
+Actions
+-------
+
+.. autoclass:: webexteamssdk.cards.actions.OpenUrl
+
+.. autoclass:: webexteamssdk.cards.actions.Submit
+
+.. autoclass:: webexteamssdk.cards.actions.ShowCard
 
 *Copyright (c) 2016-2019 Cisco and/or its affiliates.*

docs/user/api.rst

@@ -0,0 +1,39 @@
+.. _Cards:
+
+=================
+Cards and Buttons
+=================
+
+Webex Teams supports `AdaptiveCards <https://www.adaptivecards.io/>`_ to allow
+new levels of interactivity for bots and integrations. You can read more about
+how cards and buttons work `in the official guide <https://developer.webex.com/docs/api/guides/cards>`_.
+
+In this guide I want to cover the abstraction build into the webexteamssdk that
+lets you author adaptive cards in pure python without having to touch the
+underlying json of a adaptive card.
+
+Lets dive into a simple example that sends a card to a room
+
+.. code-block:: python
+
+    from webexteamssdk import WebexTeamsAPI
+    from webexteamssdk.cards.card import AdaptiveCard
+    from webexteamssdk.cards.inputs import Text, Number
+    from webexteamssdk.cards.components import TextBlock
+    from webexteamssdk.cards.actions import Submit
+
+    greeting = TextBlock("Hey hello there! I am a adaptive card")
+    first_name = Text('first_name', placeholder="First Name")
+    age = Number('age', placeholder="Age")
+
+    submit = Submit(title="Send me!")
+
+    card = AdaptiveCard(body=[greeting, first_name, age], actions=[submit])
+
+    api = WebexTeamsAPI()
+    api.messages.create(text="fallback", roomId="...", cards=card)
+
+The message we send with this code then looks like this in our Webex Teams
+client:
+
+.. image:: ../images/cards_sample.png

docs/user/cards.rst

@@ -25,6 +25,7 @@
 from .abstract_components import Serializable
 from .utils import check_type
 from .options import BlockElementHeight, Spacing
+from .actions import OpenUrl, ShowCard, Submit
 
 class MediaSource(Serializable):
     """Defines the source of a Media element."""
@@ -76,7 +77,7 @@ def __init__(self,
         check_type(separator, bool, False, True)
         check_type(spacing, Spacing, False, True)
         check_type(id, str, False, True)
-        
+
         self.type = "Media"
         self.sources = sources #Needs to be a list of media sources
         self.poster = poster
@@ -92,6 +93,8 @@ def __init__(self,
                             'separator', 'spacing', 'id'
                          ])
 class Image(Serializable):
+    """Displays a image object"""
+
     def __init__(self,
                  url,
                  altText=None,
@@ -105,6 +108,38 @@ def __init__(self,
                  seperator=None,
                  spacing=None,
                  id=None):
+        """Create a new image component
+
+        Args:
+            url(str): The URL to the image
+            altText(str): Alternative text describing the image
+            backgroundColor(str): Background color for transparent images.
+            height(str, BlockElementHeight): Height of the image either as a
+                pixel value(i.e. '50px') or as an instance of BlockElementHeight
+            horizontalAlignmnet(HorizontalAlignment): Controls how the component
+                is positioned within its parent.
+            selectAction(OpenUrl, Submit): Option that is caried out when the
+                card is selected.
+            size(ImageSize): Controls the approximate size of the image.
+            style(ImageStyle): The display style of this image.
+            width(str): Width of the image as a pixel value (i.e. '50px')
+            separator(bool): Draw a separating line when set to true
+            spacing(Spacing): Specify the spacing of this component
+            id(str): The id of this component
+
+        """
+        check_type(url, str, False, False)
+        check_type(altText, str, False, True)
+        check_type(backgroundColor, str, False, True)
+        check_type(height, (str, BlockElementHeight), False, True)
+        check_type(horizontalAlignment, horizontalAlignment, False, True)
+        check_type(selectAction, (OpenUrl, Submit), False, True)
+        check_type(size, ImageSize, False, True)
+        check_type(style, ImageStyle, False, True)
+        check_style(width, str, False, True)
+        check_style(separator, bool, False, True)
+        check_style(spacing, Spacing, False, True)
+        check_style(id, str, False, True)
 
         self.type = "Image"
         self.url = url