Added ability to send "pythonic" cards to message create method

You can now send a card like this:

```
from webexteamssdk import WebexTeamsAPI
from webexteamssdk.cards.card import AdaptiveCard
from webexteamssdk.cards.components import TextBlock
from webexteamssdk.cards.options import Colors

block = TextBlock("Hey hello there! I am a adaptive card",
color=Colors.GOOD)
card = AdaptiveCard(body=[block])
api = WebexTeamsAPI()
api.messages.create(text="fallback", roomId="...", cards=card)
```

Author: sQu4rks

webexteamssdk/api/messages.py

@@ -39,8 +39,9 @@
 from ..restsession import RestSession
 from ..utils import (
     check_type, dict_from_items_with_values, is_local_file, is_web_url,
-    open_local_file,
+    open_local_file, make_card_attachment
 )
+from ..cards.card import AdaptiveCard
 
 
 API_ENDPOINT = 'messages'
@@ -135,7 +136,7 @@ def list(self, roomId, mentionedPeople=None, before=None,
             yield self._object_factory(OBJECT_TYPE, item)
 
     def create(self, roomId=None, toPersonId=None, toPersonEmail=None,
-               text=None, markdown=None, files=None, **request_parameters):
+               text=None, markdown=None, files=None, cards=None, **request_parameters):
         """Post a message, and optionally a attachment, to a room.
 
         The files parameter is a list, which accepts multiple values to allow
@@ -154,6 +155,8 @@ def create(self, roomId=None, toPersonId=None, toPersonEmail=None,
             markdown(basestring): The message, in markdown format.
             files(`list`): A list of public URL(s) or local path(s) to files to
                 be posted into the room. Only one file is allowed per message.
+            cards(`list`): A list of adaptive cards objects that will be send
+                with this message.
             **request_parameters: Additional request parameters (provides
                 support for parameters that may be added in the future).
 
@@ -174,6 +177,7 @@ def create(self, roomId=None, toPersonId=None, toPersonEmail=None,
         check_type(text, basestring)
         check_type(markdown, basestring)
         check_type(files, list)
+        check_type(cards, (list, AdaptiveCard))
         if files:
             if len(files) != 1:
                 raise ValueError("The length of the `files` list is greater "
@@ -194,6 +198,17 @@ def create(self, roomId=None, toPersonId=None, toPersonEmail=None,
             files=files,
         )
 
+        # Add cards
+        if cards is not None:
+            cards_list = []
+
+            if isinstance(cards, list):
+                cards_list = [make_card_attachment(c) for c in cards]
+            else:
+                cards_list = [make_card_attachment(cards)]
+
+            post_data['attachments'] = cards_list
+
         # API request
         if not files or is_web_url(files[0]):
             # Standard JSON post

webexteamssdk/utils.py

@@ -254,6 +254,22 @@ def json_dict(json_data):
             "received: {!r}".format(json_data)
         )
 
+def make_card_attachment(card):
+    """Given a card, makes a card attachment by attaching the correct
+       content type and content.
+
+      Args:
+        card(AdaptiveCard): Adaptive Card object that should be attached
+
+      Returns:
+        A Python dictionary containing the card attachment dictionary
+    """
+    ret = {
+        "contentType": "application/vnd.microsoft.card.adaptive",
+        "content": card.to_dict()
+    }
+
+    return ret
 
 class ZuluTimeZone(tzinfo):
     """Zulu Time Zone."""