Discover refactoring, enhancements to the cli tool (#71)

* Discover refactoring, enhancements to the cli tool

* Discover tries to detect the type of the device from sysinfo response
* Discover.discover() returns an IP address keyed dictionary,
  values are initialized instances of the automatically detected device type.

* When no IP is given, autodetect all supported devices and print out their states
* When only IP but no type is given, autodetect type and make a call based on that information.
  * One can define --bulb or --plug to skip the detection.

* renamed pyHS100.py -> smartdevice.py

* SmartPlugException -> SmartDeviceException in comments

* fix mic_type check

* make time() return None on failure as we don't know which devices support getting the time and it's used in the cli tool

* hw_info: check if key exists before accessing it, add mic_mac and mic_type

* Check for mic_mac on mac, based on work by kdschloesser on issue #59

* make hound happy, __init__ on SmartDevice cannot error out so removing 'raises' documentation

pyHS100/discover.py

@@ -0,0 +1,68 @@
+import socket
+import logging
+import json
+
+from pyHS100 import TPLinkSmartHomeProtocol, SmartPlug, SmartBulb
+
+_LOGGER = logging.getLogger(__name__)
+
+
+class Discover:
+    @staticmethod
+    def discover(protocol=None, port=9999, timeout=3):
+        """
+        Sends discovery message to 255.255.255.255:9999 in order
+        to detect available supported devices in the local network,
+        and waits for given timeout for answers from devices.
+
+        :param timeout: How long to wait for responses, defaults to 5
+        :param port: port to send broadcast messages, defaults to 9999.
+        :rtype: dict
+        :return: Array of json objects {"ip", "port", "sys_info"}
+        """
+        if protocol is None:
+            protocol = TPLinkSmartHomeProtocol()
+
+        discovery_query = {"system": {"get_sysinfo": None},
+                           "emeter": {"get_realtime": None}}
+        target = "255.255.255.255"
+
+        sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+        sock.setsockopt(socket.SOL_SOCKET, socket.SO_BROADCAST, 1)
+        sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
+        sock.settimeout(timeout)
+
+        req = json.dumps(discovery_query)
+        _LOGGER.debug("Sending discovery to %s:%s", target, port)
+
+        encrypted_req = protocol.encrypt(req)
+        sock.sendto(encrypted_req[4:], (target, port))
+
+        devices = {}
+        _LOGGER.debug("Waiting %s seconds for responses...", timeout)
+
+        try:
+            while True:
+                data, addr = sock.recvfrom(4096)
+                ip, port = addr
+                info = json.loads(protocol.decrypt(data))
+                if "system" in info and "get_sysinfo" in info["system"]:
+                    sysinfo = info["system"]["get_sysinfo"]
+                    if "type" in sysinfo:
+                        type = sysinfo["type"]
+                    elif "mic_type" in sysinfo:
+                        type = sysinfo["mic_type"]
+                    else:
+                        _LOGGER.error("Unable to find the device type field!")
+                        type = "UNKNOWN"
+                else:
+                    _LOGGER.error("No 'system' nor 'get_sysinfo' in response")
+                if "smartplug" in type.lower():
+                    devices[ip] = SmartPlug(ip)
+                elif "smartbulb" in type.lower():
+                    devices[ip] = SmartBulb(ip)
+        except socket.timeout:
+            _LOGGER.debug("Got socket timeout, which is okay.")
+        except Exception as ex:
+            _LOGGER.error("Got exception %s", ex, exc_info=True)
+        return devices