__init__.py

# -*- coding: utf-8 -*-

from __future__ import print_function, unicode_literals
try:
	from urllib.parse import urlencode
	from http.client import HTTPConnection,HTTPException,HTTPSConnection
except ImportError:
	from urllib import urlencode
	from httplib import HTTPConnection
	from httplib import HTTPSConnection
	from httplib import HTTPException
import hashlib

class WoopraTracker:
	"""
	Woopra Python SDK.
	This class represents the Python equivalent of the JavaScript Woopra Object.
	"""

	SDK_ID = "python"
	DEFAULT_TIMEOUT = 30000

	def __init__(self, domain):
		"""
		The constructor.
		Parameter:
			domain - str : the domain name of your website as submitted on woopra.com
		Result:
			WoopraTracker
		"""
		self.domain = domain
		self.secure = False
		self.idle_timeout = WoopraTracker.DEFAULT_TIMEOUT
		self.user_properties = {}
		self.cookie = None
		self.user_agent = None
		self.ip_address = None

	def set_idle_timeout(self, idle_timeout):
		self.idle_timeout = idle_timeout

	def set_cookie(self, cookie):
		self.cookie = cookie

	def set_ip_address(self, ip_address):
		self.ip_address = ip_address

	def set_user_agent(self, user_agent):
		self.user_agent = user_agent

	def set_secure(self, secure):
                self.secure = secure

	def identify(self, user_properties = {}):
		"""
		Identifies a user.
		Parameters:
			properties (optional) - dict : the user's additional properties (name, company, ...)
				key - str : the user property name
				value -str, int, bool = the user property value
		"""

		self.user_properties = user_properties

		if self.cookie == None:
			value=None
			if 'id' in self.user_properties:
				value=self.user_properties['id']
			elif 'email' in self.user_properties:
				value=self.user_properties['email']

			if value != None:
				m = hashlib.md5()
				m.update(value.encode('utf8'))
				long_cookie = m.hexdigest().upper()
				self.cookie = (long_cookie[:12]) if len(long_cookie) > 12 else long_cookie

	def track(self, event_name, event_data = {}):
		"""
		Tracks pageviews and custom events
		Parameters:
			event_name (optional) - str : The name of the event. If none is specified, will track pageview
			event_data (optional) - dict : Properties the custom event
				key - str : the event property name
				value - str, int, bool : the event property value
		Examples:
			# This code tracks a custom event through the back-end:
			woopra.track('signup', {'company' : 'My Business', 'username' : 'johndoe', 'plan' : 'Gold'})
		"""
		self.woopra_http_request(True, event_name, event_data)

	def push(self):
		"""
		Pushes the indentification information on the user to Woopra in case no tracking event occurs.
		Parameter:
			back_end_tracking (optional) - boolean : Should the information be pushed through the back-end? Defaults to False.
		Result:
			None
		"""
		self.woopra_http_request(False)

	def woopra_http_request(self, is_tracking, event_name = None, event_data = {}):
		"""
		Sends an Http Request to Woopra for back-end identification and/or tracking.
		Parameters:
			isTracking - boolean : is this request supposed to track an event or just identify the user?
			event (optional) - dict : only matters if isTracking == True. The event to pass. Default is None.
		Result:
			None
		"""

		get_params = {}

		# Configuration
		get_params["host"] = self.domain

		if self.ip_address != None:
			get_params["ip"] = self.ip_address

		if self.idle_timeout != None:
			get_params["timeout"] = self.idle_timeout

		if self.cookie != None:
			get_params["cookie"] = self.cookie

		# Identification
		for k, v in self.user_properties.items():
			get_params["cv_" + k] = v

		if not is_tracking:
			url = "/track/identify/?" + urlencode(get_params) + "&ce_app=" + WoopraTracker.SDK_ID
		else:
			get_params["ce_name"] = event_name
			for k,v in event_data.items():
				get_params["ce_" + k] = v
			url = "/track/ce/?" + urlencode(get_params) + "&ce_app=" + WoopraTracker.SDK_ID
		try:
			if self.secure:
				conn = HTTPSConnection("www.woopra.com")
			else:
				conn = HTTPConnection("www.woopra.com")

			if self.user_agent != None:
				conn.request("GET", url, headers={'User-agent': self.user_agent})
			else:
				conn.request("GET", url)
		except HTTPException as e: print(str(e))