The python client allows you to use The Creator IoT Framework, giving the possibility to quickly implement a client, to consume the Device Server REST API.
- Getting Started
- Jump Start
- The Request Method
- Example Get Clients List
- Test
- Help
- License
- Contributing
On the current version the python module can be used by placing - creator_python_client.py file on the project directory. Then, import the module in the code:
import creator_python_clientIn order to be able to utilize this library you will have to sign up for a creator account. You can do so going through the Creator Developer Console
After signing up, you will need to create an access key and secret pair from the API keys section of the console. These will gain you access to the Creator REST API while using this library.
You can then create an instance of the library as follows:
import creator_python_client
CREATOR_ACCESS_KEY = '<your_access_key>'
CREATOR_ACCESS_SECRET = '<your_access_secret>'
creator_python_client.request(CREATOR_ACCESS_KEY, CREATOR_ACCESS_SECRET)Please note that you can also set the following environment variables for the library to use.
- CREATOR_ACCESS_KEY
- CREATOR_ACCESS_SECRET
and then
import creator_python_client
import os
CREATOR_ACCESS_KEY = os.environ['CREATOR_ACCESS_KEY']
CREATOR_ACCESS_SECRET = os.environ['CREATOR_ACCESS_SECRET']
creator_python_client.request(CREATOR_ACCESS_KEY, CREATOR_ACCESS_SECRET)Now you should have a working instance of the library that you can use to access your resources RESTfully.
As you may already know, creator rest api is using what is called the HATEOAS REST application structure which means that you need to follow links in order to reach to certain resources. This library will do that for you. Please keep reading!
The request method provide a very flexible way of accessing any resource you would like to interact with.
The structure for this method is as follows:
creator_python_client.request(CREATOR_ACCESS_KEY, CREATOR_ACCESS_SECRET, method="get", steps=steps, data=data)This module supports the following HTTP methods/verbs:
- GET
- PUT
- POST
- DEL
The method can be selected in the method option:
method="<http_method>"In the steps argument, the user provides path to the resource on the device Device Server. See two usage examples bellow:
steps = ["clients"]
request(CREATOR_ACCESS_KEY, CREATOR_ACCESS_SECRET, method="get", steps=steps)To access AwaLWM2M objects and its instances within the Device Server, you can provide the steps as shown in the following example:
steps = [("clients","ci40-press"), ("ObjectTypeID", "3201"), ("InstanceID","0")]
request(CREATOR_ACCESS_KEY, CREATOR_ACCESS_SECRET, method="get", steps=steps)The argument data allows receives the Payload for the PUT and POST method. This functionality is useful if the user wants to update a resource on the Device Server. For example:
creator_python_client.request(CREATOR_ACCESS_KEY, CREATOR_ACCESS_SECRET, method="put", steps=steps, data={"DigitalOutputState": False})Thus, the Digital Output State is updated to False.
The following example shows how to get a list of AwaLWM2M clients within the Device Server:
#!/usr/bin/env python
# -*- encoding: utf-8 -*-
import creator_python_client
CREATOR_ACCESS_KEY = '<your_access_key>'
CREATOR_ACCESS_SECRET = '<your_access_secret>'
steps = ["clients"]
CLIENTS = creator_python_client.request(CREATOR_ACCESS_KEY, CREATOR_ACCESS_SECRET, method="get", steps=steps)
print CLIENTSYou can run the command below to initiate the tests. Please note that the aforementioned ENV variables need to be set for the test script to work properly.
$ python test.pyIf you have any problems installing or utilising this project, please look into our Creator Forum.
Otherwise, If you have come across a nasty bug or would like to suggest new features to be added then please go ahead and open an issue or a pull request against this repo.
Please see the license file for a detailed explanation.
Any Bug fixes and/or feature enhancements are welcome. Please see the contributing file for a detailed explanation.
The Python code follows PEP 8 code styling, verified by Flake8.