Merge branch 'pep257-scene-mqtt' into dev

homeassistant/components/rollershutter/__init__.py

@@ -1,7 +1,5 @@
 """
-homeassistant.components.rollershutter
+Support for Roller shutters.
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Rollershutter component.
 
 For more details about this platform, please refer to the documentation at
 https://home-assistant.io/components/rollershutter/
@@ -36,7 +34,7 @@ ATTR_CURRENT_POSITION = 'current_position'
 
 
 def is_open(hass, entity_id=None):
-    """ Returns if the rollershutter is open based on the statemachine. """
+    """Return if the roller shutter is open based on the statemachine."""
     entity_id = entity_id or ENTITY_ID_ALL_ROLLERSHUTTERS
     return hass.states.is_state(entity_id, STATE_OPEN)
 
@@ -54,7 +52,7 @@ def move_down(hass, entity_id=None):
 
 
 def stop(hass, entity_id=None):
-    """ Stops all or specified rollershutter. """
+    """Stop all or specified roller shutter."""
     data = {ATTR_ENTITY_ID: entity_id} if entity_id else None
     hass.services.call(DOMAIN, SERVICE_STOP, data)
 
@@ -67,7 +65,7 @@ def setup(hass, config):
     component.setup(config)
 
     def handle_rollershutter_service(service):
-        """ Handles calls to the rollershutter services. """
+        """Handle calls to the roller shutter services."""
         target_rollershutters = component.extract_from_service(service)
 
         for rollershutter in target_rollershutters:
@@ -98,20 +96,20 @@ def setup(hass, config):
 
 
 class RollershutterDevice(Entity):
-    """ Represents a rollershutter within Home Assistant. """
+    """Representation a rollers hutter."""
-    # pylint: disable=no-self-use
 
+    # pylint: disable=no-self-use
     @property
     def current_position(self):
-        """
+        """Return current position of roller shutter.
-        Return current position of rollershutter.
+
         None is unknown, 0 is closed, 100 is fully open.
         """
         raise NotImplementedError()
 
     @property
     def state(self):
-        """ Returns the state of the rollershutter. """
+        """Return the state of the roller shutter."""
         current = self.current_position
 
         if current is None:

homeassistant/components/rollershutter/command_line.py

@@ -16,7 +16,6 @@ _LOGGER = logging.getLogger(__name__)
 
 def setup_platform(hass, config, add_devices_callback, discovery_info=None):
     """Setup roller shutter controlled by shell commands."""
-
     rollershutters = config.get('rollershutters', {})
     devices = []
 
@@ -35,15 +34,15 @@ def setup_platform(hass, config, add_devices_callback, discovery_info=None):
 
 # pylint: disable=too-many-arguments, too-many-instance-attributes
 class CommandRollershutter(RollershutterDevice):
-    """ Represents a rollershutter -  can be controlled using shell cmd. """
+    """Representation a command line roller shutter."""
 
     # pylint: disable=too-many-arguments
     def __init__(self, hass, name, command_up, command_down, command_stop,
                  command_state, value_template):
-
+        """Initialize the roller shutter."""
         self._hass = hass
         self._name = name
-        self._state = None  # Unknown
+        self._state = None
         self._command_up = command_up
         self._command_down = command_down
         self._command_stop = command_stop
@@ -75,24 +74,24 @@ class CommandRollershutter(RollershutterDevice):
 
     @property
     def should_poll(self):
-        """ Only poll if we have statecmd. """
+        """Only poll if we have state command."""
         return self._command_state is not None
 
     @property
     def name(self):
-        """ The name of the rollershutter. """
+        """Return the name of the roller shutter."""
         return self._name
 
     @property
     def current_position(self):
-        """
+        """Return current position of roller shutter.
-        Return current position of rollershutter.
+
         None is unknown, 0 is closed, 100 is fully open.
         """
         return self._state
 
     def _query_state(self):
-        """ Query for state. """
+        """Query for the state."""
         if not self._command_state:
             _LOGGER.error('No state command specified')
             return

homeassistant/components/rollershutter/demo.py

@@ -18,9 +18,11 @@ def setup_platform(hass, config, add_devices, discovery_info=None):
 
 
 class DemoRollershutter(RollershutterDevice):
-    """Represents a roller shutter."""
+    """Representation of a demo roller shutter."""
+
     # pylint: disable=no-self-use
     def __init__(self, hass, name, position):
+        """Initialize the roller shutter."""
         self.hass = hass
         self._name = name
         self._position = position
@@ -29,7 +31,7 @@ class DemoRollershutter(RollershutterDevice):
 
     @property
     def name(self):
-        """Returns the name of the roller shutter."""
+        """Return the name of the roller shutter."""
         return self._name
 
     @property
@@ -59,7 +61,7 @@ class DemoRollershutter(RollershutterDevice):
         self._moving_up = False
 
     def stop(self, **kwargs):
-        """Stops the roller shutter."""
+        """Stop the roller shutter."""
         if self._listener is not None:
             self.hass.bus.remove_listener(EVENT_TIME_CHANGED, self._listener)
             self._listener = None

homeassistant/components/rollershutter/mqtt.py

@@ -24,7 +24,6 @@ DEFAULT_PAYLOAD_STOP = "STOP"
 
 def setup_platform(hass, config, add_devices_callback, discovery_info=None):
     """Add MQTT Rollershutter."""
-
     if config.get('command_topic') is None:
         _LOGGER.error("Missing required variable: command_topic")
         return False
@@ -43,9 +42,11 @@ def setup_platform(hass, config, add_devices_callback, discovery_info=None):
 
 # pylint: disable=too-many-arguments, too-many-instance-attributes
 class MqttRollershutter(RollershutterDevice):
-    """Represents a rollershutter that can be controlled using MQTT."""
+    """Representation of a roller shutter that can be controlled using MQTT."""
+
     def __init__(self, hass, name, state_topic, command_topic, qos,
                  payload_up, payload_down, payload_stop, value_template):
+        """Initialize the roller shutter."""
         self._state = None
         self._hass = hass
         self._name = name
@@ -80,13 +81,13 @@ class MqttRollershutter(RollershutterDevice):
 
     @property
     def name(self):
-        """The name of the rollershutter."""
+        """Return the name of the roller shutter."""
         return self._name
 
     @property
     def current_position(self):
-        """
+        """Return current position of roller shutter.
-        Return current position of rollershutter.
+
         None is unknown, 0 is closed, 100 is fully open.
         """
         return self._state

