oaas-sdk2-py 0.2.0

No project description provided

OaaS-SDK2

Python Lib for OaaS-IoT

Prerequisites

• cargo (install via rust)
• oprc-cli cargo install --git https://github.com/pawissanutt/oaas-rs.git oprc-cli
• uv (python package manager)
• docker or podman

Setup

uv sync
./.venv/Scripts/activate
# or
source ./.venv/bin/activate # for Mac or Linux 

Run Example with Docker Compose

docker compose up -d --build
# invoke new function of 'example.hello' class
echo "{}" | oprc-cli i -g http://localhost:10002 example.hello 0 new -p -

TODOs

Features

• read data
• Write data
• Serve gRPC for invocation
• Create an object reference
• Call gRPC to invoke a foreign function
• Implement thread Pool
• Connect to Zenoh
• Device Agent:
  • Invoke a remote function on the referenced object
  • Invoke a local function on the referenced object
    • Need testings!
  • Invoke a local function on device agent from the anywhere else
    • Need testings!
  • Access data from the referenced object
    • Need testings!
• create interface of referenced object
• declare deployment configuration in code

QoL Features

• Improve data encode/decode
• Development CLI
  • generate project
  • setup development environment (e.g., generate docker compose for ODGM)
  • generate YAML class definition from class in Python
  • build project
  • deploy class/object

NOTE

• grpcio vs grpclib

  https://github.com/llucax/python-grpc-benchmark

• There is an error on oneof. We need to remove data validation function on ValData class after the code generation.