feat: add voice messages list functionality

Author: Serge Kamel

messagebird/client.py

@@ -13,7 +13,7 @@
 from messagebird.message import Message, MessageList
 from messagebird.mms import MMS
 from messagebird.voice_webhook import VoiceWebhook, VoiceWebhookList
-from messagebird.voicemessage import VoiceMessage
+from messagebird.voicemessage import VoiceMessagesList, VoiceMessage
 from messagebird.lookup import Lookup
 from messagebird.verify import Verify
 from messagebird.http_client import HttpClient, ResponseFormat
@@ -241,6 +241,11 @@ def voice_message(self, id):
         "Retrieve the information of a specific voice message."
         return VoiceMessage().load(self.request('voicemessages/' + str(id)))
 
+    def voice_message_list(self, limit=10, offset=0):
+        "Retrieve the information of a list of voice messages."
+        query = self._format_query(limit, offset)
+        return VoiceMessagesList().load(self.request('voicemessages?' + query, 'GET', None))
+
     def voice_message_create(self, recipients, body, params=None):
         """Create a new voice message."""
         if params is None:

messagebird/voicemessage.py

@@ -1,6 +1,44 @@
 from messagebird.base import Base
+from messagebird.base_list import BaseList
 from messagebird.recipient import Recipient
 
+class VoiceMessagesList(BaseList):
+    def __init__(self):
+        super(VoiceMessagesList, self).__init__(VoiceMessage)
+        self.perPage = None
+        self.currentPage = None
+        self.pageCount = None
+        self._pagination = None
+
+    @property
+    def data(self):
+        return self.items
+
+    @property
+    def pagination(self):
+        return {
+            "totalCount": self.totalCount,
+            "pageCount": self.pageCount,
+            "currentPage": self.currentPage,
+            "perPage": self.perPage
+        }
+
+    @pagination.setter
+    def pagination(self, value):
+        if isinstance(value, dict):
+            self.totalCount = value['totalCount']
+            self.pageCount = value['pageCount']
+            self.currentPage = value['currentPage']
+            self.perPage = value['perPage']
+            self.limit = self.perPage * self.currentPage
+            self.offset = self.perPage * (self.currentPage - 1)
+
+    @data.setter
+    def data(self, value):
+        if isinstance(value, list):
+            self.count = len(value)
+            self.items = value
+
 
 class VoiceMessage(Base):
     def __init__(self):