Add support for BONJOUR query

Author: BenoitMercier

API.md

@@ -169,6 +169,7 @@ The following event_id's are defined:
   * DISCOVER          - Subscribe to user initiated device discovery event  
   * OAUTH             - Subscribe to oauth token authentication data events 
   * WEBHOOK           - Subscribe to webhook data events
+  * BONJOUR           - Subscribe to get responses from the bonjour mdns query
 
 
 The data events will send the specific type of data, when that data changes in PG3.  For example, when the user changes a custom parameter, the CUSTOMPARAMS event will be published with the current (changed) custom parameter data.
@@ -366,6 +367,7 @@ __getValidAddress(address)__ Remove characters that are considered illegal for n
 * __addLogLevel__(name, level, string\_name), Add a new log level to the logger and to the list displayed to the user.  'name' is the level name string (typically all upper case like DEBUG, WARNING, etc.) 'level' is the numeric value of new level, and string_name is the string to display to the user in the log level selector.  <BR> **NOTE** that this modifies the node server log level list which is stored as part of the node server configuration in PG3.  Thus you should only attempt to add items to the list after the config data has been recieved from PG3.  The best place to do this would be in a CONFIG event handler.  <BR>**NOTE2** that there is currently no way to remove or modify an item on the list other than replacing the whole list. See __setLogList()__ below.
 * __setLogList(list)__ Send the list of log levels for the frontend log level list selector. The 'list' is an array of __{display_name:LOGLEVEL}__ objects.  The user will be presented with the 'display_name' and when selected, it will set the log level to LOGLEVEL.  LOGLEVEL must be one of the valid levels supported by the logger or added via the addLevelName method in the logger. (DEPRECATED) <BR>Currently you have to pass all values including default ones to add yours:
 * __webhookResponse(response, status)__ Sends a response to the webhook request
+* __bonjour()__ Sends a request to make a bonjour (mDNS) query on the local network. The response is sent back in a polyglot.BONJOUR event
 
 ```python
         poly.setLogList([

udi_interface/interface.py

@@ -59,7 +59,8 @@ class pub(object):
          'node_server_info',
          'discover',
          'oauth',
-         'webhook'
+         'webhook',
+         'bonjour'
          ]
 
     topics = {}
@@ -187,6 +188,7 @@ class Interface(object):
     DISCOVER          = 18
     OAUTH             = 19
     WEBHOOK           = 20
+    BONJOUR           = 21
 
     """
     Polyglot Interface Class
@@ -343,7 +345,7 @@ def _message(self, mqttc, userdata, msg):
                          'config', 'customdata', 'customparams', 'notices',
                          'getIsyInfo', 'getAll', 'setLogLevel',
                          'customtypeddata', 'customtypedparams', 'getNsInfo',
-                         'discover', 'nsdata', 'setController', 'oauth', 'webhook' ]
+                         'discover', 'nsdata', 'setController', 'oauth', 'webhook', 'bonjour' ]
 
             parsed_msg = json.loads(msg.payload.decode('utf-8'))
             #LOGGER.debug('MQTT Received Message: {}: {}'.format(msg.topic, parsed_msg))
@@ -994,6 +996,8 @@ def _handleInput(self, key, item, published):
             LOGGER.debug('connection status node/driver update')
         elif key == 'webhook':
             pub.publish(self.WEBHOOK, None, item)
+        elif key == 'bonjour':
+            pub.publish(self.BONJOUR, None, item)
 
     def _handleResult(self, result):
         try:
@@ -1493,11 +1497,22 @@ def webhookResponse(self, body='Success', status=200):
         LOGGER.debug('Returning webhook response')
         self.send({'webhook': { 'body': body, 'status': status } }, 'portal')
 
-    def bonjour(self, type, subtype, protocol):
+    """ Node server method to initiate a bonjour query on the network. Response is returned as a polyglot.BONJOUR event  """
+    def bonjour(self, type, subtypes, protocol):
+
+        if type is not None and not isinstance(type, str):
+            raise TypeError('type must be a string')
+
+        if subtypes is not None and not isinstance(subtypes, list):
+            raise TypeError('subtypes must be an array')
+
+        if protocol not in ['tcp', 'udp', None]:
+            raise ValueError('protocol can be either "tcp", "udp"')
+
         message = {
             'bonjour': [{
                 'type': type,
-                'subtype': subtype,
+                'subtypes': subtypes,
                 'protocol': protocol
             }]
         }