CPP based Kuksa client

A pluggable C++ based library to talk to kuksa-databroker based on kuksa-proto v2 API

Supported APIs from proto files

Kuksa v2 API	C++ client status
GetValue	✅
GetValues	✅
Subscribe	✅
SubscribeById	❌
Actuate	✅
BatchActuate	❌
ListMetadata	❌
PublishValue	✅
OpenProviderStream	❌
GetServerInfo	✅

Note

Refer example_v2 for API usage

How to build

This repo contains a justfile to help in setting up and installing dependencies

# Install conan and setup remote
just prepare
# pull in the conan deps
just configure
# build the project
just build

Proto

Proto sources are available in the submodule kuksa-common

Testing

Unit tests are written using GTest and GMock

# build unit tests
just build-with-tests
# run unit tests
just run-unit-tests
# Generate coverage report
just run-coverage

Coverage report is genereated under build/Release/coverage/index.html

Examples

There are two examples provided

• based on kuksa::v1 API example_v1
• based on kuksa::v2 API example_v2

Running examples

just run-example-v2

Debug hints

export GRPC_TRACE=all
export GRPC_VERBOSITY=DEBUG