cremalink.transports.cloud.transport module

This module provides the CloudTransport class, which handles communication with a coffee machine via the manufacturer’s cloud API (Ayla Networks).

class cremalink.transports.cloud.transport.CloudTransport(dsn: str, access_token: str, device_map_path: str | None = None)

Bases: DeviceTransport

A transport for communicating with a device via the cloud API.

This transport interacts directly with the Ayla cloud service endpoints, using a short-lived access token for authentication. Upon initialization, it fetches key device metadata from the cloud and stores it.

configure() → None

Configuration is handled during __init__, so this is a no-op.

get_monitor() → Any

Fetches, parses, and returns the device’s monitoring status.

This works by fetching the specific ‘monitor’ property, extracting its base64 value, and then decoding it into a structured snapshot.

get_properties() → Any

Fetches all properties for the device from the cloud API.

get_property(name: str) → Any

Fetches a single, specific property by name.

health() → Any

Returns the device’s online status as determined during initialization. This does not perform a live health check.

refresh_monitor() → Any

The cloud API does not provide a direct way to force a monitor refresh. This method is a no-op.

send_command(command: str) → Any

Sends a command to the device by creating a new ‘datapoint’ via the cloud API.

set_mappings(command_map: dict[str, Any], property_map: dict[str, Any]) → None

Stores the provided command and property maps on the instance.