Add ability to publish commands to devices by device ID via Meadow.Cloud

[stevenkuhn]

This updates the ability to publish commands to a collection of devices via Meadow.Cloud by including the the ability to specify devices by their device ID. The update command is meadow cloud command publish <COMMAND_NAME> --deviceIds <a list of device ids>. The generated help text for this new command is:

USAGE
  meadow cloud command publish <COMMAND_NAME> [options]

DESCRIPTION
  Publish a command to Meadow devices via the Meadow Service

PARAMETERS
* COMMAND_NAME      The name of the command

OPTIONS
  -c|--collectionId  The target collection for publishing the command
  -d|--deviceIds    The target devices for publishing the command
  -a|--args         The arguments for the command as a JSON string
  -q|--qos          The MQTT-defined quality of service for the command Choices: "AtLeastOnce", "AtMostOnce", "ExactlyOnce". Default: "AtLeastOnce".
  --host            Optionally set a host (default is https://www.meadowcloud.co)
  -h|--help         Shows help text.

With this update, meadow cloud command publish can either take in a collectionId or a list of deviceIds.

Example

An example of this command would be:

C:\>meadow login
Signed in as [email protected]
Done!

C:\>meadow cloud command publish TurnOnWater -d example_device_id1 example_device_id2 -a "{""durationInMinutes"":15}"
Publishing 'TurnOnWater ' command to Meadow.Cloud. Please wait...
Publish command successful.
Done!

If the included arguments are not properly formatted (quotes need to be escaped), a JSON error will occur:

C:\>meadow cloud command publish TurnOnWater -d example_device_id1 example_device_id2 -a "{"duration":15}"
Provided arguments is not valid JSON: 'd' is an invalid start of a property name. Expected a '"'. LineNumber: 0 | BytePositionInLine: 1.
Done!

If neither a collection ID nor device IDs are specified:

C:\>meadow cloud command publish TurnOnWater 
Either a collection ID (-c|--collectionId) or a list of device IDs (-d|--deviceIds) must be specified.

...more...

If both collection ID and device IDs are specified:

C:\>meadow cloud command publish TurnOnWater -c example_collection_id -d example_device_id1 example_device_id2
Cannot specify both a collection ID (-c|--collectionId) and list of device IDs (-d|--deviceIds). Only one is allowed.

...more...

[lamebrain]

nice! 🔥