kuksa.val python clients and SDK
Project description
Kuksa VISS Client
kuksa.val
is a part of the opensource project eclipse kuksa.
More about kuksa.val
can be found under the root README.md.
Here is a collection of clients, which can feed or handle data with the kuksa.val
server.
Python SDK
The python sdk is the easiest way for you to develop your own kuksa.val clients to interactive with the kuksa.val
server.
Installation
pip install kuksa-viss-client
Usage
import the sdk
>>> import kuksa_viss_client
>>> kuksa_viss_client.__version__
'<your version, e.g. 0.1.7>'
Setup a thread to connect with the kuksa.val
server.
The following properties for the connection can be configured:
ip
default: "127.0.0.1"port
default: 8090insecure
default:False
cacertificate
default: "../kuksa_certificates/CA.pem"certificate
default: "../kuksa_certificates/Client.pem"key
default: "../kuksa_certificates/Client.key"
>>> config = {}
>>> client = kuksa_viss_client.KuksaClientThread(config)
>>>
>>> # Start the client thread to connect with configured server
>>> client.start()
>>>
>>> # Close the connection and stop the client thread
>>> client.stop()
You have the following methods to interactive with the kuksa.val
server:
# Do authorization by passing a jwt token or a token file
def authorize(self, token, timeout = 2)
# Update VISS Tree Entry
def updateVISSTree(self, jsonStr, timeout = 5)
# Update Meta Data of a given path
def updateMetaData(self, path, jsonStr, timeout = 5)
# Get Meta Data of a given path
def getMetaData(self, path, timeout = 1)
# Set value to a given path
def setValue(self, path, value, timeout = 1)
# Get value to a given path
def getValue(self, path, timeout = 5)
# Subscribe value changes of to a given path.
# The given callback function will be called then, if the given path is updated:
# updateMessage = await webSocket.recv()
# callback(updateMessage)
def subscribe(self, path, callback, timeout = 5)
Test client
Using the python sdk, we implemented a command-line test client. When you have installed the kuksa-viss-client package via pip you can run the test client directly by executing
$ kuksa_viss_client
Refer help for further information
VSS Client> help -v
Documented commands (use 'help -v' for verbose/'help <topic>' for details):
Communication Set-up Commands
================================================================================
authorize Authorize the client to interact with the server
connect
disconnect Disconnect from the VSS Server
getServerAddress Gets the IP Address for the VSS Server
setServerAddress Sets the IP Address for the VSS Server
Kuksa Interaction Commands
================================================================================
getMetaData Get MetaData of the path
getValue Get the value of a path
setValue Set the value of a path
updateMetaData Update MetaData of a given path
updateVISSTree Update VISS Tree Entry
Using the testclient, it is also possible to update and extend the VSS data structure. More details can be found here.
Docker
You can build a docker image of the testclient using the Dockerfile
. Not the most effcient way to pack a small python script, but it is easy to get started. The Dockerfile needs to be executed on the parent directory (so it include the needed certificates and pip
package configuration).
To run the builded image:
docker run --rm -it --net=host <image-id-from docker-build>
--rm
ensures we do not keep the docker continer lying aroind after closing the vss-testclient and --net=host
makes sure you can reach locally running kuksa.val-server or kuksa-val docker with port forwarding on the host using the default 127.0.0.1
address.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for kuksa_viss_client-0.1.8-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b35699a90bd629c420d49fb1d1ab01395984fa385f7282c08d1207bfe36bf0e2 |
|
MD5 | 7ffc4388be92909de5d10eb581fd1a2a |
|
BLAKE2b-256 | 4e254273f191c407e943f0b90321345e96fe81f91e5dfe5e37b5df426c54f821 |