Add WebexTeamDateTime and update model properties

Dates and times returned by Webex Teams should be modeled using Python's native datetime class - or a derivative thereof.  :)

Author: cmlccie

tests/api/test_events.py

@@ -82,13 +82,13 @@ def test_list_events_by_actor_id(api, events):
 
 
 def test_list_events_from(api, events):
-    datetime_string = min(event.created for event in events)
+    datetime_string = str(min(event.created for event in events))
     from_events = list(api.events.list(_from=datetime_string)[:5])
     assert are_valid_events(from_events)
 
 
 def test_list_events_to(api, events):
-    datetime_string = max(event.created for event in events)
+    datetime_string = str(max(event.created for event in events))
     to_events = list(api.events.list(to=datetime_string)[:5])
     assert are_valid_events(to_events)
 

tests/api/test_messages.py

@@ -163,7 +163,7 @@ def test_list_messages_before_datetime(api, group_room,
                                        group_room_markdown_message):
     message_list = list(api.messages.list(
         roomId=group_room.id,
-        before=group_room_markdown_message.created,
+        before=str(group_room_markdown_message.created),
     ))
     assert len(message_list) >= 1
     assert are_valid_messages(message_list)

webexteamssdk/__init__.py

@@ -46,6 +46,7 @@
     immutable_data_factory,
 )
 from .models.simple import SimpleDataModel, simple_data_factory
+from .utils import WebexTeamsDateTime
 
 
 __version__ = get_versions()['version']

webexteamssdk/config.py

@@ -36,3 +36,5 @@
     'SPARK_ACCESS_TOKEN',
     'CISCO_SPARK_ACCESS_TOKEN',
 ]
+
+WEBEX_TEAMS_DATETIME_FORMAT = "%Y-%m-%dT%H:%M:%S.%fZ"

webexteamssdk/models/mixins/event.py

@@ -32,6 +32,8 @@
 
 from builtins import *
 
+from webexteamssdk.utils import WebexTeamsDateTime
+
 
 class EventBasicPropertiesMixin(object):
     """Event basic properties."""
@@ -59,4 +61,4 @@ def actorId(self):
     @property
     def created(self):
         """The date and time the event was performed."""
-        return self._json_data.get('created')
+        return WebexTeamsDateTime.strptime(self._json_data.get('created'))

webexteamssdk/models/mixins/membership.py

@@ -32,6 +32,8 @@
 
 from builtins import *
 
+from webexteamssdk.utils import WebexTeamsDateTime
+
 
 class MembershipBasicPropertiesMixin(object):
     """Membership basic properties."""
@@ -79,4 +81,4 @@ def isMonitor(self):
     @property
     def created(self):
         """The date and time the membership was created."""
-        return self._json_data.get('created')
+        return WebexTeamsDateTime.strptime(self._json_data.get('created'))

webexteamssdk/models/mixins/message.py

@@ -32,6 +32,8 @@
 
 from builtins import *
 
+from webexteamssdk.utils import WebexTeamsDateTime
+
 
 class MessageBasicPropertiesMixin(object):
     """Message basic properties."""
@@ -89,4 +91,4 @@ def mentionedPeople(self):
     @property
     def created(self):
         """The date and time the message was created."""
-        return self._json_data.get('created')
+        return WebexTeamsDateTime.strptime(self._json_data.get('created'))

webexteamssdk/models/mixins/organization.py

@@ -32,6 +32,8 @@
 
 from builtins import *
 
+from webexteamssdk.utils import WebexTeamsDateTime
+
 
 class OrganizationBasicPropertiesMixin(object):
     """Organization basic properties."""
@@ -49,4 +51,4 @@ def displayName(self):
     @property
     def created(self):
         """Creation date and time in ISO8601 format."""
-        return self._json_data.get('created')
+        return WebexTeamsDateTime.strptime(self._json_data.get('created'))

webexteamssdk/models/mixins/person.py

@@ -32,6 +32,8 @@
 
 from builtins import *
 
+from webexteamssdk.utils import WebexTeamsDateTime
+
 
 class PersonBasicPropertiesMixin(object):
     """Person basic properties."""
@@ -94,7 +96,7 @@ def licenses(self):
     @property
     def created(self):
         """The date and time the person was created."""
-        return self._json_data.get('created')
+        return WebexTeamsDateTime.strptime(self._json_data.get('created'))
 
     @property
     def status(self):
@@ -104,7 +106,7 @@ def status(self):
     @property
     def lastActivity(self):
         """The date and time of the person's last activity."""
-        return self._json_data.get('lastActivity')
+        return WebexTeamsDateTime.strptime(self._json_data.get('lastActivity'))
 
     @property
     def invitePending(self):

webexteamssdk/models/mixins/room.py

@@ -32,6 +32,8 @@
 
 from builtins import *
 
+from webexteamssdk.utils import WebexTeamsDateTime
+
 
 class RoomBasicPropertiesMixin(object):
     """Room basic properties."""
@@ -59,12 +61,12 @@ def isLocked(self):
     @property
     def lastActivity(self):
         """The date and time when the room was last active."""
-        return self._json_data.get('lastActivity')
+        return WebexTeamsDateTime.strptime(self._json_data.get('lastActivity'))
 
     @property
     def created(self):
         """The date and time when the room was created."""
-        return self._json_data.get('created')
+        return WebexTeamsDateTime.strptime(self._json_data.get('created'))
 
     @property
     def creatorId(self):