Initial Event data model

Create the initial Event data model and add it to the package interface.

Author: cmlccie

ciscosparkapi/__init__.py

@@ -16,6 +16,7 @@
 from past.builtins import basestring
 
 from .api.access_tokens import AccessTokensAPI as _AccessTokensAPI
+from .api.events import EventsAPI as _EventsAPI
 from .api.licenses import LicensesAPI as _LicensesAPI
 from .api.memberships import MembershipsAPI as _MembershipsAPI
 from .api.messages import MessagesAPI as _MessagesAPI
@@ -31,8 +32,8 @@
     ciscosparkapiException,
 )
 from .models import (
-    AccessToken, License, Membership, Message, Organization, Person, Role,
-    Room, Team, TeamMembership, Webhook, WebhookEvent, sparkdata_factory,
+    AccessToken, Event, License, Membership, Message, Organization, Person,
+    Role, Room, Team, TeamMembership, Webhook, WebhookEvent, sparkdata_factory,
 )
 from .restsession import (
     DEFAULT_SINGLE_REQUEST_TIMEOUT,
@@ -187,6 +188,7 @@ def __init__(self, access_token=None, base_url=DEFAULT_BASE_URL,
         self.access_tokens = _AccessTokensAPI(
             self.base_url, object_factory, timeout=single_request_timeout
         )
+        self.events = _EventsAPI(self._session, object_factory)
 
     @property
     def access_token(self):

ciscosparkapi/models/__init__.py

@@ -12,6 +12,7 @@
 from collections import defaultdict
 
 from .access_token import AccessTokenBasicPropertiesMixin
+from .event import EventBasicPropertiesMixin
 from .license import LicenseBasicPropertiesMixin
 from .membership import MembershipBasicPropertiesMixin
 from .message import MessageBasicPropertiesMixin
@@ -36,6 +37,10 @@ class AccessToken(SparkData, AccessTokenBasicPropertiesMixin):
     """Cisco Spark Access-Token data model."""
 
 
+class Event(SparkData, EventBasicPropertiesMixin):
+    """Cisco Spark Event data model."""
+
+
 class License(SparkData, LicenseBasicPropertiesMixin):
     """Cisco Spark License data model."""
 
@@ -82,6 +87,7 @@ class WebhookEvent(SparkData, WebhookEventBasicPropertiesMixin):
 sparkdata_models = defaultdict(
     lambda: SparkData,
     access_token=AccessToken,
+    event=Event,
     license=License,
     membership=Membership,
     message=Message,

ciscosparkapi/models/event.py

@@ -0,0 +1,54 @@
+# -*- coding: utf-8 -*-
+"""Cisco Spark Event data model."""
+
+
+from __future__ import (
+    absolute_import,
+    division,
+    print_function,
+    unicode_literals,
+)
+
+from builtins import *
+
+from .sparkdata import SparkData
+
+
+__author__ = "Chris Lunsford"
+__author_email__ = "chrlunsf@cisco.com"
+__copyright__ = "Copyright (c) 2016-2018 Cisco and/or its affiliates."
+__license__ = "MIT"
+
+
+class EventBasicPropertiesMixin(object):
+    """A mixin for :class:`SparkData` classes."""
+
+    @property
+    def id(self):
+        """Event ID."""
+        return self._json_data.get('id')
+
+    @property
+    def resource(self):
+        """The event resource type (`messagess`, `memberships`)."""
+        return self._json_data.get('resource')
+
+    @property
+    def type(self):
+        """The event type (`created`, `updated`, `deleted`)."""
+        return self._json_data.get('type')
+
+    @property
+    def actorId(self):
+        """The ID of the person that performed this event."""
+        return self._json_data.get('actorId')
+
+    @property
+    def created(self):
+        """The date and time the event was performed."""
+        return self._json_data.get('created')
+
+    @property
+    def data(self):
+        """The event resource data."""
+        return SparkData(self._json_data.get('data'))