General cleanups all around (janitoring) (#63)

* Move tests to device-type specific test files to make improvements more approachable

* protocol: remove the port parameter from query, as there are no other known ports, fix docstrings

* Revise docstrings, remove superfluous information and remove unused methods ({set,get_icon} and set_time)

* cli: indent device output to make it more easily readable when having multiple devices

* remove adjust flake8 ignores (we have no setup.py anymore)

* pyproject: include cli tool to coverage, add config for interrogate (docstring coverage)

* bulb: raise exception on color_temp error cases instead of returning zero values

* improve bulb tests, simplify conftest

* strip: rename plugs property to children and move it to smartdevice

kasa/smartbulb.py

@@ -1,4 +1,4 @@
-"""Module for bulbs."""
+"""Module for bulbs (LB*, KL*, KB*)."""
 import re
 from typing import Any, Dict, Tuple, cast
 
@@ -82,34 +82,21 @@ class SmartBulb(SmartDevice):
     @property  # type: ignore
     @requires_update
     def is_color(self) -> bool:
-        """Whether the bulb supports color changes.
-
-        :return: True if the bulb supports color changes, False otherwise
-        :rtype: bool
-        """
+        """Whether the bulb supports color changes."""
         sys_info = self.sys_info
         return bool(sys_info["is_color"])
 
     @property  # type: ignore
     @requires_update
     def is_dimmable(self) -> bool:
-        """Whether the bulb supports brightness changes.
-
-        :return: True if the bulb supports brightness changes, False otherwise
-        :rtype: bool
-        """
+        """Whether the bulb supports brightness changes."""
         sys_info = self.sys_info
         return bool(sys_info["is_dimmable"])
 
     @property  # type: ignore
     @requires_update
     def is_variable_color_temp(self) -> bool:
-        """Whether the bulb supports color temperature changes.
-
-        :return: True if the bulb supports color temperature changes, False
-        otherwise
-        :rtype: bool
-        """
+        """Whether the bulb supports color temperature changes."""
         sys_info = self.sys_info
         return bool(sys_info["is_variable_color_temp"])
 
@@ -118,16 +105,18 @@ class SmartBulb(SmartDevice):
     def valid_temperature_range(self) -> Tuple[int, int]:
         """Return the device-specific white temperature range (in Kelvin).
 
-        :return: White temperature range in Kelvin (minimun, maximum)
-        :rtype: tuple
+        :return: White temperature range in Kelvin (minimum, maximum)
         """
         if not self.is_variable_color_temp:
-            return (0, 0)
+            raise SmartDeviceException("Color temperature not supported")
         for model, temp_range in TPLINK_KELVIN.items():
             sys_info = self.sys_info
             if re.match(model, sys_info["model"]):
                 return temp_range
-        return (0, 0)
+
+        raise SmartDeviceException(
+            "Unknown color temperature range, please open an issue on github"
+        )
 
     @property  # type: ignore
     @requires_update
@@ -166,7 +155,6 @@ class SmartBulb(SmartDevice):
         """Return the current HSV state of the bulb.
 
         :return: hue, saturation and value (degrees, %, %)
-        :rtype: tuple
         """
         if not self.is_color:
             raise SmartDeviceException("Bulb does not support color.")
@@ -220,11 +208,7 @@ class SmartBulb(SmartDevice):
     @property  # type: ignore
     @requires_update
     def color_temp(self) -> int:
-        """Return color temperature of the device.
-
-        :return: Color temperature in Kelvin
-        :rtype: int
-        """
+        """Return color temperature of the device in kelvin."""
         if not self.is_variable_color_temp:
             raise SmartDeviceException("Bulb does not support colortemp.")
 
@@ -233,10 +217,7 @@ class SmartBulb(SmartDevice):
 
     @requires_update
     async def set_color_temp(self, temp: int) -> None:
-        """Set the color temperature of the device.
-
-        :param int temp: The new color temperature, in Kelvin
-        """
+        """Set the color temperature of the device in kelvin."""
         if not self.is_variable_color_temp:
             raise SmartDeviceException("Bulb does not support colortemp.")
 
@@ -253,11 +234,7 @@ class SmartBulb(SmartDevice):
     @property  # type: ignore
     @requires_update
     def brightness(self) -> int:
-        """Return the current brightness.
-
-        :return: brightness in percent
-        :rtype: int
-        """
+        """Return the current brightness in percentage."""
         if not self.is_dimmable:  # pragma: no cover
             raise SmartDeviceException("Bulb is not dimmable.")
 
@@ -266,10 +243,7 @@ class SmartBulb(SmartDevice):
 
     @requires_update
     async def set_brightness(self, brightness: int) -> None:
-        """Set the brightness.
-
-        :param int brightness: brightness in percent
-        """
+        """Set the brightness in percentage."""
         if not self.is_dimmable:  # pragma: no cover
             raise SmartDeviceException("Bulb is not dimmable.")
 
@@ -281,11 +255,7 @@ class SmartBulb(SmartDevice):
     @property  # type: ignore
     @requires_update
     def state_information(self) -> Dict[str, Any]:
-        """Return bulb-specific state information.
-
-        :return: Bulb information dict, keys in user-presentable form.
-        :rtype: dict
-        """
+        """Return bulb-specific state information."""
         info: Dict[str, Any] = {
             "Brightness": self.brightness,
             "Is dimmable": self.is_dimmable,