mms: add create mms api support

Author: sarathsp06

examples/mms.py

@@ -0,0 +1,26 @@
+#!/usr/bin/env python
+
+import sys, os
+sys.path.append(os.path.join(os.path.dirname(__file__), '..'))
+
+import messagebird
+
+ACCESS_KEY = os.environ.get('ACCESS_KEY', None)
+if ACCESS_KEY is None:
+  print("Set environment ACCESS_KEY  from https://dashboard.messagebird.com/en/developers/access")
+  exit(1)
+
+try:
+  # Create a MessageBird client with the specified ACCESS_KEY.
+  client = messagebird.Client(ACCESS_KEY)
+  # Send a MMS 
+  mms = client.mms_create('Sarath','+4915238456487','Rich test message','https://www.messagebird.com/assets/images/og/messagebird.gif')
+  # Print the object information.
+  print("The following information was returned as a MMS object:\n%s" % mms)
+
+except messagebird.client.ErrorException as e:
+  print('\nAn error occured while requesting to send a MMS:\n')
+  for error in e.errors:
+    print('  code        : %d' % error.code)
+    print('  description : %s' % error.description)
+    print('  parameter   : %s\n' % error.parameter)

messagebird/client.py

@@ -7,6 +7,7 @@
 from messagebird.group import Group, GroupList
 from messagebird.hlr import HLR
 from messagebird.message import Message
+from messagebird.mms import MMS
 from messagebird.voicemessage import VoiceMessage
 from messagebird.lookup import Lookup
 from messagebird.verify import Verify
@@ -110,6 +111,16 @@ def message_delete(self, id):
         """Delete a message from the dashboard."""
         self.request_plain_text('messages/' + str(id), 'DELETE')
 
+    def mms_create(self, originator, recipients, body, mediaUrls, subject = None, reference = None, scheduledDatetime = None):
+        """ Send bulk mms. """
+        if isinstance(recipients,list):
+            recipients = ','.join(recipients)
+        if isinstance(mediaUrls,str):
+            mediaUrls = [mediaUrls]
+        params = locals()
+        del(params['self'])
+        return  MMS().load(self.request('mms', 'POST', params))
+
     def voice_message(self, id):
         "Retrieve the information of a specific voice message."
         return VoiceMessage().load(self.request('voicemessages/' + str(id)))
@@ -250,6 +261,6 @@ def conversation_list_webhooks(self, limit=10, offset=0):
     def conversation_read_webhook(self, id):
         uri = CONVERSATION_WEB_HOOKS_PATH + '/' + str(id)
         return ConversationWebhook().load(self.request(uri, 'GET', None, CONVERSATION_TYPE))
-
+    
     def _format_query(self, limit, offset):
         return 'limit=' + str(limit) + '&offset=' + str(offset)

messagebird/mms.py

@@ -0,0 +1,56 @@
+from messagebird.base      import Base
+from messagebird.recipient import Recipient
+
+class MMS(Base):
+  def __init__(self):
+    self.id                 = None
+    self.href               = None
+    self.direction          = None
+    self.originator         = None
+    self.subject            = None
+    self.body               = None
+    self.mediaUrls          = None
+    self.reference          = None
+    self._scheduledDatetime = None
+    self._createdDatetime   = None
+    self._recipients        = None
+
+  @property 
+  def scheduledDatetime(self):
+    return self._scheduledDatetime
+
+  @scheduledDatetime.setter
+  def scheduledDatetime(self, value):
+    self._scheduledDatetime = self.value_to_time(value)
+
+  @property
+  def createdDatetime(self):
+    return self._createdDatetime
+
+  @createdDatetime.setter
+  def createdDatetime(self, value):
+    self._createdDatetime = self.value_to_time(value)
+
+  @property
+  def recipients(self):
+    return self._recipients
+
+  @recipients.setter
+  def recipients(self, value):
+    value['items'] = [Recipient().load(r) for r in value['items']]
+    self._recipients = value
+  
+  def __str__(self):
+    return "\n".join([
+        "id                      : %s" % self.id                ,
+        "href                    : %s" % self.href              ,
+        "direction               : %s" % self.direction         ,
+        "originator              : %s" % self.originator        ,
+        "subject                 : %s" % self.subject           ,
+        "body                    : %s" % self.body              ,
+        "mediaUrls               : %s" % ",".join(self.mediaUrls),
+        "reference               : %s" % self.reference         ,
+        "scheduledDatetime       : %s" % self.scheduledDatetime ,
+        "createdDatetime         : %s" % self.createdDatetime   ,
+        "recipients              : %s" % self.recipients,
+    ])

tests/test_mms.py

@@ -0,0 +1,27 @@
+import unittest
+from messagebird import Client
+
+try:
+    from unittest.mock import Mock
+except ImportError:
+    # mock was added to unittest in Python 3.3, but was an external library
+    # before.
+    from mock import Mock
+
+
+class TestMMS(unittest.TestCase):
+
+    def test_create_mms(self):
+        http_client = Mock()
+        http_client.request.return_value = '{"originator": "test-org", "body": "Rich test message", "direction": "mt", "recipients": {"totalCount": 1, "totalSentCount": 1, "totalDeliveredCount": 0, "totalDeliveryFailedCount": 0, "items": [{"status": "sent", "statusDatetime": "2019-06-04T13:54:48+00:00", "recipient": 4915238456487}]}, "reference": null, "createdDatetime": "2019-06-04T13:54:48+00:00", "href": "https://rest.messagebird.com/mms/0a75f8f82b5d4377bd8fb5b22ac1e8ac", "mediaUrls": ["https://www.messagebird.com/assets/images/og/messagebird.gif"], "scheduledDatetime": null, "id": "0a75f8f82b5d4377bd8fb5b22ac1e8ac", "subject": null}'
+
+        params = {"originator": "test-org", "body": "Rich test message","recipients":"+4915238456487","mediaUrls":"https://www.messagebird.com/assets/images/og/messagebird.gif"}
+        mms = Client('', http_client).mms_create(**params)
+
+        params["mediaUrls"] = [params["mediaUrls"]]
+        params.update({'subject': None, 'reference': None, 'scheduledDatetime': None})
+        http_client.request.assert_called_once_with('mms', 'POST', params)
+
+        self.assertEqual(params["originator"], mms.originator)
+        self.assertEqual(params["recipients"].strip("+"), str(mms.recipients["items"][0].recipient))
+        self.assertEqual(1,len(mms.recipients["items"]))