Add track_self_describing_event() method (close snowplow#160)

Author: chuwy

snowplow_tracker/_version.py

@@ -15,10 +15,10 @@
     language governing permissions and limitations there under.
 
     Authors: Anuj More, Alex Dean, Fred Blundun
-    Copyright: Copyright (c) 2013-2014 Snowplow Analytics Ltd
+    Copyright: Copyright (c) 2013-2016 Snowplow Analytics Ltd
     License: Apache License Version 2.0
 """
 
 
-__version_info__ = (0, 7, 2)
+__version_info__ = (0, 8, 0)
 __version__ = ".".join(str(x) for x in __version_info__)

snowplow_tracker/self_describing_json.py

@@ -19,6 +19,7 @@
     License: Apache License Version 2.0
 """
 
+
 class SelfDescribingJson(object):
 
     def __init__(self, schema, data):

snowplow_tracker/test/unit/test_tracker.py

@@ -20,9 +20,12 @@
 """
 
 
-import unittest
 import re
+import unittest
+
+from contracts.interface import ContractNotRespected
 from freezegun import freeze_time
+
 from snowplow_tracker.tracker import Tracker
 from snowplow_tracker.emitters import Emitter
 
@@ -61,3 +64,11 @@ def test_add_emitter(self):
         t = Tracker(e1, namespace="cloudfront", encode_base64= False, app_id="AF003")
         t.add_emitter(e2)
         self.assertEquals(t.emitters, [e1, e2])
+
+    def test_alias_contract(self):
+        e1 = Emitter("d3rkrsqld9gmqf.cloudfront.net", method="get")
+        t = Tracker(e1, namespace="cloudfront", encode_base64= False, app_id="AF003")
+        try:
+            t.track_self_describing_event("not-SelfDescribingJson")
+        except Exception as e:
+            self.assertIsInstance(e, ContractNotRespected)

snowplow_tracker/tracker.py

@@ -81,7 +81,7 @@ def __init__(self, emitters, subject=None,
             self.emitters = emitters
         else:
             self.emitters = [emitters]
-        
+
         self.subject = subject
         self.encode_base64 = encode_base64
 
@@ -272,9 +272,9 @@ def track_ecommerce_transaction(self, order_id, total_value,
             item["order_id"] = order_id
             item["currency"] = currency
             self.track_ecommerce_transaction_item(**item)
-        
+
         return self
-    
+
     @contract
     def track_screen_view(self, name=None, id_=None, context=None, tstamp=None):
         """
@@ -288,7 +288,7 @@ def track_screen_view(self, name=None, id_=None, context=None, tstamp=None):
         """
         screen_view_properties = {}
         if name is not None:
-            screen_view_properties["name"] = name        
+            screen_view_properties["name"] = name
         if id_ is not None:
             screen_view_properties["id"] = id_
 
@@ -333,10 +333,11 @@ def track_unstruct_event(self, event_json, context=None, tstamp=None):
             :param  event_json:      The properties of the event. Has two field:
                                      A "data" field containing the event properties and
                                      A "schema" field identifying the schema against which the data is validated
-
             :type   event_json:      self_describing_json
             :param  context:         Custom context for the event
             :type   context:         context_array | None
+            :param  tstamp:          User-set timestamp
+            :type   tstamp:          int | None
             :rtype:                  tracker
         """
 
@@ -349,6 +350,9 @@ def track_unstruct_event(self, event_json, context=None, tstamp=None):
 
         return self.complete_payload(pb, context, tstamp)
 
+    # Alias
+    track_self_describing_event = track_unstruct_event
+
     @contract
     def flush(self, async=False):
         """