IoT-Ticket Python client

IoT-Ticket Python client provides an easy-to-use library and examples so that your application can take advantage of the versatile IoT-Ticket cloud tools.

System requirements

This Python library required Python 3 installed in your system.
Lastest version of Python could be downloaded from: https://www.python.org/downloads/
When Python installation file is downloaded, It could be installed into the system like normal program

Getting started

1. This Python library required Python 3 installed in your system.
2. Create your own IoT-Ticket account at https://www.iot-ticket.com/ (Request an invitation)
3. Wait for the account activation email
4. Download library from github.
5. Extract the Zip file, point Pythonpath to the directory that contain the library.
6. Start using the library in your application.

Using the library

In your application, import the needed libraries

from iotticket.models import device
from iotticket.models import criteria
from iotticket.models import deviceattribute
from iotticket.models import datanodesvalue
from iotticket.client import Client

The iotticket.client is the main library to be used. All the rest above is used to create objects of its class.

Provided funtion in client

Here are the list of provided functions

getdevice(self, deviceId)
getdevices(self, limit, offset)
getdatanodeslist(self, deviceId, limit, offset)
getallquota(self)
getdevicequota(self, deviceId)
registerdevice(self, deviceobj)
readdata(self, deviceId, criteriaobj, fromdate, todate, limit)
writedata(self, deviceId, *datanodevalueobj)

Example code

The library contains a demo which provides a complete example application. Also, the unit tests can be used as a reference. demo/demo.py test/unittest.py NOTE: In order to run the demo application or unittest provided in our project, you need to create yourself a config.json file.

{
    "username": "your_username",
    "password": "your_password",
    "deviceId": "your_deviceId",
    "baseurl": "https://my.iot-ticket.com/api/v1/"
}

NOTE: The base URL if you are using our IoT server will be: "https://my.iot-ticket.com/api/v1/" In demo application, config file is called:

data = json.load(open(sys.argv[1]))
username = data["username"]
password = data["password"]
deviceId = data["deviceId"]
baseurl = data["baseurl"]

The examples could be run by using command. You need to provide command line argument which point to your config file:

$ python file_name.py path_to_your_config_file

Verify or Unverify Certificate

c = Client(baseurl, username, password, False)

True is default if no argument is given. If False is given, the unverified mode will be on. It will not check url certificate.

Registering a device

d = device()
d.set_name("Johan")
d.set_manufacturer("Wapice")
d.set_type("employee")
d.set_description("Im trainee")
d.set_attributes(deviceattribute("a","b"), deviceattribute("c","d"), deviceattribute("key","value")) [replace the arguments by list of deviceattribute object]	

c = client(baseurl, username, password)

c.registerdevice(d)

Register Device Function source code:

def registerdevice(self, deviceobj):		
		if(validate(deviceobj)):
			try:
				#parse to json and encode
				j = json.dumps(deviceobj.__dict__, sort_keys = True, indent=4)
				data = j.encode("utf8")			
				auth = url.HTTPBasicAuthHandler()
				pathUrl = self.baseUrl + self.deviceresource
				auth.add_password(realm="Wapice IOT", uri = pathUrl, user = self.username, passwd = self.password)
				opener = url.build_opener(auth)
				url.install_opener(opener)
				#create request with header
				req = url.Request(pathUrl, data=data, headers={'content-type' : 'application/json'})			
				response = url.urlopen(req)
				response = response.read()
			except err.HTTPError as e:
				if(e.code!=404):
					return self.get_errorinfo(e.code, e.read())		
				else:
					return "404 URL NOT FOUND!!!"		
			else:
				return self.get_response(response, "iotticketmodels.device")
		else:
			return "Device is not valid."

Validate function

Validate function using declared criteria in class

crit = [{"name": {"max_length":100, "nullable" : False}}, {"unit": {"max_length": 10}}, {"path": {"max_length": 1000, "regex" : "(\\/[a-zA-Z0-9]+){1,10}"}}]

Validation code:

import re
def validate(obj):
	isValid = True
	for n in obj.crit:
		for key in n:
			critlist = n[key]
			for critlistkey in critlist:
				if critlistkey == "max_length":
					if len(getattr(obj,key)) > critlist[critlistkey]:
						isValid = False
				if critlistkey == "nullable":
					if critlist[critlistkey] is False:
						if(getattr(obj,key) == "" or getattr(obj,key) == None or getattr(obj,key) == 0):
							isValid = False
				if critlistkey == "regex":
					if( not re.match(critlist[critlistkey], getattr(obj,key), flags = 0)):	
						isValid = False
				if critlistkey == "dataType":
					if not isinstance(getattr(obj,key), critlist[critlistkey]):
						isValid = False
	return isValid		

Sending data

nv = datanodesvalue()
nv.set_name("Finger No")
nv.set_path("fingerno")
nv.set_dataType("double")
nv.set_value(10)	

c = client(baseurl, username, password)

c.writedata(deviceId, nv)

Get datanodes for a device

c = client(baseurl, username, password)

c.getdatanodeslist(deviceId, 10, 0)

Read data

cr = criteria()
cr.set_criterialist("Latitude", "Longitude") [Replace the arguments by your criteria, separate by ","]

c = client(baseurl, username, password)
fd = "2016-03-22 17:22:00"
td = "2016-03-22 17:25:00"

c.readdata(deviceId, cr, fd , td, limit)

fromdate and todate is not required. it can be set and passed as argument.
If limit is provided but not fromdate and todate, then the function can be called as c.readdata(deviceId, cr, "", "", limit)
If no extra argument is provided, simply call c.readdata(deviceId, cr)

API documentation

This C++ client library uses the IoT-Ticket REST API. The documentation for the underlying REST service can be found from https://www.iot-ticket.com/images/Files/IoT-Ticket.com_IoT_API.pdf