homeassistant/components/rollershutter/scsgate.py

@@ -1,7 +1,5 @@
 """
-homeassistant.components.rollershutter.scsgate
+Allow to configure a SCSGate roller shutter.
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Allows to configure a SCSGate rollershutter.
 
 For more details about this platform, please refer to the documentation at
 https://home-assistant.io/components/rollershutter.scsgate/
@@ -15,8 +13,7 @@ DEPENDENCIES = ['scsgate']
 
 
 def setup_platform(hass, config, add_devices_callback, discovery_info=None):
-    """ Add the SCSGate swiches defined inside of the configuration file. """
+    """Setup the SCSGate roller shutter."""
-
     devices = config.get('devices')
     rollershutters = []
     logger = logging.getLogger(__name__)
@@ -42,31 +39,33 @@ def setup_platform(hass, config, add_devices_callback, discovery_info=None):
 
 # pylint: disable=too-many-arguments, too-many-instance-attributes
 class SCSGateRollerShutter(RollershutterDevice):
-    """ Represents a rollershutter that can be controlled using SCSGate. """
+    """Representation of SCSGate rollershutter."""
+
     def __init__(self, scs_id, name, logger):
+        """Initialize the roller shutter."""
         self._scs_id = scs_id
         self._name = name
         self._logger = logger
 
     @property
     def scs_id(self):
-        """ SCSGate ID """
+        """Return the SCSGate ID."""
         return self._scs_id
 
     @property
     def should_poll(self):
-        """ No polling needed """
+        """No polling needed."""
         return False
 
     @property
     def name(self):
-        """ The name of the rollershutter. """
+        """Return the name of the roller shutter."""
         return self._name
 
     @property
     def current_position(self):
-        """
+        """Return current position of roller shutter.
-        Return current position of rollershutter.
+
         None is unknown, 0 is closed, 100 is fully open.
         """
         return None
@@ -92,7 +91,7 @@ class SCSGateRollerShutter(RollershutterDevice):
         scsgate.SCSGATE.append_task(HaltRollerShutterTask(target=self._scs_id))
 
     def process_event(self, message):
-        """ Handle a SCSGate message related with this rollershutter """
+        """Handle a SCSGate message related with this roller shutter."""
         self._logger.debug(
             "Rollershutter %s, got message %s",
             self._scs_id, message.toggled)

homeassistant/components/scene/__init__.py

@@ -1,7 +1,5 @@
 """
-homeassistant.components.scene
+Allow users to set and activate scenes.
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Allows users to set and activate scenes.
 
 For more details about this component, please refer to the documentation at
 https://home-assistant.io/components/scene/
@@ -35,8 +33,7 @@ def activate(hass, entity_id=None):
 
 
 def setup(hass, config):
-    """ Sets up scenes. """
+    """Setup the scenes."""
-
     logger = logging.getLogger(__name__)
 
     # You are not allowed to mutate the original config so make a copy
@@ -58,7 +55,7 @@ def setup(hass, config):
     component.setup(config)
 
     def handle_scene_service(service):
-        """ Handles calls to the switch services. """
+        """Handle calls to the switch services."""
         target_scenes = component.extract_from_service(service)
 
         for scene in target_scenes:
@@ -74,12 +71,14 @@ class Scene(Entity):
 
     @property
     def should_poll(self):
+        """No polling needed."""
         return False
 
     @property
     def state(self):
+        """Return the state."""
         return STATE
 
     def activate(self):
-        """ Activates scene. Tries to get entities into requested state. """
+        """Activate scene. Tries to get entities into requested state."""
         raise NotImplementedError

homeassistant/components/scene/homeassistant.py

@@ -1,6 +1,4 @@
 """
-homeassistant.components.scene
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 Allows users to set and activate scenes.
 
 For more details about this component, please refer to the documentation at
@@ -24,7 +22,7 @@ SceneConfig = namedtuple('SceneConfig', ['name', 'states'])
 
 # pylint: disable=unused-argument
 def setup_platform(hass, config, add_devices, discovery_info=None):
-    """ Sets up home assistant scene entries. """
+    """Setup home assistant scene entries."""
     scene_config = config.get("states")
 
     if not isinstance(scene_config, list):
@@ -68,20 +66,22 @@ class HomeAssistantScene(Scene):
     """A scene is a group of entities and the states we want them to be."""
 
     def __init__(self, hass, scene_config):
+        """Initialize the scene."""
         self.hass = hass
         self.scene_config = scene_config
 
     @property
     def name(self):
+        """Return the name of the scene."""
         return self.scene_config.name
 
     @property
     def device_state_attributes(self):
-        """ Scene state attributes. """
+        """Return the scene state attributes."""
         return {
             ATTR_ENTITY_ID: list(self.scene_config.states.keys()),
         }
 
     def activate(self):
-        """ Activates scene. Tries to get entities into requested state. """
+        """Activate scene. Tries to get entities into requested state."""
         reproduce_state(self.hass, self.scene_config.states.values(), True)