From 0490ca67d14cf43200b9fde3ae3805ba9aaa6238 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Fri, 10 Nov 2017 18:25:31 +0100 Subject: [PATCH 001/246] Bump dev to 0.58.0.dev0 (#10510) --- homeassistant/const.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/homeassistant/const.py b/homeassistant/const.py index bff2adae969..de3f60e825f 100644 --- a/homeassistant/const.py +++ b/homeassistant/const.py @@ -1,7 +1,7 @@ # coding: utf-8 """Constants used by Home Assistant components.""" MAJOR_VERSION = 0 -MINOR_VERSION = 57 +MINOR_VERSION = 58 PATCH_VERSION = '0.dev0' __short_version__ = '{}.{}'.format(MAJOR_VERSION, MINOR_VERSION) __version__ = '{}.{}'.format(__short_version__, PATCH_VERSION) From 7d9d299d5a7112a1265d1cdda934dc68c1965110 Mon Sep 17 00:00:00 2001 From: Eric Hagan Date: Fri, 10 Nov 2017 11:29:21 -0600 Subject: [PATCH 002/246] OwnTracks Message Handling (#10489) * Improve handling and logging of unsupported owntracks message types Added generic handlers for message types that are valid but not supported by the HA component (lwt, beacon, etc.) and for message types which are invalid. Valid but not supported messages will now be logged as DEBUG. Invalid messages will be logged as WARNING. Supporting single "waypoint" messages in addition to the roll-up "waypoints" messages. Added tests around these features. * Style fixes --- .../components/device_tracker/owntracks.py | 71 +++++++++++------- .../device_tracker/test_owntracks.py | 73 ++++++++++++++++--- 2 files changed, 107 insertions(+), 37 deletions(-) diff --git a/homeassistant/components/device_tracker/owntracks.py b/homeassistant/components/device_tracker/owntracks.py index 77241e1a8ab..0c869dd4b57 100644 --- a/homeassistant/components/device_tracker/owntracks.py +++ b/homeassistant/components/device_tracker/owntracks.py @@ -367,6 +367,29 @@ def async_handle_transition_message(hass, context, message): message['event']) +@asyncio.coroutine +def async_handle_waypoint(hass, name_base, waypoint): + """Handle a waypoint.""" + name = waypoint['desc'] + pretty_name = '{} - {}'.format(name_base, name) + lat = waypoint['lat'] + lon = waypoint['lon'] + rad = waypoint['rad'] + + # check zone exists + entity_id = zone_comp.ENTITY_ID_FORMAT.format(slugify(pretty_name)) + + # Check if state already exists + if hass.states.get(entity_id) is not None: + return + + zone = zone_comp.Zone(hass, pretty_name, lat, lon, rad, + zone_comp.ICON_IMPORT, False) + zone.entity_id = entity_id + yield from zone.async_update_ha_state() + + +@HANDLERS.register('waypoint') @HANDLERS.register('waypoints') @asyncio.coroutine def async_handle_waypoints_message(hass, context, message): @@ -380,30 +403,17 @@ def async_handle_waypoints_message(hass, context, message): if user not in context.waypoint_whitelist: return - wayps = message['waypoints'] + if 'waypoints' in message: + wayps = message['waypoints'] + else: + wayps = [message] _LOGGER.info("Got %d waypoints from %s", len(wayps), message['topic']) name_base = ' '.join(_parse_topic(message['topic'])) for wayp in wayps: - name = wayp['desc'] - pretty_name = '{} - {}'.format(name_base, name) - lat = wayp['lat'] - lon = wayp['lon'] - rad = wayp['rad'] - - # check zone exists - entity_id = zone_comp.ENTITY_ID_FORMAT.format(slugify(pretty_name)) - - # Check if state already exists - if hass.states.get(entity_id) is not None: - continue - - zone = zone_comp.Zone(hass, pretty_name, lat, lon, rad, - zone_comp.ICON_IMPORT, False) - zone.entity_id = entity_id - yield from zone.async_update_ha_state() + yield from async_handle_waypoint(hass, name_base, wayp) @HANDLERS.register('encrypted') @@ -423,10 +433,22 @@ def async_handle_encrypted_message(hass, context, message): @HANDLERS.register('lwt') +@HANDLERS.register('configuration') +@HANDLERS.register('beacon') +@HANDLERS.register('cmd') +@HANDLERS.register('steps') +@HANDLERS.register('card') @asyncio.coroutine -def async_handle_lwt_message(hass, context, message): - """Handle an lwt message.""" - _LOGGER.debug('Not handling lwt message: %s', message) +def async_handle_not_impl_msg(hass, context, message): + """Handle valid but not implemented message types.""" + _LOGGER.debug('Not handling %s message: %s', message.get("_type"), message) + + +@asyncio.coroutine +def async_handle_unsupported_msg(hass, context, message): + """Handle an unsupported or invalid message type.""" + _LOGGER.warning('Received unsupported message type: %s.', + message.get('_type')) @asyncio.coroutine @@ -434,11 +456,6 @@ def async_handle_message(hass, context, message): """Handle an OwnTracks message.""" msgtype = message.get('_type') - handler = HANDLERS.get(msgtype) - - if handler is None: - _LOGGER.warning( - 'Received unsupported message type: %s.', msgtype) - return + handler = HANDLERS.get(msgtype, async_handle_unsupported_msg) yield from handler(hass, context, message) diff --git a/tests/components/device_tracker/test_owntracks.py b/tests/components/device_tracker/test_owntracks.py index a06adcb286a..4f5efb9d09d 100644 --- a/tests/components/device_tracker/test_owntracks.py +++ b/tests/components/device_tracker/test_owntracks.py @@ -18,10 +18,13 @@ DEVICE = 'phone' LOCATION_TOPIC = 'owntracks/{}/{}'.format(USER, DEVICE) EVENT_TOPIC = 'owntracks/{}/{}/event'.format(USER, DEVICE) -WAYPOINT_TOPIC = 'owntracks/{}/{}/waypoints'.format(USER, DEVICE) +WAYPOINTS_TOPIC = 'owntracks/{}/{}/waypoints'.format(USER, DEVICE) +WAYPOINT_TOPIC = 'owntracks/{}/{}/waypoint'.format(USER, DEVICE) USER_BLACKLIST = 'ram' -WAYPOINT_TOPIC_BLOCKED = 'owntracks/{}/{}/waypoints'.format( +WAYPOINTS_TOPIC_BLOCKED = 'owntracks/{}/{}/waypoints'.format( USER_BLACKLIST, DEVICE) +LWT_TOPIC = 'owntracks/{}/{}/lwt'.format(USER, DEVICE) +BAD_TOPIC = 'owntracks/{}/{}/unsupported'.format(USER, DEVICE) DEVICE_TRACKER_STATE = 'device_tracker.{}_{}'.format(USER, DEVICE) @@ -232,6 +235,15 @@ WAYPOINTS_UPDATED_MESSAGE = { ] } +WAYPOINT_MESSAGE = { + "_type": "waypoint", + "tst": 4, + "lat": 9, + "lon": 47, + "rad": 50, + "desc": "exp_wayp1" +} + WAYPOINT_ENTITY_NAMES = [ 'zone.greg_phone__exp_wayp1', 'zone.greg_phone__exp_wayp2', @@ -239,10 +251,26 @@ WAYPOINT_ENTITY_NAMES = [ 'zone.ram_phone__exp_wayp2', ] +LWT_MESSAGE = { + "_type": "lwt", + "tst": 1 +} + +BAD_MESSAGE = { + "_type": "unsupported", + "tst": 1 +} + BAD_JSON_PREFIX = '--$this is bad json#--' BAD_JSON_SUFFIX = '** and it ends here ^^' +# def raise_on_not_implemented(hass, context, message): +def raise_on_not_implemented(): + """Throw NotImplemented.""" + raise NotImplementedError("oopsie") + + class BaseMQTT(unittest.TestCase): """Base MQTT assert functions.""" @@ -1056,7 +1084,7 @@ class TestDeviceTrackerOwnTracks(BaseMQTT): def test_waypoint_import_simple(self): """Test a simple import of list of waypoints.""" waypoints_message = WAYPOINTS_EXPORTED_MESSAGE.copy() - self.send_message(WAYPOINT_TOPIC, waypoints_message) + self.send_message(WAYPOINTS_TOPIC, waypoints_message) # Check if it made it into states wayp = self.hass.states.get(WAYPOINT_ENTITY_NAMES[0]) self.assertTrue(wayp is not None) @@ -1066,7 +1094,7 @@ class TestDeviceTrackerOwnTracks(BaseMQTT): def test_waypoint_import_blacklist(self): """Test import of list of waypoints for blacklisted user.""" waypoints_message = WAYPOINTS_EXPORTED_MESSAGE.copy() - self.send_message(WAYPOINT_TOPIC_BLOCKED, waypoints_message) + self.send_message(WAYPOINTS_TOPIC_BLOCKED, waypoints_message) # Check if it made it into states wayp = self.hass.states.get(WAYPOINT_ENTITY_NAMES[2]) self.assertTrue(wayp is None) @@ -1088,7 +1116,7 @@ class TestDeviceTrackerOwnTracks(BaseMQTT): run_coroutine_threadsafe(owntracks.async_setup_scanner( self.hass, test_config, mock_see), self.hass.loop).result() waypoints_message = WAYPOINTS_EXPORTED_MESSAGE.copy() - self.send_message(WAYPOINT_TOPIC_BLOCKED, waypoints_message) + self.send_message(WAYPOINTS_TOPIC_BLOCKED, waypoints_message) # Check if it made it into states wayp = self.hass.states.get(WAYPOINT_ENTITY_NAMES[2]) self.assertTrue(wayp is not None) @@ -1098,7 +1126,7 @@ class TestDeviceTrackerOwnTracks(BaseMQTT): def test_waypoint_import_bad_json(self): """Test importing a bad JSON payload.""" waypoints_message = WAYPOINTS_EXPORTED_MESSAGE.copy() - self.send_message(WAYPOINT_TOPIC, waypoints_message, True) + self.send_message(WAYPOINTS_TOPIC, waypoints_message, True) # Check if it made it into states wayp = self.hass.states.get(WAYPOINT_ENTITY_NAMES[2]) self.assertTrue(wayp is None) @@ -1108,15 +1136,40 @@ class TestDeviceTrackerOwnTracks(BaseMQTT): def test_waypoint_import_existing(self): """Test importing a zone that exists.""" waypoints_message = WAYPOINTS_EXPORTED_MESSAGE.copy() - self.send_message(WAYPOINT_TOPIC, waypoints_message) + self.send_message(WAYPOINTS_TOPIC, waypoints_message) # Get the first waypoint exported wayp = self.hass.states.get(WAYPOINT_ENTITY_NAMES[0]) # Send an update waypoints_message = WAYPOINTS_UPDATED_MESSAGE.copy() - self.send_message(WAYPOINT_TOPIC, waypoints_message) + self.send_message(WAYPOINTS_TOPIC, waypoints_message) new_wayp = self.hass.states.get(WAYPOINT_ENTITY_NAMES[0]) self.assertTrue(wayp == new_wayp) + def test_single_waypoint_import(self): + """Test single waypoint message.""" + waypoint_message = WAYPOINT_MESSAGE.copy() + self.send_message(WAYPOINT_TOPIC, waypoint_message) + wayp = self.hass.states.get(WAYPOINT_ENTITY_NAMES[0]) + self.assertTrue(wayp is not None) + + def test_not_implemented_message(self): + """Handle not implemented message type.""" + patch_handler = patch('homeassistant.components.device_tracker.' + 'owntracks.async_handle_not_impl_msg', + return_value=mock_coro(False)) + patch_handler.start() + self.assertFalse(self.send_message(LWT_TOPIC, LWT_MESSAGE)) + patch_handler.stop() + + def test_unsupported_message(self): + """Handle not implemented message type.""" + patch_handler = patch('homeassistant.components.device_tracker.' + 'owntracks.async_handle_unsupported_msg', + return_value=mock_coro(False)) + patch_handler.start() + self.assertFalse(self.send_message(BAD_TOPIC, BAD_MESSAGE)) + patch_handler.stop() + def generate_ciphers(secret): """Generate test ciphers for the DEFAULT_LOCATION_MESSAGE.""" @@ -1143,7 +1196,7 @@ def generate_ciphers(secret): json.dumps(DEFAULT_LOCATION_MESSAGE).encode("utf-8")) ) ).decode("utf-8") - return (ctxt, mctxt) + return ctxt, mctxt TEST_SECRET_KEY = 's3cretkey' @@ -1172,7 +1225,7 @@ def mock_cipher(): if key != mkey: raise ValueError() return plaintext - return (len(TEST_SECRET_KEY), mock_decrypt) + return len(TEST_SECRET_KEY), mock_decrypt class TestDeviceTrackerOwnTrackConfigs(BaseMQTT): From 16dd90ac78b6196dee5c7bd952b3760c3bfdd682 Mon Sep 17 00:00:00 2001 From: Kenny Millington Date: Fri, 10 Nov 2017 17:35:57 +0000 Subject: [PATCH 003/246] Add support for Alexa intent slot synonyms. (#10469) --- homeassistant/components/alexa/intent.py | 20 +++- tests/components/alexa/test_intent.py | 128 ++++++++++++++++++++++- 2 files changed, 146 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/alexa/intent.py b/homeassistant/components/alexa/intent.py index a0d0062414d..56887a8a701 100644 --- a/homeassistant/components/alexa/intent.py +++ b/homeassistant/components/alexa/intent.py @@ -138,10 +138,28 @@ class AlexaResponse(object): # Intent is None if request was a LaunchRequest or SessionEndedRequest if intent_info is not None: for key, value in intent_info.get('slots', {}).items(): + underscored_key = key.replace('.', '_') + if 'value' in value: - underscored_key = key.replace('.', '_') self.variables[underscored_key] = value['value'] + if 'resolutions' in value: + self._populate_resolved_values(underscored_key, value) + + def _populate_resolved_values(self, underscored_key, value): + for resolution in value['resolutions']['resolutionsPerAuthority']: + if 'values' not in resolution: + continue + + for resolved in resolution['values']: + if 'value' not in resolved: + continue + + if 'id' in resolved['value']: + self.variables[underscored_key] = resolved['value']['id'] + elif 'name' in resolved['value']: + self.variables[underscored_key] = resolved['value']['name'] + def add_card(self, card_type, title, content): """Add a card to the response.""" assert self.card is None diff --git a/tests/components/alexa/test_intent.py b/tests/components/alexa/test_intent.py index 565ebec64aa..19ecf852622 100644 --- a/tests/components/alexa/test_intent.py +++ b/tests/components/alexa/test_intent.py @@ -13,6 +13,7 @@ from homeassistant.components.alexa import intent SESSION_ID = "amzn1.echo-api.session.0000000-0000-0000-0000-00000000000" APPLICATION_ID = "amzn1.echo-sdk-ams.app.000000-d0ed-0000-ad00-000000d00ebe" REQUEST_ID = "amzn1.echo-api.request.0000000-0000-0000-0000-00000000000" +AUTHORITY_ID = "amzn1.er-authority.000000-d0ed-0000-ad00-000000d00ebe.ZODIAC" # pylint: disable=invalid-name calls = [] @@ -90,7 +91,7 @@ def alexa_client(loop, hass, test_client): "type": "plain", "text": "LaunchRequest has been received.", } - } + }, } })) return loop.run_until_complete(test_client(hass.http.app)) @@ -207,6 +208,131 @@ def test_intent_request_with_slots(alexa_client): assert text == "You told us your sign is virgo." +@asyncio.coroutine +def test_intent_request_with_slots_and_id_resolution(alexa_client): + """Test a request with slots and an id synonym.""" + data = { + "version": "1.0", + "session": { + "new": False, + "sessionId": SESSION_ID, + "application": { + "applicationId": APPLICATION_ID + }, + "attributes": { + "supportedHoroscopePeriods": { + "daily": True, + "weekly": False, + "monthly": False + } + }, + "user": { + "userId": "amzn1.account.AM3B00000000000000000000000" + } + }, + "request": { + "type": "IntentRequest", + "requestId": REQUEST_ID, + "timestamp": "2015-05-13T12:34:56Z", + "intent": { + "name": "GetZodiacHoroscopeIntent", + "slots": { + "ZodiacSign": { + "name": "ZodiacSign", + "value": "virgo", + "resolutions": { + "resolutionsPerAuthority": [ + { + "authority": AUTHORITY_ID, + "status": { + "code": "ER_SUCCESS_MATCH" + }, + "values": [ + { + "value": { + "name": "Virgo", + "id": "VIRGO" + } + } + ] + } + ] + } + } + } + } + } + } + req = yield from _intent_req(alexa_client, data) + assert req.status == 200 + data = yield from req.json() + text = data.get("response", {}).get("outputSpeech", + {}).get("text") + assert text == "You told us your sign is VIRGO." + + +@asyncio.coroutine +def test_intent_request_with_slots_and_name_resolution(alexa_client): + """Test a request with slots and a name synonym.""" + data = { + "version": "1.0", + "session": { + "new": False, + "sessionId": SESSION_ID, + "application": { + "applicationId": APPLICATION_ID + }, + "attributes": { + "supportedHoroscopePeriods": { + "daily": True, + "weekly": False, + "monthly": False + } + }, + "user": { + "userId": "amzn1.account.AM3B00000000000000000000000" + } + }, + "request": { + "type": "IntentRequest", + "requestId": REQUEST_ID, + "timestamp": "2015-05-13T12:34:56Z", + "intent": { + "name": "GetZodiacHoroscopeIntent", + "slots": { + "ZodiacSign": { + "name": "ZodiacSign", + "value": "virgo", + "resolutions": { + "resolutionsPerAuthority": [ + { + "authority": AUTHORITY_ID, + "status": { + "code": "ER_SUCCESS_MATCH" + }, + "values": [ + { + "value": { + "name": "Virgo" + } + } + ] + } + ] + } + } + } + } + } + } + req = yield from _intent_req(alexa_client, data) + assert req.status == 200 + data = yield from req.json() + text = data.get("response", {}).get("outputSpeech", + {}).get("text") + assert text == "You told us your sign is Virgo." + + @asyncio.coroutine def test_intent_request_with_slots_but_no_value(alexa_client): """Test a request with slots but no value.""" From 1c36e2f586c0e08845ad48279cea42fbab38c123 Mon Sep 17 00:00:00 2001 From: Jan Almeroth Date: Fri, 10 Nov 2017 23:41:02 +0100 Subject: [PATCH 004/246] Introduce media progress for Yamaha Musiccast devices (#10256) * Introduce update_hass() * Introduce media_positions * Version bump pymusiccast * Fix: Unnecessary "else" after "return" * FIX D400: First line should end with a period * Version bump Fixes https://github.com/home-assistant/home-assistant/issues/10411 --- .../media_player/yamaha_musiccast.py | 34 +++++++++++++++++-- requirements_all.txt | 2 +- 2 files changed, 33 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/media_player/yamaha_musiccast.py b/homeassistant/components/media_player/yamaha_musiccast.py index 27efc4f3814..bfcffff6bb4 100644 --- a/homeassistant/components/media_player/yamaha_musiccast.py +++ b/homeassistant/components/media_player/yamaha_musiccast.py @@ -10,10 +10,11 @@ media_player: import logging import voluptuous as vol import homeassistant.helpers.config_validation as cv +import homeassistant.util.dt as dt_util from homeassistant.const import ( CONF_HOST, CONF_PORT, - STATE_UNKNOWN, STATE_ON + STATE_UNKNOWN, STATE_ON, STATE_PLAYING, STATE_PAUSED, STATE_IDLE ) from homeassistant.components.media_player import ( MediaPlayerDevice, MEDIA_TYPE_MUSIC, PLATFORM_SCHEMA, @@ -35,7 +36,7 @@ SUPPORTED_FEATURES = ( KNOWN_HOSTS_KEY = 'data_yamaha_musiccast' INTERVAL_SECONDS = 'interval_seconds' -REQUIREMENTS = ['pymusiccast==0.1.3'] +REQUIREMENTS = ['pymusiccast==0.1.5'] DEFAULT_PORT = 5005 DEFAULT_INTERVAL = 480 @@ -111,6 +112,7 @@ class YamahaDevice(MediaPlayerDevice): self._zone = zone self.mute = False self.media_status = None + self.media_status_received = None self.power = STATE_UNKNOWN self.status = STATE_UNKNOWN self.volume = 0 @@ -202,12 +204,34 @@ class YamahaDevice(MediaPlayerDevice): """Title of current playing media.""" return self.media_status.media_title if self.media_status else None + @property + def media_position(self): + """Position of current playing media in seconds.""" + if self.media_status and self.state in \ + [STATE_PLAYING, STATE_PAUSED, STATE_IDLE]: + return self.media_status.media_position + + @property + def media_position_updated_at(self): + """When was the position of the current playing media valid. + + Returns value from homeassistant.util.dt.utcnow(). + """ + return self.media_status_received if self.media_status else None + def update(self): """Get the latest details from the device.""" _LOGGER.debug("update: %s", self.entity_id) self._recv.update_status() self._zone.update_status() + def update_hass(self): + """Push updates to HASS.""" + if self.entity_id: + _LOGGER.debug("update_hass: pushing updates") + self.schedule_update_ha_state() + return True + def turn_on(self): """Turn on specified media player or all.""" _LOGGER.debug("Turn device: on") @@ -259,3 +283,9 @@ class YamahaDevice(MediaPlayerDevice): _LOGGER.debug("select_source: %s", source) self.status = STATE_UNKNOWN self._zone.set_input(source) + + def new_media_status(self, status): + """Handle updates of the media status.""" + _LOGGER.debug("new media_status arrived") + self.media_status = status + self.media_status_received = dt_util.utcnow() diff --git a/requirements_all.txt b/requirements_all.txt index dec8f96f39a..9b7bb4b3cde 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -730,7 +730,7 @@ pymodbus==1.3.1 pymonoprice==0.2 # homeassistant.components.media_player.yamaha_musiccast -pymusiccast==0.1.3 +pymusiccast==0.1.5 # homeassistant.components.cover.myq pymyq==0.0.8 From 5e92fa340468d95502d6b3f9fb968008420e1e47 Mon Sep 17 00:00:00 2001 From: Andrey Date: Sat, 11 Nov 2017 09:02:06 +0200 Subject: [PATCH 005/246] Add an option to serve ES6 JS to clients (#10474) * Add an option to serve ES6 JS to clients * Rename es6 to latest * Fixes * Serve JS vrsions from separate dirs * Revert websocket API change * Update frontend to 20171110.0 * websocket: move request to constructor --- homeassistant/components/frontend/__init__.py | 142 +++++++++++++----- .../components/frontend/templates/index.html | 20 ++- homeassistant/components/http/__init__.py | 1 - homeassistant/components/http/static.py | 3 +- homeassistant/components/websocket_api.py | 17 ++- requirements_all.txt | 2 +- requirements_test_all.txt | 2 +- tests/components/test_frontend.py | 6 +- tests/components/test_panel_iframe.py | 10 +- tests/components/test_websocket_api.py | 12 +- 10 files changed, 150 insertions(+), 65 deletions(-) diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index 224970499f3..ba09e60b742 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -9,6 +9,7 @@ import hashlib import json import logging import os +from urllib.parse import urlparse from aiohttp import web import voluptuous as vol @@ -21,21 +22,19 @@ from homeassistant.const import CONF_NAME, EVENT_THEMES_UPDATED from homeassistant.core import callback from homeassistant.loader import bind_hass -REQUIREMENTS = ['home-assistant-frontend==20171106.0'] +REQUIREMENTS = ['home-assistant-frontend==20171110.0'] DOMAIN = 'frontend' -DEPENDENCIES = ['api', 'websocket_api'] +DEPENDENCIES = ['api', 'websocket_api', 'http'] -URL_PANEL_COMPONENT = '/frontend/panels/{}.html' URL_PANEL_COMPONENT_FP = '/frontend/panels/{}-{}.html' -POLYMER_PATH = os.path.join(os.path.dirname(__file__), - 'home-assistant-polymer/') -FINAL_PATH = os.path.join(POLYMER_PATH, 'final') - CONF_THEMES = 'themes' CONF_EXTRA_HTML_URL = 'extra_html_url' CONF_FRONTEND_REPO = 'development_repo' +CONF_JS_VERSION = 'javascript_version' +JS_DEFAULT_OPTION = 'es5' +JS_OPTIONS = ['es5', 'latest', 'auto'] DEFAULT_THEME_COLOR = '#03A9F4' @@ -61,6 +60,7 @@ for size in (192, 384, 512, 1024): DATA_FINALIZE_PANEL = 'frontend_finalize_panel' DATA_PANELS = 'frontend_panels' +DATA_JS_VERSION = 'frontend_js_version' DATA_EXTRA_HTML_URL = 'frontend_extra_html_url' DATA_THEMES = 'frontend_themes' DATA_DEFAULT_THEME = 'frontend_default_theme' @@ -68,8 +68,6 @@ DEFAULT_THEME = 'default' PRIMARY_COLOR = 'primary-color' -# To keep track we don't register a component twice (gives a warning) -# _REGISTERED_COMPONENTS = set() _LOGGER = logging.getLogger(__name__) CONFIG_SCHEMA = vol.Schema({ @@ -80,6 +78,8 @@ CONFIG_SCHEMA = vol.Schema({ }), vol.Optional(CONF_EXTRA_HTML_URL): vol.All(cv.ensure_list, [cv.string]), + vol.Optional(CONF_JS_VERSION, default=JS_DEFAULT_OPTION): + vol.In(JS_OPTIONS) }), }, extra=vol.ALLOW_EXTRA) @@ -102,8 +102,9 @@ class AbstractPanel: # Title to show in the sidebar (optional) sidebar_title = None - # Url to the webcomponent - webcomponent_url = None + # Url to the webcomponent (depending on JS version) + webcomponent_url_es5 = None + webcomponent_url_latest = None # Url to show the panel in the frontend frontend_url_path = None @@ -135,16 +136,20 @@ class AbstractPanel: 'get', '/{}/{{extra:.+}}'.format(self.frontend_url_path), index_view.get) - def as_dict(self): + def to_response(self, hass, request): """Panel as dictionary.""" - return { + result = { 'component_name': self.component_name, 'icon': self.sidebar_icon, 'title': self.sidebar_title, - 'url': self.webcomponent_url, 'url_path': self.frontend_url_path, 'config': self.config, } + if _is_latest(hass.data[DATA_JS_VERSION], request): + result['url'] = self.webcomponent_url_latest + else: + result['url'] = self.webcomponent_url_es5 + return result class BuiltInPanel(AbstractPanel): @@ -170,15 +175,19 @@ class BuiltInPanel(AbstractPanel): if frontend_repository_path is None: import hass_frontend + import hass_frontend_es5 - self.webcomponent_url = \ - '/static/panels/ha-panel-{}-{}.html'.format( + self.webcomponent_url_latest = \ + '/frontend_latest/panels/ha-panel-{}-{}.html'.format( self.component_name, hass_frontend.FINGERPRINTS[panel_path]) - + self.webcomponent_url_es5 = \ + '/frontend_es5/panels/ha-panel-{}-{}.html'.format( + self.component_name, + hass_frontend_es5.FINGERPRINTS[panel_path]) else: # Dev mode - self.webcomponent_url = \ + self.webcomponent_url_es5 = self.webcomponent_url_latest = \ '/home-assistant-polymer/panels/{}/ha-panel-{}.html'.format( self.component_name, self.component_name) @@ -208,18 +217,20 @@ class ExternalPanel(AbstractPanel): """ try: if self.md5 is None: - yield from hass.async_add_job(_fingerprint, self.path) + self.md5 = yield from hass.async_add_job( + _fingerprint, self.path) except OSError: _LOGGER.error('Cannot find or access %s at %s', self.component_name, self.path) hass.data[DATA_PANELS].pop(self.frontend_url_path) + return - self.webcomponent_url = \ + self.webcomponent_url_es5 = self.webcomponent_url_latest = \ URL_PANEL_COMPONENT_FP.format(self.component_name, self.md5) if self.component_name not in self.REGISTERED_COMPONENTS: hass.http.register_static_path( - self.webcomponent_url, self.path, + self.webcomponent_url_latest, self.path, # if path is None, we're in prod mode, so cache static assets frontend_repository_path is None) self.REGISTERED_COMPONENTS.add(self.component_name) @@ -281,31 +292,50 @@ def async_setup(hass, config): repo_path = conf.get(CONF_FRONTEND_REPO) is_dev = repo_path is not None + hass.data[DATA_JS_VERSION] = js_version = conf.get(CONF_JS_VERSION) if is_dev: hass.http.register_static_path( "/home-assistant-polymer", repo_path, False) hass.http.register_static_path( "/static/translations", - os.path.join(repo_path, "build/translations"), False) - sw_path = os.path.join(repo_path, "build/service_worker.js") + os.path.join(repo_path, "build-translations"), False) + sw_path_es5 = os.path.join(repo_path, "build-es5/service_worker.js") + sw_path_latest = os.path.join(repo_path, "build/service_worker.js") static_path = os.path.join(repo_path, 'hass_frontend') + frontend_es5_path = os.path.join(repo_path, 'build-es5') + frontend_latest_path = os.path.join(repo_path, 'build') else: import hass_frontend - frontend_path = hass_frontend.where() - sw_path = os.path.join(frontend_path, "service_worker.js") - static_path = frontend_path + import hass_frontend_es5 + sw_path_es5 = os.path.join(hass_frontend_es5.where(), + "service_worker.js") + sw_path_latest = os.path.join(hass_frontend.where(), + "service_worker.js") + # /static points to dir with files that are JS-type agnostic. + # ES5 files are served from /frontend_es5. + # ES6 files are served from /frontend_latest. + static_path = hass_frontend.where() + frontend_es5_path = hass_frontend_es5.where() + frontend_latest_path = static_path - hass.http.register_static_path("/service_worker.js", sw_path, False) + hass.http.register_static_path( + "/service_worker_es5.js", sw_path_es5, False) + hass.http.register_static_path( + "/service_worker.js", sw_path_latest, False) hass.http.register_static_path( "/robots.txt", os.path.join(static_path, "robots.txt"), not is_dev) hass.http.register_static_path("/static", static_path, not is_dev) + hass.http.register_static_path( + "/frontend_latest", frontend_latest_path, not is_dev) + hass.http.register_static_path( + "/frontend_es5", frontend_es5_path, not is_dev) local = hass.config.path('www') if os.path.isdir(local): hass.http.register_static_path("/local", local, not is_dev) - index_view = IndexView(is_dev) + index_view = IndexView(is_dev, js_version) hass.http.register_view(index_view) @asyncio.coroutine @@ -405,7 +435,7 @@ class IndexView(HomeAssistantView): requires_auth = False extra_urls = ['/states', '/states/{extra}'] - def __init__(self, use_repo): + def __init__(self, use_repo, js_option): """Initialize the frontend view.""" from jinja2 import FileSystemLoader, Environment @@ -416,27 +446,37 @@ class IndexView(HomeAssistantView): os.path.join(os.path.dirname(__file__), 'templates/') ) ) + self.js_option = js_option @asyncio.coroutine def get(self, request, extra=None): """Serve the index view.""" hass = request.app['hass'] + latest = _is_latest(self.js_option, request) + compatibility_url = None if self.use_repo: - core_url = '/home-assistant-polymer/build/core.js' - compatibility_url = \ - '/home-assistant-polymer/build/compatibility.js' + core_url = '/home-assistant-polymer/{}/core.js'.format( + 'build' if latest else 'build-es5') ui_url = '/home-assistant-polymer/src/home-assistant.html' icons_fp = '' icons_url = '/static/mdi.html' else: + if latest: + import hass_frontend + core_url = '/frontend_latest/core-{}.js'.format( + hass_frontend.FINGERPRINTS['core.js']) + ui_url = '/frontend_latest/frontend-{}.html'.format( + hass_frontend.FINGERPRINTS['frontend.html']) + else: + import hass_frontend_es5 + core_url = '/frontend_es5/core-{}.js'.format( + hass_frontend_es5.FINGERPRINTS['core.js']) + compatibility_url = '/frontend_es5/compatibility-{}.js'.format( + hass_frontend_es5.FINGERPRINTS['compatibility.js']) + ui_url = '/frontend_es5/frontend-{}.html'.format( + hass_frontend_es5.FINGERPRINTS['frontend.html']) import hass_frontend - core_url = '/static/core-{}.js'.format( - hass_frontend.FINGERPRINTS['core.js']) - compatibility_url = '/static/compatibility-{}.js'.format( - hass_frontend.FINGERPRINTS['compatibility.js']) - ui_url = '/static/frontend-{}.html'.format( - hass_frontend.FINGERPRINTS['frontend.html']) icons_fp = '-{}'.format(hass_frontend.FINGERPRINTS['mdi.html']) icons_url = '/static/mdi{}.html'.format(icons_fp) @@ -447,8 +487,10 @@ class IndexView(HomeAssistantView): if panel == 'states': panel_url = '' + elif latest: + panel_url = hass.data[DATA_PANELS][panel].webcomponent_url_latest else: - panel_url = hass.data[DATA_PANELS][panel].webcomponent_url + panel_url = hass.data[DATA_PANELS][panel].webcomponent_url_es5 no_auth = 'true' if hass.config.api.api_password and not is_trusted_ip(request): @@ -468,7 +510,10 @@ class IndexView(HomeAssistantView): panel_url=panel_url, panels=hass.data[DATA_PANELS], dev_mode=self.use_repo, theme_color=MANIFEST_JSON['theme_color'], - extra_urls=hass.data[DATA_EXTRA_HTML_URL]) + extra_urls=hass.data[DATA_EXTRA_HTML_URL], + latest=latest, + service_worker_name='/service_worker.js' if latest else + '/service_worker_es5.js') return web.Response(text=resp, content_type='text/html') @@ -509,3 +554,20 @@ def _fingerprint(path): """Fingerprint a file.""" with open(path) as fil: return hashlib.md5(fil.read().encode('utf-8')).hexdigest() + + +def _is_latest(js_option, request): + """ + Return whether we should serve latest untranspiled code. + + Set according to user's preference and URL override. + """ + if request is None: + return js_option == 'latest' + latest_in_query = 'latest' in request.query or ( + request.headers.get('Referer') and + 'latest' in urlparse(request.headers['Referer']).query) + es5_in_query = 'es5' in request.query or ( + request.headers.get('Referer') and + 'es5' in urlparse(request.headers['Referer']).query) + return latest_in_query or (not es5_in_query and js_option == 'latest') diff --git a/homeassistant/components/frontend/templates/index.html b/homeassistant/components/frontend/templates/index.html index c941fbc15ae..ae030a5d026 100644 --- a/homeassistant/components/frontend/templates/index.html +++ b/homeassistant/components/frontend/templates/index.html @@ -78,11 +78,11 @@ TRY AGAIN - - {# #} + + {# -#} + {% if not latest -%} + {% endif -%} - {% if not dev_mode %} - - {% endif %} + {% if not dev_mode and not latest -%} + + {% endif -%} {% if panel_url -%} diff --git a/homeassistant/components/http/__init__.py b/homeassistant/components/http/__init__.py index 659fd026bb8..17ceccfd218 100644 --- a/homeassistant/components/http/__init__.py +++ b/homeassistant/components/http/__init__.py @@ -262,7 +262,6 @@ class HomeAssistantWSGI(object): resource = CachingStaticResource else: resource = web.StaticResource - self.app.router.register_resource(resource(url_path, path)) return diff --git a/homeassistant/components/http/static.py b/homeassistant/components/http/static.py index c2576358f59..c9b094e3f2e 100644 --- a/homeassistant/components/http/static.py +++ b/homeassistant/components/http/static.py @@ -65,7 +65,8 @@ class CachingFileResponse(FileResponse): @asyncio.coroutine def staticresource_middleware(request, handler): """Middleware to strip out fingerprint from fingerprinted assets.""" - if not request.path.startswith('/static/'): + path = request.path + if not path.startswith('/static/') and not path.startswith('/frontend'): return handler(request) fingerprinted = _FINGERPRINT.match(request.match_info['filename']) diff --git a/homeassistant/components/websocket_api.py b/homeassistant/components/websocket_api.py index e9f567c04d3..a1fb0ca9cac 100644 --- a/homeassistant/components/websocket_api.py +++ b/homeassistant/components/websocket_api.py @@ -202,15 +202,16 @@ class WebsocketAPIView(HomeAssistantView): def get(self, request): """Handle an incoming websocket connection.""" # pylint: disable=no-self-use - return ActiveConnection(request.app['hass']).handle(request) + return ActiveConnection(request.app['hass'], request).handle() class ActiveConnection: """Handle an active websocket client connection.""" - def __init__(self, hass): + def __init__(self, hass, request): """Initialize an active connection.""" self.hass = hass + self.request = request self.wsock = None self.event_listeners = {} self.to_write = asyncio.Queue(maxsize=MAX_PENDING_MSG, loop=hass.loop) @@ -259,8 +260,9 @@ class ActiveConnection: self._writer_task.cancel() @asyncio.coroutine - def handle(self, request): + def handle(self): """Handle the websocket connection.""" + request = self.request wsock = self.wsock = web.WebSocketResponse() yield from wsock.prepare(request) self.debug("Connected") @@ -350,7 +352,7 @@ class ActiveConnection: if wsock.closed: self.debug("Connection closed by client") else: - self.log_error("Unexpected TypeError", msg) + _LOGGER.exception("Unexpected TypeError: %s", msg) except ValueError as err: msg = "Received invalid JSON" @@ -483,9 +485,14 @@ class ActiveConnection: Async friendly. """ msg = GET_PANELS_MESSAGE_SCHEMA(msg) + panels = { + panel: + self.hass.data[frontend.DATA_PANELS][panel].to_response( + self.hass, self.request) + for panel in self.hass.data[frontend.DATA_PANELS]} self.to_write.put_nowait(result_message( - msg['id'], self.hass.data[frontend.DATA_PANELS])) + msg['id'], panels)) def handle_ping(self, msg): """Handle ping command. diff --git a/requirements_all.txt b/requirements_all.txt index 9b7bb4b3cde..782e9930daa 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -330,7 +330,7 @@ hipnotify==1.0.8 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171106.0 +home-assistant-frontend==20171110.0 # homeassistant.components.camera.onvif http://github.com/tgaugry/suds-passworddigest-py3/archive/86fc50e39b4d2b8997481967d6a7fe1c57118999.zip#suds-passworddigest-py3==0.1.2a diff --git a/requirements_test_all.txt b/requirements_test_all.txt index 9f45cc4516e..083c2792db2 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -74,7 +74,7 @@ hbmqtt==0.8 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171106.0 +home-assistant-frontend==20171110.0 # homeassistant.components.influxdb # homeassistant.components.sensor.influxdb diff --git a/tests/components/test_frontend.py b/tests/components/test_frontend.py index 1b034cfe940..3d8d2b62a2b 100644 --- a/tests/components/test_frontend.py +++ b/tests/components/test_frontend.py @@ -52,7 +52,7 @@ def test_frontend_and_static(mock_http_client): # Test we can retrieve frontend.js frontendjs = re.search( - r'(?P\/static\/frontend-[A-Za-z0-9]{32}.html)', text) + r'(?P\/frontend_es5\/frontend-[A-Za-z0-9]{32}.html)', text) assert frontendjs is not None resp = yield from mock_http_client.get(frontendjs.groups(0)[0]) @@ -63,6 +63,10 @@ def test_frontend_and_static(mock_http_client): @asyncio.coroutine def test_dont_cache_service_worker(mock_http_client): """Test that we don't cache the service worker.""" + resp = yield from mock_http_client.get('/service_worker_es5.js') + assert resp.status == 200 + assert 'cache-control' not in resp.headers + resp = yield from mock_http_client.get('/service_worker.js') assert resp.status == 200 assert 'cache-control' not in resp.headers diff --git a/tests/components/test_panel_iframe.py b/tests/components/test_panel_iframe.py index 00c824418be..9a56479c469 100644 --- a/tests/components/test_panel_iframe.py +++ b/tests/components/test_panel_iframe.py @@ -33,7 +33,7 @@ class TestPanelIframe(unittest.TestCase): 'panel_iframe': conf }) - @patch.dict('hass_frontend.FINGERPRINTS', + @patch.dict('hass_frontend_es5.FINGERPRINTS', {'panels/ha-panel-iframe.html': 'md5md5'}) def test_correct_config(self): """Test correct config.""" @@ -55,20 +55,20 @@ class TestPanelIframe(unittest.TestCase): panels = self.hass.data[frontend.DATA_PANELS] - assert panels.get('router').as_dict() == { + assert panels.get('router').to_response(self.hass, None) == { 'component_name': 'iframe', 'config': {'url': 'http://192.168.1.1'}, 'icon': 'mdi:network-wireless', 'title': 'Router', - 'url': '/static/panels/ha-panel-iframe-md5md5.html', + 'url': '/frontend_es5/panels/ha-panel-iframe-md5md5.html', 'url_path': 'router' } - assert panels.get('weather').as_dict() == { + assert panels.get('weather').to_response(self.hass, None) == { 'component_name': 'iframe', 'config': {'url': 'https://www.wunderground.com/us/ca/san-diego'}, 'icon': 'mdi:weather', 'title': 'Weather', - 'url': '/static/panels/ha-panel-iframe-md5md5.html', + 'url': '/frontend_es5/panels/ha-panel-iframe-md5md5.html', 'url_path': 'weather', } diff --git a/tests/components/test_websocket_api.py b/tests/components/test_websocket_api.py index c310b0d5445..8b6c7494214 100644 --- a/tests/components/test_websocket_api.py +++ b/tests/components/test_websocket_api.py @@ -290,7 +290,7 @@ def test_get_panels(hass, websocket_client): """Test get_panels command.""" yield from hass.components.frontend.async_register_built_in_panel( 'map', 'Map', 'mdi:account-location') - + hass.data[frontend.DATA_JS_VERSION] = 'es5' websocket_client.send_json({ 'id': 5, 'type': wapi.TYPE_GET_PANELS, @@ -300,8 +300,14 @@ def test_get_panels(hass, websocket_client): assert msg['id'] == 5 assert msg['type'] == wapi.TYPE_RESULT assert msg['success'] - assert msg['result'] == {url: panel.as_dict() for url, panel - in hass.data[frontend.DATA_PANELS].items()} + assert msg['result'] == {'map': { + 'component_name': 'map', + 'url_path': 'map', + 'config': None, + 'url': None, + 'icon': 'mdi:account-location', + 'title': 'Map', + }} @asyncio.coroutine From 44506ce15f71bf223b463f686fe9476919cdc4b0 Mon Sep 17 00:00:00 2001 From: Lukas Barth Date: Sat, 11 Nov 2017 17:36:37 +0100 Subject: [PATCH 006/246] Adapt to new yarl API (#10527) --- homeassistant/components/tts/google.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/homeassistant/components/tts/google.py b/homeassistant/components/tts/google.py index 4551a792fc6..e405e5be531 100644 --- a/homeassistant/components/tts/google.py +++ b/homeassistant/components/tts/google.py @@ -87,7 +87,7 @@ class GoogleProvider(Provider): url_param = { 'ie': 'UTF-8', 'tl': language, - 'q': yarl.quote(part, strict=False), + 'q': yarl.quote(part), 'tk': part_token, 'total': len(message_parts), 'idx': idx, From f3a90d69946890ee93ce59c6644ed6c27c0163a1 Mon Sep 17 00:00:00 2001 From: Hmmbob <33529490+hmmbob@users.noreply.github.com> Date: Sat, 11 Nov 2017 20:51:26 +0100 Subject: [PATCH 007/246] Update nederlandse_spoorwegen.py to include platform information (#10494) * Update nederlandse_spoorwegen.py Make departure and arrival platforms available as state attributes * Update nederlandse_spoorwegen.py * Update nederlandse_spoorwegen.py --- homeassistant/components/sensor/nederlandse_spoorwegen.py | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/homeassistant/components/sensor/nederlandse_spoorwegen.py b/homeassistant/components/sensor/nederlandse_spoorwegen.py index e8d3aa41c6c..3535e00d79b 100644 --- a/homeassistant/components/sensor/nederlandse_spoorwegen.py +++ b/homeassistant/components/sensor/nederlandse_spoorwegen.py @@ -135,6 +135,10 @@ class NSDepartureSensor(Entity): 'departure_delay': self._trips[0].departure_time_planned != self._trips[0].departure_time_actual, + 'departure_platform': + self._trips[0].trip_parts[0].stops[0].platform, + 'departure_platform_changed': + self._trips[0].trip_parts[0].stops[0].platform_changed, 'arrival_time_planned': self._trips[0].arrival_time_planned.strftime('%H:%M'), 'arrival_time_actual': @@ -142,6 +146,10 @@ class NSDepartureSensor(Entity): 'arrival_delay': self._trips[0].arrival_time_planned != self._trips[0].arrival_time_actual, + 'arrival_platform': + self._trips[0].trip_parts[0].stops[-1].platform, + 'arrival_platform_changed': + self._trips[0].trip_parts[0].stops[-1].platform_changed, 'next': self._trips[1].departure_time_actual.strftime('%H:%M'), 'status': self._trips[0].status.lower(), From 78afbd4292503974c8b50e75eaf193837fb4da1c Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sat, 11 Nov 2017 12:12:31 -0800 Subject: [PATCH 008/246] Pin YARL to 0.13 --- homeassistant/package_constraints.txt | 1 + requirements_all.txt | 1 + setup.py | 1 + 3 files changed, 3 insertions(+) diff --git a/homeassistant/package_constraints.txt b/homeassistant/package_constraints.txt index 7da87160684..a2dc9572c81 100644 --- a/homeassistant/package_constraints.txt +++ b/homeassistant/package_constraints.txt @@ -6,6 +6,7 @@ jinja2>=2.9.6 voluptuous==0.10.5 typing>=3,<4 aiohttp==2.2.5 +yarl==0.13 async_timeout==2.0.0 chardet==3.0.4 astral==1.4 diff --git a/requirements_all.txt b/requirements_all.txt index a2aa2bb1057..fb22149e54d 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -7,6 +7,7 @@ jinja2>=2.9.6 voluptuous==0.10.5 typing>=3,<4 aiohttp==2.2.5 +yarl==0.13 async_timeout==2.0.0 chardet==3.0.4 astral==1.4 diff --git a/setup.py b/setup.py index cd7043650ad..3eb636d0801 100755 --- a/setup.py +++ b/setup.py @@ -23,6 +23,7 @@ REQUIRES = [ 'voluptuous==0.10.5', 'typing>=3,<4', 'aiohttp==2.2.5', + 'yarl==0.13', # Update this whenever you update aiohttp 'async_timeout==2.0.0', 'chardet==3.0.4', 'astral==1.4', From 30bd92c851a7fe2891bf8e2fb4b37133e2e6d062 Mon Sep 17 00:00:00 2001 From: Stefan Jonasson Date: Thu, 9 Nov 2017 15:03:35 +0100 Subject: [PATCH 009/246] Tellstick Duo acync callback fix (#10384) * Reverted commit 1c8f1796903d06786060c53b48f07733708853a1. This fixes issue: #10329 * convert callback to async * fix lint * cleanup * cleanup * cleanups * optimize initial handling * Update tellstick.py * Update tellstick.py * fix lint * fix lint * Update tellstick.py * Fixed code errors and lint problems. * fix bug * Reduce logic, migrate to dispatcher * Update tellstick.py * Update tellstick.py * fix lint * fix lint --- homeassistant/components/light/tellstick.py | 20 ++- homeassistant/components/switch/tellstick.py | 22 ++-- homeassistant/components/tellstick.py | 126 ++++++++----------- 3 files changed, 68 insertions(+), 100 deletions(-) diff --git a/homeassistant/components/light/tellstick.py b/homeassistant/components/light/tellstick.py index 598cd22c986..1bf7d632af5 100644 --- a/homeassistant/components/light/tellstick.py +++ b/homeassistant/components/light/tellstick.py @@ -4,15 +4,13 @@ Support for Tellstick lights. For more details about this platform, please refer to the documentation at https://home-assistant.io/components/light.tellstick/ """ -import voluptuous as vol from homeassistant.components.light import ( ATTR_BRIGHTNESS, SUPPORT_BRIGHTNESS, Light) from homeassistant.components.tellstick import ( DEFAULT_SIGNAL_REPETITIONS, ATTR_DISCOVER_DEVICES, ATTR_DISCOVER_CONFIG, - DOMAIN, TellstickDevice) + DATA_TELLSTICK, TellstickDevice) -PLATFORM_SCHEMA = vol.Schema({vol.Required("platform"): DOMAIN}) SUPPORT_TELLSTICK = SUPPORT_BRIGHTNESS @@ -27,17 +25,18 @@ def setup_platform(hass, config, add_devices, discovery_info=None): signal_repetitions = discovery_info.get( ATTR_DISCOVER_CONFIG, DEFAULT_SIGNAL_REPETITIONS) - add_devices(TellstickLight(tellcore_id, hass.data['tellcore_registry'], - signal_repetitions) - for tellcore_id in discovery_info[ATTR_DISCOVER_DEVICES]) + add_devices([TellstickLight(hass.data[DATA_TELLSTICK][tellcore_id], + signal_repetitions) + for tellcore_id in discovery_info[ATTR_DISCOVER_DEVICES]], + True) class TellstickLight(TellstickDevice, Light): """Representation of a Tellstick light.""" - def __init__(self, tellcore_id, tellcore_registry, signal_repetitions): + def __init__(self, tellcore_device, signal_repetitions): """Initialize the Tellstick light.""" - super().__init__(tellcore_id, tellcore_registry, signal_repetitions) + super().__init__(tellcore_device, signal_repetitions) self._brightness = 255 @@ -57,9 +56,8 @@ class TellstickLight(TellstickDevice, Light): def _parse_tellcore_data(self, tellcore_data): """Turn the value received from tellcore into something useful.""" - if tellcore_data is not None: - brightness = int(tellcore_data) - return brightness + if tellcore_data: + return int(tellcore_data) # brightness return None def _update_model(self, new_state, data): diff --git a/homeassistant/components/switch/tellstick.py b/homeassistant/components/switch/tellstick.py index de7a3bf4545..ae19e77c2e5 100644 --- a/homeassistant/components/switch/tellstick.py +++ b/homeassistant/components/switch/tellstick.py @@ -4,16 +4,11 @@ Support for Tellstick switches. For more details about this platform, please refer to the documentation at https://home-assistant.io/components/switch.tellstick/ """ -import voluptuous as vol - -from homeassistant.components.tellstick import (DEFAULT_SIGNAL_REPETITIONS, - ATTR_DISCOVER_DEVICES, - ATTR_DISCOVER_CONFIG, - DOMAIN, TellstickDevice) +from homeassistant.components.tellstick import ( + DEFAULT_SIGNAL_REPETITIONS, ATTR_DISCOVER_DEVICES, + ATTR_DISCOVER_CONFIG, DATA_TELLSTICK, TellstickDevice) from homeassistant.helpers.entity import ToggleEntity -PLATFORM_SCHEMA = vol.Schema({vol.Required("platform"): DOMAIN}) - # pylint: disable=unused-argument def setup_platform(hass, config, add_devices, discovery_info=None): @@ -26,9 +21,10 @@ def setup_platform(hass, config, add_devices, discovery_info=None): signal_repetitions = discovery_info.get(ATTR_DISCOVER_CONFIG, DEFAULT_SIGNAL_REPETITIONS) - add_devices(TellstickSwitch(tellcore_id, hass.data['tellcore_registry'], - signal_repetitions) - for tellcore_id in discovery_info[ATTR_DISCOVER_DEVICES]) + add_devices([TellstickSwitch(hass.data[DATA_TELLSTICK][tellcore_id], + signal_repetitions) + for tellcore_id in discovery_info[ATTR_DISCOVER_DEVICES]], + True) class TellstickSwitch(TellstickDevice, ToggleEntity): @@ -36,11 +32,11 @@ class TellstickSwitch(TellstickDevice, ToggleEntity): def _parse_ha_data(self, kwargs): """Turn the value from HA into something useful.""" - return None + pass def _parse_tellcore_data(self, tellcore_data): """Turn the value received from tellcore into something useful.""" - return None + pass def _update_model(self, new_state, data): """Update the device entity state to match the arguments.""" diff --git a/homeassistant/components/tellstick.py b/homeassistant/components/tellstick.py index 85407ff4c7a..91a7c0c69e5 100644 --- a/homeassistant/components/tellstick.py +++ b/homeassistant/components/tellstick.py @@ -4,12 +4,14 @@ Tellstick Component. For more details about this component, please refer to the documentation at https://home-assistant.io/components/tellstick/ """ +import asyncio import logging import threading import voluptuous as vol from homeassistant.helpers import discovery +from homeassistant.core import callback from homeassistant.const import ( EVENT_HOMEASSISTANT_STOP, CONF_HOST, CONF_PORT) from homeassistant.helpers.entity import Entity @@ -26,6 +28,9 @@ CONF_SIGNAL_REPETITIONS = 'signal_repetitions' DEFAULT_SIGNAL_REPETITIONS = 1 DOMAIN = 'tellstick' +DATA_TELLSTICK = 'tellstick_device' +SIGNAL_TELLCORE_CALLBACK = 'tellstick_callback' + # Use a global tellstick domain lock to avoid getting Tellcore errors when # calling concurrently. TELLSTICK_LOCK = threading.RLock() @@ -62,7 +67,7 @@ def _discover(hass, config, component_name, found_tellcore_devices): def setup(hass, config): """Set up the Tellstick component.""" from tellcore.constants import TELLSTICK_DIM - from tellcore.telldus import QueuedCallbackDispatcher + from tellcore.telldus import AsyncioCallbackDispatcher from tellcore.telldus import TelldusCore from tellcorenet import TellCoreClient @@ -83,94 +88,57 @@ def setup(hass, config): try: tellcore_lib = TelldusCore( - callback_dispatcher=QueuedCallbackDispatcher()) + callback_dispatcher=AsyncioCallbackDispatcher(hass.loop)) except OSError: _LOGGER.exception("Could not initialize Tellstick") return False # Get all devices, switches and lights alike - all_tellcore_devices = tellcore_lib.devices() + tellcore_devices = tellcore_lib.devices() # Register devices - tellcore_registry = TellstickRegistry(hass, tellcore_lib) - tellcore_registry.register_tellcore_devices(all_tellcore_devices) - hass.data['tellcore_registry'] = tellcore_registry + hass.data[DATA_TELLSTICK] = {device.id: device for + device in tellcore_devices} # Discover the switches _discover(hass, config, 'switch', - [tellcore_device.id for tellcore_device in all_tellcore_devices - if not tellcore_device.methods(TELLSTICK_DIM)]) + [device.id for device in tellcore_devices + if not device.methods(TELLSTICK_DIM)]) # Discover the lights _discover(hass, config, 'light', - [tellcore_device.id for tellcore_device in all_tellcore_devices - if tellcore_device.methods(TELLSTICK_DIM)]) + [device.id for device in tellcore_devices + if device.methods(TELLSTICK_DIM)]) + + @callback + def async_handle_callback(tellcore_id, tellcore_command, + tellcore_data, cid): + """Handle the actual callback from Tellcore.""" + hass.helpers.dispatcher.async_dispatcher_send( + SIGNAL_TELLCORE_CALLBACK, tellcore_id, + tellcore_command, tellcore_data) + + # Register callback + callback_id = tellcore_lib.register_device_event( + async_handle_callback) + + def clean_up_callback(event): + """Unregister the callback bindings.""" + if callback_id is not None: + tellcore_lib.unregister_callback(callback_id) + + hass.bus.listen_once(EVENT_HOMEASSISTANT_STOP, clean_up_callback) return True -class TellstickRegistry(object): - """Handle everything around Tellstick callbacks. - - Keeps a map device ids to the tellcore device object, and - another to the HA device objects (entities). - - Also responsible for registering / cleanup of callbacks, and for - dispatching the callbacks to the corresponding HA device object. - - All device specific logic should be elsewhere (Entities). - """ - - def __init__(self, hass, tellcore_lib): - """Initialize the Tellstick mappings and callbacks.""" - # used when map callback device id to ha entities. - self._id_to_ha_device_map = {} - self._id_to_tellcore_device_map = {} - self._setup_tellcore_callback(hass, tellcore_lib) - - def _tellcore_event_callback(self, tellcore_id, tellcore_command, - tellcore_data, cid): - """Handle the actual callback from Tellcore.""" - ha_device = self._id_to_ha_device_map.get(tellcore_id, None) - if ha_device is not None: - # Pass it on to the HA device object - ha_device.update_from_callback(tellcore_command, tellcore_data) - - def _setup_tellcore_callback(self, hass, tellcore_lib): - """Register the callback handler.""" - callback_id = tellcore_lib.register_device_event( - self._tellcore_event_callback) - - def clean_up_callback(event): - """Unregister the callback bindings.""" - if callback_id is not None: - tellcore_lib.unregister_callback(callback_id) - _LOGGER.debug("Tellstick callback unregistered") - - hass.bus.listen_once(EVENT_HOMEASSISTANT_STOP, clean_up_callback) - - def register_ha_device(self, tellcore_id, ha_device): - """Register a new HA device to receive callback updates.""" - self._id_to_ha_device_map[tellcore_id] = ha_device - - def register_tellcore_devices(self, tellcore_devices): - """Register a list of devices.""" - self._id_to_tellcore_device_map.update( - {tellcore_device.id: tellcore_device for tellcore_device - in tellcore_devices}) - - def get_tellcore_device(self, tellcore_id): - """Return a device by tellcore_id.""" - return self._id_to_tellcore_device_map.get(tellcore_id, None) - - class TellstickDevice(Entity): """Representation of a Tellstick device. Contains the common logic for all Tellstick devices. """ - def __init__(self, tellcore_id, tellcore_registry, signal_repetitions): + def __init__(self, tellcore_device, signal_repetitions): """Init the Tellstick device.""" self._signal_repetitions = signal_repetitions self._state = None @@ -179,13 +147,16 @@ class TellstickDevice(Entity): self._repeats_left = 0 # Look up our corresponding tellcore device - self._tellcore_device = tellcore_registry.get_tellcore_device( - tellcore_id) - self._name = self._tellcore_device.name - # Query tellcore for the current state - self._update_from_tellcore() - # Add ourselves to the mapping for callbacks - tellcore_registry.register_ha_device(tellcore_id, self) + self._tellcore_device = tellcore_device + self._name = tellcore_device.name + + @asyncio.coroutine + def async_added_to_hass(self): + """Register callbacks.""" + self.hass.helpers.dispatcher.async_dispatcher_connect( + SIGNAL_TELLCORE_CALLBACK, + self.update_from_callback + ) @property def should_poll(self): @@ -275,15 +246,19 @@ class TellstickDevice(Entity): self._update_model(tellcore_command != TELLSTICK_TURNOFF, self._parse_tellcore_data(tellcore_data)) - def update_from_callback(self, tellcore_command, tellcore_data): + def update_from_callback(self, tellcore_id, tellcore_command, + tellcore_data): """Handle updates from the tellcore callback.""" + if tellcore_id != self._tellcore_device.id: + return + self._update_model_from_command(tellcore_command, tellcore_data) self.schedule_update_ha_state() # This is a benign race on _repeats_left -- it's checked with the lock # in _send_repeated_command. if self._repeats_left > 0: - self.hass.async_add_job(self._send_repeated_command) + self._send_repeated_command() def _update_from_tellcore(self): """Read the current state of the device from the tellcore library.""" @@ -303,4 +278,3 @@ class TellstickDevice(Entity): def update(self): """Poll the current state of the device.""" self._update_from_tellcore() - self.schedule_update_ha_state() From fe2e0c44c88fa0cda82649153694fd0b35bf4f07 Mon Sep 17 00:00:00 2001 From: Marcelo Moreira de Mello Date: Wed, 8 Nov 2017 19:01:20 -0500 Subject: [PATCH 010/246] Fixed update() method and removed `ding` feature from stickupcams/floodlight (#10428) * Simplified URL expiration calculation and fixed refresh method * Remove support from Ring from StickupCams or floodlight cameras * Makes lint happy * Removed unecessary attributes --- .../components/binary_sensor/ring.py | 2 +- homeassistant/components/camera/ring.py | 30 ++++++++++--------- homeassistant/components/sensor/ring.py | 2 +- 3 files changed, 18 insertions(+), 16 deletions(-) diff --git a/homeassistant/components/binary_sensor/ring.py b/homeassistant/components/binary_sensor/ring.py index 1e926f00a2f..e84009301ab 100644 --- a/homeassistant/components/binary_sensor/ring.py +++ b/homeassistant/components/binary_sensor/ring.py @@ -27,7 +27,7 @@ SCAN_INTERVAL = timedelta(seconds=5) # Sensor types: Name, category, device_class SENSOR_TYPES = { - 'ding': ['Ding', ['doorbell', 'stickup_cams'], 'occupancy'], + 'ding': ['Ding', ['doorbell'], 'occupancy'], 'motion': ['Motion', ['doorbell', 'stickup_cams'], 'motion'], } diff --git a/homeassistant/components/camera/ring.py b/homeassistant/components/camera/ring.py index 70569825764..a5e9855bf37 100644 --- a/homeassistant/components/camera/ring.py +++ b/homeassistant/components/camera/ring.py @@ -7,7 +7,7 @@ https://home-assistant.io/components/camera.ring/ import asyncio import logging -from datetime import datetime, timedelta +from datetime import timedelta import voluptuous as vol @@ -23,6 +23,8 @@ CONF_FFMPEG_ARGUMENTS = 'ffmpeg_arguments' DEPENDENCIES = ['ring', 'ffmpeg'] +FORCE_REFRESH_INTERVAL = timedelta(minutes=45) + _LOGGER = logging.getLogger(__name__) SCAN_INTERVAL = timedelta(seconds=90) @@ -63,8 +65,8 @@ class RingCam(Camera): self._ffmpeg_arguments = device_info.get(CONF_FFMPEG_ARGUMENTS) self._last_video_id = self._camera.last_recording_id self._video_url = self._camera.recording_url(self._last_video_id) - self._expires_at = None - self._utcnow = None + self._utcnow = dt_util.utcnow() + self._expires_at = FORCE_REFRESH_INTERVAL + self._utcnow @property def name(self): @@ -123,19 +125,19 @@ class RingCam(Camera): def update(self): """Update camera entity and refresh attributes.""" - # extract the video expiration from URL - x_amz_expires = int(self._video_url.split('&')[0].split('=')[-1]) - x_amz_date = self._video_url.split('&')[1].split('=')[-1] + _LOGGER.debug("Checking if Ring DoorBell needs to refresh video_url") + self._camera.update() self._utcnow = dt_util.utcnow() - self._expires_at = \ - timedelta(seconds=x_amz_expires) + \ - dt_util.as_utc(datetime.strptime(x_amz_date, "%Y%m%dT%H%M%SZ")) - if self._last_video_id != self._camera.last_recording_id: - _LOGGER.debug("Updated Ring DoorBell last_video_id") + last_recording_id = self._camera.last_recording_id + + if self._last_video_id != last_recording_id or \ + self._utcnow >= self._expires_at: + + _LOGGER.info("Ring DoorBell properties refreshed") + + # update attributes if new video or if URL has expired self._last_video_id = self._camera.last_recording_id - - if self._utcnow >= self._expires_at: - _LOGGER.debug("Updated Ring DoorBell video_url") self._video_url = self._camera.recording_url(self._last_video_id) + self._expires_at = FORCE_REFRESH_INTERVAL + self._utcnow diff --git a/homeassistant/components/sensor/ring.py b/homeassistant/components/sensor/ring.py index 6c8794d096f..cae7690103d 100644 --- a/homeassistant/components/sensor/ring.py +++ b/homeassistant/components/sensor/ring.py @@ -34,7 +34,7 @@ SENSOR_TYPES = { 'Last Activity', ['doorbell', 'stickup_cams'], None, 'history', None], 'last_ding': [ - 'Last Ding', ['doorbell', 'stickup_cams'], None, 'history', 'ding'], + 'Last Ding', ['doorbell'], None, 'history', 'ding'], 'last_motion': [ 'Last Motion', ['doorbell', 'stickup_cams'], None, From 547e089185762e159bd5e26a5cf2ffbe7459f64c Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sat, 11 Nov 2017 12:14:28 -0800 Subject: [PATCH 011/246] Version bump to 0.57.3 --- homeassistant/const.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/homeassistant/const.py b/homeassistant/const.py index 64ccc1cc395..fc471c6323d 100644 --- a/homeassistant/const.py +++ b/homeassistant/const.py @@ -2,7 +2,7 @@ """Constants used by Home Assistant components.""" MAJOR_VERSION = 0 MINOR_VERSION = 57 -PATCH_VERSION = '2' +PATCH_VERSION = '3' __short_version__ = '{}.{}'.format(MAJOR_VERSION, MINOR_VERSION) __version__ = '{}.{}'.format(__short_version__, PATCH_VERSION) REQUIRED_PYTHON_VER = (3, 4, 2) From b284cc54df49a41613d9977ee5b755276e167787 Mon Sep 17 00:00:00 2001 From: Lukas Barth Date: Sat, 11 Nov 2017 21:15:13 +0100 Subject: [PATCH 012/246] Pin yarl (#10528) * Pin yarl * Update requirements --- homeassistant/package_constraints.txt | 3 ++- requirements_all.txt | 3 ++- setup.py | 3 ++- 3 files changed, 6 insertions(+), 3 deletions(-) diff --git a/homeassistant/package_constraints.txt b/homeassistant/package_constraints.txt index 00df81290e5..056ed2f3fa6 100644 --- a/homeassistant/package_constraints.txt +++ b/homeassistant/package_constraints.txt @@ -5,7 +5,8 @@ pip>=8.0.3 jinja2>=2.9.6 voluptuous==0.10.5 typing>=3,<4 -aiohttp==2.3.1 +aiohttp==2.3.2 +yarl==0.14.0 async_timeout==2.0.0 chardet==3.0.4 astral==1.4 diff --git a/requirements_all.txt b/requirements_all.txt index 782e9930daa..3c17f5aee43 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -6,7 +6,8 @@ pip>=8.0.3 jinja2>=2.9.6 voluptuous==0.10.5 typing>=3,<4 -aiohttp==2.3.1 +aiohttp==2.3.2 +yarl==0.14.0 async_timeout==2.0.0 chardet==3.0.4 astral==1.4 diff --git a/setup.py b/setup.py index 25c38af27fb..f7a3e4ab8f3 100755 --- a/setup.py +++ b/setup.py @@ -53,7 +53,8 @@ REQUIRES = [ 'jinja2>=2.9.6', 'voluptuous==0.10.5', 'typing>=3,<4', - 'aiohttp==2.3.1', + 'aiohttp==2.3.2', # If updated, check if yarl also needs an update! + 'yarl==0.14.0', 'async_timeout==2.0.0', 'chardet==3.0.4', 'astral==1.4', From 75836affbe3ec118b75d8b691f93a9c67ea0d8bb Mon Sep 17 00:00:00 2001 From: Erik Eriksson Date: Sat, 11 Nov 2017 21:21:25 +0100 Subject: [PATCH 013/246] Support configuration of region (no service url neccessary (#10513) --- homeassistant/components/volvooncall.py | 9 ++++++--- requirements_all.txt | 2 +- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/homeassistant/components/volvooncall.py b/homeassistant/components/volvooncall.py index 9c8366e7f7e..4cee6ea2139 100644 --- a/homeassistant/components/volvooncall.py +++ b/homeassistant/components/volvooncall.py @@ -22,13 +22,14 @@ DOMAIN = 'volvooncall' DATA_KEY = DOMAIN -REQUIREMENTS = ['volvooncall==0.3.3'] +REQUIREMENTS = ['volvooncall==0.4.0'] _LOGGER = logging.getLogger(__name__) CONF_UPDATE_INTERVAL = 'update_interval' MIN_UPDATE_INTERVAL = timedelta(minutes=1) DEFAULT_UPDATE_INTERVAL = timedelta(minutes=1) +CONF_REGION = 'region' CONF_SERVICE_URL = 'service_url' SIGNAL_VEHICLE_SEEN = '{}.vehicle_seen'.format(DOMAIN) @@ -58,6 +59,7 @@ CONFIG_SCHEMA = vol.Schema({ {cv.slug: cv.string}), vol.Optional(CONF_RESOURCES): vol.All( cv.ensure_list, [vol.In(RESOURCES)]), + vol.Optional(CONF_REGION): cv.string, vol.Optional(CONF_SERVICE_URL): cv.string, }), }, extra=vol.ALLOW_EXTRA) @@ -65,11 +67,12 @@ CONFIG_SCHEMA = vol.Schema({ def setup(hass, config): """Set up the Volvo On Call component.""" - from volvooncall import Connection, DEFAULT_SERVICE_URL + from volvooncall import Connection connection = Connection( config[DOMAIN].get(CONF_USERNAME), config[DOMAIN].get(CONF_PASSWORD), - config[DOMAIN].get(CONF_SERVICE_URL, DEFAULT_SERVICE_URL)) + config[DOMAIN].get(CONF_SERVICE_URL), + config[DOMAIN].get(CONF_REGION)) interval = config[DOMAIN].get(CONF_UPDATE_INTERVAL) diff --git a/requirements_all.txt b/requirements_all.txt index 3c17f5aee43..b9d306f2e81 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -1094,7 +1094,7 @@ upsmychoice==1.0.6 uvcclient==0.10.1 # homeassistant.components.volvooncall -volvooncall==0.3.3 +volvooncall==0.4.0 # homeassistant.components.verisure vsure==1.3.7 From 4420f11d9d1e1bc897a24344aa1dfda58dce462d Mon Sep 17 00:00:00 2001 From: Andrey Date: Sat, 11 Nov 2017 22:24:43 +0200 Subject: [PATCH 014/246] Fix import in tests (#10525) --- tests/components/binary_sensor/test_vultr.py | 6 +++--- tests/components/sensor/test_vultr.py | 6 +++--- tests/components/switch/test_vultr.py | 6 +++--- tests/components/test_vultr.py | 2 +- 4 files changed, 10 insertions(+), 10 deletions(-) diff --git a/tests/components/binary_sensor/test_vultr.py b/tests/components/binary_sensor/test_vultr.py index 7b0cc8caa87..2bcb220233b 100644 --- a/tests/components/binary_sensor/test_vultr.py +++ b/tests/components/binary_sensor/test_vultr.py @@ -4,9 +4,9 @@ import requests_mock import pytest import voluptuous as vol -from components.binary_sensor import vultr -from components import vultr as base_vultr -from components.vultr import ( +from homeassistant.components.binary_sensor import vultr +from homeassistant.components import vultr as base_vultr +from homeassistant.components.vultr import ( ATTR_ALLOWED_BANDWIDTH, ATTR_AUTO_BACKUPS, ATTR_IPV4_ADDRESS, ATTR_COST_PER_MONTH, ATTR_CREATED_AT, ATTR_SUBSCRIPTION_ID, CONF_SUBSCRIPTION) diff --git a/tests/components/sensor/test_vultr.py b/tests/components/sensor/test_vultr.py index ba5730f4acf..a4e5edc5800 100644 --- a/tests/components/sensor/test_vultr.py +++ b/tests/components/sensor/test_vultr.py @@ -4,9 +4,9 @@ import unittest import requests_mock import voluptuous as vol -from components.sensor import vultr -from components import vultr as base_vultr -from components.vultr import CONF_SUBSCRIPTION +from homeassistant.components.sensor import vultr +from homeassistant.components import vultr as base_vultr +from homeassistant.components.vultr import CONF_SUBSCRIPTION from homeassistant.const import ( CONF_NAME, CONF_MONITORED_CONDITIONS, CONF_PLATFORM) diff --git a/tests/components/switch/test_vultr.py b/tests/components/switch/test_vultr.py index e5eb8800f98..53bf6fbec85 100644 --- a/tests/components/switch/test_vultr.py +++ b/tests/components/switch/test_vultr.py @@ -4,9 +4,9 @@ import requests_mock import pytest import voluptuous as vol -from components.switch import vultr -from components import vultr as base_vultr -from components.vultr import ( +from homeassistant.components.switch import vultr +from homeassistant.components import vultr as base_vultr +from homeassistant.components.vultr import ( ATTR_ALLOWED_BANDWIDTH, ATTR_AUTO_BACKUPS, ATTR_IPV4_ADDRESS, ATTR_COST_PER_MONTH, ATTR_CREATED_AT, ATTR_SUBSCRIPTION_ID, CONF_SUBSCRIPTION) diff --git a/tests/components/test_vultr.py b/tests/components/test_vultr.py index ddddcd2be6c..b504c320dc8 100644 --- a/tests/components/test_vultr.py +++ b/tests/components/test_vultr.py @@ -4,7 +4,7 @@ import requests_mock from copy import deepcopy from homeassistant import setup -import components.vultr as vultr +import homeassistant.components.vultr as vultr from tests.common import ( get_test_home_assistant, load_fixture) From 68fb995c63fc131cfa7053adb1746b0d56117298 Mon Sep 17 00:00:00 2001 From: Kane610 Date: Sat, 11 Nov 2017 21:30:18 +0100 Subject: [PATCH 015/246] Update axis.py (#10412) --- homeassistant/components/axis.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/homeassistant/components/axis.py b/homeassistant/components/axis.py index 18f2c054b0c..401afe8c62c 100644 --- a/homeassistant/components/axis.py +++ b/homeassistant/components/axis.py @@ -269,7 +269,8 @@ def setup_device(hass, config, device_config): config) AXIS_DEVICES[device.serial_number] = device - hass.add_job(device.start) + if event_types: + hass.add_job(device.start) return True From db56748d889a1caf7bb90d3414b56700675ca6f5 Mon Sep 17 00:00:00 2001 From: Martin Berg Date: Sat, 11 Nov 2017 21:36:03 +0100 Subject: [PATCH 016/246] Add attribute to show who last un/set alarm (SPC) (#9906) * Add attribute to show who last un/set alarm. This allows showing the name of the SPC user who last issued an arm/disarm command and also allows for automations to depend on this value. * Optimize * Update spc.py * Update spc.py * fix * Fix test. * Fix for removed is_state_attr. --- .../components/alarm_control_panel/spc.py | 39 ++++++++----- homeassistant/components/binary_sensor/spc.py | 2 +- homeassistant/components/spc.py | 10 +++- .../alarm_control_panel/test_spc.py | 14 +++-- tests/components/binary_sensor/test_spc.py | 6 +- tests/components/test_spc.py | 56 ++++++++++++------- 6 files changed, 82 insertions(+), 45 deletions(-) diff --git a/homeassistant/components/alarm_control_panel/spc.py b/homeassistant/components/alarm_control_panel/spc.py index 1682ef2ae02..4d9c72df2f1 100644 --- a/homeassistant/components/alarm_control_panel/spc.py +++ b/homeassistant/components/alarm_control_panel/spc.py @@ -34,10 +34,8 @@ def async_setup_platform(hass, config, async_add_devices, discovery_info[ATTR_DISCOVER_AREAS] is None): return - devices = [SpcAlarm(hass=hass, - area_id=area['id'], - name=area['name'], - state=_get_alarm_state(area['mode'])) + api = hass.data[DATA_API] + devices = [SpcAlarm(api, area) for area in discovery_info[ATTR_DISCOVER_AREAS]] async_add_devices(devices) @@ -46,21 +44,29 @@ def async_setup_platform(hass, config, async_add_devices, class SpcAlarm(alarm.AlarmControlPanel): """Represents the SPC alarm panel.""" - def __init__(self, hass, area_id, name, state): + def __init__(self, api, area): """Initialize the SPC alarm panel.""" - self._hass = hass - self._area_id = area_id - self._name = name - self._state = state - self._api = hass.data[DATA_API] - - hass.data[DATA_REGISTRY].register_alarm_device(area_id, self) + self._area_id = area['id'] + self._name = area['name'] + self._state = _get_alarm_state(area['mode']) + if self._state == STATE_ALARM_DISARMED: + self._changed_by = area.get('last_unset_user_name', 'unknown') + else: + self._changed_by = area.get('last_set_user_name', 'unknown') + self._api = api @asyncio.coroutine - def async_update_from_spc(self, state): + def async_added_to_hass(self): + """Calbback for init handlers.""" + self.hass.data[DATA_REGISTRY].register_alarm_device( + self._area_id, self) + + @asyncio.coroutine + def async_update_from_spc(self, state, extra): """Update the alarm panel with a new state.""" self._state = state - yield from self.async_update_ha_state() + self._changed_by = extra.get('changed_by', 'unknown') + self.async_schedule_update_ha_state() @property def should_poll(self): @@ -72,6 +78,11 @@ class SpcAlarm(alarm.AlarmControlPanel): """Return the name of the device.""" return self._name + @property + def changed_by(self): + """Return the user the last change was triggered by.""" + return self._changed_by + @property def state(self): """Return the state of the device.""" diff --git a/homeassistant/components/binary_sensor/spc.py b/homeassistant/components/binary_sensor/spc.py index af3669c2b15..a3a84580edd 100644 --- a/homeassistant/components/binary_sensor/spc.py +++ b/homeassistant/components/binary_sensor/spc.py @@ -67,7 +67,7 @@ class SpcBinarySensor(BinarySensorDevice): spc_registry.register_sensor_device(zone_id, self) @asyncio.coroutine - def async_update_from_spc(self, state): + def async_update_from_spc(self, state, extra): """Update the state of the device.""" self._state = state yield from self.async_update_ha_state() diff --git a/homeassistant/components/spc.py b/homeassistant/components/spc.py index a271297d0fd..c186559c91a 100644 --- a/homeassistant/components/spc.py +++ b/homeassistant/components/spc.py @@ -87,9 +87,14 @@ def _async_process_message(sia_message, spc_registry): # ZX - Zone Short # ZD - Zone Disconnected - if sia_code in ('BA', 'CG', 'NL', 'OG', 'OQ'): + extra = {} + + if sia_code in ('BA', 'CG', 'NL', 'OG'): # change in area status, notify alarm panel device device = spc_registry.get_alarm_device(spc_id) + data = sia_message['description'].split('¦') + if len(data) == 3: + extra['changed_by'] = data[1] else: # change in zone status, notify sensor device device = spc_registry.get_sensor_device(spc_id) @@ -98,7 +103,6 @@ def _async_process_message(sia_message, spc_registry): 'CG': STATE_ALARM_ARMED_AWAY, 'NL': STATE_ALARM_ARMED_HOME, 'OG': STATE_ALARM_DISARMED, - 'OQ': STATE_ALARM_DISARMED, 'ZO': STATE_ON, 'ZC': STATE_OFF, 'ZX': STATE_UNKNOWN, @@ -110,7 +114,7 @@ def _async_process_message(sia_message, spc_registry): _LOGGER.warning("No device mapping found for SPC area/zone id %s.", spc_id) elif new_state: - yield from device.async_update_from_spc(new_state) + yield from device.async_update_from_spc(new_state, extra) class SpcRegistry: diff --git a/tests/components/alarm_control_panel/test_spc.py b/tests/components/alarm_control_panel/test_spc.py index 504b4e9237c..63b79781404 100644 --- a/tests/components/alarm_control_panel/test_spc.py +++ b/tests/components/alarm_control_panel/test_spc.py @@ -7,7 +7,7 @@ from homeassistant.components.spc import SpcRegistry from homeassistant.components.alarm_control_panel import spc from tests.common import async_test_home_assistant from homeassistant.const import ( - STATE_ALARM_ARMED_AWAY, STATE_ALARM_DISARMED) + STATE_ALARM_ARMED_AWAY, STATE_ALARM_DISARMED) @pytest.fixture @@ -38,19 +38,19 @@ def test_setup_platform(hass): 'last_set_user_name': 'Pelle', 'last_unset_time': '1485800564', 'last_unset_user_id': '1', - 'last_unset_user_name': 'Pelle', + 'last_unset_user_name': 'Lisa', 'last_alarm': '1478174896' - }, { + }, { 'id': '3', 'name': 'Garage', 'mode': '0', 'last_set_time': '1483705803', 'last_set_user_id': '9998', - 'last_set_user_name': 'Lisa', + 'last_set_user_name': 'Pelle', 'last_unset_time': '1483705808', 'last_unset_user_id': '9998', 'last_unset_user_name': 'Lisa' - }]} + }]} yield from spc.async_setup_platform(hass=hass, config={}, @@ -58,7 +58,11 @@ def test_setup_platform(hass): discovery_info=areas) assert len(added_entities) == 2 + assert added_entities[0].name == 'House' assert added_entities[0].state == STATE_ALARM_ARMED_AWAY + assert added_entities[0].changed_by == 'Pelle' + assert added_entities[1].name == 'Garage' assert added_entities[1].state == STATE_ALARM_DISARMED + assert added_entities[1].changed_by == 'Lisa' diff --git a/tests/components/binary_sensor/test_spc.py b/tests/components/binary_sensor/test_spc.py index 5004ccd3210..d2299874527 100644 --- a/tests/components/binary_sensor/test_spc.py +++ b/tests/components/binary_sensor/test_spc.py @@ -30,7 +30,7 @@ def test_setup_platform(hass): 'area_name': 'House', 'input': '0', 'status': '0', - }, { + }, { 'id': '3', 'type': '0', 'zone_name': 'Hallway PIR', @@ -38,7 +38,7 @@ def test_setup_platform(hass): 'area_name': 'House', 'input': '0', 'status': '0', - }, { + }, { 'id': '5', 'type': '1', 'zone_name': 'Front door', @@ -46,7 +46,7 @@ def test_setup_platform(hass): 'area_name': 'House', 'input': '1', 'status': '0', - }]} + }]} def add_entities(entities): nonlocal added_entities diff --git a/tests/components/test_spc.py b/tests/components/test_spc.py index 6fae8d821c2..7837abd8007 100644 --- a/tests/components/test_spc.py +++ b/tests/components/test_spc.py @@ -7,7 +7,9 @@ from homeassistant.components import spc from homeassistant.bootstrap import async_setup_component from tests.common import async_test_home_assistant from tests.test_util.aiohttp import mock_aiohttp_client -from homeassistant.const import (STATE_ALARM_ARMED_HOME, STATE_ALARM_DISARMED) +from homeassistant.const import ( + STATE_ON, STATE_OFF, STATE_ALARM_ARMED_AWAY, + STATE_ALARM_ARMED_HOME, STATE_ALARM_DISARMED) @pytest.fixture @@ -57,7 +59,13 @@ def aioclient_mock(): @asyncio.coroutine -def test_update_alarm_device(hass, aioclient_mock, monkeypatch): +@pytest.mark.parametrize("sia_code,state", [ + ('NL', STATE_ALARM_ARMED_HOME), + ('CG', STATE_ALARM_ARMED_AWAY), + ('OG', STATE_ALARM_DISARMED) +]) +def test_update_alarm_device(hass, aioclient_mock, monkeypatch, + sia_code, state): """Test that alarm panel state changes on incoming websocket data.""" monkeypatch.setattr("homeassistant.components.spc.SpcWebGateway." "start_listener", lambda x, *args: None) @@ -65,8 +73,8 @@ def test_update_alarm_device(hass, aioclient_mock, monkeypatch): 'spc': { 'api_url': 'http://localhost/', 'ws_url': 'ws://localhost/' - } } + } yield from async_setup_component(hass, 'spc', config) yield from hass.async_block_till_done() @@ -74,38 +82,48 @@ def test_update_alarm_device(hass, aioclient_mock, monkeypatch): assert hass.states.get(entity_id).state == STATE_ALARM_DISARMED - msg = {"sia_code": "NL", "sia_address": "1", "description": "House|Sam|1"} + msg = {"sia_code": sia_code, "sia_address": "1", + "description": "House¦Sam¦1"} yield from spc._async_process_message(msg, hass.data[spc.DATA_REGISTRY]) - assert hass.states.get(entity_id).state == STATE_ALARM_ARMED_HOME + yield from hass.async_block_till_done() - msg = {"sia_code": "OQ", "sia_address": "1", "description": "Sam"} - yield from spc._async_process_message(msg, hass.data[spc.DATA_REGISTRY]) - assert hass.states.get(entity_id).state == STATE_ALARM_DISARMED + state_obj = hass.states.get(entity_id) + assert state_obj.state == state + assert state_obj.attributes['changed_by'] == 'Sam' @asyncio.coroutine -def test_update_sensor_device(hass, aioclient_mock, monkeypatch): - """Test that sensors change state on incoming websocket data.""" +@pytest.mark.parametrize("sia_code,state", [ + ('ZO', STATE_ON), + ('ZC', STATE_OFF) +]) +def test_update_sensor_device(hass, aioclient_mock, monkeypatch, + sia_code, state): + """ + Test that sensors change state on incoming websocket data. + + Note that we don't test for the ZD (disconnected) and ZX (problem/short) + codes since the binary sensor component is hardcoded to only + let on/off states through. + """ monkeypatch.setattr("homeassistant.components.spc.SpcWebGateway." "start_listener", lambda x, *args: None) config = { 'spc': { 'api_url': 'http://localhost/', 'ws_url': 'ws://localhost/' - } } + } yield from async_setup_component(hass, 'spc', config) yield from hass.async_block_till_done() - assert hass.states.get('binary_sensor.hallway_pir').state == 'off' + assert hass.states.get('binary_sensor.hallway_pir').state == STATE_OFF - msg = {"sia_code": "ZO", "sia_address": "3", "description": "Hallway PIR"} + msg = {"sia_code": sia_code, "sia_address": "3", + "description": "Hallway PIR"} yield from spc._async_process_message(msg, hass.data[spc.DATA_REGISTRY]) - assert hass.states.get('binary_sensor.hallway_pir').state == 'on' - - msg = {"sia_code": "ZC", "sia_address": "3", "description": "Hallway PIR"} - yield from spc._async_process_message(msg, hass.data[spc.DATA_REGISTRY]) - assert hass.states.get('binary_sensor.hallway_pir').state == 'off' + yield from hass.async_block_till_done() + assert hass.states.get('binary_sensor.hallway_pir').state == state class TestSpcRegistry: @@ -139,7 +157,7 @@ class TestSpcWebGateway: ('set', spc.SpcWebGateway.AREA_COMMAND_SET), ('unset', spc.SpcWebGateway.AREA_COMMAND_UNSET), ('set_a', spc.SpcWebGateway.AREA_COMMAND_PART_SET) - ]) + ]) def test_area_commands(self, spcwebgw, url_command, command): """Test alarm arming/disarming.""" with mock_aiohttp_client() as aioclient_mock: From b6e098d1c283ad8726fc6ecb32e870e003a0c99f Mon Sep 17 00:00:00 2001 From: William Scanlon Date: Sat, 11 Nov 2017 15:49:20 -0500 Subject: [PATCH 017/246] Fixed Wink Quirky Aros bugs. (#10533) * Fixed Wink Quirky Aros bugs. --- homeassistant/components/climate/wink.py | 44 +++++++++++++++--------- 1 file changed, 28 insertions(+), 16 deletions(-) diff --git a/homeassistant/components/climate/wink.py b/homeassistant/components/climate/wink.py index f72cefc0841..75627f11a71 100644 --- a/homeassistant/components/climate/wink.py +++ b/homeassistant/components/climate/wink.py @@ -139,7 +139,7 @@ class WinkThermostat(WinkDevice, ClimateDevice): @property def eco_target(self): - """Return status of eco target (Is the termostat in eco mode).""" + """Return status of eco target (Is the thermostat in eco mode).""" return self.wink.eco_target() @property @@ -249,7 +249,7 @@ class WinkThermostat(WinkDevice, ClimateDevice): if ha_mode is not None: op_list.append(ha_mode) else: - error = "Invaid operation mode mapping. " + mode + \ + error = "Invalid operation mode mapping. " + mode + \ " doesn't map. Please report this." _LOGGER.error(error) return op_list @@ -297,7 +297,6 @@ class WinkThermostat(WinkDevice, ClimateDevice): minimum = 7 # Default minimum min_min = self.wink.min_min_set_point() min_max = self.wink.min_max_set_point() - return_value = minimum if self.current_operation == STATE_HEAT: if min_min: return_value = min_min @@ -323,7 +322,6 @@ class WinkThermostat(WinkDevice, ClimateDevice): maximum = 35 # Default maximum max_min = self.wink.max_min_set_point() max_max = self.wink.max_max_set_point() - return_value = maximum if self.current_operation == STATE_HEAT: if max_min: return_value = max_min @@ -377,11 +375,14 @@ class WinkAC(WinkDevice, ClimateDevice): @property def current_operation(self): - """Return current operation ie. heat, cool, idle.""" + """Return current operation ie. auto_eco, cool_only, fan_only.""" if not self.wink.is_on(): current_op = STATE_OFF else: - current_op = WINK_STATE_TO_HA.get(self.wink.current_hvac_mode()) + wink_mode = self.wink.current_mode() + if wink_mode == "auto_eco": + wink_mode = "eco" + current_op = WINK_STATE_TO_HA.get(wink_mode) if current_op is None: current_op = STATE_UNKNOWN return current_op @@ -392,11 +393,13 @@ class WinkAC(WinkDevice, ClimateDevice): op_list = ['off'] modes = self.wink.modes() for mode in modes: + if mode == "auto_eco": + mode = "eco" ha_mode = WINK_STATE_TO_HA.get(mode) if ha_mode is not None: op_list.append(ha_mode) else: - error = "Invaid operation mode mapping. " + mode + \ + error = "Invalid operation mode mapping. " + mode + \ " doesn't map. Please report this." _LOGGER.error(error) return op_list @@ -420,15 +423,19 @@ class WinkAC(WinkDevice, ClimateDevice): @property def current_fan_mode(self): - """Return the current fan mode.""" + """ + Return the current fan mode. + + The official Wink app only supports 3 modes [low, medium, high] + which are equal to [0.33, 0.66, 1.0] respectively. + """ speed = self.wink.current_fan_speed() - if speed <= 0.4 and speed > 0.3: + if speed <= 0.33: return SPEED_LOW - elif speed <= 0.8 and speed > 0.5: + elif speed <= 0.66: return SPEED_MEDIUM - elif speed <= 1.0 and speed > 0.8: + else: return SPEED_HIGH - return STATE_UNKNOWN @property def fan_list(self): @@ -436,11 +443,16 @@ class WinkAC(WinkDevice, ClimateDevice): return [SPEED_LOW, SPEED_MEDIUM, SPEED_HIGH] def set_fan_mode(self, fan): - """Set fan speed.""" + """ + Set fan speed. + + The official Wink app only supports 3 modes [low, medium, high] + which are equal to [0.33, 0.66, 1.0] respectively. + """ if fan == SPEED_LOW: - speed = 0.4 + speed = 0.33 elif fan == SPEED_MEDIUM: - speed = 0.8 + speed = 0.66 elif fan == SPEED_HIGH: speed = 1.0 self.wink.set_ac_fan_speed(speed) @@ -492,7 +504,7 @@ class WinkWaterHeater(WinkDevice, ClimateDevice): if ha_mode is not None: op_list.append(ha_mode) else: - error = "Invaid operation mode mapping. " + mode + \ + error = "Invalid operation mode mapping. " + mode + \ " doesn't map. Please report this." _LOGGER.error(error) return op_list From 79001fc361b6adb9377638acd41dd3b1c64bc0f9 Mon Sep 17 00:00:00 2001 From: Aaron Bach Date: Sat, 11 Nov 2017 15:21:03 -0700 Subject: [PATCH 018/246] =?UTF-8?q?Adds=20support=20for=20Tile=C2=AE=20Blu?= =?UTF-8?q?etooth=20trackers=20(#10478)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Initial work in place * Added new attributes + client UUID storage * Wrapped up * Collaborator-requested changes --- .coveragerc | 1 + .../components/device_tracker/tile.py | 124 ++++++++++++++++++ requirements_all.txt | 3 + 3 files changed, 128 insertions(+) create mode 100644 homeassistant/components/device_tracker/tile.py diff --git a/.coveragerc b/.coveragerc index 3bfd983dc30..390e57e2e31 100644 --- a/.coveragerc +++ b/.coveragerc @@ -325,6 +325,7 @@ omit = homeassistant/components/device_tracker/thomson.py homeassistant/components/device_tracker/tomato.py homeassistant/components/device_tracker/tado.py + homeassistant/components/device_tracker/tile.py homeassistant/components/device_tracker/tplink.py homeassistant/components/device_tracker/trackr.py homeassistant/components/device_tracker/ubus.py diff --git a/homeassistant/components/device_tracker/tile.py b/homeassistant/components/device_tracker/tile.py new file mode 100644 index 00000000000..f27a950a49f --- /dev/null +++ b/homeassistant/components/device_tracker/tile.py @@ -0,0 +1,124 @@ +""" +Support for Tile® Bluetooth trackers. + +For more details about this platform, please refer to the documentation at +https://home-assistant.io/components/device_tracker.tile/ +""" +import logging + +import voluptuous as vol + +import homeassistant.helpers.config_validation as cv +from homeassistant.components.device_tracker import ( + PLATFORM_SCHEMA, DeviceScanner) +from homeassistant.const import ( + CONF_USERNAME, CONF_MONITORED_VARIABLES, CONF_PASSWORD) +from homeassistant.helpers.event import track_utc_time_change +from homeassistant.util import slugify +from homeassistant.util.json import load_json, save_json + +_LOGGER = logging.getLogger(__name__) + +REQUIREMENTS = ['pytile==1.0.0'] + +CLIENT_UUID_CONFIG_FILE = '.tile.conf' +DEFAULT_ICON = 'mdi:bluetooth' +DEVICE_TYPES = ['PHONE', 'TILE'] + +ATTR_ALTITUDE = 'altitude' +ATTR_CONNECTION_STATE = 'connection_state' +ATTR_IS_DEAD = 'is_dead' +ATTR_IS_LOST = 'is_lost' +ATTR_LAST_SEEN = 'last_seen' +ATTR_LAST_UPDATED = 'last_updated' +ATTR_RING_STATE = 'ring_state' +ATTR_VOIP_STATE = 'voip_state' + +PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ + vol.Required(CONF_USERNAME): cv.string, + vol.Required(CONF_PASSWORD): cv.string, + vol.Optional(CONF_MONITORED_VARIABLES): + vol.All(cv.ensure_list, [vol.In(DEVICE_TYPES)]), +}) + + +def setup_scanner(hass, config: dict, see, discovery_info=None): + """Validate the configuration and return a Tile scanner.""" + TileDeviceScanner(hass, config, see) + return True + + +class TileDeviceScanner(DeviceScanner): + """Define a device scanner for Tiles.""" + + def __init__(self, hass, config, see): + """Initialize.""" + from pytile import Client + + _LOGGER.debug('Received configuration data: %s', config) + + # Load the client UUID (if it exists): + config_data = load_json(hass.config.path(CLIENT_UUID_CONFIG_FILE)) + if config_data: + _LOGGER.debug('Using existing client UUID') + self._client = Client( + config[CONF_USERNAME], + config[CONF_PASSWORD], + config_data['client_uuid']) + else: + _LOGGER.debug('Generating new client UUID') + self._client = Client( + config[CONF_USERNAME], + config[CONF_PASSWORD]) + + if not save_json( + hass.config.path(CLIENT_UUID_CONFIG_FILE), + {'client_uuid': self._client.client_uuid}): + _LOGGER.error("Failed to save configuration file") + + _LOGGER.debug('Client UUID: %s', self._client.client_uuid) + _LOGGER.debug('User UUID: %s', self._client.user_uuid) + + self._types = config.get(CONF_MONITORED_VARIABLES) + + self.devices = {} + self.see = see + + track_utc_time_change( + hass, self._update_info, second=range(0, 60, 30)) + + self._update_info() + + def _update_info(self, now=None) -> None: + """Update the device info.""" + device_data = self._client.get_tiles(type_whitelist=self._types) + + try: + self.devices = device_data['result'] + except KeyError: + _LOGGER.warning('No Tiles found') + _LOGGER.debug(device_data) + return + + for info in self.devices.values(): + dev_id = 'tile_{0}'.format(slugify(info['name'])) + lat = info['tileState']['latitude'] + lon = info['tileState']['longitude'] + + attrs = { + ATTR_ALTITUDE: info['tileState']['altitude'], + ATTR_CONNECTION_STATE: info['tileState']['connection_state'], + ATTR_IS_DEAD: info['is_dead'], + ATTR_IS_LOST: info['tileState']['is_lost'], + ATTR_LAST_SEEN: info['tileState']['timestamp'], + ATTR_LAST_UPDATED: device_data['timestamp_ms'], + ATTR_RING_STATE: info['tileState']['ring_state'], + ATTR_VOIP_STATE: info['tileState']['voip_state'], + } + + self.see( + dev_id=dev_id, + gps=(lat, lon), + attributes=attrs, + icon=DEFAULT_ICON + ) diff --git a/requirements_all.txt b/requirements_all.txt index b9d306f2e81..9f4a911b6b1 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -893,6 +893,9 @@ pythonegardia==1.0.22 # homeassistant.components.sensor.whois pythonwhois==2.4.3 +# homeassistant.components.device_tracker.tile +pytile==1.0.0 + # homeassistant.components.device_tracker.trackr pytrackr==0.0.5 From 96e7944fa8303c5b27efe8b0aff35000869643d2 Mon Sep 17 00:00:00 2001 From: Vignesh Venkat Date: Sat, 11 Nov 2017 15:13:35 -0800 Subject: [PATCH 019/246] telegram_bot: Support for sending videos (#10470) * telegram_bot: Support for sending videos Telegram python library has a sendVideo function that can be used similar to sending photos and documents. * fix lint issue * fix grammar --- homeassistant/components/notify/telegram.py | 11 ++++++- .../components/telegram_bot/__init__.py | 21 ++++++++----- .../components/telegram_bot/services.yaml | 31 +++++++++++++++++++ 3 files changed, 54 insertions(+), 9 deletions(-) diff --git a/homeassistant/components/notify/telegram.py b/homeassistant/components/notify/telegram.py index fb453263dd8..899ccf9b09a 100644 --- a/homeassistant/components/notify/telegram.py +++ b/homeassistant/components/notify/telegram.py @@ -21,6 +21,7 @@ DEPENDENCIES = [DOMAIN] ATTR_KEYBOARD = 'keyboard' ATTR_INLINE_KEYBOARD = 'inline_keyboard' ATTR_PHOTO = 'photo' +ATTR_VIDEO = 'video' ATTR_DOCUMENT = 'document' CONF_CHAT_ID = 'chat_id' @@ -63,7 +64,7 @@ class TelegramNotificationService(BaseNotificationService): keys = keys if isinstance(keys, list) else [keys] service_data.update(inline_keyboard=keys) - # Send a photo, a document or a location + # Send a photo, video, document, or location if data is not None and ATTR_PHOTO in data: photos = data.get(ATTR_PHOTO, None) photos = photos if isinstance(photos, list) else [photos] @@ -72,6 +73,14 @@ class TelegramNotificationService(BaseNotificationService): self.hass.services.call( DOMAIN, 'send_photo', service_data=service_data) return + elif data is not None and ATTR_VIDEO in data: + videos = data.get(ATTR_VIDEO, None) + videos = videos if isinstance(videos, list) else [videos] + for video_data in videos: + service_data.update(video_data) + self.hass.services.call( + DOMAIN, 'send_video', service_data=service_data) + return elif data is not None and ATTR_LOCATION in data: service_data.update(data.get(ATTR_LOCATION)) return self.hass.services.call( diff --git a/homeassistant/components/telegram_bot/__init__.py b/homeassistant/components/telegram_bot/__init__.py index 896dbdc4399..dc9389b1144 100644 --- a/homeassistant/components/telegram_bot/__init__.py +++ b/homeassistant/components/telegram_bot/__init__.py @@ -65,6 +65,7 @@ DOMAIN = 'telegram_bot' SERVICE_SEND_MESSAGE = 'send_message' SERVICE_SEND_PHOTO = 'send_photo' +SERVICE_SEND_VIDEO = 'send_video' SERVICE_SEND_DOCUMENT = 'send_document' SERVICE_SEND_LOCATION = 'send_location' SERVICE_EDIT_MESSAGE = 'edit_message' @@ -154,6 +155,7 @@ SERVICE_SCHEMA_DELETE_MESSAGE = vol.Schema({ SERVICE_MAP = { SERVICE_SEND_MESSAGE: SERVICE_SCHEMA_SEND_MESSAGE, SERVICE_SEND_PHOTO: SERVICE_SCHEMA_SEND_FILE, + SERVICE_SEND_VIDEO: SERVICE_SCHEMA_SEND_FILE, SERVICE_SEND_DOCUMENT: SERVICE_SCHEMA_SEND_FILE, SERVICE_SEND_LOCATION: SERVICE_SCHEMA_SEND_LOCATION, SERVICE_EDIT_MESSAGE: SERVICE_SCHEMA_EDIT_MESSAGE, @@ -277,12 +279,11 @@ def async_setup(hass, config): if msgtype == SERVICE_SEND_MESSAGE: yield from hass.async_add_job( partial(notify_service.send_message, **kwargs)) - elif msgtype == SERVICE_SEND_PHOTO: + elif (msgtype == SERVICE_SEND_PHOTO or + msgtype == SERVICE_SEND_VIDEO or + msgtype == SERVICE_SEND_DOCUMENT): yield from hass.async_add_job( - partial(notify_service.send_file, True, **kwargs)) - elif msgtype == SERVICE_SEND_DOCUMENT: - yield from hass.async_add_job( - partial(notify_service.send_file, False, **kwargs)) + partial(notify_service.send_file, msgtype, **kwargs)) elif msgtype == SERVICE_SEND_LOCATION: yield from hass.async_add_job( partial(notify_service.send_location, **kwargs)) @@ -518,11 +519,15 @@ class TelegramNotificationService: callback_query_id, text=message, show_alert=show_alert, **params) - def send_file(self, is_photo=True, target=None, **kwargs): - """Send a photo or a document.""" + def send_file(self, file_type=SERVICE_SEND_PHOTO, target=None, **kwargs): + """Send a photo, video, or document.""" params = self._get_msg_kwargs(kwargs) caption = kwargs.get(ATTR_CAPTION) - func_send = self.bot.sendPhoto if is_photo else self.bot.sendDocument + func_send = { + SERVICE_SEND_PHOTO: self.bot.sendPhoto, + SERVICE_SEND_VIDEO: self.bot.sendVideo, + SERVICE_SEND_DOCUMENT: self.bot.sendDocument + }.get(file_type) file_content = load_data( self.hass, url=kwargs.get(ATTR_URL), diff --git a/homeassistant/components/telegram_bot/services.yaml b/homeassistant/components/telegram_bot/services.yaml index 3b86d97c310..dc864c9f61a 100644 --- a/homeassistant/components/telegram_bot/services.yaml +++ b/homeassistant/components/telegram_bot/services.yaml @@ -59,6 +59,37 @@ send_photo: description: List of rows of commands, comma-separated, to make a custom inline keyboard with buttons with asociated callback data. example: '["/button1, /button2", "/button3"] or [[["Text button1", "/button1"], ["Text button2", "/button2"]], [["Text button3", "/button3"]]]' +send_video: + description: Send a video. + fields: + url: + description: Remote path to a video. + example: 'http://example.org/path/to/the/video.mp4' + file: + description: Local path to an image. + example: '/path/to/the/video.mp4' + caption: + description: The title of the video. + example: 'My video' + username: + description: Username for a URL which require HTTP basic authentication. + example: myuser + password: + description: Password for a URL which require HTTP basic authentication. + example: myuser_pwd + target: + description: An array of pre-authorized chat_ids to send the document to. If not present, first allowed chat_id is the default. + example: '[12345, 67890] or 12345' + disable_notification: + description: Sends the message silently. iOS users and Web users will not receive a notification, Android users will receive a notification with no sound. + example: true + keyboard: + description: List of rows of commands, comma-separated, to make a custom keyboard. + example: '["/command1, /command2", "/command3"]' + inline_keyboard: + description: List of rows of commands, comma-separated, to make a custom inline keyboard with buttons with asociated callback data. + example: '["/button1, /button2", "/button3"] or [[["Text button1", "/button1"], ["Text button2", "/button2"]], [["Text button3", "/button3"]]]' + send_document: description: Send a document. fields: From c8648fbfb824cfa3435d2092803f9c0042e46ef2 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sat, 11 Nov 2017 15:22:05 -0800 Subject: [PATCH 020/246] Pre-construct frontend index.html (#10520) * Pre-construct frontend index.html * Cache templates * Update frontend to 20171111.0 * Fix iframe panel test --- homeassistant/components/frontend/__init__.py | 95 ++++++-------- .../components/frontend/templates/index.html | 124 ------------------ requirements_all.txt | 2 +- requirements_test_all.txt | 2 +- tests/components/test_panel_iframe.py | 2 +- 5 files changed, 42 insertions(+), 183 deletions(-) delete mode 100644 homeassistant/components/frontend/templates/index.html diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index ba09e60b742..a656802c77d 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -13,6 +13,7 @@ from urllib.parse import urlparse from aiohttp import web import voluptuous as vol +import jinja2 import homeassistant.helpers.config_validation as cv from homeassistant.components.http import HomeAssistantView @@ -22,7 +23,7 @@ from homeassistant.const import CONF_NAME, EVENT_THEMES_UPDATED from homeassistant.core import callback from homeassistant.loader import bind_hass -REQUIREMENTS = ['home-assistant-frontend==20171110.0'] +REQUIREMENTS = ['home-assistant-frontend==20171111.0'] DOMAIN = 'frontend' DEPENDENCIES = ['api', 'websocket_api', 'http'] @@ -171,8 +172,6 @@ class BuiltInPanel(AbstractPanel): If frontend_repository_path is set, will be prepended to path of built-in components. """ - panel_path = 'panels/ha-panel-{}.html'.format(self.component_name) - if frontend_repository_path is None: import hass_frontend import hass_frontend_es5 @@ -180,11 +179,11 @@ class BuiltInPanel(AbstractPanel): self.webcomponent_url_latest = \ '/frontend_latest/panels/ha-panel-{}-{}.html'.format( self.component_name, - hass_frontend.FINGERPRINTS[panel_path]) + hass_frontend.FINGERPRINTS[self.component_name]) self.webcomponent_url_es5 = \ '/frontend_es5/panels/ha-panel-{}-{}.html'.format( self.component_name, - hass_frontend_es5.FINGERPRINTS[panel_path]) + hass_frontend_es5.FINGERPRINTS[self.component_name]) else: # Dev mode self.webcomponent_url_es5 = self.webcomponent_url_latest = \ @@ -335,7 +334,7 @@ def async_setup(hass, config): if os.path.isdir(local): hass.http.register_static_path("/local", local, not is_dev) - index_view = IndexView(is_dev, js_version) + index_view = IndexView(repo_path, js_version) hass.http.register_view(index_view) @asyncio.coroutine @@ -435,50 +434,40 @@ class IndexView(HomeAssistantView): requires_auth = False extra_urls = ['/states', '/states/{extra}'] - def __init__(self, use_repo, js_option): + def __init__(self, repo_path, js_option): """Initialize the frontend view.""" - from jinja2 import FileSystemLoader, Environment - - self.use_repo = use_repo - self.templates = Environment( - autoescape=True, - loader=FileSystemLoader( - os.path.join(os.path.dirname(__file__), 'templates/') - ) - ) + self.repo_path = repo_path self.js_option = js_option + self._template_cache = {} + + def get_template(self, latest): + """Get template.""" + if self.repo_path is not None: + root = self.repo_path + elif latest: + import hass_frontend + root = hass_frontend.where() + else: + import hass_frontend_es5 + root = hass_frontend_es5.where() + + tpl = self._template_cache.get(root) + + if tpl is None: + with open(os.path.join(root, 'index.html')) as file: + tpl = jinja2.Template(file.read()) + + # Cache template if not running from repository + if self.repo_path is None: + self._template_cache[root] = tpl + + return tpl @asyncio.coroutine def get(self, request, extra=None): """Serve the index view.""" hass = request.app['hass'] latest = _is_latest(self.js_option, request) - compatibility_url = None - - if self.use_repo: - core_url = '/home-assistant-polymer/{}/core.js'.format( - 'build' if latest else 'build-es5') - ui_url = '/home-assistant-polymer/src/home-assistant.html' - icons_fp = '' - icons_url = '/static/mdi.html' - else: - if latest: - import hass_frontend - core_url = '/frontend_latest/core-{}.js'.format( - hass_frontend.FINGERPRINTS['core.js']) - ui_url = '/frontend_latest/frontend-{}.html'.format( - hass_frontend.FINGERPRINTS['frontend.html']) - else: - import hass_frontend_es5 - core_url = '/frontend_es5/core-{}.js'.format( - hass_frontend_es5.FINGERPRINTS['core.js']) - compatibility_url = '/frontend_es5/compatibility-{}.js'.format( - hass_frontend_es5.FINGERPRINTS['compatibility.js']) - ui_url = '/frontend_es5/frontend-{}.html'.format( - hass_frontend_es5.FINGERPRINTS['frontend.html']) - import hass_frontend - icons_fp = '-{}'.format(hass_frontend.FINGERPRINTS['mdi.html']) - icons_url = '/static/mdi{}.html'.format(icons_fp) if request.path == '/': panel = 'states' @@ -497,23 +486,17 @@ class IndexView(HomeAssistantView): # do not try to auto connect on load no_auth = 'false' - template = yield from hass.async_add_job( - self.templates.get_template, 'index.html') + template = yield from hass.async_add_job(self.get_template, latest) - # pylint is wrong - # pylint: disable=no-member - # This is a jinja2 template, not a HA template so we call 'render'. resp = template.render( - core_url=core_url, ui_url=ui_url, - compatibility_url=compatibility_url, no_auth=no_auth, - icons_url=icons_url, icons=icons_fp, - panel_url=panel_url, panels=hass.data[DATA_PANELS], - dev_mode=self.use_repo, + no_auth=no_auth, + panel_url=panel_url, + panels=hass.data[DATA_PANELS], + dev_mode=self.repo_path is not None, theme_color=MANIFEST_JSON['theme_color'], extra_urls=hass.data[DATA_EXTRA_HTML_URL], latest=latest, - service_worker_name='/service_worker.js' if latest else - '/service_worker_es5.js') + ) return web.Response(text=resp, content_type='text/html') @@ -528,8 +511,8 @@ class ManifestJSONView(HomeAssistantView): @asyncio.coroutine def get(self, request): # pylint: disable=no-self-use """Return the manifest.json.""" - msg = json.dumps(MANIFEST_JSON, sort_keys=True).encode('UTF-8') - return web.Response(body=msg, content_type="application/manifest+json") + msg = json.dumps(MANIFEST_JSON, sort_keys=True) + return web.Response(text=msg, content_type="application/manifest+json") class ThemesView(HomeAssistantView): diff --git a/homeassistant/components/frontend/templates/index.html b/homeassistant/components/frontend/templates/index.html deleted file mode 100644 index ae030a5d026..00000000000 --- a/homeassistant/components/frontend/templates/index.html +++ /dev/null @@ -1,124 +0,0 @@ - - - - - Home Assistant - - - - - - {% if not dev_mode %} - - {% for panel in panels.values() -%} - - {% endfor -%} - {% endif %} - - - - - - - - - - - - - -
-
- Home Assistant had trouble
connecting to the server.

- TRY AGAIN -
-
- - {# -#} - {% if not latest -%} - - {% endif -%} - - {% if not dev_mode and not latest -%} - - {% endif -%} - - - {% if panel_url -%} - - {% endif -%} - - {% for extra_url in extra_urls -%} - - {% endfor -%} - - diff --git a/requirements_all.txt b/requirements_all.txt index 9f4a911b6b1..25bed72b32b 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -331,7 +331,7 @@ hipnotify==1.0.8 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171110.0 +home-assistant-frontend==20171111.0 # homeassistant.components.camera.onvif http://github.com/tgaugry/suds-passworddigest-py3/archive/86fc50e39b4d2b8997481967d6a7fe1c57118999.zip#suds-passworddigest-py3==0.1.2a diff --git a/requirements_test_all.txt b/requirements_test_all.txt index 083c2792db2..7e57f0638be 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -74,7 +74,7 @@ hbmqtt==0.8 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171110.0 +home-assistant-frontend==20171111.0 # homeassistant.components.influxdb # homeassistant.components.sensor.influxdb diff --git a/tests/components/test_panel_iframe.py b/tests/components/test_panel_iframe.py index 9a56479c469..805d73e1820 100644 --- a/tests/components/test_panel_iframe.py +++ b/tests/components/test_panel_iframe.py @@ -34,7 +34,7 @@ class TestPanelIframe(unittest.TestCase): }) @patch.dict('hass_frontend_es5.FINGERPRINTS', - {'panels/ha-panel-iframe.html': 'md5md5'}) + {'iframe': 'md5md5'}) def test_correct_config(self): """Test correct config.""" assert setup.setup_component( From 59e943b3c1f2571abac4db0fb49a1bcee744c029 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Per=20Osb=C3=A4ck?= Date: Sun, 12 Nov 2017 00:57:11 +0100 Subject: [PATCH 021/246] notify.html5: use new json save and load functions (#10416) * update to use new save_json and load_json * it is no longer possible to determine if the json file contains valid or empty data. * fix lint --- homeassistant/components/notify/html5.py | 41 ++++---------- tests/components/notify/test_html5.py | 71 ++++++++++-------------- 2 files changed, 40 insertions(+), 72 deletions(-) diff --git a/homeassistant/components/notify/html5.py b/homeassistant/components/notify/html5.py index a05c061c515..2314722a2ab 100644 --- a/homeassistant/components/notify/html5.py +++ b/homeassistant/components/notify/html5.py @@ -8,7 +8,6 @@ import asyncio import datetime import json import logging -import os import time import uuid @@ -16,6 +15,8 @@ from aiohttp.hdrs import AUTHORIZATION import voluptuous as vol from voluptuous.humanize import humanize_error +from homeassistant.util.json import load_json, save_json +from homeassistant.exceptions import HomeAssistantError from homeassistant.components.frontend import add_manifest_json_key from homeassistant.components.http import HomeAssistantView from homeassistant.components.notify import ( @@ -125,21 +126,11 @@ def get_service(hass, config, discovery_info=None): def _load_config(filename): """Load configuration.""" - if not os.path.isfile(filename): - return {} - try: - with open(filename, 'r') as fdesc: - inp = fdesc.read() - - # In case empty file - if not inp: - return {} - - return json.loads(inp) - except (IOError, ValueError) as error: - _LOGGER.error("Reading config file %s failed: %s", filename, error) - return None + return load_json(filename) + except HomeAssistantError: + pass + return {} class JSONBytesDecoder(json.JSONEncoder): @@ -153,18 +144,6 @@ class JSONBytesDecoder(json.JSONEncoder): return json.JSONEncoder.default(self, obj) -def _save_config(filename, config): - """Save configuration.""" - try: - with open(filename, 'w') as fdesc: - fdesc.write(json.dumps( - config, cls=JSONBytesDecoder, indent=4, sort_keys=True)) - except (IOError, TypeError) as error: - _LOGGER.error("Saving configuration file failed: %s", error) - return False - return True - - class HTML5PushRegistrationView(HomeAssistantView): """Accepts push registrations from a browser.""" @@ -194,7 +173,7 @@ class HTML5PushRegistrationView(HomeAssistantView): self.registrations[name] = data - if not _save_config(self.json_path, self.registrations): + if not save_json(self.json_path, self.registrations): return self.json_message( 'Error saving registration.', HTTP_INTERNAL_SERVER_ERROR) @@ -223,7 +202,7 @@ class HTML5PushRegistrationView(HomeAssistantView): reg = self.registrations.pop(found) - if not _save_config(self.json_path, self.registrations): + if not save_json(self.json_path, self.registrations): self.registrations[found] = reg return self.json_message( 'Error saving registration.', HTTP_INTERNAL_SERVER_ERROR) @@ -411,8 +390,8 @@ class HTML5NotificationService(BaseNotificationService): if response.status_code == 410: _LOGGER.info("Notification channel has expired") reg = self.registrations.pop(target) - if not _save_config(self.registrations_json_path, - self.registrations): + if not save_json(self.registrations_json_path, + self.registrations): self.registrations[target] = reg _LOGGER.error("Error saving registration") else: diff --git a/tests/components/notify/test_html5.py b/tests/components/notify/test_html5.py index 2c39cc5dbd7..c3998b6db64 100644 --- a/tests/components/notify/test_html5.py +++ b/tests/components/notify/test_html5.py @@ -57,24 +57,13 @@ class TestHtml5Notify(object): m = mock_open() with patch( - 'homeassistant.components.notify.html5.open', m, create=True + 'homeassistant.util.json.open', + m, create=True ): service = html5.get_service(hass, {}) assert service is not None - def test_get_service_with_bad_json(self): - """Test .""" - hass = MagicMock() - - m = mock_open(read_data='I am not JSON') - with patch( - 'homeassistant.components.notify.html5.open', m, create=True - ): - service = html5.get_service(hass, {}) - - assert service is None - @patch('pywebpush.WebPusher') def test_sending_message(self, mock_wp): """Test sending message.""" @@ -86,7 +75,8 @@ class TestHtml5Notify(object): m = mock_open(read_data=json.dumps(data)) with patch( - 'homeassistant.components.notify.html5.open', m, create=True + 'homeassistant.util.json.open', + m, create=True ): service = html5.get_service(hass, {'gcm_sender_id': '100'}) @@ -120,7 +110,8 @@ class TestHtml5Notify(object): m = mock_open() with patch( - 'homeassistant.components.notify.html5.open', m, create=True + 'homeassistant.util.json.open', + m, create=True ): hass.config.path.return_value = 'file.conf' service = html5.get_service(hass, {}) @@ -158,7 +149,8 @@ class TestHtml5Notify(object): m = mock_open() with patch( - 'homeassistant.components.notify.html5.open', m, create=True + 'homeassistant.util.json.open', + m, create=True ): hass.config.path.return_value = 'file.conf' service = html5.get_service(hass, {}) @@ -193,7 +185,8 @@ class TestHtml5Notify(object): m = mock_open() with patch( - 'homeassistant.components.notify.html5.open', m, create=True + 'homeassistant.util.json.open', + m, create=True ): hass.config.path.return_value = 'file.conf' service = html5.get_service(hass, {}) @@ -222,7 +215,7 @@ class TestHtml5Notify(object): })) assert resp.status == 400 - with patch('homeassistant.components.notify.html5._save_config', + with patch('homeassistant.components.notify.html5.save_json', return_value=False): # resp = view.post(Request(builder.get_environ())) resp = yield from client.post(REGISTER_URL, data=json.dumps({ @@ -243,14 +236,12 @@ class TestHtml5Notify(object): } m = mock_open(read_data=json.dumps(config)) - - with patch('homeassistant.components.notify.html5.open', m, - create=True): + with patch( + 'homeassistant.util.json.open', + m, create=True + ): hass.config.path.return_value = 'file.conf' - - with patch('homeassistant.components.notify.html5.os.path.isfile', - return_value=True): - service = html5.get_service(hass, {}) + service = html5.get_service(hass, {}) assert service is not None @@ -291,12 +282,11 @@ class TestHtml5Notify(object): m = mock_open(read_data=json.dumps(config)) with patch( - 'homeassistant.components.notify.html5.open', m, create=True + 'homeassistant.util.json.open', + m, create=True ): hass.config.path.return_value = 'file.conf' - with patch('homeassistant.components.notify.html5.os.path.isfile', - return_value=True): - service = html5.get_service(hass, {}) + service = html5.get_service(hass, {}) assert service is not None @@ -324,7 +314,7 @@ class TestHtml5Notify(object): @asyncio.coroutine def test_unregistering_device_view_handles_json_safe_error( - self, loop, test_client): + self, loop, test_client): """Test that the HTML unregister view handles JSON write errors.""" hass = MagicMock() @@ -335,12 +325,11 @@ class TestHtml5Notify(object): m = mock_open(read_data=json.dumps(config)) with patch( - 'homeassistant.components.notify.html5.open', m, create=True + 'homeassistant.util.json.open', + m, create=True ): hass.config.path.return_value = 'file.conf' - with patch('homeassistant.components.notify.html5.os.path.isfile', - return_value=True): - service = html5.get_service(hass, {}) + service = html5.get_service(hass, {}) assert service is not None @@ -357,7 +346,7 @@ class TestHtml5Notify(object): client = yield from test_client(app) hass.http.is_banned_ip.return_value = False - with patch('homeassistant.components.notify.html5._save_config', + with patch('homeassistant.components.notify.html5.save_json', return_value=False): resp = yield from client.delete(REGISTER_URL, data=json.dumps({ 'subscription': SUBSCRIPTION_1['subscription'], @@ -375,7 +364,8 @@ class TestHtml5Notify(object): m = mock_open() with patch( - 'homeassistant.components.notify.html5.open', m, create=True + 'homeassistant.util.json.open', + m, create=True ): hass.config.path.return_value = 'file.conf' service = html5.get_service(hass, {}) @@ -406,17 +396,16 @@ class TestHtml5Notify(object): hass = MagicMock() data = { - 'device': SUBSCRIPTION_1, + 'device': SUBSCRIPTION_1 } m = mock_open(read_data=json.dumps(data)) with patch( - 'homeassistant.components.notify.html5.open', m, create=True + 'homeassistant.util.json.open', + m, create=True ): hass.config.path.return_value = 'file.conf' - with patch('homeassistant.components.notify.html5.os.path.isfile', - return_value=True): - service = html5.get_service(hass, {'gcm_sender_id': '100'}) + service = html5.get_service(hass, {'gcm_sender_id': '100'}) assert service is not None From bc23799c712aad52f0ce129aa247c08a05c83516 Mon Sep 17 00:00:00 2001 From: Diogo Gomes Date: Sun, 12 Nov 2017 14:25:44 +0000 Subject: [PATCH 022/246] Change to device state attributes (#10536) * Following the suggestion of @MartinHjelmare --- homeassistant/components/sensor/serial.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/homeassistant/components/sensor/serial.py b/homeassistant/components/sensor/serial.py index 7bed4b25011..df0f1e21625 100644 --- a/homeassistant/components/sensor/serial.py +++ b/homeassistant/components/sensor/serial.py @@ -113,7 +113,7 @@ class SerialSensor(Entity): return False @property - def state_attributes(self): + def device_state_attributes(self): """Return the attributes of the entity (if any JSON present).""" return self._attributes From f6d511ac1a10707bf6da31e0c372695130e1db2c Mon Sep 17 00:00:00 2001 From: r4nd0mbr1ck <23737685+r4nd0mbr1ck@users.noreply.github.com> Date: Tue, 14 Nov 2017 03:32:23 +1100 Subject: [PATCH 023/246] Google Assistant request sync service (#10165) * Initial commit for request_sync functionality * Fixes for Tox results * Fixed all tox issues and tested locally with GA * Review comments - api_key, conditional read descriptions * Add test for service --- .../components/google_assistant/__init__.py | 55 ++++++++++++++++++- .../components/google_assistant/const.py | 6 ++ .../components/google_assistant/http.py | 19 +++++-- .../components/google_assistant/services.yaml | 2 + .../components/google_assistant/test_init.py | 31 +++++++++++ 5 files changed, 106 insertions(+), 7 deletions(-) create mode 100644 homeassistant/components/google_assistant/services.yaml create mode 100644 tests/components/google_assistant/test_init.py diff --git a/homeassistant/components/google_assistant/__init__.py b/homeassistant/components/google_assistant/__init__.py index 53de8764a12..2db36d8829f 100644 --- a/homeassistant/components/google_assistant/__init__.py +++ b/homeassistant/components/google_assistant/__init__.py @@ -4,9 +4,13 @@ Support for Actions on Google Assistant Smart Home Control. For more details about this component, please refer to the documentation at https://home-assistant.io/components/google_assistant/ """ +import os import asyncio import logging +import aiohttp +import async_timeout + import voluptuous as vol # Typing imports @@ -15,11 +19,16 @@ import voluptuous as vol from homeassistant.core import HomeAssistant # NOQA from typing import Dict, Any # NOQA +from homeassistant import config as conf_util from homeassistant.helpers import config_validation as cv +from homeassistant.helpers.aiohttp_client import async_get_clientsession +from homeassistant.loader import bind_hass from .const import ( DOMAIN, CONF_PROJECT_ID, CONF_CLIENT_ID, CONF_ACCESS_TOKEN, - CONF_EXPOSE_BY_DEFAULT, CONF_EXPOSED_DOMAINS + CONF_EXPOSE_BY_DEFAULT, CONF_EXPOSED_DOMAINS, + CONF_AGENT_USER_ID, CONF_API_KEY, + SERVICE_REQUEST_SYNC, REQUEST_SYNC_BASE_URL ) from .auth import GoogleAssistantAuthView from .http import GoogleAssistantView @@ -28,6 +37,8 @@ _LOGGER = logging.getLogger(__name__) DEPENDENCIES = ['http'] +DEFAULT_AGENT_USER_ID = 'home-assistant' + CONFIG_SCHEMA = vol.Schema( { DOMAIN: { @@ -36,17 +47,57 @@ CONFIG_SCHEMA = vol.Schema( vol.Required(CONF_ACCESS_TOKEN): cv.string, vol.Optional(CONF_EXPOSE_BY_DEFAULT): cv.boolean, vol.Optional(CONF_EXPOSED_DOMAINS): cv.ensure_list, + vol.Optional(CONF_AGENT_USER_ID, + default=DEFAULT_AGENT_USER_ID): cv.string, + vol.Optional(CONF_API_KEY): cv.string } }, extra=vol.ALLOW_EXTRA) +@bind_hass +def request_sync(hass): + """Request sync.""" + hass.services.call(DOMAIN, SERVICE_REQUEST_SYNC) + + @asyncio.coroutine def async_setup(hass: HomeAssistant, yaml_config: Dict[str, Any]): """Activate Google Actions component.""" config = yaml_config.get(DOMAIN, {}) - + agent_user_id = config.get(CONF_AGENT_USER_ID) + api_key = config.get(CONF_API_KEY) + if api_key is not None: + descriptions = yield from hass.async_add_job( + conf_util.load_yaml_config_file, os.path.join( + os.path.dirname(__file__), 'services.yaml') + ) hass.http.register_view(GoogleAssistantAuthView(hass, config)) hass.http.register_view(GoogleAssistantView(hass, config)) + @asyncio.coroutine + def request_sync_service_handler(call): + """Handle request sync service calls.""" + websession = async_get_clientsession(hass) + try: + with async_timeout.timeout(5, loop=hass.loop): + res = yield from websession.post( + REQUEST_SYNC_BASE_URL, + params={'key': api_key}, + json={'agent_user_id': agent_user_id}) + _LOGGER.info("Submitted request_sync request to Google") + res.raise_for_status() + except aiohttp.ClientResponseError: + body = yield from res.read() + _LOGGER.error( + 'request_sync request failed: %d %s', res.status, body) + except (asyncio.TimeoutError, aiohttp.ClientError): + _LOGGER.error("Could not contact Google for request_sync") + +# Register service only if api key is provided + if api_key is not None: + hass.services.async_register( + DOMAIN, SERVICE_REQUEST_SYNC, request_sync_service_handler, + descriptions.get(SERVICE_REQUEST_SYNC)) + return True diff --git a/homeassistant/components/google_assistant/const.py b/homeassistant/components/google_assistant/const.py index 80afad82938..c15f14bccdb 100644 --- a/homeassistant/components/google_assistant/const.py +++ b/homeassistant/components/google_assistant/const.py @@ -13,6 +13,8 @@ CONF_PROJECT_ID = 'project_id' CONF_ACCESS_TOKEN = 'access_token' CONF_CLIENT_ID = 'client_id' CONF_ALIASES = 'aliases' +CONF_AGENT_USER_ID = 'agent_user_id' +CONF_API_KEY = 'api_key' DEFAULT_EXPOSE_BY_DEFAULT = True DEFAULT_EXPOSED_DOMAINS = [ @@ -44,3 +46,7 @@ TYPE_LIGHT = PREFIX_TYPES + 'LIGHT' TYPE_SWITCH = PREFIX_TYPES + 'SWITCH' TYPE_SCENE = PREFIX_TYPES + 'SCENE' TYPE_THERMOSTAT = PREFIX_TYPES + 'THERMOSTAT' + +SERVICE_REQUEST_SYNC = 'request_sync' +HOMEGRAPH_URL = 'https://homegraph.googleapis.com/' +REQUEST_SYNC_BASE_URL = HOMEGRAPH_URL + 'v1/devices:requestSync' diff --git a/homeassistant/components/google_assistant/http.py b/homeassistant/components/google_assistant/http.py index 76b911e051a..1458d695163 100644 --- a/homeassistant/components/google_assistant/http.py +++ b/homeassistant/components/google_assistant/http.py @@ -21,10 +21,16 @@ from homeassistant.core import HomeAssistant # NOQA from homeassistant.helpers.entity import Entity # NOQA from .const import ( - CONF_ACCESS_TOKEN, CONF_EXPOSED_DOMAINS, ATTR_GOOGLE_ASSISTANT, - CONF_EXPOSE_BY_DEFAULT, DEFAULT_EXPOSED_DOMAINS, DEFAULT_EXPOSE_BY_DEFAULT, - GOOGLE_ASSISTANT_API_ENDPOINT) -from .smart_home import query_device, entity_to_device, determine_service + GOOGLE_ASSISTANT_API_ENDPOINT, + CONF_ACCESS_TOKEN, + DEFAULT_EXPOSE_BY_DEFAULT, + DEFAULT_EXPOSED_DOMAINS, + CONF_EXPOSE_BY_DEFAULT, + CONF_EXPOSED_DOMAINS, + ATTR_GOOGLE_ASSISTANT, + CONF_AGENT_USER_ID + ) +from .smart_home import entity_to_device, query_device, determine_service _LOGGER = logging.getLogger(__name__) @@ -45,6 +51,7 @@ class GoogleAssistantView(HomeAssistantView): DEFAULT_EXPOSE_BY_DEFAULT) self.exposed_domains = cfg.get(CONF_EXPOSED_DOMAINS, DEFAULT_EXPOSED_DOMAINS) + self.agent_user_id = cfg.get(CONF_AGENT_USER_ID) def is_entity_exposed(self, entity) -> bool: """Determine if an entity should be exposed to Google Assistant.""" @@ -82,7 +89,9 @@ class GoogleAssistantView(HomeAssistantView): devices.append(device) return self.json( - make_actions_response(request_id, {'devices': devices})) + make_actions_response(request_id, + {'agentUserId': self.agent_user_id, + 'devices': devices})) @asyncio.coroutine def handle_query(self, diff --git a/homeassistant/components/google_assistant/services.yaml b/homeassistant/components/google_assistant/services.yaml new file mode 100644 index 00000000000..6019b75bd98 --- /dev/null +++ b/homeassistant/components/google_assistant/services.yaml @@ -0,0 +1,2 @@ +request_sync: + description: Send a request_sync command to Google. \ No newline at end of file diff --git a/tests/components/google_assistant/test_init.py b/tests/components/google_assistant/test_init.py new file mode 100644 index 00000000000..9ced9fc329d --- /dev/null +++ b/tests/components/google_assistant/test_init.py @@ -0,0 +1,31 @@ +"""The tests for google-assistant init.""" +import asyncio + +from homeassistant.setup import async_setup_component +from homeassistant.components import google_assistant as ga + +GA_API_KEY = "Agdgjsj399sdfkosd932ksd" +GA_AGENT_USER_ID = "testid" + + +@asyncio.coroutine +def test_request_sync_service(aioclient_mock, hass): + """Test that it posts to the request_sync url.""" + aioclient_mock.post( + ga.const.REQUEST_SYNC_BASE_URL, status=200) + + yield from async_setup_component(hass, 'google_assistant', { + 'google_assistant': { + 'project_id': 'test_project', + 'client_id': 'r7328kwdsdfsdf03223409', + 'access_token': '8wdsfjsf932492342349234', + 'agent_user_id': GA_AGENT_USER_ID, + 'api_key': GA_API_KEY + }}) + + assert aioclient_mock.call_count == 0 + yield from hass.services.async_call(ga.const.DOMAIN, + ga.const.SERVICE_REQUEST_SYNC, + blocking=True) + + assert aioclient_mock.call_count == 1 From 46fe9ed200dd4e23c6ea52a0bb637d8d3c2d2fdb Mon Sep 17 00:00:00 2001 From: Anders Melchiorsen Date: Mon, 13 Nov 2017 18:03:12 +0100 Subject: [PATCH 024/246] Optimize concurrent access to media player image cache (#10345) We now do locking to ensure that an image is only downloaded and added once, even when requested by multiple media players at the same time. --- .../components/media_player/__init__.py | 67 +++++++++---------- 1 file changed, 31 insertions(+), 36 deletions(-) diff --git a/homeassistant/components/media_player/__init__.py b/homeassistant/components/media_player/__init__.py index e9b51874de3..89686c312bd 100644 --- a/homeassistant/components/media_player/__init__.py +++ b/homeassistant/components/media_player/__init__.py @@ -7,6 +7,7 @@ https://home-assistant.io/components/media_player/ import asyncio from datetime import timedelta import functools as ft +import collections import hashlib import logging import os @@ -44,13 +45,14 @@ SCAN_INTERVAL = timedelta(seconds=10) ENTITY_ID_FORMAT = DOMAIN + '.{}' ENTITY_IMAGE_URL = '/api/media_player_proxy/{0}?token={1}&cache={2}' -ATTR_CACHE_IMAGES = 'images' -ATTR_CACHE_URLS = 'urls' -ATTR_CACHE_MAXSIZE = 'maxsize' +CACHE_IMAGES = 'images' +CACHE_MAXSIZE = 'maxsize' +CACHE_LOCK = 'lock' +CACHE_URL = 'url' +CACHE_CONTENT = 'content' ENTITY_IMAGE_CACHE = { - ATTR_CACHE_IMAGES: {}, - ATTR_CACHE_URLS: [], - ATTR_CACHE_MAXSIZE: 16 + CACHE_IMAGES: collections.OrderedDict(), + CACHE_MAXSIZE: 16 } SERVICE_PLAY_MEDIA = 'play_media' @@ -894,43 +896,36 @@ def _async_fetch_image(hass, url): Images are cached in memory (the images are typically 10-100kB in size). """ - cache_images = ENTITY_IMAGE_CACHE[ATTR_CACHE_IMAGES] - cache_urls = ENTITY_IMAGE_CACHE[ATTR_CACHE_URLS] - cache_maxsize = ENTITY_IMAGE_CACHE[ATTR_CACHE_MAXSIZE] + cache_images = ENTITY_IMAGE_CACHE[CACHE_IMAGES] + cache_maxsize = ENTITY_IMAGE_CACHE[CACHE_MAXSIZE] - if url in cache_images: - return cache_images[url] + if url not in cache_images: + cache_images[url] = {CACHE_LOCK: asyncio.Lock(loop=hass.loop)} - content, content_type = (None, None) - websession = async_get_clientsession(hass) - try: - with async_timeout.timeout(10, loop=hass.loop): - response = yield from websession.get(url) + with (yield from cache_images[url][CACHE_LOCK]): + if CACHE_CONTENT in cache_images[url]: + return cache_images[url][CACHE_CONTENT] - if response.status == 200: - content = yield from response.read() - content_type = response.headers.get(CONTENT_TYPE) - if content_type: - content_type = content_type.split(';')[0] + content, content_type = (None, None) + websession = async_get_clientsession(hass) + try: + with async_timeout.timeout(10, loop=hass.loop): + response = yield from websession.get(url) - except asyncio.TimeoutError: - pass + if response.status == 200: + content = yield from response.read() + content_type = response.headers.get(CONTENT_TYPE) + if content_type: + content_type = content_type.split(';')[0] + cache_images[url][CACHE_CONTENT] = content, content_type - if not content: - return (None, None) + except asyncio.TimeoutError: + pass - cache_images[url] = (content, content_type) - cache_urls.append(url) + while len(cache_images) > cache_maxsize: + cache_images.popitem(last=False) - while len(cache_urls) > cache_maxsize: - # remove oldest item from cache - oldest_url = cache_urls[0] - if oldest_url in cache_images: - del cache_images[oldest_url] - - cache_urls = cache_urls[1:] - - return content, content_type + return content, content_type class MediaPlayerImageView(HomeAssistantView): From a6d9c7a621e929cef244688c89b6fa6510440f02 Mon Sep 17 00:00:00 2001 From: Ruslan Sayfutdinov Date: Mon, 13 Nov 2017 17:23:42 +0000 Subject: [PATCH 025/246] webostv: set current source correctly (#10548) --- .../components/media_player/webostv.py | 34 ++++++++----------- 1 file changed, 15 insertions(+), 19 deletions(-) diff --git a/homeassistant/components/media_player/webostv.py b/homeassistant/components/media_player/webostv.py index 8df8ceb0a8e..188f93da882 100644 --- a/homeassistant/components/media_player/webostv.py +++ b/homeassistant/components/media_player/webostv.py @@ -202,29 +202,25 @@ class LgWebOSDevice(MediaPlayerDevice): for app in self._client.get_apps(): self._app_list[app['id']] = app - if conf_sources: - if app['id'] == self._current_source_id: - self._current_source = app['title'] - self._source_list[app['title']] = app - elif (app['id'] in conf_sources or - any(word in app['title'] - for word in conf_sources) or - any(word in app['id'] - for word in conf_sources)): - self._source_list[app['title']] = app - else: + if app['id'] == self._current_source_id: self._current_source = app['title'] self._source_list[app['title']] = app + elif (not conf_sources or + app['id'] in conf_sources or + any(word in app['title'] + for word in conf_sources) or + any(word in app['id'] + for word in conf_sources)): + self._source_list[app['title']] = app for source in self._client.get_inputs(): - if conf_sources: - if source['id'] == self._current_source_id: - self._source_list[source['label']] = source - elif (source['label'] in conf_sources or - any(source['label'].find(word) != -1 - for word in conf_sources)): - self._source_list[source['label']] = source - else: + if source['id'] == self._current_source_id: + self._current_source = source['label'] + self._source_list[source['label']] = source + elif (not conf_sources or + source['label'] in conf_sources or + any(source['label'].find(word) != -1 + for word in conf_sources)): self._source_list[source['label']] = source except (OSError, ConnectionClosed, TypeError, asyncio.TimeoutError): From 6974f2366dfa4f01745f3b85c4f8c2aba7e392d5 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Mon, 13 Nov 2017 18:24:07 +0100 Subject: [PATCH 026/246] Upgrade pysnmp to 4.4.2 (#10539) --- homeassistant/components/device_tracker/snmp.py | 8 ++++---- homeassistant/components/sensor/snmp.py | 2 +- homeassistant/components/switch/snmp.py | 2 +- requirements_all.txt | 2 +- 4 files changed, 7 insertions(+), 7 deletions(-) diff --git a/homeassistant/components/device_tracker/snmp.py b/homeassistant/components/device_tracker/snmp.py index 8c1bf6dc67b..add027e1823 100644 --- a/homeassistant/components/device_tracker/snmp.py +++ b/homeassistant/components/device_tracker/snmp.py @@ -14,14 +14,14 @@ from homeassistant.components.device_tracker import ( DOMAIN, PLATFORM_SCHEMA, DeviceScanner) from homeassistant.const import CONF_HOST +REQUIREMENTS = ['pysnmp==4.4.2'] + _LOGGER = logging.getLogger(__name__) -REQUIREMENTS = ['pysnmp==4.4.1'] - -CONF_COMMUNITY = 'community' CONF_AUTHKEY = 'authkey' -CONF_PRIVKEY = 'privkey' CONF_BASEOID = 'baseoid' +CONF_COMMUNITY = 'community' +CONF_PRIVKEY = 'privkey' DEFAULT_COMMUNITY = 'public' diff --git a/homeassistant/components/sensor/snmp.py b/homeassistant/components/sensor/snmp.py index 841ff107826..982e7d9559b 100644 --- a/homeassistant/components/sensor/snmp.py +++ b/homeassistant/components/sensor/snmp.py @@ -16,7 +16,7 @@ from homeassistant.const import ( CONF_HOST, CONF_NAME, CONF_PORT, CONF_UNIT_OF_MEASUREMENT, STATE_UNKNOWN, CONF_VALUE_TEMPLATE) -REQUIREMENTS = ['pysnmp==4.4.1'] +REQUIREMENTS = ['pysnmp==4.4.2'] _LOGGER = logging.getLogger(__name__) diff --git a/homeassistant/components/switch/snmp.py b/homeassistant/components/switch/snmp.py index d372991c3e2..99ba9d8cd54 100644 --- a/homeassistant/components/switch/snmp.py +++ b/homeassistant/components/switch/snmp.py @@ -13,7 +13,7 @@ from homeassistant.const import ( CONF_HOST, CONF_NAME, CONF_PORT, CONF_PAYLOAD_ON, CONF_PAYLOAD_OFF) import homeassistant.helpers.config_validation as cv -REQUIREMENTS = ['pysnmp==4.4.1'] +REQUIREMENTS = ['pysnmp==4.4.2'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index 25bed72b32b..cd042c018de 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -789,7 +789,7 @@ pysma==0.1.3 # homeassistant.components.device_tracker.snmp # homeassistant.components.sensor.snmp # homeassistant.components.switch.snmp -pysnmp==4.4.1 +pysnmp==4.4.2 # homeassistant.components.sensor.thinkingcleaner # homeassistant.components.switch.thinkingcleaner From 3c135deec8f9b60aa043e88dfdf117272f1f278e Mon Sep 17 00:00:00 2001 From: Martin Hjelmare Date: Mon, 13 Nov 2017 21:12:15 +0100 Subject: [PATCH 027/246] Fix and clean lametric (#10391) * Fix and clean lametric * Add missing DEPENDENCIES in notify platform. * Remove not needed method in component manager class. * Don't overwrite notify DOMAIN. * Return consistently depending on found devices in setup of component. * Get new token if token expired * Add debug log for getting new token * Clean up --- homeassistant/components/lametric.py | 18 +++++++----------- homeassistant/components/notify/lametric.py | 17 ++++++++++++----- 2 files changed, 19 insertions(+), 16 deletions(-) diff --git a/homeassistant/components/lametric.py b/homeassistant/components/lametric.py index b11d874127f..d7c56734e42 100644 --- a/homeassistant/components/lametric.py +++ b/homeassistant/components/lametric.py @@ -38,15 +38,16 @@ def setup(hass, config): conf = config[DOMAIN] hlmn = HassLaMetricManager(client_id=conf[CONF_CLIENT_ID], client_secret=conf[CONF_CLIENT_SECRET]) - devices = hlmn.manager().get_devices() + devices = hlmn.manager.get_devices() + if not devices: + _LOGGER.error("No LaMetric devices found") + return False - found = False hass.data[DOMAIN] = hlmn for dev in devices: _LOGGER.debug("Discovered LaMetric device: %s", dev) - found = True - return found + return True class HassLaMetricManager(): @@ -63,7 +64,7 @@ class HassLaMetricManager(): from lmnotify import LaMetricManager _LOGGER.debug("Connecting to LaMetric") - self.lmn = LaMetricManager(client_id, client_secret) + self.manager = LaMetricManager(client_id, client_secret) self._client_id = client_id self._client_secret = client_secret @@ -75,9 +76,4 @@ class HassLaMetricManager(): """ from lmnotify import LaMetricManager _LOGGER.debug("Reconnecting to LaMetric") - self.lmn = LaMetricManager(self._client_id, - self._client_secret) - - def manager(self): - """Return the global LaMetricManager instance.""" - return self.lmn + self.manager = LaMetricManager(self._client_id, self._client_secret) diff --git a/homeassistant/components/notify/lametric.py b/homeassistant/components/notify/lametric.py index a3af1eb1914..32935419ee5 100644 --- a/homeassistant/components/notify/lametric.py +++ b/homeassistant/components/notify/lametric.py @@ -13,9 +13,10 @@ from homeassistant.components.notify import ( from homeassistant.const import CONF_ICON import homeassistant.helpers.config_validation as cv -from homeassistant.components.lametric import DOMAIN +from homeassistant.components.lametric import DOMAIN as LAMETRIC_DOMAIN REQUIREMENTS = ['lmnotify==0.0.4'] +DEPENDENCIES = ['lametric'] _LOGGER = logging.getLogger(__name__) @@ -30,7 +31,7 @@ PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ # pylint: disable=unused-variable def get_service(hass, config, discovery_info=None): """Get the Slack notification service.""" - hlmn = hass.data.get(DOMAIN) + hlmn = hass.data.get(LAMETRIC_DOMAIN) return LaMetricNotificationService(hlmn, config[CONF_ICON], config[CONF_DISPLAY_TIME] * 1000) @@ -49,6 +50,7 @@ class LaMetricNotificationService(BaseNotificationService): def send_message(self, message="", **kwargs): """Send a message to some LaMetric deviced.""" from lmnotify import SimpleFrame, Sound, Model + from oauthlib.oauth2 import TokenExpiredError targets = kwargs.get(ATTR_TARGET) data = kwargs.get(ATTR_DATA) @@ -82,10 +84,15 @@ class LaMetricNotificationService(BaseNotificationService): _LOGGER.debug(frames) model = Model(frames=frames) - lmn = self.hasslametricmanager.manager() - devices = lmn.get_devices() + lmn = self.hasslametricmanager.manager + try: + devices = lmn.get_devices() + except TokenExpiredError: + _LOGGER.debug("Token expired, fetching new token") + lmn.get_token() + devices = lmn.get_devices() for dev in devices: - if (targets is None) or (dev["name"] in targets): + if targets is None or dev["name"] in targets: lmn.set_device(dev) lmn.send_notification(model, lifetime=self._display_time) _LOGGER.debug("Sent notification to LaMetric %s", dev["name"]) From 2dcde12d38f65b8e4117ea531526034555662e42 Mon Sep 17 00:00:00 2001 From: Ari Lotter Date: Mon, 13 Nov 2017 17:10:39 -0500 Subject: [PATCH 028/246] Support presence detection using Hitron Coda router (#9682) * Support presence detection using Hitron Coda router * at least 2 spaces before inline comment * Update hitron_coda.py * rewrote authentication code, it actually works now * make line slightly shorter to comply with hound * Removed hardcoded IP address * Fix string formatting, add timeout, and use generator * Update hitron_coda.py * Update hitron_coda.py * Update hitron_coda.py * typo * update .coveragerc * Update stale URL --- .coveragerc | 1 + .../components/device_tracker/hitron_coda.py | 138 ++++++++++++++++++ 2 files changed, 139 insertions(+) create mode 100644 homeassistant/components/device_tracker/hitron_coda.py diff --git a/.coveragerc b/.coveragerc index 390e57e2e31..4ff7fa24102 100644 --- a/.coveragerc +++ b/.coveragerc @@ -309,6 +309,7 @@ omit = homeassistant/components/device_tracker/cisco_ios.py homeassistant/components/device_tracker/fritz.py homeassistant/components/device_tracker/gpslogger.py + homeassistant/components/device_tracker/hitron_coda.py homeassistant/components/device_tracker/huawei_router.py homeassistant/components/device_tracker/icloud.py homeassistant/components/device_tracker/keenetic_ndms2.py diff --git a/homeassistant/components/device_tracker/hitron_coda.py b/homeassistant/components/device_tracker/hitron_coda.py new file mode 100644 index 00000000000..17dc34d1040 --- /dev/null +++ b/homeassistant/components/device_tracker/hitron_coda.py @@ -0,0 +1,138 @@ +""" +Support for the Hitron CODA-4582U, provided by Rogers. + +For more details about this platform, please refer to the documentation at +https://home-assistant.io/components/device_tracker.hitron_coda/ +""" +import logging +from collections import namedtuple + +import requests +import voluptuous as vol + +import homeassistant.helpers.config_validation as cv +from homeassistant.components.device_tracker import ( + DOMAIN, PLATFORM_SCHEMA, DeviceScanner) +from homeassistant.const import ( + CONF_HOST, CONF_PASSWORD, CONF_USERNAME +) + +_LOGGER = logging.getLogger(__name__) + +PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ + vol.Required(CONF_HOST): cv.string, + vol.Required(CONF_USERNAME): cv.string, + vol.Required(CONF_PASSWORD): cv.string +}) + + +def get_scanner(_hass, config): + """Validate the configuration and return a Nmap scanner.""" + scanner = HitronCODADeviceScanner(config[DOMAIN]) + + return scanner if scanner.success_init else None + + +Device = namedtuple('Device', ['mac', 'name']) + + +class HitronCODADeviceScanner(DeviceScanner): + """This class scans for devices using the CODA's web interface.""" + + def __init__(self, config): + """Initialize the scanner.""" + self.last_results = [] + host = config[CONF_HOST] + self._url = 'http://{}/data/getConnectInfo.asp'.format(host) + self._loginurl = 'http://{}/goform/login'.format(host) + + self._username = config.get(CONF_USERNAME) + self._password = config.get(CONF_PASSWORD) + + self._userid = None + + self.success_init = self._update_info() + _LOGGER.info("Scanner initialized") + + def scan_devices(self): + """Scan for new devices and return a list with found device IDs.""" + self._update_info() + + return [device.mac for device in self.last_results] + + def get_device_name(self, mac): + """Return the name of the device with the given MAC address.""" + name = next(( + device.name for device in self.last_results + if device.mac == mac), None) + return name + + def _login(self): + """Log in to the router. This is required for subsequent api calls.""" + _LOGGER.info("Logging in to CODA...") + + try: + data = [ + ('user', self._username), + ('pws', self._password), + ] + res = requests.post(self._loginurl, data=data, timeout=10) + except requests.exceptions.Timeout: + _LOGGER.error( + "Connection to the router timed out at URL %s", self._url) + return False + if res.status_code != 200: + _LOGGER.error( + "Connection failed with http code %s", res.status_code) + return False + try: + self._userid = res.cookies['userid'] + return True + except KeyError: + _LOGGER.error("Failed to log in to router") + return False + + def _update_info(self): + """Get ARP from router.""" + _LOGGER.info("Fetching...") + + if self._userid is None: + if not self._login(): + _LOGGER.error("Could not obtain a user ID from the router") + return False + last_results = [] + + # doing a request + try: + res = requests.get(self._url, timeout=10, cookies={ + 'userid': self._userid + }) + except requests.exceptions.Timeout: + _LOGGER.error( + "Connection to the router timed out at URL %s", self._url) + return False + if res.status_code != 200: + _LOGGER.error( + "Connection failed with http code %s", res.status_code) + return False + try: + result = res.json() + except ValueError: + # If json decoder could not parse the response + _LOGGER.error("Failed to parse response from router") + return False + + # parsing response + for info in result: + mac = info['macAddr'] + name = info['hostName'] + # No address = no item :) + if mac is None: + continue + + last_results.append(Device(mac.upper(), name)) + + self.last_results = last_results + + _LOGGER.info("Request successful") + return True From e33451e2b94e021e21231417807c1f0f10358c70 Mon Sep 17 00:00:00 2001 From: ziotibia81 Date: Mon, 13 Nov 2017 23:27:15 +0100 Subject: [PATCH 029/246] Better support for int types (#10409) * Better int types support * type * Added optional register order * Fix white spaces * Fix line length * Fix line too long * Fix trailing whitespace * Stylistc code fixes --- homeassistant/components/sensor/modbus.py | 68 ++++++++++++++++++----- 1 file changed, 54 insertions(+), 14 deletions(-) diff --git a/homeassistant/components/sensor/modbus.py b/homeassistant/components/sensor/modbus.py index 0b2198bd396..b05b58344fb 100644 --- a/homeassistant/components/sensor/modbus.py +++ b/homeassistant/components/sensor/modbus.py @@ -11,7 +11,8 @@ import voluptuous as vol import homeassistant.components.modbus as modbus from homeassistant.const import ( - CONF_NAME, CONF_OFFSET, CONF_UNIT_OF_MEASUREMENT, CONF_SLAVE) + CONF_NAME, CONF_OFFSET, CONF_UNIT_OF_MEASUREMENT, CONF_SLAVE, + CONF_STRUCTURE) from homeassistant.helpers.entity import Entity from homeassistant.helpers import config_validation as cv from homeassistant.components.sensor import PLATFORM_SCHEMA @@ -21,6 +22,7 @@ _LOGGER = logging.getLogger(__name__) DEPENDENCIES = ['modbus'] CONF_COUNT = 'count' +CONF_REVERSE_ORDER = 'reverse_order' CONF_PRECISION = 'precision' CONF_REGISTER = 'register' CONF_REGISTERS = 'registers' @@ -32,7 +34,9 @@ REGISTER_TYPE_HOLDING = 'holding' REGISTER_TYPE_INPUT = 'input' DATA_TYPE_INT = 'int' +DATA_TYPE_UINT = 'uint' DATA_TYPE_FLOAT = 'float' +DATA_TYPE_CUSTOM = 'custom' PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Required(CONF_REGISTERS): [{ @@ -41,12 +45,15 @@ PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Optional(CONF_REGISTER_TYPE, default=REGISTER_TYPE_HOLDING): vol.In([REGISTER_TYPE_HOLDING, REGISTER_TYPE_INPUT]), vol.Optional(CONF_COUNT, default=1): cv.positive_int, + vol.Optional(CONF_REVERSE_ORDER, default=False): cv.boolean, vol.Optional(CONF_OFFSET, default=0): vol.Coerce(float), vol.Optional(CONF_PRECISION, default=0): cv.positive_int, vol.Optional(CONF_SCALE, default=1): vol.Coerce(float), vol.Optional(CONF_SLAVE): cv.positive_int, vol.Optional(CONF_DATA_TYPE, default=DATA_TYPE_INT): - vol.In([DATA_TYPE_INT, DATA_TYPE_FLOAT]), + vol.In([DATA_TYPE_INT, DATA_TYPE_UINT, DATA_TYPE_FLOAT, + DATA_TYPE_CUSTOM]), + vol.Optional(CONF_STRUCTURE): cv.string, vol.Optional(CONF_UNIT_OF_MEASUREMENT): cv.string }] }) @@ -55,7 +62,37 @@ PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the Modbus sensors.""" sensors = [] + data_types = {DATA_TYPE_INT: {1: 'h', 2: 'i', 4: 'q'}} + data_types[DATA_TYPE_UINT] = {1: 'H', 2: 'I', 4: 'Q'} + data_types[DATA_TYPE_FLOAT] = {1: 'e', 2: 'f', 4: 'd'} + for register in config.get(CONF_REGISTERS): + structure = '>i' + if register.get(CONF_DATA_TYPE) != DATA_TYPE_CUSTOM: + try: + structure = '>{:c}'.format(data_types[ + register.get(CONF_DATA_TYPE)][register.get(CONF_COUNT)]) + except KeyError: + _LOGGER.error("Unable to detect data type for %s sensor, " + "try a custom type.", register.get(CONF_NAME)) + continue + else: + structure = register.get(CONF_STRUCTURE) + + try: + size = struct.calcsize(structure) + except struct.error as err: + _LOGGER.error( + "Error in sensor %s structure: %s", + register.get(CONF_NAME), err) + continue + + if register.get(CONF_COUNT) * 2 != size: + _LOGGER.error( + "Structure size (%d bytes) mismatch registers count " + "(%d words)", size, register.get(CONF_COUNT)) + continue + sensors.append(ModbusRegisterSensor( register.get(CONF_NAME), register.get(CONF_SLAVE), @@ -63,10 +100,14 @@ def setup_platform(hass, config, add_devices, discovery_info=None): register.get(CONF_REGISTER_TYPE), register.get(CONF_UNIT_OF_MEASUREMENT), register.get(CONF_COUNT), + register.get(CONF_REVERSE_ORDER), register.get(CONF_SCALE), register.get(CONF_OFFSET), - register.get(CONF_DATA_TYPE), + structure, register.get(CONF_PRECISION))) + + if not sensors: + return False add_devices(sensors) @@ -74,8 +115,8 @@ class ModbusRegisterSensor(Entity): """Modbus register sensor.""" def __init__(self, name, slave, register, register_type, - unit_of_measurement, count, scale, offset, data_type, - precision): + unit_of_measurement, count, reverse_order, scale, offset, + structure, precision): """Initialize the modbus register sensor.""" self._name = name self._slave = int(slave) if slave else None @@ -83,10 +124,11 @@ class ModbusRegisterSensor(Entity): self._register_type = register_type self._unit_of_measurement = unit_of_measurement self._count = int(count) + self._reverse_order = reverse_order self._scale = scale self._offset = offset self._precision = precision - self._data_type = data_type + self._structure = structure self._value = None @property @@ -120,17 +162,15 @@ class ModbusRegisterSensor(Entity): try: registers = result.registers + if self._reverse_order: + registers.reverse() except AttributeError: _LOGGER.error("No response from modbus slave %s register %s", self._slave, self._register) return - if self._data_type == DATA_TYPE_FLOAT: - byte_string = b''.join( - [x.to_bytes(2, byteorder='big') for x in registers] - ) - val = struct.unpack(">f", byte_string)[0] - elif self._data_type == DATA_TYPE_INT: - for i, res in enumerate(registers): - val += res * (2**(i*16)) + byte_string = b''.join( + [x.to_bytes(2, byteorder='big') for x in registers] + ) + val = struct.unpack(self._structure, byte_string)[0] self._value = format( self._scale * val + self._offset, '.{}f'.format(self._precision)) From 7c24d7703180f32f7d19516e8de05de3df82a0e9 Mon Sep 17 00:00:00 2001 From: Kenny Millington Date: Tue, 14 Nov 2017 06:46:26 +0000 Subject: [PATCH 030/246] Don't use the 'id' field since it can be autogenerated (fixes #10551). (#10554) --- homeassistant/components/alexa/intent.py | 4 +- tests/components/alexa/test_intent.py | 63 ------------------------ 2 files changed, 1 insertion(+), 66 deletions(-) diff --git a/homeassistant/components/alexa/intent.py b/homeassistant/components/alexa/intent.py index 56887a8a701..c3a0155e312 100644 --- a/homeassistant/components/alexa/intent.py +++ b/homeassistant/components/alexa/intent.py @@ -155,9 +155,7 @@ class AlexaResponse(object): if 'value' not in resolved: continue - if 'id' in resolved['value']: - self.variables[underscored_key] = resolved['value']['id'] - elif 'name' in resolved['value']: + if 'name' in resolved['value']: self.variables[underscored_key] = resolved['value']['name'] def add_card(self, card_type, title, content): diff --git a/tests/components/alexa/test_intent.py b/tests/components/alexa/test_intent.py index 19ecf852622..097c91ded79 100644 --- a/tests/components/alexa/test_intent.py +++ b/tests/components/alexa/test_intent.py @@ -208,69 +208,6 @@ def test_intent_request_with_slots(alexa_client): assert text == "You told us your sign is virgo." -@asyncio.coroutine -def test_intent_request_with_slots_and_id_resolution(alexa_client): - """Test a request with slots and an id synonym.""" - data = { - "version": "1.0", - "session": { - "new": False, - "sessionId": SESSION_ID, - "application": { - "applicationId": APPLICATION_ID - }, - "attributes": { - "supportedHoroscopePeriods": { - "daily": True, - "weekly": False, - "monthly": False - } - }, - "user": { - "userId": "amzn1.account.AM3B00000000000000000000000" - } - }, - "request": { - "type": "IntentRequest", - "requestId": REQUEST_ID, - "timestamp": "2015-05-13T12:34:56Z", - "intent": { - "name": "GetZodiacHoroscopeIntent", - "slots": { - "ZodiacSign": { - "name": "ZodiacSign", - "value": "virgo", - "resolutions": { - "resolutionsPerAuthority": [ - { - "authority": AUTHORITY_ID, - "status": { - "code": "ER_SUCCESS_MATCH" - }, - "values": [ - { - "value": { - "name": "Virgo", - "id": "VIRGO" - } - } - ] - } - ] - } - } - } - } - } - } - req = yield from _intent_req(alexa_client, data) - assert req.status == 200 - data = yield from req.json() - text = data.get("response", {}).get("outputSpeech", - {}).get("text") - assert text == "You told us your sign is VIRGO." - - @asyncio.coroutine def test_intent_request_with_slots_and_name_resolution(alexa_client): """Test a request with slots and a name synonym.""" From b1afed9e52681a233d3e3067b511112dc72f90ae Mon Sep 17 00:00:00 2001 From: Steve Edson Date: Tue, 14 Nov 2017 08:18:06 +0000 Subject: [PATCH 031/246] pad packets to multiple of 4 characters (#10560) * pad packets to multiple of 4 characters This fixes sending commands, see #7669 * Update broadlink.py * removed whitespace --- homeassistant/components/switch/broadlink.py | 3 +++ 1 file changed, 3 insertions(+) diff --git a/homeassistant/components/switch/broadlink.py b/homeassistant/components/switch/broadlink.py index c12d13860e2..8abdba31b67 100644 --- a/homeassistant/components/switch/broadlink.py +++ b/homeassistant/components/switch/broadlink.py @@ -117,6 +117,9 @@ def setup_platform(hass, config, add_devices, discovery_info=None): for packet in packets: for retry in range(DEFAULT_RETRY): try: + extra = len(packet) % 4 + if extra > 0: + packet = packet + ('=' * (4 - extra)) payload = b64decode(packet) yield from hass.async_add_job( broadlink_device.send_data, payload) From d25f6767115feae4d5cab6de74af65884f720862 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Tue, 14 Nov 2017 10:36:18 +0100 Subject: [PATCH 032/246] Move temperature display helper from components to helpers (#10555) --- homeassistant/components/climate/__init__.py | 58 +++++------- .../components/climate/eq3btsmart.py | 25 +++--- homeassistant/components/climate/wink.py | 90 ++++++++++--------- homeassistant/components/weather/__init__.py | 36 +++----- homeassistant/components/weather/demo.py | 2 +- homeassistant/const.py | 5 ++ homeassistant/helpers/temperature.py | 33 +++++++ tests/components/weather/test_weather.py | 4 +- tests/helpers/test_temperature.py | 49 ++++++++++ 9 files changed, 186 insertions(+), 116 deletions(-) create mode 100644 homeassistant/helpers/temperature.py create mode 100644 tests/helpers/test_temperature.py diff --git a/homeassistant/components/climate/__init__.py b/homeassistant/components/climate/__init__.py index 61f5773356f..81a7adca1b7 100644 --- a/homeassistant/components/climate/__init__.py +++ b/homeassistant/components/climate/__init__.py @@ -9,12 +9,12 @@ from datetime import timedelta import logging import os import functools as ft -from numbers import Number import voluptuous as vol from homeassistant.config import load_yaml_config_file from homeassistant.loader import bind_hass +from homeassistant.helpers.temperature import display_temp as show_temp from homeassistant.util.temperature import convert as convert_temperature from homeassistant.helpers.entity_component import EntityComponent from homeassistant.helpers.entity import Entity @@ -22,7 +22,7 @@ from homeassistant.helpers.config_validation import PLATFORM_SCHEMA # noqa import homeassistant.helpers.config_validation as cv from homeassistant.const import ( ATTR_ENTITY_ID, ATTR_TEMPERATURE, STATE_ON, STATE_OFF, STATE_UNKNOWN, - TEMP_CELSIUS) + TEMP_CELSIUS, PRECISION_WHOLE, PRECISION_TENTHS) DOMAIN = 'climate' @@ -71,11 +71,6 @@ ATTR_OPERATION_LIST = 'operation_list' ATTR_SWING_MODE = 'swing_mode' ATTR_SWING_LIST = 'swing_list' -# The degree of precision for each platform -PRECISION_WHOLE = 1 -PRECISION_HALVES = 0.5 -PRECISION_TENTHS = 0.1 - CONVERTIBLE_ATTRIBUTE = [ ATTR_TEMPERATURE, ATTR_TARGET_TEMP_LOW, @@ -456,12 +451,18 @@ class ClimateDevice(Entity): def state_attributes(self): """Return the optional state attributes.""" data = { - ATTR_CURRENT_TEMPERATURE: - self._convert_for_display(self.current_temperature), - ATTR_MIN_TEMP: self._convert_for_display(self.min_temp), - ATTR_MAX_TEMP: self._convert_for_display(self.max_temp), - ATTR_TEMPERATURE: - self._convert_for_display(self.target_temperature), + ATTR_CURRENT_TEMPERATURE: show_temp( + self.hass, self.current_temperature, self.temperature_unit, + self.precision), + ATTR_MIN_TEMP: show_temp( + self.hass, self.min_temp, self.temperature_unit, + self.precision), + ATTR_MAX_TEMP: show_temp( + self.hass, self.max_temp, self.temperature_unit, + self.precision), + ATTR_TEMPERATURE: show_temp( + self.hass, self.target_temperature, self.temperature_unit, + self.precision), } if self.target_temperature_step is not None: @@ -469,10 +470,12 @@ class ClimateDevice(Entity): target_temp_high = self.target_temperature_high if target_temp_high is not None: - data[ATTR_TARGET_TEMP_HIGH] = self._convert_for_display( - self.target_temperature_high) - data[ATTR_TARGET_TEMP_LOW] = self._convert_for_display( - self.target_temperature_low) + data[ATTR_TARGET_TEMP_HIGH] = show_temp( + self.hass, self.target_temperature_high, self.temperature_unit, + self.precision) + data[ATTR_TARGET_TEMP_LOW] = show_temp( + self.hass, self.target_temperature_low, self.temperature_unit, + self.precision) humidity = self.target_humidity if humidity is not None: @@ -733,24 +736,3 @@ class ClimateDevice(Entity): def max_humidity(self): """Return the maximum humidity.""" return 99 - - def _convert_for_display(self, temp): - """Convert temperature into preferred units for display purposes.""" - if temp is None: - return temp - - # if the temperature is not a number this can cause issues - # with polymer components, so bail early there. - if not isinstance(temp, Number): - raise TypeError("Temperature is not a number: %s" % temp) - - if self.temperature_unit != self.unit_of_measurement: - temp = convert_temperature( - temp, self.temperature_unit, self.unit_of_measurement) - # Round in the units appropriate - if self.precision == PRECISION_HALVES: - return round(temp * 2) / 2.0 - elif self.precision == PRECISION_TENTHS: - return round(temp, 1) - # PRECISION_WHOLE as a fall back - return round(temp) diff --git a/homeassistant/components/climate/eq3btsmart.py b/homeassistant/components/climate/eq3btsmart.py index d70890317fd..dba096bb632 100644 --- a/homeassistant/components/climate/eq3btsmart.py +++ b/homeassistant/components/climate/eq3btsmart.py @@ -9,12 +9,9 @@ import logging import voluptuous as vol from homeassistant.components.climate import ( - ClimateDevice, PLATFORM_SCHEMA, PRECISION_HALVES, - STATE_AUTO, STATE_ON, STATE_OFF, -) + STATE_ON, STATE_OFF, STATE_AUTO, PLATFORM_SCHEMA, ClimateDevice) from homeassistant.const import ( - CONF_MAC, TEMP_CELSIUS, CONF_DEVICES, ATTR_TEMPERATURE) - + CONF_MAC, CONF_DEVICES, TEMP_CELSIUS, ATTR_TEMPERATURE, PRECISION_HALVES) import homeassistant.helpers.config_validation as cv REQUIREMENTS = ['python-eq3bt==0.1.6'] @@ -58,15 +55,17 @@ class EQ3BTSmartThermostat(ClimateDevice): def __init__(self, _mac, _name): """Initialize the thermostat.""" - # we want to avoid name clash with this module.. + # We want to avoid name clash with this module. import eq3bt as eq3 - self.modes = {eq3.Mode.Open: STATE_ON, - eq3.Mode.Closed: STATE_OFF, - eq3.Mode.Auto: STATE_AUTO, - eq3.Mode.Manual: STATE_MANUAL, - eq3.Mode.Boost: STATE_BOOST, - eq3.Mode.Away: STATE_AWAY} + self.modes = { + eq3.Mode.Open: STATE_ON, + eq3.Mode.Closed: STATE_OFF, + eq3.Mode.Auto: STATE_AUTO, + eq3.Mode.Manual: STATE_MANUAL, + eq3.Mode.Boost: STATE_BOOST, + eq3.Mode.Away: STATE_AWAY, + } self.reverse_modes = {v: k for k, v in self.modes.items()} @@ -153,11 +152,11 @@ class EQ3BTSmartThermostat(ClimateDevice): def device_state_attributes(self): """Return the device specific state attributes.""" dev_specific = { + ATTR_STATE_AWAY_END: self._thermostat.away_end, ATTR_STATE_LOCKED: self._thermostat.locked, ATTR_STATE_LOW_BAT: self._thermostat.low_battery, ATTR_STATE_VALVE: self._thermostat.valve_state, ATTR_STATE_WINDOW_OPEN: self._thermostat.window_open, - ATTR_STATE_AWAY_END: self._thermostat.away_end, } return dev_specific diff --git a/homeassistant/components/climate/wink.py b/homeassistant/components/climate/wink.py index 75627f11a71..54d8d8617c7 100644 --- a/homeassistant/components/climate/wink.py +++ b/homeassistant/components/climate/wink.py @@ -4,46 +4,51 @@ Support for Wink thermostats, Air Conditioners, and Water Heaters. For more details about this platform, please refer to the documentation at https://home-assistant.io/components/climate.wink/ """ -import logging import asyncio +import logging -from homeassistant.components.wink import WinkDevice, DOMAIN from homeassistant.components.climate import ( - STATE_AUTO, STATE_COOL, STATE_HEAT, ClimateDevice, - ATTR_TARGET_TEMP_HIGH, ATTR_TARGET_TEMP_LOW, - ATTR_TEMPERATURE, STATE_FAN_ONLY, - ATTR_CURRENT_HUMIDITY, STATE_ECO, STATE_ELECTRIC, - STATE_PERFORMANCE, STATE_HIGH_DEMAND, - STATE_HEAT_PUMP, STATE_GAS) + STATE_ECO, STATE_GAS, STATE_AUTO, STATE_COOL, STATE_HEAT, STATE_ELECTRIC, + STATE_FAN_ONLY, STATE_HEAT_PUMP, ATTR_TEMPERATURE, STATE_HIGH_DEMAND, + STATE_PERFORMANCE, ATTR_TARGET_TEMP_LOW, ATTR_CURRENT_HUMIDITY, + ATTR_TARGET_TEMP_HIGH, ClimateDevice) +from homeassistant.components.wink import DOMAIN, WinkDevice from homeassistant.const import ( - TEMP_CELSIUS, STATE_ON, - STATE_OFF, STATE_UNKNOWN) + STATE_ON, STATE_OFF, TEMP_CELSIUS, STATE_UNKNOWN, PRECISION_TENTHS) +from homeassistant.helpers.temperature import display_temp as show_temp _LOGGER = logging.getLogger(__name__) +ATTR_ECO_TARGET = 'eco_target' +ATTR_EXTERNAL_TEMPERATURE = 'external_temperature' +ATTR_OCCUPIED = 'occupied' +ATTR_RHEEM_TYPE = 'rheem_type' +ATTR_SCHEDULE_ENABLED = 'schedule_enabled' +ATTR_SMART_TEMPERATURE = 'smart_temperature' +ATTR_TOTAL_CONSUMPTION = 'total_consumption' +ATTR_VACATION_MODE = 'vacation_mode' + DEPENDENCIES = ['wink'] SPEED_LOW = 'low' SPEED_MEDIUM = 'medium' SPEED_HIGH = 'high' -HA_STATE_TO_WINK = {STATE_AUTO: 'auto', - STATE_ECO: 'eco', - STATE_FAN_ONLY: 'fan_only', - STATE_HEAT: 'heat_only', - STATE_COOL: 'cool_only', - STATE_PERFORMANCE: 'performance', - STATE_HIGH_DEMAND: 'high_demand', - STATE_HEAT_PUMP: 'heat_pump', - STATE_ELECTRIC: 'electric_only', - STATE_GAS: 'gas', - STATE_OFF: 'off'} -WINK_STATE_TO_HA = {value: key for key, value in HA_STATE_TO_WINK.items()} +HA_STATE_TO_WINK = { + STATE_AUTO: 'auto', + STATE_COOL: 'cool_only', + STATE_ECO: 'eco', + STATE_ELECTRIC: 'electric_only', + STATE_FAN_ONLY: 'fan_only', + STATE_GAS: 'gas', + STATE_HEAT: 'heat_only', + STATE_HEAT_PUMP: 'heat_pump', + STATE_HIGH_DEMAND: 'high_demand', + STATE_OFF: 'off', + STATE_PERFORMANCE: 'performance', +} -ATTR_EXTERNAL_TEMPERATURE = "external_temperature" -ATTR_SMART_TEMPERATURE = "smart_temperature" -ATTR_ECO_TARGET = "eco_target" -ATTR_OCCUPIED = "occupied" +WINK_STATE_TO_HA = {value: key for key, value in HA_STATE_TO_WINK.items()} def setup_platform(hass, config, add_devices, discovery_info=None): @@ -85,15 +90,18 @@ class WinkThermostat(WinkDevice, ClimateDevice): target_temp_high = self.target_temperature_high target_temp_low = self.target_temperature_low if target_temp_high is not None: - data[ATTR_TARGET_TEMP_HIGH] = self._convert_for_display( - self.target_temperature_high) + data[ATTR_TARGET_TEMP_HIGH] = show_temp( + self.hass, self.target_temperature_high, self.temperature_unit, + PRECISION_TENTHS) if target_temp_low is not None: - data[ATTR_TARGET_TEMP_LOW] = self._convert_for_display( - self.target_temperature_low) + data[ATTR_TARGET_TEMP_LOW] = show_temp( + self.hass, self.target_temperature_low, self.temperature_unit, + PRECISION_TENTHS) if self.external_temperature: - data[ATTR_EXTERNAL_TEMPERATURE] = self._convert_for_display( - self.external_temperature) + data[ATTR_EXTERNAL_TEMPERATURE] = show_temp( + self.hass, self.external_temperature, self.temperature_unit, + PRECISION_TENTHS) if self.smart_temperature: data[ATTR_SMART_TEMPERATURE] = self.smart_temperature @@ -358,13 +366,15 @@ class WinkAC(WinkDevice, ClimateDevice): target_temp_high = self.target_temperature_high target_temp_low = self.target_temperature_low if target_temp_high is not None: - data[ATTR_TARGET_TEMP_HIGH] = self._convert_for_display( - self.target_temperature_high) + data[ATTR_TARGET_TEMP_HIGH] = show_temp( + self.hass, self.target_temperature_high, self.temperature_unit, + PRECISION_TENTHS) if target_temp_low is not None: - data[ATTR_TARGET_TEMP_LOW] = self._convert_for_display( - self.target_temperature_low) - data["total_consumption"] = self.wink.total_consumption() - data["schedule_enabled"] = self.wink.schedule_enabled() + data[ATTR_TARGET_TEMP_LOW] = show_temp( + self.hass, self.target_temperature_low, self.temperature_unit, + PRECISION_TENTHS) + data[ATTR_TOTAL_CONSUMPTION] = self.wink.total_consumption() + data[ATTR_SCHEDULE_ENABLED] = self.wink.schedule_enabled() return data @@ -471,8 +481,8 @@ class WinkWaterHeater(WinkDevice, ClimateDevice): def device_state_attributes(self): """Return the optional state attributes.""" data = {} - data["vacation_mode"] = self.wink.vacation_mode_enabled() - data["rheem_type"] = self.wink.rheem_type() + data[ATTR_VACATION_MODE] = self.wink.vacation_mode_enabled() + data[ATTR_RHEEM_TYPE] = self.wink.rheem_type() return data diff --git a/homeassistant/components/weather/__init__.py b/homeassistant/components/weather/__init__.py index 9e927da893e..acb95c17814 100644 --- a/homeassistant/components/weather/__init__.py +++ b/homeassistant/components/weather/__init__.py @@ -6,11 +6,10 @@ https://home-assistant.io/components/weather/ """ import asyncio import logging -from numbers import Number -from homeassistant.const import TEMP_CELSIUS from homeassistant.helpers.entity_component import EntityComponent -from homeassistant.util.temperature import convert as convert_temperature +from homeassistant.helpers.temperature import display_temp as show_temp +from homeassistant.const import PRECISION_WHOLE, PRECISION_TENTHS, TEMP_CELSIUS from homeassistant.helpers.config_validation import PLATFORM_SCHEMA # noqa from homeassistant.helpers.entity import Entity @@ -98,11 +97,19 @@ class WeatherEntity(Entity): """Return the forecast.""" return None + @property + def precision(self): + """Return the forecast.""" + return PRECISION_TENTHS if self.temperature_unit == TEMP_CELSIUS \ + else PRECISION_WHOLE + @property def state_attributes(self): """Return the state attributes.""" data = { - ATTR_WEATHER_TEMPERATURE: self._temp_for_display(self.temperature), + ATTR_WEATHER_TEMPERATURE: show_temp( + self.hass, self.temperature, self.temperature_unit, + self.precision), ATTR_WEATHER_HUMIDITY: self.humidity, } @@ -134,8 +141,9 @@ class WeatherEntity(Entity): forecast = [] for forecast_entry in self.forecast: forecast_entry = dict(forecast_entry) - forecast_entry[ATTR_FORECAST_TEMP] = self._temp_for_display( - forecast_entry[ATTR_FORECAST_TEMP]) + forecast_entry[ATTR_FORECAST_TEMP] = show_temp( + self.hass, forecast_entry[ATTR_FORECAST_TEMP], + self.temperature_unit, self.precision) forecast.append(forecast_entry) data[ATTR_FORECAST] = forecast @@ -151,19 +159,3 @@ class WeatherEntity(Entity): def condition(self): """Return the current condition.""" raise NotImplementedError() - - def _temp_for_display(self, temp): - """Convert temperature into preferred units for display purposes.""" - unit = self.temperature_unit - hass_unit = self.hass.config.units.temperature_unit - - if (temp is None or not isinstance(temp, Number) or - unit == hass_unit): - return temp - - value = convert_temperature(temp, unit, hass_unit) - - if hass_unit == TEMP_CELSIUS: - return round(value, 1) - # Users of fahrenheit generally expect integer units. - return round(value) diff --git a/homeassistant/components/weather/demo.py b/homeassistant/components/weather/demo.py index 0a404447346..02e07996213 100644 --- a/homeassistant/components/weather/demo.py +++ b/homeassistant/components/weather/demo.py @@ -31,7 +31,7 @@ CONDITION_CLASSES = { def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the Demo weather.""" add_devices([ - DemoWeather('South', 'Sunshine', 21, 92, 1099, 0.5, TEMP_CELSIUS, + DemoWeather('South', 'Sunshine', 21.6414, 92, 1099, 0.5, TEMP_CELSIUS, [22, 19, 15, 12, 14, 18, 21]), DemoWeather('North', 'Shower rain', -12, 54, 987, 4.8, TEMP_FAHRENHEIT, [-10, -13, -18, -23, -19, -14, -9]) diff --git a/homeassistant/const.py b/homeassistant/const.py index de3f60e825f..90aa2c52483 100644 --- a/homeassistant/const.py +++ b/homeassistant/const.py @@ -417,3 +417,8 @@ SPEED_MS = 'speed_ms' # type: str ILLUMINANCE = 'illuminance' # type: str WEEKDAYS = ['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun'] + +# The degree of precision for platforms +PRECISION_WHOLE = 1 +PRECISION_HALVES = 0.5 +PRECISION_TENTHS = 0.1 diff --git a/homeassistant/helpers/temperature.py b/homeassistant/helpers/temperature.py new file mode 100644 index 00000000000..a4626c33210 --- /dev/null +++ b/homeassistant/helpers/temperature.py @@ -0,0 +1,33 @@ +"""Temperature helpers for Home Assistant.""" +from numbers import Number + +from homeassistant.core import HomeAssistant +from homeassistant.util.temperature import convert as convert_temperature + + +def display_temp(hass: HomeAssistant, temperature: float, unit: str, + precision: float) -> float: + """Convert temperature into preferred units for display purposes.""" + temperature_unit = unit + ha_unit = hass.config.units.temperature_unit + + if temperature is None: + return temperature + + # If the temperature is not a number this can cause issues + # with Polymer components, so bail early there. + if not isinstance(temperature, Number): + raise TypeError( + "Temperature is not a number: {}".format(temperature)) + + if temperature_unit != ha_unit: + temperature = convert_temperature( + temperature, temperature_unit, ha_unit) + + # Round in the units appropriate + if precision == 0.5: + return round(temperature * 2) / 2.0 + elif precision == 0.1: + return round(temperature, 1) + # Integer as a fall back (PRECISION_WHOLE) + return round(temperature) diff --git a/tests/components/weather/test_weather.py b/tests/components/weather/test_weather.py index 1563dd377c4..9d22b1ad0ae 100644 --- a/tests/components/weather/test_weather.py +++ b/tests/components/weather/test_weather.py @@ -37,7 +37,7 @@ class TestWeather(unittest.TestCase): assert state.state == 'sunny' data = state.attributes - assert data.get(ATTR_WEATHER_TEMPERATURE) == 21 + assert data.get(ATTR_WEATHER_TEMPERATURE) == 21.6 assert data.get(ATTR_WEATHER_HUMIDITY) == 92 assert data.get(ATTR_WEATHER_PRESSURE) == 1099 assert data.get(ATTR_WEATHER_WIND_SPEED) == 0.5 @@ -57,4 +57,4 @@ class TestWeather(unittest.TestCase): assert state.state == 'rainy' data = state.attributes - assert data.get(ATTR_WEATHER_TEMPERATURE) == -24.4 + assert data.get(ATTR_WEATHER_TEMPERATURE) == -24 diff --git a/tests/helpers/test_temperature.py b/tests/helpers/test_temperature.py new file mode 100644 index 00000000000..96e7bd6c74f --- /dev/null +++ b/tests/helpers/test_temperature.py @@ -0,0 +1,49 @@ +"""Tests Home Assistant temperature helpers.""" +import unittest + +from tests.common import get_test_home_assistant + +from homeassistant.const import ( + TEMP_CELSIUS, PRECISION_WHOLE, TEMP_FAHRENHEIT, PRECISION_HALVES, + PRECISION_TENTHS) +from homeassistant.helpers.temperature import display_temp +from homeassistant.util.unit_system import METRIC_SYSTEM + +TEMP = 24.636626 + + +class TestHelpersTemperature(unittest.TestCase): + """Setup the temperature tests.""" + + def setUp(self): + """Setup the tests.""" + self.hass = get_test_home_assistant() + self.hass.config.unit_system = METRIC_SYSTEM + + def tearDown(self): + """Stop down stuff we started.""" + self.hass.stop() + + def test_temperature_not_a_number(self): + """Test that temperature is a number.""" + temp = "Temperature" + with self.assertRaises(Exception) as context: + display_temp(self.hass, temp, TEMP_CELSIUS, PRECISION_HALVES) + + self.assertTrue("Temperature is not a number: {}".format(temp) + in str(context.exception)) + + def test_celsius_halves(self): + """Test temperature to celsius rounding to halves.""" + self.assertEqual(24.5, display_temp( + self.hass, TEMP, TEMP_CELSIUS, PRECISION_HALVES)) + + def test_celsius_tenths(self): + """Test temperature to celsius rounding to tenths.""" + self.assertEqual(24.6, display_temp( + self.hass, TEMP, TEMP_CELSIUS, PRECISION_TENTHS)) + + def test_fahrenheit_wholes(self): + """Test temperature to fahrenheit rounding to wholes.""" + self.assertEqual(-4, display_temp( + self.hass, TEMP, TEMP_FAHRENHEIT, PRECISION_WHOLE)) From 637b058a7ec3e063f9e40d3443b4ec0657424ec7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ab=C3=ADlio=20Costa?= Date: Tue, 14 Nov 2017 09:37:52 +0000 Subject: [PATCH 033/246] webostv: Reduce default timeout to prevent log spamming (#10564) With the default timeout of 10 seconds, the log gets filled up with "component is taking more than 10 seconds" errors. This should probably be fixed in some other way, but for now this reduces the problem a bit. --- homeassistant/components/media_player/webostv.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/homeassistant/components/media_player/webostv.py b/homeassistant/components/media_player/webostv.py index 188f93da882..3215ad82a7c 100644 --- a/homeassistant/components/media_player/webostv.py +++ b/homeassistant/components/media_player/webostv.py @@ -57,7 +57,7 @@ PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Optional(CONF_HOST): cv.string, vol.Optional(CONF_CUSTOMIZE, default={}): CUSTOMIZE_SCHEMA, vol.Optional(CONF_FILENAME, default=WEBOSTV_CONFIG_FILE): cv.string, - vol.Optional(CONF_TIMEOUT, default=10): cv.positive_int, + vol.Optional(CONF_TIMEOUT, default=8): cv.positive_int, vol.Optional(CONF_ON_ACTION): cv.SCRIPT_SCHEMA, }) From dc6e50c39d6c28628b5010b1dd07f02b31177b01 Mon Sep 17 00:00:00 2001 From: Martin Hjelmare Date: Tue, 14 Nov 2017 10:40:44 +0100 Subject: [PATCH 034/246] Fix lametric sound (#10562) * Fix sound for lametric notify * Remove not used method --- homeassistant/components/lametric.py | 18 +----------------- homeassistant/components/notify/lametric.py | 7 +------ 2 files changed, 2 insertions(+), 23 deletions(-) diff --git a/homeassistant/components/lametric.py b/homeassistant/components/lametric.py index d7c56734e42..49b4f73ea17 100644 --- a/homeassistant/components/lametric.py +++ b/homeassistant/components/lametric.py @@ -51,13 +51,7 @@ def setup(hass, config): class HassLaMetricManager(): - """ - A class that encapsulated requests to the LaMetric manager. - - As the original class does not have a re-connect feature that is needed - for applications running for a long time as the OAuth tokens expire. This - class implements this reconnect() feature. - """ + """A class that encapsulated requests to the LaMetric manager.""" def __init__(self, client_id, client_secret): """Initialize HassLaMetricManager and connect to LaMetric.""" @@ -67,13 +61,3 @@ class HassLaMetricManager(): self.manager = LaMetricManager(client_id, client_secret) self._client_id = client_id self._client_secret = client_secret - - def reconnect(self): - """ - Reconnect to LaMetric. - - This is usually necessary when the OAuth token is expired. - """ - from lmnotify import LaMetricManager - _LOGGER.debug("Reconnecting to LaMetric") - self.manager = LaMetricManager(self._client_id, self._client_secret) diff --git a/homeassistant/components/notify/lametric.py b/homeassistant/components/notify/lametric.py index 32935419ee5..56030afb30c 100644 --- a/homeassistant/components/notify/lametric.py +++ b/homeassistant/components/notify/lametric.py @@ -78,12 +78,7 @@ class LaMetricNotificationService(BaseNotificationService): frames = [text_frame] - if sound is not None: - frames.append(sound) - - _LOGGER.debug(frames) - - model = Model(frames=frames) + model = Model(frames=frames, sound=sound) lmn = self.hasslametricmanager.manager try: devices = lmn.get_devices() From e947e6a143b7ee4ff2cc9b55eae6a0c9f19a0ccc Mon Sep 17 00:00:00 2001 From: Eugenio Panadero Date: Tue, 14 Nov 2017 11:41:19 +0100 Subject: [PATCH 035/246] Use a template for the Universal media player state (#10395) * Implementation of `state_template` for the Universal media_player * add tracking to entities in state template * use normal config_validation * fix tests, use defaults in platform schema, remove extra keys * and test the new option `state_template` * lint fixes * no need to check attributes against None * use `async_added_to_hass` and call `async_track_state_change` from `hass.helpers` --- .../components/media_player/universal.py | 164 +++++++---------- homeassistant/const.py | 1 + .../components/media_player/test_universal.py | 167 ++++++++++-------- 3 files changed, 155 insertions(+), 177 deletions(-) diff --git a/homeassistant/components/media_player/universal.py b/homeassistant/components/media_player/universal.py index 9647f04f5c3..a7173e35a48 100644 --- a/homeassistant/components/media_player/universal.py +++ b/homeassistant/components/media_player/universal.py @@ -9,28 +9,30 @@ import logging # pylint: disable=import-error from copy import copy +import voluptuous as vol + from homeassistant.core import callback from homeassistant.components.media_player import ( - ATTR_APP_ID, ATTR_APP_NAME, ATTR_MEDIA_ALBUM_ARTIST, ATTR_MEDIA_ALBUM_NAME, - ATTR_MEDIA_ARTIST, ATTR_MEDIA_CHANNEL, ATTR_MEDIA_CONTENT_ID, - ATTR_MEDIA_CONTENT_TYPE, ATTR_MEDIA_DURATION, ATTR_MEDIA_EPISODE, - ATTR_MEDIA_PLAYLIST, ATTR_MEDIA_SEASON, ATTR_MEDIA_SEEK_POSITION, - ATTR_MEDIA_SERIES_TITLE, ATTR_MEDIA_TITLE, ATTR_MEDIA_TRACK, - ATTR_MEDIA_VOLUME_LEVEL, ATTR_MEDIA_VOLUME_MUTED, ATTR_INPUT_SOURCE_LIST, - ATTR_MEDIA_POSITION, ATTR_MEDIA_SHUFFLE, - ATTR_MEDIA_POSITION_UPDATED_AT, DOMAIN, SERVICE_PLAY_MEDIA, + ATTR_APP_ID, ATTR_APP_NAME, ATTR_INPUT_SOURCE, ATTR_INPUT_SOURCE_LIST, + ATTR_MEDIA_ALBUM_ARTIST, ATTR_MEDIA_ALBUM_NAME, ATTR_MEDIA_ARTIST, + ATTR_MEDIA_CHANNEL, ATTR_MEDIA_CONTENT_ID, ATTR_MEDIA_CONTENT_TYPE, + ATTR_MEDIA_DURATION, ATTR_MEDIA_EPISODE, ATTR_MEDIA_PLAYLIST, + ATTR_MEDIA_POSITION, ATTR_MEDIA_POSITION_UPDATED_AT, ATTR_MEDIA_SEASON, + ATTR_MEDIA_SEEK_POSITION, ATTR_MEDIA_SERIES_TITLE, ATTR_MEDIA_SHUFFLE, + ATTR_MEDIA_TITLE, ATTR_MEDIA_TRACK, ATTR_MEDIA_VOLUME_LEVEL, + ATTR_MEDIA_VOLUME_MUTED, DOMAIN, MediaPlayerDevice, PLATFORM_SCHEMA, + SERVICE_CLEAR_PLAYLIST, SERVICE_PLAY_MEDIA, SERVICE_SELECT_SOURCE, + SUPPORT_CLEAR_PLAYLIST, SUPPORT_SELECT_SOURCE, SUPPORT_SHUFFLE_SET, SUPPORT_TURN_OFF, SUPPORT_TURN_ON, SUPPORT_VOLUME_MUTE, SUPPORT_VOLUME_SET, - SUPPORT_VOLUME_STEP, SUPPORT_SELECT_SOURCE, SUPPORT_CLEAR_PLAYLIST, - SUPPORT_SHUFFLE_SET, ATTR_INPUT_SOURCE, SERVICE_SELECT_SOURCE, - SERVICE_CLEAR_PLAYLIST, MediaPlayerDevice) + SUPPORT_VOLUME_STEP) from homeassistant.const import ( - ATTR_ENTITY_ID, ATTR_ENTITY_PICTURE, CONF_NAME, SERVICE_MEDIA_NEXT_TRACK, - SERVICE_MEDIA_PAUSE, SERVICE_MEDIA_PLAY, SERVICE_MEDIA_PLAY_PAUSE, - SERVICE_MEDIA_PREVIOUS_TRACK, SERVICE_MEDIA_SEEK, SERVICE_TURN_OFF, - SERVICE_TURN_ON, SERVICE_VOLUME_DOWN, SERVICE_VOLUME_MUTE, - SERVICE_VOLUME_SET, SERVICE_VOLUME_UP, SERVICE_SHUFFLE_SET, STATE_IDLE, - STATE_OFF, STATE_ON, SERVICE_MEDIA_STOP, ATTR_SUPPORTED_FEATURES) -from homeassistant.helpers.event import async_track_state_change + ATTR_ENTITY_ID, ATTR_ENTITY_PICTURE, ATTR_SUPPORTED_FEATURES, CONF_NAME, + CONF_STATE_TEMPLATE, SERVICE_MEDIA_NEXT_TRACK, SERVICE_MEDIA_PAUSE, + SERVICE_MEDIA_PLAY, SERVICE_MEDIA_PLAY_PAUSE, SERVICE_MEDIA_PREVIOUS_TRACK, + SERVICE_MEDIA_SEEK, SERVICE_TURN_OFF, SERVICE_TURN_ON, SERVICE_VOLUME_DOWN, + SERVICE_VOLUME_MUTE, SERVICE_VOLUME_SET, SERVICE_VOLUME_UP, + SERVICE_SHUFFLE_SET, STATE_IDLE, STATE_OFF, STATE_ON, SERVICE_MEDIA_STOP) +from homeassistant.helpers import config_validation as cv from homeassistant.helpers.service import async_call_from_config ATTR_ACTIVE_CHILD = 'active_child' @@ -48,113 +50,75 @@ OFF_STATES = [STATE_IDLE, STATE_OFF] REQUIREMENTS = [] _LOGGER = logging.getLogger(__name__) +ATTRS_SCHEMA = vol.Schema({cv.slug: cv.string}) +CMD_SCHEMA = vol.Schema({cv.slug: cv.SERVICE_SCHEMA}) + +PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ + vol.Required(CONF_NAME): cv.string, + vol.Optional(CONF_CHILDREN, default=[]): cv.entity_ids, + vol.Optional(CONF_COMMANDS, default={}): CMD_SCHEMA, + vol.Optional(CONF_ATTRS, default={}): + vol.Or(cv.ensure_list(ATTRS_SCHEMA), ATTRS_SCHEMA), + vol.Optional(CONF_STATE_TEMPLATE): cv.template +}, extra=vol.REMOVE_EXTRA) + @asyncio.coroutine def async_setup_platform(hass, config, async_add_devices, discovery_info=None): """Set up the universal media players.""" - if not validate_config(config): - return - player = UniversalMediaPlayer( hass, - config[CONF_NAME], - config[CONF_CHILDREN], - config[CONF_COMMANDS], - config[CONF_ATTRS] + config.get(CONF_NAME), + config.get(CONF_CHILDREN), + config.get(CONF_COMMANDS), + config.get(CONF_ATTRS), + config.get(CONF_STATE_TEMPLATE) ) async_add_devices([player]) -def validate_config(config): - """Validate universal media player configuration.""" - del config[CONF_PLATFORM] - - # Validate name - if CONF_NAME not in config: - _LOGGER.error("Universal Media Player configuration requires name") - return False - - validate_children(config) - validate_commands(config) - validate_attributes(config) - - del_keys = [] - for key in config: - if key not in [CONF_NAME, CONF_CHILDREN, CONF_COMMANDS, CONF_ATTRS]: - _LOGGER.warning( - "Universal Media Player (%s) unrecognized parameter %s", - config[CONF_NAME], key) - del_keys.append(key) - for key in del_keys: - del config[key] - - return True - - -def validate_children(config): - """Validate children.""" - if CONF_CHILDREN not in config: - _LOGGER.info( - "No children under Universal Media Player (%s)", config[CONF_NAME]) - config[CONF_CHILDREN] = [] - elif not isinstance(config[CONF_CHILDREN], list): - _LOGGER.warning( - "Universal Media Player (%s) children not list in config. " - "They will be ignored", config[CONF_NAME]) - config[CONF_CHILDREN] = [] - - -def validate_commands(config): - """Validate commands.""" - if CONF_COMMANDS not in config: - config[CONF_COMMANDS] = {} - elif not isinstance(config[CONF_COMMANDS], dict): - _LOGGER.warning( - "Universal Media Player (%s) specified commands not dict in " - "config. They will be ignored", config[CONF_NAME]) - config[CONF_COMMANDS] = {} - - -def validate_attributes(config): - """Validate attributes.""" - if CONF_ATTRS not in config: - config[CONF_ATTRS] = {} - elif not isinstance(config[CONF_ATTRS], dict): - _LOGGER.warning( - "Universal Media Player (%s) specified attributes " - "not dict in config. They will be ignored", config[CONF_NAME]) - config[CONF_ATTRS] = {} - - for key, val in config[CONF_ATTRS].items(): - attr = val.split('|', 1) - if len(attr) == 1: - attr.append(None) - config[CONF_ATTRS][key] = attr - - class UniversalMediaPlayer(MediaPlayerDevice): """Representation of an universal media player.""" - def __init__(self, hass, name, children, commands, attributes): + def __init__(self, hass, name, children, + commands, attributes, state_template=None): """Initialize the Universal media device.""" self.hass = hass self._name = name self._children = children self._cmds = commands - self._attrs = attributes + self._attrs = {} + for key, val in attributes.items(): + attr = val.split('|', 1) + if len(attr) == 1: + attr.append(None) + self._attrs[key] = attr self._child_state = None + self._state_template = state_template + if state_template is not None: + self._state_template.hass = hass + @asyncio.coroutine + def async_added_to_hass(self): + """Subscribe to children and template state changes. + + This method must be run in the event loop and returns a coroutine. + """ @callback def async_on_dependency_update(*_): """Update ha state when dependencies update.""" self.async_schedule_update_ha_state(True) - depend = copy(children) - for entity in attributes.values(): + depend = copy(self._children) + for entity in self._attrs.values(): depend.append(entity[0]) + if self._state_template is not None: + for entity in self._state_template.extract_entities(): + depend.append(entity) - async_track_state_change(hass, depend, async_on_dependency_update) + self.hass.helpers.event.async_track_state_change( + list(set(depend)), async_on_dependency_update) def _entity_lkp(self, entity_id, state_attr=None): """Look up an entity state.""" @@ -211,6 +175,8 @@ class UniversalMediaPlayer(MediaPlayerDevice): @property def master_state(self): """Return the master state for entity or None.""" + if self._state_template is not None: + return self._state_template.async_render() if CONF_STATE in self._attrs: master_state = self._entity_lkp( self._attrs[CONF_STATE][0], self._attrs[CONF_STATE][1]) @@ -232,8 +198,8 @@ class UniversalMediaPlayer(MediaPlayerDevice): else master state or off """ master_state = self.master_state # avoid multiple lookups - if master_state == STATE_OFF: - return STATE_OFF + if (master_state == STATE_OFF) or (self._state_template is not None): + return master_state active_child = self._child_state if active_child: diff --git a/homeassistant/const.py b/homeassistant/const.py index 90aa2c52483..d08308de820 100644 --- a/homeassistant/const.py +++ b/homeassistant/const.py @@ -126,6 +126,7 @@ CONF_SHOW_ON_MAP = 'show_on_map' CONF_SLAVE = 'slave' CONF_SSL = 'ssl' CONF_STATE = 'state' +CONF_STATE_TEMPLATE = 'state_template' CONF_STRUCTURE = 'structure' CONF_SWITCHES = 'switches' CONF_TEMPERATURE_UNIT = 'temperature_unit' diff --git a/tests/components/media_player/test_universal.py b/tests/components/media_player/test_universal.py index 01281d189b4..ffd4008f385 100644 --- a/tests/components/media_player/test_universal.py +++ b/tests/components/media_player/test_universal.py @@ -2,6 +2,8 @@ from copy import copy import unittest +from voluptuous.error import MultipleInvalid + from homeassistant.const import ( STATE_OFF, STATE_ON, STATE_UNKNOWN, STATE_PLAYING, STATE_PAUSED) import homeassistant.components.switch as switch @@ -14,6 +16,13 @@ from homeassistant.util.async import run_coroutine_threadsafe from tests.common import mock_service, get_test_home_assistant +def validate_config(config): + """Use the platform schema to validate configuration.""" + validated_config = universal.PLATFORM_SCHEMA(config) + validated_config.pop('platform') + return validated_config + + class MockMediaPlayer(media_player.MediaPlayerDevice): """Mock media player for testing.""" @@ -116,9 +125,9 @@ class MockMediaPlayer(media_player.MediaPlayerDevice): """Mock turn_off function.""" self._state = STATE_OFF - def mute_volume(self): + def mute_volume(self, mute): """Mock mute function.""" - self._is_volume_muted = ~self._is_volume_muted + self._is_volume_muted = mute def set_volume_level(self, volume): """Mock set volume level.""" @@ -210,10 +219,8 @@ class TestMediaPlayer(unittest.TestCase): config_start['commands'] = {} config_start['attributes'] = {} - response = universal.validate_config(self.config_children_only) - - self.assertTrue(response) - self.assertEqual(config_start, self.config_children_only) + config = validate_config(self.config_children_only) + self.assertEqual(config_start, config) def test_config_children_and_attr(self): """Check config with children and attributes.""" @@ -221,15 +228,16 @@ class TestMediaPlayer(unittest.TestCase): del config_start['platform'] config_start['commands'] = {} - response = universal.validate_config(self.config_children_and_attr) - - self.assertTrue(response) - self.assertEqual(config_start, self.config_children_and_attr) + config = validate_config(self.config_children_and_attr) + self.assertEqual(config_start, config) def test_config_no_name(self): """Check config with no Name entry.""" - response = universal.validate_config({'platform': 'universal'}) - + response = True + try: + validate_config({'platform': 'universal'}) + except MultipleInvalid: + response = False self.assertFalse(response) def test_config_bad_children(self): @@ -238,36 +246,31 @@ class TestMediaPlayer(unittest.TestCase): config_bad_children = {'name': 'test', 'children': {}, 'platform': 'universal'} - response = universal.validate_config(config_no_children) - self.assertTrue(response) + config_no_children = validate_config(config_no_children) self.assertEqual([], config_no_children['children']) - response = universal.validate_config(config_bad_children) - self.assertTrue(response) + config_bad_children = validate_config(config_bad_children) self.assertEqual([], config_bad_children['children']) def test_config_bad_commands(self): """Check config with bad commands entry.""" - config = {'name': 'test', 'commands': [], 'platform': 'universal'} + config = {'name': 'test', 'platform': 'universal'} - response = universal.validate_config(config) - self.assertTrue(response) + config = validate_config(config) self.assertEqual({}, config['commands']) def test_config_bad_attributes(self): """Check config with bad attributes.""" - config = {'name': 'test', 'attributes': [], 'platform': 'universal'} + config = {'name': 'test', 'platform': 'universal'} - response = universal.validate_config(config) - self.assertTrue(response) + config = validate_config(config) self.assertEqual({}, config['attributes']) def test_config_bad_key(self): """Check config with bad key.""" config = {'name': 'test', 'asdf': 5, 'platform': 'universal'} - response = universal.validate_config(config) - self.assertTrue(response) + config = validate_config(config) self.assertFalse('asdf' in config) def test_platform_setup(self): @@ -281,21 +284,27 @@ class TestMediaPlayer(unittest.TestCase): for dev in new_entities: entities.append(dev) - run_coroutine_threadsafe( - universal.async_setup_platform(self.hass, bad_config, add_devices), - self.hass.loop).result() + setup_ok = True + try: + run_coroutine_threadsafe( + universal.async_setup_platform( + self.hass, validate_config(bad_config), add_devices), + self.hass.loop).result() + except MultipleInvalid: + setup_ok = False + self.assertFalse(setup_ok) self.assertEqual(0, len(entities)) run_coroutine_threadsafe( - universal.async_setup_platform(self.hass, config, add_devices), + universal.async_setup_platform( + self.hass, validate_config(config), add_devices), self.hass.loop).result() self.assertEqual(1, len(entities)) self.assertEqual('test', entities[0].name) def test_master_state(self): """Test master state property.""" - config = self.config_children_only - universal.validate_config(config) + config = validate_config(self.config_children_only) ump = universal.UniversalMediaPlayer(self.hass, **config) @@ -303,8 +312,7 @@ class TestMediaPlayer(unittest.TestCase): def test_master_state_with_attrs(self): """Test master state property.""" - config = self.config_children_and_attr - universal.validate_config(config) + config = validate_config(self.config_children_and_attr) ump = universal.UniversalMediaPlayer(self.hass, **config) @@ -312,11 +320,26 @@ class TestMediaPlayer(unittest.TestCase): self.hass.states.set(self.mock_state_switch_id, STATE_ON) self.assertEqual(STATE_ON, ump.master_state) + def test_master_state_with_template(self): + """Test the state_template option.""" + config = copy(self.config_children_and_attr) + self.hass.states.set('input_boolean.test', STATE_OFF) + templ = '{% if states.input_boolean.test.state == "off" %}on' \ + '{% else %}{{ states.media_player.mock1.state }}{% endif %}' + config['state_template'] = templ + config = validate_config(config) + + ump = universal.UniversalMediaPlayer(self.hass, **config) + + self.assertEqual(STATE_ON, ump.master_state) + self.hass.states.set('input_boolean.test', STATE_ON) + self.assertEqual(STATE_OFF, ump.master_state) + def test_master_state_with_bad_attrs(self): """Test master state property.""" - config = self.config_children_and_attr + config = copy(self.config_children_and_attr) config['attributes']['state'] = 'bad.entity_id' - universal.validate_config(config) + config = validate_config(config) ump = universal.UniversalMediaPlayer(self.hass, **config) @@ -324,8 +347,7 @@ class TestMediaPlayer(unittest.TestCase): def test_active_child_state(self): """Test active child state property.""" - config = self.config_children_only - universal.validate_config(config) + config = validate_config(self.config_children_only) ump = universal.UniversalMediaPlayer(self.hass, **config) ump.entity_id = media_player.ENTITY_ID_FORMAT.format(config['name']) @@ -356,8 +378,7 @@ class TestMediaPlayer(unittest.TestCase): def test_name(self): """Test name property.""" - config = self.config_children_only - universal.validate_config(config) + config = validate_config(self.config_children_only) ump = universal.UniversalMediaPlayer(self.hass, **config) @@ -365,8 +386,7 @@ class TestMediaPlayer(unittest.TestCase): def test_polling(self): """Test should_poll property.""" - config = self.config_children_only - universal.validate_config(config) + config = validate_config(self.config_children_only) ump = universal.UniversalMediaPlayer(self.hass, **config) @@ -374,8 +394,7 @@ class TestMediaPlayer(unittest.TestCase): def test_state_children_only(self): """Test media player state with only children.""" - config = self.config_children_only - universal.validate_config(config) + config = validate_config(self.config_children_only) ump = universal.UniversalMediaPlayer(self.hass, **config) ump.entity_id = media_player.ENTITY_ID_FORMAT.format(config['name']) @@ -391,8 +410,7 @@ class TestMediaPlayer(unittest.TestCase): def test_state_with_children_and_attrs(self): """Test media player with children and master state.""" - config = self.config_children_and_attr - universal.validate_config(config) + config = validate_config(self.config_children_and_attr) ump = universal.UniversalMediaPlayer(self.hass, **config) ump.entity_id = media_player.ENTITY_ID_FORMAT.format(config['name']) @@ -416,8 +434,7 @@ class TestMediaPlayer(unittest.TestCase): def test_volume_level(self): """Test volume level property.""" - config = self.config_children_only - universal.validate_config(config) + config = validate_config(self.config_children_only) ump = universal.UniversalMediaPlayer(self.hass, **config) ump.entity_id = media_player.ENTITY_ID_FORMAT.format(config['name']) @@ -439,9 +456,8 @@ class TestMediaPlayer(unittest.TestCase): def test_media_image_url(self): """Test media_image_url property.""" - TEST_URL = "test_url" - config = self.config_children_only - universal.validate_config(config) + test_url = "test_url" + config = validate_config(self.config_children_only) ump = universal.UniversalMediaPlayer(self.hass, **config) ump.entity_id = media_player.ENTITY_ID_FORMAT.format(config['name']) @@ -450,7 +466,7 @@ class TestMediaPlayer(unittest.TestCase): self.assertEqual(None, ump.media_image_url) self.mock_mp_1._state = STATE_PLAYING - self.mock_mp_1._media_image_url = TEST_URL + self.mock_mp_1._media_image_url = test_url self.mock_mp_1.schedule_update_ha_state() self.hass.block_till_done() run_coroutine_threadsafe(ump.async_update(), self.hass.loop).result() @@ -460,8 +476,7 @@ class TestMediaPlayer(unittest.TestCase): def test_is_volume_muted_children_only(self): """Test is volume muted property w/ children only.""" - config = self.config_children_only - universal.validate_config(config) + config = validate_config(self.config_children_only) ump = universal.UniversalMediaPlayer(self.hass, **config) ump.entity_id = media_player.ENTITY_ID_FORMAT.format(config['name']) @@ -483,8 +498,7 @@ class TestMediaPlayer(unittest.TestCase): def test_source_list_children_and_attr(self): """Test source list property w/ children and attrs.""" - config = self.config_children_and_attr - universal.validate_config(config) + config = validate_config(self.config_children_and_attr) ump = universal.UniversalMediaPlayer(self.hass, **config) @@ -495,8 +509,7 @@ class TestMediaPlayer(unittest.TestCase): def test_source_children_and_attr(self): """Test source property w/ children and attrs.""" - config = self.config_children_and_attr - universal.validate_config(config) + config = validate_config(self.config_children_and_attr) ump = universal.UniversalMediaPlayer(self.hass, **config) @@ -507,8 +520,7 @@ class TestMediaPlayer(unittest.TestCase): def test_volume_level_children_and_attr(self): """Test volume level property w/ children and attrs.""" - config = self.config_children_and_attr - universal.validate_config(config) + config = validate_config(self.config_children_and_attr) ump = universal.UniversalMediaPlayer(self.hass, **config) @@ -519,8 +531,7 @@ class TestMediaPlayer(unittest.TestCase): def test_is_volume_muted_children_and_attr(self): """Test is volume muted property w/ children and attrs.""" - config = self.config_children_and_attr - universal.validate_config(config) + config = validate_config(self.config_children_and_attr) ump = universal.UniversalMediaPlayer(self.hass, **config) @@ -531,8 +542,7 @@ class TestMediaPlayer(unittest.TestCase): def test_supported_features_children_only(self): """Test supported media commands with only children.""" - config = self.config_children_only - universal.validate_config(config) + config = validate_config(self.config_children_only) ump = universal.UniversalMediaPlayer(self.hass, **config) ump.entity_id = media_player.ENTITY_ID_FORMAT.format(config['name']) @@ -549,16 +559,19 @@ class TestMediaPlayer(unittest.TestCase): def test_supported_features_children_and_cmds(self): """Test supported media commands with children and attrs.""" - config = self.config_children_and_attr - universal.validate_config(config) - config['commands']['turn_on'] = 'test' - config['commands']['turn_off'] = 'test' - config['commands']['volume_up'] = 'test' - config['commands']['volume_down'] = 'test' - config['commands']['volume_mute'] = 'test' - config['commands']['volume_set'] = 'test' - config['commands']['select_source'] = 'test' - config['commands']['shuffle_set'] = 'test' + config = copy(self.config_children_and_attr) + excmd = {'service': 'media_player.test', 'data': {'entity_id': 'test'}} + config['commands'] = { + 'turn_on': excmd, + 'turn_off': excmd, + 'volume_up': excmd, + 'volume_down': excmd, + 'volume_mute': excmd, + 'volume_set': excmd, + 'select_source': excmd, + 'shuffle_set': excmd + } + config = validate_config(config) ump = universal.UniversalMediaPlayer(self.hass, **config) ump.entity_id = media_player.ENTITY_ID_FORMAT.format(config['name']) @@ -577,8 +590,7 @@ class TestMediaPlayer(unittest.TestCase): def test_service_call_no_active_child(self): """Test a service call to children with no active child.""" - config = self.config_children_only - universal.validate_config(config) + config = validate_config(self.config_children_and_attr) ump = universal.UniversalMediaPlayer(self.hass, **config) ump.entity_id = media_player.ENTITY_ID_FORMAT.format(config['name']) @@ -599,8 +611,7 @@ class TestMediaPlayer(unittest.TestCase): def test_service_call_to_child(self): """Test service calls that should be routed to a child.""" - config = self.config_children_only - universal.validate_config(config) + config = validate_config(self.config_children_only) ump = universal.UniversalMediaPlayer(self.hass, **config) ump.entity_id = media_player.ENTITY_ID_FORMAT.format(config['name']) @@ -699,10 +710,10 @@ class TestMediaPlayer(unittest.TestCase): def test_service_call_to_command(self): """Test service call to command.""" - config = self.config_children_only + config = copy(self.config_children_only) config['commands'] = {'turn_off': { 'service': 'test.turn_off', 'data': {}}} - universal.validate_config(config) + config = validate_config(config) service = mock_service(self.hass, 'test', 'turn_off') From 061253fded1ef60da14feb59f27f712c438ebbff Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andreas=20Bj=C3=B6rshammar?= Date: Tue, 14 Nov 2017 15:53:26 +0100 Subject: [PATCH 036/246] Verisure: Added option to set installation giid (#10504) * Added option to set installation giid * Changed where giid config var is being checked * Style fix * Fix style --- homeassistant/components/verisure.py | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/homeassistant/components/verisure.py b/homeassistant/components/verisure.py index 3ed6efc25d7..94f712896cc 100644 --- a/homeassistant/components/verisure.py +++ b/homeassistant/components/verisure.py @@ -27,6 +27,7 @@ ATTR_DEVICE_SERIAL = 'device_serial' CONF_ALARM = 'alarm' CONF_CODE_DIGITS = 'code_digits' CONF_DOOR_WINDOW = 'door_window' +CONF_GIID = 'giid' CONF_HYDROMETERS = 'hygrometers' CONF_LOCKS = 'locks' CONF_MOUSE = 'mouse' @@ -47,6 +48,7 @@ CONFIG_SCHEMA = vol.Schema({ vol.Optional(CONF_ALARM, default=True): cv.boolean, vol.Optional(CONF_CODE_DIGITS, default=4): cv.positive_int, vol.Optional(CONF_DOOR_WINDOW, default=True): cv.boolean, + vol.Optional(CONF_GIID): cv.string, vol.Optional(CONF_HYDROMETERS, default=True): cv.boolean, vol.Optional(CONF_LOCKS, default=True): cv.boolean, vol.Optional(CONF_MOUSE, default=True): cv.boolean, @@ -110,6 +112,8 @@ class VerisureHub(object): domain_config[CONF_USERNAME], domain_config[CONF_PASSWORD]) + self.giid = domain_config.get(CONF_GIID) + import jsonpath self.jsonpath = jsonpath.jsonpath @@ -120,6 +124,8 @@ class VerisureHub(object): except self._verisure.Error as ex: _LOGGER.error('Could not log in to verisure, %s', ex) return False + if self.giid: + return self.set_giid() return True def logout(self): @@ -131,6 +137,15 @@ class VerisureHub(object): return False return True + def set_giid(self): + """Set installation GIID.""" + try: + self.session.set_giid(self.giid) + except self._verisure.Error as ex: + _LOGGER.error('Could not set installation GIID, %s', ex) + return False + return True + @Throttle(timedelta(seconds=60)) def update_overview(self): """Update the overview.""" From 95c831d5bcf5e93c8d84bca9142090888b73f18c Mon Sep 17 00:00:00 2001 From: Marcelo Moreira de Mello Date: Tue, 14 Nov 2017 09:56:42 -0500 Subject: [PATCH 037/246] Bump ring_doorbell to 0.1.7 (#10566) --- homeassistant/components/ring.py | 2 +- requirements_all.txt | 2 +- requirements_test_all.txt | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/ring.py b/homeassistant/components/ring.py index 701889d60b5..c16164d7700 100644 --- a/homeassistant/components/ring.py +++ b/homeassistant/components/ring.py @@ -12,7 +12,7 @@ from homeassistant.const import CONF_USERNAME, CONF_PASSWORD from requests.exceptions import HTTPError, ConnectTimeout -REQUIREMENTS = ['ring_doorbell==0.1.6'] +REQUIREMENTS = ['ring_doorbell==0.1.7'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index cd042c018de..70e68e5bfa6 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -951,7 +951,7 @@ restrictedpython==4.0b2 rflink==0.0.34 # homeassistant.components.ring -ring_doorbell==0.1.6 +ring_doorbell==0.1.7 # homeassistant.components.notify.rocketchat rocketchat-API==0.6.1 diff --git a/requirements_test_all.txt b/requirements_test_all.txt index 7e57f0638be..79440bf6be6 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -143,7 +143,7 @@ restrictedpython==4.0b2 rflink==0.0.34 # homeassistant.components.ring -ring_doorbell==0.1.6 +ring_doorbell==0.1.7 # homeassistant.components.media_player.yamaha rxv==0.5.1 From 309e493e7697d0fbd3b0c3370c21db64786989e6 Mon Sep 17 00:00:00 2001 From: marthoc <30442019+marthoc@users.noreply.github.com> Date: Tue, 14 Nov 2017 23:19:15 -0500 Subject: [PATCH 038/246] Add code to enable discovery for mqtt cover (#10580) * Add code to enable discovery for mqtt cover * Fix pylint error --- homeassistant/components/cover/mqtt.py | 3 +++ homeassistant/components/mqtt/discovery.py | 4 +++- 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/homeassistant/components/cover/mqtt.py b/homeassistant/components/cover/mqtt.py index d10166a9469..0a49679b9c4 100644 --- a/homeassistant/components/cover/mqtt.py +++ b/homeassistant/components/cover/mqtt.py @@ -104,6 +104,9 @@ PLATFORM_SCHEMA = mqtt.MQTT_BASE_PLATFORM_SCHEMA.extend({ @asyncio.coroutine def async_setup_platform(hass, config, async_add_devices, discovery_info=None): """Set up the MQTT Cover.""" + if discovery_info is not None: + config = PLATFORM_SCHEMA(discovery_info) + value_template = config.get(CONF_VALUE_TEMPLATE) if value_template is not None: value_template.hass = hass diff --git a/homeassistant/components/mqtt/discovery.py b/homeassistant/components/mqtt/discovery.py index 7140423633e..b6f6a1c5a92 100644 --- a/homeassistant/components/mqtt/discovery.py +++ b/homeassistant/components/mqtt/discovery.py @@ -20,10 +20,12 @@ TOPIC_MATCHER = re.compile( r'(?P\w+)/(?P\w+)/' r'(?:(?P[a-zA-Z0-9_-]+)/)?(?P[a-zA-Z0-9_-]+)/config') -SUPPORTED_COMPONENTS = ['binary_sensor', 'fan', 'light', 'sensor', 'switch'] +SUPPORTED_COMPONENTS = [ + 'binary_sensor', 'cover', 'fan', 'light', 'sensor', 'switch'] ALLOWED_PLATFORMS = { 'binary_sensor': ['mqtt'], + 'cover': ['mqtt'], 'fan': ['mqtt'], 'light': ['mqtt', 'mqtt_json', 'mqtt_template'], 'sensor': ['mqtt'], From 0b4de54725de83cfed5597dcc2ac0ec552c688ae Mon Sep 17 00:00:00 2001 From: Eitan Mosenkis Date: Wed, 15 Nov 2017 06:19:42 +0200 Subject: [PATCH 039/246] Google Assistant for climate entities: Support QUERY and respect system-wide unit_system setting. (#10346) --- .../components/google_assistant/http.py | 20 ++-- .../components/google_assistant/smart_home.py | 58 ++++++++--- .../google_assistant/test_google_assistant.py | 96 +++++++++++++++++++ .../google_assistant/test_smart_home.py | 26 ++++- 4 files changed, 176 insertions(+), 24 deletions(-) diff --git a/homeassistant/components/google_assistant/http.py b/homeassistant/components/google_assistant/http.py index 1458d695163..71a4ff9ce3a 100644 --- a/homeassistant/components/google_assistant/http.py +++ b/homeassistant/components/google_assistant/http.py @@ -81,7 +81,7 @@ class GoogleAssistantView(HomeAssistantView): if not self.is_entity_exposed(entity): continue - device = entity_to_device(entity) + device = entity_to_device(entity, hass.config.units) if device is None: _LOGGER.warning("No mapping for %s domain", entity.domain) continue @@ -89,9 +89,9 @@ class GoogleAssistantView(HomeAssistantView): devices.append(device) return self.json( - make_actions_response(request_id, - {'agentUserId': self.agent_user_id, - 'devices': devices})) + _make_actions_response(request_id, + {'agentUserId': self.agent_user_id, + 'devices': devices})) @asyncio.coroutine def handle_query(self, @@ -112,10 +112,10 @@ class GoogleAssistantView(HomeAssistantView): # If we can't find a state, the device is offline devices[devid] = {'online': False} - devices[devid] = query_device(state) + devices[devid] = query_device(state, hass.config.units) return self.json( - make_actions_response(request_id, {'devices': devices})) + _make_actions_response(request_id, {'devices': devices})) @asyncio.coroutine def handle_execute(self, @@ -130,7 +130,8 @@ class GoogleAssistantView(HomeAssistantView): for eid in ent_ids: domain = eid.split('.')[0] (service, service_data) = determine_service( - eid, execution.get('command'), execution.get('params')) + eid, execution.get('command'), execution.get('params'), + hass.config.units) success = yield from hass.services.async_call( domain, service, service_data, blocking=True) result = {"ids": [eid], "states": {}} @@ -141,7 +142,7 @@ class GoogleAssistantView(HomeAssistantView): commands.append(result) return self.json( - make_actions_response(request_id, {'commands': commands})) + _make_actions_response(request_id, {'commands': commands})) @asyncio.coroutine def post(self, request: Request) -> Response: @@ -181,6 +182,5 @@ class GoogleAssistantView(HomeAssistantView): "invalid intent", status_code=HTTP_BAD_REQUEST) -def make_actions_response(request_id: str, payload: dict) -> dict: - """Helper to simplify format for response.""" +def _make_actions_response(request_id: str, payload: dict) -> dict: return {'requestId': request_id, 'payload': payload} diff --git a/homeassistant/components/google_assistant/smart_home.py b/homeassistant/components/google_assistant/smart_home.py index 1c8adf3d8f7..42cb555fe3c 100644 --- a/homeassistant/components/google_assistant/smart_home.py +++ b/homeassistant/components/google_assistant/smart_home.py @@ -5,18 +5,21 @@ import logging # pylint: disable=using-constant-test,unused-import,ungrouped-imports # if False: from aiohttp.web import Request, Response # NOQA -from typing import Dict, Tuple, Any # NOQA +from typing import Dict, Tuple, Any, Optional # NOQA from homeassistant.helpers.entity import Entity # NOQA from homeassistant.core import HomeAssistant # NOQA +from homeassistant.util.unit_system import UnitSystem # NOQA from homeassistant.const import ( ATTR_SUPPORTED_FEATURES, ATTR_ENTITY_ID, CONF_FRIENDLY_NAME, STATE_OFF, - SERVICE_TURN_OFF, SERVICE_TURN_ON + SERVICE_TURN_OFF, SERVICE_TURN_ON, + TEMP_FAHRENHEIT, TEMP_CELSIUS, ) from homeassistant.components import ( switch, light, cover, media_player, group, fan, scene, script, climate ) +from homeassistant.util.unit_system import METRIC_SYSTEM from .const import ( ATTR_GOOGLE_ASSISTANT_NAME, ATTR_GOOGLE_ASSISTANT_TYPE, @@ -65,7 +68,7 @@ def make_actions_response(request_id: str, payload: dict) -> dict: return {'requestId': request_id, 'payload': payload} -def entity_to_device(entity: Entity): +def entity_to_device(entity: Entity, units: UnitSystem): """Convert a hass entity into an google actions device.""" class_data = MAPPING_COMPONENT.get( entity.attributes.get(ATTR_GOOGLE_ASSISTANT_TYPE) or entity.domain) @@ -105,14 +108,39 @@ def entity_to_device(entity: Entity): if m in CLIMATE_SUPPORTED_MODES) device['attributes'] = { 'availableThermostatModes': modes, - 'thermostatTemperatureUnit': 'C', + 'thermostatTemperatureUnit': + 'F' if units.temperature_unit == TEMP_FAHRENHEIT else 'C', } return device -def query_device(entity: Entity) -> dict: +def query_device(entity: Entity, units: UnitSystem) -> dict: """Take an entity and return a properly formatted device object.""" + def celsius(deg: Optional[float]) -> Optional[float]: + """Convert a float to Celsius and rounds to one decimal place.""" + if deg is None: + return None + return round(METRIC_SYSTEM.temperature(deg, units.temperature_unit), 1) + if entity.domain == climate.DOMAIN: + mode = entity.attributes.get(climate.ATTR_OPERATION_MODE) + if mode not in CLIMATE_SUPPORTED_MODES: + mode = 'on' + response = { + 'thermostatMode': mode, + 'thermostatTemperatureSetpoint': + celsius(entity.attributes.get(climate.ATTR_TEMPERATURE)), + 'thermostatTemperatureAmbient': + celsius(entity.attributes.get(climate.ATTR_CURRENT_TEMPERATURE)), + 'thermostatTemperatureSetpointHigh': + celsius(entity.attributes.get(climate.ATTR_TARGET_TEMP_HIGH)), + 'thermostatTemperatureSetpointLow': + celsius(entity.attributes.get(climate.ATTR_TARGET_TEMP_LOW)), + 'thermostatHumidityAmbient': + entity.attributes.get(climate.ATTR_CURRENT_HUMIDITY), + } + return {k: v for k, v in response.items() if v is not None} + final_state = entity.state != STATE_OFF final_brightness = entity.attributes.get(light.ATTR_BRIGHTNESS, 255 if final_state else 0) @@ -138,8 +166,9 @@ def query_device(entity: Entity) -> dict: # erroneous bug on old pythons and pylint # https://github.com/PyCQA/pylint/issues/1212 # pylint: disable=invalid-sequence-index -def determine_service(entity_id: str, command: str, - params: dict) -> Tuple[str, dict]: +def determine_service( + entity_id: str, command: str, params: dict, + units: UnitSystem) -> Tuple[str, dict]: """ Determine service and service_data. @@ -166,14 +195,17 @@ def determine_service(entity_id: str, command: str, # special climate handling if domain == climate.DOMAIN: if command == COMMAND_THERMOSTAT_TEMPERATURE_SETPOINT: - service_data['temperature'] = params.get( - 'thermostatTemperatureSetpoint', 25) + service_data['temperature'] = units.temperature( + params.get('thermostatTemperatureSetpoint', 25), + TEMP_CELSIUS) return (climate.SERVICE_SET_TEMPERATURE, service_data) if command == COMMAND_THERMOSTAT_TEMPERATURE_SET_RANGE: - service_data['target_temp_high'] = params.get( - 'thermostatTemperatureSetpointHigh', 25) - service_data['target_temp_low'] = params.get( - 'thermostatTemperatureSetpointLow', 18) + service_data['target_temp_high'] = units.temperature( + params.get('thermostatTemperatureSetpointHigh', 25), + TEMP_CELSIUS) + service_data['target_temp_low'] = units.temperature( + params.get('thermostatTemperatureSetpointLow', 18), + TEMP_CELSIUS) return (climate.SERVICE_SET_TEMPERATURE, service_data) if command == COMMAND_THERMOSTAT_SET_MODE: service_data['operation_mode'] = params.get( diff --git a/tests/components/google_assistant/test_google_assistant.py b/tests/components/google_assistant/test_google_assistant.py index 7ad59779f94..c21c63b0d52 100644 --- a/tests/components/google_assistant/test_google_assistant.py +++ b/tests/components/google_assistant/test_google_assistant.py @@ -11,6 +11,7 @@ from homeassistant import core, const, setup from homeassistant.components import ( fan, http, cover, light, switch, climate, async_setup, media_player) from homeassistant.components import google_assistant as ga +from homeassistant.util.unit_system import IMPERIAL_SYSTEM from . import DEMO_DEVICES @@ -198,6 +199,101 @@ def test_query_request(hass_fixture, assistant_client): assert devices['light.ceiling_lights']['brightness'] == 70 +@asyncio.coroutine +def test_query_climate_request(hass_fixture, assistant_client): + """Test a query request.""" + reqid = '5711642932632160984' + data = { + 'requestId': + reqid, + 'inputs': [{ + 'intent': 'action.devices.QUERY', + 'payload': { + 'devices': [ + {'id': 'climate.hvac'}, + {'id': 'climate.heatpump'}, + {'id': 'climate.ecobee'}, + ] + } + }] + } + result = yield from assistant_client.post( + ga.const.GOOGLE_ASSISTANT_API_ENDPOINT, + data=json.dumps(data), + headers=AUTH_HEADER) + assert result.status == 200 + body = yield from result.json() + assert body.get('requestId') == reqid + devices = body['payload']['devices'] + assert devices == { + 'climate.heatpump': { + 'thermostatTemperatureSetpoint': 20.0, + 'thermostatTemperatureAmbient': 25.0, + 'thermostatMode': 'heat', + }, + 'climate.ecobee': { + 'thermostatTemperatureSetpointHigh': 24, + 'thermostatTemperatureAmbient': 23, + 'thermostatMode': 'on', + 'thermostatTemperatureSetpointLow': 21 + }, + 'climate.hvac': { + 'thermostatTemperatureSetpoint': 21, + 'thermostatTemperatureAmbient': 22, + 'thermostatMode': 'cool', + 'thermostatHumidityAmbient': 54, + } + } + + +@asyncio.coroutine +def test_query_climate_request_f(hass_fixture, assistant_client): + """Test a query request.""" + hass_fixture.config.units = IMPERIAL_SYSTEM + reqid = '5711642932632160984' + data = { + 'requestId': + reqid, + 'inputs': [{ + 'intent': 'action.devices.QUERY', + 'payload': { + 'devices': [ + {'id': 'climate.hvac'}, + {'id': 'climate.heatpump'}, + {'id': 'climate.ecobee'}, + ] + } + }] + } + result = yield from assistant_client.post( + ga.const.GOOGLE_ASSISTANT_API_ENDPOINT, + data=json.dumps(data), + headers=AUTH_HEADER) + assert result.status == 200 + body = yield from result.json() + assert body.get('requestId') == reqid + devices = body['payload']['devices'] + assert devices == { + 'climate.heatpump': { + 'thermostatTemperatureSetpoint': -6.7, + 'thermostatTemperatureAmbient': -3.9, + 'thermostatMode': 'heat', + }, + 'climate.ecobee': { + 'thermostatTemperatureSetpointHigh': -4.4, + 'thermostatTemperatureAmbient': -5, + 'thermostatMode': 'on', + 'thermostatTemperatureSetpointLow': -6.1, + }, + 'climate.hvac': { + 'thermostatTemperatureSetpoint': -6.1, + 'thermostatTemperatureAmbient': -5.6, + 'thermostatMode': 'cool', + 'thermostatHumidityAmbient': 54, + } + } + + @asyncio.coroutine def test_execute_request(hass_fixture, assistant_client): """Test a execute request.""" diff --git a/tests/components/google_assistant/test_smart_home.py b/tests/components/google_assistant/test_smart_home.py index 20db85b998e..6712b390dbb 100644 --- a/tests/components/google_assistant/test_smart_home.py +++ b/tests/components/google_assistant/test_smart_home.py @@ -5,6 +5,7 @@ import asyncio from homeassistant import const from homeassistant.components import climate from homeassistant.components import google_assistant as ga +from homeassistant.util.unit_system import (IMPERIAL_SYSTEM, METRIC_SYSTEM) DETERMINE_SERVICE_TESTS = [{ # Test light brightness 'entity_id': 'light.test', @@ -82,6 +83,15 @@ DETERMINE_SERVICE_TESTS = [{ # Test light brightness climate.SERVICE_SET_TEMPERATURE, {'entity_id': 'climate.living_room', 'temperature': 24.5} ), +}, { # Test climate temperature Fahrenheit + 'entity_id': 'climate.living_room', + 'command': ga.const.COMMAND_THERMOSTAT_TEMPERATURE_SETPOINT, + 'params': {'thermostatTemperatureSetpoint': 24.5}, + 'units': IMPERIAL_SYSTEM, + 'expected': ( + climate.SERVICE_SET_TEMPERATURE, + {'entity_id': 'climate.living_room', 'temperature': 76.1} + ), }, { # Test climate temperature range 'entity_id': 'climate.living_room', 'command': ga.const.COMMAND_THERMOSTAT_TEMPERATURE_SET_RANGE, @@ -94,6 +104,19 @@ DETERMINE_SERVICE_TESTS = [{ # Test light brightness {'entity_id': 'climate.living_room', 'target_temp_high': 24.5, 'target_temp_low': 20.5} ), +}, { # Test climate temperature range Fahrenheit + 'entity_id': 'climate.living_room', + 'command': ga.const.COMMAND_THERMOSTAT_TEMPERATURE_SET_RANGE, + 'params': { + 'thermostatTemperatureSetpointHigh': 24.5, + 'thermostatTemperatureSetpointLow': 20.5, + }, + 'units': IMPERIAL_SYSTEM, + 'expected': ( + climate.SERVICE_SET_TEMPERATURE, + {'entity_id': 'climate.living_room', + 'target_temp_high': 76.1, 'target_temp_low': 68.9} + ), }, { # Test climate operation mode 'entity_id': 'climate.living_room', 'command': ga.const.COMMAND_THERMOSTAT_SET_MODE, @@ -122,5 +145,6 @@ def test_determine_service(): result = ga.smart_home.determine_service( test['entity_id'], test['command'], - test['params']) + test['params'], + test.get('units', METRIC_SYSTEM)) assert result == test['expected'] From 8d91de877afee16ec11e72d4d45236cffc581224 Mon Sep 17 00:00:00 2001 From: NovapaX Date: Wed, 15 Nov 2017 05:32:48 +0100 Subject: [PATCH 040/246] turn service call handler into coroutine (#10576) --- homeassistant/components/configurator.py | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/configurator.py b/homeassistant/components/configurator.py index 2da8967bddf..7d1b1fd7ef1 100644 --- a/homeassistant/components/configurator.py +++ b/homeassistant/components/configurator.py @@ -207,7 +207,7 @@ class Configurator(object): self.hass.bus.async_listen_once(EVENT_TIME_CHANGED, deferred_remove) - @async_callback + @asyncio.coroutine def async_handle_service_call(self, call): """Handle a configure service call.""" request_id = call.data.get(ATTR_CONFIGURE_ID) @@ -220,7 +220,8 @@ class Configurator(object): # field validation goes here? if callback: - self.hass.async_add_job(callback, call.data.get(ATTR_FIELDS, {})) + yield from self.hass.async_add_job(callback, + call.data.get(ATTR_FIELDS, {})) def _generate_unique_id(self): """Generate a unique configurator ID.""" From 8111e3944c2b5d2bbbf9e147fb0bb856283fea9f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pierre=20St=C3=A5hl?= Date: Wed, 15 Nov 2017 05:35:56 +0100 Subject: [PATCH 041/246] Add basic backend support for a system log (#10492) Everything logged with "warning" or "error" is stored and exposed via the HTTP API, that can be used by the frontend. --- homeassistant/bootstrap.py | 4 +- homeassistant/components/frontend/__init__.py | 2 +- .../components/system_log/__init__.py | 145 ++++++++++++++++++ .../components/system_log/services.yaml | 3 + tests/components/test_system_log.py | 112 ++++++++++++++ 5 files changed, 263 insertions(+), 3 deletions(-) create mode 100644 homeassistant/components/system_log/__init__.py create mode 100644 homeassistant/components/system_log/services.yaml create mode 100644 tests/components/test_system_log.py diff --git a/homeassistant/bootstrap.py b/homeassistant/bootstrap.py index 4de464be88a..64ad88f8c8b 100644 --- a/homeassistant/bootstrap.py +++ b/homeassistant/bootstrap.py @@ -30,8 +30,8 @@ ERROR_LOG_FILENAME = 'home-assistant.log' DATA_LOGGING = 'logging' FIRST_INIT_COMPONENT = set(( - 'recorder', 'mqtt', 'mqtt_eventstream', 'logger', 'introduction', - 'frontend', 'history')) + 'system_log', 'recorder', 'mqtt', 'mqtt_eventstream', 'logger', + 'introduction', 'frontend', 'history')) def from_config_dict(config: Dict[str, Any], diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index a656802c77d..f6c058f977e 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -26,7 +26,7 @@ from homeassistant.loader import bind_hass REQUIREMENTS = ['home-assistant-frontend==20171111.0'] DOMAIN = 'frontend' -DEPENDENCIES = ['api', 'websocket_api', 'http'] +DEPENDENCIES = ['api', 'websocket_api', 'http', 'system_log'] URL_PANEL_COMPONENT_FP = '/frontend/panels/{}-{}.html' diff --git a/homeassistant/components/system_log/__init__.py b/homeassistant/components/system_log/__init__.py new file mode 100644 index 00000000000..f2d3e4edad2 --- /dev/null +++ b/homeassistant/components/system_log/__init__.py @@ -0,0 +1,145 @@ +""" +Support for system log. + +For more details about this platform, please refer to the documentation at +https://home-assistant.io/components/system_log/ +""" +import os +import re +import asyncio +import logging +import traceback +from io import StringIO +from collections import deque + +import voluptuous as vol + +from homeassistant.config import load_yaml_config_file +import homeassistant.helpers.config_validation as cv +from homeassistant.components.http import HomeAssistantView + +DOMAIN = 'system_log' +DEPENDENCIES = ['http'] +SERVICE_CLEAR = 'clear' + +CONF_MAX_ENTRIES = 'max_entries' + +DEFAULT_MAX_ENTRIES = 50 + +DATA_SYSTEM_LOG = 'system_log' + +CONFIG_SCHEMA = vol.Schema({ + DOMAIN: vol.Schema({ + vol.Optional(CONF_MAX_ENTRIES, + default=DEFAULT_MAX_ENTRIES): cv.positive_int, + }), +}, extra=vol.ALLOW_EXTRA) + +SERVICE_CLEAR_SCHEMA = vol.Schema({}) + + +class LogErrorHandler(logging.Handler): + """Log handler for error messages.""" + + def __init__(self, maxlen): + """Initialize a new LogErrorHandler.""" + super().__init__() + self.records = deque(maxlen=maxlen) + + def emit(self, record): + """Save error and warning logs. + + Everyhing logged with error or warning is saved in local buffer. A + default upper limit is set to 50 (older entries are discarded) but can + be changed if neeeded. + """ + if record.levelno >= logging.WARN: + self.records.appendleft(record) + + +@asyncio.coroutine +def async_setup(hass, config): + """Set up the logger component.""" + conf = config.get(DOMAIN) + + if conf is None: + conf = CONFIG_SCHEMA({DOMAIN: {}})[DOMAIN] + + handler = LogErrorHandler(conf.get(CONF_MAX_ENTRIES)) + logging.getLogger().addHandler(handler) + + hass.http.register_view(AllErrorsView(handler)) + yield from hass.components.frontend.async_register_built_in_panel( + 'system-log', 'system_log', 'mdi:monitor') + + @asyncio.coroutine + def async_service_handler(service): + """Handle logger services.""" + # Only one service so far + handler.records.clear() + + descriptions = yield from hass.async_add_job( + load_yaml_config_file, os.path.join( + os.path.dirname(__file__), 'services.yaml')) + + hass.services.async_register( + DOMAIN, SERVICE_CLEAR, async_service_handler, + descriptions[DOMAIN].get(SERVICE_CLEAR), + schema=SERVICE_CLEAR_SCHEMA) + + return True + + +def _figure_out_source(record): + # If a stack trace exists, extract filenames from the entire call stack. + # The other case is when a regular "log" is made (without an attached + # exception). In that case, just use the file where the log was made from. + if record.exc_info: + stack = [x[0] for x in traceback.extract_tb(record.exc_info[2])] + else: + stack = [record.pathname] + + # Iterate through the stack call (in reverse) and find the last call from + # a file in HA. Try to figure out where error happened. + for pathname in reversed(stack): + + # Try to match with a file within HA + match = re.match(r'.*/homeassistant/(.*)', pathname) + if match: + return match.group(1) + + # Ok, we don't know what this is + return 'unknown' + + +def _exception_as_string(exc_info): + buf = StringIO() + if exc_info: + traceback.print_exception(*exc_info, file=buf) + return buf.getvalue() + + +def _convert(record): + return { + 'timestamp': record.created, + 'level': record.levelname, + 'message': record.getMessage(), + 'exception': _exception_as_string(record.exc_info), + 'source': _figure_out_source(record), + } + + +class AllErrorsView(HomeAssistantView): + """Get all logged errors and warnings.""" + + url = "/api/error/all" + name = "api:error:all" + + def __init__(self, handler): + """Initialize a new AllErrorsView.""" + self.handler = handler + + @asyncio.coroutine + def get(self, request): + """Get all errors and warnings.""" + return self.json([_convert(x) for x in self.handler.records]) diff --git a/homeassistant/components/system_log/services.yaml b/homeassistant/components/system_log/services.yaml new file mode 100644 index 00000000000..98f86e12f8c --- /dev/null +++ b/homeassistant/components/system_log/services.yaml @@ -0,0 +1,3 @@ +system_log: + clear: + description: Clear all log entries. diff --git a/tests/components/test_system_log.py b/tests/components/test_system_log.py new file mode 100644 index 00000000000..b86c768fb42 --- /dev/null +++ b/tests/components/test_system_log.py @@ -0,0 +1,112 @@ +"""Test system log component.""" +import asyncio +import logging +import pytest + +from homeassistant.bootstrap import async_setup_component +from homeassistant.components import system_log + +_LOGGER = logging.getLogger('test_logger') + + +@pytest.fixture(autouse=True) +@asyncio.coroutine +def setup_test_case(hass): + """Setup system_log component before test case.""" + config = {'system_log': {'max_entries': 2}} + yield from async_setup_component(hass, system_log.DOMAIN, config) + + +@asyncio.coroutine +def get_error_log(hass, test_client, expected_count): + """Fetch all entries from system_log via the API.""" + client = yield from test_client(hass.http.app) + resp = yield from client.get('/api/error/all') + assert resp.status == 200 + + data = yield from resp.json() + assert len(data) == expected_count + return data + + +def _generate_and_log_exception(exception, log): + try: + raise Exception(exception) + except: # pylint: disable=bare-except + _LOGGER.exception(log) + + +def assert_log(log, exception, message, level): + """Assert that specified values are in a specific log entry.""" + assert exception in log['exception'] + assert message == log['message'] + assert level == log['level'] + assert log['source'] == 'unknown' # always unkown in tests + assert 'timestamp' in log + + +@asyncio.coroutine +def test_normal_logs(hass, test_client): + """Test that debug and info are not logged.""" + _LOGGER.debug('debug') + _LOGGER.info('info') + + # Assert done by get_error_log + yield from get_error_log(hass, test_client, 0) + + +@asyncio.coroutine +def test_exception(hass, test_client): + """Test that exceptions are logged and retrieved correctly.""" + _generate_and_log_exception('exception message', 'log message') + log = (yield from get_error_log(hass, test_client, 1))[0] + assert_log(log, 'exception message', 'log message', 'ERROR') + + +@asyncio.coroutine +def test_warning(hass, test_client): + """Test that warning are logged and retrieved correctly.""" + _LOGGER.warning('warning message') + log = (yield from get_error_log(hass, test_client, 1))[0] + assert_log(log, '', 'warning message', 'WARNING') + + +@asyncio.coroutine +def test_error(hass, test_client): + """Test that errors are logged and retrieved correctly.""" + _LOGGER.error('error message') + log = (yield from get_error_log(hass, test_client, 1))[0] + assert_log(log, '', 'error message', 'ERROR') + + +@asyncio.coroutine +def test_critical(hass, test_client): + """Test that critical are logged and retrieved correctly.""" + _LOGGER.critical('critical message') + log = (yield from get_error_log(hass, test_client, 1))[0] + assert_log(log, '', 'critical message', 'CRITICAL') + + +@asyncio.coroutine +def test_remove_older_logs(hass, test_client): + """Test that older logs are rotated out.""" + _LOGGER.error('error message 1') + _LOGGER.error('error message 2') + _LOGGER.error('error message 3') + log = yield from get_error_log(hass, test_client, 2) + assert_log(log[0], '', 'error message 3', 'ERROR') + assert_log(log[1], '', 'error message 2', 'ERROR') + + +@asyncio.coroutine +def test_clear_logs(hass, test_client): + """Test that the log can be cleared via a service call.""" + _LOGGER.error('error message') + + hass.async_add_job( + hass.services.async_call( + system_log.DOMAIN, system_log.SERVICE_CLEAR, {})) + yield from hass.async_block_till_done() + + # Assert done by get_error_log + yield from get_error_log(hass, test_client, 0) From 1e493dcb8a0acdf552b71dca235c3cdca92bbe8b Mon Sep 17 00:00:00 2001 From: NovapaX Date: Wed, 15 Nov 2017 07:16:21 +0100 Subject: [PATCH 042/246] Tradfri unique identities (#10414) * Unique identity Use unique ID for generating keys and store them in config. Fallback to old id so existing installs will still work. * Remove Timeouts they don't really work. this should be fixed in pytradfri I think. * import uuid only when necessary * more selective import * lint * use load_json and save_json from util.json * remove unnecessary imports * use async configurator functions * async configurator calls * thou shalt not mixup the (a)syncs * again: no asyncs in the syncs! last warning... * Update tradfri.py --- homeassistant/components/tradfri.py | 92 ++++++++++++++--------------- 1 file changed, 45 insertions(+), 47 deletions(-) diff --git a/homeassistant/components/tradfri.py b/homeassistant/components/tradfri.py index ead4924d599..53ea7eac997 100644 --- a/homeassistant/components/tradfri.py +++ b/homeassistant/components/tradfri.py @@ -5,9 +5,8 @@ For more details about this component, please refer to the documentation at https://home-assistant.io/components/ikea_tradfri/ """ import asyncio -import json import logging -import os +from uuid import uuid4 import voluptuous as vol @@ -15,6 +14,7 @@ import homeassistant.helpers.config_validation as cv from homeassistant.helpers import discovery from homeassistant.const import CONF_HOST from homeassistant.components.discovery import SERVICE_IKEA_TRADFRI +from homeassistant.util.json import load_json, save_json REQUIREMENTS = ['pytradfri==4.0.1', 'DTLSSocket==0.1.4', @@ -58,26 +58,40 @@ def request_configuration(hass, config, host): """Handle the submitted configuration.""" try: from pytradfri.api.aiocoap_api import APIFactory + from pytradfri import RequestError except ImportError: _LOGGER.exception("Looks like something isn't installed!") return - api_factory = APIFactory(host, psk_id=GATEWAY_IDENTITY) - psk = yield from api_factory.generate_psk(callback_data.get('key')) - res = yield from _setup_gateway(hass, config, host, psk, + identity = uuid4().hex + security_code = callback_data.get('security_code') + + api_factory = APIFactory(host, psk_id=identity, loop=hass.loop) + # Need To Fix: currently entering a wrong security code sends + # pytradfri aiocoap API into an endless loop. + # Should just raise a requestError or something. + try: + key = yield from api_factory.generate_psk(security_code) + except RequestError: + configurator.async_notify_errors(hass, instance, + "Security Code not accepted.") + return + + res = yield from _setup_gateway(hass, config, host, identity, key, DEFAULT_ALLOW_TRADFRI_GROUPS) if not res: - hass.async_add_job(configurator.notify_errors, instance, - "Unable to connect.") + configurator.async_notify_errors(hass, instance, + "Unable to connect.") return def success(): """Set up was successful.""" - conf = _read_config(hass) - conf[host] = {'key': psk} - _write_config(hass, conf) - hass.async_add_job(configurator.request_done, instance) + conf = load_json(hass.config.path(CONFIG_FILE)) + conf[host] = {'identity': identity, + 'key': key} + save_json(hass.config.path(CONFIG_FILE), conf) + configurator.request_done(instance) hass.async_add_job(success) @@ -86,7 +100,8 @@ def request_configuration(hass, config, host): description='Please enter the security code written at the bottom of ' 'your IKEA Trådfri Gateway.', submit_caption="Confirm", - fields=[{'id': 'key', 'name': 'Security Code', 'type': 'password'}] + fields=[{'id': 'security_code', 'name': 'Security Code', + 'type': 'password'}] ) @@ -96,35 +111,37 @@ def async_setup(hass, config): conf = config.get(DOMAIN, {}) host = conf.get(CONF_HOST) allow_tradfri_groups = conf.get(CONF_ALLOW_TRADFRI_GROUPS) - keys = yield from hass.async_add_job(_read_config, hass) + known_hosts = yield from hass.async_add_job(load_json, + hass.config.path(CONFIG_FILE)) @asyncio.coroutine - def gateway_discovered(service, info): + def gateway_discovered(service, info, + allow_tradfri_groups=DEFAULT_ALLOW_TRADFRI_GROUPS): """Run when a gateway is discovered.""" host = info['host'] - if host in keys: - yield from _setup_gateway(hass, config, host, keys[host]['key'], + if host in known_hosts: + # use fallbacks for old config style + # identity was hard coded as 'homeassistant' + identity = known_hosts[host].get('identity', 'homeassistant') + key = known_hosts[host].get('key') + yield from _setup_gateway(hass, config, host, identity, key, allow_tradfri_groups) else: hass.async_add_job(request_configuration, hass, config, host) discovery.async_listen(hass, SERVICE_IKEA_TRADFRI, gateway_discovered) - if not host: - return True - - if host and keys.get(host): - return (yield from _setup_gateway(hass, config, host, - keys[host]['key'], - allow_tradfri_groups)) - else: - hass.async_add_job(request_configuration, hass, config, host) - return True + if host: + yield from gateway_discovered(None, + {'host': host}, + allow_tradfri_groups) + return True @asyncio.coroutine -def _setup_gateway(hass, hass_config, host, key, allow_tradfri_groups): +def _setup_gateway(hass, hass_config, host, identity, key, + allow_tradfri_groups): """Create a gateway.""" from pytradfri import Gateway, RequestError try: @@ -134,7 +151,7 @@ def _setup_gateway(hass, hass_config, host, key, allow_tradfri_groups): return False try: - factory = APIFactory(host, psk_id=GATEWAY_IDENTITY, psk=key, + factory = APIFactory(host, psk_id=identity, psk=key, loop=hass.loop) api = factory.request gateway = Gateway() @@ -163,22 +180,3 @@ def _setup_gateway(hass, hass_config, host, key, allow_tradfri_groups): hass.async_add_job(discovery.async_load_platform( hass, 'sensor', DOMAIN, {'gateway': gateway_id}, hass_config)) return True - - -def _read_config(hass): - """Read tradfri config.""" - path = hass.config.path(CONFIG_FILE) - - if not os.path.isfile(path): - return {} - - with open(path) as f_handle: - # Guard against empty file - return json.loads(f_handle.read() or '{}') - - -def _write_config(hass, config): - """Write tradfri config.""" - data = json.dumps(config) - with open(hass.config.path(CONFIG_FILE), 'w', encoding='utf-8') as outfile: - outfile.write(data) From 7920ddda9d435b70edc13550fe6224895c780e8e Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Tue, 14 Nov 2017 22:39:06 -0800 Subject: [PATCH 043/246] Add panel build type (#10589) --- homeassistant/components/hassio.py | 2 +- tests/components/test_hassio.py | 6 ++++-- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/hassio.py b/homeassistant/components/hassio.py index 940de2ba12f..048a7d531f4 100644 --- a/homeassistant/components/hassio.py +++ b/homeassistant/components/hassio.py @@ -49,7 +49,7 @@ NO_TIMEOUT = { } NO_AUTH = { - re.compile(r'^panel$'), re.compile(r'^addons/[^/]*/logo$') + re.compile(r'^panel_(es5|latest)$'), re.compile(r'^addons/[^/]*/logo$') } SCHEMA_ADDON = vol.Schema({ diff --git a/tests/components/test_hassio.py b/tests/components/test_hassio.py index 761ba29e403..3704c486a2a 100644 --- a/tests/components/test_hassio.py +++ b/tests/components/test_hassio.py @@ -231,7 +231,8 @@ def test_auth_required_forward_request(hassio_client): @asyncio.coroutine -def test_forward_request_no_auth_for_panel(hassio_client): +@pytest.mark.parametrize('build_type', ['es5', 'latest']) +def test_forward_request_no_auth_for_panel(hassio_client, build_type): """Test no auth needed for .""" response = MagicMock() response.read.return_value = mock_coro('data') @@ -240,7 +241,8 @@ def test_forward_request_no_auth_for_panel(hassio_client): Mock(return_value=mock_coro(response))), \ patch('homeassistant.components.hassio._create_response') as mresp: mresp.return_value = 'response' - resp = yield from hassio_client.get('/api/hassio/panel') + resp = yield from hassio_client.get( + '/api/hassio/panel_{}'.format(build_type)) # Check we got right response assert resp.status == 200 From 0cd3271dfa9b92fd2922fb7c1ad21d1e37582d26 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Tue, 14 Nov 2017 22:48:31 -0800 Subject: [PATCH 044/246] Update frontend to 20171115.0 --- homeassistant/components/frontend/__init__.py | 2 +- requirements_all.txt | 2 +- requirements_test_all.txt | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index f6c058f977e..d1f35683e95 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -23,7 +23,7 @@ from homeassistant.const import CONF_NAME, EVENT_THEMES_UPDATED from homeassistant.core import callback from homeassistant.loader import bind_hass -REQUIREMENTS = ['home-assistant-frontend==20171111.0'] +REQUIREMENTS = ['home-assistant-frontend==20171115.0'] DOMAIN = 'frontend' DEPENDENCIES = ['api', 'websocket_api', 'http', 'system_log'] diff --git a/requirements_all.txt b/requirements_all.txt index 70e68e5bfa6..6125ee9a090 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -331,7 +331,7 @@ hipnotify==1.0.8 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171111.0 +home-assistant-frontend==20171115.0 # homeassistant.components.camera.onvif http://github.com/tgaugry/suds-passworddigest-py3/archive/86fc50e39b4d2b8997481967d6a7fe1c57118999.zip#suds-passworddigest-py3==0.1.2a diff --git a/requirements_test_all.txt b/requirements_test_all.txt index 79440bf6be6..ea2700f7c9b 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -74,7 +74,7 @@ hbmqtt==0.8 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171111.0 +home-assistant-frontend==20171115.0 # homeassistant.components.influxdb # homeassistant.components.sensor.influxdb From ea7ffff0ca43eb9e4185ab34bfd32e8b26f19d12 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Tue, 14 Nov 2017 23:16:19 -0800 Subject: [PATCH 045/246] Cloud updates (#10567) * Update cloud * Fix tests * Lint --- homeassistant/components/cloud/__init__.py | 37 +++++++-- homeassistant/components/cloud/auth_api.py | 1 - homeassistant/components/cloud/const.py | 5 ++ homeassistant/components/cloud/http_api.py | 10 ++- homeassistant/components/cloud/iot.py | 73 +++++++++++----- tests/components/cloud/test_auth_api.py | 1 - tests/components/cloud/test_http_api.py | 44 +++++++--- tests/components/cloud/test_init.py | 42 ++++++++-- tests/components/cloud/test_iot.py | 97 ++++++++++++---------- 9 files changed, 219 insertions(+), 91 deletions(-) diff --git a/homeassistant/components/cloud/__init__.py b/homeassistant/components/cloud/__init__.py index c5d709d60c3..2d01399bc07 100644 --- a/homeassistant/components/cloud/__init__.py +++ b/homeassistant/components/cloud/__init__.py @@ -1,5 +1,6 @@ """Component to integrate the Home Assistant cloud.""" import asyncio +from datetime import datetime import json import logging import os @@ -8,6 +9,7 @@ import voluptuous as vol from homeassistant.const import ( EVENT_HOMEASSISTANT_START, CONF_REGION, CONF_MODE) +from homeassistant.util import dt as dt_util from . import http_api, iot from .const import CONFIG_DIR, DOMAIN, SERVERS @@ -66,7 +68,6 @@ class Cloud: """Create an instance of Cloud.""" self.hass = hass self.mode = mode - self.email = None self.id_token = None self.access_token = None self.refresh_token = None @@ -89,7 +90,29 @@ class Cloud: @property def is_logged_in(self): """Get if cloud is logged in.""" - return self.email is not None + return self.id_token is not None + + @property + def subscription_expired(self): + """Return a boolen if the subscription has expired.""" + # For now, don't enforce subscriptions to exist + if 'custom:sub-exp' not in self.claims: + return False + + return dt_util.utcnow() > self.expiration_date + + @property + def expiration_date(self): + """Return the subscription expiration as a UTC datetime object.""" + return datetime.combine( + dt_util.parse_date(self.claims['custom:sub-exp']), + datetime.min.time()).replace(tzinfo=dt_util.UTC) + + @property + def claims(self): + """Get the claims from the id token.""" + from jose import jwt + return jwt.get_unverified_claims(self.id_token) @property def user_info_path(self): @@ -110,18 +133,20 @@ class Cloud: if os.path.isfile(user_info): with open(user_info, 'rt') as file: info = json.loads(file.read()) - self.email = info['email'] self.id_token = info['id_token'] self.access_token = info['access_token'] self.refresh_token = info['refresh_token'] yield from self.hass.async_add_job(load_config) - if self.email is not None: + if self.id_token is not None: yield from self.iot.connect() def path(self, *parts): - """Get config path inside cloud dir.""" + """Get config path inside cloud dir. + + Async friendly. + """ return self.hass.config.path(CONFIG_DIR, *parts) @asyncio.coroutine @@ -129,7 +154,6 @@ class Cloud: """Close connection and remove all credentials.""" yield from self.iot.disconnect() - self.email = None self.id_token = None self.access_token = None self.refresh_token = None @@ -141,7 +165,6 @@ class Cloud: """Write user info to a file.""" with open(self.user_info_path, 'wt') as file: file.write(json.dumps({ - 'email': self.email, 'id_token': self.id_token, 'access_token': self.access_token, 'refresh_token': self.refresh_token, diff --git a/homeassistant/components/cloud/auth_api.py b/homeassistant/components/cloud/auth_api.py index 50a88d4be4d..cb9fe15ab4a 100644 --- a/homeassistant/components/cloud/auth_api.py +++ b/homeassistant/components/cloud/auth_api.py @@ -113,7 +113,6 @@ def login(cloud, email, password): cloud.id_token = cognito.id_token cloud.access_token = cognito.access_token cloud.refresh_token = cognito.refresh_token - cloud.email = email cloud.write_user_info() diff --git a/homeassistant/components/cloud/const.py b/homeassistant/components/cloud/const.py index 334e522f81b..440e4179eea 100644 --- a/homeassistant/components/cloud/const.py +++ b/homeassistant/components/cloud/const.py @@ -12,3 +12,8 @@ SERVERS = { # 'relayer': '' # } } + +MESSAGE_EXPIRATION = """ +It looks like your Home Assistant Cloud subscription has expired. Please check +your [account page](/config/cloud/account) to continue using the service. +""" diff --git a/homeassistant/components/cloud/http_api.py b/homeassistant/components/cloud/http_api.py index aa91f5a45e7..d16df130c48 100644 --- a/homeassistant/components/cloud/http_api.py +++ b/homeassistant/components/cloud/http_api.py @@ -79,8 +79,10 @@ class CloudLoginView(HomeAssistantView): with async_timeout.timeout(REQUEST_TIMEOUT, loop=hass.loop): yield from hass.async_add_job(auth_api.login, cloud, data['email'], data['password']) - hass.async_add_job(cloud.iot.connect) + hass.async_add_job(cloud.iot.connect) + # Allow cloud to start connecting. + yield from asyncio.sleep(0, loop=hass.loop) return self.json(_account_data(cloud)) @@ -222,6 +224,10 @@ class CloudConfirmForgotPasswordView(HomeAssistantView): def _account_data(cloud): """Generate the auth data JSON response.""" + claims = cloud.claims + return { - 'email': cloud.email + 'email': claims['email'], + 'sub_exp': claims.get('custom:sub-exp'), + 'cloud': cloud.iot.state, } diff --git a/homeassistant/components/cloud/iot.py b/homeassistant/components/cloud/iot.py index 1bb6668e0cc..c0b6bb96da1 100644 --- a/homeassistant/components/cloud/iot.py +++ b/homeassistant/components/cloud/iot.py @@ -9,11 +9,16 @@ from homeassistant.components.alexa import smart_home from homeassistant.util.decorator import Registry from homeassistant.helpers.aiohttp_client import async_get_clientsession from . import auth_api +from .const import MESSAGE_EXPIRATION HANDLERS = Registry() _LOGGER = logging.getLogger(__name__) +STATE_CONNECTING = 'connecting' +STATE_CONNECTED = 'connected' +STATE_DISCONNECTED = 'disconnected' + class UnknownHandler(Exception): """Exception raised when trying to handle unknown handler.""" @@ -25,27 +30,41 @@ class CloudIoT: def __init__(self, cloud): """Initialize the CloudIoT class.""" self.cloud = cloud + # The WebSocket client self.client = None + # Scheduled sleep task till next connection retry + self.retry_task = None + # Boolean to indicate if we wanted the connection to close self.close_requested = False + # The current number of attempts to connect, impacts wait time self.tries = 0 - - @property - def is_connected(self): - """Return if connected to the cloud.""" - return self.client is not None + # Current state of the connection + self.state = STATE_DISCONNECTED @asyncio.coroutine def connect(self): """Connect to the IoT broker.""" - if self.client is not None: - raise RuntimeError('Cannot connect while already connected') - - self.close_requested = False - hass = self.cloud.hass - remove_hass_stop_listener = None + if self.cloud.subscription_expired: + # Try refreshing the token to see if it is still expired. + yield from hass.async_add_job(auth_api.check_token, self.cloud) + if self.cloud.subscription_expired: + hass.components.persistent_notification.async_create( + MESSAGE_EXPIRATION, 'Subscription expired', + 'cloud_subscription_expired') + self.state = STATE_DISCONNECTED + return + + if self.state == STATE_CONNECTED: + raise RuntimeError('Already connected') + + self.state = STATE_CONNECTING + self.close_requested = False + remove_hass_stop_listener = None session = async_get_clientsession(self.cloud.hass) + client = None + disconnect_warn = None @asyncio.coroutine def _handle_hass_stop(event): @@ -54,8 +73,6 @@ class CloudIoT: remove_hass_stop_listener = None yield from self.disconnect() - client = None - disconnect_warn = None try: yield from hass.async_add_job(auth_api.check_token, self.cloud) @@ -70,13 +87,14 @@ class CloudIoT: EVENT_HOMEASSISTANT_STOP, _handle_hass_stop) _LOGGER.info('Connected') + self.state = STATE_CONNECTED while not client.closed: msg = yield from client.receive() if msg.type in (WSMsgType.ERROR, WSMsgType.CLOSED, WSMsgType.CLOSING): - disconnect_warn = 'Closed by server' + disconnect_warn = 'Connection cancelled.' break elif msg.type != WSMsgType.TEXT: @@ -144,20 +162,33 @@ class CloudIoT: self.client = None yield from client.close() - if not self.close_requested: + if self.close_requested: + self.state = STATE_DISCONNECTED + + else: + self.state = STATE_CONNECTING self.tries += 1 - # Sleep 0, 5, 10, 15 … up to 30 seconds between retries - yield from asyncio.sleep( - min(30, (self.tries - 1) * 5), loop=hass.loop) - - hass.async_add_job(self.connect()) + try: + # Sleep 0, 5, 10, 15 … up to 30 seconds between retries + self.retry_task = hass.async_add_job(asyncio.sleep( + min(30, (self.tries - 1) * 5), loop=hass.loop)) + yield from self.retry_task + self.retry_task = None + hass.async_add_job(self.connect()) + except asyncio.CancelledError: + # Happens if disconnect called + pass @asyncio.coroutine def disconnect(self): """Disconnect the client.""" self.close_requested = True - yield from self.client.close() + + if self.client is not None: + yield from self.client.close() + elif self.retry_task is not None: + self.retry_task.cancel() @asyncio.coroutine diff --git a/tests/components/cloud/test_auth_api.py b/tests/components/cloud/test_auth_api.py index d9f005fdcfa..20f9265a1c1 100644 --- a/tests/components/cloud/test_auth_api.py +++ b/tests/components/cloud/test_auth_api.py @@ -69,7 +69,6 @@ def test_login(mock_cognito): auth_api.login(cloud, 'user', 'pass') assert len(mock_cognito.authenticate.mock_calls) == 1 - assert cloud.email == 'user' assert cloud.id_token == 'test_id_token' assert cloud.access_token == 'test_access_token' assert cloud.refresh_token == 'test_refresh_token' diff --git a/tests/components/cloud/test_http_api.py b/tests/components/cloud/test_http_api.py index 1090acb01e9..296baa3f143 100644 --- a/tests/components/cloud/test_http_api.py +++ b/tests/components/cloud/test_http_api.py @@ -3,9 +3,10 @@ import asyncio from unittest.mock import patch, MagicMock import pytest +from jose import jwt from homeassistant.bootstrap import async_setup_component -from homeassistant.components.cloud import DOMAIN, auth_api +from homeassistant.components.cloud import DOMAIN, auth_api, iot from tests.common import mock_coro @@ -23,7 +24,8 @@ def cloud_client(hass, test_client): 'relayer': 'relayer', } })) - return hass.loop.run_until_complete(test_client(hass.http.app)) + with patch('homeassistant.components.cloud.Cloud.write_user_info'): + yield hass.loop.run_until_complete(test_client(hass.http.app)) @pytest.fixture @@ -43,21 +45,35 @@ def test_account_view_no_account(cloud_client): @asyncio.coroutine def test_account_view(hass, cloud_client): """Test fetching account if no account available.""" - hass.data[DOMAIN].email = 'hello@home-assistant.io' + hass.data[DOMAIN].id_token = jwt.encode({ + 'email': 'hello@home-assistant.io', + 'custom:sub-exp': '2018-01-03' + }, 'test') + hass.data[DOMAIN].iot.state = iot.STATE_CONNECTED req = yield from cloud_client.get('/api/cloud/account') assert req.status == 200 result = yield from req.json() - assert result == {'email': 'hello@home-assistant.io'} + assert result == { + 'email': 'hello@home-assistant.io', + 'sub_exp': '2018-01-03', + 'cloud': iot.STATE_CONNECTED, + } @asyncio.coroutine -def test_login_view(hass, cloud_client): +def test_login_view(hass, cloud_client, mock_cognito): """Test logging in.""" - hass.data[DOMAIN].email = 'hello@home-assistant.io' + mock_cognito.id_token = jwt.encode({ + 'email': 'hello@home-assistant.io', + 'custom:sub-exp': '2018-01-03' + }, 'test') + mock_cognito.access_token = 'access_token' + mock_cognito.refresh_token = 'refresh_token' - with patch('homeassistant.components.cloud.iot.CloudIoT.connect'), \ - patch('homeassistant.components.cloud.' - 'auth_api.login') as mock_login: + with patch('homeassistant.components.cloud.iot.CloudIoT.' + 'connect') as mock_connect, \ + patch('homeassistant.components.cloud.auth_api._authenticate', + return_value=mock_cognito) as mock_auth: req = yield from cloud_client.post('/api/cloud/login', json={ 'email': 'my_username', 'password': 'my_password' @@ -65,9 +81,13 @@ def test_login_view(hass, cloud_client): assert req.status == 200 result = yield from req.json() - assert result == {'email': 'hello@home-assistant.io'} - assert len(mock_login.mock_calls) == 1 - cloud, result_user, result_pass = mock_login.mock_calls[0][1] + assert result['email'] == 'hello@home-assistant.io' + assert result['sub_exp'] == '2018-01-03' + + assert len(mock_connect.mock_calls) == 1 + + assert len(mock_auth.mock_calls) == 1 + cloud, result_user, result_pass = mock_auth.mock_calls[0][1] assert result_user == 'my_username' assert result_pass == 'my_password' diff --git a/tests/components/cloud/test_init.py b/tests/components/cloud/test_init.py index 1eb1051520f..c05fdabf465 100644 --- a/tests/components/cloud/test_init.py +++ b/tests/components/cloud/test_init.py @@ -3,9 +3,11 @@ import asyncio import json from unittest.mock import patch, MagicMock, mock_open +from jose import jwt import pytest from homeassistant.components import cloud +from homeassistant.util.dt import utcnow from tests.common import mock_coro @@ -72,7 +74,6 @@ def test_initialize_loads_info(mock_os, hass): """Test initialize will load info from config file.""" mock_os.path.isfile.return_value = True mopen = mock_open(read_data=json.dumps({ - 'email': 'test-email', 'id_token': 'test-id-token', 'access_token': 'test-access-token', 'refresh_token': 'test-refresh-token', @@ -85,7 +86,6 @@ def test_initialize_loads_info(mock_os, hass): with patch('homeassistant.components.cloud.open', mopen, create=True): yield from cl.initialize() - assert cl.email == 'test-email' assert cl.id_token == 'test-id-token' assert cl.access_token == 'test-access-token' assert cl.refresh_token == 'test-refresh-token' @@ -102,7 +102,6 @@ def test_logout_clears_info(mock_os, hass): yield from cl.logout() assert len(cl.iot.disconnect.mock_calls) == 1 - assert cl.email is None assert cl.id_token is None assert cl.access_token is None assert cl.refresh_token is None @@ -115,7 +114,6 @@ def test_write_user_info(): mopen = mock_open() cl = cloud.Cloud(MagicMock(), cloud.MODE_DEV) - cl.email = 'test-email' cl.id_token = 'test-id-token' cl.access_token = 'test-access-token' cl.refresh_token = 'test-refresh-token' @@ -129,7 +127,41 @@ def test_write_user_info(): data = json.loads(handle.write.mock_calls[0][1][0]) assert data == { 'access_token': 'test-access-token', - 'email': 'test-email', 'id_token': 'test-id-token', 'refresh_token': 'test-refresh-token', } + + +@asyncio.coroutine +def test_subscription_not_expired_without_sub_in_claim(): + """Test that we do not enforce subscriptions yet.""" + cl = cloud.Cloud(None, cloud.MODE_DEV) + cl.id_token = jwt.encode({}, 'test') + + assert not cl.subscription_expired + + +@asyncio.coroutine +def test_subscription_expired(): + """Test subscription being expired.""" + cl = cloud.Cloud(None, cloud.MODE_DEV) + cl.id_token = jwt.encode({ + 'custom:sub-exp': '2017-11-13' + }, 'test') + + with patch('homeassistant.util.dt.utcnow', + return_value=utcnow().replace(year=2018)): + assert cl.subscription_expired + + +@asyncio.coroutine +def test_subscription_not_expired(): + """Test subscription not being expired.""" + cl = cloud.Cloud(None, cloud.MODE_DEV) + cl.id_token = jwt.encode({ + 'custom:sub-exp': '2017-11-13' + }, 'test') + + with patch('homeassistant.util.dt.utcnow', + return_value=utcnow().replace(year=2017, month=11, day=9)): + assert not cl.subscription_expired diff --git a/tests/components/cloud/test_iot.py b/tests/components/cloud/test_iot.py index f1254cdb3c7..be5a93c9e47 100644 --- a/tests/components/cloud/test_iot.py +++ b/tests/components/cloud/test_iot.py @@ -30,11 +30,16 @@ def mock_handle_message(): yield mock +@pytest.fixture +def mock_cloud(): + """Mock cloud class.""" + return MagicMock(subscription_expired=False) + + @asyncio.coroutine -def test_cloud_calling_handler(mock_client, mock_handle_message): +def test_cloud_calling_handler(mock_client, mock_handle_message, mock_cloud): """Test we call handle message with correct info.""" - cloud = MagicMock() - conn = iot.CloudIoT(cloud) + conn = iot.CloudIoT(mock_cloud) mock_client.receive.return_value = mock_coro(MagicMock( type=WSMsgType.text, json=MagicMock(return_value={ @@ -53,8 +58,8 @@ def test_cloud_calling_handler(mock_client, mock_handle_message): p_hass, p_cloud, handler_name, payload = \ mock_handle_message.mock_calls[0][1] - assert p_hass is cloud.hass - assert p_cloud is cloud + assert p_hass is mock_cloud.hass + assert p_cloud is mock_cloud assert handler_name == 'test-handler' assert payload == 'test-payload' @@ -67,10 +72,9 @@ def test_cloud_calling_handler(mock_client, mock_handle_message): @asyncio.coroutine -def test_connection_msg_for_unknown_handler(mock_client): +def test_connection_msg_for_unknown_handler(mock_client, mock_cloud): """Test a msg for an unknown handler.""" - cloud = MagicMock() - conn = iot.CloudIoT(cloud) + conn = iot.CloudIoT(mock_cloud) mock_client.receive.return_value = mock_coro(MagicMock( type=WSMsgType.text, json=MagicMock(return_value={ @@ -92,10 +96,10 @@ def test_connection_msg_for_unknown_handler(mock_client): @asyncio.coroutine -def test_connection_msg_for_handler_raising(mock_client, mock_handle_message): +def test_connection_msg_for_handler_raising(mock_client, mock_handle_message, + mock_cloud): """Test we sent error when handler raises exception.""" - cloud = MagicMock() - conn = iot.CloudIoT(cloud) + conn = iot.CloudIoT(mock_cloud) mock_client.receive.return_value = mock_coro(MagicMock( type=WSMsgType.text, json=MagicMock(return_value={ @@ -136,37 +140,34 @@ def test_handler_forwarding(): @asyncio.coroutine -def test_handling_core_messages(hass): +def test_handling_core_messages(hass, mock_cloud): """Test handling core messages.""" - cloud = MagicMock() - cloud.logout.return_value = mock_coro() - yield from iot.async_handle_cloud(hass, cloud, { + mock_cloud.logout.return_value = mock_coro() + yield from iot.async_handle_cloud(hass, mock_cloud, { 'action': 'logout', 'reason': 'Logged in at two places.' }) - assert len(cloud.logout.mock_calls) == 1 + assert len(mock_cloud.logout.mock_calls) == 1 @asyncio.coroutine -def test_cloud_getting_disconnected_by_server(mock_client, caplog): +def test_cloud_getting_disconnected_by_server(mock_client, caplog, mock_cloud): """Test server disconnecting instance.""" - cloud = MagicMock() - conn = iot.CloudIoT(cloud) + conn = iot.CloudIoT(mock_cloud) mock_client.receive.return_value = mock_coro(MagicMock( type=WSMsgType.CLOSING, )) yield from conn.connect() - assert 'Connection closed: Closed by server' in caplog.text - assert 'connect' in str(cloud.hass.async_add_job.mock_calls[-1][1][0]) + assert 'Connection closed: Connection cancelled.' in caplog.text + assert 'connect' in str(mock_cloud.hass.async_add_job.mock_calls[-1][1][0]) @asyncio.coroutine -def test_cloud_receiving_bytes(mock_client, caplog): +def test_cloud_receiving_bytes(mock_client, caplog, mock_cloud): """Test server disconnecting instance.""" - cloud = MagicMock() - conn = iot.CloudIoT(cloud) + conn = iot.CloudIoT(mock_cloud) mock_client.receive.return_value = mock_coro(MagicMock( type=WSMsgType.BINARY, )) @@ -174,14 +175,13 @@ def test_cloud_receiving_bytes(mock_client, caplog): yield from conn.connect() assert 'Connection closed: Received non-Text message' in caplog.text - assert 'connect' in str(cloud.hass.async_add_job.mock_calls[-1][1][0]) + assert 'connect' in str(mock_cloud.hass.async_add_job.mock_calls[-1][1][0]) @asyncio.coroutine -def test_cloud_sending_invalid_json(mock_client, caplog): +def test_cloud_sending_invalid_json(mock_client, caplog, mock_cloud): """Test cloud sending invalid JSON.""" - cloud = MagicMock() - conn = iot.CloudIoT(cloud) + conn = iot.CloudIoT(mock_cloud) mock_client.receive.return_value = mock_coro(MagicMock( type=WSMsgType.TEXT, json=MagicMock(side_effect=ValueError) @@ -190,27 +190,25 @@ def test_cloud_sending_invalid_json(mock_client, caplog): yield from conn.connect() assert 'Connection closed: Received invalid JSON.' in caplog.text - assert 'connect' in str(cloud.hass.async_add_job.mock_calls[-1][1][0]) + assert 'connect' in str(mock_cloud.hass.async_add_job.mock_calls[-1][1][0]) @asyncio.coroutine -def test_cloud_check_token_raising(mock_client, caplog): +def test_cloud_check_token_raising(mock_client, caplog, mock_cloud): """Test cloud sending invalid JSON.""" - cloud = MagicMock() - conn = iot.CloudIoT(cloud) + conn = iot.CloudIoT(mock_cloud) mock_client.receive.side_effect = auth_api.CloudError yield from conn.connect() assert 'Unable to connect: Unable to refresh token.' in caplog.text - assert 'connect' in str(cloud.hass.async_add_job.mock_calls[-1][1][0]) + assert 'connect' in str(mock_cloud.hass.async_add_job.mock_calls[-1][1][0]) @asyncio.coroutine -def test_cloud_connect_invalid_auth(mock_client, caplog): +def test_cloud_connect_invalid_auth(mock_client, caplog, mock_cloud): """Test invalid auth detected by server.""" - cloud = MagicMock() - conn = iot.CloudIoT(cloud) + conn = iot.CloudIoT(mock_cloud) mock_client.receive.side_effect = \ client_exceptions.WSServerHandshakeError(None, None, code=401) @@ -220,10 +218,9 @@ def test_cloud_connect_invalid_auth(mock_client, caplog): @asyncio.coroutine -def test_cloud_unable_to_connect(mock_client, caplog): +def test_cloud_unable_to_connect(mock_client, caplog, mock_cloud): """Test unable to connect error.""" - cloud = MagicMock() - conn = iot.CloudIoT(cloud) + conn = iot.CloudIoT(mock_cloud) mock_client.receive.side_effect = client_exceptions.ClientError(None, None) yield from conn.connect() @@ -232,12 +229,28 @@ def test_cloud_unable_to_connect(mock_client, caplog): @asyncio.coroutine -def test_cloud_random_exception(mock_client, caplog): +def test_cloud_random_exception(mock_client, caplog, mock_cloud): """Test random exception.""" - cloud = MagicMock() - conn = iot.CloudIoT(cloud) + conn = iot.CloudIoT(mock_cloud) mock_client.receive.side_effect = Exception yield from conn.connect() assert 'Unexpected error' in caplog.text + + +@asyncio.coroutine +def test_refresh_token_before_expiration_fails(hass, mock_cloud): + """Test that we don't connect if token is expired.""" + mock_cloud.subscription_expired = True + mock_cloud.hass = hass + conn = iot.CloudIoT(mock_cloud) + + with patch('homeassistant.components.cloud.auth_api.check_token', + return_value=mock_coro()) as mock_check_token, \ + patch.object(hass.components.persistent_notification, + 'async_create') as mock_create: + yield from conn.connect() + + assert len(mock_check_token.mock_calls) == 1 + assert len(mock_create.mock_calls) == 1 From d5b170f76166e194c1a54f658111e0d9b96e2606 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Wed, 15 Nov 2017 12:41:25 +0100 Subject: [PATCH 046/246] Upgrade youtube_dl to 2017.11.15 (#10592) --- homeassistant/components/media_extractor.py | 2 +- requirements_all.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/media_extractor.py b/homeassistant/components/media_extractor.py index 3b75c4494d8..d1f7f89863c 100644 --- a/homeassistant/components/media_extractor.py +++ b/homeassistant/components/media_extractor.py @@ -16,7 +16,7 @@ from homeassistant.components.media_player import ( from homeassistant.config import load_yaml_config_file from homeassistant.helpers import config_validation as cv -REQUIREMENTS = ['youtube_dl==2017.11.06'] +REQUIREMENTS = ['youtube_dl==2017.11.15'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index 6125ee9a090..c2bdad99efb 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -1157,7 +1157,7 @@ yeelight==0.3.3 yeelightsunflower==0.0.8 # homeassistant.components.media_extractor -youtube_dl==2017.11.06 +youtube_dl==2017.11.15 # homeassistant.components.light.zengge zengge==0.2 From c7b0f25eae0936ced42bf0183e00aee419500763 Mon Sep 17 00:00:00 2001 From: On Freund Date: Wed, 15 Nov 2017 22:27:26 +0200 Subject: [PATCH 047/246] Fix Yahoo Weather icons over SSL (#10602) --- homeassistant/components/sensor/yweather.py | 2 +- homeassistant/components/weather/yweather.py | 2 +- requirements_all.txt | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/sensor/yweather.py b/homeassistant/components/sensor/yweather.py index 2883a396b77..873e27975db 100644 --- a/homeassistant/components/sensor/yweather.py +++ b/homeassistant/components/sensor/yweather.py @@ -17,7 +17,7 @@ from homeassistant.const import ( from homeassistant.helpers.entity import Entity from homeassistant.util import Throttle -REQUIREMENTS = ['yahooweather==0.8'] +REQUIREMENTS = ['yahooweather==0.9'] _LOGGER = logging.getLogger(__name__) diff --git a/homeassistant/components/weather/yweather.py b/homeassistant/components/weather/yweather.py index 12dc73af5cd..514eda0f09f 100644 --- a/homeassistant/components/weather/yweather.py +++ b/homeassistant/components/weather/yweather.py @@ -15,7 +15,7 @@ from homeassistant.components.weather import ( ATTR_FORECAST_TEMP, ATTR_FORECAST_TIME) from homeassistant.const import (TEMP_CELSIUS, CONF_NAME, STATE_UNKNOWN) -REQUIREMENTS = ["yahooweather==0.8"] +REQUIREMENTS = ["yahooweather==0.9"] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index c2bdad99efb..dd4c97a7ea1 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -1148,7 +1148,7 @@ yahoo-finance==1.4.0 # homeassistant.components.sensor.yweather # homeassistant.components.weather.yweather -yahooweather==0.8 +yahooweather==0.9 # homeassistant.components.light.yeelight yeelight==0.3.3 From c2d0c8fba4cca89233f6c24d9baa5ee2b416963a Mon Sep 17 00:00:00 2001 From: Jeremy Williams Date: Wed, 15 Nov 2017 16:33:50 -0600 Subject: [PATCH 048/246] Arlo - Fixes for updated library (#9892) * Reduce update calls to API. Add signal strength monitor. * Fix lint errors * Fix indent * Update pyarlo version and review fixes * Fix lint errors * Remove staticmethod * Clean up attributes * Update arlo.py --- homeassistant/components/arlo.py | 2 +- homeassistant/components/camera/arlo.py | 35 +++++++++++-------------- homeassistant/components/sensor/arlo.py | 24 ++++++++++++++--- requirements_all.txt | 2 +- 4 files changed, 39 insertions(+), 24 deletions(-) diff --git a/homeassistant/components/arlo.py b/homeassistant/components/arlo.py index f3397a884d1..a78b334de0b 100644 --- a/homeassistant/components/arlo.py +++ b/homeassistant/components/arlo.py @@ -12,7 +12,7 @@ from requests.exceptions import HTTPError, ConnectTimeout from homeassistant.helpers import config_validation as cv from homeassistant.const import CONF_USERNAME, CONF_PASSWORD -REQUIREMENTS = ['pyarlo==0.0.7'] +REQUIREMENTS = ['pyarlo==0.1.0'] _LOGGER = logging.getLogger(__name__) diff --git a/homeassistant/components/camera/arlo.py b/homeassistant/components/camera/arlo.py index be58b61fb8c..4f597771726 100644 --- a/homeassistant/components/camera/arlo.py +++ b/homeassistant/components/camera/arlo.py @@ -19,7 +19,7 @@ from homeassistant.helpers.aiohttp_client import async_aiohttp_proxy_stream _LOGGER = logging.getLogger(__name__) -SCAN_INTERVAL = timedelta(minutes=10) +SCAN_INTERVAL = timedelta(seconds=90) ARLO_MODE_ARMED = 'armed' ARLO_MODE_DISARMED = 'disarmed' @@ -31,6 +31,7 @@ ATTR_MOTION = 'motion_detection_sensitivity' ATTR_POWERSAVE = 'power_save_mode' ATTR_SIGNAL_STRENGTH = 'signal_strength' ATTR_UNSEEN_VIDEOS = 'unseen_videos' +ATTR_LAST_REFRESH = 'last_refresh' CONF_FFMPEG_ARGUMENTS = 'ffmpeg_arguments' @@ -73,6 +74,8 @@ class ArloCam(Camera): self._motion_status = False self._ffmpeg = hass.data[DATA_FFMPEG] self._ffmpeg_arguments = device_info.get(CONF_FFMPEG_ARGUMENTS) + self._last_refresh = None + self._camera.base_station.refresh_rate = SCAN_INTERVAL.total_seconds() self.attrs = {} def camera_image(self): @@ -105,14 +108,17 @@ class ArloCam(Camera): def device_state_attributes(self): """Return the state attributes.""" return { - ATTR_BATTERY_LEVEL: self.attrs.get(ATTR_BATTERY_LEVEL), - ATTR_BRIGHTNESS: self.attrs.get(ATTR_BRIGHTNESS), - ATTR_FLIPPED: self.attrs.get(ATTR_FLIPPED), - ATTR_MIRRORED: self.attrs.get(ATTR_MIRRORED), - ATTR_MOTION: self.attrs.get(ATTR_MOTION), - ATTR_POWERSAVE: self.attrs.get(ATTR_POWERSAVE), - ATTR_SIGNAL_STRENGTH: self.attrs.get(ATTR_SIGNAL_STRENGTH), - ATTR_UNSEEN_VIDEOS: self.attrs.get(ATTR_UNSEEN_VIDEOS), + name: value for name, value in ( + (ATTR_BATTERY_LEVEL, self._camera.battery_level), + (ATTR_BRIGHTNESS, self._camera.brightness), + (ATTR_FLIPPED, self._camera.flip_state), + (ATTR_MIRRORED, self._camera.mirror_state), + (ATTR_MOTION, self._camera.motion_detection_sensitivity), + (ATTR_POWERSAVE, POWERSAVE_MODE_MAPPING.get( + self._camera.powersave_mode)), + (ATTR_SIGNAL_STRENGTH, self._camera.signal_strength), + (ATTR_UNSEEN_VIDEOS, self._camera.unseen_videos), + ) if value is not None } @property @@ -160,13 +166,4 @@ class ArloCam(Camera): def update(self): """Add an attribute-update task to the executor pool.""" - self.attrs[ATTR_BATTERY_LEVEL] = self._camera.get_battery_level - self.attrs[ATTR_BRIGHTNESS] = self._camera.get_battery_level - self.attrs[ATTR_FLIPPED] = self._camera.get_flip_state, - self.attrs[ATTR_MIRRORED] = self._camera.get_mirror_state, - self.attrs[ - ATTR_MOTION] = self._camera.get_motion_detection_sensitivity, - self.attrs[ATTR_POWERSAVE] = POWERSAVE_MODE_MAPPING[ - self._camera.get_powersave_mode], - self.attrs[ATTR_SIGNAL_STRENGTH] = self._camera.get_signal_strength, - self.attrs[ATTR_UNSEEN_VIDEOS] = self._camera.unseen_videos + self._camera.update() diff --git a/homeassistant/components/sensor/arlo.py b/homeassistant/components/sensor/arlo.py index f665d8e70ab..97b7ac22909 100644 --- a/homeassistant/components/sensor/arlo.py +++ b/homeassistant/components/sensor/arlo.py @@ -29,7 +29,8 @@ SENSOR_TYPES = { 'last_capture': ['Last', None, 'run-fast'], 'total_cameras': ['Arlo Cameras', None, 'video'], 'captured_today': ['Captured Today', None, 'file-video'], - 'battery_level': ['Battery Level', '%', 'battery-50'] + 'battery_level': ['Battery Level', '%', 'battery-50'], + 'signal_strength': ['Signal Strength', None, 'signal'] } PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ @@ -97,6 +98,16 @@ class ArloSensor(Entity): def update(self): """Get the latest data and updates the state.""" + try: + base_station = self._data.base_station + except (AttributeError, IndexError): + return + + if not base_station: + return + + base_station.refresh_rate = SCAN_INTERVAL.total_seconds() + self._data.update() if self._sensor_type == 'total_cameras': @@ -114,7 +125,13 @@ class ArloSensor(Entity): elif self._sensor_type == 'battery_level': try: - self._state = self._data.get_battery_level + self._state = self._data.battery_level + except TypeError: + self._state = None + + elif self._sensor_type == 'signal_strength': + try: + self._state = self._data.signal_strength except TypeError: self._state = None @@ -128,7 +145,8 @@ class ArloSensor(Entity): if self._sensor_type == 'last_capture' or \ self._sensor_type == 'captured_today' or \ - self._sensor_type == 'battery_level': + self._sensor_type == 'battery_level' or \ + self._sensor_type == 'signal_strength': attrs['model'] = self._data.model_id return attrs diff --git a/requirements_all.txt b/requirements_all.txt index dd4c97a7ea1..46f28eb5037 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -603,7 +603,7 @@ pyairvisual==1.0.0 pyalarmdotcom==0.3.0 # homeassistant.components.arlo -pyarlo==0.0.7 +pyarlo==0.1.0 # homeassistant.components.notify.xmpp pyasn1-modules==0.1.5 From 87995ad62c35e1e58ed5c7a48d7afddcdaaeb131 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pierre=20St=C3=A5hl?= Date: Wed, 15 Nov 2017 23:45:08 +0100 Subject: [PATCH 049/246] Do not add panel from system_log (#10600) The frontend will not have this panel. --- homeassistant/components/system_log/__init__.py | 2 -- 1 file changed, 2 deletions(-) diff --git a/homeassistant/components/system_log/__init__.py b/homeassistant/components/system_log/__init__.py index f2d3e4edad2..6505107d034 100644 --- a/homeassistant/components/system_log/__init__.py +++ b/homeassistant/components/system_log/__init__.py @@ -69,8 +69,6 @@ def async_setup(hass, config): logging.getLogger().addHandler(handler) hass.http.register_view(AllErrorsView(handler)) - yield from hass.components.frontend.async_register_built_in_panel( - 'system-log', 'system_log', 'mdi:monitor') @asyncio.coroutine def async_service_handler(service): From d652d793f3f1e2d68afdf35935589f5eb487fc0b Mon Sep 17 00:00:00 2001 From: ziotibia81 Date: Thu, 16 Nov 2017 00:17:17 +0100 Subject: [PATCH 050/246] Fix ValueError exception (#10596) * Fix ValueError exception structure = '>{:c}'.format(data_types[register.get(CONF_DATA_TYPE)][register.get(CONF_COUNT)]) give: ValueError: Unknown format code 'c' for object of type 'str' * Minor typo --- homeassistant/components/sensor/modbus.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/sensor/modbus.py b/homeassistant/components/sensor/modbus.py index b05b58344fb..c4014fbd1dd 100644 --- a/homeassistant/components/sensor/modbus.py +++ b/homeassistant/components/sensor/modbus.py @@ -70,7 +70,7 @@ def setup_platform(hass, config, add_devices, discovery_info=None): structure = '>i' if register.get(CONF_DATA_TYPE) != DATA_TYPE_CUSTOM: try: - structure = '>{:c}'.format(data_types[ + structure = '>{}'.format(data_types[ register.get(CONF_DATA_TYPE)][register.get(CONF_COUNT)]) except KeyError: _LOGGER.error("Unable to detect data type for %s sensor, " @@ -165,7 +165,7 @@ class ModbusRegisterSensor(Entity): if self._reverse_order: registers.reverse() except AttributeError: - _LOGGER.error("No response from modbus slave %s register %s", + _LOGGER.error("No response from modbus slave %s, register %s", self._slave, self._register) return byte_string = b''.join( From 3a0c749a121eabf4175740c0c77d09e8b4931e50 Mon Sep 17 00:00:00 2001 From: Alok Saboo Date: Wed, 15 Nov 2017 19:15:45 -0500 Subject: [PATCH 051/246] Fix Hikvision (motion) switch bug (#10608) * Fix Hikvision switch bug * Added comment about last working version --- homeassistant/components/switch/hikvisioncam.py | 3 ++- requirements_all.txt | 2 +- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/switch/hikvisioncam.py b/homeassistant/components/switch/hikvisioncam.py index acb9af3cacb..c3e065abc0e 100644 --- a/homeassistant/components/switch/hikvisioncam.py +++ b/homeassistant/components/switch/hikvisioncam.py @@ -15,7 +15,8 @@ from homeassistant.const import ( from homeassistant.helpers.entity import ToggleEntity import homeassistant.helpers.config_validation as cv -REQUIREMENTS = ['hikvision==1.2'] +REQUIREMENTS = ['hikvision==0.4'] +# This is the last working version, please test before updating _LOGGING = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index 46f28eb5037..975e6359431 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -322,7 +322,7 @@ hbmqtt==0.8 heatmiserV3==0.9.1 # homeassistant.components.switch.hikvisioncam -hikvision==1.2 +hikvision==0.4 # homeassistant.components.notify.hipchat hipnotify==1.0.8 From d5cba0b716191ce4f40d70f7f6b7408f6bae68c7 Mon Sep 17 00:00:00 2001 From: Andrey Date: Thu, 16 Nov 2017 04:24:08 +0200 Subject: [PATCH 052/246] Allow unicode when dumping yaml (#10607) --- homeassistant/util/yaml.py | 3 ++- tests/util/test_yaml.py | 4 ++++ 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/homeassistant/util/yaml.py b/homeassistant/util/yaml.py index da97ed5662e..48d709bc549 100644 --- a/homeassistant/util/yaml.py +++ b/homeassistant/util/yaml.py @@ -78,7 +78,8 @@ def load_yaml(fname: str) -> Union[List, Dict]: def dump(_dict: dict) -> str: """Dump YAML to a string and remove null.""" - return yaml.safe_dump(_dict, default_flow_style=False) \ + return yaml.safe_dump( + _dict, default_flow_style=False, allow_unicode=True) \ .replace(': null\n', ':\n') diff --git a/tests/util/test_yaml.py b/tests/util/test_yaml.py index 50e271008a2..38b957ad102 100644 --- a/tests/util/test_yaml.py +++ b/tests/util/test_yaml.py @@ -267,6 +267,10 @@ class TestYaml(unittest.TestCase): """The that the dump method returns empty None values.""" assert yaml.dump({'a': None, 'b': 'b'}) == 'a:\nb: b\n' + def test_dump_unicode(self): + """The that the dump method returns empty None values.""" + assert yaml.dump({'a': None, 'b': 'привет'}) == 'a:\nb: привет\n' + FILES = {} From 48181a9388612fd678e47f94bce880dfd7ec9727 Mon Sep 17 00:00:00 2001 From: Michael Chang Date: Wed, 15 Nov 2017 23:44:27 -0600 Subject: [PATCH 053/246] Support script execution for Alexa (#10517) * Support script execution for Alexa * Use PowerController for the script component --- homeassistant/components/alexa/smart_home.py | 3 ++- tests/components/alexa/test_smart_home.py | 17 ++++++++++++++--- 2 files changed, 16 insertions(+), 4 deletions(-) diff --git a/homeassistant/components/alexa/smart_home.py b/homeassistant/components/alexa/smart_home.py index e65345cabca..a96386cbdf9 100644 --- a/homeassistant/components/alexa/smart_home.py +++ b/homeassistant/components/alexa/smart_home.py @@ -6,7 +6,7 @@ from uuid import uuid4 from homeassistant.const import ( ATTR_SUPPORTED_FEATURES, ATTR_ENTITY_ID, SERVICE_TURN_ON, SERVICE_TURN_OFF) -from homeassistant.components import switch, light +from homeassistant.components import switch, light, script import homeassistant.util.color as color_util from homeassistant.util.decorator import Registry @@ -21,6 +21,7 @@ API_ENDPOINT = 'endpoint' MAPPING_COMPONENT = { + script.DOMAIN: ['SWITCH', ('Alexa.PowerController',), None], switch.DOMAIN: ['SWITCH', ('Alexa.PowerController',), None], light.DOMAIN: [ 'LIGHT', ('Alexa.PowerController',), { diff --git a/tests/components/alexa/test_smart_home.py b/tests/components/alexa/test_smart_home.py index 4c79e95b324..eadb72f91c0 100644 --- a/tests/components/alexa/test_smart_home.py +++ b/tests/components/alexa/test_smart_home.py @@ -114,12 +114,15 @@ def test_discovery_request(hass): 'friendly_name': "Test light 3", 'supported_features': 19 }) + hass.states.async_set( + 'script.test', 'off', {'friendly_name': "Test script"}) + msg = yield from smart_home.async_handle_message(hass, request) assert 'event' in msg msg = msg['event'] - assert len(msg['payload']['endpoints']) == 4 + assert len(msg['payload']['endpoints']) == 5 assert msg['header']['name'] == 'Discover.Response' assert msg['header']['namespace'] == 'Alexa.Discovery' @@ -170,6 +173,14 @@ def test_discovery_request(hass): continue + if appliance['endpointId'] == 'script#test': + assert appliance['displayCategories'][0] == "SWITCH" + assert appliance['friendlyName'] == "Test script" + assert len(appliance['capabilities']) == 1 + assert appliance['capabilities'][-1]['interface'] == \ + 'Alexa.PowerController' + continue + raise AssertionError("Unknown appliance!") @@ -206,7 +217,7 @@ def test_api_function_not_implemented(hass): @asyncio.coroutine -@pytest.mark.parametrize("domain", ['light', 'switch']) +@pytest.mark.parametrize("domain", ['light', 'switch', 'script']) def test_api_turn_on(hass, domain): """Test api turn on process.""" request = get_new_request( @@ -231,7 +242,7 @@ def test_api_turn_on(hass, domain): @asyncio.coroutine -@pytest.mark.parametrize("domain", ['light', 'switch']) +@pytest.mark.parametrize("domain", ['light', 'switch', 'script']) def test_api_turn_off(hass, domain): """Test api turn on process.""" request = get_new_request( From 17cd64966dcc68274f99318ae958e57b134b755a Mon Sep 17 00:00:00 2001 From: "Craig J. Ward" Date: Thu, 16 Nov 2017 00:04:26 -0600 Subject: [PATCH 054/246] bump client version (#10610) --- homeassistant/components/alarm_control_panel/totalconnect.py | 2 +- requirements_all.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/alarm_control_panel/totalconnect.py b/homeassistant/components/alarm_control_panel/totalconnect.py index 7abdf5efcab..423628c9365 100644 --- a/homeassistant/components/alarm_control_panel/totalconnect.py +++ b/homeassistant/components/alarm_control_panel/totalconnect.py @@ -16,7 +16,7 @@ from homeassistant.const import ( STATE_ALARM_ARMED_HOME, STATE_ALARM_ARMED_NIGHT, STATE_ALARM_DISARMED, STATE_ALARM_ARMING, STATE_ALARM_DISARMING, STATE_UNKNOWN, CONF_NAME) -REQUIREMENTS = ['total_connect_client==0.12'] +REQUIREMENTS = ['total_connect_client==0.13'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index 975e6359431..29efb610897 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -1078,7 +1078,7 @@ todoist-python==7.0.17 toonlib==1.0.2 # homeassistant.components.alarm_control_panel.totalconnect -total_connect_client==0.12 +total_connect_client==0.13 # homeassistant.components.sensor.transmission # homeassistant.components.switch.transmission From b2ab4443a7ab576b6c882861211c52a60dfe7509 Mon Sep 17 00:00:00 2001 From: Fabrizio Furnari Date: Thu, 16 Nov 2017 07:07:16 +0100 Subject: [PATCH 055/246] New sensor viaggiatreno. (#10522) * New sensor viaggiatreno. I've messed up the previous PR so here it is in a new one. Should include also all corrections from @pvizeli * fixes from PR 10522 * fixed import order * requested changes from MartinHjelmare --- .coveragerc | 1 + .../components/sensor/viaggiatreno.py | 187 ++++++++++++++++++ 2 files changed, 188 insertions(+) create mode 100644 homeassistant/components/sensor/viaggiatreno.py diff --git a/.coveragerc b/.coveragerc index 4ff7fa24102..01187b92d66 100644 --- a/.coveragerc +++ b/.coveragerc @@ -583,6 +583,7 @@ omit = homeassistant/components/sensor/upnp.py homeassistant/components/sensor/ups.py homeassistant/components/sensor/vasttrafik.py + homeassistant/components/sensor/viaggiatreno.py homeassistant/components/sensor/waqi.py homeassistant/components/sensor/whois.py homeassistant/components/sensor/worldtidesinfo.py diff --git a/homeassistant/components/sensor/viaggiatreno.py b/homeassistant/components/sensor/viaggiatreno.py new file mode 100644 index 00000000000..37e7e020cc9 --- /dev/null +++ b/homeassistant/components/sensor/viaggiatreno.py @@ -0,0 +1,187 @@ +""" +Support for information about the Italian train system using ViaggiaTreno API. + +For more details about this platform please refer to the documentation at +https://home-assistant.io/components/sensor.viaggiatreno +""" +import logging + +import asyncio +import async_timeout +import aiohttp + +import voluptuous as vol + +import homeassistant.helpers.config_validation as cv +from homeassistant.components.sensor import PLATFORM_SCHEMA +from homeassistant.const import ATTR_ATTRIBUTION +from homeassistant.helpers.entity import Entity + +_LOGGER = logging.getLogger(__name__) + +CONF_ATTRIBUTION = "Powered by ViaggiaTreno Data" +VIAGGIATRENO_ENDPOINT = ("http://www.viaggiatreno.it/viaggiatrenonew/" + "resteasy/viaggiatreno/andamentoTreno/" + "{station_id}/{train_id}") + +REQUEST_TIMEOUT = 5 # seconds +ICON = 'mdi:train' +MONITORED_INFO = [ + 'categoria', + 'compOrarioArrivoZeroEffettivo', + 'compOrarioPartenzaZeroEffettivo', + 'destinazione', + 'numeroTreno', + 'orarioArrivo', + 'orarioPartenza', + 'origine', + 'subTitle', + ] + +DEFAULT_NAME = "Train {}" + +CONF_NAME = 'train_name' +CONF_STATION_ID = 'station_id' +CONF_STATION_NAME = 'station_name' +CONF_TRAIN_ID = 'train_id' + +ARRIVED_STRING = 'Arrived' +CANCELLED_STRING = 'Cancelled' +NOT_DEPARTED_STRING = "Not departed yet" +NO_INFORMATION_STRING = "No information for this train now" + +PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ + vol.Required(CONF_TRAIN_ID): cv.string, + vol.Required(CONF_STATION_ID): cv.string, + vol.Optional(CONF_NAME): cv.string, + }) + + +@asyncio.coroutine +def async_setup_platform(hass, config, + async_add_devices, discovery_info=None): + """Setup the ViaggiaTreno platform.""" + train_id = config.get(CONF_TRAIN_ID) + station_id = config.get(CONF_STATION_ID) + name = config.get(CONF_NAME) + if not name: + name = DEFAULT_NAME.format(train_id) + async_add_devices([ViaggiaTrenoSensor(train_id, station_id, name)]) + + +@asyncio.coroutine +def async_http_request(hass, uri): + """Perform actual request.""" + try: + session = hass.helpers.aiohttp_client.async_get_clientsession(hass) + with async_timeout.timeout(REQUEST_TIMEOUT, loop=hass.loop): + req = yield from session.get(uri) + if req.status != 200: + return {'error': req.status} + else: + json_response = yield from req.json() + return json_response + except (asyncio.TimeoutError, aiohttp.ClientError) as exc: + _LOGGER.error("Cannot connect to ViaggiaTreno API endpoint: %s", exc) + except ValueError: + _LOGGER.error("Received non-JSON data from ViaggiaTreno API endpoint") + + +class ViaggiaTrenoSensor(Entity): + """Implementation of a ViaggiaTreno sensor.""" + + def __init__(self, train_id, station_id, name): + """Initialize the sensor.""" + self._state = None + self._attributes = {} + self._unit = '' + self._icon = ICON + self._station_id = station_id + self._name = name + + self.uri = VIAGGIATRENO_ENDPOINT.format( + station_id=station_id, + train_id=train_id) + + @property + def name(self): + """Return the name of the sensor.""" + return self._name + + @property + def state(self): + """Return the state of the sensor.""" + return self._state + + @property + def icon(self): + """Icon to use in the frontend, if any.""" + return self._icon + + @property + def unit_of_measurement(self): + """Return the unit of measurement.""" + return self._unit + + @property + def device_state_attributes(self): + """Return extra attributes.""" + self._attributes[ATTR_ATTRIBUTION] = CONF_ATTRIBUTION + return self._attributes + + @staticmethod + def has_departed(data): + """Check if the train has actually departed.""" + try: + first_station = data['fermate'][0] + if data['oraUltimoRilevamento'] or first_station['effettiva']: + return True + except ValueError: + _LOGGER.error("Cannot fetch first station: %s", data) + return False + + @staticmethod + def has_arrived(data): + """Check if the train has already arrived.""" + last_station = data['fermate'][-1] + if not last_station['effettiva']: + return False + return True + + @staticmethod + def is_cancelled(data): + """Check if the train is cancelled.""" + if data['tipoTreno'] == 'ST' and data['provvedimento'] == 1: + return True + return False + + @asyncio.coroutine + def async_update(self): + """Update state.""" + uri = self.uri + res = yield from async_http_request(self.hass, uri) + if res.get('error', ''): + if res['error'] == 204: + self._state = NO_INFORMATION_STRING + self._unit = '' + else: + self._state = "Error: {}".format(res['error']) + self._unit = '' + else: + for i in MONITORED_INFO: + self._attributes[i] = res[i] + + if self.is_cancelled(res): + self._state = CANCELLED_STRING + self._icon = 'mdi:cancel' + self._unit = '' + elif not self.has_departed(res): + self._state = NOT_DEPARTED_STRING + self._unit = '' + elif self.has_arrived(res): + self._state = ARRIVED_STRING + self._unit = '' + else: + self._state = res.get('ritardo') + self._unit = 'min' + self._icon = ICON From 270846c2f5121562561a32fca1ac9a8b9bd3686a Mon Sep 17 00:00:00 2001 From: ziotibia81 Date: Thu, 16 Nov 2017 07:17:10 +0100 Subject: [PATCH 056/246] Modbus switch register support (#10563) * Update modbus.py * Fix blank linea and whitespaces * Fix visual indent * Fix visual indent * fix multiple statements on one line * Typo * Disable pylint check # pylint: disable=super-init-not-called * Fix code style --- homeassistant/components/switch/modbus.py | 152 ++++++++++++++++++++-- 1 file changed, 138 insertions(+), 14 deletions(-) diff --git a/homeassistant/components/switch/modbus.py b/homeassistant/components/switch/modbus.py index e6342617f28..c731b336dfb 100644 --- a/homeassistant/components/switch/modbus.py +++ b/homeassistant/components/switch/modbus.py @@ -8,7 +8,8 @@ import logging import voluptuous as vol import homeassistant.components.modbus as modbus -from homeassistant.const import CONF_NAME, CONF_SLAVE +from homeassistant.const import ( + CONF_NAME, CONF_SLAVE, CONF_COMMAND_ON, CONF_COMMAND_OFF) from homeassistant.helpers.entity import ToggleEntity from homeassistant.helpers import config_validation as cv from homeassistant.components.sensor import PLATFORM_SCHEMA @@ -18,32 +19,76 @@ DEPENDENCIES = ['modbus'] CONF_COIL = "coil" CONF_COILS = "coils" +CONF_REGISTER = "register" +CONF_REGISTERS = "registers" +CONF_VERIFY_STATE = "verify_state" +CONF_VERIFY_REGISTER = "verify_register" +CONF_REGISTER_TYPE = "register_type" +CONF_STATE_ON = "state_on" +CONF_STATE_OFF = "state_off" -PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ - vol.Required(CONF_COILS): [{ - vol.Required(CONF_COIL): cv.positive_int, - vol.Required(CONF_NAME): cv.string, - vol.Optional(CONF_SLAVE): cv.positive_int, - }] +REGISTER_TYPE_HOLDING = 'holding' +REGISTER_TYPE_INPUT = 'input' + +REGISTERS_SCHEMA = vol.Schema({ + vol.Required(CONF_NAME): cv.string, + vol.Optional(CONF_SLAVE): cv.positive_int, + vol.Required(CONF_REGISTER): cv.positive_int, + vol.Required(CONF_COMMAND_ON): cv.positive_int, + vol.Required(CONF_COMMAND_OFF): cv.positive_int, + vol.Optional(CONF_VERIFY_STATE, default=True): cv.boolean, + vol.Optional(CONF_VERIFY_REGISTER, default=None): + cv.positive_int, + vol.Optional(CONF_REGISTER_TYPE, default=REGISTER_TYPE_HOLDING): + vol.In([REGISTER_TYPE_HOLDING, REGISTER_TYPE_INPUT]), + vol.Optional(CONF_STATE_ON, default=None): cv.positive_int, + vol.Optional(CONF_STATE_OFF, default=None): cv.positive_int, }) +COILS_SCHEMA = vol.Schema({ + vol.Required(CONF_COIL): cv.positive_int, + vol.Required(CONF_NAME): cv.string, + vol.Required(CONF_SLAVE): cv.positive_int, +}) + +PLATFORM_SCHEMA = vol.All( + cv.has_at_least_one_key(CONF_COILS, CONF_REGISTERS), + PLATFORM_SCHEMA.extend({ + vol.Optional(CONF_COILS): [COILS_SCHEMA], + vol.Optional(CONF_REGISTERS): [REGISTERS_SCHEMA] + })) + def setup_platform(hass, config, add_devices, discovery_info=None): """Read configuration and create Modbus devices.""" switches = [] - for coil in config.get("coils"): - switches.append(ModbusCoilSwitch( - coil.get(CONF_NAME), - coil.get(CONF_SLAVE), - coil.get(CONF_COIL))) + if CONF_COILS in config: + for coil in config.get(CONF_COILS): + switches.append(ModbusCoilSwitch( + coil.get(CONF_NAME), + coil.get(CONF_SLAVE), + coil.get(CONF_COIL))) + if CONF_REGISTERS in config: + for register in config.get(CONF_REGISTERS): + switches.append(ModbusRegisterSwitch( + register.get(CONF_NAME), + register.get(CONF_SLAVE), + register.get(CONF_REGISTER), + register.get(CONF_COMMAND_ON), + register.get(CONF_COMMAND_OFF), + register.get(CONF_VERIFY_STATE), + register.get(CONF_VERIFY_REGISTER), + register.get(CONF_REGISTER_TYPE), + register.get(CONF_STATE_ON), + register.get(CONF_STATE_OFF))) add_devices(switches) class ModbusCoilSwitch(ToggleEntity): - """Representation of a Modbus switch.""" + """Representation of a Modbus coil switch.""" def __init__(self, name, slave, coil): - """Initialize the switch.""" + """Initialize the coil switch.""" self._name = name self._slave = int(slave) if slave else None self._coil = int(coil) @@ -77,3 +122,82 @@ class ModbusCoilSwitch(ToggleEntity): 'No response from modbus slave %s coil %s', self._slave, self._coil) + + +class ModbusRegisterSwitch(ModbusCoilSwitch): + """Representation of a Modbus register switch.""" + + # pylint: disable=super-init-not-called + def __init__(self, name, slave, register, command_on, + command_off, verify_state, verify_register, + register_type, state_on, state_off): + """Initialize the register switch.""" + self._name = name + self._slave = slave + self._register = register + self._command_on = command_on + self._command_off = command_off + self._verify_state = verify_state + self._verify_register = ( + verify_register if verify_register else self._register) + self._register_type = register_type + self._state_on = ( + state_on if state_on else self._command_on) + self._state_off = ( + state_off if state_off else self._command_off) + self._is_on = None + + def turn_on(self, **kwargs): + """Set switch on.""" + modbus.HUB.write_register( + self._slave, + self._register, + self._command_on) + if not self._verify_state: + self._is_on = True + + def turn_off(self, **kwargs): + """Set switch off.""" + modbus.HUB.write_register( + self._slave, + self._register, + self._command_off) + if not self._verify_state: + self._is_on = False + + def update(self): + """Update the state of the switch.""" + if not self._verify_state: + return + + value = 0 + if self._register_type == REGISTER_TYPE_INPUT: + result = modbus.HUB.read_input_registers( + self._slave, + self._register, + 1) + else: + result = modbus.HUB.read_holding_registers( + self._slave, + self._register, + 1) + + try: + value = int(result.registers[0]) + except AttributeError: + _LOGGER.error( + 'No response from modbus slave %s register %s', + self._slave, + self._verify_register) + + if value == self._state_on: + self._is_on = True + elif value == self._state_off: + self._is_on = False + else: + _LOGGER.error( + 'Unexpected response from modbus slave %s ' + 'register %s, got 0x%2x', + self._slave, + self._verify_register, + value) From e20fd3b973e2e593649e0e4cfec175531be9fb7d Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Thu, 16 Nov 2017 07:35:18 +0100 Subject: [PATCH 057/246] Upgrade mypy to 0.550 (#10591) --- requirements_test.txt | 2 +- requirements_test_all.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/requirements_test.txt b/requirements_test.txt index 1aa909bc9bb..3edfa168f79 100644 --- a/requirements_test.txt +++ b/requirements_test.txt @@ -3,7 +3,7 @@ # new version flake8==3.3 pylint==1.6.5 -mypy==0.540 +mypy==0.550 pydocstyle==1.1.1 coveralls>=1.1 pytest>=2.9.2 diff --git a/requirements_test_all.txt b/requirements_test_all.txt index ea2700f7c9b..18ea3192a98 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -4,7 +4,7 @@ # new version flake8==3.3 pylint==1.6.5 -mypy==0.540 +mypy==0.550 pydocstyle==1.1.1 coveralls>=1.1 pytest>=2.9.2 From f494c32866c7e6601995c915399ac4a152b7de58 Mon Sep 17 00:00:00 2001 From: boltgolt Date: Thu, 16 Nov 2017 07:41:39 +0100 Subject: [PATCH 058/246] Small fix to be able to use mac and vendor in "device_tracker_new_device" event. (#10537) * Small fix to be able to use mac and vendor in EVENT_NEW_DEVICE event * Missed device_tracker test --- homeassistant/components/device_tracker/__init__.py | 13 ++++++++----- tests/components/device_tracker/test_init.py | 2 ++ 2 files changed, 10 insertions(+), 5 deletions(-) diff --git a/homeassistant/components/device_tracker/__init__.py b/homeassistant/components/device_tracker/__init__.py index 05131a039cd..0b18cc72f6e 100644 --- a/homeassistant/components/device_tracker/__init__.py +++ b/homeassistant/components/device_tracker/__init__.py @@ -76,6 +76,7 @@ ATTR_LOCATION_NAME = 'location_name' ATTR_MAC = 'mac' ATTR_NAME = 'name' ATTR_SOURCE_TYPE = 'source_type' +ATTR_VENDOR = 'vendor' SOURCE_TYPE_GPS = 'gps' SOURCE_TYPE_ROUTER = 'router' @@ -285,11 +286,6 @@ class DeviceTracker(object): if device.track: yield from device.async_update_ha_state() - self.hass.bus.async_fire(EVENT_NEW_DEVICE, { - ATTR_ENTITY_ID: device.entity_id, - ATTR_HOST_NAME: device.host_name, - }) - # During init, we ignore the group if self.group and self.track_new: self.group.async_set_group( @@ -299,6 +295,13 @@ class DeviceTracker(object): # lookup mac vendor string to be stored in config yield from device.set_vendor_for_mac() + self.hass.bus.async_fire(EVENT_NEW_DEVICE, { + ATTR_ENTITY_ID: device.entity_id, + ATTR_HOST_NAME: device.host_name, + ATTR_MAC: device.mac, + ATTR_VENDOR: device.vendor, + }) + # update known_devices.yaml self.hass.async_add_job( self.async_update_config( diff --git a/tests/components/device_tracker/test_init.py b/tests/components/device_tracker/test_init.py index a8531e2aa69..704b2590f12 100644 --- a/tests/components/device_tracker/test_init.py +++ b/tests/components/device_tracker/test_init.py @@ -481,6 +481,8 @@ class TestComponentsDeviceTracker(unittest.TestCase): assert test_events[0].data == { 'entity_id': 'device_tracker.hello', 'host_name': 'hello', + 'mac': 'MAC_1', + 'vendor': 'unknown', } # pylint: disable=invalid-name From d4bd4c114b0430f50281df06ef46d007bb773a61 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Per=20Osb=C3=A4ck?= Date: Thu, 16 Nov 2017 08:00:43 +0100 Subject: [PATCH 059/246] add support for color temperature and color to Google Assistant (#10039) * add support for color temperature and color; also add some extra deviceInfo attributes * change so that default behaviour doesn't turn off device if the action isn't handled * add tests * fix lint * more lint * use attributes were applicable * removed debug logging * fix unassigned if only None returned * report more data in QUERY * better tests for color and temperature * fixes after dev merge * remove deviceInfo as not part of a device state (PR #10399) * fix after merge --- .../components/google_assistant/http.py | 1 + .../components/google_assistant/smart_home.py | 73 +++++++++++++++++-- .../google_assistant/test_google_assistant.py | 36 ++++++++- .../google_assistant/test_smart_home.py | 51 +++++++++++++ 4 files changed, 154 insertions(+), 7 deletions(-) diff --git a/homeassistant/components/google_assistant/http.py b/homeassistant/components/google_assistant/http.py index 71a4ff9ce3a..ab9705432fb 100644 --- a/homeassistant/components/google_assistant/http.py +++ b/homeassistant/components/google_assistant/http.py @@ -128,6 +128,7 @@ class GoogleAssistantView(HomeAssistantView): ent_ids = [ent.get('id') for ent in command.get('devices', [])] execution = command.get('execution')[0] for eid in ent_ids: + success = False domain = eid.split('.')[0] (service, service_data) = determine_service( eid, execution.get('command'), execution.get('params'), diff --git a/homeassistant/components/google_assistant/smart_home.py b/homeassistant/components/google_assistant/smart_home.py index 42cb555fe3c..cd1583fb377 100644 --- a/homeassistant/components/google_assistant/smart_home.py +++ b/homeassistant/components/google_assistant/smart_home.py @@ -8,6 +8,7 @@ from aiohttp.web import Request, Response # NOQA from typing import Dict, Tuple, Any, Optional # NOQA from homeassistant.helpers.entity import Entity # NOQA from homeassistant.core import HomeAssistant # NOQA +from homeassistant.util import color from homeassistant.util.unit_system import UnitSystem # NOQA from homeassistant.const import ( @@ -22,7 +23,8 @@ from homeassistant.components import ( from homeassistant.util.unit_system import METRIC_SYSTEM from .const import ( - ATTR_GOOGLE_ASSISTANT_NAME, ATTR_GOOGLE_ASSISTANT_TYPE, + ATTR_GOOGLE_ASSISTANT_NAME, COMMAND_COLOR, + ATTR_GOOGLE_ASSISTANT_TYPE, COMMAND_BRIGHTNESS, COMMAND_ONOFF, COMMAND_ACTIVATESCENE, COMMAND_THERMOSTAT_TEMPERATURE_SETPOINT, COMMAND_THERMOSTAT_TEMPERATURE_SET_RANGE, COMMAND_THERMOSTAT_SET_MODE, @@ -78,6 +80,7 @@ def entity_to_device(entity: Entity, units: UnitSystem): device = { 'id': entity.entity_id, 'name': {}, + 'attributes': {}, 'traits': [], 'willReportState': False, } @@ -102,6 +105,23 @@ def entity_to_device(entity: Entity, units: UnitSystem): for feature, trait in class_data[2].items(): if feature & supported > 0: device['traits'].append(trait) + + # Actions require this attributes for a device + # supporting temperature + # For IKEA trådfri, these attributes only seem to + # be set only if the device is on? + if trait == TRAIT_COLOR_TEMP: + if entity.attributes.get( + light.ATTR_MAX_MIREDS) is not None: + device['attributes']['temperatureMinK'] = \ + int(round(color.color_temperature_mired_to_kelvin( + entity.attributes.get(light.ATTR_MAX_MIREDS)))) + if entity.attributes.get( + light.ATTR_MIN_MIREDS) is not None: + device['attributes']['temperatureMaxK'] = \ + int(round(color.color_temperature_mired_to_kelvin( + entity.attributes.get(light.ATTR_MIN_MIREDS)))) + if entity.domain == climate.DOMAIN: modes = ','.join( m for m in entity.attributes.get(climate.ATTR_OPERATION_LIST, []) @@ -156,12 +176,35 @@ def query_device(entity: Entity, units: UnitSystem) -> dict: final_brightness = 100 * (final_brightness / 255) - return { + query_response = { "on": final_state, "online": True, "brightness": int(final_brightness) } + supported_features = entity.attributes.get(ATTR_SUPPORTED_FEATURES, 0) + if supported_features & \ + (light.SUPPORT_COLOR_TEMP | light.SUPPORT_RGB_COLOR): + query_response["color"] = {} + + if entity.attributes.get(light.ATTR_COLOR_TEMP) is not None: + query_response["color"]["temperature"] = \ + int(round(color.color_temperature_mired_to_kelvin( + entity.attributes.get(light.ATTR_COLOR_TEMP)))) + + if entity.attributes.get(light.ATTR_COLOR_NAME) is not None: + query_response["color"]["name"] = \ + entity.attributes.get(light.ATTR_COLOR_NAME) + + if entity.attributes.get(light.ATTR_RGB_COLOR) is not None: + color_rgb = entity.attributes.get(light.ATTR_RGB_COLOR) + if color_rgb is not None: + query_response["color"]["spectrumRGB"] = \ + int(color.color_rgb_to_hex( + color_rgb[0], color_rgb[1], color_rgb[2]), 16) + + return query_response + # erroneous bug on old pythons and pylint # https://github.com/PyCQA/pylint/issues/1212 @@ -217,7 +260,27 @@ def determine_service( service_data['brightness'] = int(brightness / 100 * 255) return (SERVICE_TURN_ON, service_data) - if command == COMMAND_ACTIVATESCENE or (COMMAND_ONOFF == command and - params.get('on') is True): + _LOGGER.debug("Handling command %s with data %s", command, params) + if command == COMMAND_COLOR: + color_data = params.get('color') + if color_data is not None: + if color_data.get('temperature', 0) > 0: + service_data[light.ATTR_KELVIN] = color_data.get('temperature') + return (SERVICE_TURN_ON, service_data) + if color_data.get('spectrumRGB', 0) > 0: + # blue is 255 so pad up to 6 chars + hex_value = \ + ('%0x' % int(color_data.get('spectrumRGB'))).zfill(6) + service_data[light.ATTR_RGB_COLOR] = \ + color.rgb_hex_to_rgb_list(hex_value) + return (SERVICE_TURN_ON, service_data) + + if command == COMMAND_ACTIVATESCENE: return (SERVICE_TURN_ON, service_data) - return (SERVICE_TURN_OFF, service_data) + + if COMMAND_ONOFF == command: + if params.get('on') is True: + return (SERVICE_TURN_ON, service_data) + return (SERVICE_TURN_OFF, service_data) + + return (None, service_data) diff --git a/tests/components/google_assistant/test_google_assistant.py b/tests/components/google_assistant/test_google_assistant.py index c21c63b0d52..dba10608991 100644 --- a/tests/components/google_assistant/test_google_assistant.py +++ b/tests/components/google_assistant/test_google_assistant.py @@ -181,6 +181,8 @@ def test_query_request(hass_fixture, assistant_client): 'id': "light.ceiling_lights", }, { 'id': "light.bed_light", + }, { + 'id': "light.kitchen_lights", }] } }] @@ -193,10 +195,12 @@ def test_query_request(hass_fixture, assistant_client): body = yield from result.json() assert body.get('requestId') == reqid devices = body['payload']['devices'] - assert len(devices) == 2 + assert len(devices) == 3 assert devices['light.bed_light']['on'] is False assert devices['light.ceiling_lights']['on'] is True assert devices['light.ceiling_lights']['brightness'] == 70 + assert devices['light.kitchen_lights']['color']['spectrumRGB'] == 16727919 + assert devices['light.kitchen_lights']['color']['temperature'] == 4166 @asyncio.coroutine @@ -321,6 +325,31 @@ def test_execute_request(hass_fixture, assistant_client): "on": False } }] + }, { + "devices": [{ + "id": "light.kitchen_lights", + }], + "execution": [{ + "command": "action.devices.commands.ColorAbsolute", + "params": { + "color": { + "spectrumRGB": 16711680, + "temperature": 2100 + } + } + }] + }, { + "devices": [{ + "id": "light.kitchen_lights", + }], + "execution": [{ + "command": "action.devices.commands.ColorAbsolute", + "params": { + "color": { + "spectrumRGB": 16711680 + } + } + }] }] } }] @@ -333,7 +362,10 @@ def test_execute_request(hass_fixture, assistant_client): body = yield from result.json() assert body.get('requestId') == reqid commands = body['payload']['commands'] - assert len(commands) == 3 + assert len(commands) == 5 ceiling = hass_fixture.states.get('light.ceiling_lights') assert ceiling.state == 'off' + kitchen = hass_fixture.states.get('light.kitchen_lights') + assert kitchen.attributes.get(light.ATTR_COLOR_TEMP) == 476 + assert kitchen.attributes.get(light.ATTR_RGB_COLOR) == (255, 0, 0) assert hass_fixture.states.get('switch.decorative_lights').state == 'off' diff --git a/tests/components/google_assistant/test_smart_home.py b/tests/components/google_assistant/test_smart_home.py index 6712b390dbb..2668c0cecfc 100644 --- a/tests/components/google_assistant/test_smart_home.py +++ b/tests/components/google_assistant/test_smart_home.py @@ -17,6 +17,57 @@ DETERMINE_SERVICE_TESTS = [{ # Test light brightness const.SERVICE_TURN_ON, {'entity_id': 'light.test', 'brightness': 242} ) +}, { # Test light color temperature + 'entity_id': 'light.test', + 'command': ga.const.COMMAND_COLOR, + 'params': { + 'color': { + 'temperature': 2300, + 'name': 'warm white' + } + }, + 'expected': ( + const.SERVICE_TURN_ON, + {'entity_id': 'light.test', 'kelvin': 2300} + ) +}, { # Test light color blue + 'entity_id': 'light.test', + 'command': ga.const.COMMAND_COLOR, + 'params': { + 'color': { + 'spectrumRGB': 255, + 'name': 'blue' + } + }, + 'expected': ( + const.SERVICE_TURN_ON, + {'entity_id': 'light.test', 'rgb_color': [0, 0, 255]} + ) +}, { # Test light color yellow + 'entity_id': 'light.test', + 'command': ga.const.COMMAND_COLOR, + 'params': { + 'color': { + 'spectrumRGB': 16776960, + 'name': 'yellow' + } + }, + 'expected': ( + const.SERVICE_TURN_ON, + {'entity_id': 'light.test', 'rgb_color': [255, 255, 0]} + ) +}, { # Test unhandled action/service + 'entity_id': 'light.test', + 'command': ga.const.COMMAND_COLOR, + 'params': { + 'color': { + 'unhandled': 2300 + } + }, + 'expected': ( + None, + {'entity_id': 'light.test'} + ) }, { # Test switch to light custom type 'entity_id': 'switch.decorative_lights', 'command': ga.const.COMMAND_ONOFF, From 1719fa70080521b3364550822edddb1e585c8380 Mon Sep 17 00:00:00 2001 From: Pascal Vizeli Date: Thu, 16 Nov 2017 08:03:41 +0100 Subject: [PATCH 060/246] Cleanup old stale restore feature (#10593) * Cleanup old stale restore feature * cleanup * Update __init__.py * Update test_demo.py * Lint --- homeassistant/components/light/__init__.py | 15 -------- homeassistant/components/light/demo.py | 24 ------------- tests/components/light/test_demo.py | 40 ++-------------------- 3 files changed, 2 insertions(+), 77 deletions(-) diff --git a/homeassistant/components/light/__init__.py b/homeassistant/components/light/__init__.py index d69d6991ff0..e4fb4542205 100644 --- a/homeassistant/components/light/__init__.py +++ b/homeassistant/components/light/__init__.py @@ -23,7 +23,6 @@ from homeassistant.helpers.entity import ToggleEntity from homeassistant.helpers.entity_component import EntityComponent from homeassistant.helpers.config_validation import PLATFORM_SCHEMA # noqa import homeassistant.helpers.config_validation as cv -from homeassistant.helpers.restore_state import async_restore_state import homeassistant.util.color as color_util DOMAIN = "light" @@ -140,14 +139,6 @@ PROFILE_SCHEMA = vol.Schema( _LOGGER = logging.getLogger(__name__) -def extract_info(state): - """Extract light parameters from a state object.""" - params = {key: state.attributes[key] for key in PROP_TO_ATTR - if key in state.attributes} - params['is_on'] = state.state == STATE_ON - return params - - @bind_hass def is_on(hass, entity_id=None): """Return if the lights are on based on the statemachine.""" @@ -431,9 +422,3 @@ class Light(ToggleEntity): def supported_features(self): """Flag supported features.""" return 0 - - @asyncio.coroutine - def async_added_to_hass(self): - """Component added, restore_state using platforms.""" - if hasattr(self, 'async_restore_state'): - yield from async_restore_state(self, extract_info) diff --git a/homeassistant/components/light/demo.py b/homeassistant/components/light/demo.py index 22ab404a3b2..d01611716eb 100644 --- a/homeassistant/components/light/demo.py +++ b/homeassistant/components/light/demo.py @@ -4,7 +4,6 @@ Demo light platform that implements lights. For more details about this platform, please refer to the documentation https://home-assistant.io/components/demo/ """ -import asyncio import random from homeassistant.components.light import ( @@ -150,26 +149,3 @@ class DemoLight(Light): # As we have disabled polling, we need to inform # Home Assistant about updates in our state ourselves. self.schedule_update_ha_state() - - @asyncio.coroutine - def async_restore_state(self, is_on, **kwargs): - """Restore the demo state.""" - self._state = is_on - - if 'brightness' in kwargs: - self._brightness = kwargs['brightness'] - - if 'color_temp' in kwargs: - self._ct = kwargs['color_temp'] - - if 'rgb_color' in kwargs: - self._rgb = kwargs['rgb_color'] - - if 'xy_color' in kwargs: - self._xy_color = kwargs['xy_color'] - - if 'white_value' in kwargs: - self._white = kwargs['white_value'] - - if 'effect' in kwargs: - self._effect = kwargs['effect'] diff --git a/tests/components/light/test_demo.py b/tests/components/light/test_demo.py index b4576b174d6..8a7d648e6f2 100644 --- a/tests/components/light/test_demo.py +++ b/tests/components/light/test_demo.py @@ -1,14 +1,11 @@ """The tests for the demo light component.""" # pylint: disable=protected-access -import asyncio import unittest -from homeassistant.core import State, CoreState -from homeassistant.setup import setup_component, async_setup_component +from homeassistant.setup import setup_component import homeassistant.components.light as light -from homeassistant.helpers.restore_state import DATA_RESTORE_CACHE -from tests.common import get_test_home_assistant, mock_component +from tests.common import get_test_home_assistant ENTITY_LIGHT = 'light.bed_light' @@ -79,36 +76,3 @@ class TestDemoLight(unittest.TestCase): light.turn_off(self.hass) self.hass.block_till_done() self.assertFalse(light.is_on(self.hass, ENTITY_LIGHT)) - - -@asyncio.coroutine -def test_restore_state(hass): - """Test state gets restored.""" - mock_component(hass, 'recorder') - hass.state = CoreState.starting - hass.data[DATA_RESTORE_CACHE] = { - 'light.bed_light': State('light.bed_light', 'on', { - 'brightness': 'value-brightness', - 'color_temp': 'value-color_temp', - 'rgb_color': 'value-rgb_color', - 'xy_color': 'value-xy_color', - 'white_value': 'value-white_value', - 'effect': 'value-effect', - }), - } - - yield from async_setup_component(hass, 'light', { - 'light': { - 'platform': 'demo', - }}) - - state = hass.states.get('light.bed_light') - assert state is not None - assert state.entity_id == 'light.bed_light' - assert state.state == 'on' - assert state.attributes.get('brightness') == 'value-brightness' - assert state.attributes.get('color_temp') == 'value-color_temp' - assert state.attributes.get('rgb_color') == 'value-rgb_color' - assert state.attributes.get('xy_color') == 'value-xy_color' - assert state.attributes.get('white_value') == 'value-white_value' - assert state.attributes.get('effect') == 'value-effect' From 3dbae5ca5b22b2c0ed22cd1a46e64eb9486cc810 Mon Sep 17 00:00:00 2001 From: Colin Dunn Date: Thu, 16 Nov 2017 18:16:22 +1100 Subject: [PATCH 061/246] Correct input_datetime initial value parsing (#10417) * Correct input_datetime initial value parsing * Correct input_datetime initial value parsing --- homeassistant/components/input_datetime.py | 10 +++++----- tests/components/test_input_datetime.py | 8 ++++---- 2 files changed, 9 insertions(+), 9 deletions(-) diff --git a/homeassistant/components/input_datetime.py b/homeassistant/components/input_datetime.py index 9dd09f2c245..fecc31f14ae 100644 --- a/homeassistant/components/input_datetime.py +++ b/homeassistant/components/input_datetime.py @@ -46,7 +46,7 @@ CONFIG_SCHEMA = vol.Schema({ vol.Required(CONF_HAS_DATE): cv.boolean, vol.Required(CONF_HAS_TIME): cv.boolean, vol.Optional(CONF_ICON): cv.icon, - vol.Optional(CONF_INITIAL): cv.datetime, + vol.Optional(CONF_INITIAL): cv.string, }, cv.has_at_least_one_key_value((CONF_HAS_DATE, True), (CONF_HAS_TIME, True)))}) }, extra=vol.ALLOW_EXTRA) @@ -137,15 +137,15 @@ class InputDatetime(Entity): old_state = yield from async_get_last_state(self.hass, self.entity_id) if old_state is not None: - restore_val = dt_util.parse_datetime(old_state.state) + restore_val = old_state.state if restore_val is not None: if not self._has_date: - self._current_datetime = restore_val.time() + self._current_datetime = dt_util.parse_time(restore_val) elif not self._has_time: - self._current_datetime = restore_val.date() + self._current_datetime = dt_util.parse_date(restore_val) else: - self._current_datetime = restore_val + self._current_datetime = dt_util.parse_datetime(restore_val) def has_date(self): """Return whether the input datetime carries a date.""" diff --git a/tests/components/test_input_datetime.py b/tests/components/test_input_datetime.py index af664f36a53..5d3f1782831 100644 --- a/tests/components/test_input_datetime.py +++ b/tests/components/test_input_datetime.py @@ -102,7 +102,7 @@ def test_set_datetime_time(hass): @asyncio.coroutine def test_set_invalid(hass): """Test set_datetime method with only time.""" - initial = datetime.datetime(2017, 1, 1, 0, 0) + initial = '2017-01-01' yield from async_setup_component(hass, DOMAIN, { DOMAIN: { 'test_date': { @@ -124,7 +124,7 @@ def test_set_invalid(hass): yield from hass.async_block_till_done() state = hass.states.get(entity_id) - assert state.state == str(initial.date()) + assert state.state == initial @asyncio.coroutine @@ -159,8 +159,8 @@ def test_set_datetime_date(hass): def test_restore_state(hass): """Ensure states are restored on startup.""" mock_restore_cache(hass, ( - State('input_datetime.test_time', '2017-09-07 19:46:00'), - State('input_datetime.test_date', '2017-09-07 19:46:00'), + State('input_datetime.test_time', '19:46:00'), + State('input_datetime.test_date', '2017-09-07'), State('input_datetime.test_datetime', '2017-09-07 19:46:00'), State('input_datetime.test_bogus_data', 'this is not a date'), )) From 79ca93f892fd3ca2370d9c26ce50b6c92213a245 Mon Sep 17 00:00:00 2001 From: Milan V Date: Thu, 16 Nov 2017 13:11:46 +0100 Subject: [PATCH 062/246] Change generic thermostat to control heating on mode change Off -> Auto (#10601) * Change generic thermostat to control heating on mode change Off -> Auto * Fix typo --- .../components/climate/generic_thermostat.py | 1 + .../climate/test_generic_thermostat.py | 44 +++++++++++++++---- 2 files changed, 37 insertions(+), 8 deletions(-) diff --git a/homeassistant/components/climate/generic_thermostat.py b/homeassistant/components/climate/generic_thermostat.py index 191960d2848..0c0c837b850 100644 --- a/homeassistant/components/climate/generic_thermostat.py +++ b/homeassistant/components/climate/generic_thermostat.py @@ -163,6 +163,7 @@ class GenericThermostat(ClimateDevice): """Set operation mode.""" if operation_mode == STATE_AUTO: self._enabled = True + self._async_control_heating() elif operation_mode == STATE_OFF: self._enabled = False if self._is_device_active: diff --git a/tests/components/climate/test_generic_thermostat.py b/tests/components/climate/test_generic_thermostat.py index 74b2186b8d7..bb42ef177f0 100644 --- a/tests/components/climate/test_generic_thermostat.py +++ b/tests/components/climate/test_generic_thermostat.py @@ -1,9 +1,9 @@ """The tests for the generic_thermostat.""" import asyncio import datetime -import pytz import unittest from unittest import mock +import pytz import homeassistant.core as ha from homeassistant.core import callback @@ -54,13 +54,16 @@ class TestSetupClimateGenericThermostat(unittest.TestCase): 'climate': config}) def test_valid_conf(self): - """Test set up genreic_thermostat with valid config values.""" - self.assertTrue(setup_component(self.hass, 'climate', - {'climate': { - 'platform': 'generic_thermostat', - 'name': 'test', - 'heater': ENT_SWITCH, - 'target_sensor': ENT_SENSOR}})) + """Test set up generic_thermostat with valid config values.""" + self.assertTrue( + setup_component(self.hass, 'climate', + {'climate': { + 'platform': 'generic_thermostat', + 'name': 'test', + 'heater': ENT_SWITCH, + 'target_sensor': ENT_SENSOR + }}) + ) def test_setup_with_sensor(self): """Test set up heat_control with sensor to trigger update at init.""" @@ -243,6 +246,31 @@ class TestClimateGenericThermostat(unittest.TestCase): self.hass.block_till_done() self.assertEqual(0, len(self.calls)) + @mock.patch('logging.Logger.error') + def test_invalid_operating_mode(self, log_mock): + """Test error handling for invalid operation mode.""" + climate.set_operation_mode(self.hass, 'invalid mode') + self.hass.block_till_done() + self.assertEqual(log_mock.call_count, 1) + + def test_operating_mode_auto(self): + """Test change mode from OFF to AUTO. + + Switch turns on when temp below setpoint and mode changes. + """ + climate.set_operation_mode(self.hass, STATE_OFF) + climate.set_temperature(self.hass, 30) + self._setup_sensor(25) + self.hass.block_till_done() + self._setup_switch(False) + climate.set_operation_mode(self.hass, climate.STATE_AUTO) + self.hass.block_till_done() + self.assertEqual(1, len(self.calls)) + call = self.calls[0] + self.assertEqual('switch', call.domain) + self.assertEqual(SERVICE_TURN_ON, call.service) + self.assertEqual(ENT_SWITCH, call.data['entity_id']) + def _setup_sensor(self, temp, unit=TEMP_CELSIUS): """Setup the test sensor.""" self.hass.states.set(ENT_SENSOR, temp, { From eb7643e163a04e5479c1592603bae601613c37a9 Mon Sep 17 00:00:00 2001 From: Milan V Date: Thu, 16 Nov 2017 16:26:23 +0100 Subject: [PATCH 063/246] Improve WUnderground config validation (#10573) * Fix WUnderground config validation * Fix indentation --- homeassistant/components/sensor/wunderground.py | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/homeassistant/components/sensor/wunderground.py b/homeassistant/components/sensor/wunderground.py index 2fcb13e13dd..c0763c4fefa 100644 --- a/homeassistant/components/sensor/wunderground.py +++ b/homeassistant/components/sensor/wunderground.py @@ -616,14 +616,13 @@ LANG_CODES = [ PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Required(CONF_API_KEY): cv.string, vol.Optional(CONF_PWS_ID): cv.string, - vol.Optional(CONF_LANG, default=DEFAULT_LANG): - vol.All(vol.In(LANG_CODES)), + vol.Optional(CONF_LANG, default=DEFAULT_LANG): vol.All(vol.In(LANG_CODES)), vol.Inclusive(CONF_LATITUDE, 'coordinates', 'Latitude and longitude must exist together'): cv.latitude, vol.Inclusive(CONF_LONGITUDE, 'coordinates', 'Latitude and longitude must exist together'): cv.longitude, - vol.Required(CONF_MONITORED_CONDITIONS, default=[]): - vol.All(cv.ensure_list, [vol.In(SENSOR_TYPES)]), + vol.Required(CONF_MONITORED_CONDITIONS): + vol.All(cv.ensure_list, vol.Length(min=1), [vol.In(SENSOR_TYPES)]), }) From bd5a16d70b3eb432af5bc46cdbb9c9d8bb07ea14 Mon Sep 17 00:00:00 2001 From: Mitko Masarliev Date: Thu, 16 Nov 2017 17:47:37 +0200 Subject: [PATCH 064/246] update hbmqtt to 0.9.1 (#10611) --- homeassistant/components/mqtt/server.py | 2 +- requirements_all.txt | 2 +- requirements_test_all.txt | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/mqtt/server.py b/homeassistant/components/mqtt/server.py index 0e866723b34..db251ab4180 100644 --- a/homeassistant/components/mqtt/server.py +++ b/homeassistant/components/mqtt/server.py @@ -13,7 +13,7 @@ import voluptuous as vol from homeassistant.const import EVENT_HOMEASSISTANT_STOP import homeassistant.helpers.config_validation as cv -REQUIREMENTS = ['hbmqtt==0.8'] +REQUIREMENTS = ['hbmqtt==0.9.1'] DEPENDENCIES = ['http'] # None allows custom config to be created through generate_config diff --git a/requirements_all.txt b/requirements_all.txt index 29efb610897..d22090708fe 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -316,7 +316,7 @@ ha-philipsjs==0.0.1 haversine==0.4.5 # homeassistant.components.mqtt.server -hbmqtt==0.8 +hbmqtt==0.9.1 # homeassistant.components.climate.heatmiser heatmiserV3==0.9.1 diff --git a/requirements_test_all.txt b/requirements_test_all.txt index 18ea3192a98..201da6be2b3 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -68,7 +68,7 @@ ha-ffmpeg==1.9 haversine==0.4.5 # homeassistant.components.mqtt.server -hbmqtt==0.8 +hbmqtt==0.9.1 # homeassistant.components.binary_sensor.workday holidays==0.8.1 From 072ed7ea13c37d1bfb180acbe943c878590bacdb Mon Sep 17 00:00:00 2001 From: Andrey Date: Thu, 16 Nov 2017 19:10:25 +0200 Subject: [PATCH 065/246] Allow to pass YandexTTS options via sevice call (#10578) --- homeassistant/components/tts/__init__.py | 5 +-- homeassistant/components/tts/yandextts.py | 21 ++++++++++--- tests/components/tts/test_yandextts.py | 37 +++++++++++++++++++++++ 3 files changed, 57 insertions(+), 6 deletions(-) diff --git a/homeassistant/components/tts/__init__.py b/homeassistant/components/tts/__init__.py index 9f36b2fb78f..59090b98e94 100644 --- a/homeassistant/components/tts/__init__.py +++ b/homeassistant/components/tts/__init__.py @@ -286,10 +286,11 @@ class SpeechManager(object): options = options or provider.default_options if options is not None: invalid_opts = [opt_name for opt_name in options.keys() - if opt_name not in provider.supported_options] + if opt_name not in (provider.supported_options or + [])] if invalid_opts: raise HomeAssistantError( - "Invalid options found: %s", invalid_opts) + "Invalid options found: {}".format(invalid_opts)) options_key = ctypes.c_size_t(hash(frozenset(options))).value else: options_key = '-' diff --git a/homeassistant/components/tts/yandextts.py b/homeassistant/components/tts/yandextts.py index 05daad55412..b5e965a5b50 100644 --- a/homeassistant/components/tts/yandextts.py +++ b/homeassistant/components/tts/yandextts.py @@ -63,6 +63,13 @@ PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Range(min=MIN_SPEED, max=MAX_SPEED) }) +SUPPORTED_OPTIONS = [ + CONF_CODEC, + CONF_VOICE, + CONF_EMOTION, + CONF_SPEED, +] + @asyncio.coroutine def async_get_engine(hass, config): @@ -94,11 +101,17 @@ class YandexSpeechKitProvider(Provider): """Return list of supported languages.""" return SUPPORT_LANGUAGES + @property + def supported_options(self): + """Return list of supported options.""" + return SUPPORTED_OPTIONS + @asyncio.coroutine def async_get_tts_audio(self, message, language, options=None): """Load TTS from yandex.""" websession = async_get_clientsession(self.hass) actual_language = language + options = options or {} try: with async_timeout.timeout(10, loop=self.hass.loop): @@ -106,10 +119,10 @@ class YandexSpeechKitProvider(Provider): 'text': message, 'lang': actual_language, 'key': self._key, - 'speaker': self._speaker, - 'format': self._codec, - 'emotion': self._emotion, - 'speed': self._speed + 'speaker': options.get(CONF_VOICE, self._speaker), + 'format': options.get(CONF_CODEC, self._codec), + 'emotion': options.get(CONF_EMOTION, self._emotion), + 'speed': options.get(CONF_SPEED, self._speed) } request = yield from websession.get( diff --git a/tests/components/tts/test_yandextts.py b/tests/components/tts/test_yandextts.py index 1ed92f34ebe..e08229631cf 100644 --- a/tests/components/tts/test_yandextts.py +++ b/tests/components/tts/test_yandextts.py @@ -363,3 +363,40 @@ class TestTTSYandexPlatform(object): assert len(aioclient_mock.mock_calls) == 1 assert len(calls) == 1 + + def test_service_say_specified_options(self, aioclient_mock): + """Test service call say with options.""" + calls = mock_service(self.hass, DOMAIN_MP, SERVICE_PLAY_MEDIA) + + url_param = { + 'text': 'HomeAssistant', + 'lang': 'en-US', + 'key': '1234567xx', + 'speaker': 'zahar', + 'format': 'mp3', + 'emotion': 'evil', + 'speed': 2 + } + aioclient_mock.get( + self._base_url, status=200, content=b'test', params=url_param) + config = { + tts.DOMAIN: { + 'platform': 'yandextts', + 'api_key': '1234567xx', + } + } + + with assert_setup_component(1, tts.DOMAIN): + setup_component(self.hass, tts.DOMAIN, config) + + self.hass.services.call(tts.DOMAIN, 'yandextts_say', { + tts.ATTR_MESSAGE: "HomeAssistant", + 'options': { + 'emotion': 'evil', + 'speed': 2, + } + }) + self.hass.block_till_done() + + assert len(aioclient_mock.mock_calls) == 1 + assert len(calls) == 1 From 693d32fa6802ea59bac0a1fa8c10ef583b65ce1d Mon Sep 17 00:00:00 2001 From: Jan Losinski Date: Fri, 17 Nov 2017 02:32:26 +0100 Subject: [PATCH 066/246] Snapcast: bump version and enable reconnect. (#10626) This bumps the used snapcast version to 2.0.8 and enables the new reconnect feature that causes the component to reconnect to a server if the connection was lost. This fixes the ned to restart Home Assstant after a snapcast reboot, as described in issue #10264. Signed-off-by: Jan Losinski --- homeassistant/components/media_player/snapcast.py | 4 ++-- requirements_all.txt | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/media_player/snapcast.py b/homeassistant/components/media_player/snapcast.py index 3f1607831e5..54015bec277 100644 --- a/homeassistant/components/media_player/snapcast.py +++ b/homeassistant/components/media_player/snapcast.py @@ -20,7 +20,7 @@ from homeassistant.const import ( import homeassistant.helpers.config_validation as cv from homeassistant.config import load_yaml_config_file -REQUIREMENTS = ['snapcast==2.0.7'] +REQUIREMENTS = ['snapcast==2.0.8'] _LOGGER = logging.getLogger(__name__) @@ -80,7 +80,7 @@ def async_setup_platform(hass, config, async_add_devices, discovery_info=None): try: server = yield from snapcast.control.create_server( - hass.loop, host, port) + hass.loop, host, port, reconnect=True) except socket.gaierror: _LOGGER.error('Could not connect to Snapcast server at %s:%d', host, port) diff --git a/requirements_all.txt b/requirements_all.txt index d22090708fe..2c1112ae49e 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -1022,7 +1022,7 @@ sleepyq==0.6 # smbus-cffi==0.5.1 # homeassistant.components.media_player.snapcast -snapcast==2.0.7 +snapcast==2.0.8 # homeassistant.components.climate.honeywell somecomfort==0.4.1 From aa6b37912a1b3c68b20a83558ad83d46f0a57626 Mon Sep 17 00:00:00 2001 From: Adam Mills Date: Fri, 17 Nov 2017 00:03:05 -0500 Subject: [PATCH 067/246] Fix async missing decorators (#10628) --- homeassistant/helpers/entity.py | 5 ++++- homeassistant/helpers/entity_component.py | 1 + 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/homeassistant/helpers/entity.py b/homeassistant/helpers/entity.py index 8e032bc48a1..4a967e50995 100644 --- a/homeassistant/helpers/entity.py +++ b/homeassistant/helpers/entity.py @@ -11,7 +11,7 @@ from homeassistant.const import ( ATTR_UNIT_OF_MEASUREMENT, DEVICE_DEFAULT_NAME, STATE_OFF, STATE_ON, STATE_UNAVAILABLE, STATE_UNKNOWN, TEMP_CELSIUS, TEMP_FAHRENHEIT, ATTR_ENTITY_PICTURE, ATTR_SUPPORTED_FEATURES, ATTR_DEVICE_CLASS) -from homeassistant.core import HomeAssistant +from homeassistant.core import HomeAssistant, callback from homeassistant.config import DATA_CUSTOMIZE from homeassistant.exceptions import NoEntitySpecifiedError from homeassistant.util import ensure_unique_string, slugify @@ -41,6 +41,7 @@ def generate_entity_id(entity_id_format: str, name: Optional[str], entity_id_format.format(slugify(name)), current_ids) +@callback def async_generate_entity_id(entity_id_format: str, name: Optional[str], current_ids: Optional[List[str]]=None, hass: Optional[HomeAssistant]=None) -> str: @@ -271,10 +272,12 @@ class Entity(object): """ self.hass.add_job(self.async_update_ha_state(force_refresh)) + @callback def async_schedule_update_ha_state(self, force_refresh=False): """Schedule a update ha state change task.""" self.hass.async_add_job(self.async_update_ha_state(force_refresh)) + @asyncio.coroutine def async_device_update(self, warning=True): """Process 'update' or 'async_update' from entity. diff --git a/homeassistant/helpers/entity_component.py b/homeassistant/helpers/entity_component.py index e805f277483..9b25b8ddbd4 100644 --- a/homeassistant/helpers/entity_component.py +++ b/homeassistant/helpers/entity_component.py @@ -97,6 +97,7 @@ class EntityComponent(object): expand_group ).result() + @callback def async_extract_from_service(self, service, expand_group=True): """Extract all known and available entities from a service call. From 6cf2e758a822fe54537efe49cdc4c5fd4dc0af9f Mon Sep 17 00:00:00 2001 From: Corey Pauley Date: Thu, 16 Nov 2017 23:09:00 -0600 Subject: [PATCH 068/246] Alexa slot synonym fix (#10614) * Added logic to the alexa component for handling slot synonyms * Moved note with long url to the top of the file * Just made a tiny url instead of messing with Flake8 * Refactored to be more Pythonic * Put trailing comma back --- homeassistant/components/alexa/const.py | 2 + homeassistant/components/alexa/intent.py | 63 +++++++++++----- tests/components/alexa/test_intent.py | 95 +++++++++++++++++++++++- 3 files changed, 139 insertions(+), 21 deletions(-) diff --git a/homeassistant/components/alexa/const.py b/homeassistant/components/alexa/const.py index 9550b6dbade..c243fc12d5e 100644 --- a/homeassistant/components/alexa/const.py +++ b/homeassistant/components/alexa/const.py @@ -15,4 +15,6 @@ ATTR_STREAM_URL = 'streamUrl' ATTR_MAIN_TEXT = 'mainText' ATTR_REDIRECTION_URL = 'redirectionURL' +SYN_RESOLUTION_MATCH = 'ER_SUCCESS_MATCH' + DATE_FORMAT = '%Y-%m-%dT%H:%M:%S.0Z' diff --git a/homeassistant/components/alexa/intent.py b/homeassistant/components/alexa/intent.py index c3a0155e312..3ade199aabb 100644 --- a/homeassistant/components/alexa/intent.py +++ b/homeassistant/components/alexa/intent.py @@ -3,6 +3,7 @@ Support for Alexa skill service end point. For more details about this component, please refer to the documentation at https://home-assistant.io/components/alexa/ + """ import asyncio import enum @@ -13,7 +14,7 @@ from homeassistant.const import HTTP_BAD_REQUEST from homeassistant.helpers import intent from homeassistant.components import http -from .const import DOMAIN +from .const import DOMAIN, SYN_RESOLUTION_MATCH INTENTS_API_ENDPOINT = '/api/alexa' @@ -123,6 +124,43 @@ class AlexaIntentsView(http.HomeAssistantView): return self.json(alexa_response) +def resolve_slot_synonyms(key, request): + """Check slot request for synonym resolutions.""" + # Default to the spoken slot value if more than one or none are found. For + # reference to the request object structure, see the Alexa docs: + # https://tinyurl.com/ybvm7jhs + resolved_value = request['value'] + + if ('resolutions' in request and + 'resolutionsPerAuthority' in request['resolutions'] and + len(request['resolutions']['resolutionsPerAuthority']) >= 1): + + # Extract all of the possible values from each authority with a + # successful match + possible_values = [] + + for entry in request['resolutions']['resolutionsPerAuthority']: + if entry['status']['code'] != SYN_RESOLUTION_MATCH: + continue + + possible_values.extend([item['value']['name'] + for item + in entry['values']]) + + # If there is only one match use the resolved value, otherwise the + # resolution cannot be determined, so use the spoken slot value + if len(possible_values) == 1: + resolved_value = possible_values[0] + else: + _LOGGER.debug( + 'Found multiple synonym resolutions for slot value: {%s: %s}', + key, + request['value'] + ) + + return resolved_value + + class AlexaResponse(object): """Help generating the response for Alexa.""" @@ -135,28 +173,17 @@ class AlexaResponse(object): self.session_attributes = {} self.should_end_session = True self.variables = {} + # Intent is None if request was a LaunchRequest or SessionEndedRequest if intent_info is not None: for key, value in intent_info.get('slots', {}).items(): - underscored_key = key.replace('.', '_') - - if 'value' in value: - self.variables[underscored_key] = value['value'] - - if 'resolutions' in value: - self._populate_resolved_values(underscored_key, value) - - def _populate_resolved_values(self, underscored_key, value): - for resolution in value['resolutions']['resolutionsPerAuthority']: - if 'values' not in resolution: - continue - - for resolved in resolution['values']: - if 'value' not in resolved: + # Only include slots with values + if 'value' not in value: continue - if 'name' in resolved['value']: - self.variables[underscored_key] = resolved['value']['name'] + _key = key.replace('.', '_') + + self.variables[_key] = resolve_slot_synonyms(key, value) def add_card(self, card_type, title, content): """Add a card to the response.""" diff --git a/tests/components/alexa/test_intent.py b/tests/components/alexa/test_intent.py index 097c91ded79..a3587622b3d 100644 --- a/tests/components/alexa/test_intent.py +++ b/tests/components/alexa/test_intent.py @@ -14,6 +14,7 @@ SESSION_ID = "amzn1.echo-api.session.0000000-0000-0000-0000-00000000000" APPLICATION_ID = "amzn1.echo-sdk-ams.app.000000-d0ed-0000-ad00-000000d00ebe" REQUEST_ID = "amzn1.echo-api.request.0000000-0000-0000-0000-00000000000" AUTHORITY_ID = "amzn1.er-authority.000000-d0ed-0000-ad00-000000d00ebe.ZODIAC" +BUILTIN_AUTH_ID = "amzn1.er-authority.000000-d0ed-0000-ad00-000000d00ebe.TEST" # pylint: disable=invalid-name calls = [] @@ -209,7 +210,7 @@ def test_intent_request_with_slots(alexa_client): @asyncio.coroutine -def test_intent_request_with_slots_and_name_resolution(alexa_client): +def test_intent_request_with_slots_and_synonym_resolution(alexa_client): """Test a request with slots and a name synonym.""" data = { "version": "1.0", @@ -239,7 +240,7 @@ def test_intent_request_with_slots_and_name_resolution(alexa_client): "slots": { "ZodiacSign": { "name": "ZodiacSign", - "value": "virgo", + "value": "V zodiac", "resolutions": { "resolutionsPerAuthority": [ { @@ -254,6 +255,19 @@ def test_intent_request_with_slots_and_name_resolution(alexa_client): } } ] + }, + { + "authority": BUILTIN_AUTH_ID, + "status": { + "code": "ER_SUCCESS_NO_MATCH" + }, + "values": [ + { + "value": { + "name": "Test" + } + } + ] } ] } @@ -270,6 +284,81 @@ def test_intent_request_with_slots_and_name_resolution(alexa_client): assert text == "You told us your sign is Virgo." +@asyncio.coroutine +def test_intent_request_with_slots_and_multi_synonym_resolution(alexa_client): + """Test a request with slots and multiple name synonyms.""" + data = { + "version": "1.0", + "session": { + "new": False, + "sessionId": SESSION_ID, + "application": { + "applicationId": APPLICATION_ID + }, + "attributes": { + "supportedHoroscopePeriods": { + "daily": True, + "weekly": False, + "monthly": False + } + }, + "user": { + "userId": "amzn1.account.AM3B00000000000000000000000" + } + }, + "request": { + "type": "IntentRequest", + "requestId": REQUEST_ID, + "timestamp": "2015-05-13T12:34:56Z", + "intent": { + "name": "GetZodiacHoroscopeIntent", + "slots": { + "ZodiacSign": { + "name": "ZodiacSign", + "value": "V zodiac", + "resolutions": { + "resolutionsPerAuthority": [ + { + "authority": AUTHORITY_ID, + "status": { + "code": "ER_SUCCESS_MATCH" + }, + "values": [ + { + "value": { + "name": "Virgo" + } + } + ] + }, + { + "authority": BUILTIN_AUTH_ID, + "status": { + "code": "ER_SUCCESS_MATCH" + }, + "values": [ + { + "value": { + "name": "Test" + } + } + ] + } + ] + } + } + } + } + } + } + req = yield from _intent_req(alexa_client, data) + assert req.status == 200 + data = yield from req.json() + text = data.get("response", {}).get("outputSpeech", + {}).get("text") + assert text == "You told us your sign is V zodiac." + + @asyncio.coroutine def test_intent_request_with_slots_but_no_value(alexa_client): """Test a request with slots but no value.""" @@ -300,7 +389,7 @@ def test_intent_request_with_slots_but_no_value(alexa_client): "name": "GetZodiacHoroscopeIntent", "slots": { "ZodiacSign": { - "name": "ZodiacSign", + "name": "ZodiacSign" } } } From 5c20cc32b57910abf191e1bdbf0cd6b0f7362573 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Thu, 16 Nov 2017 22:03:31 -0800 Subject: [PATCH 069/246] Update frontend to 20171117.0 --- homeassistant/components/frontend/__init__.py | 2 +- requirements_all.txt | 2 +- requirements_test_all.txt | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index d1f35683e95..094037152d4 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -23,7 +23,7 @@ from homeassistant.const import CONF_NAME, EVENT_THEMES_UPDATED from homeassistant.core import callback from homeassistant.loader import bind_hass -REQUIREMENTS = ['home-assistant-frontend==20171115.0'] +REQUIREMENTS = ['home-assistant-frontend==20171117.0'] DOMAIN = 'frontend' DEPENDENCIES = ['api', 'websocket_api', 'http', 'system_log'] diff --git a/requirements_all.txt b/requirements_all.txt index 2c1112ae49e..64d4404f45a 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -331,7 +331,7 @@ hipnotify==1.0.8 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171115.0 +home-assistant-frontend==20171117.0 # homeassistant.components.camera.onvif http://github.com/tgaugry/suds-passworddigest-py3/archive/86fc50e39b4d2b8997481967d6a7fe1c57118999.zip#suds-passworddigest-py3==0.1.2a diff --git a/requirements_test_all.txt b/requirements_test_all.txt index 201da6be2b3..b1ae935ff72 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -74,7 +74,7 @@ hbmqtt==0.9.1 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171115.0 +home-assistant-frontend==20171117.0 # homeassistant.components.influxdb # homeassistant.components.sensor.influxdb From 24aeea5ca33449e4590b919e8e15388e25ca4902 Mon Sep 17 00:00:00 2001 From: Anders Melchiorsen Date: Fri, 17 Nov 2017 07:05:08 +0100 Subject: [PATCH 070/246] Adjust logging in downloader component (#10622) --- homeassistant/components/downloader.py | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/downloader.py b/homeassistant/components/downloader.py index 5c9ced1fd89..d832bbdfdd1 100644 --- a/homeassistant/components/downloader.py +++ b/homeassistant/components/downloader.py @@ -77,8 +77,13 @@ def setup(hass, config): req = requests.get(url, stream=True, timeout=10) - if req.status_code == 200: + if req.status_code != 200: + _LOGGER.warning( + "downloading '%s' failed, stauts_code=%d", + url, + req.status_code) + else: if filename is None and \ 'content-disposition' in req.headers: match = re.findall(r"filename=(\S+)", @@ -121,13 +126,13 @@ def setup(hass, config): final_path = "{}_{}.{}".format(path, tries, ext) - _LOGGER.info("%s -> %s", url, final_path) + _LOGGER.debug("%s -> %s", url, final_path) with open(final_path, 'wb') as fil: for chunk in req.iter_content(1024): fil.write(chunk) - _LOGGER.info("Downloading of %s done", url) + _LOGGER.debug("Downloading of %s done", url) except requests.exceptions.ConnectionError: _LOGGER.exception("ConnectionError occurred for %s", url) From f052a0926be0f373e20ce322f18f0515aacfdbf4 Mon Sep 17 00:00:00 2001 From: Egor Tsinko Date: Thu, 16 Nov 2017 23:06:02 -0700 Subject: [PATCH 071/246] Added sorted() to python_script (#10621) * added sorted() to python_script * fixed lint errors --- homeassistant/components/python_script.py | 1 + tests/components/test_python_script.py | 21 +++++++++++++++++++++ 2 files changed, 22 insertions(+) diff --git a/homeassistant/components/python_script.py b/homeassistant/components/python_script.py index 75b2a1fed71..85f12a18afd 100644 --- a/homeassistant/components/python_script.py +++ b/homeassistant/components/python_script.py @@ -140,6 +140,7 @@ def execute(hass, filename, source, data=None): builtins = safe_builtins.copy() builtins.update(utility_builtins) builtins['datetime'] = datetime + builtins['sorted'] = sorted builtins['time'] = TimeWrapper() builtins['dt_util'] = dt_util restricted_globals = { diff --git a/tests/components/test_python_script.py b/tests/components/test_python_script.py index e5d6b0c4aad..8a7f94d7dcd 100644 --- a/tests/components/test_python_script.py +++ b/tests/components/test_python_script.py @@ -209,6 +209,27 @@ hass.states.set('hello.ab_list', '{}'.format(ab_list)) assert caplog.text == '' +@asyncio.coroutine +def test_execute_sorted(hass, caplog): + """Test sorted() function.""" + caplog.set_level(logging.ERROR) + source = """ +a = sorted([3,1,2]) +assert(a == [1,2,3]) +hass.states.set('hello.a', a[0]) +hass.states.set('hello.b', a[1]) +hass.states.set('hello.c', a[2]) +""" + hass.async_add_job(execute, hass, 'test.py', source, {}) + yield from hass.async_block_till_done() + + assert hass.states.is_state('hello.a', '1') + assert hass.states.is_state('hello.b', '2') + assert hass.states.is_state('hello.c', '3') + # No errors logged = good + assert caplog.text == '' + + @asyncio.coroutine def test_exposed_modules(hass, caplog): """Test datetime and time modules exposed.""" From 1bb37aff0cfd809b7bbff4c4631f8d6a6c09c63f Mon Sep 17 00:00:00 2001 From: John Arild Berentsen Date: Fri, 17 Nov 2017 07:07:08 +0100 Subject: [PATCH 072/246] Add loglinefetch for frontend API call (#10579) * Add loglinefetch for frontend API call * Too many blank lines * Review changes * review changes * Only return a text * Use aiohttp * Don't do I/O in event loop * Move lines to query and default to 0 * Small fixes --- homeassistant/components/config/zwave.py | 38 ++++++++++++++++++++++-- 1 file changed, 35 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/config/zwave.py b/homeassistant/components/config/zwave.py index dd8552f374e..c839ab7bc6e 100644 --- a/homeassistant/components/config/zwave.py +++ b/homeassistant/components/config/zwave.py @@ -2,6 +2,8 @@ import asyncio import logging +from collections import deque +from aiohttp.web import Response import homeassistant.core as ha from homeassistant.const import HTTP_NOT_FOUND, HTTP_OK from homeassistant.components.http import HomeAssistantView @@ -12,7 +14,6 @@ import homeassistant.helpers.config_validation as cv _LOGGER = logging.getLogger(__name__) CONFIG_PATH = 'zwave_device_config.yaml' OZW_LOG_FILENAME = 'OZW_Log.txt' -URL_API_OZW_LOG = '/api/zwave/ozwlog' @asyncio.coroutine @@ -26,13 +27,44 @@ def async_setup(hass): hass.http.register_view(ZWaveNodeGroupView) hass.http.register_view(ZWaveNodeConfigView) hass.http.register_view(ZWaveUserCodeView) - hass.http.register_static_path( - URL_API_OZW_LOG, hass.config.path(OZW_LOG_FILENAME), False) + hass.http.register_view(ZWaveLogView) hass.http.register_view(ZWaveConfigWriteView) return True +class ZWaveLogView(HomeAssistantView): + """View to read the ZWave log file.""" + + url = "/api/zwave/ozwlog" + name = "api:zwave:ozwlog" + +# pylint: disable=no-self-use + @asyncio.coroutine + def get(self, request): + """Retrieve the lines from ZWave log.""" + try: + lines = int(request.query.get('lines', 0)) + except ValueError: + return Response(text='Invalid datetime', status=400) + + hass = request.app['hass'] + response = yield from hass.async_add_job(self._get_log, hass, lines) + + return Response(text='\n'.join(response)) + + def _get_log(self, hass, lines): + """Retrieve the logfile content.""" + logfilepath = hass.config.path(OZW_LOG_FILENAME) + with open(logfilepath, 'r') as logfile: + data = (line.rstrip() for line in logfile) + if lines == 0: + loglines = list(data) + else: + loglines = deque(data, lines) + return loglines + + class ZWaveConfigWriteView(HomeAssistantView): """View to save the ZWave configuration to zwcfg_xxxxx.xml.""" From 62c8843956bf3283c728144ad4422367ead3e213 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Thu, 16 Nov 2017 22:08:15 -0800 Subject: [PATCH 073/246] Update frontend to 20171117.1 --- homeassistant/components/frontend/__init__.py | 2 +- requirements_all.txt | 2 +- requirements_test_all.txt | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index 094037152d4..bac00b8a57a 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -23,7 +23,7 @@ from homeassistant.const import CONF_NAME, EVENT_THEMES_UPDATED from homeassistant.core import callback from homeassistant.loader import bind_hass -REQUIREMENTS = ['home-assistant-frontend==20171117.0'] +REQUIREMENTS = ['home-assistant-frontend==20171117.1'] DOMAIN = 'frontend' DEPENDENCIES = ['api', 'websocket_api', 'http', 'system_log'] diff --git a/requirements_all.txt b/requirements_all.txt index 64d4404f45a..04432aa26a2 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -331,7 +331,7 @@ hipnotify==1.0.8 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171117.0 +home-assistant-frontend==20171117.1 # homeassistant.components.camera.onvif http://github.com/tgaugry/suds-passworddigest-py3/archive/86fc50e39b4d2b8997481967d6a7fe1c57118999.zip#suds-passworddigest-py3==0.1.2a diff --git a/requirements_test_all.txt b/requirements_test_all.txt index b1ae935ff72..32c2feb7427 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -74,7 +74,7 @@ hbmqtt==0.9.1 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171117.0 +home-assistant-frontend==20171117.1 # homeassistant.components.influxdb # homeassistant.components.sensor.influxdb From eb8a8f6d0b13780ecf967fa0b43d83091f86dcef Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Thu, 16 Nov 2017 22:10:40 -0800 Subject: [PATCH 074/246] Version bump to 0.58.0 --- homeassistant/const.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/homeassistant/const.py b/homeassistant/const.py index d08308de820..d8b4dfcb044 100644 --- a/homeassistant/const.py +++ b/homeassistant/const.py @@ -2,7 +2,7 @@ """Constants used by Home Assistant components.""" MAJOR_VERSION = 0 MINOR_VERSION = 58 -PATCH_VERSION = '0.dev0' +PATCH_VERSION = '0' __short_version__ = '{}.{}'.format(MAJOR_VERSION, MINOR_VERSION) __version__ = '{}.{}'.format(__short_version__, PATCH_VERSION) REQUIRED_PYTHON_VER = (3, 4, 2) From 2a778831468250193d5c0967535d1f9f0bec9fbe Mon Sep 17 00:00:00 2001 From: Alok Saboo Date: Fri, 17 Nov 2017 02:58:46 -0500 Subject: [PATCH 075/246] Added unit_of_measurement to Currencylayer (#10598) * Added unit_of_measurement to Currencylayer * Updated based on comments * Remove quote from name --- homeassistant/components/sensor/currencylayer.py | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/homeassistant/components/sensor/currencylayer.py b/homeassistant/components/sensor/currencylayer.py index 2d4e43f69be..f5d6f278da0 100644 --- a/homeassistant/components/sensor/currencylayer.py +++ b/homeassistant/components/sensor/currencylayer.py @@ -68,10 +68,15 @@ class CurrencylayerSensor(Entity): self._base = base self._state = None + @property + def unit_of_measurement(self): + """Return the unit of measurement of this entity, if any.""" + return self._quote + @property def name(self): """Return the name of the sensor.""" - return '{} {}'.format(self._base, self._quote) + return self._base @property def icon(self): From e9b691173a5b4a4d7c67442cbb47eb1ef2d50e60 Mon Sep 17 00:00:00 2001 From: Milan V Date: Fri, 17 Nov 2017 12:47:54 +0100 Subject: [PATCH 076/246] Change generic thermostat - any toggle device as heater switch (#10597) * Change generic thermostat - any toggle device as heater * Heater switch state method * Tests * Debug log, lint * Debug code remove, cleanup * Change generic thermostat to control heating on mode change Off -> Auto * Fix typo * Review fixes, tests * Merge and fix tests --- .../components/climate/generic_thermostat.py | 34 +++-- .../climate/test_generic_thermostat.py | 144 ++++++++++++++---- 2 files changed, 135 insertions(+), 43 deletions(-) diff --git a/homeassistant/components/climate/generic_thermostat.py b/homeassistant/components/climate/generic_thermostat.py index 0c0c837b850..4b86fa4067b 100644 --- a/homeassistant/components/climate/generic_thermostat.py +++ b/homeassistant/components/climate/generic_thermostat.py @@ -10,13 +10,13 @@ import logging import voluptuous as vol from homeassistant.core import callback -from homeassistant.components import switch +from homeassistant.core import DOMAIN as HA_DOMAIN from homeassistant.components.climate import ( STATE_HEAT, STATE_COOL, STATE_IDLE, ClimateDevice, PLATFORM_SCHEMA, STATE_AUTO) from homeassistant.const import ( ATTR_UNIT_OF_MEASUREMENT, STATE_ON, STATE_OFF, ATTR_TEMPERATURE, - CONF_NAME) + CONF_NAME, ATTR_ENTITY_ID, SERVICE_TURN_ON, SERVICE_TURN_OFF) from homeassistant.helpers import condition from homeassistant.helpers.event import ( async_track_state_change, async_track_time_interval) @@ -167,7 +167,7 @@ class GenericThermostat(ClimateDevice): elif operation_mode == STATE_OFF: self._enabled = False if self._is_device_active: - switch.async_turn_off(self.hass, self.heater_entity_id) + self._heater_turn_off() else: _LOGGER.error('Unrecognized operation mode: %s', operation_mode) return @@ -225,9 +225,9 @@ class GenericThermostat(ClimateDevice): def _async_keep_alive(self, time): """Call at constant intervals for keep-alive purposes.""" if self.current_operation in [STATE_COOL, STATE_HEAT]: - switch.async_turn_on(self.hass, self.heater_entity_id) + self._heater_turn_on() else: - switch.async_turn_off(self.hass, self.heater_entity_id) + self._heater_turn_off() @callback def _async_update_temp(self, state): @@ -273,13 +273,13 @@ class GenericThermostat(ClimateDevice): self._cold_tolerance if too_cold: _LOGGER.info('Turning off AC %s', self.heater_entity_id) - switch.async_turn_off(self.hass, self.heater_entity_id) + self._heater_turn_off() else: too_hot = self._cur_temp - self._target_temp >= \ self._hot_tolerance if too_hot: _LOGGER.info('Turning on AC %s', self.heater_entity_id) - switch.async_turn_on(self.hass, self.heater_entity_id) + self._heater_turn_on() else: is_heating = self._is_device_active if is_heating: @@ -288,15 +288,29 @@ class GenericThermostat(ClimateDevice): if too_hot: _LOGGER.info('Turning off heater %s', self.heater_entity_id) - switch.async_turn_off(self.hass, self.heater_entity_id) + self._heater_turn_off() else: too_cold = self._target_temp - self._cur_temp >= \ self._cold_tolerance if too_cold: _LOGGER.info('Turning on heater %s', self.heater_entity_id) - switch.async_turn_on(self.hass, self.heater_entity_id) + self._heater_turn_on() @property def _is_device_active(self): """If the toggleable device is currently active.""" - return switch.is_on(self.hass, self.heater_entity_id) + return self.hass.states.is_state(self.heater_entity_id, STATE_ON) + + @callback + def _heater_turn_on(self): + """Turn heater toggleable device on.""" + data = {ATTR_ENTITY_ID: self.heater_entity_id} + self.hass.async_add_job( + self.hass.services.async_call(HA_DOMAIN, SERVICE_TURN_ON, data)) + + @callback + def _heater_turn_off(self): + """Turn heater toggleable device off.""" + data = {ATTR_ENTITY_ID: self.heater_entity_id} + self.hass.async_add_job( + self.hass.services.async_call(HA_DOMAIN, SERVICE_TURN_OFF, data)) diff --git a/tests/components/climate/test_generic_thermostat.py b/tests/components/climate/test_generic_thermostat.py index bb42ef177f0..25887211253 100644 --- a/tests/components/climate/test_generic_thermostat.py +++ b/tests/components/climate/test_generic_thermostat.py @@ -16,9 +16,11 @@ from homeassistant.const import ( STATE_OFF, TEMP_CELSIUS, ) +from homeassistant import loader from homeassistant.util.unit_system import METRIC_SYSTEM -from homeassistant.components import climate - +from homeassistant.util.async import run_coroutine_threadsafe +from homeassistant.components import climate, input_boolean, switch +import homeassistant.components as comps from tests.common import assert_setup_component, get_test_home_assistant @@ -82,6 +84,82 @@ class TestSetupClimateGenericThermostat(unittest.TestCase): self.assertEqual(22.0, state.attributes.get('current_temperature')) +class TestGenericThermostatHeaterSwitching(unittest.TestCase): + """Test the Generic thermostat heater switching. + + Different toggle type devices are tested. + """ + + def setUp(self): # pylint: disable=invalid-name + """Setup things to be run when tests are started.""" + self.hass = get_test_home_assistant() + self.hass.config.units = METRIC_SYSTEM + self.assertTrue(run_coroutine_threadsafe( + comps.async_setup(self.hass, {}), self.hass.loop + ).result()) + + def tearDown(self): # pylint: disable=invalid-name + """Stop down everything that was started.""" + self.hass.stop() + + def test_heater_input_boolean(self): + """Test heater switching input_boolean.""" + heater_switch = 'input_boolean.test' + assert setup_component(self.hass, input_boolean.DOMAIN, + {'input_boolean': {'test': None}}) + + assert setup_component(self.hass, climate.DOMAIN, {'climate': { + 'platform': 'generic_thermostat', + 'name': 'test', + 'heater': heater_switch, + 'target_sensor': ENT_SENSOR + }}) + + self.assertEqual(STATE_OFF, + self.hass.states.get(heater_switch).state) + + self._setup_sensor(18) + self.hass.block_till_done() + climate.set_temperature(self.hass, 23) + self.hass.block_till_done() + + self.assertEqual(STATE_ON, + self.hass.states.get(heater_switch).state) + + def test_heater_switch(self): + """Test heater switching test switch.""" + platform = loader.get_component('switch.test') + platform.init() + self.switch_1 = platform.DEVICES[1] + assert setup_component(self.hass, switch.DOMAIN, {'switch': { + 'platform': 'test'}}) + heater_switch = self.switch_1.entity_id + + assert setup_component(self.hass, climate.DOMAIN, {'climate': { + 'platform': 'generic_thermostat', + 'name': 'test', + 'heater': heater_switch, + 'target_sensor': ENT_SENSOR + }}) + + self.assertEqual(STATE_OFF, + self.hass.states.get(heater_switch).state) + + self._setup_sensor(18) + self.hass.block_till_done() + climate.set_temperature(self.hass, 23) + self.hass.block_till_done() + + self.assertEqual(STATE_ON, + self.hass.states.get(heater_switch).state) + + def _setup_sensor(self, temp, unit=TEMP_CELSIUS): + """Setup the test sensor.""" + self.hass.states.set(ENT_SENSOR, temp, { + ATTR_UNIT_OF_MEASUREMENT: unit + }) + + class TestClimateGenericThermostat(unittest.TestCase): """Test the Generic thermostat.""" @@ -161,7 +239,7 @@ class TestClimateGenericThermostat(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) call = self.calls[0] - self.assertEqual('switch', call.domain) + self.assertEqual('homeassistant', call.domain) self.assertEqual(SERVICE_TURN_ON, call.service) self.assertEqual(ENT_SWITCH, call.data['entity_id']) @@ -174,7 +252,7 @@ class TestClimateGenericThermostat(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) call = self.calls[0] - self.assertEqual('switch', call.domain) + self.assertEqual('homeassistant', call.domain) self.assertEqual(SERVICE_TURN_OFF, call.service) self.assertEqual(ENT_SWITCH, call.data['entity_id']) @@ -196,7 +274,7 @@ class TestClimateGenericThermostat(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) call = self.calls[0] - self.assertEqual('switch', call.domain) + self.assertEqual('homeassistant', call.domain) self.assertEqual(SERVICE_TURN_ON, call.service) self.assertEqual(ENT_SWITCH, call.data['entity_id']) @@ -218,7 +296,7 @@ class TestClimateGenericThermostat(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) call = self.calls[0] - self.assertEqual('switch', call.domain) + self.assertEqual('homeassistant', call.domain) self.assertEqual(SERVICE_TURN_OFF, call.service) self.assertEqual(ENT_SWITCH, call.data['entity_id']) @@ -231,7 +309,7 @@ class TestClimateGenericThermostat(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) call = self.calls[0] - self.assertEqual('switch', call.domain) + self.assertEqual('homeassistant', call.domain) self.assertEqual(SERVICE_TURN_OFF, call.service) self.assertEqual(ENT_SWITCH, call.data['entity_id']) @@ -267,7 +345,7 @@ class TestClimateGenericThermostat(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) call = self.calls[0] - self.assertEqual('switch', call.domain) + self.assertEqual('homeassistant', call.domain) self.assertEqual(SERVICE_TURN_ON, call.service) self.assertEqual(ENT_SWITCH, call.data['entity_id']) @@ -287,8 +365,8 @@ class TestClimateGenericThermostat(unittest.TestCase): """Log service calls.""" self.calls.append(call) - self.hass.services.register('switch', SERVICE_TURN_ON, log_call) - self.hass.services.register('switch', SERVICE_TURN_OFF, log_call) + self.hass.services.register(ha.DOMAIN, SERVICE_TURN_ON, log_call) + self.hass.services.register(ha.DOMAIN, SERVICE_TURN_OFF, log_call) class TestClimateGenericThermostatACMode(unittest.TestCase): @@ -321,7 +399,7 @@ class TestClimateGenericThermostatACMode(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) call = self.calls[0] - self.assertEqual('switch', call.domain) + self.assertEqual('homeassistant', call.domain) self.assertEqual(SERVICE_TURN_OFF, call.service) self.assertEqual(ENT_SWITCH, call.data['entity_id']) @@ -334,7 +412,7 @@ class TestClimateGenericThermostatACMode(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) call = self.calls[0] - self.assertEqual('switch', call.domain) + self.assertEqual('homeassistant', call.domain) self.assertEqual(SERVICE_TURN_ON, call.service) self.assertEqual(ENT_SWITCH, call.data['entity_id']) @@ -356,7 +434,7 @@ class TestClimateGenericThermostatACMode(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) call = self.calls[0] - self.assertEqual('switch', call.domain) + self.assertEqual('homeassistant', call.domain) self.assertEqual(SERVICE_TURN_OFF, call.service) self.assertEqual(ENT_SWITCH, call.data['entity_id']) @@ -378,7 +456,7 @@ class TestClimateGenericThermostatACMode(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) call = self.calls[0] - self.assertEqual('switch', call.domain) + self.assertEqual('homeassistant', call.domain) self.assertEqual(SERVICE_TURN_ON, call.service) self.assertEqual(ENT_SWITCH, call.data['entity_id']) @@ -391,7 +469,7 @@ class TestClimateGenericThermostatACMode(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) call = self.calls[0] - self.assertEqual('switch', call.domain) + self.assertEqual('homeassistant', call.domain) self.assertEqual(SERVICE_TURN_OFF, call.service) self.assertEqual(ENT_SWITCH, call.data['entity_id']) @@ -422,8 +500,8 @@ class TestClimateGenericThermostatACMode(unittest.TestCase): """Log service calls.""" self.calls.append(call) - self.hass.services.register('switch', SERVICE_TURN_ON, log_call) - self.hass.services.register('switch', SERVICE_TURN_OFF, log_call) + self.hass.services.register(ha.DOMAIN, SERVICE_TURN_ON, log_call) + self.hass.services.register(ha.DOMAIN, SERVICE_TURN_OFF, log_call) class TestClimateGenericThermostatACModeMinCycle(unittest.TestCase): @@ -470,7 +548,7 @@ class TestClimateGenericThermostatACModeMinCycle(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) call = self.calls[0] - self.assertEqual('switch', call.domain) + self.assertEqual('homeassistant', call.domain) self.assertEqual(SERVICE_TURN_ON, call.service) self.assertEqual(ENT_SWITCH, call.data['entity_id']) @@ -496,7 +574,7 @@ class TestClimateGenericThermostatACModeMinCycle(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) call = self.calls[0] - self.assertEqual('switch', call.domain) + self.assertEqual('homeassistant', call.domain) self.assertEqual(SERVICE_TURN_OFF, call.service) self.assertEqual(ENT_SWITCH, call.data['entity_id']) @@ -516,8 +594,8 @@ class TestClimateGenericThermostatACModeMinCycle(unittest.TestCase): """Log service calls.""" self.calls.append(call) - self.hass.services.register('switch', SERVICE_TURN_ON, log_call) - self.hass.services.register('switch', SERVICE_TURN_OFF, log_call) + self.hass.services.register(ha.DOMAIN, SERVICE_TURN_ON, log_call) + self.hass.services.register(ha.DOMAIN, SERVICE_TURN_OFF, log_call) class TestClimateGenericThermostatMinCycle(unittest.TestCase): @@ -572,7 +650,7 @@ class TestClimateGenericThermostatMinCycle(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) call = self.calls[0] - self.assertEqual('switch', call.domain) + self.assertEqual('homeassistant', call.domain) self.assertEqual(SERVICE_TURN_ON, call.service) self.assertEqual(ENT_SWITCH, call.data['entity_id']) @@ -589,7 +667,7 @@ class TestClimateGenericThermostatMinCycle(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) call = self.calls[0] - self.assertEqual('switch', call.domain) + self.assertEqual('homeassistant', call.domain) self.assertEqual(SERVICE_TURN_OFF, call.service) self.assertEqual(ENT_SWITCH, call.data['entity_id']) @@ -609,8 +687,8 @@ class TestClimateGenericThermostatMinCycle(unittest.TestCase): """Log service calls.""" self.calls.append(call) - self.hass.services.register('switch', SERVICE_TURN_ON, log_call) - self.hass.services.register('switch', SERVICE_TURN_OFF, log_call) + self.hass.services.register(ha.DOMAIN, SERVICE_TURN_ON, log_call) + self.hass.services.register(ha.DOMAIN, SERVICE_TURN_OFF, log_call) class TestClimateGenericThermostatACKeepAlive(unittest.TestCase): @@ -654,7 +732,7 @@ class TestClimateGenericThermostatACKeepAlive(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) call = self.calls[0] - self.assertEqual('switch', call.domain) + self.assertEqual('homeassistant', call.domain) self.assertEqual(SERVICE_TURN_ON, call.service) self.assertEqual(ENT_SWITCH, call.data['entity_id']) @@ -677,7 +755,7 @@ class TestClimateGenericThermostatACKeepAlive(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) call = self.calls[0] - self.assertEqual('switch', call.domain) + self.assertEqual('homeassistant', call.domain) self.assertEqual(SERVICE_TURN_OFF, call.service) self.assertEqual(ENT_SWITCH, call.data['entity_id']) @@ -701,8 +779,8 @@ class TestClimateGenericThermostatACKeepAlive(unittest.TestCase): """Log service calls.""" self.calls.append(call) - self.hass.services.register('switch', SERVICE_TURN_ON, log_call) - self.hass.services.register('switch', SERVICE_TURN_OFF, log_call) + self.hass.services.register(ha.DOMAIN, SERVICE_TURN_ON, log_call) + self.hass.services.register(ha.DOMAIN, SERVICE_TURN_OFF, log_call) class TestClimateGenericThermostatKeepAlive(unittest.TestCase): @@ -745,7 +823,7 @@ class TestClimateGenericThermostatKeepAlive(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) call = self.calls[0] - self.assertEqual('switch', call.domain) + self.assertEqual('homeassistant', call.domain) self.assertEqual(SERVICE_TURN_ON, call.service) self.assertEqual(ENT_SWITCH, call.data['entity_id']) @@ -768,7 +846,7 @@ class TestClimateGenericThermostatKeepAlive(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) call = self.calls[0] - self.assertEqual('switch', call.domain) + self.assertEqual('homeassistant', call.domain) self.assertEqual(SERVICE_TURN_OFF, call.service) self.assertEqual(ENT_SWITCH, call.data['entity_id']) @@ -792,8 +870,8 @@ class TestClimateGenericThermostatKeepAlive(unittest.TestCase): """Log service calls.""" self.calls.append(call) - self.hass.services.register('switch', SERVICE_TURN_ON, log_call) - self.hass.services.register('switch', SERVICE_TURN_OFF, log_call) + self.hass.services.register(ha.DOMAIN, SERVICE_TURN_ON, log_call) + self.hass.services.register(ha.DOMAIN, SERVICE_TURN_OFF, log_call) @asyncio.coroutine From be5f0fb3ac319446afa987febb52ba09bb99c08c Mon Sep 17 00:00:00 2001 From: cgtobi Date: Fri, 17 Nov 2017 15:21:27 +0100 Subject: [PATCH 077/246] Add hddtemp sensor device even if unreachable. (#10623) * Add hddtemp sensor device even if unreachable. * Removed old commented code. * Move unit detection logic into update. --- homeassistant/components/sensor/hddtemp.py | 32 ++++++++++++---------- tests/components/sensor/test_hddtemp.py | 25 +++++++++++++++-- 2 files changed, 41 insertions(+), 16 deletions(-) diff --git a/homeassistant/components/sensor/hddtemp.py b/homeassistant/components/sensor/hddtemp.py index e025cd2fbcd..006542a777f 100644 --- a/homeassistant/components/sensor/hddtemp.py +++ b/homeassistant/components/sensor/hddtemp.py @@ -7,6 +7,7 @@ https://home-assistant.io/components/sensor.hddtemp/ import logging from datetime import timedelta from telnetlib import Telnet +import socket import voluptuous as vol @@ -46,16 +47,12 @@ def setup_platform(hass, config, add_devices, discovery_info=None): hddtemp = HddTempData(host, port) hddtemp.update() - if hddtemp.data is None: - return False - if not disks: disks = [next(iter(hddtemp.data)).split('|')[0]] dev = [] for disk in disks: - if disk in hddtemp.data: - dev.append(HddTempSensor(name, disk, hddtemp)) + dev.append(HddTempSensor(name, disk, hddtemp)) add_devices(dev, True) @@ -70,6 +67,7 @@ class HddTempSensor(Entity): self._name = '{} {}'.format(name, disk) self._state = None self._details = None + self._unit = None @property def name(self): @@ -84,17 +82,16 @@ class HddTempSensor(Entity): @property def unit_of_measurement(self): """Return the unit the value is expressed in.""" - if self._details[3] == 'C': - return TEMP_CELSIUS - return TEMP_FAHRENHEIT + return self._unit @property def device_state_attributes(self): """Return the state attributes of the sensor.""" - return { - ATTR_DEVICE: self._details[0], - ATTR_MODEL: self._details[1], - } + if self._details is not None: + return { + ATTR_DEVICE: self._details[0], + ATTR_MODEL: self._details[1], + } def update(self): """Get the latest data from HDDTemp daemon and updates the state.""" @@ -103,6 +100,10 @@ class HddTempSensor(Entity): if self.hddtemp.data and self.disk in self.hddtemp.data: self._details = self.hddtemp.data[self.disk].split('|') self._state = self._details[2] + if self._details is not None and self._details[3] == 'F': + self._unit = TEMP_FAHRENHEIT + else: + self._unit = TEMP_CELSIUS else: self._state = None @@ -126,6 +127,9 @@ class HddTempData(object): self.data = {data[i].split('|')[0]: data[i] for i in range(0, len(data), 1)} except ConnectionRefusedError: - _LOGGER.error( - "HDDTemp is not available at %s:%s", self.host, self.port) + _LOGGER.error("HDDTemp is not available at %s:%s", + self.host, self.port) + self.data = None + except socket.gaierror: + _LOGGER.error("HDDTemp host not found %s:%s", self.host, self.port) self.data = None diff --git a/tests/components/sensor/test_hddtemp.py b/tests/components/sensor/test_hddtemp.py index 35d1c08c08a..3be35f3281c 100644 --- a/tests/components/sensor/test_hddtemp.py +++ b/tests/components/sensor/test_hddtemp.py @@ -1,4 +1,6 @@ """The tests for the hddtemp platform.""" +import socket + import unittest from unittest.mock import patch @@ -56,6 +58,13 @@ VALID_CONFIG_HOST = { } } +VALID_CONFIG_HOST_UNREACHABLE = { + 'sensor': { + 'platform': 'hddtemp', + 'host': 'bob.local', + } +} + class TelnetMock(): """Mock class for the telnetlib.Telnet object.""" @@ -75,6 +84,8 @@ class TelnetMock(): """Return sample values.""" if self.host == 'alice.local': raise ConnectionRefusedError + elif self.host == 'bob.local': + raise socket.gaierror else: return self.sample_data return None @@ -161,7 +172,10 @@ class TestHDDTempSensor(unittest.TestCase): """Test hddtemp wrong disk configuration.""" assert setup_component(self.hass, 'sensor', VALID_CONFIG_WRONG_DISK) - self.assertEqual(len(self.hass.states.all()), 0) + self.assertEqual(len(self.hass.states.all()), 1) + state = self.hass.states.get('sensor.hd_temperature_devsdx1') + self.assertEqual(state.attributes.get('friendly_name'), + 'HD Temperature ' + '/dev/sdx1') @patch('telnetlib.Telnet', new=TelnetMock) def test_hddtemp_multiple_disks(self): @@ -189,7 +203,14 @@ class TestHDDTempSensor(unittest.TestCase): 'HD Temperature ' + reference['device']) @patch('telnetlib.Telnet', new=TelnetMock) - def test_hddtemp_host_unreachable(self): + def test_hddtemp_host_refused(self): """Test hddtemp if host unreachable.""" assert setup_component(self.hass, 'sensor', VALID_CONFIG_HOST) self.assertEqual(len(self.hass.states.all()), 0) + + @patch('telnetlib.Telnet', new=TelnetMock) + def test_hddtemp_host_unreachable(self): + """Test hddtemp if host unreachable.""" + assert setup_component(self.hass, 'sensor', + VALID_CONFIG_HOST_UNREACHABLE) + self.assertEqual(len(self.hass.states.all()), 0) From 68d2076b566749ce5a38d2712ede3ceb9d39f84c Mon Sep 17 00:00:00 2001 From: Lukas Barth Date: Fri, 17 Nov 2017 17:32:58 +0100 Subject: [PATCH 078/246] Restore target temperature for generic thermostat (#10635) * Restore target temp for generic thermostat * Fix lint --- .../components/climate/generic_thermostat.py | 12 +++++++++ .../climate/test_generic_thermostat.py | 27 +++++++++++++++++-- 2 files changed, 37 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/climate/generic_thermostat.py b/homeassistant/components/climate/generic_thermostat.py index 4b86fa4067b..3f3470c1c86 100644 --- a/homeassistant/components/climate/generic_thermostat.py +++ b/homeassistant/components/climate/generic_thermostat.py @@ -21,6 +21,7 @@ from homeassistant.helpers import condition from homeassistant.helpers.event import ( async_track_state_change, async_track_time_interval) import homeassistant.helpers.config_validation as cv +from homeassistant.helpers.restore_state import async_get_last_state _LOGGER = logging.getLogger(__name__) @@ -117,6 +118,17 @@ class GenericThermostat(ClimateDevice): if sensor_state: self._async_update_temp(sensor_state) + @asyncio.coroutine + def async_added_to_hass(self): + """Run when entity about to be added.""" + # If we have an old state and no target temp, restore + if self._target_temp is None: + old_state = yield from async_get_last_state(self.hass, + self.entity_id) + if old_state is not None: + self._target_temp = float( + old_state.attributes[ATTR_TEMPERATURE]) + @property def should_poll(self): """Return the polling state.""" diff --git a/tests/components/climate/test_generic_thermostat.py b/tests/components/climate/test_generic_thermostat.py index 25887211253..5982a6c16d8 100644 --- a/tests/components/climate/test_generic_thermostat.py +++ b/tests/components/climate/test_generic_thermostat.py @@ -6,7 +6,7 @@ from unittest import mock import pytz import homeassistant.core as ha -from homeassistant.core import callback +from homeassistant.core import callback, CoreState, State from homeassistant.setup import setup_component, async_setup_component from homeassistant.const import ( ATTR_UNIT_OF_MEASUREMENT, @@ -15,13 +15,15 @@ from homeassistant.const import ( STATE_ON, STATE_OFF, TEMP_CELSIUS, + ATTR_TEMPERATURE ) from homeassistant import loader from homeassistant.util.unit_system import METRIC_SYSTEM from homeassistant.util.async import run_coroutine_threadsafe from homeassistant.components import climate, input_boolean, switch import homeassistant.components as comps -from tests.common import assert_setup_component, get_test_home_assistant +from tests.common import (assert_setup_component, get_test_home_assistant, + mock_restore_cache) ENTITY = 'climate.test' @@ -892,3 +894,24 @@ def test_custom_setup_params(hass): assert state.attributes.get('min_temp') == MIN_TEMP assert state.attributes.get('max_temp') == MAX_TEMP assert state.attributes.get('temperature') == TARGET_TEMP + + +@asyncio.coroutine +def test_restore_state(hass): + """Ensure states are restored on startup.""" + mock_restore_cache(hass, ( + State('climate.test_thermostat', '0', {ATTR_TEMPERATURE: "20"}), + )) + + hass.state = CoreState.starting + + yield from async_setup_component( + hass, climate.DOMAIN, {'climate': { + 'platform': 'generic_thermostat', + 'name': 'test_thermostat', + 'heater': ENT_SWITCH, + 'target_sensor': ENT_SENSOR, + }}) + + state = hass.states.get('climate.test_thermostat') + assert(state.attributes[ATTR_TEMPERATURE] == 20) From f43092c563a4153b5e816aba3e0781f45b5e8cad Mon Sep 17 00:00:00 2001 From: Andrey Date: Fri, 17 Nov 2017 18:36:18 +0200 Subject: [PATCH 079/246] Print entity type in "too slow" warnings (#10641) * Update entity.py * Update entity.py --- homeassistant/helpers/entity.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/helpers/entity.py b/homeassistant/helpers/entity.py index 4a967e50995..78db0890ab1 100644 --- a/homeassistant/helpers/entity.py +++ b/homeassistant/helpers/entity.py @@ -235,10 +235,10 @@ class Entity(object): if not self._slow_reported and end - start > 0.4: self._slow_reported = True - _LOGGER.warning("Updating state for %s took %.3f seconds. " + _LOGGER.warning("Updating state for %s (%s) took %.3f seconds. " "Please report platform to the developers at " "https://goo.gl/Nvioub", self.entity_id, - end - start) + type(self), end - start) # Overwrite properties that have been set in the config file. if DATA_CUSTOMIZE in self.hass.data: From 2b60fca08d417912b39063ad315ec7f695aa2e2e Mon Sep 17 00:00:00 2001 From: Robbie Trencheny Date: Fri, 17 Nov 2017 09:14:22 -0800 Subject: [PATCH 080/246] Alexa improvements (#10632) * Initial scene support * Initial fan support * ordering * Initial lock support * Scenes cant be deactivated; Correct the scene display category * Initial input_boolean support * Support customization of Alexa discovered entities * Initial media player support * Add input_boolean to tests * Add play/pause/stop/next/previous to media player * Add missing functions and pylint * Set manufacturerName to Home Assistant since the value is displayed in app * Add scene test * Add fan tests * Add lock test * Fix volume logic * Add volume tests * settup -> setup * Remove unused variable * Set required scene description as per docs * Allow setting scene category (ACTIVITY_TRIGGER/SCENE_TRIGGER) * Add alert, automation and group support/tests * Change display categories to match docs * simplify down the display category props into a single prop which can be used on any entity * Fix tests to expect proper display categories * Add cover support * sort things * Use generic homeassistant domain for turn on/off --- homeassistant/components/alexa/smart_home.py | 334 +++++++++++- tests/components/alexa/test_smart_home.py | 546 ++++++++++++++++++- 2 files changed, 853 insertions(+), 27 deletions(-) diff --git a/homeassistant/components/alexa/smart_home.py b/homeassistant/components/alexa/smart_home.py index a96386cbdf9..c5a849ad560 100644 --- a/homeassistant/components/alexa/smart_home.py +++ b/homeassistant/components/alexa/smart_home.py @@ -4,9 +4,16 @@ import logging import math from uuid import uuid4 +import homeassistant.core as ha from homeassistant.const import ( - ATTR_SUPPORTED_FEATURES, ATTR_ENTITY_ID, SERVICE_TURN_ON, SERVICE_TURN_OFF) -from homeassistant.components import switch, light, script + ATTR_ENTITY_ID, ATTR_SUPPORTED_FEATURES, SERVICE_LOCK, + SERVICE_MEDIA_NEXT_TRACK, SERVICE_MEDIA_PAUSE, SERVICE_MEDIA_PLAY, + SERVICE_MEDIA_PREVIOUS_TRACK, SERVICE_MEDIA_STOP, + SERVICE_SET_COVER_POSITION, SERVICE_TURN_OFF, SERVICE_TURN_ON, + SERVICE_UNLOCK, SERVICE_VOLUME_SET) +from homeassistant.components import ( + alert, automation, cover, fan, group, input_boolean, light, lock, + media_player, scene, script, switch) import homeassistant.util.color as color_util from homeassistant.util.decorator import Registry @@ -14,15 +21,32 @@ HANDLERS = Registry() _LOGGER = logging.getLogger(__name__) API_DIRECTIVE = 'directive' +API_ENDPOINT = 'endpoint' API_EVENT = 'event' API_HEADER = 'header' API_PAYLOAD = 'payload' -API_ENDPOINT = 'endpoint' + +ATTR_ALEXA_DESCRIPTION = 'alexa_description' +ATTR_ALEXA_DISPLAY_CATEGORIES = 'alexa_display_categories' +ATTR_ALEXA_HIDDEN = 'alexa_hidden' +ATTR_ALEXA_NAME = 'alexa_name' MAPPING_COMPONENT = { - script.DOMAIN: ['SWITCH', ('Alexa.PowerController',), None], - switch.DOMAIN: ['SWITCH', ('Alexa.PowerController',), None], + alert.DOMAIN: ['OTHER', ('Alexa.PowerController',), None], + automation.DOMAIN: ['OTHER', ('Alexa.PowerController',), None], + cover.DOMAIN: [ + 'DOOR', ('Alexa.PowerController',), { + cover.SUPPORT_SET_POSITION: 'Alexa.PercentageController', + } + ], + fan.DOMAIN: [ + 'OTHER', ('Alexa.PowerController',), { + fan.SUPPORT_SET_SPEED: 'Alexa.PercentageController', + } + ], + group.DOMAIN: ['OTHER', ('Alexa.PowerController',), None], + input_boolean.DOMAIN: ['OTHER', ('Alexa.PowerController',), None], light.DOMAIN: [ 'LIGHT', ('Alexa.PowerController',), { light.SUPPORT_BRIGHTNESS: 'Alexa.BrightnessController', @@ -31,6 +55,20 @@ MAPPING_COMPONENT = { light.SUPPORT_COLOR_TEMP: 'Alexa.ColorTemperatureController', } ], + lock.DOMAIN: ['SMARTLOCK', ('Alexa.LockController',), None], + media_player.DOMAIN: [ + 'TV', ('Alexa.PowerController',), { + media_player.SUPPORT_VOLUME_SET: 'Alexa.Speaker', + media_player.SUPPORT_PLAY: 'Alexa.PlaybackController', + media_player.SUPPORT_PAUSE: 'Alexa.PlaybackController', + media_player.SUPPORT_STOP: 'Alexa.PlaybackController', + media_player.SUPPORT_NEXT_TRACK: 'Alexa.PlaybackController', + media_player.SUPPORT_PREVIOUS_TRACK: 'Alexa.PlaybackController', + } + ], + scene.DOMAIN: ['ACTIVITY_TRIGGER', ('Alexa.SceneController',), None], + script.DOMAIN: ['OTHER', ('Alexa.PowerController',), None], + switch.DOMAIN: ['SWITCH', ('Alexa.PowerController',), None], } @@ -108,18 +146,33 @@ def async_api_discovery(hass, request): discovery_endpoints = [] for entity in hass.states.async_all(): + if entity.attributes.get(ATTR_ALEXA_HIDDEN, False): + continue + class_data = MAPPING_COMPONENT.get(entity.domain) if not class_data: continue + friendly_name = entity.attributes.get(ATTR_ALEXA_NAME, entity.name) + description = entity.attributes.get(ATTR_ALEXA_DESCRIPTION, + entity.entity_id) + + # Required description as per Amazon Scene docs + if entity.domain == scene.DOMAIN: + scene_fmt = '%s (Scene connected via Home Assistant)' + description = scene_fmt.format(description) + + cat_key = ATTR_ALEXA_DISPLAY_CATEGORIES + display_categories = entity.attributes.get(cat_key, class_data[0]) + endpoint = { - 'displayCategories': [class_data[0]], + 'displayCategories': [display_categories], 'additionalApplianceDetails': {}, 'endpointId': entity.entity_id.replace('.', '#'), - 'friendlyName': entity.name, - 'description': '', - 'manufacturerName': 'Unknown', + 'friendlyName': friendly_name, + 'description': description, + 'manufacturerName': 'Home Assistant', } actions = set() @@ -175,7 +228,7 @@ def extract_entity(funct): @asyncio.coroutine def async_api_turn_on(hass, request, entity): """Process a turn on request.""" - yield from hass.services.async_call(entity.domain, SERVICE_TURN_ON, { + yield from hass.services.async_call(ha.DOMAIN, SERVICE_TURN_ON, { ATTR_ENTITY_ID: entity.entity_id }, blocking=True) @@ -187,7 +240,7 @@ def async_api_turn_on(hass, request, entity): @asyncio.coroutine def async_api_turn_off(hass, request, entity): """Process a turn off request.""" - yield from hass.services.async_call(entity.domain, SERVICE_TURN_OFF, { + yield from hass.services.async_call(ha.DOMAIN, SERVICE_TURN_OFF, { ATTR_ENTITY_ID: entity.entity_id }, blocking=True) @@ -310,3 +363,262 @@ def async_api_increase_color_temp(hass, request, entity): }, blocking=True) return api_message(request) + + +@HANDLERS.register(('Alexa.SceneController', 'Activate')) +@extract_entity +@asyncio.coroutine +def async_api_activate(hass, request, entity): + """Process a activate request.""" + yield from hass.services.async_call(entity.domain, SERVICE_TURN_ON, { + ATTR_ENTITY_ID: entity.entity_id + }, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.PercentageController', 'SetPercentage')) +@extract_entity +@asyncio.coroutine +def async_api_set_percentage(hass, request, entity): + """Process a set percentage request.""" + percentage = int(request[API_PAYLOAD]['percentage']) + service = None + data = {ATTR_ENTITY_ID: entity.entity_id} + + if entity.domain == fan.DOMAIN: + service = fan.SERVICE_SET_SPEED + speed = "off" + + if percentage <= 33: + speed = "low" + elif percentage <= 66: + speed = "medium" + elif percentage <= 100: + speed = "high" + data[fan.ATTR_SPEED] = speed + + elif entity.domain == cover.DOMAIN: + service = SERVICE_SET_COVER_POSITION + data[cover.ATTR_POSITION] = percentage + + yield from hass.services.async_call(entity.domain, service, + data, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.PercentageController', 'AdjustPercentage')) +@extract_entity +@asyncio.coroutine +def async_api_adjust_percentage(hass, request, entity): + """Process a adjust percentage request.""" + percentage_delta = int(request[API_PAYLOAD]['percentageDelta']) + service = None + data = {ATTR_ENTITY_ID: entity.entity_id} + + if entity.domain == fan.DOMAIN: + service = fan.SERVICE_SET_SPEED + speed = entity.attributes.get(fan.ATTR_SPEED) + + if speed == "off": + current = 0 + elif speed == "low": + current = 33 + elif speed == "medium": + current = 66 + elif speed == "high": + current = 100 + + # set percentage + percentage = max(0, percentage_delta + current) + speed = "off" + + if percentage <= 33: + speed = "low" + elif percentage <= 66: + speed = "medium" + elif percentage <= 100: + speed = "high" + + data[fan.ATTR_SPEED] = speed + + elif entity.domain == cover.DOMAIN: + service = SERVICE_SET_COVER_POSITION + + current = entity.attributes.get(cover.ATTR_POSITION) + + data[cover.ATTR_POSITION] = max(0, percentage_delta + current) + + yield from hass.services.async_call(entity.domain, service, + data, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.LockController', 'Lock')) +@extract_entity +@asyncio.coroutine +def async_api_lock(hass, request, entity): + """Process a lock request.""" + yield from hass.services.async_call(entity.domain, SERVICE_LOCK, { + ATTR_ENTITY_ID: entity.entity_id + }, blocking=True) + + return api_message(request) + + +# Not supported by Alexa yet +@HANDLERS.register(('Alexa.LockController', 'Unlock')) +@extract_entity +@asyncio.coroutine +def async_api_unlock(hass, request, entity): + """Process a unlock request.""" + yield from hass.services.async_call(entity.domain, SERVICE_UNLOCK, { + ATTR_ENTITY_ID: entity.entity_id + }, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.Speaker', 'SetVolume')) +@extract_entity +@asyncio.coroutine +def async_api_set_volume(hass, request, entity): + """Process a set volume request.""" + volume = round(float(request[API_PAYLOAD]['volume'] / 100), 2) + + data = { + ATTR_ENTITY_ID: entity.entity_id, + media_player.ATTR_MEDIA_VOLUME_LEVEL: volume, + } + + yield from hass.services.async_call(entity.domain, SERVICE_VOLUME_SET, + data, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.Speaker', 'AdjustVolume')) +@extract_entity +@asyncio.coroutine +def async_api_adjust_volume(hass, request, entity): + """Process a adjust volume request.""" + volume_delta = int(request[API_PAYLOAD]['volume']) + + current_level = entity.attributes.get(media_player.ATTR_MEDIA_VOLUME_LEVEL) + + # read current state + try: + current = math.floor(int(current_level * 100)) + except ZeroDivisionError: + current = 0 + + volume = float(max(0, volume_delta + current) / 100) + + data = { + ATTR_ENTITY_ID: entity.entity_id, + media_player.ATTR_MEDIA_VOLUME_LEVEL: volume, + } + + yield from hass.services.async_call(entity.domain, + media_player.SERVICE_VOLUME_SET, + data, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.Speaker', 'SetMute')) +@extract_entity +@asyncio.coroutine +def async_api_set_mute(hass, request, entity): + """Process a set mute request.""" + mute = bool(request[API_PAYLOAD]['mute']) + + data = { + ATTR_ENTITY_ID: entity.entity_id, + media_player.ATTR_MEDIA_VOLUME_MUTED: mute, + } + + yield from hass.services.async_call(entity.domain, + media_player.SERVICE_VOLUME_MUTE, + data, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.PlaybackController', 'Play')) +@extract_entity +@asyncio.coroutine +def async_api_play(hass, request, entity): + """Process a play request.""" + data = { + ATTR_ENTITY_ID: entity.entity_id + } + + yield from hass.services.async_call(entity.domain, SERVICE_MEDIA_PLAY, + data, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.PlaybackController', 'Pause')) +@extract_entity +@asyncio.coroutine +def async_api_pause(hass, request, entity): + """Process a pause request.""" + data = { + ATTR_ENTITY_ID: entity.entity_id + } + + yield from hass.services.async_call(entity.domain, SERVICE_MEDIA_PAUSE, + data, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.PlaybackController', 'Stop')) +@extract_entity +@asyncio.coroutine +def async_api_stop(hass, request, entity): + """Process a stop request.""" + data = { + ATTR_ENTITY_ID: entity.entity_id + } + + yield from hass.services.async_call(entity.domain, SERVICE_MEDIA_STOP, + data, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.PlaybackController', 'Next')) +@extract_entity +@asyncio.coroutine +def async_api_next(hass, request, entity): + """Process a next request.""" + data = { + ATTR_ENTITY_ID: entity.entity_id + } + + yield from hass.services.async_call(entity.domain, + SERVICE_MEDIA_NEXT_TRACK, + data, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.PlaybackController', 'Previous')) +@extract_entity +@asyncio.coroutine +def async_api_previous(hass, request, entity): + """Process a previous request.""" + data = { + ATTR_ENTITY_ID: entity.entity_id + } + + yield from hass.services.async_call(entity.domain, + SERVICE_MEDIA_PREVIOUS_TRACK, + data, blocking=True) + + return api_message(request) diff --git a/tests/components/alexa/test_smart_home.py b/tests/components/alexa/test_smart_home.py index eadb72f91c0..3fe9145f2d6 100644 --- a/tests/components/alexa/test_smart_home.py +++ b/tests/components/alexa/test_smart_home.py @@ -99,7 +99,7 @@ def test_discovery_request(hass): """Test alexa discovery request.""" request = get_new_request('Alexa.Discovery', 'Discover') - # settup test devices + # setup test devices hass.states.async_set( 'switch.test', 'on', {'friendly_name': "Test switch"}) @@ -117,12 +117,52 @@ def test_discovery_request(hass): hass.states.async_set( 'script.test', 'off', {'friendly_name': "Test script"}) + hass.states.async_set( + 'input_boolean.test', 'off', {'friendly_name': "Test input boolean"}) + + hass.states.async_set( + 'scene.test', 'off', {'friendly_name': "Test scene"}) + + hass.states.async_set( + 'fan.test_1', 'off', {'friendly_name': "Test fan 1"}) + + hass.states.async_set( + 'fan.test_2', 'off', { + 'friendly_name': "Test fan 2", 'supported_features': 1, + 'speed_list': ['low', 'medium', 'high'] + }) + + hass.states.async_set( + 'lock.test', 'off', {'friendly_name': "Test lock"}) + + hass.states.async_set( + 'media_player.test', 'off', { + 'friendly_name': "Test media player", + 'supported_features': 20925, + 'volume_level': 1 + }) + + hass.states.async_set( + 'alert.test', 'off', {'friendly_name': "Test alert"}) + + hass.states.async_set( + 'automation.test', 'off', {'friendly_name': "Test automation"}) + + hass.states.async_set( + 'group.test', 'off', {'friendly_name': "Test group"}) + + hass.states.async_set( + 'cover.test', 'off', { + 'friendly_name': "Test cover", 'supported_features': 255, + 'position': 85 + }) + msg = yield from smart_home.async_handle_message(hass, request) assert 'event' in msg msg = msg['event'] - assert len(msg['payload']['endpoints']) == 5 + assert len(msg['payload']['endpoints']) == 15 assert msg['header']['name'] == 'Discover.Response' assert msg['header']['namespace'] == 'Alexa.Discovery' @@ -174,13 +214,108 @@ def test_discovery_request(hass): continue if appliance['endpointId'] == 'script#test': - assert appliance['displayCategories'][0] == "SWITCH" + assert appliance['displayCategories'][0] == "OTHER" assert appliance['friendlyName'] == "Test script" assert len(appliance['capabilities']) == 1 assert appliance['capabilities'][-1]['interface'] == \ 'Alexa.PowerController' continue + if appliance['endpointId'] == 'input_boolean#test': + assert appliance['displayCategories'][0] == "OTHER" + assert appliance['friendlyName'] == "Test input boolean" + assert len(appliance['capabilities']) == 1 + assert appliance['capabilities'][-1]['interface'] == \ + 'Alexa.PowerController' + continue + + if appliance['endpointId'] == 'scene#test': + assert appliance['displayCategories'][0] == "ACTIVITY_TRIGGER" + assert appliance['friendlyName'] == "Test scene" + assert len(appliance['capabilities']) == 1 + assert appliance['capabilities'][-1]['interface'] == \ + 'Alexa.SceneController' + continue + + if appliance['endpointId'] == 'fan#test_1': + assert appliance['displayCategories'][0] == "OTHER" + assert appliance['friendlyName'] == "Test fan 1" + assert len(appliance['capabilities']) == 1 + assert appliance['capabilities'][-1]['interface'] == \ + 'Alexa.PowerController' + continue + + if appliance['endpointId'] == 'fan#test_2': + assert appliance['displayCategories'][0] == "OTHER" + assert appliance['friendlyName'] == "Test fan 2" + assert len(appliance['capabilities']) == 2 + + caps = set() + for feature in appliance['capabilities']: + caps.add(feature['interface']) + + assert 'Alexa.PercentageController' in caps + assert 'Alexa.PowerController' in caps + continue + + if appliance['endpointId'] == 'lock#test': + assert appliance['displayCategories'][0] == "SMARTLOCK" + assert appliance['friendlyName'] == "Test lock" + assert len(appliance['capabilities']) == 1 + assert appliance['capabilities'][-1]['interface'] == \ + 'Alexa.LockController' + continue + + if appliance['endpointId'] == 'media_player#test': + assert appliance['displayCategories'][0] == "TV" + assert appliance['friendlyName'] == "Test media player" + assert len(appliance['capabilities']) == 3 + caps = set() + for feature in appliance['capabilities']: + caps.add(feature['interface']) + + assert 'Alexa.PowerController' in caps + assert 'Alexa.Speaker' in caps + assert 'Alexa.PlaybackController' in caps + continue + + if appliance['endpointId'] == 'alert#test': + assert appliance['displayCategories'][0] == "OTHER" + assert appliance['friendlyName'] == "Test alert" + assert len(appliance['capabilities']) == 1 + assert appliance['capabilities'][-1]['interface'] == \ + 'Alexa.PowerController' + continue + + if appliance['endpointId'] == 'automation#test': + assert appliance['displayCategories'][0] == "OTHER" + assert appliance['friendlyName'] == "Test automation" + assert len(appliance['capabilities']) == 1 + assert appliance['capabilities'][-1]['interface'] == \ + 'Alexa.PowerController' + continue + + if appliance['endpointId'] == 'group#test': + assert appliance['displayCategories'][0] == "OTHER" + assert appliance['friendlyName'] == "Test group" + assert len(appliance['capabilities']) == 1 + assert appliance['capabilities'][-1]['interface'] == \ + 'Alexa.PowerController' + continue + + if appliance['endpointId'] == 'cover#test': + assert appliance['displayCategories'][0] == "DOOR" + assert appliance['friendlyName'] == "Test cover" + assert len(appliance['capabilities']) == 2 + + caps = set() + for feature in appliance['capabilities']: + caps.add(feature['interface']) + + assert 'Alexa.PercentageController' in caps + assert 'Alexa.PowerController' in caps + continue + raise AssertionError("Unknown appliance!") @@ -217,19 +352,21 @@ def test_api_function_not_implemented(hass): @asyncio.coroutine -@pytest.mark.parametrize("domain", ['light', 'switch', 'script']) +@pytest.mark.parametrize("domain", ['alert', 'automation', 'group', + 'input_boolean', 'light', 'script', + 'switch']) def test_api_turn_on(hass, domain): """Test api turn on process.""" request = get_new_request( 'Alexa.PowerController', 'TurnOn', '{}#test'.format(domain)) - # settup test devices + # setup test devices hass.states.async_set( '{}.test'.format(domain), 'off', { 'friendly_name': "Test {}".format(domain) }) - call = async_mock_service(hass, domain, 'turn_on') + call = async_mock_service(hass, 'homeassistant', 'turn_on') msg = yield from smart_home.async_handle_message(hass, request) @@ -242,19 +379,21 @@ def test_api_turn_on(hass, domain): @asyncio.coroutine -@pytest.mark.parametrize("domain", ['light', 'switch', 'script']) +@pytest.mark.parametrize("domain", ['alert', 'automation', 'group', + 'input_boolean', 'light', 'script', + 'switch']) def test_api_turn_off(hass, domain): """Test api turn on process.""" request = get_new_request( 'Alexa.PowerController', 'TurnOff', '{}#test'.format(domain)) - # settup test devices + # setup test devices hass.states.async_set( '{}.test'.format(domain), 'on', { 'friendly_name': "Test {}".format(domain) }) - call = async_mock_service(hass, domain, 'turn_off') + call = async_mock_service(hass, 'homeassistant', 'turn_off') msg = yield from smart_home.async_handle_message(hass, request) @@ -275,7 +414,7 @@ def test_api_set_brightness(hass): # add payload request['directive']['payload']['brightness'] = '50' - # settup test devices + # setup test devices hass.states.async_set( 'light.test', 'off', {'friendly_name': "Test light"}) @@ -303,7 +442,7 @@ def test_api_adjust_brightness(hass, result, adjust): # add payload request['directive']['payload']['brightnessDelta'] = adjust - # settup test devices + # setup test devices hass.states.async_set( 'light.test', 'off', { 'friendly_name': "Test light", 'brightness': '77' @@ -335,7 +474,7 @@ def test_api_set_color_rgb(hass): 'brightness': '0.342', } - # settup test devices + # setup test devices hass.states.async_set( 'light.test', 'off', { 'friendly_name': "Test light", @@ -368,7 +507,7 @@ def test_api_set_color_xy(hass): 'brightness': '0.342', } - # settup test devices + # setup test devices hass.states.async_set( 'light.test', 'off', { 'friendly_name': "Test light", @@ -399,7 +538,7 @@ def test_api_set_color_temperature(hass): # add payload request['directive']['payload']['colorTemperatureInKelvin'] = '7500' - # settup test devices + # setup test devices hass.states.async_set( 'light.test', 'off', {'friendly_name': "Test light"}) @@ -424,7 +563,7 @@ def test_api_decrease_color_temp(hass, result, initial): 'Alexa.ColorTemperatureController', 'DecreaseColorTemperature', 'light#test') - # settup test devices + # setup test devices hass.states.async_set( 'light.test', 'off', { 'friendly_name': "Test light", 'color_temp': initial, @@ -452,7 +591,7 @@ def test_api_increase_color_temp(hass, result, initial): 'Alexa.ColorTemperatureController', 'IncreaseColorTemperature', 'light#test') - # settup test devices + # setup test devices hass.states.async_set( 'light.test', 'off', { 'friendly_name': "Test light", 'color_temp': initial, @@ -470,3 +609,378 @@ def test_api_increase_color_temp(hass, result, initial): assert call_light[0].data['entity_id'] == 'light.test' assert call_light[0].data['color_temp'] == result assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize("domain", ['scene']) +def test_api_activate(hass, domain): + """Test api activate process.""" + request = get_new_request( + 'Alexa.SceneController', 'Activate', '{}#test'.format(domain)) + + # setup test devices + hass.states.async_set( + '{}.test'.format(domain), 'off', { + 'friendly_name': "Test {}".format(domain) + }) + + call = async_mock_service(hass, domain, 'turn_on') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call) == 1 + assert call[0].data['entity_id'] == '{}.test'.format(domain) + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +def test_api_set_percentage_fan(hass): + """Test api set percentage for fan process.""" + request = get_new_request( + 'Alexa.PercentageController', 'SetPercentage', 'fan#test_2') + + # add payload + request['directive']['payload']['percentage'] = '50' + + # setup test devices + hass.states.async_set( + 'fan.test_2', 'off', {'friendly_name': "Test fan"}) + + call_fan = async_mock_service(hass, 'fan', 'set_speed') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call_fan) == 1 + assert call_fan[0].data['entity_id'] == 'fan.test_2' + assert call_fan[0].data['speed'] == 'medium' + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +def test_api_set_percentage_cover(hass): + """Test api set percentage for cover process.""" + request = get_new_request( + 'Alexa.PercentageController', 'SetPercentage', 'cover#test') + + # add payload + request['directive']['payload']['percentage'] = '50' + + # setup test devices + hass.states.async_set( + 'cover.test', 'closed', { + 'friendly_name': "Test cover" + }) + + call_cover = async_mock_service(hass, 'cover', 'set_cover_position') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call_cover) == 1 + assert call_cover[0].data['entity_id'] == 'cover.test' + assert call_cover[0].data['position'] == 50 + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize( + "result,adjust", [('high', '-5'), ('off', '5'), ('low', '-80')]) +def test_api_adjust_percentage_fan(hass, result, adjust): + """Test api adjust percentage for fan process.""" + request = get_new_request( + 'Alexa.PercentageController', 'AdjustPercentage', 'fan#test_2') + + # add payload + request['directive']['payload']['percentageDelta'] = adjust + + # setup test devices + hass.states.async_set( + 'fan.test_2', 'on', { + 'friendly_name': "Test fan 2", 'speed': 'high' + }) + + call_fan = async_mock_service(hass, 'fan', 'set_speed') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call_fan) == 1 + assert call_fan[0].data['entity_id'] == 'fan.test_2' + assert call_fan[0].data['speed'] == result + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize( + "result,adjust", [(25, '-5'), (35, '5'), (0, '-80')]) +def test_api_adjust_percentage_cover(hass, result, adjust): + """Test api adjust percentage for cover process.""" + request = get_new_request( + 'Alexa.PercentageController', 'AdjustPercentage', 'cover#test') + + # add payload + request['directive']['payload']['percentageDelta'] = adjust + + # setup test devices + hass.states.async_set( + 'cover.test', 'closed', { + 'friendly_name': "Test cover", + 'position': 30 + }) + + call_cover = async_mock_service(hass, 'cover', 'set_cover_position') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call_cover) == 1 + assert call_cover[0].data['entity_id'] == 'cover.test' + assert call_cover[0].data['position'] == result + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize("domain", ['lock']) +def test_api_lock(hass, domain): + """Test api lock process.""" + request = get_new_request( + 'Alexa.LockController', 'Lock', '{}#test'.format(domain)) + + # setup test devices + hass.states.async_set( + '{}.test'.format(domain), 'off', { + 'friendly_name': "Test {}".format(domain) + }) + + call = async_mock_service(hass, domain, 'lock') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call) == 1 + assert call[0].data['entity_id'] == '{}.test'.format(domain) + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize("domain", ['media_player']) +def test_api_play(hass, domain): + """Test api play process.""" + request = get_new_request( + 'Alexa.PlaybackController', 'Play', '{}#test'.format(domain)) + + # setup test devices + hass.states.async_set( + '{}.test'.format(domain), 'off', { + 'friendly_name': "Test {}".format(domain) + }) + + call = async_mock_service(hass, domain, 'media_play') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call) == 1 + assert call[0].data['entity_id'] == '{}.test'.format(domain) + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize("domain", ['media_player']) +def test_api_pause(hass, domain): + """Test api pause process.""" + request = get_new_request( + 'Alexa.PlaybackController', 'Pause', '{}#test'.format(domain)) + + # setup test devices + hass.states.async_set( + '{}.test'.format(domain), 'off', { + 'friendly_name': "Test {}".format(domain) + }) + + call = async_mock_service(hass, domain, 'media_pause') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call) == 1 + assert call[0].data['entity_id'] == '{}.test'.format(domain) + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize("domain", ['media_player']) +def test_api_stop(hass, domain): + """Test api stop process.""" + request = get_new_request( + 'Alexa.PlaybackController', 'Stop', '{}#test'.format(domain)) + + # setup test devices + hass.states.async_set( + '{}.test'.format(domain), 'off', { + 'friendly_name': "Test {}".format(domain) + }) + + call = async_mock_service(hass, domain, 'media_stop') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call) == 1 + assert call[0].data['entity_id'] == '{}.test'.format(domain) + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize("domain", ['media_player']) +def test_api_next(hass, domain): + """Test api next process.""" + request = get_new_request( + 'Alexa.PlaybackController', 'Next', '{}#test'.format(domain)) + + # setup test devices + hass.states.async_set( + '{}.test'.format(domain), 'off', { + 'friendly_name': "Test {}".format(domain) + }) + + call = async_mock_service(hass, domain, 'media_next_track') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call) == 1 + assert call[0].data['entity_id'] == '{}.test'.format(domain) + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize("domain", ['media_player']) +def test_api_previous(hass, domain): + """Test api previous process.""" + request = get_new_request( + 'Alexa.PlaybackController', 'Previous', '{}#test'.format(domain)) + + # setup test devices + hass.states.async_set( + '{}.test'.format(domain), 'off', { + 'friendly_name': "Test {}".format(domain) + }) + + call = async_mock_service(hass, domain, 'media_previous_track') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call) == 1 + assert call[0].data['entity_id'] == '{}.test'.format(domain) + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +def test_api_set_volume(hass): + """Test api set volume process.""" + request = get_new_request( + 'Alexa.Speaker', 'SetVolume', 'media_player#test') + + # add payload + request['directive']['payload']['volume'] = 50 + + # setup test devices + hass.states.async_set( + 'media_player.test', 'off', { + 'friendly_name': "Test media player", 'volume_level': 0 + }) + + call_media_player = async_mock_service(hass, 'media_player', 'volume_set') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call_media_player) == 1 + assert call_media_player[0].data['entity_id'] == 'media_player.test' + assert call_media_player[0].data['volume_level'] == 0.5 + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize( + "result,adjust", [(0.7, '-5'), (0.8, '5'), (0, '-80')]) +def test_api_adjust_volume(hass, result, adjust): + """Test api adjust volume process.""" + request = get_new_request( + 'Alexa.Speaker', 'AdjustVolume', 'media_player#test') + + # add payload + request['directive']['payload']['volume'] = adjust + + # setup test devices + hass.states.async_set( + 'media_player.test', 'off', { + 'friendly_name': "Test media player", 'volume_level': 0.75 + }) + + call_media_player = async_mock_service(hass, 'media_player', 'volume_set') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call_media_player) == 1 + assert call_media_player[0].data['entity_id'] == 'media_player.test' + assert call_media_player[0].data['volume_level'] == result + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize("domain", ['media_player']) +def test_api_mute(hass, domain): + """Test api mute process.""" + request = get_new_request( + 'Alexa.Speaker', 'SetMute', '{}#test'.format(domain)) + + request['directive']['payload']['mute'] = True + + # setup test devices + hass.states.async_set( + '{}.test'.format(domain), 'off', { + 'friendly_name': "Test {}".format(domain) + }) + + call = async_mock_service(hass, domain, 'volume_mute') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call) == 1 + assert call[0].data['entity_id'] == '{}.test'.format(domain) + assert msg['header']['name'] == 'Response' From b8b4e3275842c4780efc5685df45853820372c45 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cezar=20S=C3=A1=20Espinola?= Date: Fri, 17 Nov 2017 16:29:23 -0200 Subject: [PATCH 081/246] Make MQTT reconnection logic more resilient and fix race condition (#10133) --- homeassistant/components/mqtt/__init__.py | 34 ++++++++--------------- tests/components/mqtt/test_init.py | 28 ++++++++++++------- 2 files changed, 30 insertions(+), 32 deletions(-) diff --git a/homeassistant/components/mqtt/__init__.py b/homeassistant/components/mqtt/__init__.py index 9decc9a14aa..3a6abec0ddf 100644 --- a/homeassistant/components/mqtt/__init__.py +++ b/homeassistant/components/mqtt/__init__.py @@ -438,7 +438,8 @@ class MQTT(object): self.broker = broker self.port = port self.keepalive = keepalive - self.topics = {} + self.wanted_topics = {} + self.subscribed_topics = {} self.progress = {} self.birth_message = birth_message self._mqttc = None @@ -526,15 +527,14 @@ class MQTT(object): raise HomeAssistantError("topic need to be a string!") with (yield from self._paho_lock): - if topic in self.topics: + if topic in self.subscribed_topics: return - + self.wanted_topics[topic] = qos result, mid = yield from self.hass.async_add_job( self._mqttc.subscribe, topic, qos) _raise_on_error(result) self.progress[mid] = topic - self.topics[topic] = None @asyncio.coroutine def async_unsubscribe(self, topic): @@ -542,6 +542,7 @@ class MQTT(object): This method is a coroutine. """ + self.wanted_topics.pop(topic, None) result, mid = yield from self.hass.async_add_job( self._mqttc.unsubscribe, topic) @@ -562,15 +563,10 @@ class MQTT(object): self._mqttc.disconnect() return - old_topics = self.topics - - self.topics = {key: value for key, value in self.topics.items() - if value is None} - - for topic, qos in old_topics.items(): - # qos is None if we were in process of subscribing - if qos is not None: - self.hass.add_job(self.async_subscribe, topic, qos) + self.progress = {} + self.subscribed_topics = {} + for topic, qos in self.wanted_topics.items(): + self.hass.add_job(self.async_subscribe, topic, qos) if self.birth_message: self.hass.add_job(self.async_publish( @@ -584,7 +580,7 @@ class MQTT(object): topic = self.progress.pop(mid, None) if topic is None: return - self.topics[topic] = granted_qos[0] + self.subscribed_topics[topic] = granted_qos[0] def _mqtt_on_message(self, _mqttc, _userdata, msg): """Message received callback.""" @@ -598,18 +594,12 @@ class MQTT(object): topic = self.progress.pop(mid, None) if topic is None: return - self.topics.pop(topic, None) + self.subscribed_topics.pop(topic, None) def _mqtt_on_disconnect(self, _mqttc, _userdata, result_code): """Disconnected callback.""" self.progress = {} - self.topics = {key: value for key, value in self.topics.items() - if value is not None} - - # Remove None values from topic list - for key in list(self.topics): - if self.topics[key] is None: - self.topics.pop(key) + self.subscribed_topics = {} # When disconnected because of calling disconnect() if result_code == 0: diff --git a/tests/components/mqtt/test_init.py b/tests/components/mqtt/test_init.py index 3d068224243..55ff0e9ff05 100644 --- a/tests/components/mqtt/test_init.py +++ b/tests/components/mqtt/test_init.py @@ -388,9 +388,12 @@ class TestMQTTCallbacks(unittest.TestCase): @mock.patch('homeassistant.components.mqtt.time.sleep') def test_mqtt_disconnect_tries_reconnect(self, mock_sleep): """Test the re-connect tries.""" - self.hass.data['mqtt'].topics = { + self.hass.data['mqtt'].subscribed_topics = { 'test/topic': 1, - 'test/progress': None + } + self.hass.data['mqtt'].wanted_topics = { + 'test/progress': 0, + 'test/topic': 2, } self.hass.data['mqtt'].progress = { 1: 'test/progress' @@ -403,7 +406,9 @@ class TestMQTTCallbacks(unittest.TestCase): self.assertEqual([1, 2, 4], [call[1][0] for call in mock_sleep.mock_calls]) - self.assertEqual({'test/topic': 1}, self.hass.data['mqtt'].topics) + self.assertEqual({'test/topic': 2, 'test/progress': 0}, + self.hass.data['mqtt'].wanted_topics) + self.assertEqual({}, self.hass.data['mqtt'].subscribed_topics) self.assertEqual({}, self.hass.data['mqtt'].progress) def test_invalid_mqtt_topics(self): @@ -556,12 +561,15 @@ def test_mqtt_subscribes_topics_on_connect(hass): """Test subscription to topic on connect.""" mqtt_client = yield from mock_mqtt_client(hass) - prev_topics = OrderedDict() - prev_topics['topic/test'] = 1, - prev_topics['home/sensor'] = 2, - prev_topics['still/pending'] = None + subscribed_topics = OrderedDict() + subscribed_topics['topic/test'] = 1 + subscribed_topics['home/sensor'] = 2 - hass.data['mqtt'].topics = prev_topics + wanted_topics = subscribed_topics.copy() + wanted_topics['still/pending'] = 0 + + hass.data['mqtt'].wanted_topics = wanted_topics + hass.data['mqtt'].subscribed_topics = subscribed_topics hass.data['mqtt'].progress = {1: 'still/pending'} # Return values for subscribe calls (rc, mid) @@ -574,7 +582,7 @@ def test_mqtt_subscribes_topics_on_connect(hass): assert not mqtt_client.disconnect.called - expected = [(topic, qos) for topic, qos in prev_topics.items() - if qos is not None] + expected = [(topic, qos) for topic, qos in wanted_topics.items()] assert [call[1][1:] for call in hass.add_job.mock_calls] == expected + assert hass.data['mqtt'].progress == {} From 5b44e83c0f9eee653b9173eeba21a7e368e4e21d Mon Sep 17 00:00:00 2001 From: Giel Janssens Date: Fri, 17 Nov 2017 19:31:08 +0100 Subject: [PATCH 082/246] Update lnetatmo (#10631) --- homeassistant/components/netatmo.py | 2 +- requirements_all.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/netatmo.py b/homeassistant/components/netatmo.py index 606c9eef5b0..82b1b1163c3 100644 --- a/homeassistant/components/netatmo.py +++ b/homeassistant/components/netatmo.py @@ -18,7 +18,7 @@ from homeassistant.util import Throttle REQUIREMENTS = [ 'https://github.com/jabesq/netatmo-api-python/archive/' - 'v0.9.2.zip#lnetatmo==0.9.2'] + 'v0.9.2.zip#lnetatmo==0.9.2.1'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index 04432aa26a2..5ad07d15ef7 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -352,7 +352,7 @@ https://github.com/aparraga/braviarc/archive/0.3.7.zip#braviarc==0.3.7 https://github.com/happyleavesaoc/spotipy/archive/544614f4b1d508201d363e84e871f86c90aa26b2.zip#spotipy==2.4.4 # homeassistant.components.netatmo -https://github.com/jabesq/netatmo-api-python/archive/v0.9.2.zip#lnetatmo==0.9.2 +https://github.com/jabesq/netatmo-api-python/archive/v0.9.2.zip#lnetatmo==0.9.2.1 # homeassistant.components.neato https://github.com/jabesq/pybotvac/archive/v0.0.3.zip#pybotvac==0.0.3 From 2664ca498e31913d37572a8b876b0a66ad54f7da Mon Sep 17 00:00:00 2001 From: William Scanlon Date: Fri, 17 Nov 2017 14:47:40 -0500 Subject: [PATCH 083/246] Support for Unifi direct access device tracker (No unifi controller software) (#10097) --- .../components/device_tracker/unifi_direct.py | 134 ++++++++++++++ requirements_all.txt | 1 + requirements_test_all.txt | 1 + .../device_tracker/test_unifi_direct.py | 172 ++++++++++++++++++ tests/fixtures/unifi_direct.txt | 1 + 5 files changed, 309 insertions(+) create mode 100644 homeassistant/components/device_tracker/unifi_direct.py create mode 100644 tests/components/device_tracker/test_unifi_direct.py create mode 100644 tests/fixtures/unifi_direct.txt diff --git a/homeassistant/components/device_tracker/unifi_direct.py b/homeassistant/components/device_tracker/unifi_direct.py new file mode 100644 index 00000000000..57a0186a2e2 --- /dev/null +++ b/homeassistant/components/device_tracker/unifi_direct.py @@ -0,0 +1,134 @@ +""" +Support for Unifi AP direct access. + +For more details about this platform, please refer to the documentation at +https://home-assistant.io/components/device_tracker.unifi_direct/ +""" +import logging +import json + +import voluptuous as vol + +import homeassistant.helpers.config_validation as cv +from homeassistant.components.device_tracker import ( + DOMAIN, PLATFORM_SCHEMA, DeviceScanner) +from homeassistant.const import ( + CONF_HOST, CONF_PASSWORD, CONF_USERNAME, + CONF_PORT) + +REQUIREMENTS = ['pexpect==4.0.1'] + +_LOGGER = logging.getLogger(__name__) + +DEFAULT_SSH_PORT = 22 +UNIFI_COMMAND = 'mca-dump | tr -d "\n"' +UNIFI_SSID_TABLE = "vap_table" +UNIFI_CLIENT_TABLE = "sta_table" + +PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ + vol.Required(CONF_HOST): cv.string, + vol.Required(CONF_PASSWORD): cv.string, + vol.Required(CONF_USERNAME): cv.string, + vol.Optional(CONF_PORT, default=DEFAULT_SSH_PORT): cv.port +}) + + +# pylint: disable=unused-argument +def get_scanner(hass, config): + """Validate the configuration and return a Unifi direct scanner.""" + scanner = UnifiDeviceScanner(config[DOMAIN]) + if not scanner.connected: + return False + return scanner + + +class UnifiDeviceScanner(DeviceScanner): + """This class queries Unifi wireless access point.""" + + def __init__(self, config): + """Initialize the scanner.""" + self.host = config[CONF_HOST] + self.username = config[CONF_USERNAME] + self.password = config[CONF_PASSWORD] + self.port = config[CONF_PORT] + self.ssh = None + self.connected = False + self.last_results = {} + self._connect() + + def scan_devices(self): + """Scan for new devices and return a list with found device IDs.""" + result = _response_to_json(self._get_update()) + if result: + self.last_results = result + return self.last_results.keys() + + def get_device_name(self, device): + """Return the name of the given device or None if we don't know.""" + hostname = next(( + value.get('hostname') for key, value in self.last_results.items() + if key.upper() == device.upper()), None) + if hostname is not None: + hostname = str(hostname) + return hostname + + def _connect(self): + """Connect to the Unifi AP SSH server.""" + from pexpect import pxssh, exceptions + + self.ssh = pxssh.pxssh() + try: + self.ssh.login(self.host, self.username, + password=self.password, port=self.port) + self.connected = True + except exceptions.EOF: + _LOGGER.error("Connection refused. SSH enabled?") + self._disconnect() + + def _disconnect(self): + """Disconnect the current SSH connection.""" + # pylint: disable=broad-except + try: + self.ssh.logout() + except Exception: + pass + finally: + self.ssh = None + + self.connected = False + + def _get_update(self): + from pexpect import pxssh + + try: + if not self.connected: + self._connect() + self.ssh.sendline(UNIFI_COMMAND) + self.ssh.prompt() + return self.ssh.before + except pxssh.ExceptionPxssh as err: + _LOGGER.error("Unexpected SSH error: %s", str(err)) + self._disconnect() + return None + except AssertionError as err: + _LOGGER.error("Connection to AP unavailable: %s", str(err)) + self._disconnect() + return None + + +def _response_to_json(response): + try: + json_response = json.loads(str(response)[31:-1].replace("\\", "")) + _LOGGER.debug(str(json_response)) + ssid_table = json_response.get(UNIFI_SSID_TABLE) + active_clients = {} + + for ssid in ssid_table: + client_table = ssid.get(UNIFI_CLIENT_TABLE) + for client in client_table: + active_clients[client.get("mac")] = client + + return active_clients + except ValueError: + _LOGGER.error("Failed to decode response from AP.") + return {} diff --git a/requirements_all.txt b/requirements_all.txt index 5ad07d15ef7..39136d59db4 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -523,6 +523,7 @@ pdunehd==1.3 # homeassistant.components.device_tracker.aruba # homeassistant.components.device_tracker.asuswrt # homeassistant.components.device_tracker.cisco_ios +# homeassistant.components.device_tracker.unifi_direct # homeassistant.components.media_player.pandora pexpect==4.0.1 diff --git a/requirements_test_all.txt b/requirements_test_all.txt index 32c2feb7427..4331b7d11e6 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -101,6 +101,7 @@ paho-mqtt==1.3.1 # homeassistant.components.device_tracker.aruba # homeassistant.components.device_tracker.asuswrt # homeassistant.components.device_tracker.cisco_ios +# homeassistant.components.device_tracker.unifi_direct # homeassistant.components.media_player.pandora pexpect==4.0.1 diff --git a/tests/components/device_tracker/test_unifi_direct.py b/tests/components/device_tracker/test_unifi_direct.py new file mode 100644 index 00000000000..0e22758d07e --- /dev/null +++ b/tests/components/device_tracker/test_unifi_direct.py @@ -0,0 +1,172 @@ +"""The tests for the Unifi direct device tracker platform.""" +import os +from datetime import timedelta +import unittest +from unittest import mock +from unittest.mock import patch + +import pytest +import voluptuous as vol + +from homeassistant.setup import setup_component +from homeassistant.components import device_tracker +from homeassistant.components.device_tracker import ( + CONF_CONSIDER_HOME, CONF_TRACK_NEW) +from homeassistant.components.device_tracker.unifi_direct import ( + DOMAIN, CONF_PORT, PLATFORM_SCHEMA, _response_to_json, get_scanner) +from homeassistant.const import (CONF_PLATFORM, CONF_PASSWORD, CONF_USERNAME, + CONF_HOST) + +from tests.common import ( + get_test_home_assistant, assert_setup_component, + mock_component, load_fixture) + + +class TestComponentsDeviceTrackerUnifiDirect(unittest.TestCase): + """Tests for the Unifi direct device tracker platform.""" + + hass = None + scanner_path = 'homeassistant.components.device_tracker.' + \ + 'unifi_direct.UnifiDeviceScanner' + + def setup_method(self, _): + """Setup things to be run when tests are started.""" + self.hass = get_test_home_assistant() + mock_component(self.hass, 'zone') + + def teardown_method(self, _): + """Stop everything that was started.""" + self.hass.stop() + try: + os.remove(self.hass.config.path(device_tracker.YAML_DEVICES)) + except FileNotFoundError: + pass + + @mock.patch(scanner_path, + return_value=mock.MagicMock()) + def test_get_scanner(self, unifi_mock): \ + # pylint: disable=invalid-name + """Test creating an Unifi direct scanner with a password.""" + conf_dict = { + DOMAIN: { + CONF_PLATFORM: 'unifi_direct', + CONF_HOST: 'fake_host', + CONF_USERNAME: 'fake_user', + CONF_PASSWORD: 'fake_pass', + CONF_TRACK_NEW: True, + CONF_CONSIDER_HOME: timedelta(seconds=180) + } + } + + with assert_setup_component(1, DOMAIN): + assert setup_component(self.hass, DOMAIN, conf_dict) + + conf_dict[DOMAIN][CONF_PORT] = 22 + self.assertEqual(unifi_mock.call_args, mock.call(conf_dict[DOMAIN])) + + @patch('pexpect.pxssh.pxssh') + def test_get_device_name(self, mock_ssh): + """"Testing MAC matching.""" + conf_dict = { + DOMAIN: { + CONF_PLATFORM: 'unifi_direct', + CONF_HOST: 'fake_host', + CONF_USERNAME: 'fake_user', + CONF_PASSWORD: 'fake_pass', + CONF_PORT: 22, + CONF_TRACK_NEW: True, + CONF_CONSIDER_HOME: timedelta(seconds=180) + } + } + mock_ssh.return_value.before = load_fixture('unifi_direct.txt') + scanner = get_scanner(self.hass, conf_dict) + devices = scanner.scan_devices() + self.assertEqual(23, len(devices)) + self.assertEqual("iPhone", + scanner.get_device_name("98:00:c6:56:34:12")) + self.assertEqual("iPhone", + scanner.get_device_name("98:00:C6:56:34:12")) + + @patch('pexpect.pxssh.pxssh.logout') + @patch('pexpect.pxssh.pxssh.login') + def test_failed_to_log_in(self, mock_login, mock_logout): + """"Testing exception at login results in False.""" + from pexpect import exceptions + + conf_dict = { + DOMAIN: { + CONF_PLATFORM: 'unifi_direct', + CONF_HOST: 'fake_host', + CONF_USERNAME: 'fake_user', + CONF_PASSWORD: 'fake_pass', + CONF_PORT: 22, + CONF_TRACK_NEW: True, + CONF_CONSIDER_HOME: timedelta(seconds=180) + } + } + + mock_login.side_effect = exceptions.EOF("Test") + scanner = get_scanner(self.hass, conf_dict) + self.assertFalse(scanner) + + @patch('pexpect.pxssh.pxssh.logout') + @patch('pexpect.pxssh.pxssh.login', autospec=True) + @patch('pexpect.pxssh.pxssh.prompt') + @patch('pexpect.pxssh.pxssh.sendline') + def test_to_get_update(self, mock_sendline, mock_prompt, mock_login, + mock_logout): + """"Testing exception in get_update matching.""" + conf_dict = { + DOMAIN: { + CONF_PLATFORM: 'unifi_direct', + CONF_HOST: 'fake_host', + CONF_USERNAME: 'fake_user', + CONF_PASSWORD: 'fake_pass', + CONF_PORT: 22, + CONF_TRACK_NEW: True, + CONF_CONSIDER_HOME: timedelta(seconds=180) + } + } + + scanner = get_scanner(self.hass, conf_dict) + # mock_sendline.side_effect = AssertionError("Test") + mock_prompt.side_effect = AssertionError("Test") + devices = scanner._get_update() # pylint: disable=protected-access + self.assertTrue(devices is None) + + def test_good_reponse_parses(self): + """Test that the response form the AP parses to JSON correctly.""" + response = _response_to_json(load_fixture('unifi_direct.txt')) + self.assertTrue(response != {}) + + def test_bad_reponse_returns_none(self): + """Test that a bad response form the AP parses to JSON correctly.""" + self.assertTrue(_response_to_json("{(}") == {}) + + +def test_config_error(): + """Test for configuration errors.""" + with pytest.raises(vol.Invalid): + PLATFORM_SCHEMA({ + # no username + CONF_PASSWORD: 'password', + CONF_PLATFORM: DOMAIN, + CONF_HOST: 'myhost', + 'port': 123, + }) + with pytest.raises(vol.Invalid): + PLATFORM_SCHEMA({ + # no password + CONF_USERNAME: 'foo', + CONF_PLATFORM: DOMAIN, + CONF_HOST: 'myhost', + 'port': 123, + }) + with pytest.raises(vol.Invalid): + PLATFORM_SCHEMA({ + CONF_PLATFORM: DOMAIN, + CONF_USERNAME: 'foo', + CONF_PASSWORD: 'password', + CONF_HOST: 'myhost', + 'port': 'foo', # bad port! + }) diff --git a/tests/fixtures/unifi_direct.txt b/tests/fixtures/unifi_direct.txt new file mode 100644 index 00000000000..fcb58070fcc --- /dev/null +++ b/tests/fixtures/unifi_direct.txt @@ -0,0 +1 @@ +b'mca-dump | tr -d "\r\n> "\r\n{ "board_rev": 16, "bootrom_version": "unifi-v1.6.7.249-gb74e0282", "cfgversion": "63b505a1c328fd9c", "country_code": 840, "default": false, "discovery_response": true, "fw_caps": 855, "guest_token": "E6BAE04FD72C", "has_eth1": false, "has_speaker": false, "hostname": "UBNT", "if_table": [ { "full_duplex": true, "ip": "0.0.0.0", "mac": "80:2a:a8:56:34:12", "name": "eth0", "netmask": "0.0.0.0", "num_port": 1, "rx_bytes": 3879332085, "rx_dropped": 0, "rx_errors": 0, "rx_multicast": 0, "rx_packets": 4093520, "speed": 1000, "tx_bytes": 1745140940, "tx_dropped": 0, "tx_errors": 0, "tx_packets": 3105586, "up": true } ], "inform_url": "?", "ip": "192.168.1.2", "isolated": false, "last_error": "", "locating": false, "mac": "80:2a:a8:56:34:12", "model": "U7LR", "model_display": "UAP-AC-LR", "netmask": "255.255.255.0", "port_table": [ { "media": "GE", "poe_caps": 0, "port_idx": 0, "port_poe": false } ], "radio_table": [ { "athstats": { "ast_ath_reset": 0, "ast_be_xmit": 1098121, "ast_cst": 225, "ast_deadqueue_reset": 0, "ast_fullqueue_stop": 0, "ast_txto": 151, "cu_self_rx": 8, "cu_self_tx": 4, "cu_total": 12, "n_rx_aggr": 3915695, "n_rx_pkts": 6518082, "n_tx_bawadv": 1205430, "n_tx_bawretries": 70257, "n_tx_pkts": 1813368, "n_tx_queue": 1024366, "n_tx_retries": 70273, "n_tx_xretries": 897, "n_txaggr_compgood": 616173, "n_txaggr_compretries": 71170, "n_txaggr_compxretry": 0, "n_txaggr_prepends": 21240, "name": "wifi0" }, "builtin_ant_gain": 0, "builtin_antenna": true, "max_txpower": 24, "min_txpower": 6, "name": "wifi0", "nss": 3, "radio": "ng", "scan_table": [ { "age": 2, "bssid": "28:56:5a:34:23:12", "bw": 20, "center_freq": 2462, "channel": 11, "essid": "someones_wifi", "freq": 2462, "is_adhoc": false, "is_ubnt": false, "rssi": 8, "rssi_age": 2, "security": "secured" }, { "age": 37, "bssid": "00:60:0f:45:34:12", "bw": 20, "center_freq": 2462, "channel": 11, "essid": "", "freq": 2462, "is_adhoc": false, "is_ubnt": false, "rssi": 10, "rssi_age": 37, "security": "secured" }, { "age": 29, "bssid": "b0:93:5b:7a:35:23", "bw": 20, "center_freq": 2462, "channel": 11, "essid": "ARRIS-CB55", "freq": 2462, "is_adhoc": false, "is_ubnt": false, "rssi": 10, "rssi_age": 29, "security": "secured" }, { "age": 0, "bssid": "e0:46:9a:e1:ea:7d", "bw": 20, "center_freq": 2462, "channel": 11, "essid": "Darjeeling", "freq": 2462, "is_adhoc": false, "is_ubnt": false, "rssi": 9, "rssi_age": 0, "security": "secured" }, { "age": 1, "bssid": "00:60:0f:e1:ea:7e", "bw": 20, "center_freq": 2462, "channel": 11, "essid": "", "freq": 2462, "is_adhoc": false, "is_ubnt": false, "rssi": 10, "rssi_age": 1, "security": "secured" }, { "age": 0, "bssid": "7c:d1:c3:cd:e5:f4", "bw": 20, "center_freq": 2462, "channel": 11, "essid": "Chris\'s Wi-Fi Network", "freq": 2462, "is_adhoc": false, "is_ubnt": false, "rssi": 17, "rssi_age": 0, "security": "secured" } ] }, { "athstats": { "ast_ath_reset": 14, "ast_be_xmit": 1097310, "ast_cst": 0, "ast_deadqueue_reset": 41, "ast_fullqueue_stop": 0, "ast_txto": 0, "cu_self_rx": 0, "cu_self_tx": 0, "cu_total": 0, "n_rx_aggr": 106804, "n_rx_pkts": 2453041, "n_tx_bawadv": 557298, "n_tx_bawretries": 0, "n_tx_pkts": 1080, "n_tx_queue": 0, "n_tx_retries": 1, "n_tx_xretries": 44046, "n_txaggr_compgood": 0, "n_txaggr_compretries": 0, "n_txaggr_compxretry": 0, "n_txaggr_prepends": 0, "name": "wifi1" }, "builtin_ant_gain": 0, "builtin_antenna": true, "has_dfs": true, "has_fccdfs": true, "is_11ac": true, "max_txpower": 22, "min_txpower": 4, "name": "wifi1", "nss": 2, "radio": "na", "scan_table": [] } ], "required_version": "3.4.1", "selfrun_beacon": false, "serial": "802AA896363C", "spectrum_scanning": false, "ssh_session_table": [], "state": 0, "stream_token": "", "sys_stats": { "loadavg_1": "0.03", "loadavg_15": "0.06", "loadavg_5": "0.06", "mem_buffer": 0, "mem_total": 129310720, "mem_used": 75800576 }, "system-stats": { "cpu": "8.4", "mem": "58.6", "uptime": "112391" }, "time": 1508795154, "uplink": "eth0", "uptime": 112391, "vap_table": [ { "bssid": "80:2a:a8:97:36:3c", "ccq": 914, "channel": 11, "essid": "220", "id": "55b19c7e50e4e11e798e84c7", "name": "ath0", "num_sta": 20, "radio": "ng", "rx_bytes": 1155345354, "rx_crypts": 5491, "rx_dropped": 5540, "rx_errors": 5540, "rx_frags": 0, "rx_nwids": 647001, "rx_packets": 1840967, "sta_table": [ { "auth_time": 4294967206, "authorized": true, "ccq": 991, "dhcpend_time": 660, "dhcpstart_time": 660, "hostname": "amazon-device", "idletime": 0, "ip": "192.168.1.45", "is_11n": true, "mac": "44:65:0d:12:34:56", "noise": -114, "rssi": 59, "rx_bytes": 1176121, "rx_mcast": 0, "rx_packets": 20927, "rx_rate": 24000, "rx_retries": 0, "signal": -55, "state": 15, "state_ht": true, "state_pwrmgt": false, "tx_bytes": 364495, "tx_packets": 2183, "tx_power": 48, "tx_rate": 72222, "tx_retries": 589, "uptime": 7031, "vlan_id": 0 }, { "auth_time": 4294967266, "authorized": true, "ccq": 991, "dhcpend_time": 290, "dhcpstart_time": 290, "hostname": "iPhone", "idletime": 9, "ip": "192.168.1.209", "is_11n": true, "mac": "98:00:c6:56:34:12", "noise": -114, "rssi": 40, "rx_bytes": 5862172, "rx_mcast": 0, "rx_packets": 30977, "rx_rate": 24000, "rx_retries": 0, "signal": -74, "state": 31, "state_ht": true, "state_pwrmgt": true, "tx_bytes": 31707361, "tx_packets": 27775, "tx_power": 48, "tx_rate": 140637, "tx_retries": 1213, "uptime": 15556, "vlan_id": 0 }, { "auth_time": 4294967276, "authorized": true, "ccq": 991, "dhcpend_time": 630, "dhcpstart_time": 630, "hostname": "android", "idletime": 0, "ip": "192.168.1.10", "is_11n": true, "mac": "b4:79:a7:45:34:12", "noise": -114, "rssi": 60, "rx_bytes": 13694423, "rx_mcast": 0, "rx_packets": 110909, "rx_rate": 1000, "rx_retries": 0, "signal": -54, "state": 15, "state_ht": true, "state_pwrmgt": false, "tx_bytes": 7988429, "tx_packets": 28863, "tx_power": 48, "tx_rate": 72222, "tx_retries": 1254, "uptime": 19052, "vlan_id": 0 }, { "auth_time": 4294967176, "authorized": true, "ccq": 991, "dhcpend_time": 4480, "dhcpstart_time": 4480, "hostname": "wink", "idletime": 0, "ip": "192.168.1.3", "is_11n": true, "mac": "b4:79:a7:56:34:12", "noise": -114, "rssi": 38, "rx_bytes": 18705870, "rx_mcast": 0, "rx_packets": 78794, "rx_rate": 72109, "rx_retries": 0, "signal": -76, "state": 15, "state_ht": true, "state_pwrmgt": false, "tx_bytes": 4416534, "tx_packets": 58304, "tx_power": 48, "tx_rate": 72222, "tx_retries": 1978, "uptime": 51648, "vlan_id": 0 }, { "auth_time": 4294966266, "authorized": true, "ccq": 981, "dhcpend_time": 1530, "dhcpstart_time": 1530, "hostname": "Chromecast", "idletime": 0, "ip": "192.168.1.30", "is_11n": true, "mac": "80:d2:1d:56:34:12", "noise": -114, "rssi": 37, "rx_bytes": 29377621, "rx_mcast": 0, "rx_packets": 105806, "rx_rate": 72109, "rx_retries": 0, "signal": -77, "state": 15, "state_ht": true, "state_pwrmgt": false, "tx_bytes": 122681792, "tx_packets": 145339, "tx_power": 48, "tx_rate": 72222, "tx_retries": 2980, "uptime": 53658, "vlan_id": 0 }, { "auth_time": 4294967176, "authorized": true, "ccq": 991, "dhcpend_time": 370, "dhcpstart_time": 360, "idletime": 2, "ip": "192.168.1.51", "is_11n": false, "mac": "48:02:2d:56:34:12", "noise": -114, "rssi": 56, "rx_bytes": 48148926, "rx_mcast": 0, "rx_packets": 59462, "rx_rate": 1000, "rx_retries": 0, "signal": -58, "state": 16391, "state_ht": false, "state_pwrmgt": false, "tx_bytes": 7075470, "tx_packets": 33047, "tx_power": 48, "tx_rate": 54000, "tx_retries": 2833, "uptime": 63850, "vlan_id": 0 }, { "auth_time": 4294967276, "authorized": true, "ccq": 971, "dhcpend_time": 30, "dhcpstart_time": 30, "hostname": "ESP_1C2F8D", "idletime": 0, "ip": "192.168.1.54", "is_11n": true, "mac": "a0:20:a6:45:35:12", "noise": -114, "rssi": 51, "rx_bytes": 4684699, "rx_mcast": 0, "rx_packets": 137798, "rx_rate": 2000, "rx_retries": 0, "signal": -63, "state": 31, "state_ht": true, "state_pwrmgt": true, "tx_bytes": 355735, "tx_packets": 6977, "tx_power": 48, "tx_rate": 72222, "tx_retries": 590, "uptime": 78427, "vlan_id": 0 }, { "auth_time": 4294967176, "authorized": true, "ccq": 991, "dhcpend_time": 220, "dhcpstart_time": 220, "hostname": "HF-LPB100-ZJ200", "idletime": 2, "ip": "192.168.1.53", "is_11n": true, "mac": "f0:fe:6b:56:34:12", "noise": -114, "rssi": 29, "rx_bytes": 1415840, "rx_mcast": 0, "rx_packets": 22821, "rx_rate": 1000, "rx_retries": 0, "signal": -85, "state": 31, "state_ht": true, "state_pwrmgt": true, "tx_bytes": 402439, "tx_packets": 7779, "tx_power": 48, "tx_rate": 72222, "tx_retries": 891, "uptime": 111944, "vlan_id": 0 }, { "auth_time": 4294967276, "authorized": true, "ccq": 991, "dhcpend_time": 1620, "dhcpstart_time": 1620, "idletime": 0, "ip": "192.168.1.33", "is_11n": false, "mac": "94:10:3e:45:34:12", "noise": -114, "rssi": 48, "rx_bytes": 47843953, "rx_mcast": 0, "rx_packets": 79456, "rx_rate": 54000, "rx_retries": 0, "signal": -66, "state": 16391, "state_ht": false, "state_pwrmgt": false, "tx_bytes": 4357955, "tx_packets": 60958, "tx_power": 48, "tx_rate": 54000, "tx_retries": 4598, "uptime": 112316, "vlan_id": 0 }, { "auth_time": 4294967266, "authorized": true, "ccq": 991, "dhcpend_time": 540, "dhcpstart_time": 540, "hostname": "amazon-device", "idletime": 0, "ip": "192.168.1.46", "is_11n": true, "mac": "ac:63:be:56:34:12", "noise": -114, "rssi": 30, "rx_bytes": 14607810, "rx_mcast": 0, "rx_packets": 326158, "rx_rate": 24000, "rx_retries": 0, "signal": -84, "state": 15, "state_ht": true, "state_pwrmgt": false, "tx_bytes": 3238319, "tx_packets": 25605, "tx_power": 48, "tx_rate": 72222, "tx_retries": 2465, "uptime": 112364, "vlan_id": 0 }, { "auth_time": 4294966266, "authorized": true, "ccq": 941, "dhcpend_time": 1060, "dhcpstart_time": 1060, "hostname": "Broadlink_RMMINI-56-34-12", "idletime": 12, "ip": "192.168.1.52", "is_11n": true, "mac": "34:ea:34:56:34:12", "noise": -114, "rssi": 43, "rx_bytes": 625268, "rx_mcast": 0, "rx_packets": 4711, "rx_rate": 65000, "rx_retries": 0, "signal": -71, "state": 15, "state_ht": true, "state_pwrmgt": false, "tx_bytes": 420763, "tx_packets": 4620, "tx_power": 48, "tx_rate": 65000, "tx_retries": 783, "uptime": 112368, "vlan_id": 0 }, { "auth_time": 4294967256, "authorized": true, "ccq": 930, "dhcpend_time": 3360, "dhcpstart_time": 3360, "hostname": "garage", "idletime": 2, "ip": "192.168.1.28", "is_11n": true, "mac": "00:13:ef:45:34:12", "noise": -114, "rssi": 28, "rx_bytes": 11639474, "rx_mcast": 0, "rx_packets": 102103, "rx_rate": 24000, "rx_retries": 0, "signal": -86, "state": 31, "state_ht": true, "state_pwrmgt": true, "tx_bytes": 6282728, "tx_packets": 85279, "tx_power": 48, "tx_rate": 58500, "tx_retries": 21185, "uptime": 112369, "vlan_id": 0 }, { "auth_time": 4294967286, "authorized": true, "ccq": 991, "dhcpend_time": 30, "dhcpstart_time": 30, "hostname": "keurig", "idletime": 0, "ip": "192.168.1.48", "is_11n": true, "mac": "18:fe:34:56:34:12", "noise": -114, "rssi": 52, "rx_bytes": 17781940, "rx_mcast": 0, "rx_packets": 432172, "rx_rate": 6000, "rx_retries": 0, "signal": -62, "state": 31, "state_ht": true, "state_pwrmgt": true, "tx_bytes": 4143184, "tx_packets": 53751, "tx_power": 48, "tx_rate": 72222, "tx_retries": 3781, "uptime": 112369, "vlan_id": 0 }, { "auth_time": 4294967276, "authorized": true, "ccq": 940, "dhcpend_time": 50, "dhcpstart_time": 50, "hostname": "freezer", "idletime": 0, "ip": "192.168.1.26", "is_11n": true, "mac": "5c:cf:7f:07:5a:a4", "noise": -114, "rssi": 47, "rx_bytes": 13613265, "rx_mcast": 0, "rx_packets": 411785, "rx_rate": 2000, "rx_retries": 0, "signal": -67, "state": 31, "state_ht": true, "state_pwrmgt": true, "tx_bytes": 1411127, "tx_packets": 17492, "tx_power": 48, "tx_rate": 65000, "tx_retries": 5869, "uptime": 112370, "vlan_id": 0 }, { "auth_time": 4294967276, "authorized": true, "ccq": 778, "dhcpend_time": 50, "dhcpstart_time": 50, "hostname": "fan", "idletime": 0, "ip": "192.168.1.34", "is_11n": true, "mac": "5c:cf:7f:02:09:4e", "noise": -114, "rssi": 45, "rx_bytes": 15377230, "rx_mcast": 0, "rx_packets": 417435, "rx_rate": 6000, "rx_retries": 0, "signal": -69, "state": 31, "state_ht": true, "state_pwrmgt": true, "tx_bytes": 2974258, "tx_packets": 36175, "tx_power": 48, "tx_rate": 58500, "tx_retries": 18552, "uptime": 112372, "vlan_id": 0 }, { "auth_time": 4294966266, "authorized": true, "ccq": 991, "dhcpend_time": 1070, "dhcpstart_time": 1070, "hostname": "Broadlink_RMPROPLUS-45-34-12", "idletime": 1, "ip": "192.168.1.9", "is_11n": true, "mac": "b4:43:0d:45:56:56", "noise": -114, "rssi": 57, "rx_bytes": 1792908, "rx_mcast": 0, "rx_packets": 8528, "rx_rate": 72109, "rx_retries": 0, "signal": -57, "state": 15, "state_ht": true, "state_pwrmgt": false, "tx_bytes": 770834, "tx_packets": 8443, "tx_power": 48, "tx_rate": 65000, "tx_retries": 5258, "uptime": 112373, "vlan_id": 0 }, { "auth_time": 4294967276, "authorized": true, "ccq": 991, "dhcpend_time": 210, "dhcpstart_time": 210, "idletime": 49, "ip": "192.168.1.40", "is_11n": true, "mac": "0c:2a:69:02:3e:3b", "noise": -114, "rssi": 36, "rx_bytes": 427418, "rx_mcast": 0, "rx_packets": 2824, "rx_rate": 65000, "rx_retries": 0, "signal": -78, "state": 15, "state_ht": true, "state_pwrmgt": false, "tx_bytes": 176039, "tx_packets": 2872, "tx_power": 48, "tx_rate": 65000, "tx_retries": 87, "uptime": 112373, "vlan_id": 0 }, { "auth_time": 4294966266, "authorized": true, "ccq": 991, "dhcpend_time": 5030, "dhcpstart_time": 5030, "hostname": "HP2C27D78D9F3E", "idletime": 268, "ip": "192.168.1.44", "is_11n": true, "mac": "2c:27:d7:8d:9f:3e", "noise": -114, "rssi": 41, "rx_bytes": 172927, "rx_mcast": 0, "rx_packets": 781, "rx_rate": 72109, "rx_retries": 0, "signal": -73, "state": 15, "state_ht": true, "state_pwrmgt": false, "tx_bytes": 41924, "tx_packets": 453, "tx_power": 48, "tx_rate": 66610, "tx_retries": 66, "uptime": 112373, "vlan_id": 0 }, { "auth_time": 4294967266, "authorized": true, "ccq": 991, "dhcpend_time": 110, "dhcpstart_time": 110, "idletime": 4, "ip": "192.168.1.55", "is_11n": true, "mac": "0c:2a:69:04:e6:ac", "noise": -114, "rssi": 51, "rx_bytes": 300741, "rx_mcast": 0, "rx_packets": 2443, "rx_rate": 65000, "rx_retries": 0, "signal": -63, "state": 15, "state_ht": true, "state_pwrmgt": false, "tx_bytes": 159980, "tx_packets": 2526, "tx_power": 48, "tx_rate": 65000, "tx_retries": 47, "uptime": 112373, "vlan_id": 0 }, { "auth_time": 4294967256, "authorized": true, "ccq": 991, "dhcpend_time": 1570, "dhcpstart_time": 1560, "idletime": 1, "ip": "192.168.1.37", "is_11n": true, "mac": "0c:2a:69:03:df:37", "noise": -114, "rssi": 42, "rx_bytes": 304567, "rx_mcast": 0, "rx_packets": 2468, "rx_rate": 65000, "rx_retries": 0, "signal": -72, "state": 15, "state_ht": true, "state_pwrmgt": false, "tx_bytes": 164382, "tx_packets": 2553, "tx_power": 48, "tx_rate": 65000, "tx_retries": 48, "uptime": 112373, "vlan_id": 0 } ], "state": "RUN", "tx_bytes": 1190129336, "tx_dropped": 7, "tx_errors": 0, "tx_packets": 1907093, "tx_power": 24, "tx_retries": 29927, "up": true, "usage": "user" }, { "bssid": "ff:ff:ff:ff:ff:ff", "ccq": 914, "channel": 157, "essid": "", "extchannel": 1, "id": "user", "name": "ath1", "num_sta": 0, "radio": "na", "rx_bytes": 0, "rx_crypts": 0, "rx_dropped": 0, "rx_errors": 0, "rx_frags": 0, "rx_nwids": 0, "rx_packets": 0, "sta_table": [], "state": "INIT", "tx_bytes": 0, "tx_dropped": 0, "tx_errors": 0, "tx_packets": 0, "tx_power": 22, "tx_retries": 0, "up": false, "usage": "uplink" }, { "bssid": "82:2a:a8:98:36:3c", "ccq": 482, "channel": 157, "essid": "220 5ghz", "extchannel": 1, "id": "55b19c7e50e4e11e798e84c7", "name": "ath2", "num_sta": 3, "radio": "na", "rx_bytes": 250435644, "rx_crypts": 4071, "rx_dropped": 4071, "rx_errors": 4071, "rx_frags": 0, "rx_nwids": 6660, "rx_packets": 1123263, "sta_table": [ { "auth_time": 4294967246, "authorized": true, "ccq": 631, "dhcpend_time": 190, "dhcpstart_time": 190, "hostname": "android-f4aaefc31d5d2f78", "idletime": 26, "ip": "192.168.1.15", "is_11a": true, "is_11ac": true, "is_11n": true, "mac": "c0:ee:fb:24:ef:a0", "noise": -105, "rssi": 16, "rx_bytes": 3188995, "rx_mcast": 0, "rx_packets": 37243, "rx_rate": 81000, "rx_retries": 0, "signal": -89, "state": 11, "state_ht": true, "state_pwrmgt": false, "tx_bytes": 89051905, "tx_packets": 64756, "tx_power": 44, "tx_rate": 108000, "tx_retries": 0, "uptime": 5494, "vlan_id": 0 }, { "auth_time": 4294967286, "authorized": true, "ccq": 333, "dhcpend_time": 10, "dhcpstart_time": 10, "hostname": "mac_book_air", "idletime": 1, "ip": "192.168.1.12", "is_11a": true, "is_11n": true, "mac": "00:88:65:56:34:12", "noise": -105, "rssi": 52, "rx_bytes": 106902966, "rx_mcast": 0, "rx_packets": 270845, "rx_rate": 300000, "rx_retries": 0, "signal": -53, "state": 11, "state_ht": true, "state_pwrmgt": false, "tx_bytes": 289588466, "tx_packets": 339466, "tx_power": 44, "tx_rate": 300000, "tx_retries": 0, "uptime": 15312, "vlan_id": 0 }, { "auth_time": 4294967266, "authorized": true, "ccq": 333, "dhcpend_time": 160, "dhcpstart_time": 160, "hostname": "Chromecast", "idletime": 0, "ip": "192.168.1.29", "is_11a": true, "is_11ac": true, "is_11n": true, "mac": "f4:f5:d8:11:57:6a", "noise": -105, "rssi": 40, "rx_bytes": 50958412, "rx_mcast": 0, "rx_packets": 339563, "rx_rate": 200000, "rx_retries": 0, "signal": -65, "state": 11, "state_ht": true, "state_pwrmgt": false, "tx_bytes": 1186178689, "tx_packets": 890384, "tx_power": 44, "tx_rate": 150000, "tx_retries": 0, "uptime": 56493, "vlan_id": 0 } ], "state": "RUN", "tx_bytes": 2766849222, "tx_dropped": 119, "tx_errors": 23508, "tx_packets": 2247859, "tx_power": 22, "tx_retries": 0, "up": true, "usage": "user" } ], "version": "3.7.58.6385", "wifi_caps": 1909}' \ No newline at end of file From 3ad64b0a66301a8aa14eccde89ebdc44dc4548a2 Mon Sep 17 00:00:00 2001 From: Aaron Bach Date: Fri, 17 Nov 2017 13:11:05 -0700 Subject: [PATCH 084/246] Fixes AirVisual bug regarding incorrect location data (#10054) * Fixes AirVisual bug regarding incorrect location data * Owner-requested changes --- homeassistant/components/sensor/airvisual.py | 47 ++++++++++---------- 1 file changed, 24 insertions(+), 23 deletions(-) diff --git a/homeassistant/components/sensor/airvisual.py b/homeassistant/components/sensor/airvisual.py index 56ddf7adcab..5ea24dab823 100644 --- a/homeassistant/components/sensor/airvisual.py +++ b/homeassistant/components/sensor/airvisual.py @@ -126,7 +126,7 @@ class AirVisualBaseSensor(Entity): def __init__(self, data, name, icon, locale): """Initialize the sensor.""" - self._data = data + self.data = data self._icon = icon self._locale = locale self._name = name @@ -136,20 +136,17 @@ class AirVisualBaseSensor(Entity): @property def device_state_attributes(self): """Return the device state attributes.""" - attrs = { + attrs = merge_two_dicts({ ATTR_ATTRIBUTION: CONF_ATTRIBUTION, - ATTR_CITY: self._data.city, - ATTR_COUNTRY: self._data.country, - ATTR_REGION: self._data.state, - ATTR_TIMESTAMP: self._data.pollution_info.get('ts') - } + ATTR_TIMESTAMP: self.data.pollution_info.get('ts') + }, self.data.attrs) - if self._data.show_on_map: - attrs[ATTR_LATITUDE] = self._data.latitude - attrs[ATTR_LONGITUDE] = self._data.longitude + if self.data.show_on_map: + attrs[ATTR_LATITUDE] = self.data.latitude + attrs[ATTR_LONGITUDE] = self.data.longitude else: - attrs['lati'] = self._data.latitude - attrs['long'] = self._data.longitude + attrs['lati'] = self.data.latitude + attrs['long'] = self.data.longitude return attrs @@ -174,9 +171,9 @@ class AirPollutionLevelSensor(AirVisualBaseSensor): def update(self): """Update the status of the sensor.""" - self._data.update() + self.data.update() - aqi = self._data.pollution_info.get('aqi{0}'.format(self._locale)) + aqi = self.data.pollution_info.get('aqi{0}'.format(self._locale)) try: [level] = [ i for i in POLLUTANT_LEVEL_MAPPING @@ -199,9 +196,9 @@ class AirQualityIndexSensor(AirVisualBaseSensor): def update(self): """Update the status of the sensor.""" - self._data.update() + self.data.update() - self._state = self._data.pollution_info.get( + self._state = self.data.pollution_info.get( 'aqi{0}'.format(self._locale)) @@ -224,9 +221,9 @@ class MainPollutantSensor(AirVisualBaseSensor): def update(self): """Update the status of the sensor.""" - self._data.update() + self.data.update() - symbol = self._data.pollution_info.get('main{0}'.format(self._locale)) + symbol = self.data.pollution_info.get('main{0}'.format(self._locale)) pollution_info = POLLUTANT_MAPPING.get(symbol, {}) self._state = pollution_info.get('label') self._unit = pollution_info.get('unit') @@ -239,6 +236,7 @@ class AirVisualData(object): def __init__(self, client, **kwargs): """Initialize the AirVisual data element.""" self._client = client + self.attrs = {} self.pollution_info = None self.city = kwargs.get(CONF_CITY) @@ -260,17 +258,20 @@ class AirVisualData(object): if self.city and self.state and self.country: resp = self._client.city( self.city, self.state, self.country).get('data') + self.longitude, self.latitude = resp.get('location').get( + 'coordinates') else: resp = self._client.nearest_city( self.latitude, self.longitude, self._radius).get('data') _LOGGER.debug("New data retrieved: %s", resp) - self.city = resp.get('city') - self.state = resp.get('state') - self.country = resp.get('country') - self.longitude, self.latitude = resp.get('location').get( - 'coordinates') self.pollution_info = resp.get('current', {}).get('pollution', {}) + + self.attrs = { + ATTR_CITY: resp.get('city'), + ATTR_REGION: resp.get('state'), + ATTR_COUNTRY: resp.get('country') + } except exceptions.HTTPError as exc_info: _LOGGER.error("Unable to retrieve data on this location: %s", self.__dict__) From 64a393b377e96c6e9e70c1b452d3c07bdb4d9d9d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pierre=20St=C3=A5hl?= Date: Sat, 18 Nov 2017 00:00:15 +0100 Subject: [PATCH 085/246] Bump pyatv to 0.3.8 (#10643) Fixes AirPlay issues on newer versions of tvOS. --- homeassistant/components/apple_tv.py | 2 +- requirements_all.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/apple_tv.py b/homeassistant/components/apple_tv.py index 6e38f172c4c..c8eb1841c0d 100644 --- a/homeassistant/components/apple_tv.py +++ b/homeassistant/components/apple_tv.py @@ -18,7 +18,7 @@ from homeassistant.helpers import discovery from homeassistant.components.discovery import SERVICE_APPLE_TV import homeassistant.helpers.config_validation as cv -REQUIREMENTS = ['pyatv==0.3.6'] +REQUIREMENTS = ['pyatv==0.3.8'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index 39136d59db4..48704667afa 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -613,7 +613,7 @@ pyasn1-modules==0.1.5 pyasn1==0.3.7 # homeassistant.components.apple_tv -pyatv==0.3.6 +pyatv==0.3.8 # homeassistant.components.device_tracker.bbox # homeassistant.components.sensor.bbox From b3d66e5881a2b54dc90c5899a6f23e0ede209f7e Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Fri, 17 Nov 2017 19:09:47 -0800 Subject: [PATCH 086/246] Update frontend to 20171118.0 --- homeassistant/components/frontend/__init__.py | 2 +- requirements_all.txt | 2 +- requirements_test_all.txt | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index bac00b8a57a..e7cfcf8d88c 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -23,7 +23,7 @@ from homeassistant.const import CONF_NAME, EVENT_THEMES_UPDATED from homeassistant.core import callback from homeassistant.loader import bind_hass -REQUIREMENTS = ['home-assistant-frontend==20171117.1'] +REQUIREMENTS = ['home-assistant-frontend==20171118.0'] DOMAIN = 'frontend' DEPENDENCIES = ['api', 'websocket_api', 'http', 'system_log'] diff --git a/requirements_all.txt b/requirements_all.txt index 04432aa26a2..004535fd14f 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -331,7 +331,7 @@ hipnotify==1.0.8 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171117.1 +home-assistant-frontend==20171118.0 # homeassistant.components.camera.onvif http://github.com/tgaugry/suds-passworddigest-py3/archive/86fc50e39b4d2b8997481967d6a7fe1c57118999.zip#suds-passworddigest-py3==0.1.2a diff --git a/requirements_test_all.txt b/requirements_test_all.txt index 32c2feb7427..c9ea20494d4 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -74,7 +74,7 @@ hbmqtt==0.9.1 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171117.1 +home-assistant-frontend==20171118.0 # homeassistant.components.influxdb # homeassistant.components.sensor.influxdb From 13172971912267158cdac72f3634b2b26c7b0672 Mon Sep 17 00:00:00 2001 From: Robbie Trencheny Date: Fri, 17 Nov 2017 21:10:24 -0800 Subject: [PATCH 087/246] Implement entity and domain exclude/include for Alexa (#10647) * Implement entity and domain exclude/include for Alexa * Switch to using generate_filter * Use proper domain for turn on/off calls except for groups where we must use the generic homeassistant.turn_on/off * travis fixes * Untangle * Lint --- homeassistant/components/alexa/smart_home.py | 75 +++++---- homeassistant/components/cloud/__init__.py | 19 ++- homeassistant/components/cloud/iot.py | 4 +- homeassistant/components/mqtt_statestream.py | 12 +- homeassistant/helpers/config_validation.py | 16 +- homeassistant/helpers/entityfilter.py | 24 +++ tests/components/alexa/test_smart_home.py | 158 +++++++++++++++---- 7 files changed, 233 insertions(+), 75 deletions(-) diff --git a/homeassistant/components/alexa/smart_home.py b/homeassistant/components/alexa/smart_home.py index c5a849ad560..6e71fc67df1 100644 --- a/homeassistant/components/alexa/smart_home.py +++ b/homeassistant/components/alexa/smart_home.py @@ -1,5 +1,6 @@ """Support for alexa Smart Home Skill API.""" import asyncio +from collections import namedtuple import logging import math from uuid import uuid4 @@ -72,8 +73,11 @@ MAPPING_COMPONENT = { } +Config = namedtuple('AlexaConfig', 'filter') + + @asyncio.coroutine -def async_handle_message(hass, message): +def async_handle_message(hass, config, message): """Handle incoming API messages.""" assert message[API_DIRECTIVE][API_HEADER]['payloadVersion'] == '3' @@ -89,7 +93,7 @@ def async_handle_message(hass, message): "Unsupported API request %s/%s", namespace, name) return api_error(message) - return (yield from funct_ref(hass, message)) + return (yield from funct_ref(hass, config, message)) def api_message(request, name='Response', namespace='Alexa', payload=None): @@ -138,7 +142,7 @@ def api_error(request, error_type='INTERNAL_ERROR', error_message=""): @HANDLERS.register(('Alexa.Discovery', 'Discover')) @asyncio.coroutine -def async_api_discovery(hass, request): +def async_api_discovery(hass, config, request): """Create a API formatted discovery response. Async friendly. @@ -146,7 +150,14 @@ def async_api_discovery(hass, request): discovery_endpoints = [] for entity in hass.states.async_all(): + if not config.filter(entity.entity_id): + _LOGGER.debug("Not exposing %s because filtered by config", + entity.entity_id) + continue + if entity.attributes.get(ATTR_ALEXA_HIDDEN, False): + _LOGGER.debug("Not exposing %s because alexa_hidden is true", + entity.entity_id) continue class_data = MAPPING_COMPONENT.get(entity.domain) @@ -207,7 +218,7 @@ def async_api_discovery(hass, request): def extract_entity(funct): """Decorator for extract entity object from request.""" @asyncio.coroutine - def async_api_entity_wrapper(hass, request): + def async_api_entity_wrapper(hass, config, request): """Process a turn on request.""" entity_id = request[API_ENDPOINT]['endpointId'].replace('#', '.') @@ -218,7 +229,7 @@ def extract_entity(funct): request[API_HEADER]['name'], entity_id) return api_error(request, error_type='NO_SUCH_ENDPOINT') - return (yield from funct(hass, request, entity)) + return (yield from funct(hass, config, request, entity)) return async_api_entity_wrapper @@ -226,9 +237,13 @@ def extract_entity(funct): @HANDLERS.register(('Alexa.PowerController', 'TurnOn')) @extract_entity @asyncio.coroutine -def async_api_turn_on(hass, request, entity): +def async_api_turn_on(hass, config, request, entity): """Process a turn on request.""" - yield from hass.services.async_call(ha.DOMAIN, SERVICE_TURN_ON, { + domain = entity.domain + if entity.domain == group.DOMAIN: + domain = ha.DOMAIN + + yield from hass.services.async_call(domain, SERVICE_TURN_ON, { ATTR_ENTITY_ID: entity.entity_id }, blocking=True) @@ -238,9 +253,13 @@ def async_api_turn_on(hass, request, entity): @HANDLERS.register(('Alexa.PowerController', 'TurnOff')) @extract_entity @asyncio.coroutine -def async_api_turn_off(hass, request, entity): +def async_api_turn_off(hass, config, request, entity): """Process a turn off request.""" - yield from hass.services.async_call(ha.DOMAIN, SERVICE_TURN_OFF, { + domain = entity.domain + if entity.domain == group.DOMAIN: + domain = ha.DOMAIN + + yield from hass.services.async_call(domain, SERVICE_TURN_OFF, { ATTR_ENTITY_ID: entity.entity_id }, blocking=True) @@ -250,7 +269,7 @@ def async_api_turn_off(hass, request, entity): @HANDLERS.register(('Alexa.BrightnessController', 'SetBrightness')) @extract_entity @asyncio.coroutine -def async_api_set_brightness(hass, request, entity): +def async_api_set_brightness(hass, config, request, entity): """Process a set brightness request.""" brightness = int(request[API_PAYLOAD]['brightness']) @@ -265,7 +284,7 @@ def async_api_set_brightness(hass, request, entity): @HANDLERS.register(('Alexa.BrightnessController', 'AdjustBrightness')) @extract_entity @asyncio.coroutine -def async_api_adjust_brightness(hass, request, entity): +def async_api_adjust_brightness(hass, config, request, entity): """Process a adjust brightness request.""" brightness_delta = int(request[API_PAYLOAD]['brightnessDelta']) @@ -289,7 +308,7 @@ def async_api_adjust_brightness(hass, request, entity): @HANDLERS.register(('Alexa.ColorController', 'SetColor')) @extract_entity @asyncio.coroutine -def async_api_set_color(hass, request, entity): +def async_api_set_color(hass, config, request, entity): """Process a set color request.""" supported = entity.attributes.get(ATTR_SUPPORTED_FEATURES) rgb = color_util.color_hsb_to_RGB( @@ -317,7 +336,7 @@ def async_api_set_color(hass, request, entity): @HANDLERS.register(('Alexa.ColorTemperatureController', 'SetColorTemperature')) @extract_entity @asyncio.coroutine -def async_api_set_color_temperature(hass, request, entity): +def async_api_set_color_temperature(hass, config, request, entity): """Process a set color temperature request.""" kelvin = int(request[API_PAYLOAD]['colorTemperatureInKelvin']) @@ -333,7 +352,7 @@ def async_api_set_color_temperature(hass, request, entity): ('Alexa.ColorTemperatureController', 'DecreaseColorTemperature')) @extract_entity @asyncio.coroutine -def async_api_decrease_color_temp(hass, request, entity): +def async_api_decrease_color_temp(hass, config, request, entity): """Process a decrease color temperature request.""" current = int(entity.attributes.get(light.ATTR_COLOR_TEMP)) max_mireds = int(entity.attributes.get(light.ATTR_MAX_MIREDS)) @@ -351,7 +370,7 @@ def async_api_decrease_color_temp(hass, request, entity): ('Alexa.ColorTemperatureController', 'IncreaseColorTemperature')) @extract_entity @asyncio.coroutine -def async_api_increase_color_temp(hass, request, entity): +def async_api_increase_color_temp(hass, config, request, entity): """Process a increase color temperature request.""" current = int(entity.attributes.get(light.ATTR_COLOR_TEMP)) min_mireds = int(entity.attributes.get(light.ATTR_MIN_MIREDS)) @@ -368,7 +387,7 @@ def async_api_increase_color_temp(hass, request, entity): @HANDLERS.register(('Alexa.SceneController', 'Activate')) @extract_entity @asyncio.coroutine -def async_api_activate(hass, request, entity): +def async_api_activate(hass, config, request, entity): """Process a activate request.""" yield from hass.services.async_call(entity.domain, SERVICE_TURN_ON, { ATTR_ENTITY_ID: entity.entity_id @@ -380,7 +399,7 @@ def async_api_activate(hass, request, entity): @HANDLERS.register(('Alexa.PercentageController', 'SetPercentage')) @extract_entity @asyncio.coroutine -def async_api_set_percentage(hass, request, entity): +def async_api_set_percentage(hass, config, request, entity): """Process a set percentage request.""" percentage = int(request[API_PAYLOAD]['percentage']) service = None @@ -411,7 +430,7 @@ def async_api_set_percentage(hass, request, entity): @HANDLERS.register(('Alexa.PercentageController', 'AdjustPercentage')) @extract_entity @asyncio.coroutine -def async_api_adjust_percentage(hass, request, entity): +def async_api_adjust_percentage(hass, config, request, entity): """Process a adjust percentage request.""" percentage_delta = int(request[API_PAYLOAD]['percentageDelta']) service = None @@ -459,7 +478,7 @@ def async_api_adjust_percentage(hass, request, entity): @HANDLERS.register(('Alexa.LockController', 'Lock')) @extract_entity @asyncio.coroutine -def async_api_lock(hass, request, entity): +def async_api_lock(hass, config, request, entity): """Process a lock request.""" yield from hass.services.async_call(entity.domain, SERVICE_LOCK, { ATTR_ENTITY_ID: entity.entity_id @@ -472,7 +491,7 @@ def async_api_lock(hass, request, entity): @HANDLERS.register(('Alexa.LockController', 'Unlock')) @extract_entity @asyncio.coroutine -def async_api_unlock(hass, request, entity): +def async_api_unlock(hass, config, request, entity): """Process a unlock request.""" yield from hass.services.async_call(entity.domain, SERVICE_UNLOCK, { ATTR_ENTITY_ID: entity.entity_id @@ -484,7 +503,7 @@ def async_api_unlock(hass, request, entity): @HANDLERS.register(('Alexa.Speaker', 'SetVolume')) @extract_entity @asyncio.coroutine -def async_api_set_volume(hass, request, entity): +def async_api_set_volume(hass, config, request, entity): """Process a set volume request.""" volume = round(float(request[API_PAYLOAD]['volume'] / 100), 2) @@ -502,7 +521,7 @@ def async_api_set_volume(hass, request, entity): @HANDLERS.register(('Alexa.Speaker', 'AdjustVolume')) @extract_entity @asyncio.coroutine -def async_api_adjust_volume(hass, request, entity): +def async_api_adjust_volume(hass, config, request, entity): """Process a adjust volume request.""" volume_delta = int(request[API_PAYLOAD]['volume']) @@ -531,7 +550,7 @@ def async_api_adjust_volume(hass, request, entity): @HANDLERS.register(('Alexa.Speaker', 'SetMute')) @extract_entity @asyncio.coroutine -def async_api_set_mute(hass, request, entity): +def async_api_set_mute(hass, config, request, entity): """Process a set mute request.""" mute = bool(request[API_PAYLOAD]['mute']) @@ -550,7 +569,7 @@ def async_api_set_mute(hass, request, entity): @HANDLERS.register(('Alexa.PlaybackController', 'Play')) @extract_entity @asyncio.coroutine -def async_api_play(hass, request, entity): +def async_api_play(hass, config, request, entity): """Process a play request.""" data = { ATTR_ENTITY_ID: entity.entity_id @@ -565,7 +584,7 @@ def async_api_play(hass, request, entity): @HANDLERS.register(('Alexa.PlaybackController', 'Pause')) @extract_entity @asyncio.coroutine -def async_api_pause(hass, request, entity): +def async_api_pause(hass, config, request, entity): """Process a pause request.""" data = { ATTR_ENTITY_ID: entity.entity_id @@ -580,7 +599,7 @@ def async_api_pause(hass, request, entity): @HANDLERS.register(('Alexa.PlaybackController', 'Stop')) @extract_entity @asyncio.coroutine -def async_api_stop(hass, request, entity): +def async_api_stop(hass, config, request, entity): """Process a stop request.""" data = { ATTR_ENTITY_ID: entity.entity_id @@ -595,7 +614,7 @@ def async_api_stop(hass, request, entity): @HANDLERS.register(('Alexa.PlaybackController', 'Next')) @extract_entity @asyncio.coroutine -def async_api_next(hass, request, entity): +def async_api_next(hass, config, request, entity): """Process a next request.""" data = { ATTR_ENTITY_ID: entity.entity_id @@ -611,7 +630,7 @@ def async_api_next(hass, request, entity): @HANDLERS.register(('Alexa.PlaybackController', 'Previous')) @extract_entity @asyncio.coroutine -def async_api_previous(hass, request, entity): +def async_api_previous(hass, config, request, entity): """Process a previous request.""" data = { ATTR_ENTITY_ID: entity.entity_id diff --git a/homeassistant/components/cloud/__init__.py b/homeassistant/components/cloud/__init__.py index 2d01399bc07..e6da2de40f2 100644 --- a/homeassistant/components/cloud/__init__.py +++ b/homeassistant/components/cloud/__init__.py @@ -9,7 +9,9 @@ import voluptuous as vol from homeassistant.const import ( EVENT_HOMEASSISTANT_START, CONF_REGION, CONF_MODE) +from homeassistant.helpers import entityfilter from homeassistant.util import dt as dt_util +from homeassistant.components.alexa import smart_home from . import http_api, iot from .const import CONFIG_DIR, DOMAIN, SERVERS @@ -18,6 +20,8 @@ REQUIREMENTS = ['warrant==0.5.0'] _LOGGER = logging.getLogger(__name__) +CONF_ALEXA = 'alexa' +CONF_ALEXA_FILTER = 'filter' CONF_COGNITO_CLIENT_ID = 'cognito_client_id' CONF_RELAYER = 'relayer' CONF_USER_POOL_ID = 'user_pool_id' @@ -26,6 +30,13 @@ MODE_DEV = 'development' DEFAULT_MODE = MODE_DEV DEPENDENCIES = ['http'] +ALEXA_SCHEMA = vol.Schema({ + vol.Optional( + CONF_ALEXA_FILTER, + default=lambda: entityfilter.generate_filter([], [], [], []) + ): entityfilter.FILTER_SCHEMA, +}) + CONFIG_SCHEMA = vol.Schema({ DOMAIN: vol.Schema({ vol.Optional(CONF_MODE, default=DEFAULT_MODE): @@ -35,6 +46,7 @@ CONFIG_SCHEMA = vol.Schema({ vol.Required(CONF_USER_POOL_ID): str, vol.Required(CONF_REGION): str, vol.Required(CONF_RELAYER): str, + vol.Optional(CONF_ALEXA): ALEXA_SCHEMA }), }, extra=vol.ALLOW_EXTRA) @@ -47,6 +59,10 @@ def async_setup(hass, config): else: kwargs = {CONF_MODE: DEFAULT_MODE} + if CONF_ALEXA not in kwargs: + kwargs[CONF_ALEXA] = ALEXA_SCHEMA({}) + + kwargs[CONF_ALEXA] = smart_home.Config(**kwargs[CONF_ALEXA]) cloud = hass.data[DOMAIN] = Cloud(hass, **kwargs) @asyncio.coroutine @@ -64,10 +80,11 @@ class Cloud: """Store the configuration of the cloud connection.""" def __init__(self, hass, mode, cognito_client_id=None, user_pool_id=None, - region=None, relayer=None): + region=None, relayer=None, alexa=None): """Create an instance of Cloud.""" self.hass = hass self.mode = mode + self.alexa_config = alexa self.id_token = None self.access_token = None self.refresh_token = None diff --git a/homeassistant/components/cloud/iot.py b/homeassistant/components/cloud/iot.py index c0b6bb96da1..91ad1cfc6ff 100644 --- a/homeassistant/components/cloud/iot.py +++ b/homeassistant/components/cloud/iot.py @@ -206,7 +206,9 @@ def async_handle_message(hass, cloud, handler_name, payload): @asyncio.coroutine def async_handle_alexa(hass, cloud, payload): """Handle an incoming IoT message for Alexa.""" - return (yield from smart_home.async_handle_message(hass, payload)) + return (yield from smart_home.async_handle_message(hass, + cloud.alexa_config, + payload)) @HANDLERS.register('cloud') diff --git a/homeassistant/components/mqtt_statestream.py b/homeassistant/components/mqtt_statestream.py index fa1da879110..4427870c294 100644 --- a/homeassistant/components/mqtt_statestream.py +++ b/homeassistant/components/mqtt_statestream.py @@ -25,7 +25,17 @@ DEPENDENCIES = ['mqtt'] DOMAIN = 'mqtt_statestream' CONFIG_SCHEMA = vol.Schema({ - DOMAIN: cv.FILTER_SCHEMA.extend({ + DOMAIN: vol.Schema({ + vol.Optional(CONF_EXCLUDE, default={}): vol.Schema({ + vol.Optional(CONF_ENTITIES, default=[]): cv.entity_ids, + vol.Optional(CONF_DOMAINS, default=[]): + vol.All(cv.ensure_list, [cv.string]) + }), + vol.Optional(CONF_INCLUDE, default={}): vol.Schema({ + vol.Optional(CONF_ENTITIES, default=[]): cv.entity_ids, + vol.Optional(CONF_DOMAINS, default=[]): + vol.All(cv.ensure_list, [cv.string]) + }), vol.Required(CONF_BASE_TOPIC): valid_publish_topic, vol.Optional(CONF_PUBLISH_ATTRIBUTES, default=False): cv.boolean, vol.Optional(CONF_PUBLISH_TIMESTAMPS, default=False): cv.boolean diff --git a/homeassistant/helpers/config_validation.py b/homeassistant/helpers/config_validation.py index e5512b9140e..e5d0a34f76e 100644 --- a/homeassistant/helpers/config_validation.py +++ b/homeassistant/helpers/config_validation.py @@ -12,8 +12,7 @@ import voluptuous as vol from homeassistant.loader import get_platform from homeassistant.const import ( - CONF_DOMAINS, CONF_ENTITIES, CONF_EXCLUDE, CONF_INCLUDE, CONF_PLATFORM, - CONF_SCAN_INTERVAL, TEMP_CELSIUS, TEMP_FAHRENHEIT, + CONF_PLATFORM, CONF_SCAN_INTERVAL, TEMP_CELSIUS, TEMP_FAHRENHEIT, CONF_ALIAS, CONF_ENTITY_ID, CONF_VALUE_TEMPLATE, WEEKDAYS, CONF_CONDITION, CONF_BELOW, CONF_ABOVE, CONF_TIMEOUT, SUN_EVENT_SUNSET, SUN_EVENT_SUNRISE, CONF_UNIT_SYSTEM_IMPERIAL, CONF_UNIT_SYSTEM_METRIC) @@ -563,16 +562,3 @@ SCRIPT_SCHEMA = vol.All( [vol.Any(SERVICE_SCHEMA, _SCRIPT_DELAY_SCHEMA, _SCRIPT_WAIT_TEMPLATE_SCHEMA, EVENT_SCHEMA, CONDITION_SCHEMA)], ) - -FILTER_SCHEMA = vol.Schema({ - vol.Optional(CONF_EXCLUDE, default={}): vol.Schema({ - vol.Optional(CONF_ENTITIES, default=[]): entity_ids, - vol.Optional(CONF_DOMAINS, default=[]): - vol.All(ensure_list, [string]) - }), - vol.Optional(CONF_INCLUDE, default={}): vol.Schema({ - vol.Optional(CONF_ENTITIES, default=[]): entity_ids, - vol.Optional(CONF_DOMAINS, default=[]): - vol.All(ensure_list, [string]) - }) -}) diff --git a/homeassistant/helpers/entityfilter.py b/homeassistant/helpers/entityfilter.py index d8d3f1c9325..f78c70e57d3 100644 --- a/homeassistant/helpers/entityfilter.py +++ b/homeassistant/helpers/entityfilter.py @@ -1,6 +1,30 @@ """Helper class to implement include/exclude of entities and domains.""" +import voluptuous as vol + from homeassistant.core import split_entity_id +from homeassistant.helpers import config_validation as cv + +CONF_INCLUDE_DOMAINS = 'include_domains' +CONF_INCLUDE_ENTITIES = 'include_entities' +CONF_EXCLUDE_DOMAINS = 'exclude_domains' +CONF_EXCLUDE_ENTITIES = 'exclude_entities' + +FILTER_SCHEMA = vol.All( + vol.Schema({ + vol.Optional(CONF_EXCLUDE_DOMAINS, default=[]): + vol.All(cv.ensure_list, [cv.string]), + vol.Optional(CONF_EXCLUDE_ENTITIES, default=[]): cv.entity_ids, + vol.Optional(CONF_INCLUDE_DOMAINS, default=[]): + vol.All(cv.ensure_list, [cv.string]), + vol.Optional(CONF_INCLUDE_ENTITIES, default=[]): cv.entity_ids, + }), + lambda config: generate_filter( + config[CONF_INCLUDE_DOMAINS], + config[CONF_INCLUDE_ENTITIES], + config[CONF_EXCLUDE_DOMAINS], + config[CONF_EXCLUDE_ENTITIES], + )) def generate_filter(include_domains, include_entities, diff --git a/tests/components/alexa/test_smart_home.py b/tests/components/alexa/test_smart_home.py index 3fe9145f2d6..55a412af1fd 100644 --- a/tests/components/alexa/test_smart_home.py +++ b/tests/components/alexa/test_smart_home.py @@ -5,9 +5,12 @@ from uuid import uuid4 import pytest from homeassistant.components.alexa import smart_home +from homeassistant.helpers import entityfilter from tests.common import async_mock_service +DEFAULT_CONFIG = smart_home.Config(filter=lambda entity_id: True) + def get_new_request(namespace, name, endpoint=None): """Generate a new API message.""" @@ -91,7 +94,7 @@ def test_wrong_version(hass): msg['directive']['header']['payloadVersion'] = '2' with pytest.raises(AssertionError): - yield from smart_home.async_handle_message(hass, msg) + yield from smart_home.async_handle_message(hass, DEFAULT_CONFIG, msg) @asyncio.coroutine @@ -157,7 +160,8 @@ def test_discovery_request(hass): 'position': 85 }) - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -319,6 +323,67 @@ def test_discovery_request(hass): raise AssertionError("Unknown appliance!") +@asyncio.coroutine +def test_exclude_filters(hass): + """Test exclusion filters.""" + request = get_new_request('Alexa.Discovery', 'Discover') + + # setup test devices + hass.states.async_set( + 'switch.test', 'on', {'friendly_name': "Test switch"}) + + hass.states.async_set( + 'script.deny', 'off', {'friendly_name': "Blocked script"}) + + hass.states.async_set( + 'cover.deny', 'off', {'friendly_name': "Blocked cover"}) + + config = smart_home.Config(filter=entityfilter.generate_filter( + include_domains=[], + include_entities=[], + exclude_domains=['script'], + exclude_entities=['cover.deny'], + )) + + msg = yield from smart_home.async_handle_message(hass, config, request) + + msg = msg['event'] + + assert len(msg['payload']['endpoints']) == 1 + + +@asyncio.coroutine +def test_include_filters(hass): + """Test inclusion filters.""" + request = get_new_request('Alexa.Discovery', 'Discover') + + # setup test devices + hass.states.async_set( + 'switch.deny', 'on', {'friendly_name': "Blocked switch"}) + + hass.states.async_set( + 'script.deny', 'off', {'friendly_name': "Blocked script"}) + + hass.states.async_set( + 'automation.allow', 'off', {'friendly_name': "Allowed automation"}) + + hass.states.async_set( + 'group.allow', 'off', {'friendly_name': "Allowed group"}) + + config = smart_home.Config(filter=entityfilter.generate_filter( + include_domains=['automation', 'group'], + include_entities=['script.deny'], + exclude_domains=[], + exclude_entities=[], + )) + + msg = yield from smart_home.async_handle_message(hass, config, request) + + msg = msg['event'] + + assert len(msg['payload']['endpoints']) == 3 + + @asyncio.coroutine def test_api_entity_not_exists(hass): """Test api turn on process without entity.""" @@ -326,7 +391,8 @@ def test_api_entity_not_exists(hass): call_switch = async_mock_service(hass, 'switch', 'turn_on') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -341,7 +407,8 @@ def test_api_entity_not_exists(hass): def test_api_function_not_implemented(hass): """Test api call that is not implemented to us.""" request = get_new_request('Alexa.HAHAAH', 'Sweet') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -366,9 +433,15 @@ def test_api_turn_on(hass, domain): 'friendly_name': "Test {}".format(domain) }) - call = async_mock_service(hass, 'homeassistant', 'turn_on') + call_domain = domain - msg = yield from smart_home.async_handle_message(hass, request) + if domain == 'group': + call_domain = 'homeassistant' + + call = async_mock_service(hass, call_domain, 'turn_on') + + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -393,9 +466,15 @@ def test_api_turn_off(hass, domain): 'friendly_name': "Test {}".format(domain) }) - call = async_mock_service(hass, 'homeassistant', 'turn_off') + call_domain = domain - msg = yield from smart_home.async_handle_message(hass, request) + if domain == 'group': + call_domain = 'homeassistant' + + call = async_mock_service(hass, call_domain, 'turn_off') + + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -420,7 +499,8 @@ def test_api_set_brightness(hass): call_light = async_mock_service(hass, 'light', 'turn_on') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -450,7 +530,8 @@ def test_api_adjust_brightness(hass, result, adjust): call_light = async_mock_service(hass, 'light', 'turn_on') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -483,7 +564,8 @@ def test_api_set_color_rgb(hass): call_light = async_mock_service(hass, 'light', 'turn_on') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -516,7 +598,8 @@ def test_api_set_color_xy(hass): call_light = async_mock_service(hass, 'light', 'turn_on') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -544,7 +627,8 @@ def test_api_set_color_temperature(hass): call_light = async_mock_service(hass, 'light', 'turn_on') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -572,7 +656,8 @@ def test_api_decrease_color_temp(hass, result, initial): call_light = async_mock_service(hass, 'light', 'turn_on') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -600,7 +685,8 @@ def test_api_increase_color_temp(hass, result, initial): call_light = async_mock_service(hass, 'light', 'turn_on') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -626,7 +712,8 @@ def test_api_activate(hass, domain): call = async_mock_service(hass, domain, 'turn_on') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -651,7 +738,8 @@ def test_api_set_percentage_fan(hass): call_fan = async_mock_service(hass, 'fan', 'set_speed') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -679,7 +767,8 @@ def test_api_set_percentage_cover(hass): call_cover = async_mock_service(hass, 'cover', 'set_cover_position') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -709,7 +798,8 @@ def test_api_adjust_percentage_fan(hass, result, adjust): call_fan = async_mock_service(hass, 'fan', 'set_speed') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -740,7 +830,8 @@ def test_api_adjust_percentage_cover(hass, result, adjust): call_cover = async_mock_service(hass, 'cover', 'set_cover_position') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -766,7 +857,8 @@ def test_api_lock(hass, domain): call = async_mock_service(hass, domain, 'lock') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -791,7 +883,8 @@ def test_api_play(hass, domain): call = async_mock_service(hass, domain, 'media_play') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -816,7 +909,8 @@ def test_api_pause(hass, domain): call = async_mock_service(hass, domain, 'media_pause') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -841,7 +935,8 @@ def test_api_stop(hass, domain): call = async_mock_service(hass, domain, 'media_stop') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -866,7 +961,8 @@ def test_api_next(hass, domain): call = async_mock_service(hass, domain, 'media_next_track') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -891,7 +987,8 @@ def test_api_previous(hass, domain): call = async_mock_service(hass, domain, 'media_previous_track') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -918,7 +1015,8 @@ def test_api_set_volume(hass): call_media_player = async_mock_service(hass, 'media_player', 'volume_set') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -948,7 +1046,8 @@ def test_api_adjust_volume(hass, result, adjust): call_media_player = async_mock_service(hass, 'media_player', 'volume_set') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -976,7 +1075,8 @@ def test_api_mute(hass, domain): call = async_mock_service(hass, domain, 'volume_mute') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] From e1d1cf76caa54846d818b41341b65eea26c7e263 Mon Sep 17 00:00:00 2001 From: Derek Brooks Date: Fri, 17 Nov 2017 23:12:36 -0600 Subject: [PATCH 088/246] Add Facebook Notification tests (#10642) * test the facebook notification component * respond to hound feedback * remove unnecessary line breaks * parse_qs not needed with requests_mock * remove facebook notifier from .coveragerc --- .coveragerc | 1 - tests/components/notify/test_facebook.py | 129 +++++++++++++++++++++++ 2 files changed, 129 insertions(+), 1 deletion(-) create mode 100644 tests/components/notify/test_facebook.py diff --git a/.coveragerc b/.coveragerc index 01187b92d66..2b846ca5b09 100644 --- a/.coveragerc +++ b/.coveragerc @@ -426,7 +426,6 @@ omit = homeassistant/components/notify/clicksend.py homeassistant/components/notify/clicksend_tts.py homeassistant/components/notify/discord.py - homeassistant/components/notify/facebook.py homeassistant/components/notify/free_mobile.py homeassistant/components/notify/gntp.py homeassistant/components/notify/group.py diff --git a/tests/components/notify/test_facebook.py b/tests/components/notify/test_facebook.py new file mode 100644 index 00000000000..7bc7a55869a --- /dev/null +++ b/tests/components/notify/test_facebook.py @@ -0,0 +1,129 @@ +"""The test for the Facebook notify module.""" +import unittest +import requests_mock + +import homeassistant.components.notify.facebook as facebook + + +class TestFacebook(unittest.TestCase): + """Tests for Facebook notifification service.""" + + def setUp(self): + """Set up test variables.""" + access_token = "page-access-token" + self.facebook = facebook.FacebookNotificationService(access_token) + + @requests_mock.Mocker() + def test_send_simple_message(self, mock): + """Test sending a simple message with success.""" + mock.register_uri( + requests_mock.POST, + facebook.BASE_URL, + status_code=200 + ) + + message = "This is just a test" + target = ["+15555551234"] + + self.facebook.send_message(message=message, target=target) + self.assertTrue(mock.called) + self.assertEqual(mock.call_count, 1) + + expected_body = { + "recipient": {"phone_number": target[0]}, + "message": {"text": message} + } + self.assertEqual(mock.last_request.json(), expected_body) + + expected_params = {"access_token": ["page-access-token"]} + self.assertEqual(mock.last_request.qs, expected_params) + + @requests_mock.Mocker() + def test_sending_multiple_messages(self, mock): + """Test sending a message to multiple targets.""" + mock.register_uri( + requests_mock.POST, + facebook.BASE_URL, + status_code=200 + ) + + message = "This is just a test" + targets = ["+15555551234", "+15555551235"] + + self.facebook.send_message(message=message, target=targets) + self.assertTrue(mock.called) + self.assertEqual(mock.call_count, 2) + + for idx, target in enumerate(targets): + request = mock.request_history[idx] + expected_body = { + "recipient": {"phone_number": target}, + "message": {"text": message} + } + self.assertEqual(request.json(), expected_body) + + expected_params = {"access_token": ["page-access-token"]} + self.assertEqual(request.qs, expected_params) + + @requests_mock.Mocker() + def test_send_message_attachment(self, mock): + """Test sending a message with a remote attachment.""" + mock.register_uri( + requests_mock.POST, + facebook.BASE_URL, + status_code=200 + ) + + message = "This will be thrown away." + data = { + "attachment": { + "type": "image", + "payload": {"url": "http://www.example.com/image.jpg"} + } + } + target = ["+15555551234"] + + self.facebook.send_message(message=message, data=data, target=target) + self.assertTrue(mock.called) + self.assertEqual(mock.call_count, 1) + + expected_body = { + "recipient": {"phone_number": target[0]}, + "message": data + } + self.assertEqual(mock.last_request.json(), expected_body) + + expected_params = {"access_token": ["page-access-token"]} + self.assertEqual(mock.last_request.qs, expected_params) + + @requests_mock.Mocker() + def test_send_targetless_message(self, mock): + """Test sending a message without a target.""" + mock.register_uri( + requests_mock.POST, + facebook.BASE_URL, + status_code=200 + ) + + self.facebook.send_message(message="goin nowhere") + self.assertFalse(mock.called) + + @requests_mock.Mocker() + def test_send_message_with_400(self, mock): + """Test sending a message with a 400 from Facebook.""" + mock.register_uri( + requests_mock.POST, + facebook.BASE_URL, + status_code=400, + json={ + "error": { + "message": "Invalid OAuth access token.", + "type": "OAuthException", + "code": 190, + "fbtrace_id": "G4Da2pFp2Dp" + } + } + ) + self.facebook.send_message(message="nope!", target=["+15555551234"]) + self.assertTrue(mock.called) + self.assertEqual(mock.call_count, 1) From 0202e966ea250188ef4da3e4a0b29d929060e912 Mon Sep 17 00:00:00 2001 From: Aaron Bach Date: Fri, 17 Nov 2017 13:11:05 -0700 Subject: [PATCH 089/246] Fixes AirVisual bug regarding incorrect location data (#10054) * Fixes AirVisual bug regarding incorrect location data * Owner-requested changes --- homeassistant/components/sensor/airvisual.py | 47 ++++++++++---------- 1 file changed, 24 insertions(+), 23 deletions(-) diff --git a/homeassistant/components/sensor/airvisual.py b/homeassistant/components/sensor/airvisual.py index 56ddf7adcab..5ea24dab823 100644 --- a/homeassistant/components/sensor/airvisual.py +++ b/homeassistant/components/sensor/airvisual.py @@ -126,7 +126,7 @@ class AirVisualBaseSensor(Entity): def __init__(self, data, name, icon, locale): """Initialize the sensor.""" - self._data = data + self.data = data self._icon = icon self._locale = locale self._name = name @@ -136,20 +136,17 @@ class AirVisualBaseSensor(Entity): @property def device_state_attributes(self): """Return the device state attributes.""" - attrs = { + attrs = merge_two_dicts({ ATTR_ATTRIBUTION: CONF_ATTRIBUTION, - ATTR_CITY: self._data.city, - ATTR_COUNTRY: self._data.country, - ATTR_REGION: self._data.state, - ATTR_TIMESTAMP: self._data.pollution_info.get('ts') - } + ATTR_TIMESTAMP: self.data.pollution_info.get('ts') + }, self.data.attrs) - if self._data.show_on_map: - attrs[ATTR_LATITUDE] = self._data.latitude - attrs[ATTR_LONGITUDE] = self._data.longitude + if self.data.show_on_map: + attrs[ATTR_LATITUDE] = self.data.latitude + attrs[ATTR_LONGITUDE] = self.data.longitude else: - attrs['lati'] = self._data.latitude - attrs['long'] = self._data.longitude + attrs['lati'] = self.data.latitude + attrs['long'] = self.data.longitude return attrs @@ -174,9 +171,9 @@ class AirPollutionLevelSensor(AirVisualBaseSensor): def update(self): """Update the status of the sensor.""" - self._data.update() + self.data.update() - aqi = self._data.pollution_info.get('aqi{0}'.format(self._locale)) + aqi = self.data.pollution_info.get('aqi{0}'.format(self._locale)) try: [level] = [ i for i in POLLUTANT_LEVEL_MAPPING @@ -199,9 +196,9 @@ class AirQualityIndexSensor(AirVisualBaseSensor): def update(self): """Update the status of the sensor.""" - self._data.update() + self.data.update() - self._state = self._data.pollution_info.get( + self._state = self.data.pollution_info.get( 'aqi{0}'.format(self._locale)) @@ -224,9 +221,9 @@ class MainPollutantSensor(AirVisualBaseSensor): def update(self): """Update the status of the sensor.""" - self._data.update() + self.data.update() - symbol = self._data.pollution_info.get('main{0}'.format(self._locale)) + symbol = self.data.pollution_info.get('main{0}'.format(self._locale)) pollution_info = POLLUTANT_MAPPING.get(symbol, {}) self._state = pollution_info.get('label') self._unit = pollution_info.get('unit') @@ -239,6 +236,7 @@ class AirVisualData(object): def __init__(self, client, **kwargs): """Initialize the AirVisual data element.""" self._client = client + self.attrs = {} self.pollution_info = None self.city = kwargs.get(CONF_CITY) @@ -260,17 +258,20 @@ class AirVisualData(object): if self.city and self.state and self.country: resp = self._client.city( self.city, self.state, self.country).get('data') + self.longitude, self.latitude = resp.get('location').get( + 'coordinates') else: resp = self._client.nearest_city( self.latitude, self.longitude, self._radius).get('data') _LOGGER.debug("New data retrieved: %s", resp) - self.city = resp.get('city') - self.state = resp.get('state') - self.country = resp.get('country') - self.longitude, self.latitude = resp.get('location').get( - 'coordinates') self.pollution_info = resp.get('current', {}).get('pollution', {}) + + self.attrs = { + ATTR_CITY: resp.get('city'), + ATTR_REGION: resp.get('state'), + ATTR_COUNTRY: resp.get('country') + } except exceptions.HTTPError as exc_info: _LOGGER.error("Unable to retrieve data on this location: %s", self.__dict__) From bf8e2bd77ee743624a4f1a15936fa4885857f8f3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cezar=20S=C3=A1=20Espinola?= Date: Fri, 17 Nov 2017 16:29:23 -0200 Subject: [PATCH 090/246] Make MQTT reconnection logic more resilient and fix race condition (#10133) --- homeassistant/components/mqtt/__init__.py | 34 ++++++++--------------- tests/components/mqtt/test_init.py | 28 ++++++++++++------- 2 files changed, 30 insertions(+), 32 deletions(-) diff --git a/homeassistant/components/mqtt/__init__.py b/homeassistant/components/mqtt/__init__.py index 9decc9a14aa..3a6abec0ddf 100644 --- a/homeassistant/components/mqtt/__init__.py +++ b/homeassistant/components/mqtt/__init__.py @@ -438,7 +438,8 @@ class MQTT(object): self.broker = broker self.port = port self.keepalive = keepalive - self.topics = {} + self.wanted_topics = {} + self.subscribed_topics = {} self.progress = {} self.birth_message = birth_message self._mqttc = None @@ -526,15 +527,14 @@ class MQTT(object): raise HomeAssistantError("topic need to be a string!") with (yield from self._paho_lock): - if topic in self.topics: + if topic in self.subscribed_topics: return - + self.wanted_topics[topic] = qos result, mid = yield from self.hass.async_add_job( self._mqttc.subscribe, topic, qos) _raise_on_error(result) self.progress[mid] = topic - self.topics[topic] = None @asyncio.coroutine def async_unsubscribe(self, topic): @@ -542,6 +542,7 @@ class MQTT(object): This method is a coroutine. """ + self.wanted_topics.pop(topic, None) result, mid = yield from self.hass.async_add_job( self._mqttc.unsubscribe, topic) @@ -562,15 +563,10 @@ class MQTT(object): self._mqttc.disconnect() return - old_topics = self.topics - - self.topics = {key: value for key, value in self.topics.items() - if value is None} - - for topic, qos in old_topics.items(): - # qos is None if we were in process of subscribing - if qos is not None: - self.hass.add_job(self.async_subscribe, topic, qos) + self.progress = {} + self.subscribed_topics = {} + for topic, qos in self.wanted_topics.items(): + self.hass.add_job(self.async_subscribe, topic, qos) if self.birth_message: self.hass.add_job(self.async_publish( @@ -584,7 +580,7 @@ class MQTT(object): topic = self.progress.pop(mid, None) if topic is None: return - self.topics[topic] = granted_qos[0] + self.subscribed_topics[topic] = granted_qos[0] def _mqtt_on_message(self, _mqttc, _userdata, msg): """Message received callback.""" @@ -598,18 +594,12 @@ class MQTT(object): topic = self.progress.pop(mid, None) if topic is None: return - self.topics.pop(topic, None) + self.subscribed_topics.pop(topic, None) def _mqtt_on_disconnect(self, _mqttc, _userdata, result_code): """Disconnected callback.""" self.progress = {} - self.topics = {key: value for key, value in self.topics.items() - if value is not None} - - # Remove None values from topic list - for key in list(self.topics): - if self.topics[key] is None: - self.topics.pop(key) + self.subscribed_topics = {} # When disconnected because of calling disconnect() if result_code == 0: diff --git a/tests/components/mqtt/test_init.py b/tests/components/mqtt/test_init.py index 3d068224243..55ff0e9ff05 100644 --- a/tests/components/mqtt/test_init.py +++ b/tests/components/mqtt/test_init.py @@ -388,9 +388,12 @@ class TestMQTTCallbacks(unittest.TestCase): @mock.patch('homeassistant.components.mqtt.time.sleep') def test_mqtt_disconnect_tries_reconnect(self, mock_sleep): """Test the re-connect tries.""" - self.hass.data['mqtt'].topics = { + self.hass.data['mqtt'].subscribed_topics = { 'test/topic': 1, - 'test/progress': None + } + self.hass.data['mqtt'].wanted_topics = { + 'test/progress': 0, + 'test/topic': 2, } self.hass.data['mqtt'].progress = { 1: 'test/progress' @@ -403,7 +406,9 @@ class TestMQTTCallbacks(unittest.TestCase): self.assertEqual([1, 2, 4], [call[1][0] for call in mock_sleep.mock_calls]) - self.assertEqual({'test/topic': 1}, self.hass.data['mqtt'].topics) + self.assertEqual({'test/topic': 2, 'test/progress': 0}, + self.hass.data['mqtt'].wanted_topics) + self.assertEqual({}, self.hass.data['mqtt'].subscribed_topics) self.assertEqual({}, self.hass.data['mqtt'].progress) def test_invalid_mqtt_topics(self): @@ -556,12 +561,15 @@ def test_mqtt_subscribes_topics_on_connect(hass): """Test subscription to topic on connect.""" mqtt_client = yield from mock_mqtt_client(hass) - prev_topics = OrderedDict() - prev_topics['topic/test'] = 1, - prev_topics['home/sensor'] = 2, - prev_topics['still/pending'] = None + subscribed_topics = OrderedDict() + subscribed_topics['topic/test'] = 1 + subscribed_topics['home/sensor'] = 2 - hass.data['mqtt'].topics = prev_topics + wanted_topics = subscribed_topics.copy() + wanted_topics['still/pending'] = 0 + + hass.data['mqtt'].wanted_topics = wanted_topics + hass.data['mqtt'].subscribed_topics = subscribed_topics hass.data['mqtt'].progress = {1: 'still/pending'} # Return values for subscribe calls (rc, mid) @@ -574,7 +582,7 @@ def test_mqtt_subscribes_topics_on_connect(hass): assert not mqtt_client.disconnect.called - expected = [(topic, qos) for topic, qos in prev_topics.items() - if qos is not None] + expected = [(topic, qos) for topic, qos in wanted_topics.items()] assert [call[1][1:] for call in hass.add_job.mock_calls] == expected + assert hass.data['mqtt'].progress == {} From e449ceeeff8ebe0392653a2e4f7833d8e01d8c51 Mon Sep 17 00:00:00 2001 From: Robbie Trencheny Date: Fri, 17 Nov 2017 09:14:22 -0800 Subject: [PATCH 091/246] Alexa improvements (#10632) * Initial scene support * Initial fan support * ordering * Initial lock support * Scenes cant be deactivated; Correct the scene display category * Initial input_boolean support * Support customization of Alexa discovered entities * Initial media player support * Add input_boolean to tests * Add play/pause/stop/next/previous to media player * Add missing functions and pylint * Set manufacturerName to Home Assistant since the value is displayed in app * Add scene test * Add fan tests * Add lock test * Fix volume logic * Add volume tests * settup -> setup * Remove unused variable * Set required scene description as per docs * Allow setting scene category (ACTIVITY_TRIGGER/SCENE_TRIGGER) * Add alert, automation and group support/tests * Change display categories to match docs * simplify down the display category props into a single prop which can be used on any entity * Fix tests to expect proper display categories * Add cover support * sort things * Use generic homeassistant domain for turn on/off --- homeassistant/components/alexa/smart_home.py | 334 +++++++++++- tests/components/alexa/test_smart_home.py | 546 ++++++++++++++++++- 2 files changed, 853 insertions(+), 27 deletions(-) diff --git a/homeassistant/components/alexa/smart_home.py b/homeassistant/components/alexa/smart_home.py index a96386cbdf9..c5a849ad560 100644 --- a/homeassistant/components/alexa/smart_home.py +++ b/homeassistant/components/alexa/smart_home.py @@ -4,9 +4,16 @@ import logging import math from uuid import uuid4 +import homeassistant.core as ha from homeassistant.const import ( - ATTR_SUPPORTED_FEATURES, ATTR_ENTITY_ID, SERVICE_TURN_ON, SERVICE_TURN_OFF) -from homeassistant.components import switch, light, script + ATTR_ENTITY_ID, ATTR_SUPPORTED_FEATURES, SERVICE_LOCK, + SERVICE_MEDIA_NEXT_TRACK, SERVICE_MEDIA_PAUSE, SERVICE_MEDIA_PLAY, + SERVICE_MEDIA_PREVIOUS_TRACK, SERVICE_MEDIA_STOP, + SERVICE_SET_COVER_POSITION, SERVICE_TURN_OFF, SERVICE_TURN_ON, + SERVICE_UNLOCK, SERVICE_VOLUME_SET) +from homeassistant.components import ( + alert, automation, cover, fan, group, input_boolean, light, lock, + media_player, scene, script, switch) import homeassistant.util.color as color_util from homeassistant.util.decorator import Registry @@ -14,15 +21,32 @@ HANDLERS = Registry() _LOGGER = logging.getLogger(__name__) API_DIRECTIVE = 'directive' +API_ENDPOINT = 'endpoint' API_EVENT = 'event' API_HEADER = 'header' API_PAYLOAD = 'payload' -API_ENDPOINT = 'endpoint' + +ATTR_ALEXA_DESCRIPTION = 'alexa_description' +ATTR_ALEXA_DISPLAY_CATEGORIES = 'alexa_display_categories' +ATTR_ALEXA_HIDDEN = 'alexa_hidden' +ATTR_ALEXA_NAME = 'alexa_name' MAPPING_COMPONENT = { - script.DOMAIN: ['SWITCH', ('Alexa.PowerController',), None], - switch.DOMAIN: ['SWITCH', ('Alexa.PowerController',), None], + alert.DOMAIN: ['OTHER', ('Alexa.PowerController',), None], + automation.DOMAIN: ['OTHER', ('Alexa.PowerController',), None], + cover.DOMAIN: [ + 'DOOR', ('Alexa.PowerController',), { + cover.SUPPORT_SET_POSITION: 'Alexa.PercentageController', + } + ], + fan.DOMAIN: [ + 'OTHER', ('Alexa.PowerController',), { + fan.SUPPORT_SET_SPEED: 'Alexa.PercentageController', + } + ], + group.DOMAIN: ['OTHER', ('Alexa.PowerController',), None], + input_boolean.DOMAIN: ['OTHER', ('Alexa.PowerController',), None], light.DOMAIN: [ 'LIGHT', ('Alexa.PowerController',), { light.SUPPORT_BRIGHTNESS: 'Alexa.BrightnessController', @@ -31,6 +55,20 @@ MAPPING_COMPONENT = { light.SUPPORT_COLOR_TEMP: 'Alexa.ColorTemperatureController', } ], + lock.DOMAIN: ['SMARTLOCK', ('Alexa.LockController',), None], + media_player.DOMAIN: [ + 'TV', ('Alexa.PowerController',), { + media_player.SUPPORT_VOLUME_SET: 'Alexa.Speaker', + media_player.SUPPORT_PLAY: 'Alexa.PlaybackController', + media_player.SUPPORT_PAUSE: 'Alexa.PlaybackController', + media_player.SUPPORT_STOP: 'Alexa.PlaybackController', + media_player.SUPPORT_NEXT_TRACK: 'Alexa.PlaybackController', + media_player.SUPPORT_PREVIOUS_TRACK: 'Alexa.PlaybackController', + } + ], + scene.DOMAIN: ['ACTIVITY_TRIGGER', ('Alexa.SceneController',), None], + script.DOMAIN: ['OTHER', ('Alexa.PowerController',), None], + switch.DOMAIN: ['SWITCH', ('Alexa.PowerController',), None], } @@ -108,18 +146,33 @@ def async_api_discovery(hass, request): discovery_endpoints = [] for entity in hass.states.async_all(): + if entity.attributes.get(ATTR_ALEXA_HIDDEN, False): + continue + class_data = MAPPING_COMPONENT.get(entity.domain) if not class_data: continue + friendly_name = entity.attributes.get(ATTR_ALEXA_NAME, entity.name) + description = entity.attributes.get(ATTR_ALEXA_DESCRIPTION, + entity.entity_id) + + # Required description as per Amazon Scene docs + if entity.domain == scene.DOMAIN: + scene_fmt = '%s (Scene connected via Home Assistant)' + description = scene_fmt.format(description) + + cat_key = ATTR_ALEXA_DISPLAY_CATEGORIES + display_categories = entity.attributes.get(cat_key, class_data[0]) + endpoint = { - 'displayCategories': [class_data[0]], + 'displayCategories': [display_categories], 'additionalApplianceDetails': {}, 'endpointId': entity.entity_id.replace('.', '#'), - 'friendlyName': entity.name, - 'description': '', - 'manufacturerName': 'Unknown', + 'friendlyName': friendly_name, + 'description': description, + 'manufacturerName': 'Home Assistant', } actions = set() @@ -175,7 +228,7 @@ def extract_entity(funct): @asyncio.coroutine def async_api_turn_on(hass, request, entity): """Process a turn on request.""" - yield from hass.services.async_call(entity.domain, SERVICE_TURN_ON, { + yield from hass.services.async_call(ha.DOMAIN, SERVICE_TURN_ON, { ATTR_ENTITY_ID: entity.entity_id }, blocking=True) @@ -187,7 +240,7 @@ def async_api_turn_on(hass, request, entity): @asyncio.coroutine def async_api_turn_off(hass, request, entity): """Process a turn off request.""" - yield from hass.services.async_call(entity.domain, SERVICE_TURN_OFF, { + yield from hass.services.async_call(ha.DOMAIN, SERVICE_TURN_OFF, { ATTR_ENTITY_ID: entity.entity_id }, blocking=True) @@ -310,3 +363,262 @@ def async_api_increase_color_temp(hass, request, entity): }, blocking=True) return api_message(request) + + +@HANDLERS.register(('Alexa.SceneController', 'Activate')) +@extract_entity +@asyncio.coroutine +def async_api_activate(hass, request, entity): + """Process a activate request.""" + yield from hass.services.async_call(entity.domain, SERVICE_TURN_ON, { + ATTR_ENTITY_ID: entity.entity_id + }, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.PercentageController', 'SetPercentage')) +@extract_entity +@asyncio.coroutine +def async_api_set_percentage(hass, request, entity): + """Process a set percentage request.""" + percentage = int(request[API_PAYLOAD]['percentage']) + service = None + data = {ATTR_ENTITY_ID: entity.entity_id} + + if entity.domain == fan.DOMAIN: + service = fan.SERVICE_SET_SPEED + speed = "off" + + if percentage <= 33: + speed = "low" + elif percentage <= 66: + speed = "medium" + elif percentage <= 100: + speed = "high" + data[fan.ATTR_SPEED] = speed + + elif entity.domain == cover.DOMAIN: + service = SERVICE_SET_COVER_POSITION + data[cover.ATTR_POSITION] = percentage + + yield from hass.services.async_call(entity.domain, service, + data, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.PercentageController', 'AdjustPercentage')) +@extract_entity +@asyncio.coroutine +def async_api_adjust_percentage(hass, request, entity): + """Process a adjust percentage request.""" + percentage_delta = int(request[API_PAYLOAD]['percentageDelta']) + service = None + data = {ATTR_ENTITY_ID: entity.entity_id} + + if entity.domain == fan.DOMAIN: + service = fan.SERVICE_SET_SPEED + speed = entity.attributes.get(fan.ATTR_SPEED) + + if speed == "off": + current = 0 + elif speed == "low": + current = 33 + elif speed == "medium": + current = 66 + elif speed == "high": + current = 100 + + # set percentage + percentage = max(0, percentage_delta + current) + speed = "off" + + if percentage <= 33: + speed = "low" + elif percentage <= 66: + speed = "medium" + elif percentage <= 100: + speed = "high" + + data[fan.ATTR_SPEED] = speed + + elif entity.domain == cover.DOMAIN: + service = SERVICE_SET_COVER_POSITION + + current = entity.attributes.get(cover.ATTR_POSITION) + + data[cover.ATTR_POSITION] = max(0, percentage_delta + current) + + yield from hass.services.async_call(entity.domain, service, + data, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.LockController', 'Lock')) +@extract_entity +@asyncio.coroutine +def async_api_lock(hass, request, entity): + """Process a lock request.""" + yield from hass.services.async_call(entity.domain, SERVICE_LOCK, { + ATTR_ENTITY_ID: entity.entity_id + }, blocking=True) + + return api_message(request) + + +# Not supported by Alexa yet +@HANDLERS.register(('Alexa.LockController', 'Unlock')) +@extract_entity +@asyncio.coroutine +def async_api_unlock(hass, request, entity): + """Process a unlock request.""" + yield from hass.services.async_call(entity.domain, SERVICE_UNLOCK, { + ATTR_ENTITY_ID: entity.entity_id + }, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.Speaker', 'SetVolume')) +@extract_entity +@asyncio.coroutine +def async_api_set_volume(hass, request, entity): + """Process a set volume request.""" + volume = round(float(request[API_PAYLOAD]['volume'] / 100), 2) + + data = { + ATTR_ENTITY_ID: entity.entity_id, + media_player.ATTR_MEDIA_VOLUME_LEVEL: volume, + } + + yield from hass.services.async_call(entity.domain, SERVICE_VOLUME_SET, + data, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.Speaker', 'AdjustVolume')) +@extract_entity +@asyncio.coroutine +def async_api_adjust_volume(hass, request, entity): + """Process a adjust volume request.""" + volume_delta = int(request[API_PAYLOAD]['volume']) + + current_level = entity.attributes.get(media_player.ATTR_MEDIA_VOLUME_LEVEL) + + # read current state + try: + current = math.floor(int(current_level * 100)) + except ZeroDivisionError: + current = 0 + + volume = float(max(0, volume_delta + current) / 100) + + data = { + ATTR_ENTITY_ID: entity.entity_id, + media_player.ATTR_MEDIA_VOLUME_LEVEL: volume, + } + + yield from hass.services.async_call(entity.domain, + media_player.SERVICE_VOLUME_SET, + data, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.Speaker', 'SetMute')) +@extract_entity +@asyncio.coroutine +def async_api_set_mute(hass, request, entity): + """Process a set mute request.""" + mute = bool(request[API_PAYLOAD]['mute']) + + data = { + ATTR_ENTITY_ID: entity.entity_id, + media_player.ATTR_MEDIA_VOLUME_MUTED: mute, + } + + yield from hass.services.async_call(entity.domain, + media_player.SERVICE_VOLUME_MUTE, + data, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.PlaybackController', 'Play')) +@extract_entity +@asyncio.coroutine +def async_api_play(hass, request, entity): + """Process a play request.""" + data = { + ATTR_ENTITY_ID: entity.entity_id + } + + yield from hass.services.async_call(entity.domain, SERVICE_MEDIA_PLAY, + data, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.PlaybackController', 'Pause')) +@extract_entity +@asyncio.coroutine +def async_api_pause(hass, request, entity): + """Process a pause request.""" + data = { + ATTR_ENTITY_ID: entity.entity_id + } + + yield from hass.services.async_call(entity.domain, SERVICE_MEDIA_PAUSE, + data, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.PlaybackController', 'Stop')) +@extract_entity +@asyncio.coroutine +def async_api_stop(hass, request, entity): + """Process a stop request.""" + data = { + ATTR_ENTITY_ID: entity.entity_id + } + + yield from hass.services.async_call(entity.domain, SERVICE_MEDIA_STOP, + data, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.PlaybackController', 'Next')) +@extract_entity +@asyncio.coroutine +def async_api_next(hass, request, entity): + """Process a next request.""" + data = { + ATTR_ENTITY_ID: entity.entity_id + } + + yield from hass.services.async_call(entity.domain, + SERVICE_MEDIA_NEXT_TRACK, + data, blocking=True) + + return api_message(request) + + +@HANDLERS.register(('Alexa.PlaybackController', 'Previous')) +@extract_entity +@asyncio.coroutine +def async_api_previous(hass, request, entity): + """Process a previous request.""" + data = { + ATTR_ENTITY_ID: entity.entity_id + } + + yield from hass.services.async_call(entity.domain, + SERVICE_MEDIA_PREVIOUS_TRACK, + data, blocking=True) + + return api_message(request) diff --git a/tests/components/alexa/test_smart_home.py b/tests/components/alexa/test_smart_home.py index eadb72f91c0..3fe9145f2d6 100644 --- a/tests/components/alexa/test_smart_home.py +++ b/tests/components/alexa/test_smart_home.py @@ -99,7 +99,7 @@ def test_discovery_request(hass): """Test alexa discovery request.""" request = get_new_request('Alexa.Discovery', 'Discover') - # settup test devices + # setup test devices hass.states.async_set( 'switch.test', 'on', {'friendly_name': "Test switch"}) @@ -117,12 +117,52 @@ def test_discovery_request(hass): hass.states.async_set( 'script.test', 'off', {'friendly_name': "Test script"}) + hass.states.async_set( + 'input_boolean.test', 'off', {'friendly_name': "Test input boolean"}) + + hass.states.async_set( + 'scene.test', 'off', {'friendly_name': "Test scene"}) + + hass.states.async_set( + 'fan.test_1', 'off', {'friendly_name': "Test fan 1"}) + + hass.states.async_set( + 'fan.test_2', 'off', { + 'friendly_name': "Test fan 2", 'supported_features': 1, + 'speed_list': ['low', 'medium', 'high'] + }) + + hass.states.async_set( + 'lock.test', 'off', {'friendly_name': "Test lock"}) + + hass.states.async_set( + 'media_player.test', 'off', { + 'friendly_name': "Test media player", + 'supported_features': 20925, + 'volume_level': 1 + }) + + hass.states.async_set( + 'alert.test', 'off', {'friendly_name': "Test alert"}) + + hass.states.async_set( + 'automation.test', 'off', {'friendly_name': "Test automation"}) + + hass.states.async_set( + 'group.test', 'off', {'friendly_name': "Test group"}) + + hass.states.async_set( + 'cover.test', 'off', { + 'friendly_name': "Test cover", 'supported_features': 255, + 'position': 85 + }) + msg = yield from smart_home.async_handle_message(hass, request) assert 'event' in msg msg = msg['event'] - assert len(msg['payload']['endpoints']) == 5 + assert len(msg['payload']['endpoints']) == 15 assert msg['header']['name'] == 'Discover.Response' assert msg['header']['namespace'] == 'Alexa.Discovery' @@ -174,13 +214,108 @@ def test_discovery_request(hass): continue if appliance['endpointId'] == 'script#test': - assert appliance['displayCategories'][0] == "SWITCH" + assert appliance['displayCategories'][0] == "OTHER" assert appliance['friendlyName'] == "Test script" assert len(appliance['capabilities']) == 1 assert appliance['capabilities'][-1]['interface'] == \ 'Alexa.PowerController' continue + if appliance['endpointId'] == 'input_boolean#test': + assert appliance['displayCategories'][0] == "OTHER" + assert appliance['friendlyName'] == "Test input boolean" + assert len(appliance['capabilities']) == 1 + assert appliance['capabilities'][-1]['interface'] == \ + 'Alexa.PowerController' + continue + + if appliance['endpointId'] == 'scene#test': + assert appliance['displayCategories'][0] == "ACTIVITY_TRIGGER" + assert appliance['friendlyName'] == "Test scene" + assert len(appliance['capabilities']) == 1 + assert appliance['capabilities'][-1]['interface'] == \ + 'Alexa.SceneController' + continue + + if appliance['endpointId'] == 'fan#test_1': + assert appliance['displayCategories'][0] == "OTHER" + assert appliance['friendlyName'] == "Test fan 1" + assert len(appliance['capabilities']) == 1 + assert appliance['capabilities'][-1]['interface'] == \ + 'Alexa.PowerController' + continue + + if appliance['endpointId'] == 'fan#test_2': + assert appliance['displayCategories'][0] == "OTHER" + assert appliance['friendlyName'] == "Test fan 2" + assert len(appliance['capabilities']) == 2 + + caps = set() + for feature in appliance['capabilities']: + caps.add(feature['interface']) + + assert 'Alexa.PercentageController' in caps + assert 'Alexa.PowerController' in caps + continue + + if appliance['endpointId'] == 'lock#test': + assert appliance['displayCategories'][0] == "SMARTLOCK" + assert appliance['friendlyName'] == "Test lock" + assert len(appliance['capabilities']) == 1 + assert appliance['capabilities'][-1]['interface'] == \ + 'Alexa.LockController' + continue + + if appliance['endpointId'] == 'media_player#test': + assert appliance['displayCategories'][0] == "TV" + assert appliance['friendlyName'] == "Test media player" + assert len(appliance['capabilities']) == 3 + caps = set() + for feature in appliance['capabilities']: + caps.add(feature['interface']) + + assert 'Alexa.PowerController' in caps + assert 'Alexa.Speaker' in caps + assert 'Alexa.PlaybackController' in caps + continue + + if appliance['endpointId'] == 'alert#test': + assert appliance['displayCategories'][0] == "OTHER" + assert appliance['friendlyName'] == "Test alert" + assert len(appliance['capabilities']) == 1 + assert appliance['capabilities'][-1]['interface'] == \ + 'Alexa.PowerController' + continue + + if appliance['endpointId'] == 'automation#test': + assert appliance['displayCategories'][0] == "OTHER" + assert appliance['friendlyName'] == "Test automation" + assert len(appliance['capabilities']) == 1 + assert appliance['capabilities'][-1]['interface'] == \ + 'Alexa.PowerController' + continue + + if appliance['endpointId'] == 'group#test': + assert appliance['displayCategories'][0] == "OTHER" + assert appliance['friendlyName'] == "Test group" + assert len(appliance['capabilities']) == 1 + assert appliance['capabilities'][-1]['interface'] == \ + 'Alexa.PowerController' + continue + + if appliance['endpointId'] == 'cover#test': + assert appliance['displayCategories'][0] == "DOOR" + assert appliance['friendlyName'] == "Test cover" + assert len(appliance['capabilities']) == 2 + + caps = set() + for feature in appliance['capabilities']: + caps.add(feature['interface']) + + assert 'Alexa.PercentageController' in caps + assert 'Alexa.PowerController' in caps + continue + raise AssertionError("Unknown appliance!") @@ -217,19 +352,21 @@ def test_api_function_not_implemented(hass): @asyncio.coroutine -@pytest.mark.parametrize("domain", ['light', 'switch', 'script']) +@pytest.mark.parametrize("domain", ['alert', 'automation', 'group', + 'input_boolean', 'light', 'script', + 'switch']) def test_api_turn_on(hass, domain): """Test api turn on process.""" request = get_new_request( 'Alexa.PowerController', 'TurnOn', '{}#test'.format(domain)) - # settup test devices + # setup test devices hass.states.async_set( '{}.test'.format(domain), 'off', { 'friendly_name': "Test {}".format(domain) }) - call = async_mock_service(hass, domain, 'turn_on') + call = async_mock_service(hass, 'homeassistant', 'turn_on') msg = yield from smart_home.async_handle_message(hass, request) @@ -242,19 +379,21 @@ def test_api_turn_on(hass, domain): @asyncio.coroutine -@pytest.mark.parametrize("domain", ['light', 'switch', 'script']) +@pytest.mark.parametrize("domain", ['alert', 'automation', 'group', + 'input_boolean', 'light', 'script', + 'switch']) def test_api_turn_off(hass, domain): """Test api turn on process.""" request = get_new_request( 'Alexa.PowerController', 'TurnOff', '{}#test'.format(domain)) - # settup test devices + # setup test devices hass.states.async_set( '{}.test'.format(domain), 'on', { 'friendly_name': "Test {}".format(domain) }) - call = async_mock_service(hass, domain, 'turn_off') + call = async_mock_service(hass, 'homeassistant', 'turn_off') msg = yield from smart_home.async_handle_message(hass, request) @@ -275,7 +414,7 @@ def test_api_set_brightness(hass): # add payload request['directive']['payload']['brightness'] = '50' - # settup test devices + # setup test devices hass.states.async_set( 'light.test', 'off', {'friendly_name': "Test light"}) @@ -303,7 +442,7 @@ def test_api_adjust_brightness(hass, result, adjust): # add payload request['directive']['payload']['brightnessDelta'] = adjust - # settup test devices + # setup test devices hass.states.async_set( 'light.test', 'off', { 'friendly_name': "Test light", 'brightness': '77' @@ -335,7 +474,7 @@ def test_api_set_color_rgb(hass): 'brightness': '0.342', } - # settup test devices + # setup test devices hass.states.async_set( 'light.test', 'off', { 'friendly_name': "Test light", @@ -368,7 +507,7 @@ def test_api_set_color_xy(hass): 'brightness': '0.342', } - # settup test devices + # setup test devices hass.states.async_set( 'light.test', 'off', { 'friendly_name': "Test light", @@ -399,7 +538,7 @@ def test_api_set_color_temperature(hass): # add payload request['directive']['payload']['colorTemperatureInKelvin'] = '7500' - # settup test devices + # setup test devices hass.states.async_set( 'light.test', 'off', {'friendly_name': "Test light"}) @@ -424,7 +563,7 @@ def test_api_decrease_color_temp(hass, result, initial): 'Alexa.ColorTemperatureController', 'DecreaseColorTemperature', 'light#test') - # settup test devices + # setup test devices hass.states.async_set( 'light.test', 'off', { 'friendly_name': "Test light", 'color_temp': initial, @@ -452,7 +591,7 @@ def test_api_increase_color_temp(hass, result, initial): 'Alexa.ColorTemperatureController', 'IncreaseColorTemperature', 'light#test') - # settup test devices + # setup test devices hass.states.async_set( 'light.test', 'off', { 'friendly_name': "Test light", 'color_temp': initial, @@ -470,3 +609,378 @@ def test_api_increase_color_temp(hass, result, initial): assert call_light[0].data['entity_id'] == 'light.test' assert call_light[0].data['color_temp'] == result assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize("domain", ['scene']) +def test_api_activate(hass, domain): + """Test api activate process.""" + request = get_new_request( + 'Alexa.SceneController', 'Activate', '{}#test'.format(domain)) + + # setup test devices + hass.states.async_set( + '{}.test'.format(domain), 'off', { + 'friendly_name': "Test {}".format(domain) + }) + + call = async_mock_service(hass, domain, 'turn_on') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call) == 1 + assert call[0].data['entity_id'] == '{}.test'.format(domain) + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +def test_api_set_percentage_fan(hass): + """Test api set percentage for fan process.""" + request = get_new_request( + 'Alexa.PercentageController', 'SetPercentage', 'fan#test_2') + + # add payload + request['directive']['payload']['percentage'] = '50' + + # setup test devices + hass.states.async_set( + 'fan.test_2', 'off', {'friendly_name': "Test fan"}) + + call_fan = async_mock_service(hass, 'fan', 'set_speed') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call_fan) == 1 + assert call_fan[0].data['entity_id'] == 'fan.test_2' + assert call_fan[0].data['speed'] == 'medium' + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +def test_api_set_percentage_cover(hass): + """Test api set percentage for cover process.""" + request = get_new_request( + 'Alexa.PercentageController', 'SetPercentage', 'cover#test') + + # add payload + request['directive']['payload']['percentage'] = '50' + + # setup test devices + hass.states.async_set( + 'cover.test', 'closed', { + 'friendly_name': "Test cover" + }) + + call_cover = async_mock_service(hass, 'cover', 'set_cover_position') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call_cover) == 1 + assert call_cover[0].data['entity_id'] == 'cover.test' + assert call_cover[0].data['position'] == 50 + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize( + "result,adjust", [('high', '-5'), ('off', '5'), ('low', '-80')]) +def test_api_adjust_percentage_fan(hass, result, adjust): + """Test api adjust percentage for fan process.""" + request = get_new_request( + 'Alexa.PercentageController', 'AdjustPercentage', 'fan#test_2') + + # add payload + request['directive']['payload']['percentageDelta'] = adjust + + # setup test devices + hass.states.async_set( + 'fan.test_2', 'on', { + 'friendly_name': "Test fan 2", 'speed': 'high' + }) + + call_fan = async_mock_service(hass, 'fan', 'set_speed') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call_fan) == 1 + assert call_fan[0].data['entity_id'] == 'fan.test_2' + assert call_fan[0].data['speed'] == result + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize( + "result,adjust", [(25, '-5'), (35, '5'), (0, '-80')]) +def test_api_adjust_percentage_cover(hass, result, adjust): + """Test api adjust percentage for cover process.""" + request = get_new_request( + 'Alexa.PercentageController', 'AdjustPercentage', 'cover#test') + + # add payload + request['directive']['payload']['percentageDelta'] = adjust + + # setup test devices + hass.states.async_set( + 'cover.test', 'closed', { + 'friendly_name': "Test cover", + 'position': 30 + }) + + call_cover = async_mock_service(hass, 'cover', 'set_cover_position') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call_cover) == 1 + assert call_cover[0].data['entity_id'] == 'cover.test' + assert call_cover[0].data['position'] == result + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize("domain", ['lock']) +def test_api_lock(hass, domain): + """Test api lock process.""" + request = get_new_request( + 'Alexa.LockController', 'Lock', '{}#test'.format(domain)) + + # setup test devices + hass.states.async_set( + '{}.test'.format(domain), 'off', { + 'friendly_name': "Test {}".format(domain) + }) + + call = async_mock_service(hass, domain, 'lock') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call) == 1 + assert call[0].data['entity_id'] == '{}.test'.format(domain) + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize("domain", ['media_player']) +def test_api_play(hass, domain): + """Test api play process.""" + request = get_new_request( + 'Alexa.PlaybackController', 'Play', '{}#test'.format(domain)) + + # setup test devices + hass.states.async_set( + '{}.test'.format(domain), 'off', { + 'friendly_name': "Test {}".format(domain) + }) + + call = async_mock_service(hass, domain, 'media_play') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call) == 1 + assert call[0].data['entity_id'] == '{}.test'.format(domain) + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize("domain", ['media_player']) +def test_api_pause(hass, domain): + """Test api pause process.""" + request = get_new_request( + 'Alexa.PlaybackController', 'Pause', '{}#test'.format(domain)) + + # setup test devices + hass.states.async_set( + '{}.test'.format(domain), 'off', { + 'friendly_name': "Test {}".format(domain) + }) + + call = async_mock_service(hass, domain, 'media_pause') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call) == 1 + assert call[0].data['entity_id'] == '{}.test'.format(domain) + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize("domain", ['media_player']) +def test_api_stop(hass, domain): + """Test api stop process.""" + request = get_new_request( + 'Alexa.PlaybackController', 'Stop', '{}#test'.format(domain)) + + # setup test devices + hass.states.async_set( + '{}.test'.format(domain), 'off', { + 'friendly_name': "Test {}".format(domain) + }) + + call = async_mock_service(hass, domain, 'media_stop') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call) == 1 + assert call[0].data['entity_id'] == '{}.test'.format(domain) + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize("domain", ['media_player']) +def test_api_next(hass, domain): + """Test api next process.""" + request = get_new_request( + 'Alexa.PlaybackController', 'Next', '{}#test'.format(domain)) + + # setup test devices + hass.states.async_set( + '{}.test'.format(domain), 'off', { + 'friendly_name': "Test {}".format(domain) + }) + + call = async_mock_service(hass, domain, 'media_next_track') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call) == 1 + assert call[0].data['entity_id'] == '{}.test'.format(domain) + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize("domain", ['media_player']) +def test_api_previous(hass, domain): + """Test api previous process.""" + request = get_new_request( + 'Alexa.PlaybackController', 'Previous', '{}#test'.format(domain)) + + # setup test devices + hass.states.async_set( + '{}.test'.format(domain), 'off', { + 'friendly_name': "Test {}".format(domain) + }) + + call = async_mock_service(hass, domain, 'media_previous_track') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call) == 1 + assert call[0].data['entity_id'] == '{}.test'.format(domain) + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +def test_api_set_volume(hass): + """Test api set volume process.""" + request = get_new_request( + 'Alexa.Speaker', 'SetVolume', 'media_player#test') + + # add payload + request['directive']['payload']['volume'] = 50 + + # setup test devices + hass.states.async_set( + 'media_player.test', 'off', { + 'friendly_name': "Test media player", 'volume_level': 0 + }) + + call_media_player = async_mock_service(hass, 'media_player', 'volume_set') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call_media_player) == 1 + assert call_media_player[0].data['entity_id'] == 'media_player.test' + assert call_media_player[0].data['volume_level'] == 0.5 + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize( + "result,adjust", [(0.7, '-5'), (0.8, '5'), (0, '-80')]) +def test_api_adjust_volume(hass, result, adjust): + """Test api adjust volume process.""" + request = get_new_request( + 'Alexa.Speaker', 'AdjustVolume', 'media_player#test') + + # add payload + request['directive']['payload']['volume'] = adjust + + # setup test devices + hass.states.async_set( + 'media_player.test', 'off', { + 'friendly_name': "Test media player", 'volume_level': 0.75 + }) + + call_media_player = async_mock_service(hass, 'media_player', 'volume_set') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call_media_player) == 1 + assert call_media_player[0].data['entity_id'] == 'media_player.test' + assert call_media_player[0].data['volume_level'] == result + assert msg['header']['name'] == 'Response' + + +@asyncio.coroutine +@pytest.mark.parametrize("domain", ['media_player']) +def test_api_mute(hass, domain): + """Test api mute process.""" + request = get_new_request( + 'Alexa.Speaker', 'SetMute', '{}#test'.format(domain)) + + request['directive']['payload']['mute'] = True + + # setup test devices + hass.states.async_set( + '{}.test'.format(domain), 'off', { + 'friendly_name': "Test {}".format(domain) + }) + + call = async_mock_service(hass, domain, 'volume_mute') + + msg = yield from smart_home.async_handle_message(hass, request) + + assert 'event' in msg + msg = msg['event'] + + assert len(call) == 1 + assert call[0].data['entity_id'] == '{}.test'.format(domain) + assert msg['header']['name'] == 'Response' From b86110a15d6d93ea06707f3b00d338b9ea8e55a1 Mon Sep 17 00:00:00 2001 From: Andrey Date: Fri, 17 Nov 2017 18:36:18 +0200 Subject: [PATCH 092/246] Print entity type in "too slow" warnings (#10641) * Update entity.py * Update entity.py --- homeassistant/helpers/entity.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/helpers/entity.py b/homeassistant/helpers/entity.py index 4a967e50995..78db0890ab1 100644 --- a/homeassistant/helpers/entity.py +++ b/homeassistant/helpers/entity.py @@ -235,10 +235,10 @@ class Entity(object): if not self._slow_reported and end - start > 0.4: self._slow_reported = True - _LOGGER.warning("Updating state for %s took %.3f seconds. " + _LOGGER.warning("Updating state for %s (%s) took %.3f seconds. " "Please report platform to the developers at " "https://goo.gl/Nvioub", self.entity_id, - end - start) + type(self), end - start) # Overwrite properties that have been set in the config file. if DATA_CUSTOMIZE in self.hass.data: From 35699273da5dabbf48659f56020250cd54a90862 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pierre=20St=C3=A5hl?= Date: Sat, 18 Nov 2017 00:00:15 +0100 Subject: [PATCH 093/246] Bump pyatv to 0.3.8 (#10643) Fixes AirPlay issues on newer versions of tvOS. --- homeassistant/components/apple_tv.py | 2 +- requirements_all.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/apple_tv.py b/homeassistant/components/apple_tv.py index 6e38f172c4c..c8eb1841c0d 100644 --- a/homeassistant/components/apple_tv.py +++ b/homeassistant/components/apple_tv.py @@ -18,7 +18,7 @@ from homeassistant.helpers import discovery from homeassistant.components.discovery import SERVICE_APPLE_TV import homeassistant.helpers.config_validation as cv -REQUIREMENTS = ['pyatv==0.3.6'] +REQUIREMENTS = ['pyatv==0.3.8'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index 004535fd14f..405bafaf13a 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -612,7 +612,7 @@ pyasn1-modules==0.1.5 pyasn1==0.3.7 # homeassistant.components.apple_tv -pyatv==0.3.6 +pyatv==0.3.8 # homeassistant.components.device_tracker.bbox # homeassistant.components.sensor.bbox From 425c027085f859adb0e650aa2a15bbd689ccd537 Mon Sep 17 00:00:00 2001 From: Robbie Trencheny Date: Fri, 17 Nov 2017 21:10:24 -0800 Subject: [PATCH 094/246] Implement entity and domain exclude/include for Alexa (#10647) * Implement entity and domain exclude/include for Alexa * Switch to using generate_filter * Use proper domain for turn on/off calls except for groups where we must use the generic homeassistant.turn_on/off * travis fixes * Untangle * Lint --- homeassistant/components/alexa/smart_home.py | 75 +++++---- homeassistant/components/cloud/__init__.py | 19 ++- homeassistant/components/cloud/iot.py | 4 +- homeassistant/components/mqtt_statestream.py | 12 +- homeassistant/helpers/config_validation.py | 16 +- homeassistant/helpers/entityfilter.py | 24 +++ tests/components/alexa/test_smart_home.py | 158 +++++++++++++++---- 7 files changed, 233 insertions(+), 75 deletions(-) diff --git a/homeassistant/components/alexa/smart_home.py b/homeassistant/components/alexa/smart_home.py index c5a849ad560..6e71fc67df1 100644 --- a/homeassistant/components/alexa/smart_home.py +++ b/homeassistant/components/alexa/smart_home.py @@ -1,5 +1,6 @@ """Support for alexa Smart Home Skill API.""" import asyncio +from collections import namedtuple import logging import math from uuid import uuid4 @@ -72,8 +73,11 @@ MAPPING_COMPONENT = { } +Config = namedtuple('AlexaConfig', 'filter') + + @asyncio.coroutine -def async_handle_message(hass, message): +def async_handle_message(hass, config, message): """Handle incoming API messages.""" assert message[API_DIRECTIVE][API_HEADER]['payloadVersion'] == '3' @@ -89,7 +93,7 @@ def async_handle_message(hass, message): "Unsupported API request %s/%s", namespace, name) return api_error(message) - return (yield from funct_ref(hass, message)) + return (yield from funct_ref(hass, config, message)) def api_message(request, name='Response', namespace='Alexa', payload=None): @@ -138,7 +142,7 @@ def api_error(request, error_type='INTERNAL_ERROR', error_message=""): @HANDLERS.register(('Alexa.Discovery', 'Discover')) @asyncio.coroutine -def async_api_discovery(hass, request): +def async_api_discovery(hass, config, request): """Create a API formatted discovery response. Async friendly. @@ -146,7 +150,14 @@ def async_api_discovery(hass, request): discovery_endpoints = [] for entity in hass.states.async_all(): + if not config.filter(entity.entity_id): + _LOGGER.debug("Not exposing %s because filtered by config", + entity.entity_id) + continue + if entity.attributes.get(ATTR_ALEXA_HIDDEN, False): + _LOGGER.debug("Not exposing %s because alexa_hidden is true", + entity.entity_id) continue class_data = MAPPING_COMPONENT.get(entity.domain) @@ -207,7 +218,7 @@ def async_api_discovery(hass, request): def extract_entity(funct): """Decorator for extract entity object from request.""" @asyncio.coroutine - def async_api_entity_wrapper(hass, request): + def async_api_entity_wrapper(hass, config, request): """Process a turn on request.""" entity_id = request[API_ENDPOINT]['endpointId'].replace('#', '.') @@ -218,7 +229,7 @@ def extract_entity(funct): request[API_HEADER]['name'], entity_id) return api_error(request, error_type='NO_SUCH_ENDPOINT') - return (yield from funct(hass, request, entity)) + return (yield from funct(hass, config, request, entity)) return async_api_entity_wrapper @@ -226,9 +237,13 @@ def extract_entity(funct): @HANDLERS.register(('Alexa.PowerController', 'TurnOn')) @extract_entity @asyncio.coroutine -def async_api_turn_on(hass, request, entity): +def async_api_turn_on(hass, config, request, entity): """Process a turn on request.""" - yield from hass.services.async_call(ha.DOMAIN, SERVICE_TURN_ON, { + domain = entity.domain + if entity.domain == group.DOMAIN: + domain = ha.DOMAIN + + yield from hass.services.async_call(domain, SERVICE_TURN_ON, { ATTR_ENTITY_ID: entity.entity_id }, blocking=True) @@ -238,9 +253,13 @@ def async_api_turn_on(hass, request, entity): @HANDLERS.register(('Alexa.PowerController', 'TurnOff')) @extract_entity @asyncio.coroutine -def async_api_turn_off(hass, request, entity): +def async_api_turn_off(hass, config, request, entity): """Process a turn off request.""" - yield from hass.services.async_call(ha.DOMAIN, SERVICE_TURN_OFF, { + domain = entity.domain + if entity.domain == group.DOMAIN: + domain = ha.DOMAIN + + yield from hass.services.async_call(domain, SERVICE_TURN_OFF, { ATTR_ENTITY_ID: entity.entity_id }, blocking=True) @@ -250,7 +269,7 @@ def async_api_turn_off(hass, request, entity): @HANDLERS.register(('Alexa.BrightnessController', 'SetBrightness')) @extract_entity @asyncio.coroutine -def async_api_set_brightness(hass, request, entity): +def async_api_set_brightness(hass, config, request, entity): """Process a set brightness request.""" brightness = int(request[API_PAYLOAD]['brightness']) @@ -265,7 +284,7 @@ def async_api_set_brightness(hass, request, entity): @HANDLERS.register(('Alexa.BrightnessController', 'AdjustBrightness')) @extract_entity @asyncio.coroutine -def async_api_adjust_brightness(hass, request, entity): +def async_api_adjust_brightness(hass, config, request, entity): """Process a adjust brightness request.""" brightness_delta = int(request[API_PAYLOAD]['brightnessDelta']) @@ -289,7 +308,7 @@ def async_api_adjust_brightness(hass, request, entity): @HANDLERS.register(('Alexa.ColorController', 'SetColor')) @extract_entity @asyncio.coroutine -def async_api_set_color(hass, request, entity): +def async_api_set_color(hass, config, request, entity): """Process a set color request.""" supported = entity.attributes.get(ATTR_SUPPORTED_FEATURES) rgb = color_util.color_hsb_to_RGB( @@ -317,7 +336,7 @@ def async_api_set_color(hass, request, entity): @HANDLERS.register(('Alexa.ColorTemperatureController', 'SetColorTemperature')) @extract_entity @asyncio.coroutine -def async_api_set_color_temperature(hass, request, entity): +def async_api_set_color_temperature(hass, config, request, entity): """Process a set color temperature request.""" kelvin = int(request[API_PAYLOAD]['colorTemperatureInKelvin']) @@ -333,7 +352,7 @@ def async_api_set_color_temperature(hass, request, entity): ('Alexa.ColorTemperatureController', 'DecreaseColorTemperature')) @extract_entity @asyncio.coroutine -def async_api_decrease_color_temp(hass, request, entity): +def async_api_decrease_color_temp(hass, config, request, entity): """Process a decrease color temperature request.""" current = int(entity.attributes.get(light.ATTR_COLOR_TEMP)) max_mireds = int(entity.attributes.get(light.ATTR_MAX_MIREDS)) @@ -351,7 +370,7 @@ def async_api_decrease_color_temp(hass, request, entity): ('Alexa.ColorTemperatureController', 'IncreaseColorTemperature')) @extract_entity @asyncio.coroutine -def async_api_increase_color_temp(hass, request, entity): +def async_api_increase_color_temp(hass, config, request, entity): """Process a increase color temperature request.""" current = int(entity.attributes.get(light.ATTR_COLOR_TEMP)) min_mireds = int(entity.attributes.get(light.ATTR_MIN_MIREDS)) @@ -368,7 +387,7 @@ def async_api_increase_color_temp(hass, request, entity): @HANDLERS.register(('Alexa.SceneController', 'Activate')) @extract_entity @asyncio.coroutine -def async_api_activate(hass, request, entity): +def async_api_activate(hass, config, request, entity): """Process a activate request.""" yield from hass.services.async_call(entity.domain, SERVICE_TURN_ON, { ATTR_ENTITY_ID: entity.entity_id @@ -380,7 +399,7 @@ def async_api_activate(hass, request, entity): @HANDLERS.register(('Alexa.PercentageController', 'SetPercentage')) @extract_entity @asyncio.coroutine -def async_api_set_percentage(hass, request, entity): +def async_api_set_percentage(hass, config, request, entity): """Process a set percentage request.""" percentage = int(request[API_PAYLOAD]['percentage']) service = None @@ -411,7 +430,7 @@ def async_api_set_percentage(hass, request, entity): @HANDLERS.register(('Alexa.PercentageController', 'AdjustPercentage')) @extract_entity @asyncio.coroutine -def async_api_adjust_percentage(hass, request, entity): +def async_api_adjust_percentage(hass, config, request, entity): """Process a adjust percentage request.""" percentage_delta = int(request[API_PAYLOAD]['percentageDelta']) service = None @@ -459,7 +478,7 @@ def async_api_adjust_percentage(hass, request, entity): @HANDLERS.register(('Alexa.LockController', 'Lock')) @extract_entity @asyncio.coroutine -def async_api_lock(hass, request, entity): +def async_api_lock(hass, config, request, entity): """Process a lock request.""" yield from hass.services.async_call(entity.domain, SERVICE_LOCK, { ATTR_ENTITY_ID: entity.entity_id @@ -472,7 +491,7 @@ def async_api_lock(hass, request, entity): @HANDLERS.register(('Alexa.LockController', 'Unlock')) @extract_entity @asyncio.coroutine -def async_api_unlock(hass, request, entity): +def async_api_unlock(hass, config, request, entity): """Process a unlock request.""" yield from hass.services.async_call(entity.domain, SERVICE_UNLOCK, { ATTR_ENTITY_ID: entity.entity_id @@ -484,7 +503,7 @@ def async_api_unlock(hass, request, entity): @HANDLERS.register(('Alexa.Speaker', 'SetVolume')) @extract_entity @asyncio.coroutine -def async_api_set_volume(hass, request, entity): +def async_api_set_volume(hass, config, request, entity): """Process a set volume request.""" volume = round(float(request[API_PAYLOAD]['volume'] / 100), 2) @@ -502,7 +521,7 @@ def async_api_set_volume(hass, request, entity): @HANDLERS.register(('Alexa.Speaker', 'AdjustVolume')) @extract_entity @asyncio.coroutine -def async_api_adjust_volume(hass, request, entity): +def async_api_adjust_volume(hass, config, request, entity): """Process a adjust volume request.""" volume_delta = int(request[API_PAYLOAD]['volume']) @@ -531,7 +550,7 @@ def async_api_adjust_volume(hass, request, entity): @HANDLERS.register(('Alexa.Speaker', 'SetMute')) @extract_entity @asyncio.coroutine -def async_api_set_mute(hass, request, entity): +def async_api_set_mute(hass, config, request, entity): """Process a set mute request.""" mute = bool(request[API_PAYLOAD]['mute']) @@ -550,7 +569,7 @@ def async_api_set_mute(hass, request, entity): @HANDLERS.register(('Alexa.PlaybackController', 'Play')) @extract_entity @asyncio.coroutine -def async_api_play(hass, request, entity): +def async_api_play(hass, config, request, entity): """Process a play request.""" data = { ATTR_ENTITY_ID: entity.entity_id @@ -565,7 +584,7 @@ def async_api_play(hass, request, entity): @HANDLERS.register(('Alexa.PlaybackController', 'Pause')) @extract_entity @asyncio.coroutine -def async_api_pause(hass, request, entity): +def async_api_pause(hass, config, request, entity): """Process a pause request.""" data = { ATTR_ENTITY_ID: entity.entity_id @@ -580,7 +599,7 @@ def async_api_pause(hass, request, entity): @HANDLERS.register(('Alexa.PlaybackController', 'Stop')) @extract_entity @asyncio.coroutine -def async_api_stop(hass, request, entity): +def async_api_stop(hass, config, request, entity): """Process a stop request.""" data = { ATTR_ENTITY_ID: entity.entity_id @@ -595,7 +614,7 @@ def async_api_stop(hass, request, entity): @HANDLERS.register(('Alexa.PlaybackController', 'Next')) @extract_entity @asyncio.coroutine -def async_api_next(hass, request, entity): +def async_api_next(hass, config, request, entity): """Process a next request.""" data = { ATTR_ENTITY_ID: entity.entity_id @@ -611,7 +630,7 @@ def async_api_next(hass, request, entity): @HANDLERS.register(('Alexa.PlaybackController', 'Previous')) @extract_entity @asyncio.coroutine -def async_api_previous(hass, request, entity): +def async_api_previous(hass, config, request, entity): """Process a previous request.""" data = { ATTR_ENTITY_ID: entity.entity_id diff --git a/homeassistant/components/cloud/__init__.py b/homeassistant/components/cloud/__init__.py index 2d01399bc07..e6da2de40f2 100644 --- a/homeassistant/components/cloud/__init__.py +++ b/homeassistant/components/cloud/__init__.py @@ -9,7 +9,9 @@ import voluptuous as vol from homeassistant.const import ( EVENT_HOMEASSISTANT_START, CONF_REGION, CONF_MODE) +from homeassistant.helpers import entityfilter from homeassistant.util import dt as dt_util +from homeassistant.components.alexa import smart_home from . import http_api, iot from .const import CONFIG_DIR, DOMAIN, SERVERS @@ -18,6 +20,8 @@ REQUIREMENTS = ['warrant==0.5.0'] _LOGGER = logging.getLogger(__name__) +CONF_ALEXA = 'alexa' +CONF_ALEXA_FILTER = 'filter' CONF_COGNITO_CLIENT_ID = 'cognito_client_id' CONF_RELAYER = 'relayer' CONF_USER_POOL_ID = 'user_pool_id' @@ -26,6 +30,13 @@ MODE_DEV = 'development' DEFAULT_MODE = MODE_DEV DEPENDENCIES = ['http'] +ALEXA_SCHEMA = vol.Schema({ + vol.Optional( + CONF_ALEXA_FILTER, + default=lambda: entityfilter.generate_filter([], [], [], []) + ): entityfilter.FILTER_SCHEMA, +}) + CONFIG_SCHEMA = vol.Schema({ DOMAIN: vol.Schema({ vol.Optional(CONF_MODE, default=DEFAULT_MODE): @@ -35,6 +46,7 @@ CONFIG_SCHEMA = vol.Schema({ vol.Required(CONF_USER_POOL_ID): str, vol.Required(CONF_REGION): str, vol.Required(CONF_RELAYER): str, + vol.Optional(CONF_ALEXA): ALEXA_SCHEMA }), }, extra=vol.ALLOW_EXTRA) @@ -47,6 +59,10 @@ def async_setup(hass, config): else: kwargs = {CONF_MODE: DEFAULT_MODE} + if CONF_ALEXA not in kwargs: + kwargs[CONF_ALEXA] = ALEXA_SCHEMA({}) + + kwargs[CONF_ALEXA] = smart_home.Config(**kwargs[CONF_ALEXA]) cloud = hass.data[DOMAIN] = Cloud(hass, **kwargs) @asyncio.coroutine @@ -64,10 +80,11 @@ class Cloud: """Store the configuration of the cloud connection.""" def __init__(self, hass, mode, cognito_client_id=None, user_pool_id=None, - region=None, relayer=None): + region=None, relayer=None, alexa=None): """Create an instance of Cloud.""" self.hass = hass self.mode = mode + self.alexa_config = alexa self.id_token = None self.access_token = None self.refresh_token = None diff --git a/homeassistant/components/cloud/iot.py b/homeassistant/components/cloud/iot.py index c0b6bb96da1..91ad1cfc6ff 100644 --- a/homeassistant/components/cloud/iot.py +++ b/homeassistant/components/cloud/iot.py @@ -206,7 +206,9 @@ def async_handle_message(hass, cloud, handler_name, payload): @asyncio.coroutine def async_handle_alexa(hass, cloud, payload): """Handle an incoming IoT message for Alexa.""" - return (yield from smart_home.async_handle_message(hass, payload)) + return (yield from smart_home.async_handle_message(hass, + cloud.alexa_config, + payload)) @HANDLERS.register('cloud') diff --git a/homeassistant/components/mqtt_statestream.py b/homeassistant/components/mqtt_statestream.py index fa1da879110..4427870c294 100644 --- a/homeassistant/components/mqtt_statestream.py +++ b/homeassistant/components/mqtt_statestream.py @@ -25,7 +25,17 @@ DEPENDENCIES = ['mqtt'] DOMAIN = 'mqtt_statestream' CONFIG_SCHEMA = vol.Schema({ - DOMAIN: cv.FILTER_SCHEMA.extend({ + DOMAIN: vol.Schema({ + vol.Optional(CONF_EXCLUDE, default={}): vol.Schema({ + vol.Optional(CONF_ENTITIES, default=[]): cv.entity_ids, + vol.Optional(CONF_DOMAINS, default=[]): + vol.All(cv.ensure_list, [cv.string]) + }), + vol.Optional(CONF_INCLUDE, default={}): vol.Schema({ + vol.Optional(CONF_ENTITIES, default=[]): cv.entity_ids, + vol.Optional(CONF_DOMAINS, default=[]): + vol.All(cv.ensure_list, [cv.string]) + }), vol.Required(CONF_BASE_TOPIC): valid_publish_topic, vol.Optional(CONF_PUBLISH_ATTRIBUTES, default=False): cv.boolean, vol.Optional(CONF_PUBLISH_TIMESTAMPS, default=False): cv.boolean diff --git a/homeassistant/helpers/config_validation.py b/homeassistant/helpers/config_validation.py index e5512b9140e..e5d0a34f76e 100644 --- a/homeassistant/helpers/config_validation.py +++ b/homeassistant/helpers/config_validation.py @@ -12,8 +12,7 @@ import voluptuous as vol from homeassistant.loader import get_platform from homeassistant.const import ( - CONF_DOMAINS, CONF_ENTITIES, CONF_EXCLUDE, CONF_INCLUDE, CONF_PLATFORM, - CONF_SCAN_INTERVAL, TEMP_CELSIUS, TEMP_FAHRENHEIT, + CONF_PLATFORM, CONF_SCAN_INTERVAL, TEMP_CELSIUS, TEMP_FAHRENHEIT, CONF_ALIAS, CONF_ENTITY_ID, CONF_VALUE_TEMPLATE, WEEKDAYS, CONF_CONDITION, CONF_BELOW, CONF_ABOVE, CONF_TIMEOUT, SUN_EVENT_SUNSET, SUN_EVENT_SUNRISE, CONF_UNIT_SYSTEM_IMPERIAL, CONF_UNIT_SYSTEM_METRIC) @@ -563,16 +562,3 @@ SCRIPT_SCHEMA = vol.All( [vol.Any(SERVICE_SCHEMA, _SCRIPT_DELAY_SCHEMA, _SCRIPT_WAIT_TEMPLATE_SCHEMA, EVENT_SCHEMA, CONDITION_SCHEMA)], ) - -FILTER_SCHEMA = vol.Schema({ - vol.Optional(CONF_EXCLUDE, default={}): vol.Schema({ - vol.Optional(CONF_ENTITIES, default=[]): entity_ids, - vol.Optional(CONF_DOMAINS, default=[]): - vol.All(ensure_list, [string]) - }), - vol.Optional(CONF_INCLUDE, default={}): vol.Schema({ - vol.Optional(CONF_ENTITIES, default=[]): entity_ids, - vol.Optional(CONF_DOMAINS, default=[]): - vol.All(ensure_list, [string]) - }) -}) diff --git a/homeassistant/helpers/entityfilter.py b/homeassistant/helpers/entityfilter.py index d8d3f1c9325..f78c70e57d3 100644 --- a/homeassistant/helpers/entityfilter.py +++ b/homeassistant/helpers/entityfilter.py @@ -1,6 +1,30 @@ """Helper class to implement include/exclude of entities and domains.""" +import voluptuous as vol + from homeassistant.core import split_entity_id +from homeassistant.helpers import config_validation as cv + +CONF_INCLUDE_DOMAINS = 'include_domains' +CONF_INCLUDE_ENTITIES = 'include_entities' +CONF_EXCLUDE_DOMAINS = 'exclude_domains' +CONF_EXCLUDE_ENTITIES = 'exclude_entities' + +FILTER_SCHEMA = vol.All( + vol.Schema({ + vol.Optional(CONF_EXCLUDE_DOMAINS, default=[]): + vol.All(cv.ensure_list, [cv.string]), + vol.Optional(CONF_EXCLUDE_ENTITIES, default=[]): cv.entity_ids, + vol.Optional(CONF_INCLUDE_DOMAINS, default=[]): + vol.All(cv.ensure_list, [cv.string]), + vol.Optional(CONF_INCLUDE_ENTITIES, default=[]): cv.entity_ids, + }), + lambda config: generate_filter( + config[CONF_INCLUDE_DOMAINS], + config[CONF_INCLUDE_ENTITIES], + config[CONF_EXCLUDE_DOMAINS], + config[CONF_EXCLUDE_ENTITIES], + )) def generate_filter(include_domains, include_entities, diff --git a/tests/components/alexa/test_smart_home.py b/tests/components/alexa/test_smart_home.py index 3fe9145f2d6..55a412af1fd 100644 --- a/tests/components/alexa/test_smart_home.py +++ b/tests/components/alexa/test_smart_home.py @@ -5,9 +5,12 @@ from uuid import uuid4 import pytest from homeassistant.components.alexa import smart_home +from homeassistant.helpers import entityfilter from tests.common import async_mock_service +DEFAULT_CONFIG = smart_home.Config(filter=lambda entity_id: True) + def get_new_request(namespace, name, endpoint=None): """Generate a new API message.""" @@ -91,7 +94,7 @@ def test_wrong_version(hass): msg['directive']['header']['payloadVersion'] = '2' with pytest.raises(AssertionError): - yield from smart_home.async_handle_message(hass, msg) + yield from smart_home.async_handle_message(hass, DEFAULT_CONFIG, msg) @asyncio.coroutine @@ -157,7 +160,8 @@ def test_discovery_request(hass): 'position': 85 }) - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -319,6 +323,67 @@ def test_discovery_request(hass): raise AssertionError("Unknown appliance!") +@asyncio.coroutine +def test_exclude_filters(hass): + """Test exclusion filters.""" + request = get_new_request('Alexa.Discovery', 'Discover') + + # setup test devices + hass.states.async_set( + 'switch.test', 'on', {'friendly_name': "Test switch"}) + + hass.states.async_set( + 'script.deny', 'off', {'friendly_name': "Blocked script"}) + + hass.states.async_set( + 'cover.deny', 'off', {'friendly_name': "Blocked cover"}) + + config = smart_home.Config(filter=entityfilter.generate_filter( + include_domains=[], + include_entities=[], + exclude_domains=['script'], + exclude_entities=['cover.deny'], + )) + + msg = yield from smart_home.async_handle_message(hass, config, request) + + msg = msg['event'] + + assert len(msg['payload']['endpoints']) == 1 + + +@asyncio.coroutine +def test_include_filters(hass): + """Test inclusion filters.""" + request = get_new_request('Alexa.Discovery', 'Discover') + + # setup test devices + hass.states.async_set( + 'switch.deny', 'on', {'friendly_name': "Blocked switch"}) + + hass.states.async_set( + 'script.deny', 'off', {'friendly_name': "Blocked script"}) + + hass.states.async_set( + 'automation.allow', 'off', {'friendly_name': "Allowed automation"}) + + hass.states.async_set( + 'group.allow', 'off', {'friendly_name': "Allowed group"}) + + config = smart_home.Config(filter=entityfilter.generate_filter( + include_domains=['automation', 'group'], + include_entities=['script.deny'], + exclude_domains=[], + exclude_entities=[], + )) + + msg = yield from smart_home.async_handle_message(hass, config, request) + + msg = msg['event'] + + assert len(msg['payload']['endpoints']) == 3 + + @asyncio.coroutine def test_api_entity_not_exists(hass): """Test api turn on process without entity.""" @@ -326,7 +391,8 @@ def test_api_entity_not_exists(hass): call_switch = async_mock_service(hass, 'switch', 'turn_on') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -341,7 +407,8 @@ def test_api_entity_not_exists(hass): def test_api_function_not_implemented(hass): """Test api call that is not implemented to us.""" request = get_new_request('Alexa.HAHAAH', 'Sweet') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -366,9 +433,15 @@ def test_api_turn_on(hass, domain): 'friendly_name': "Test {}".format(domain) }) - call = async_mock_service(hass, 'homeassistant', 'turn_on') + call_domain = domain - msg = yield from smart_home.async_handle_message(hass, request) + if domain == 'group': + call_domain = 'homeassistant' + + call = async_mock_service(hass, call_domain, 'turn_on') + + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -393,9 +466,15 @@ def test_api_turn_off(hass, domain): 'friendly_name': "Test {}".format(domain) }) - call = async_mock_service(hass, 'homeassistant', 'turn_off') + call_domain = domain - msg = yield from smart_home.async_handle_message(hass, request) + if domain == 'group': + call_domain = 'homeassistant' + + call = async_mock_service(hass, call_domain, 'turn_off') + + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -420,7 +499,8 @@ def test_api_set_brightness(hass): call_light = async_mock_service(hass, 'light', 'turn_on') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -450,7 +530,8 @@ def test_api_adjust_brightness(hass, result, adjust): call_light = async_mock_service(hass, 'light', 'turn_on') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -483,7 +564,8 @@ def test_api_set_color_rgb(hass): call_light = async_mock_service(hass, 'light', 'turn_on') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -516,7 +598,8 @@ def test_api_set_color_xy(hass): call_light = async_mock_service(hass, 'light', 'turn_on') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -544,7 +627,8 @@ def test_api_set_color_temperature(hass): call_light = async_mock_service(hass, 'light', 'turn_on') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -572,7 +656,8 @@ def test_api_decrease_color_temp(hass, result, initial): call_light = async_mock_service(hass, 'light', 'turn_on') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -600,7 +685,8 @@ def test_api_increase_color_temp(hass, result, initial): call_light = async_mock_service(hass, 'light', 'turn_on') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -626,7 +712,8 @@ def test_api_activate(hass, domain): call = async_mock_service(hass, domain, 'turn_on') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -651,7 +738,8 @@ def test_api_set_percentage_fan(hass): call_fan = async_mock_service(hass, 'fan', 'set_speed') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -679,7 +767,8 @@ def test_api_set_percentage_cover(hass): call_cover = async_mock_service(hass, 'cover', 'set_cover_position') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -709,7 +798,8 @@ def test_api_adjust_percentage_fan(hass, result, adjust): call_fan = async_mock_service(hass, 'fan', 'set_speed') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -740,7 +830,8 @@ def test_api_adjust_percentage_cover(hass, result, adjust): call_cover = async_mock_service(hass, 'cover', 'set_cover_position') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -766,7 +857,8 @@ def test_api_lock(hass, domain): call = async_mock_service(hass, domain, 'lock') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -791,7 +883,8 @@ def test_api_play(hass, domain): call = async_mock_service(hass, domain, 'media_play') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -816,7 +909,8 @@ def test_api_pause(hass, domain): call = async_mock_service(hass, domain, 'media_pause') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -841,7 +935,8 @@ def test_api_stop(hass, domain): call = async_mock_service(hass, domain, 'media_stop') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -866,7 +961,8 @@ def test_api_next(hass, domain): call = async_mock_service(hass, domain, 'media_next_track') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -891,7 +987,8 @@ def test_api_previous(hass, domain): call = async_mock_service(hass, domain, 'media_previous_track') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -918,7 +1015,8 @@ def test_api_set_volume(hass): call_media_player = async_mock_service(hass, 'media_player', 'volume_set') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -948,7 +1046,8 @@ def test_api_adjust_volume(hass, result, adjust): call_media_player = async_mock_service(hass, 'media_player', 'volume_set') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] @@ -976,7 +1075,8 @@ def test_api_mute(hass, domain): call = async_mock_service(hass, domain, 'volume_mute') - msg = yield from smart_home.async_handle_message(hass, request) + msg = yield from smart_home.async_handle_message( + hass, DEFAULT_CONFIG, request) assert 'event' in msg msg = msg['event'] From 92fe9aadc8ad776512c25ebb5150c042bef87f1a Mon Sep 17 00:00:00 2001 From: Charles Garwood Date: Sat, 18 Nov 2017 14:04:09 -0500 Subject: [PATCH 095/246] Change some warnings to info (#10386) --- homeassistant/components/emulated_hue/__init__.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/emulated_hue/__init__.py b/homeassistant/components/emulated_hue/__init__.py index b2399d748c9..d1a58ba941e 100644 --- a/homeassistant/components/emulated_hue/__init__.py +++ b/homeassistant/components/emulated_hue/__init__.py @@ -136,7 +136,7 @@ class Config(object): self.host_ip_addr = conf.get(CONF_HOST_IP) if self.host_ip_addr is None: self.host_ip_addr = util.get_local_ip() - _LOGGER.warning( + _LOGGER.info( "Listen IP address not specified, auto-detected address is %s", self.host_ip_addr) @@ -144,7 +144,7 @@ class Config(object): self.listen_port = conf.get(CONF_LISTEN_PORT) if not isinstance(self.listen_port, int): self.listen_port = DEFAULT_LISTEN_PORT - _LOGGER.warning( + _LOGGER.info( "Listen port not specified, defaulting to %s", self.listen_port) From 6ad62a2ccbf42fc3c48a6d81917cc91572bf143f Mon Sep 17 00:00:00 2001 From: frittes <33233288+frittes@users.noreply.github.com> Date: Sat, 18 Nov 2017 21:12:16 +0100 Subject: [PATCH 096/246] Added cycles config option to LaMetric notifications (#10656) * Added cycles config option to lametric.py Added cycles config option, changed display_time to lifetime, code cleanup * Update lametric.py * Update lametric.py --- homeassistant/components/notify/lametric.py | 29 ++++++++++++--------- 1 file changed, 17 insertions(+), 12 deletions(-) diff --git a/homeassistant/components/notify/lametric.py b/homeassistant/components/notify/lametric.py index 56030afb30c..2f967dcdda4 100644 --- a/homeassistant/components/notify/lametric.py +++ b/homeassistant/components/notify/lametric.py @@ -20,35 +20,39 @@ DEPENDENCIES = ['lametric'] _LOGGER = logging.getLogger(__name__) -CONF_DISPLAY_TIME = "display_time" +CONF_LIFETIME = "lifetime" +CONF_CYCLES = "cycles" PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Optional(CONF_ICON, default="i555"): cv.string, - vol.Optional(CONF_DISPLAY_TIME, default=10): cv.positive_int, + vol.Optional(CONF_LIFETIME, default=10): cv.positive_int, + vol.Optional(CONF_CYCLES, default=1): cv.positive_int, }) # pylint: disable=unused-variable def get_service(hass, config, discovery_info=None): - """Get the Slack notification service.""" + """Get the LaMetric notification service.""" hlmn = hass.data.get(LAMETRIC_DOMAIN) return LaMetricNotificationService(hlmn, config[CONF_ICON], - config[CONF_DISPLAY_TIME] * 1000) + config[CONF_LIFETIME] * 1000, + config[CONF_CYCLES]) class LaMetricNotificationService(BaseNotificationService): """Implement the notification service for LaMetric.""" - def __init__(self, hasslametricmanager, icon, display_time): + def __init__(self, hasslametricmanager, icon, lifetime, cycles): """Initialize the service.""" self.hasslametricmanager = hasslametricmanager self._icon = icon - self._display_time = display_time + self._lifetime = lifetime + self._cycles = cycles # pylint: disable=broad-except def send_message(self, message="", **kwargs): - """Send a message to some LaMetric deviced.""" + """Send a message to some LaMetric device.""" from lmnotify import SimpleFrame, Sound, Model from oauthlib.oauth2 import TokenExpiredError @@ -56,9 +60,10 @@ class LaMetricNotificationService(BaseNotificationService): data = kwargs.get(ATTR_DATA) _LOGGER.debug("Targets/Data: %s/%s", targets, data) icon = self._icon + cycles = self._cycles sound = None - # User-defined icon? + # Additional data? if data is not None: if "icon" in data: icon = data["icon"] @@ -73,12 +78,12 @@ class LaMetricNotificationService(BaseNotificationService): data["sound"]) text_frame = SimpleFrame(icon, message) - _LOGGER.debug("Icon/Message/Duration: %s, %s, %d", - icon, message, self._display_time) + _LOGGER.debug("Icon/Message/Cycles/Lifetime: %s, %s, %d, %d", + icon, message, self._cycles, self._lifetime) frames = [text_frame] - model = Model(frames=frames, sound=sound) + model = Model(frames=frames, cycles=cycles, sound=sound) lmn = self.hasslametricmanager.manager try: devices = lmn.get_devices() @@ -89,5 +94,5 @@ class LaMetricNotificationService(BaseNotificationService): for dev in devices: if targets is None or dev["name"] in targets: lmn.set_device(dev) - lmn.send_notification(model, lifetime=self._display_time) + lmn.send_notification(model, lifetime=self._lifetime) _LOGGER.debug("Sent notification to LaMetric %s", dev["name"]) From 086f64b06c2406c45aa75743f1ed1282dcad82dd Mon Sep 17 00:00:00 2001 From: Lukas Barth Date: Sat, 18 Nov 2017 23:33:18 +0100 Subject: [PATCH 097/246] Fix yweather (#10661) --- homeassistant/components/weather/yweather.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/homeassistant/components/weather/yweather.py b/homeassistant/components/weather/yweather.py index 514eda0f09f..a043f3c2212 100644 --- a/homeassistant/components/weather/yweather.py +++ b/homeassistant/components/weather/yweather.py @@ -115,7 +115,7 @@ class YahooWeatherWeather(WeatherEntity): @property def temperature(self): """Return the temperature.""" - return self._data.yahoo.Now['temp'] + return int(self._data.yahoo.Now['temp']) @property def temperature_unit(self): From 09d826edf4c70bf9fe9636dbb11e49ae226c1e93 Mon Sep 17 00:00:00 2001 From: Giel Janssens Date: Sat, 18 Nov 2017 23:36:01 +0100 Subject: [PATCH 098/246] Netatmo httperror403 fix (#10659) * Update lnetatmo * updated zip * updated zip --- homeassistant/components/netatmo.py | 2 +- requirements_all.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/netatmo.py b/homeassistant/components/netatmo.py index 82b1b1163c3..44a54c95512 100644 --- a/homeassistant/components/netatmo.py +++ b/homeassistant/components/netatmo.py @@ -18,7 +18,7 @@ from homeassistant.util import Throttle REQUIREMENTS = [ 'https://github.com/jabesq/netatmo-api-python/archive/' - 'v0.9.2.zip#lnetatmo==0.9.2.1'] + 'v0.9.2.1.zip#lnetatmo==0.9.2.1'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index 48704667afa..f1450339058 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -352,7 +352,7 @@ https://github.com/aparraga/braviarc/archive/0.3.7.zip#braviarc==0.3.7 https://github.com/happyleavesaoc/spotipy/archive/544614f4b1d508201d363e84e871f86c90aa26b2.zip#spotipy==2.4.4 # homeassistant.components.netatmo -https://github.com/jabesq/netatmo-api-python/archive/v0.9.2.zip#lnetatmo==0.9.2.1 +https://github.com/jabesq/netatmo-api-python/archive/v0.9.2.1.zip#lnetatmo==0.9.2.1 # homeassistant.components.neato https://github.com/jabesq/pybotvac/archive/v0.0.3.zip#pybotvac==0.0.3 From 709df1e844313301451013be87f0cb837b12e3bf Mon Sep 17 00:00:00 2001 From: Anders Melchiorsen Date: Sun, 19 Nov 2017 05:20:31 +0100 Subject: [PATCH 099/246] Properly initialize Harmony remote (#10665) The delay_secs variable was not initialized if discovery was active and no matching configuration block existed (i.e. override was None). --- homeassistant/components/remote/harmony.py | 1 + 1 file changed, 1 insertion(+) diff --git a/homeassistant/components/remote/harmony.py b/homeassistant/components/remote/harmony.py index 7a398def5f9..40536a83602 100755 --- a/homeassistant/components/remote/harmony.py +++ b/homeassistant/components/remote/harmony.py @@ -60,6 +60,7 @@ def setup_platform(hass, config, add_devices, discovery_info=None): False) port = DEFAULT_PORT + delay_secs = DEFAULT_DELAY_SECS if override: activity = override.get(ATTR_ACTIVITY) delay_secs = override.get(ATTR_DELAY_SECS) From 50775ce5090b74c7f2f2709b82ce5e3c7911f549 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sun, 19 Nov 2017 14:37:07 +0100 Subject: [PATCH 100/246] Bump dev to 0.59.0.dev0 (#10675) --- homeassistant/const.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/homeassistant/const.py b/homeassistant/const.py index d08308de820..eeff5773640 100644 --- a/homeassistant/const.py +++ b/homeassistant/const.py @@ -1,7 +1,7 @@ # coding: utf-8 """Constants used by Home Assistant components.""" MAJOR_VERSION = 0 -MINOR_VERSION = 58 +MINOR_VERSION = 59 PATCH_VERSION = '0.dev0' __short_version__ = '{}.{}'.format(MAJOR_VERSION, MINOR_VERSION) __version__ = '{}.{}'.format(__short_version__, PATCH_VERSION) From 2031b2803f2f75e0a4588410dc26dac5e289b97a Mon Sep 17 00:00:00 2001 From: PeteBa Date: Sun, 19 Nov 2017 20:30:47 +0000 Subject: [PATCH 101/246] Include unit_of_measurement as InfluxDb field (#9790) --- homeassistant/components/influxdb.py | 5 +++- tests/components/test_influxdb.py | 42 ++++++++++++++++++++++++++++ 2 files changed, 46 insertions(+), 1 deletion(-) diff --git a/homeassistant/components/influxdb.py b/homeassistant/components/influxdb.py index b41deb5e5e3..0006b052ab2 100644 --- a/homeassistant/components/influxdb.py +++ b/homeassistant/components/influxdb.py @@ -151,6 +151,7 @@ def setup(hass, config): _state = state.state _state_key = "state" + include_uom = True measurement = component_config.get(state.entity_id).get( CONF_OVERRIDE_MEASUREMENT) if measurement in (None, ''): @@ -163,6 +164,8 @@ def setup(hass, config): measurement = default_measurement else: measurement = state.entity_id + else: + include_uom = False json_body = [ { @@ -181,7 +184,7 @@ def setup(hass, config): for key, value in state.attributes.items(): if key in tags_attributes: json_body[0]['tags'][key] = value - elif key != 'unit_of_measurement': + elif key != 'unit_of_measurement' or include_uom: # If the key is already in fields if key in json_body[0]['fields']: key = key + "_" diff --git a/tests/components/test_influxdb.py b/tests/components/test_influxdb.py index 7c98dfcd540..8815b9eee4a 100644 --- a/tests/components/test_influxdb.py +++ b/tests/components/test_influxdb.py @@ -532,6 +532,48 @@ class TestInfluxDB(unittest.TestCase): self.assertFalse(mock_client.return_value.write_points.called) mock_client.return_value.write_points.reset_mock() + def test_event_listener_unit_of_measurement_field(self, mock_client): + """Test the event listener for unit of measurement field.""" + config = { + 'influxdb': { + 'host': 'host', + 'username': 'user', + 'password': 'pass', + 'override_measurement': 'state', + } + } + assert setup_component(self.hass, influxdb.DOMAIN, config) + self.handler_method = self.hass.bus.listen.call_args_list[0][0][1] + + attrs = { + 'unit_of_measurement': 'foobars', + } + state = mock.MagicMock( + state='foo', domain='fake', entity_id='fake.entity-id', + object_id='entity', attributes=attrs) + event = mock.MagicMock(data={'new_state': state}, time_fired=12345) + body = [{ + 'measurement': 'state', + 'tags': { + 'domain': 'fake', + 'entity_id': 'entity', + }, + 'time': 12345, + 'fields': { + 'state': 'foo', + 'unit_of_measurement_str': 'foobars', + }, + }] + self.handler_method(event) + self.assertEqual( + mock_client.return_value.write_points.call_count, 1 + ) + self.assertEqual( + mock_client.return_value.write_points.call_args, + mock.call(body) + ) + mock_client.return_value.write_points.reset_mock() + def test_event_listener_tags_attributes(self, mock_client): """Test the event listener when some attributes should be tags.""" config = { From b548116f9bbaa75d61900c6dd1059249195094d4 Mon Sep 17 00:00:00 2001 From: Philip Kleimeyer Date: Sun, 19 Nov 2017 21:35:13 +0100 Subject: [PATCH 102/246] Tahoma platform for Somfy Covers and Sensors (#10652) Tahoma platform for Somfy Covers and Sensors --- .coveragerc | 3 + CODEOWNERS | 2 + homeassistant/components/cover/tahoma.py | 73 +++++++++++++ homeassistant/components/sensor/tahoma.py | 61 +++++++++++ homeassistant/components/tahoma.py | 120 ++++++++++++++++++++++ requirements_all.txt | 3 + 6 files changed, 262 insertions(+) create mode 100644 homeassistant/components/cover/tahoma.py create mode 100644 homeassistant/components/sensor/tahoma.py create mode 100644 homeassistant/components/tahoma.py diff --git a/.coveragerc b/.coveragerc index 2b846ca5b09..dd3874a9ffd 100644 --- a/.coveragerc +++ b/.coveragerc @@ -182,6 +182,9 @@ omit = homeassistant/components/tado.py homeassistant/components/*/tado.py + homeassistant/components/tahoma.py + homeassistant/components/*/tahoma.py + homeassistant/components/tellduslive.py homeassistant/components/*/tellduslive.py diff --git a/CODEOWNERS b/CODEOWNERS index 82ae451e59c..66007f53d7e 100644 --- a/CODEOWNERS +++ b/CODEOWNERS @@ -68,6 +68,8 @@ homeassistant/components/velux.py @Julius2342 homeassistant/components/*/velux.py @Julius2342 homeassistant/components/knx.py @Julius2342 homeassistant/components/*/knx.py @Julius2342 +homeassistant/components/tahoma.py @philklei +homeassistant/components/*/tahoma.py @philklei homeassistant/components/tesla.py @zabuldon homeassistant/components/*/tesla.py @zabuldon homeassistant/components/*/tradfri.py @ggravlingen diff --git a/homeassistant/components/cover/tahoma.py b/homeassistant/components/cover/tahoma.py new file mode 100644 index 00000000000..ce668cfe876 --- /dev/null +++ b/homeassistant/components/cover/tahoma.py @@ -0,0 +1,73 @@ +""" +Support for Tahoma cover - shutters etc. + +For more details about this platform, please refer to the documentation at +https://home-assistant.io/components/cover.tahoma/ +""" +import logging + +from homeassistant.components.cover import CoverDevice, ENTITY_ID_FORMAT +from homeassistant.components.tahoma import ( + DOMAIN as TAHOMA_DOMAIN, TahomaDevice) + +DEPENDENCIES = ['tahoma'] + +_LOGGER = logging.getLogger(__name__) + + +def setup_platform(hass, config, add_devices, discovery_info=None): + """Set up Tahoma covers.""" + controller = hass.data[TAHOMA_DOMAIN]['controller'] + devices = [] + for device in hass.data[TAHOMA_DOMAIN]['devices']['cover']: + devices.append(TahomaCover(device, controller)) + add_devices(devices, True) + + +class TahomaCover(TahomaDevice, CoverDevice): + """Representation a Tahoma Cover.""" + + def __init__(self, tahoma_device, controller): + """Initialize the Tahoma device.""" + super().__init__(tahoma_device, controller) + self.entity_id = ENTITY_ID_FORMAT.format(self.unique_id) + + def update(self): + """Update method.""" + self.controller.get_states([self.tahoma_device]) + + @property + def current_cover_position(self): + """ + Return current position of cover. + + 0 is closed, 100 is fully open. + """ + position = 100 - self.tahoma_device.active_states['core:ClosureState'] + if position <= 5: + return 0 + if position >= 95: + return 100 + return position + + def set_cover_position(self, position, **kwargs): + """Move the cover to a specific position.""" + self.apply_action('setPosition', 100 - position) + + @property + def is_closed(self): + """Return if the cover is closed.""" + if self.current_cover_position is not None: + return self.current_cover_position == 0 + + def open_cover(self, **kwargs): + """Open the cover.""" + self.apply_action('open') + + def close_cover(self, **kwargs): + """Close the cover.""" + self.apply_action('close') + + def stop_cover(self, **kwargs): + """Stop the cover.""" + self.apply_action('stopIdentify') diff --git a/homeassistant/components/sensor/tahoma.py b/homeassistant/components/sensor/tahoma.py new file mode 100644 index 00000000000..d0b038fd230 --- /dev/null +++ b/homeassistant/components/sensor/tahoma.py @@ -0,0 +1,61 @@ +""" +Support for Tahoma sensors. + +For more details about this platform, please refer to the documentation at +https://home-assistant.io/components/sensor.tahoma/ +""" + +import logging +from datetime import timedelta + +from homeassistant.helpers.entity import Entity +from homeassistant.components.sensor import ENTITY_ID_FORMAT +from homeassistant.components.tahoma import ( + DOMAIN as TAHOMA_DOMAIN, TahomaDevice) + +DEPENDENCIES = ['tahoma'] + +_LOGGER = logging.getLogger(__name__) + +SCAN_INTERVAL = timedelta(seconds=10) + + +def setup_platform(hass, config, add_devices, discovery_info=None): + """Set up Tahoma controller devices.""" + controller = hass.data[TAHOMA_DOMAIN]['controller'] + devices = [] + for device in hass.data[TAHOMA_DOMAIN]['devices']['sensor']: + devices.append(TahomaSensor(device, controller)) + add_devices(devices, True) + + +class TahomaSensor(TahomaDevice, Entity): + """Representation of a Tahoma Sensor.""" + + def __init__(self, tahoma_device, controller): + """Initialize the sensor.""" + self.current_value = None + super().__init__(tahoma_device, controller) + self.entity_id = ENTITY_ID_FORMAT.format(self.unique_id) + + @property + def state(self): + """Return the name of the sensor.""" + return self.current_value + + @property + def unit_of_measurement(self): + """Return the unit of measurement of this entity, if any.""" + if self.tahoma_device.type == 'Temperature Sensor': + return None + elif self.tahoma_device.type == 'io:LightIOSystemSensor': + return 'lux' + elif self.tahoma_device.type == 'Humidity Sensor': + return '%' + + def update(self): + """Update the state.""" + self.controller.get_states([self.tahoma_device]) + if self.tahoma_device.type == 'io:LightIOSystemSensor': + self.current_value = self.tahoma_device.active_states[ + 'core:LuminanceState'] diff --git a/homeassistant/components/tahoma.py b/homeassistant/components/tahoma.py new file mode 100644 index 00000000000..129c6506ac1 --- /dev/null +++ b/homeassistant/components/tahoma.py @@ -0,0 +1,120 @@ +""" +Support for Tahoma devices. + +For more details about this component, please refer to the documentation at +https://home-assistant.io/components/tahoma/ +""" +from collections import defaultdict +import logging +import voluptuous as vol +from requests.exceptions import RequestException + +from homeassistant.const import CONF_USERNAME, CONF_PASSWORD, CONF_EXCLUDE +from homeassistant.helpers import discovery +from homeassistant.helpers import config_validation as cv +from homeassistant.helpers.entity import Entity +from homeassistant.util import (slugify) + +REQUIREMENTS = ['tahoma-api==0.0.10'] + +_LOGGER = logging.getLogger(__name__) + +DOMAIN = 'tahoma' + +TAHOMA_ID_FORMAT = '{}_{}' + +CONFIG_SCHEMA = vol.Schema({ + DOMAIN: vol.Schema({ + vol.Required(CONF_USERNAME): cv.string, + vol.Required(CONF_PASSWORD): cv.string, + vol.Optional(CONF_EXCLUDE, default=[]): + vol.All(cv.ensure_list, [cv.string]), + }), +}, extra=vol.ALLOW_EXTRA) + +TAHOMA_COMPONENTS = [ + 'sensor', 'cover' +] + + +def setup(hass, config): + """Activate Tahoma component.""" + from tahoma_api import TahomaApi + + conf = config[DOMAIN] + username = conf.get(CONF_USERNAME) + password = conf.get(CONF_PASSWORD) + exclude = conf.get(CONF_EXCLUDE) + try: + api = TahomaApi(username, password) + except RequestException: + _LOGGER.exception("Error communicating with Tahoma API") + return False + + try: + api.get_setup() + devices = api.get_devices() + except RequestException: + _LOGGER.exception("Cannot fetch informations from Tahoma API") + return False + + hass.data[DOMAIN] = { + 'controller': api, + 'devices': defaultdict(list) + } + + for device in devices: + _device = api.get_device(device) + if all(ext not in _device.type for ext in exclude): + device_type = map_tahoma_device(_device) + if device_type is None: + continue + hass.data[DOMAIN]['devices'][device_type].append(_device) + + for component in TAHOMA_COMPONENTS: + discovery.load_platform(hass, component, DOMAIN, {}, config) + + return True + + +def map_tahoma_device(tahoma_device): + """Map tahoma classes to Home Assistant types.""" + if tahoma_device.type.lower().find("shutter") != -1: + return 'cover' + elif tahoma_device.type == 'io:LightIOSystemSensor': + return 'sensor' + return None + + +class TahomaDevice(Entity): + """Representation of a Tahoma device entity.""" + + def __init__(self, tahoma_device, controller): + """Initialize the device.""" + self.tahoma_device = tahoma_device + self.controller = controller + self._unique_id = TAHOMA_ID_FORMAT.format( + slugify(tahoma_device.label), slugify(tahoma_device.url)) + self._name = self.tahoma_device.label + + @property + def unique_id(self): + """Return the unique ID for this cover.""" + return self._unique_id + + @property + def name(self): + """Return the name of the device.""" + return self._name + + @property + def device_state_attributes(self): + """Return the state attributes of the device.""" + return {'tahoma_device_id': self.tahoma_device.url} + + def apply_action(self, cmd_name, *args): + """Apply Action to Device.""" + from tahoma_api import Action + action = Action(self.tahoma_device.url) + action.add_command(cmd_name, *args) + self.controller.apply_actions('', [action]) diff --git a/requirements_all.txt b/requirements_all.txt index f1450339058..520848166d0 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -1044,6 +1044,9 @@ steamodd==4.21 # homeassistant.components.camera.onvif suds-py3==1.3.3.0 +# homeassistant.components.tahoma +tahoma-api==0.0.10 + # homeassistant.components.sensor.tank_utility tank_utility==1.4.0 From fb32cc39e1c78460d993bccf88a092b2a54a421e Mon Sep 17 00:00:00 2001 From: PeteBa Date: Sun, 19 Nov 2017 22:49:49 +0000 Subject: [PATCH 103/246] Populate measurement state field for HA states like home/not_home (#9833) --- homeassistant/components/influxdb.py | 18 +++- tests/components/test_influxdb.py | 145 +++++++++++---------------- 2 files changed, 71 insertions(+), 92 deletions(-) diff --git a/homeassistant/components/influxdb.py b/homeassistant/components/influxdb.py index 0006b052ab2..55b0f08a711 100644 --- a/homeassistant/components/influxdb.py +++ b/homeassistant/components/influxdb.py @@ -145,11 +145,16 @@ def setup(hass, config): (whitelist_d and state.domain not in whitelist_d): return - _state = float(state_helper.state_as_number(state)) - _state_key = "value" + _include_state = _include_value = False + + _state_as_value = float(state.state) + _include_value = True except ValueError: - _state = state.state - _state_key = "state" + try: + _state_as_value = float(state_helper.state_as_number(state)) + _include_state = _include_value = True + except ValueError: + _include_state = True include_uom = True measurement = component_config.get(state.entity_id).get( @@ -176,10 +181,13 @@ def setup(hass, config): }, 'time': event.time_fired, 'fields': { - _state_key: _state, } } ] + if _include_state: + json_body[0]['fields']['state'] = state.state + if _include_value: + json_body[0]['fields']['value'] = _state_as_value for key, value in state.attributes.items(): if key in tags_attributes: diff --git a/tests/components/test_influxdb.py b/tests/components/test_influxdb.py index 8815b9eee4a..6c52663051c 100644 --- a/tests/components/test_influxdb.py +++ b/tests/components/test_influxdb.py @@ -7,7 +7,8 @@ import influxdb as influx_client from homeassistant.setup import setup_component import homeassistant.components.influxdb as influxdb -from homeassistant.const import EVENT_STATE_CHANGED, STATE_OFF, STATE_ON +from homeassistant.const import EVENT_STATE_CHANGED, STATE_OFF, STATE_ON, \ + STATE_STANDBY from tests.common import get_test_home_assistant @@ -110,12 +111,14 @@ class TestInfluxDB(unittest.TestCase): """Test the event listener.""" self._setup() + # map of HA State to valid influxdb [state, value] fields valid = { - '1': 1, - '1.0': 1.0, - STATE_ON: 1, - STATE_OFF: 0, - 'foo': 'foo' + '1': [None, 1], + '1.0': [None, 1.0], + STATE_ON: [STATE_ON, 1], + STATE_OFF: [STATE_OFF, 0], + STATE_STANDBY: [STATE_STANDBY, None], + 'foo': ['foo', None] } for in_, out in valid.items(): attrs = { @@ -132,53 +135,32 @@ class TestInfluxDB(unittest.TestCase): state=in_, domain='fake', entity_id='fake.entity-id', object_id='entity', attributes=attrs) event = mock.MagicMock(data={'new_state': state}, time_fired=12345) - if isinstance(out, str): - body = [{ - 'measurement': 'foobars', - 'tags': { - 'domain': 'fake', - 'entity_id': 'entity', - }, - 'time': 12345, - 'fields': { - 'state': out, - 'longitude': 1.1, - 'latitude': 2.2, - 'battery_level_str': '99%', - 'battery_level': 99.0, - 'temperature_str': '20c', - 'temperature': 20.0, - 'last_seen_str': 'Last seen 23 minutes ago', - 'last_seen': 23.0, - 'updated_at_str': '2017-01-01 00:00:00', - 'updated_at': 20170101000000, - 'multi_periods_str': '0.120.240.2023873' - }, - }] + body = [{ + 'measurement': 'foobars', + 'tags': { + 'domain': 'fake', + 'entity_id': 'entity', + }, + 'time': 12345, + 'fields': { + 'longitude': 1.1, + 'latitude': 2.2, + 'battery_level_str': '99%', + 'battery_level': 99.0, + 'temperature_str': '20c', + 'temperature': 20.0, + 'last_seen_str': 'Last seen 23 minutes ago', + 'last_seen': 23.0, + 'updated_at_str': '2017-01-01 00:00:00', + 'updated_at': 20170101000000, + 'multi_periods_str': '0.120.240.2023873' + }, + }] + if out[0] is not None: + body[0]['fields']['state'] = out[0] + if out[1] is not None: + body[0]['fields']['value'] = out[1] - else: - body = [{ - 'measurement': 'foobars', - 'tags': { - 'domain': 'fake', - 'entity_id': 'entity', - }, - 'time': 12345, - 'fields': { - 'value': out, - 'longitude': 1.1, - 'latitude': 2.2, - 'battery_level_str': '99%', - 'battery_level': 99.0, - 'temperature_str': '20c', - 'temperature': 20.0, - 'last_seen_str': 'Last seen 23 minutes ago', - 'last_seen': 23.0, - 'updated_at_str': '2017-01-01 00:00:00', - 'updated_at': 20170101000000, - 'multi_periods_str': '0.120.240.2023873' - }, - }] self.handler_method(event) self.assertEqual( mock_client.return_value.write_points.call_count, 1 @@ -428,12 +410,14 @@ class TestInfluxDB(unittest.TestCase): """Test the event listener when an attribute has an invalid type.""" self._setup() + # map of HA State to valid influxdb [state, value] fields valid = { - '1': 1, - '1.0': 1.0, - STATE_ON: 1, - STATE_OFF: 0, - 'foo': 'foo' + '1': [None, 1], + '1.0': [None, 1.0], + STATE_ON: [STATE_ON, 1], + STATE_OFF: [STATE_OFF, 0], + STATE_STANDBY: [STATE_STANDBY, None], + 'foo': ['foo', None] } for in_, out in valid.items(): attrs = { @@ -446,37 +430,24 @@ class TestInfluxDB(unittest.TestCase): state=in_, domain='fake', entity_id='fake.entity-id', object_id='entity', attributes=attrs) event = mock.MagicMock(data={'new_state': state}, time_fired=12345) - if isinstance(out, str): - body = [{ - 'measurement': 'foobars', - 'tags': { - 'domain': 'fake', - 'entity_id': 'entity', - }, - 'time': 12345, - 'fields': { - 'state': out, - 'longitude': 1.1, - 'latitude': 2.2, - 'invalid_attribute_str': "['value1', 'value2']" - }, - }] + body = [{ + 'measurement': 'foobars', + 'tags': { + 'domain': 'fake', + 'entity_id': 'entity', + }, + 'time': 12345, + 'fields': { + 'longitude': 1.1, + 'latitude': 2.2, + 'invalid_attribute_str': "['value1', 'value2']" + }, + }] + if out[0] is not None: + body[0]['fields']['state'] = out[0] + if out[1] is not None: + body[0]['fields']['value'] = out[1] - else: - body = [{ - 'measurement': 'foobars', - 'tags': { - 'domain': 'fake', - 'entity_id': 'entity', - }, - 'time': 12345, - 'fields': { - 'value': float(out), - 'longitude': 1.1, - 'latitude': 2.2, - 'invalid_attribute_str': "['value1', 'value2']" - }, - }] self.handler_method(event) self.assertEqual( mock_client.return_value.write_points.call_count, 1 From 3f5c7485600a34c39f02787cb633bcc723515d33 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sun, 19 Nov 2017 17:39:24 -0800 Subject: [PATCH 104/246] Reorganize lint travis builds (#10670) * tox cleanup * 1 tox step * Revert pytest sugar changes * Tox: make pylint its own task * Bump Travis to 30 minutes timeout --- .travis.yml | 8 ++++---- script/setup | 1 - setup.cfg | 5 +---- tox.ini | 11 ++++++----- 4 files changed, 11 insertions(+), 14 deletions(-) diff --git a/.travis.yml b/.travis.yml index fdc5650db22..3d6789ea586 100644 --- a/.travis.yml +++ b/.travis.yml @@ -8,18 +8,18 @@ matrix: include: - python: "3.4.2" env: TOXENV=lint + - python: "3.4.2" + env: TOXENV=pylint - python: "3.4.2" env: TOXENV=py34 # - python: "3.5" # env: TOXENV=typing - - python: "3.5" + - python: "3.5.3" env: TOXENV=py35 - python: "3.6" env: TOXENV=py36 # - python: "3.6-dev" # env: TOXENV=py36 - - python: "3.4.2" - env: TOXENV=requirements # allow_failures: # - python: "3.5" # env: TOXENV=typing @@ -29,5 +29,5 @@ cache: - $HOME/.cache/pip install: pip install -U tox coveralls language: python -script: travis_wait tox +script: travis_wait 30 tox --develop after_success: coveralls diff --git a/script/setup b/script/setup index f554efe9153..554389e063e 100755 --- a/script/setup +++ b/script/setup @@ -5,7 +5,6 @@ set -e cd "$(dirname "$0")/.." -git submodule init script/bootstrap pip3 install -e . diff --git a/setup.cfg b/setup.cfg index f6cc8bd45b9..d6dfdfe0ea5 100644 --- a/setup.cfg +++ b/setup.cfg @@ -6,10 +6,7 @@ testpaths = tests norecursedirs = .git testing_config [flake8] -exclude = .venv,.git,.tox,docs,www_static,venv,bin,lib,deps,build - -[pydocstyle] -match_dir = ^((?!\.|www_static).)*$ +exclude = .venv,.git,.tox,docs,venv,bin,lib,deps,build [isort] # https://github.com/timothycrosley/isort diff --git a/tox.ini b/tox.ini index e3063af8f40..f3e58ce8889 100644 --- a/tox.ini +++ b/tox.ini @@ -12,12 +12,12 @@ setenv = whitelist_externals = /usr/bin/env install_command = /usr/bin/env LANG=C.UTF-8 pip install {opts} {packages} commands = - py.test --timeout=30 --duration=10 --cov --cov-report= {posargs} + py.test --timeout=15 --duration=10 --cov --cov-report= {posargs} deps = -r{toxinidir}/requirements_test_all.txt -c{toxinidir}/homeassistant/package_constraints.txt -[testenv:lint] +[testenv:pylint] basepython = python3 ignore_errors = True deps = @@ -25,15 +25,16 @@ deps = -r{toxinidir}/requirements_test.txt -c{toxinidir}/homeassistant/package_constraints.txt commands = - flake8 pylint homeassistant - pydocstyle homeassistant tests -[testenv:requirements] +[testenv:lint] basepython = python3 deps = + -r{toxinidir}/requirements_test.txt commands = python script/gen_requirements_all.py validate + flake8 + pydocstyle homeassistant tests [testenv:typing] basepython = python3 From 7695ca2c8b189f0017556772233b1e9de658366f Mon Sep 17 00:00:00 2001 From: Egor Tsinko Date: Sun, 19 Nov 2017 20:41:30 -0700 Subject: [PATCH 105/246] Fix for time_date sensor (#10694) * fix to time_date sensor * cleaned up the code and added unit tests * fixed lint errors --- homeassistant/components/sensor/time_date.py | 2 +- tests/components/sensor/test_time_date.py | 27 ++++++++++++++++---- 2 files changed, 23 insertions(+), 6 deletions(-) diff --git a/homeassistant/components/sensor/time_date.py b/homeassistant/components/sensor/time_date.py index 69723aea19a..bfdf0c3c3aa 100644 --- a/homeassistant/components/sensor/time_date.py +++ b/homeassistant/components/sensor/time_date.py @@ -90,7 +90,7 @@ class TimeDateSensor(Entity): if now is None: now = dt_util.utcnow() if self.type == 'date': - now = dt_util.start_of_local_day(now) + now = dt_util.start_of_local_day(dt_util.as_local(now)) return now + timedelta(seconds=86400) elif self.type == 'beat': interval = 86.4 diff --git a/tests/components/sensor/test_time_date.py b/tests/components/sensor/test_time_date.py index 98eb6e79428..1b3ab68988e 100644 --- a/tests/components/sensor/test_time_date.py +++ b/tests/components/sensor/test_time_date.py @@ -1,5 +1,6 @@ """The tests for Kira sensor platform.""" import unittest +from unittest.mock import patch from homeassistant.components.sensor import time_date as time_date import homeassistant.util.dt as dt_util @@ -36,11 +37,6 @@ class TestTimeDateSensor(unittest.TestCase): next_time = device.get_next_interval(now) assert next_time == dt_util.utc_from_timestamp(60) - device = time_date.TimeDateSensor(self.hass, 'date') - now = dt_util.utc_from_timestamp(12345) - next_time = device.get_next_interval(now) - assert next_time == dt_util.utc_from_timestamp(86400) - device = time_date.TimeDateSensor(self.hass, 'beat') now = dt_util.utc_from_timestamp(29) next_time = device.get_next_interval(now) @@ -89,6 +85,27 @@ class TestTimeDateSensor(unittest.TestCase): # so the second day was 18000 + 86400 assert next_time.timestamp() == 104400 + new_tz = dt_util.get_time_zone('America/Edmonton') + assert new_tz is not None + dt_util.set_default_time_zone(new_tz) + now = dt_util.parse_datetime('2017-11-13 19:47:19-07:00') + device = time_date.TimeDateSensor(self.hass, 'date') + next_time = device.get_next_interval(now) + assert (next_time.timestamp() == + dt_util.as_timestamp('2017-11-14 00:00:00-07:00')) + + @patch('homeassistant.util.dt.utcnow', + return_value=dt_util.parse_datetime('2017-11-14 02:47:19-00:00')) + def test_timezone_intervals_empty_parameter(self, _): + """Test get_interval() without parameters.""" + new_tz = dt_util.get_time_zone('America/Edmonton') + assert new_tz is not None + dt_util.set_default_time_zone(new_tz) + device = time_date.TimeDateSensor(self.hass, 'date') + next_time = device.get_next_interval() + assert (next_time.timestamp() == + dt_util.as_timestamp('2017-11-14 00:00:00-07:00')) + def test_icons(self): """Test attributes of sensors.""" device = time_date.TimeDateSensor(self.hass, 'time') From a83e741dc7c33430719e3eb25678eef9f0b99864 Mon Sep 17 00:00:00 2001 From: Markus Nigbur Date: Mon, 20 Nov 2017 04:47:55 +0100 Subject: [PATCH 106/246] Refactored to new global json saving and loading (#10677) * Refactored to new global json saving and loading * Fixed emulated_hue tests * Removed unnecassary error handling * Added missing newline * Remove unused imports * Fixed linting error * Moved _load_json wrapper out of the config class --- .gitignore | 2 +- homeassistant/components/axis.py | 27 ++-------- homeassistant/components/ecobee.py | 5 +- .../components/emulated_hue/__init__.py | 37 +++++-------- homeassistant/components/fan/insteon_local.py | 37 ++----------- homeassistant/components/ios.py | 53 ++++--------------- .../components/light/insteon_local.py | 38 ++----------- .../components/media_player/braviatv.py | 44 ++------------- .../components/media_player/gpmdp.py | 37 ++----------- homeassistant/components/media_player/plex.py | 13 +++-- homeassistant/components/notify/matrix.py | 16 ++---- homeassistant/components/sensor/fitbit.py | 41 +++----------- homeassistant/components/sensor/sabnzbd.py | 28 ++-------- .../components/switch/insteon_local.py | 37 ++----------- tests/components/emulated_hue/test_init.py | 6 +-- 15 files changed, 73 insertions(+), 348 deletions(-) diff --git a/.gitignore b/.gitignore index 87bc6990ce4..e01de1b49b8 100644 --- a/.gitignore +++ b/.gitignore @@ -96,4 +96,4 @@ docs/build desktop.ini /home-assistant.pyproj /home-assistant.sln -/.vs/home-assistant/v14 +/.vs/* diff --git a/homeassistant/components/axis.py b/homeassistant/components/axis.py index 401afe8c62c..a7c820f23c7 100644 --- a/homeassistant/components/axis.py +++ b/homeassistant/components/axis.py @@ -5,7 +5,6 @@ For more details about this component, please refer to the documentation at https://home-assistant.io/components/axis/ """ -import json import logging import os @@ -22,6 +21,7 @@ from homeassistant.helpers import config_validation as cv from homeassistant.helpers import discovery from homeassistant.helpers.dispatcher import dispatcher_send from homeassistant.helpers.entity import Entity +from homeassistant.util.json import load_json, save_json REQUIREMENTS = ['axis==14'] @@ -103,9 +103,9 @@ def request_configuration(hass, config, name, host, serialnumber): return False if setup_device(hass, config, device_config): - config_file = _read_config(hass) + config_file = load_json(hass.config.path(CONFIG_FILE)) config_file[serialnumber] = dict(device_config) - _write_config(hass, config_file) + save_json(hass.config.path(CONFIG_FILE), config_file) configurator.request_done(request_id) else: configurator.notify_errors(request_id, @@ -163,7 +163,7 @@ def setup(hass, config): serialnumber = discovery_info['properties']['macaddress'] if serialnumber not in AXIS_DEVICES: - config_file = _read_config(hass) + config_file = load_json(hass.config.path(CONFIG_FILE)) if serialnumber in config_file: # Device config previously saved to file try: @@ -274,25 +274,6 @@ def setup_device(hass, config, device_config): return True -def _read_config(hass): - """Read Axis config.""" - path = hass.config.path(CONFIG_FILE) - - if not os.path.isfile(path): - return {} - - with open(path) as f_handle: - # Guard against empty file - return json.loads(f_handle.read() or '{}') - - -def _write_config(hass, config): - """Write Axis config.""" - data = json.dumps(config) - with open(hass.config.path(CONFIG_FILE), 'w', encoding='utf-8') as outfile: - outfile.write(data) - - class AxisDeviceEvent(Entity): """Representation of a Axis device event.""" diff --git a/homeassistant/components/ecobee.py b/homeassistant/components/ecobee.py index 0b0c9d1d65a..31cf31dac1e 100644 --- a/homeassistant/components/ecobee.py +++ b/homeassistant/components/ecobee.py @@ -14,6 +14,7 @@ import homeassistant.helpers.config_validation as cv from homeassistant.helpers import discovery from homeassistant.const import CONF_API_KEY from homeassistant.util import Throttle +from homeassistant.util.json import save_json REQUIREMENTS = ['python-ecobee-api==0.0.10'] @@ -110,12 +111,10 @@ def setup(hass, config): if 'ecobee' in _CONFIGURING: return - from pyecobee import config_from_file - # Create ecobee.conf if it doesn't exist if not os.path.isfile(hass.config.path(ECOBEE_CONFIG_FILE)): jsonconfig = {"API_KEY": config[DOMAIN].get(CONF_API_KEY)} - config_from_file(hass.config.path(ECOBEE_CONFIG_FILE), jsonconfig) + save_json(hass.config.path(ECOBEE_CONFIG_FILE), jsonconfig) NETWORK = EcobeeData(hass.config.path(ECOBEE_CONFIG_FILE)) diff --git a/homeassistant/components/emulated_hue/__init__.py b/homeassistant/components/emulated_hue/__init__.py index d1a58ba941e..1a3b6413d2c 100644 --- a/homeassistant/components/emulated_hue/__init__.py +++ b/homeassistant/components/emulated_hue/__init__.py @@ -5,7 +5,6 @@ For more details about this component, please refer to the documentation at https://home-assistant.io/components/emulated_hue/ """ import asyncio -import json import logging import voluptuous as vol @@ -16,8 +15,10 @@ from homeassistant.const import ( ) from homeassistant.components.http import REQUIREMENTS # NOQA from homeassistant.components.http import HomeAssistantWSGI +from homeassistant.exceptions import HomeAssistantError from homeassistant.helpers.deprecation import get_deprecated import homeassistant.helpers.config_validation as cv +from homeassistant.util.json import load_json, save_json from .hue_api import ( HueUsernameView, HueAllLightsStateView, HueOneLightStateView, HueOneLightChangeView) @@ -187,7 +188,7 @@ class Config(object): return entity_id if self.numbers is None: - self.numbers = self._load_numbers_json() + self.numbers = _load_json(self.hass.config.path(NUMBERS_FILE)) # Google Home for number, ent_id in self.numbers.items(): @@ -198,7 +199,7 @@ class Config(object): if self.numbers: number = str(max(int(k) for k in self.numbers) + 1) self.numbers[number] = entity_id - self._save_numbers_json() + save_json(self.hass.config.path(NUMBERS_FILE), self.numbers) return number def number_to_entity_id(self, number): @@ -207,7 +208,7 @@ class Config(object): return number if self.numbers is None: - self.numbers = self._load_numbers_json() + self.numbers = _load_json(self.hass.config.path(NUMBERS_FILE)) # Google Home assert isinstance(number, str) @@ -244,25 +245,11 @@ class Config(object): return is_default_exposed or expose - def _load_numbers_json(self): - """Set up helper method to load numbers json.""" - try: - with open(self.hass.config.path(NUMBERS_FILE), - encoding='utf-8') as fil: - return json.loads(fil.read()) - except (OSError, ValueError) as err: - # OSError if file not found or unaccessible/no permissions - # ValueError if could not parse JSON - if not isinstance(err, FileNotFoundError): - _LOGGER.warning("Failed to open %s: %s", NUMBERS_FILE, err) - return {} - def _save_numbers_json(self): - """Set up helper method to save numbers json.""" - try: - with open(self.hass.config.path(NUMBERS_FILE), 'w', - encoding='utf-8') as fil: - fil.write(json.dumps(self.numbers)) - except OSError as err: - # OSError if file write permissions - _LOGGER.warning("Failed to write %s: %s", NUMBERS_FILE, err) +def _load_json(filename): + """Wrapper, because we actually want to handle invalid json.""" + try: + return load_json(filename) + except HomeAssistantError: + pass + return {} diff --git a/homeassistant/components/fan/insteon_local.py b/homeassistant/components/fan/insteon_local.py index e12e3476c3a..58c8caa331b 100644 --- a/homeassistant/components/fan/insteon_local.py +++ b/homeassistant/components/fan/insteon_local.py @@ -4,9 +4,7 @@ Support for Insteon fans via local hub control. For more details about this component, please refer to the documentation at https://home-assistant.io/components/fan.insteon_local/ """ -import json import logging -import os from datetime import timedelta from homeassistant.components.fan import ( @@ -14,6 +12,7 @@ from homeassistant.components.fan import ( SUPPORT_SET_SPEED, FanEntity) from homeassistant.helpers.entity import ToggleEntity import homeassistant.util as util +from homeassistant.util.json import load_json, save_json _CONFIGURING = {} _LOGGER = logging.getLogger(__name__) @@ -33,7 +32,7 @@ def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the Insteon local fan platform.""" insteonhub = hass.data['insteon_local'] - conf_fans = config_from_file(hass.config.path(INSTEON_LOCAL_FANS_CONF)) + conf_fans = load_json(hass.config.path(INSTEON_LOCAL_FANS_CONF)) if conf_fans: for device_id in conf_fans: setup_fan(device_id, conf_fans[device_id], insteonhub, hass, @@ -88,44 +87,16 @@ def setup_fan(device_id, name, insteonhub, hass, add_devices_callback): configurator.request_done(request_id) _LOGGER.info("Device configuration done!") - conf_fans = config_from_file(hass.config.path(INSTEON_LOCAL_FANS_CONF)) + conf_fans = load_json(hass.config.path(INSTEON_LOCAL_FANS_CONF)) if device_id not in conf_fans: conf_fans[device_id] = name - if not config_from_file( - hass.config.path(INSTEON_LOCAL_FANS_CONF), - conf_fans): - _LOGGER.error("Failed to save configuration file") + save_json(hass.config.path(INSTEON_LOCAL_FANS_CONF), conf_fans) device = insteonhub.fan(device_id) add_devices_callback([InsteonLocalFanDevice(device, name)]) -def config_from_file(filename, config=None): - """Small configuration file management function.""" - if config: - # We're writing configuration - try: - with open(filename, 'w') as fdesc: - fdesc.write(json.dumps(config)) - except IOError as error: - _LOGGER.error('Saving config file failed: %s', error) - return False - return True - else: - # We're reading config - if os.path.isfile(filename): - try: - with open(filename, 'r') as fdesc: - return json.loads(fdesc.read()) - except IOError as error: - _LOGGER.error("Reading configuration file failed: %s", error) - # This won't work yet - return False - else: - return {} - - class InsteonLocalFanDevice(FanEntity): """An abstract Class for an Insteon node.""" diff --git a/homeassistant/components/ios.py b/homeassistant/components/ios.py index e3c58425b27..cfa1693f571 100644 --- a/homeassistant/components/ios.py +++ b/homeassistant/components/ios.py @@ -5,26 +5,21 @@ For more details about this component, please refer to the documentation at https://home-assistant.io/ecosystem/ios/ """ import asyncio -import os -import json import logging import datetime import voluptuous as vol # from voluptuous.humanize import humanize_error -from homeassistant.helpers import config_validation as cv - -from homeassistant.helpers import discovery - -from homeassistant.core import callback - from homeassistant.components.http import HomeAssistantView - -from homeassistant.remote import JSONEncoder - from homeassistant.const import (HTTP_INTERNAL_SERVER_ERROR, HTTP_BAD_REQUEST) +from homeassistant.core import callback +from homeassistant.exceptions import HomeAssistantError +from homeassistant.helpers import config_validation as cv +from homeassistant.helpers import discovery +from homeassistant.util.json import load_json, save_json + _LOGGER = logging.getLogger(__name__) @@ -174,36 +169,6 @@ CONFIG_FILE = {ATTR_DEVICES: {}} CONFIG_FILE_PATH = "" -def _load_config(filename): - """Load configuration.""" - if not os.path.isfile(filename): - return {} - - try: - with open(filename, "r") as fdesc: - inp = fdesc.read() - - # In case empty file - if not inp: - return {} - - return json.loads(inp) - except (IOError, ValueError) as error: - _LOGGER.error("Reading config file %s failed: %s", filename, error) - return None - - -def _save_config(filename, config): - """Save configuration.""" - try: - with open(filename, 'w') as fdesc: - fdesc.write(json.dumps(config, cls=JSONEncoder)) - except (IOError, TypeError) as error: - _LOGGER.error("Saving config file failed: %s", error) - return False - return True - - def devices_with_push(): """Return a dictionary of push enabled targets.""" targets = {} @@ -244,7 +209,7 @@ def setup(hass, config): CONFIG_FILE_PATH = hass.config.path(CONFIGURATION_FILE) - CONFIG_FILE = _load_config(CONFIG_FILE_PATH) + CONFIG_FILE = load_json(CONFIG_FILE_PATH) if CONFIG_FILE == {}: CONFIG_FILE[ATTR_DEVICES] = {} @@ -305,7 +270,9 @@ class iOSIdentifyDeviceView(HomeAssistantView): CONFIG_FILE[ATTR_DEVICES][name] = data - if not _save_config(CONFIG_FILE_PATH, CONFIG_FILE): + try: + save_json(CONFIG_FILE_PATH, CONFIG_FILE) + except HomeAssistantError: return self.json_message("Error saving device.", HTTP_INTERNAL_SERVER_ERROR) diff --git a/homeassistant/components/light/insteon_local.py b/homeassistant/components/light/insteon_local.py index 8917a9e9ccf..9d704327a1d 100644 --- a/homeassistant/components/light/insteon_local.py +++ b/homeassistant/components/light/insteon_local.py @@ -4,14 +4,14 @@ Support for Insteon dimmers via local hub control. For more details about this component, please refer to the documentation at https://home-assistant.io/components/light.insteon_local/ """ -import json import logging -import os from datetime import timedelta from homeassistant.components.light import ( ATTR_BRIGHTNESS, SUPPORT_BRIGHTNESS, Light) import homeassistant.util as util +from homeassistant.util.json import load_json, save_json + _CONFIGURING = {} _LOGGER = logging.getLogger(__name__) @@ -31,7 +31,7 @@ def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the Insteon local light platform.""" insteonhub = hass.data['insteon_local'] - conf_lights = config_from_file(hass.config.path(INSTEON_LOCAL_LIGHTS_CONF)) + conf_lights = load_json(hass.config.path(INSTEON_LOCAL_LIGHTS_CONF)) if conf_lights: for device_id in conf_lights: setup_light(device_id, conf_lights[device_id], insteonhub, hass, @@ -85,44 +85,16 @@ def setup_light(device_id, name, insteonhub, hass, add_devices_callback): configurator.request_done(request_id) _LOGGER.debug("Device configuration done") - conf_lights = config_from_file(hass.config.path(INSTEON_LOCAL_LIGHTS_CONF)) + conf_lights = load_json(hass.config.path(INSTEON_LOCAL_LIGHTS_CONF)) if device_id not in conf_lights: conf_lights[device_id] = name - if not config_from_file( - hass.config.path(INSTEON_LOCAL_LIGHTS_CONF), - conf_lights): - _LOGGER.error("Failed to save configuration file") + save_json(hass.config.path(INSTEON_LOCAL_LIGHTS_CONF), conf_lights) device = insteonhub.dimmer(device_id) add_devices_callback([InsteonLocalDimmerDevice(device, name)]) -def config_from_file(filename, config=None): - """Small configuration file management function.""" - if config: - # We're writing configuration - try: - with open(filename, 'w') as fdesc: - fdesc.write(json.dumps(config)) - except IOError as error: - _LOGGER.error("Saving config file failed: %s", error) - return False - return True - else: - # We're reading config - if os.path.isfile(filename): - try: - with open(filename, 'r') as fdesc: - return json.loads(fdesc.read()) - except IOError as error: - _LOGGER.error("Reading configuration file failed: %s", error) - # This won't work yet - return False - else: - return {} - - class InsteonLocalDimmerDevice(Light): """An abstract Class for an Insteon node.""" diff --git a/homeassistant/components/media_player/braviatv.py b/homeassistant/components/media_player/braviatv.py index 399052611c1..f0cc93a8b0f 100644 --- a/homeassistant/components/media_player/braviatv.py +++ b/homeassistant/components/media_player/braviatv.py @@ -5,8 +5,6 @@ For more details about this platform, please refer to the documentation at https://home-assistant.io/components/media_player.braviatv/ """ import logging -import os -import json import re import voluptuous as vol @@ -18,6 +16,7 @@ from homeassistant.components.media_player import ( PLATFORM_SCHEMA) from homeassistant.const import (CONF_HOST, CONF_NAME, STATE_OFF, STATE_ON) import homeassistant.helpers.config_validation as cv +from homeassistant.util.json import load_json, save_json REQUIREMENTS = [ 'https://github.com/aparraga/braviarc/archive/0.3.7.zip' @@ -61,38 +60,6 @@ def _get_mac_address(ip_address): return None -def _config_from_file(filename, config=None): - """Create the configuration from a file.""" - if config: - # We're writing configuration - bravia_config = _config_from_file(filename) - if bravia_config is None: - bravia_config = {} - new_config = bravia_config.copy() - new_config.update(config) - try: - with open(filename, 'w') as fdesc: - fdesc.write(json.dumps(new_config)) - except IOError as error: - _LOGGER.error("Saving config file failed: %s", error) - return False - return True - else: - # We're reading config - if os.path.isfile(filename): - try: - with open(filename, 'r') as fdesc: - return json.loads(fdesc.read()) - except ValueError as error: - return {} - except IOError as error: - _LOGGER.error("Reading config file failed: %s", error) - # This won't work yet - return False - else: - return {} - - # pylint: disable=unused-argument def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the Sony Bravia TV platform.""" @@ -102,7 +69,7 @@ def setup_platform(hass, config, add_devices, discovery_info=None): return pin = None - bravia_config = _config_from_file(hass.config.path(BRAVIA_CONFIG_FILE)) + bravia_config = load_json(hass.config.path(BRAVIA_CONFIG_FILE)) while bravia_config: # Set up a configured TV host_ip, host_config = bravia_config.popitem() @@ -136,10 +103,9 @@ def setup_bravia(config, pin, hass, add_devices): _LOGGER.info("Discovery configuration done") # Save config - if not _config_from_file( - hass.config.path(BRAVIA_CONFIG_FILE), - {host: {'pin': pin, 'host': host, 'mac': mac}}): - _LOGGER.error("Failed to save configuration file") + save_json( + hass.config.path(BRAVIA_CONFIG_FILE), + {host: {'pin': pin, 'host': host, 'mac': mac}}) add_devices([BraviaTVDevice(host, mac, name, pin)]) diff --git a/homeassistant/components/media_player/gpmdp.py b/homeassistant/components/media_player/gpmdp.py index 4090f420855..2f116abebc3 100644 --- a/homeassistant/components/media_player/gpmdp.py +++ b/homeassistant/components/media_player/gpmdp.py @@ -6,7 +6,6 @@ https://home-assistant.io/components/media_player.gpmdp/ """ import logging import json -import os import socket import time @@ -19,6 +18,7 @@ from homeassistant.components.media_player import ( from homeassistant.const import ( STATE_PLAYING, STATE_PAUSED, STATE_OFF, CONF_HOST, CONF_PORT, CONF_NAME) import homeassistant.helpers.config_validation as cv +from homeassistant.util.json import load_json, save_json REQUIREMENTS = ['websocket-client==0.37.0'] @@ -86,8 +86,7 @@ def request_configuration(hass, config, url, add_devices_callback): continue setup_gpmdp(hass, config, code, add_devices_callback) - _save_config(hass.config.path(GPMDP_CONFIG_FILE), - {"CODE": code}) + save_json(hass.config.path(GPMDP_CONFIG_FILE), {"CODE": code}) websocket.send(json.dumps({'namespace': 'connect', 'method': 'connect', 'arguments': ['Home Assistant', code]})) @@ -122,39 +121,9 @@ def setup_gpmdp(hass, config, code, add_devices): add_devices([GPMDP(name, url, code)], True) -def _load_config(filename): - """Load configuration.""" - if not os.path.isfile(filename): - return {} - - try: - with open(filename, 'r') as fdesc: - inp = fdesc.read() - - # In case empty file - if not inp: - return {} - - return json.loads(inp) - except (IOError, ValueError) as error: - _LOGGER.error("Reading config file %s failed: %s", filename, error) - return None - - -def _save_config(filename, config): - """Save configuration.""" - try: - with open(filename, 'w') as fdesc: - fdesc.write(json.dumps(config, indent=4, sort_keys=True)) - except (IOError, TypeError) as error: - _LOGGER.error("Saving configuration file failed: %s", error) - return False - return True - - def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the GPMDP platform.""" - codeconfig = _load_config(hass.config.path(GPMDP_CONFIG_FILE)) + codeconfig = load_json(hass.config.path(GPMDP_CONFIG_FILE)) if codeconfig: code = codeconfig.get('CODE') elif discovery_info is not None: diff --git a/homeassistant/components/media_player/plex.py b/homeassistant/components/media_player/plex.py index 4722a538fa9..9b984813ff6 100644 --- a/homeassistant/components/media_player/plex.py +++ b/homeassistant/components/media_player/plex.py @@ -121,13 +121,12 @@ def setup_plexserver( _LOGGER.info("Discovery configuration done") # Save config - if not save_json( - hass.config.path(PLEX_CONFIG_FILE), {host: { - 'token': token, - 'ssl': has_ssl, - 'verify': verify_ssl, - }}): - _LOGGER.error("Failed to save configuration file") + save_json( + hass.config.path(PLEX_CONFIG_FILE), {host: { + 'token': token, + 'ssl': has_ssl, + 'verify': verify_ssl, + }}) _LOGGER.info('Connected to: %s://%s', http_prefix, host) diff --git a/homeassistant/components/notify/matrix.py b/homeassistant/components/notify/matrix.py index c3bdeae0280..03bc53e204c 100644 --- a/homeassistant/components/notify/matrix.py +++ b/homeassistant/components/notify/matrix.py @@ -5,7 +5,6 @@ For more details about this platform, please refer to the documentation at https://home-assistant.io/components/notify.matrix/ """ import logging -import json import os from urllib.parse import urlparse @@ -15,6 +14,7 @@ import homeassistant.helpers.config_validation as cv from homeassistant.components.notify import (ATTR_TARGET, PLATFORM_SCHEMA, BaseNotificationService) from homeassistant.const import CONF_USERNAME, CONF_PASSWORD, CONF_VERIFY_SSL +from homeassistant.util.json import load_json, save_json REQUIREMENTS = ['matrix-client==0.0.6'] @@ -82,8 +82,7 @@ class MatrixNotificationService(BaseNotificationService): return {} try: - with open(self.session_filepath) as handle: - data = json.load(handle) + data = load_json(self.session_filepath) auth_tokens = {} for mx_id, token in data.items(): @@ -101,16 +100,7 @@ class MatrixNotificationService(BaseNotificationService): """Store authentication token to session and persistent storage.""" self.auth_tokens[self.mx_id] = token - try: - with open(self.session_filepath, 'w') as handle: - handle.write(json.dumps(self.auth_tokens)) - - # Not saving the tokens to disk should not stop the client, we can just - # login using the password every time. - except (OSError, IOError, PermissionError) as ex: - _LOGGER.warning( - "Storing authentication tokens to file '%s' failed: %s", - self.session_filepath, str(ex)) + save_json(self.session_filepath, self.auth_tokens) def login(self): """Login to the matrix homeserver and return the client instance.""" diff --git a/homeassistant/components/sensor/fitbit.py b/homeassistant/components/sensor/fitbit.py index 5f33874c412..35748b30ecf 100644 --- a/homeassistant/components/sensor/fitbit.py +++ b/homeassistant/components/sensor/fitbit.py @@ -5,7 +5,6 @@ For more details about this platform, please refer to the documentation at https://home-assistant.io/components/sensor.fitbit/ """ import os -import json import logging import datetime import time @@ -19,6 +18,8 @@ from homeassistant.const import ATTR_ATTRIBUTION from homeassistant.helpers.entity import Entity from homeassistant.helpers.icon import icon_for_battery_level import homeassistant.helpers.config_validation as cv +from homeassistant.util.json import load_json, save_json + REQUIREMENTS = ['fitbit==0.3.0'] @@ -147,31 +148,6 @@ PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ }) -def config_from_file(filename, config=None): - """Small configuration file management function.""" - if config: - # We"re writing configuration - try: - with open(filename, 'w') as fdesc: - fdesc.write(json.dumps(config)) - except IOError as error: - _LOGGER.error("Saving config file failed: %s", error) - return False - return config - else: - # We"re reading config - if os.path.isfile(filename): - try: - with open(filename, 'r') as fdesc: - return json.loads(fdesc.read()) - except IOError as error: - _LOGGER.error("Reading config file failed: %s", error) - # This won"t work yet - return False - else: - return {} - - def request_app_setup(hass, config, add_devices, config_path, discovery_info=None): """Assist user with configuring the Fitbit dev application.""" @@ -182,7 +158,7 @@ def request_app_setup(hass, config, add_devices, config_path, """Handle configuration updates.""" config_path = hass.config.path(FITBIT_CONFIG_FILE) if os.path.isfile(config_path): - config_file = config_from_file(config_path) + config_file = load_json(config_path) if config_file == DEFAULT_CONFIG: error_msg = ("You didn't correctly modify fitbit.conf", " please try again") @@ -242,13 +218,13 @@ def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the Fitbit sensor.""" config_path = hass.config.path(FITBIT_CONFIG_FILE) if os.path.isfile(config_path): - config_file = config_from_file(config_path) + config_file = load_json(config_path) if config_file == DEFAULT_CONFIG: request_app_setup( hass, config, add_devices, config_path, discovery_info=None) return False else: - config_file = config_from_file(config_path, DEFAULT_CONFIG) + config_file = save_json(config_path, DEFAULT_CONFIG) request_app_setup( hass, config, add_devices, config_path, discovery_info=None) return False @@ -384,9 +360,7 @@ class FitbitAuthCallbackView(HomeAssistantView): ATTR_CLIENT_SECRET: self.oauth.client_secret, ATTR_LAST_SAVED_AT: int(time.time()) } - if not config_from_file(hass.config.path(FITBIT_CONFIG_FILE), - config_contents): - _LOGGER.error("Failed to save config file") + save_json(hass.config.path(FITBIT_CONFIG_FILE), config_contents) hass.async_add_job(setup_platform, hass, self.config, self.add_devices) @@ -513,5 +487,4 @@ class FitbitSensor(Entity): ATTR_CLIENT_SECRET: self.client.client.client_secret, ATTR_LAST_SAVED_AT: int(time.time()) } - if not config_from_file(self.config_path, config_contents): - _LOGGER.error("Failed to save config file") + save_json(self.config_path, config_contents) diff --git a/homeassistant/components/sensor/sabnzbd.py b/homeassistant/components/sensor/sabnzbd.py index 928e855915a..f034755e780 100644 --- a/homeassistant/components/sensor/sabnzbd.py +++ b/homeassistant/components/sensor/sabnzbd.py @@ -4,9 +4,7 @@ Support for monitoring an SABnzbd NZB client. For more details about this platform, please refer to the documentation at https://home-assistant.io/components/sensor.sabnzbd/ """ -import os import logging -import json from datetime import timedelta import voluptuous as vol @@ -17,6 +15,7 @@ from homeassistant.const import ( CONF_SSL) from homeassistant.helpers.entity import Entity from homeassistant.util import Throttle +from homeassistant.util.json import load_json, save_json import homeassistant.helpers.config_validation as cv REQUIREMENTS = ['https://github.com/jamespcole/home-assistant-nzb-clients/' @@ -104,9 +103,9 @@ def request_configuration(host, name, hass, config, add_devices, sab_api): def success(): """Set up was successful.""" - conf = _read_config(hass) + conf = load_json(hass.config.path(CONFIG_FILE)) conf[host] = {'api_key': api_key} - _write_config(hass, conf) + save_json(hass.config.path(CONFIG_FILE), conf) req_config = _CONFIGURING.pop(host) hass.async_add_job(configurator.request_done, req_config) @@ -144,7 +143,7 @@ def setup_platform(hass, config, add_devices, discovery_info=None): api_key = config.get(CONF_API_KEY) if not api_key: - conf = _read_config(hass) + conf = load_json(hass.config.path(CONFIG_FILE)) if conf.get(base_url, {}).get('api_key'): api_key = conf[base_url]['api_key'] @@ -214,22 +213,3 @@ class SabnzbdSensor(Entity): self._state = self.sabnzb_client.queue.get('diskspace1') else: self._state = 'Unknown' - - -def _read_config(hass): - """Read SABnzbd config.""" - path = hass.config.path(CONFIG_FILE) - - if not os.path.isfile(path): - return {} - - with open(path) as f_handle: - # Guard against empty file - return json.loads(f_handle.read() or '{}') - - -def _write_config(hass, config): - """Write SABnzbd config.""" - data = json.dumps(config) - with open(hass.config.path(CONFIG_FILE), 'w', encoding='utf-8') as outfile: - outfile.write(data) diff --git a/homeassistant/components/switch/insteon_local.py b/homeassistant/components/switch/insteon_local.py index 674a20278b3..5fd37c84986 100644 --- a/homeassistant/components/switch/insteon_local.py +++ b/homeassistant/components/switch/insteon_local.py @@ -4,13 +4,12 @@ Support for Insteon switch devices via local hub support. For more details about this component, please refer to the documentation at https://home-assistant.io/components/switch.insteon_local/ """ -import json import logging -import os from datetime import timedelta from homeassistant.components.switch import SwitchDevice import homeassistant.util as util +from homeassistant.util.json import load_json, save_json _CONFIGURING = {} _LOGGER = logging.getLogger(__name__) @@ -28,8 +27,7 @@ def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the Insteon local switch platform.""" insteonhub = hass.data['insteon_local'] - conf_switches = config_from_file(hass.config.path( - INSTEON_LOCAL_SWITCH_CONF)) + conf_switches = load_json(hass.config.path(INSTEON_LOCAL_SWITCH_CONF)) if conf_switches: for device_id in conf_switches: setup_switch( @@ -82,43 +80,16 @@ def setup_switch(device_id, name, insteonhub, hass, add_devices_callback): configurator.request_done(request_id) _LOGGER.info("Device configuration done") - conf_switch = config_from_file(hass.config.path(INSTEON_LOCAL_SWITCH_CONF)) + conf_switch = load_json(hass.config.path(INSTEON_LOCAL_SWITCH_CONF)) if device_id not in conf_switch: conf_switch[device_id] = name - if not config_from_file( - hass.config.path(INSTEON_LOCAL_SWITCH_CONF), conf_switch): - _LOGGER.error("Failed to save configuration file") + save_json(hass.config.path(INSTEON_LOCAL_SWITCH_CONF), conf_switch) device = insteonhub.switch(device_id) add_devices_callback([InsteonLocalSwitchDevice(device, name)]) -def config_from_file(filename, config=None): - """Small configuration file management function.""" - if config: - # We're writing configuration - try: - with open(filename, 'w') as fdesc: - fdesc.write(json.dumps(config)) - except IOError as error: - _LOGGER.error("Saving configuration file failed: %s", error) - return False - return True - else: - # We're reading config - if os.path.isfile(filename): - try: - with open(filename, 'r') as fdesc: - return json.loads(fdesc.read()) - except IOError as error: - _LOGGER.error("Reading config file failed: %s", error) - # This won't work yet - return False - else: - return {} - - class InsteonLocalSwitchDevice(SwitchDevice): """An abstract Class for an Insteon node.""" diff --git a/tests/components/emulated_hue/test_init.py b/tests/components/emulated_hue/test_init.py index b9ef09fe4a7..25bcbc1dd55 100755 --- a/tests/components/emulated_hue/test_init.py +++ b/tests/components/emulated_hue/test_init.py @@ -15,7 +15,7 @@ def test_config_google_home_entity_id_to_number(): mop = mock_open(read_data=json.dumps({'1': 'light.test2'})) handle = mop() - with patch('homeassistant.components.emulated_hue.open', mop, create=True): + with patch('homeassistant.util.json.open', mop, create=True): number = conf.entity_id_to_number('light.test') assert number == '2' assert handle.write.call_count == 1 @@ -45,7 +45,7 @@ def test_config_google_home_entity_id_to_number_altered(): mop = mock_open(read_data=json.dumps({'21': 'light.test2'})) handle = mop() - with patch('homeassistant.components.emulated_hue.open', mop, create=True): + with patch('homeassistant.util.json.open', mop, create=True): number = conf.entity_id_to_number('light.test') assert number == '22' assert handle.write.call_count == 1 @@ -75,7 +75,7 @@ def test_config_google_home_entity_id_to_number_empty(): mop = mock_open(read_data='') handle = mop() - with patch('homeassistant.components.emulated_hue.open', mop, create=True): + with patch('homeassistant.util.json.open', mop, create=True): number = conf.entity_id_to_number('light.test') assert number == '1' assert handle.write.call_count == 1 From 62a740ba22279a01a771d34254eddd15af56d1d8 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Mon, 20 Nov 2017 05:11:55 -0800 Subject: [PATCH 107/246] Convert configurator to use markdown (#10668) --- homeassistant/components/configurator.py | 18 +++++++++--------- homeassistant/components/light/hue.py | 10 +++++++--- tests/components/test_configurator.py | 11 ++++++----- 3 files changed, 22 insertions(+), 17 deletions(-) diff --git a/homeassistant/components/configurator.py b/homeassistant/components/configurator.py index 7d1b1fd7ef1..eaba08f0e89 100644 --- a/homeassistant/components/configurator.py +++ b/homeassistant/components/configurator.py @@ -50,15 +50,19 @@ def async_request_config( Will return an ID to be used for sequent calls. """ + if link_name is not None and link_url is not None: + description += '\n\n[{}]({})'.format(link_name, link_url) + + if description_image is not None: + description += '\n\n![Description image]({})'.format(description_image) + instance = hass.data.get(_KEY_INSTANCE) if instance is None: instance = hass.data[_KEY_INSTANCE] = Configurator(hass) request_id = instance.async_request_config( - name, callback, - description, description_image, submit_caption, - fields, link_name, link_url, entity_picture) + name, callback, description, submit_caption, fields, entity_picture) if DATA_REQUESTS not in hass.data: hass.data[DATA_REQUESTS] = {} @@ -137,9 +141,8 @@ class Configurator(object): @async_callback def async_request_config( - self, name, callback, - description, description_image, submit_caption, - fields, link_name, link_url, entity_picture): + self, name, callback, description, submit_caption, fields, + entity_picture): """Set up a request for configuration.""" entity_id = async_generate_entity_id( ENTITY_ID_FORMAT, name, hass=self.hass) @@ -161,10 +164,7 @@ class Configurator(object): data.update({ key: value for key, value in [ (ATTR_DESCRIPTION, description), - (ATTR_DESCRIPTION_IMAGE, description_image), (ATTR_SUBMIT_CAPTION, submit_caption), - (ATTR_LINK_NAME, link_name), - (ATTR_LINK_URL, link_url), ] if value is not None }) diff --git a/homeassistant/components/light/hue.py b/homeassistant/components/light/hue.py index feacf34bfe8..6f4e948adea 100644 --- a/homeassistant/components/light/hue.py +++ b/homeassistant/components/light/hue.py @@ -85,6 +85,12 @@ SCENE_SCHEMA = vol.Schema({ ATTR_IS_HUE_GROUP = "is_hue_group" GROUP_NAME_ALL_HUE_LIGHTS = "All Hue Lights" +CONFIG_INSTRUCTIONS = """ +Press the button on the bridge to register Philips Hue with Home Assistant. + +![Location of button on bridge](/static/images/config_philips_hue.jpg) +""" + def _find_host_from_config(hass, filename=PHUE_CONFIG_FILE): """Attempt to detect host based on existing configuration.""" @@ -298,10 +304,8 @@ def request_configuration(host, hass, add_devices, filename, _CONFIGURING[host] = configurator.request_config( "Philips Hue", hue_configuration_callback, - description=("Press the button on the bridge to register Philips Hue " - "with Home Assistant."), + description=CONFIG_INSTRUCTIONS, entity_picture="/static/images/logo_philips_hue.png", - description_image="/static/images/config_philips_hue.jpg", submit_caption="I have pressed the button" ) diff --git a/tests/components/test_configurator.py b/tests/components/test_configurator.py index a289f58db5a..809c02548dc 100644 --- a/tests/components/test_configurator.py +++ b/tests/components/test_configurator.py @@ -44,12 +44,13 @@ class TestConfigurator(unittest.TestCase): """Test request config with all possible info.""" exp_attr = { ATTR_FRIENDLY_NAME: "Test Request", - configurator.ATTR_DESCRIPTION: "config description", - configurator.ATTR_DESCRIPTION_IMAGE: "config image url", + configurator.ATTR_DESCRIPTION: """config description + +[link name](link url) + +![Description image](config image url)""", configurator.ATTR_SUBMIT_CAPTION: "config submit caption", configurator.ATTR_FIELDS: [], - configurator.ATTR_LINK_NAME: "link name", - configurator.ATTR_LINK_URL: "link url", configurator.ATTR_ENTITY_PICTURE: "config entity picture", configurator.ATTR_CONFIGURE_ID: configurator.request_config( self.hass, @@ -70,7 +71,7 @@ class TestConfigurator(unittest.TestCase): state = states[0] self.assertEqual(configurator.STATE_CONFIGURE, state.state) - assert exp_attr == dict(state.attributes) + assert exp_attr == state.attributes def test_callback_called_on_configure(self): """Test if our callback gets called when configure service called.""" From 857d6b5b49f9f371931fc6aae6f351616964bc88 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Mon, 20 Nov 2017 06:16:36 -0800 Subject: [PATCH 108/246] index.html improvements (#10696) --- homeassistant/components/frontend/__init__.py | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index bac00b8a57a..9707570432d 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -481,10 +481,10 @@ class IndexView(HomeAssistantView): else: panel_url = hass.data[DATA_PANELS][panel].webcomponent_url_es5 - no_auth = 'true' + no_auth = '1' if hass.config.api.api_password and not is_trusted_ip(request): # do not try to auto connect on load - no_auth = 'false' + no_auth = '0' template = yield from hass.async_add_job(self.get_template, latest) @@ -492,10 +492,8 @@ class IndexView(HomeAssistantView): no_auth=no_auth, panel_url=panel_url, panels=hass.data[DATA_PANELS], - dev_mode=self.repo_path is not None, theme_color=MANIFEST_JSON['theme_color'], extra_urls=hass.data[DATA_EXTRA_HTML_URL], - latest=latest, ) return web.Response(text=resp, content_type='text/html') From df37cb11faae28a3f288682147a68aa7dc3efe7c Mon Sep 17 00:00:00 2001 From: Thibault Cohen Date: Mon, 20 Nov 2017 12:02:05 -0500 Subject: [PATCH 109/246] Handle the new version of HydroQuebec website (#10682) * Handle the new version of HydroQuebec website * Update requirements_all.txt --- homeassistant/components/sensor/hydroquebec.py | 5 +++-- requirements_all.txt | 2 +- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/sensor/hydroquebec.py b/homeassistant/components/sensor/hydroquebec.py index 884f101c033..d857ce57fce 100644 --- a/homeassistant/components/sensor/hydroquebec.py +++ b/homeassistant/components/sensor/hydroquebec.py @@ -21,7 +21,7 @@ from homeassistant.helpers.entity import Entity from homeassistant.util import Throttle import homeassistant.helpers.config_validation as cv -REQUIREMENTS = ['pyhydroquebec==1.2.0'] +REQUIREMENTS = ['pyhydroquebec==1.3.1'] _LOGGER = logging.getLogger(__name__) @@ -34,6 +34,7 @@ DEFAULT_NAME = 'HydroQuebec' REQUESTS_TIMEOUT = 15 MIN_TIME_BETWEEN_UPDATES = timedelta(hours=1) +SCAN_INTERVAL = timedelta(hours=1) SENSOR_TYPES = { 'balance': @@ -115,7 +116,7 @@ def setup_platform(hass, config, add_devices, discovery_info=None): for variable in config[CONF_MONITORED_VARIABLES]: sensors.append(HydroQuebecSensor(hydroquebec_data, variable, name)) - add_devices(sensors, True) + add_devices(sensors) class HydroQuebecSensor(Entity): diff --git a/requirements_all.txt b/requirements_all.txt index 520848166d0..a8718ebe5b7 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -677,7 +677,7 @@ pyhik==0.1.4 pyhomematic==0.1.34 # homeassistant.components.sensor.hydroquebec -pyhydroquebec==1.2.0 +pyhydroquebec==1.3.1 # homeassistant.components.device_tracker.icloud pyicloud==0.9.1 From e62ef067ccc2e8ba5da241ad082b358dbe3513bb Mon Sep 17 00:00:00 2001 From: uchagani Date: Mon, 20 Nov 2017 11:34:21 -0600 Subject: [PATCH 110/246] Add Arm Custom Bypass to alarm_control_panel (#10697) --- .../alarm_control_panel/__init__.py | 26 +++- .../components/alarm_control_panel/manual.py | 18 ++- homeassistant/const.py | 3 + .../alarm_control_panel/test_manual.py | 115 +++++++++++++++++- 4 files changed, 156 insertions(+), 6 deletions(-) diff --git a/homeassistant/components/alarm_control_panel/__init__.py b/homeassistant/components/alarm_control_panel/__init__.py index 1141e42f9ef..f6fd3f3bea9 100644 --- a/homeassistant/components/alarm_control_panel/__init__.py +++ b/homeassistant/components/alarm_control_panel/__init__.py @@ -14,7 +14,7 @@ import voluptuous as vol from homeassistant.const import ( ATTR_CODE, ATTR_CODE_FORMAT, ATTR_ENTITY_ID, SERVICE_ALARM_TRIGGER, SERVICE_ALARM_DISARM, SERVICE_ALARM_ARM_HOME, SERVICE_ALARM_ARM_AWAY, - SERVICE_ALARM_ARM_NIGHT) + SERVICE_ALARM_ARM_NIGHT, SERVICE_ALARM_ARM_CUSTOM_BYPASS) from homeassistant.config import load_yaml_config_file from homeassistant.loader import bind_hass from homeassistant.helpers.config_validation import PLATFORM_SCHEMA # noqa @@ -33,6 +33,7 @@ SERVICE_TO_METHOD = { SERVICE_ALARM_ARM_HOME: 'alarm_arm_home', SERVICE_ALARM_ARM_AWAY: 'alarm_arm_away', SERVICE_ALARM_ARM_NIGHT: 'alarm_arm_night', + SERVICE_ALARM_ARM_CUSTOM_BYPASS: 'alarm_arm_custom_bypass', SERVICE_ALARM_TRIGGER: 'alarm_trigger' } @@ -107,6 +108,18 @@ def alarm_trigger(hass, code=None, entity_id=None): hass.services.call(DOMAIN, SERVICE_ALARM_TRIGGER, data) +@bind_hass +def alarm_arm_custom_bypass(hass, code=None, entity_id=None): + """Send the alarm the command for arm custom bypass.""" + data = {} + if code: + data[ATTR_CODE] = code + if entity_id: + data[ATTR_ENTITY_ID] = entity_id + + hass.services.call(DOMAIN, SERVICE_ALARM_ARM_CUSTOM_BYPASS, data) + + @asyncio.coroutine def async_setup(hass, config): """Track states and offer events for sensors.""" @@ -216,6 +229,17 @@ class AlarmControlPanel(Entity): """ return self.hass.async_add_job(self.alarm_trigger, code) + def alarm_arm_custom_bypass(self, code=None): + """Send arm custom bypass command.""" + raise NotImplementedError() + + def async_alarm_arm_custom_bypass(self, code=None): + """Send arm custom bypass command. + + This method must be run in the event loop and returns a coroutine. + """ + return self.hass.async_add_job(self.alarm_arm_custom_bypass, code) + @property def state_attributes(self): """Return the state attributes.""" diff --git a/homeassistant/components/alarm_control_panel/manual.py b/homeassistant/components/alarm_control_panel/manual.py index 237959ab10d..55f3834c06a 100644 --- a/homeassistant/components/alarm_control_panel/manual.py +++ b/homeassistant/components/alarm_control_panel/manual.py @@ -14,9 +14,9 @@ import homeassistant.components.alarm_control_panel as alarm import homeassistant.util.dt as dt_util from homeassistant.const import ( STATE_ALARM_ARMED_AWAY, STATE_ALARM_ARMED_HOME, STATE_ALARM_ARMED_NIGHT, - STATE_ALARM_DISARMED, STATE_ALARM_PENDING, STATE_ALARM_TRIGGERED, - CONF_PLATFORM, CONF_NAME, CONF_CODE, CONF_PENDING_TIME, CONF_TRIGGER_TIME, - CONF_DISARM_AFTER_TRIGGER) + STATE_ALARM_ARMED_CUSTOM_BYPASS, STATE_ALARM_DISARMED, STATE_ALARM_PENDING, + STATE_ALARM_TRIGGERED, CONF_PLATFORM, CONF_NAME, CONF_CODE, + CONF_PENDING_TIME, CONF_TRIGGER_TIME, CONF_DISARM_AFTER_TRIGGER) import homeassistant.helpers.config_validation as cv from homeassistant.helpers.event import track_point_in_time @@ -26,7 +26,8 @@ DEFAULT_TRIGGER_TIME = 120 DEFAULT_DISARM_AFTER_TRIGGER = False SUPPORTED_PENDING_STATES = [STATE_ALARM_ARMED_AWAY, STATE_ALARM_ARMED_HOME, - STATE_ALARM_ARMED_NIGHT, STATE_ALARM_TRIGGERED] + STATE_ALARM_ARMED_NIGHT, STATE_ALARM_TRIGGERED, + STATE_ALARM_ARMED_CUSTOM_BYPASS] ATTR_POST_PENDING_STATE = 'post_pending_state' @@ -59,6 +60,8 @@ PLATFORM_SCHEMA = vol.Schema(vol.All({ vol.Optional(STATE_ALARM_ARMED_AWAY, default={}): STATE_SETTING_SCHEMA, vol.Optional(STATE_ALARM_ARMED_HOME, default={}): STATE_SETTING_SCHEMA, vol.Optional(STATE_ALARM_ARMED_NIGHT, default={}): STATE_SETTING_SCHEMA, + vol.Optional(STATE_ALARM_ARMED_CUSTOM_BYPASS, + default={}): STATE_SETTING_SCHEMA, vol.Optional(STATE_ALARM_TRIGGERED, default={}): STATE_SETTING_SCHEMA, }, _state_validator)) @@ -174,6 +177,13 @@ class ManualAlarm(alarm.AlarmControlPanel): self._update_state(STATE_ALARM_ARMED_NIGHT) + def alarm_arm_custom_bypass(self, code=None): + """Send arm custom bypass command.""" + if not self._validate_code(code, STATE_ALARM_ARMED_CUSTOM_BYPASS): + return + + self._update_state(STATE_ALARM_ARMED_CUSTOM_BYPASS) + def alarm_trigger(self, code=None): """Send alarm trigger command. No code needed.""" self._pre_trigger_state = self._state diff --git a/homeassistant/const.py b/homeassistant/const.py index eeff5773640..f46058b186c 100644 --- a/homeassistant/const.py +++ b/homeassistant/const.py @@ -181,6 +181,7 @@ STATE_ALARM_DISARMED = 'disarmed' STATE_ALARM_ARMED_HOME = 'armed_home' STATE_ALARM_ARMED_AWAY = 'armed_away' STATE_ALARM_ARMED_NIGHT = 'armed_night' +STATE_ALARM_ARMED_CUSTOM_BYPASS = 'armed_custom_bypass' STATE_ALARM_PENDING = 'pending' STATE_ALARM_ARMING = 'arming' STATE_ALARM_DISARMING = 'disarming' @@ -347,8 +348,10 @@ SERVICE_ALARM_DISARM = 'alarm_disarm' SERVICE_ALARM_ARM_HOME = 'alarm_arm_home' SERVICE_ALARM_ARM_AWAY = 'alarm_arm_away' SERVICE_ALARM_ARM_NIGHT = 'alarm_arm_night' +SERVICE_ALARM_ARM_CUSTOM_BYPASS = 'alarm_arm_custom_bypass' SERVICE_ALARM_TRIGGER = 'alarm_trigger' + SERVICE_LOCK = 'lock' SERVICE_UNLOCK = 'unlock' diff --git a/tests/components/alarm_control_panel/test_manual.py b/tests/components/alarm_control_panel/test_manual.py index 1b10b942281..2e96b81bfce 100644 --- a/tests/components/alarm_control_panel/test_manual.py +++ b/tests/components/alarm_control_panel/test_manual.py @@ -6,7 +6,8 @@ from unittest.mock import patch from homeassistant.setup import setup_component from homeassistant.const import ( STATE_ALARM_DISARMED, STATE_ALARM_ARMED_HOME, STATE_ALARM_ARMED_AWAY, - STATE_ALARM_ARMED_NIGHT, STATE_ALARM_PENDING, STATE_ALARM_TRIGGERED) + STATE_ALARM_ARMED_NIGHT, STATE_ALARM_ARMED_CUSTOM_BYPASS, + STATE_ALARM_PENDING, STATE_ALARM_TRIGGERED) from homeassistant.components import alarm_control_panel import homeassistant.util.dt as dt_util @@ -673,3 +674,115 @@ class TestAlarmControlPanelManual(unittest.TestCase): self.assertEqual(STATE_ALARM_TRIGGERED, self.hass.states.get(entity_id).state) + + def test_arm_custom_bypass_no_pending(self): + """Test arm custom bypass method.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual', + 'name': 'test', + 'code': CODE, + 'pending_time': 0, + 'disarm_after_trigger': False + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_arm_custom_bypass(self.hass, CODE) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_ARMED_CUSTOM_BYPASS, + self.hass.states.get(entity_id).state) + + def test_arm_custom_bypass_with_pending(self): + """Test arm custom bypass method.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual', + 'name': 'test', + 'code': CODE, + 'pending_time': 1, + 'disarm_after_trigger': False + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_arm_custom_bypass(self.hass, CODE, entity_id) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_PENDING, + self.hass.states.get(entity_id).state) + + state = self.hass.states.get(entity_id) + assert state.attributes['post_pending_state'] == \ + STATE_ALARM_ARMED_CUSTOM_BYPASS + + future = dt_util.utcnow() + timedelta(seconds=1) + with patch(('homeassistant.components.alarm_control_panel.manual.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + assert state.state == STATE_ALARM_ARMED_CUSTOM_BYPASS + + def test_arm_custom_bypass_with_invalid_code(self): + """Attempt to custom bypass without a valid code.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual', + 'name': 'test', + 'code': CODE, + 'pending_time': 1, + 'disarm_after_trigger': False + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_arm_custom_bypass(self.hass, CODE + '2') + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + def test_armed_custom_bypass_with_specific_pending(self): + """Test arm custom bypass method.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual', + 'name': 'test', + 'pending_time': 10, + 'armed_custom_bypass': { + 'pending_time': 2 + } + }})) + + entity_id = 'alarm_control_panel.test' + + alarm_control_panel.alarm_arm_custom_bypass(self.hass) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_PENDING, + self.hass.states.get(entity_id).state) + + future = dt_util.utcnow() + timedelta(seconds=2) + with patch(('homeassistant.components.alarm_control_panel.manual.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_ARMED_CUSTOM_BYPASS, + self.hass.states.get(entity_id).state) From 34a4db57db0b0b9f396a024df6534e5db72df9fa Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Mon, 20 Nov 2017 20:26:36 -0800 Subject: [PATCH 111/246] Fix conversation (#10686) * Fix conversation * Lint --- homeassistant/components/conversation.py | 121 +++++++++----- tests/components/test_conversation.py | 203 ++++++++++------------- 2 files changed, 172 insertions(+), 152 deletions(-) diff --git a/homeassistant/components/conversation.py b/homeassistant/components/conversation.py index 62611b82496..064428c010c 100644 --- a/homeassistant/components/conversation.py +++ b/homeassistant/components/conversation.py @@ -14,7 +14,7 @@ import voluptuous as vol from homeassistant import core from homeassistant.loader import bind_hass from homeassistant.const import ( - ATTR_ENTITY_ID, SERVICE_TURN_OFF, SERVICE_TURN_ON, HTTP_BAD_REQUEST) + ATTR_ENTITY_ID, SERVICE_TURN_OFF, SERVICE_TURN_ON) from homeassistant.helpers import intent, config_validation as cv from homeassistant.components import http @@ -39,6 +39,10 @@ CONFIG_SCHEMA = vol.Schema({DOMAIN: vol.Schema({ }) })}, extra=vol.ALLOW_EXTRA) +INTENT_TURN_ON = 'HassTurnOn' +INTENT_TURN_OFF = 'HassTurnOff' +REGEX_TYPE = type(re.compile('')) + _LOGGER = logging.getLogger(__name__) @@ -60,7 +64,11 @@ def async_register(hass, intent_type, utterances): if conf is None: conf = intents[intent_type] = [] - conf.extend(_create_matcher(utterance) for utterance in utterances) + for utterance in utterances: + if isinstance(utterance, REGEX_TYPE): + conf.append(utterance) + else: + conf.append(_create_matcher(utterance)) @asyncio.coroutine @@ -93,6 +101,13 @@ def async_setup(hass, config): hass.http.register_view(ConversationProcessView) + hass.helpers.intent.async_register(TurnOnIntent()) + hass.helpers.intent.async_register(TurnOffIntent()) + async_register(hass, INTENT_TURN_ON, + ['Turn {name} on', 'Turn on {name}']) + async_register(hass, INTENT_TURN_OFF, [ + 'Turn {name} off', 'Turn off {name}']) + return True @@ -128,48 +143,84 @@ def _process(hass, text): if not match: continue - response = yield from intent.async_handle( - hass, DOMAIN, intent_type, + response = yield from hass.helpers.intent.async_handle( + DOMAIN, intent_type, {key: {'value': value} for key, value in match.groupdict().items()}, text) return response + +@core.callback +def _match_entity(hass, name): + """Match a name to an entity.""" from fuzzywuzzy import process as fuzzyExtract - text = text.lower() - match = REGEX_TURN_COMMAND.match(text) - - if not match: - _LOGGER.error("Unable to process: %s", text) - return None - - name, command = match.groups() entities = {state.entity_id: state.name for state in hass.states.async_all()} - entity_ids = fuzzyExtract.extractOne( + entity_id = fuzzyExtract.extractOne( name, entities, score_cutoff=65)[2] + return hass.states.get(entity_id) if entity_id else None - if not entity_ids: - _LOGGER.error( - "Could not find entity id %s from text %s", name, text) - return None - if command == 'on': +class TurnOnIntent(intent.IntentHandler): + """Handle turning item on intents.""" + + intent_type = INTENT_TURN_ON + slot_schema = { + 'name': cv.string, + } + + @asyncio.coroutine + def async_handle(self, intent_obj): + """Handle turn on intent.""" + hass = intent_obj.hass + slots = self.async_validate_slots(intent_obj.slots) + name = slots['name']['value'] + entity = _match_entity(hass, name) + + if not entity: + _LOGGER.error("Could not find entity id for %s", name) + return None + yield from hass.services.async_call( core.DOMAIN, SERVICE_TURN_ON, { - ATTR_ENTITY_ID: entity_ids, + ATTR_ENTITY_ID: entity.entity_id, }, blocking=True) - elif command == 'off': + response = intent_obj.create_response() + response.async_set_speech( + 'Turned on {}'.format(entity.name)) + return response + + +class TurnOffIntent(intent.IntentHandler): + """Handle turning item off intents.""" + + intent_type = INTENT_TURN_OFF + slot_schema = { + 'name': cv.string, + } + + @asyncio.coroutine + def async_handle(self, intent_obj): + """Handle turn off intent.""" + hass = intent_obj.hass + slots = self.async_validate_slots(intent_obj.slots) + name = slots['name']['value'] + entity = _match_entity(hass, name) + + if not entity: + _LOGGER.error("Could not find entity id for %s", name) + return None + yield from hass.services.async_call( core.DOMAIN, SERVICE_TURN_OFF, { - ATTR_ENTITY_ID: entity_ids, + ATTR_ENTITY_ID: entity.entity_id, }, blocking=True) - else: - _LOGGER.error('Got unsupported command %s from text %s', - command, text) - - return None + response = intent_obj.create_response() + response.async_set_speech( + 'Turned off {}'.format(entity.name)) + return response class ConversationProcessView(http.HomeAssistantView): @@ -178,23 +229,15 @@ class ConversationProcessView(http.HomeAssistantView): url = '/api/conversation/process' name = "api:conversation:process" + @http.RequestDataValidator(vol.Schema({ + vol.Required('text'): str, + })) @asyncio.coroutine - def post(self, request): + def post(self, request, data): """Send a request for processing.""" hass = request.app['hass'] - try: - data = yield from request.json() - except ValueError: - return self.json_message('Invalid JSON specified', - HTTP_BAD_REQUEST) - text = data.get('text') - - if text is None: - return self.json_message('Missing "text" key in JSON.', - HTTP_BAD_REQUEST) - - intent_result = yield from _process(hass, text) + intent_result = yield from _process(hass, data['text']) if intent_result is None: intent_result = intent.IntentResponse() diff --git a/tests/components/test_conversation.py b/tests/components/test_conversation.py index 138ae1668f8..fab1e24d8e7 100644 --- a/tests/components/test_conversation.py +++ b/tests/components/test_conversation.py @@ -1,123 +1,14 @@ """The tests for the Conversation component.""" # pylint: disable=protected-access import asyncio -import unittest -from unittest.mock import patch -from homeassistant.core import callback -from homeassistant.setup import setup_component, async_setup_component -import homeassistant.components as core_components +import pytest + +from homeassistant.setup import async_setup_component from homeassistant.components import conversation -from homeassistant.const import ATTR_ENTITY_ID -from homeassistant.util.async import run_coroutine_threadsafe from homeassistant.helpers import intent -from tests.common import get_test_home_assistant, async_mock_intent - - -class TestConversation(unittest.TestCase): - """Test the conversation component.""" - - # pylint: disable=invalid-name - def setUp(self): - """Setup things to be run when tests are started.""" - self.ent_id = 'light.kitchen_lights' - self.hass = get_test_home_assistant() - self.hass.states.set(self.ent_id, 'on') - self.assertTrue(run_coroutine_threadsafe( - core_components.async_setup(self.hass, {}), self.hass.loop - ).result()) - self.assertTrue(setup_component(self.hass, conversation.DOMAIN, { - conversation.DOMAIN: {} - })) - - # pylint: disable=invalid-name - def tearDown(self): - """Stop everything that was started.""" - self.hass.stop() - - def test_turn_on(self): - """Setup and perform good turn on requests.""" - calls = [] - - @callback - def record_call(service): - """Recorder for a call.""" - calls.append(service) - - self.hass.services.register('light', 'turn_on', record_call) - - event_data = {conversation.ATTR_TEXT: 'turn kitchen lights on'} - self.assertTrue(self.hass.services.call( - conversation.DOMAIN, 'process', event_data, True)) - - call = calls[-1] - self.assertEqual('light', call.domain) - self.assertEqual('turn_on', call.service) - self.assertEqual([self.ent_id], call.data[ATTR_ENTITY_ID]) - - def test_turn_off(self): - """Setup and perform good turn off requests.""" - calls = [] - - @callback - def record_call(service): - """Recorder for a call.""" - calls.append(service) - - self.hass.services.register('light', 'turn_off', record_call) - - event_data = {conversation.ATTR_TEXT: 'turn kitchen lights off'} - self.assertTrue(self.hass.services.call( - conversation.DOMAIN, 'process', event_data, True)) - - call = calls[-1] - self.assertEqual('light', call.domain) - self.assertEqual('turn_off', call.service) - self.assertEqual([self.ent_id], call.data[ATTR_ENTITY_ID]) - - @patch('homeassistant.components.conversation.logging.Logger.error') - @patch('homeassistant.core.ServiceRegistry.call') - def test_bad_request_format(self, mock_logger, mock_call): - """Setup and perform a badly formatted request.""" - event_data = { - conversation.ATTR_TEXT: - 'what is the answer to the ultimate question of life, ' + - 'the universe and everything'} - self.assertTrue(self.hass.services.call( - conversation.DOMAIN, 'process', event_data, True)) - self.assertTrue(mock_logger.called) - self.assertFalse(mock_call.called) - - @patch('homeassistant.components.conversation.logging.Logger.error') - @patch('homeassistant.core.ServiceRegistry.call') - def test_bad_request_entity(self, mock_logger, mock_call): - """Setup and perform requests with bad entity id.""" - event_data = {conversation.ATTR_TEXT: 'turn something off'} - self.assertTrue(self.hass.services.call( - conversation.DOMAIN, 'process', event_data, True)) - self.assertTrue(mock_logger.called) - self.assertFalse(mock_call.called) - - @patch('homeassistant.components.conversation.logging.Logger.error') - @patch('homeassistant.core.ServiceRegistry.call') - def test_bad_request_command(self, mock_logger, mock_call): - """Setup and perform requests with bad command.""" - event_data = {conversation.ATTR_TEXT: 'turn kitchen lights over'} - self.assertTrue(self.hass.services.call( - conversation.DOMAIN, 'process', event_data, True)) - self.assertTrue(mock_logger.called) - self.assertFalse(mock_call.called) - - @patch('homeassistant.components.conversation.logging.Logger.error') - @patch('homeassistant.core.ServiceRegistry.call') - def test_bad_request_notext(self, mock_logger, mock_call): - """Setup and perform requests with bad command with no text.""" - event_data = {} - self.assertTrue(self.hass.services.call( - conversation.DOMAIN, 'process', event_data, True)) - self.assertTrue(mock_logger.called) - self.assertFalse(mock_call.called) +from tests.common import async_mock_intent, async_mock_service @asyncio.coroutine @@ -248,3 +139,89 @@ def test_http_processing_intent(hass, test_client): } } } + + +@asyncio.coroutine +@pytest.mark.parametrize('sentence', ('turn on kitchen', 'turn kitchen on')) +def test_turn_on_intent(hass, sentence): + """Test calling the turn on intent.""" + result = yield from async_setup_component(hass, 'conversation', {}) + assert result + + hass.states.async_set('light.kitchen', 'off') + calls = async_mock_service(hass, 'homeassistant', 'turn_on') + + yield from hass.services.async_call( + 'conversation', 'process', { + conversation.ATTR_TEXT: sentence + }) + yield from hass.async_block_till_done() + + assert len(calls) == 1 + call = calls[0] + assert call.domain == 'homeassistant' + assert call.service == 'turn_on' + assert call.data == {'entity_id': 'light.kitchen'} + + +@asyncio.coroutine +@pytest.mark.parametrize('sentence', ('turn off kitchen', 'turn kitchen off')) +def test_turn_off_intent(hass, sentence): + """Test calling the turn on intent.""" + result = yield from async_setup_component(hass, 'conversation', {}) + assert result + + hass.states.async_set('light.kitchen', 'on') + calls = async_mock_service(hass, 'homeassistant', 'turn_off') + + yield from hass.services.async_call( + 'conversation', 'process', { + conversation.ATTR_TEXT: sentence + }) + yield from hass.async_block_till_done() + + assert len(calls) == 1 + call = calls[0] + assert call.domain == 'homeassistant' + assert call.service == 'turn_off' + assert call.data == {'entity_id': 'light.kitchen'} + + +@asyncio.coroutine +def test_http_api(hass, test_client): + """Test the HTTP conversation API.""" + result = yield from async_setup_component(hass, 'conversation', {}) + assert result + + client = yield from test_client(hass.http.app) + hass.states.async_set('light.kitchen', 'off') + calls = async_mock_service(hass, 'homeassistant', 'turn_on') + + resp = yield from client.post('/api/conversation/process', json={ + 'text': 'Turn kitchen on' + }) + assert resp.status == 200 + + assert len(calls) == 1 + call = calls[0] + assert call.domain == 'homeassistant' + assert call.service == 'turn_on' + assert call.data == {'entity_id': 'light.kitchen'} + + +@asyncio.coroutine +def test_http_api_wrong_data(hass, test_client): + """Test the HTTP conversation API.""" + result = yield from async_setup_component(hass, 'conversation', {}) + assert result + + client = yield from test_client(hass.http.app) + + resp = yield from client.post('/api/conversation/process', json={ + 'text': 123 + }) + assert resp.status == 400 + + resp = yield from client.post('/api/conversation/process', json={ + }) + assert resp.status == 400 From efd45549e489c7e0867abe0215200b4207995694 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Mon, 20 Nov 2017 20:48:52 -0800 Subject: [PATCH 112/246] Bump frontend to 20171121.0 --- homeassistant/components/frontend/__init__.py | 2 +- requirements_all.txt | 2 +- requirements_test_all.txt | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index 9707570432d..d3142232404 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -23,7 +23,7 @@ from homeassistant.const import CONF_NAME, EVENT_THEMES_UPDATED from homeassistant.core import callback from homeassistant.loader import bind_hass -REQUIREMENTS = ['home-assistant-frontend==20171117.1'] +REQUIREMENTS = ['home-assistant-frontend==20171121.0'] DOMAIN = 'frontend' DEPENDENCIES = ['api', 'websocket_api', 'http', 'system_log'] diff --git a/requirements_all.txt b/requirements_all.txt index a8718ebe5b7..b2ab7ad37c9 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -331,7 +331,7 @@ hipnotify==1.0.8 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171117.1 +home-assistant-frontend==20171121.0 # homeassistant.components.camera.onvif http://github.com/tgaugry/suds-passworddigest-py3/archive/86fc50e39b4d2b8997481967d6a7fe1c57118999.zip#suds-passworddigest-py3==0.1.2a diff --git a/requirements_test_all.txt b/requirements_test_all.txt index 4331b7d11e6..cbeb84860fc 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -74,7 +74,7 @@ hbmqtt==0.9.1 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171117.1 +home-assistant-frontend==20171121.0 # homeassistant.components.influxdb # homeassistant.components.sensor.influxdb From 34f06e8eef2ce580710b5a7bcc00b651056f2b5c Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Mon, 20 Nov 2017 20:48:52 -0800 Subject: [PATCH 113/246] Bump frontend to 20171121.0 --- homeassistant/components/frontend/__init__.py | 2 +- requirements_all.txt | 2 +- requirements_test_all.txt | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index e7cfcf8d88c..3d83c524461 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -23,7 +23,7 @@ from homeassistant.const import CONF_NAME, EVENT_THEMES_UPDATED from homeassistant.core import callback from homeassistant.loader import bind_hass -REQUIREMENTS = ['home-assistant-frontend==20171118.0'] +REQUIREMENTS = ['home-assistant-frontend==20171121.0'] DOMAIN = 'frontend' DEPENDENCIES = ['api', 'websocket_api', 'http', 'system_log'] diff --git a/requirements_all.txt b/requirements_all.txt index 405bafaf13a..412405fab1c 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -331,7 +331,7 @@ hipnotify==1.0.8 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171118.0 +home-assistant-frontend==20171121.0 # homeassistant.components.camera.onvif http://github.com/tgaugry/suds-passworddigest-py3/archive/86fc50e39b4d2b8997481967d6a7fe1c57118999.zip#suds-passworddigest-py3==0.1.2a diff --git a/requirements_test_all.txt b/requirements_test_all.txt index c9ea20494d4..ac39aef6e47 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -74,7 +74,7 @@ hbmqtt==0.9.1 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171118.0 +home-assistant-frontend==20171121.0 # homeassistant.components.influxdb # homeassistant.components.sensor.influxdb From d7f9be964080a569da2a08cc3fbbddeda8df9d55 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Mon, 20 Nov 2017 20:50:12 -0800 Subject: [PATCH 114/246] Version bump to 0.58.1 --- homeassistant/const.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/homeassistant/const.py b/homeassistant/const.py index d8b4dfcb044..706a3881831 100644 --- a/homeassistant/const.py +++ b/homeassistant/const.py @@ -2,7 +2,7 @@ """Constants used by Home Assistant components.""" MAJOR_VERSION = 0 MINOR_VERSION = 58 -PATCH_VERSION = '0' +PATCH_VERSION = '1' __short_version__ = '{}.{}'.format(MAJOR_VERSION, MINOR_VERSION) __version__ = '{}.{}'.format(__short_version__, PATCH_VERSION) REQUIRED_PYTHON_VER = (3, 4, 2) From 2ba5f1f45e513bce49cce575d1696ae8be310cb4 Mon Sep 17 00:00:00 2001 From: Lukas Barth Date: Sat, 18 Nov 2017 23:33:18 +0100 Subject: [PATCH 115/246] Fix yweather (#10661) --- homeassistant/components/weather/yweather.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/homeassistant/components/weather/yweather.py b/homeassistant/components/weather/yweather.py index 514eda0f09f..a043f3c2212 100644 --- a/homeassistant/components/weather/yweather.py +++ b/homeassistant/components/weather/yweather.py @@ -115,7 +115,7 @@ class YahooWeatherWeather(WeatherEntity): @property def temperature(self): """Return the temperature.""" - return self._data.yahoo.Now['temp'] + return int(self._data.yahoo.Now['temp']) @property def temperature_unit(self): From 4cb0e4b3c24995d51cd8a18f771acdcc6bb18c57 Mon Sep 17 00:00:00 2001 From: Anders Melchiorsen Date: Sun, 19 Nov 2017 05:20:31 +0100 Subject: [PATCH 116/246] Properly initialize Harmony remote (#10665) The delay_secs variable was not initialized if discovery was active and no matching configuration block existed (i.e. override was None). --- homeassistant/components/remote/harmony.py | 1 + 1 file changed, 1 insertion(+) diff --git a/homeassistant/components/remote/harmony.py b/homeassistant/components/remote/harmony.py index 7a398def5f9..40536a83602 100755 --- a/homeassistant/components/remote/harmony.py +++ b/homeassistant/components/remote/harmony.py @@ -60,6 +60,7 @@ def setup_platform(hass, config, add_devices, discovery_info=None): False) port = DEFAULT_PORT + delay_secs = DEFAULT_DELAY_SECS if override: activity = override.get(ATTR_ACTIVITY) delay_secs = override.get(ATTR_DELAY_SECS) From 8cb87d5e64f982fe7ba1e1829d024f202f3d64a9 Mon Sep 17 00:00:00 2001 From: Thibault Cohen Date: Mon, 20 Nov 2017 12:02:05 -0500 Subject: [PATCH 117/246] Handle the new version of HydroQuebec website (#10682) * Handle the new version of HydroQuebec website * Update requirements_all.txt --- homeassistant/components/sensor/hydroquebec.py | 5 +++-- requirements_all.txt | 2 +- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/sensor/hydroquebec.py b/homeassistant/components/sensor/hydroquebec.py index 884f101c033..d857ce57fce 100644 --- a/homeassistant/components/sensor/hydroquebec.py +++ b/homeassistant/components/sensor/hydroquebec.py @@ -21,7 +21,7 @@ from homeassistant.helpers.entity import Entity from homeassistant.util import Throttle import homeassistant.helpers.config_validation as cv -REQUIREMENTS = ['pyhydroquebec==1.2.0'] +REQUIREMENTS = ['pyhydroquebec==1.3.1'] _LOGGER = logging.getLogger(__name__) @@ -34,6 +34,7 @@ DEFAULT_NAME = 'HydroQuebec' REQUESTS_TIMEOUT = 15 MIN_TIME_BETWEEN_UPDATES = timedelta(hours=1) +SCAN_INTERVAL = timedelta(hours=1) SENSOR_TYPES = { 'balance': @@ -115,7 +116,7 @@ def setup_platform(hass, config, add_devices, discovery_info=None): for variable in config[CONF_MONITORED_VARIABLES]: sensors.append(HydroQuebecSensor(hydroquebec_data, variable, name)) - add_devices(sensors, True) + add_devices(sensors) class HydroQuebecSensor(Entity): diff --git a/requirements_all.txt b/requirements_all.txt index 412405fab1c..4ce91ce57a7 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -676,7 +676,7 @@ pyhik==0.1.4 pyhomematic==0.1.34 # homeassistant.components.sensor.hydroquebec -pyhydroquebec==1.2.0 +pyhydroquebec==1.3.1 # homeassistant.components.device_tracker.icloud pyicloud==0.9.1 From 235707d31c3c87dd43d6034ca190a520968bb0ef Mon Sep 17 00:00:00 2001 From: Egor Tsinko Date: Sun, 19 Nov 2017 20:41:30 -0700 Subject: [PATCH 118/246] Fix for time_date sensor (#10694) * fix to time_date sensor * cleaned up the code and added unit tests * fixed lint errors --- homeassistant/components/sensor/time_date.py | 2 +- tests/components/sensor/test_time_date.py | 27 ++++++++++++++++---- 2 files changed, 23 insertions(+), 6 deletions(-) diff --git a/homeassistant/components/sensor/time_date.py b/homeassistant/components/sensor/time_date.py index 69723aea19a..bfdf0c3c3aa 100644 --- a/homeassistant/components/sensor/time_date.py +++ b/homeassistant/components/sensor/time_date.py @@ -90,7 +90,7 @@ class TimeDateSensor(Entity): if now is None: now = dt_util.utcnow() if self.type == 'date': - now = dt_util.start_of_local_day(now) + now = dt_util.start_of_local_day(dt_util.as_local(now)) return now + timedelta(seconds=86400) elif self.type == 'beat': interval = 86.4 diff --git a/tests/components/sensor/test_time_date.py b/tests/components/sensor/test_time_date.py index 98eb6e79428..1b3ab68988e 100644 --- a/tests/components/sensor/test_time_date.py +++ b/tests/components/sensor/test_time_date.py @@ -1,5 +1,6 @@ """The tests for Kira sensor platform.""" import unittest +from unittest.mock import patch from homeassistant.components.sensor import time_date as time_date import homeassistant.util.dt as dt_util @@ -36,11 +37,6 @@ class TestTimeDateSensor(unittest.TestCase): next_time = device.get_next_interval(now) assert next_time == dt_util.utc_from_timestamp(60) - device = time_date.TimeDateSensor(self.hass, 'date') - now = dt_util.utc_from_timestamp(12345) - next_time = device.get_next_interval(now) - assert next_time == dt_util.utc_from_timestamp(86400) - device = time_date.TimeDateSensor(self.hass, 'beat') now = dt_util.utc_from_timestamp(29) next_time = device.get_next_interval(now) @@ -89,6 +85,27 @@ class TestTimeDateSensor(unittest.TestCase): # so the second day was 18000 + 86400 assert next_time.timestamp() == 104400 + new_tz = dt_util.get_time_zone('America/Edmonton') + assert new_tz is not None + dt_util.set_default_time_zone(new_tz) + now = dt_util.parse_datetime('2017-11-13 19:47:19-07:00') + device = time_date.TimeDateSensor(self.hass, 'date') + next_time = device.get_next_interval(now) + assert (next_time.timestamp() == + dt_util.as_timestamp('2017-11-14 00:00:00-07:00')) + + @patch('homeassistant.util.dt.utcnow', + return_value=dt_util.parse_datetime('2017-11-14 02:47:19-00:00')) + def test_timezone_intervals_empty_parameter(self, _): + """Test get_interval() without parameters.""" + new_tz = dt_util.get_time_zone('America/Edmonton') + assert new_tz is not None + dt_util.set_default_time_zone(new_tz) + device = time_date.TimeDateSensor(self.hass, 'date') + next_time = device.get_next_interval() + assert (next_time.timestamp() == + dt_util.as_timestamp('2017-11-14 00:00:00-07:00')) + def test_icons(self): """Test attributes of sensors.""" device = time_date.TimeDateSensor(self.hass, 'time') From 6e27e73474047bf759a390d856bd8e92339b728b Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Mon, 20 Nov 2017 21:44:22 -0800 Subject: [PATCH 119/246] Shopping list: add item HTTP API (#10674) * Shopping list: add item HTTP API * Fix order of decorators --- homeassistant/components/cloud/http_api.py | 12 +++---- homeassistant/components/shopping_list.py | 31 ++++++++++++---- tests/components/test_shopping_list.py | 41 ++++++++++++++++++++-- 3 files changed, 70 insertions(+), 14 deletions(-) diff --git a/homeassistant/components/cloud/http_api.py b/homeassistant/components/cloud/http_api.py index d16df130c48..27fd6f604c0 100644 --- a/homeassistant/components/cloud/http_api.py +++ b/homeassistant/components/cloud/http_api.py @@ -65,12 +65,12 @@ class CloudLoginView(HomeAssistantView): url = '/api/cloud/login' name = 'api:cloud:login' - @asyncio.coroutine @_handle_cloud_errors @RequestDataValidator(vol.Schema({ vol.Required('email'): str, vol.Required('password'): str, })) + @asyncio.coroutine def post(self, request, data): """Handle login request.""" hass = request.app['hass'] @@ -92,8 +92,8 @@ class CloudLogoutView(HomeAssistantView): url = '/api/cloud/logout' name = 'api:cloud:logout' - @asyncio.coroutine @_handle_cloud_errors + @asyncio.coroutine def post(self, request): """Handle logout request.""" hass = request.app['hass'] @@ -129,12 +129,12 @@ class CloudRegisterView(HomeAssistantView): url = '/api/cloud/register' name = 'api:cloud:register' - @asyncio.coroutine @_handle_cloud_errors @RequestDataValidator(vol.Schema({ vol.Required('email'): str, vol.Required('password'): vol.All(str, vol.Length(min=6)), })) + @asyncio.coroutine def post(self, request, data): """Handle registration request.""" hass = request.app['hass'] @@ -153,12 +153,12 @@ class CloudConfirmRegisterView(HomeAssistantView): url = '/api/cloud/confirm_register' name = 'api:cloud:confirm_register' - @asyncio.coroutine @_handle_cloud_errors @RequestDataValidator(vol.Schema({ vol.Required('confirmation_code'): str, vol.Required('email'): str, })) + @asyncio.coroutine def post(self, request, data): """Handle registration confirmation request.""" hass = request.app['hass'] @@ -178,11 +178,11 @@ class CloudForgotPasswordView(HomeAssistantView): url = '/api/cloud/forgot_password' name = 'api:cloud:forgot_password' - @asyncio.coroutine @_handle_cloud_errors @RequestDataValidator(vol.Schema({ vol.Required('email'): str, })) + @asyncio.coroutine def post(self, request, data): """Handle forgot password request.""" hass = request.app['hass'] @@ -201,13 +201,13 @@ class CloudConfirmForgotPasswordView(HomeAssistantView): url = '/api/cloud/confirm_forgot_password' name = 'api:cloud:confirm_forgot_password' - @asyncio.coroutine @_handle_cloud_errors @RequestDataValidator(vol.Schema({ vol.Required('confirmation_code'): str, vol.Required('email'): str, vol.Required('new_password'): vol.All(str, vol.Length(min=6)) })) + @asyncio.coroutine def post(self, request, data): """Handle forgot password confirm request.""" hass = request.app['hass'] diff --git a/homeassistant/components/shopping_list.py b/homeassistant/components/shopping_list.py index 8b318d07946..8ec023057d1 100644 --- a/homeassistant/components/shopping_list.py +++ b/homeassistant/components/shopping_list.py @@ -38,6 +38,7 @@ def async_setup(hass, config): intent.async_register(hass, ListTopItemsIntent()) hass.http.register_view(ShoppingListView) + hass.http.register_view(CreateShoppingListItemView) hass.http.register_view(UpdateShoppingListItemView) hass.http.register_view(ClearCompletedItemsView) @@ -65,12 +66,14 @@ class ShoppingData: @callback def async_add(self, name): """Add a shopping list item.""" - self.items.append({ + item = { 'name': name, 'id': uuid.uuid4().hex, 'complete': False - }) + } + self.items.append(item) self.hass.async_add_job(self.save) + return item @callback def async_update(self, item_id, info): @@ -102,8 +105,7 @@ class ShoppingData: with open(path) as file: return json.loads(file.read()) - items = yield from self.hass.async_add_job(load) - self.items = items + self.items = yield from self.hass.async_add_job(load) def save(self): """Save the items.""" @@ -166,7 +168,7 @@ class ShoppingListView(http.HomeAssistantView): @callback def get(self, request): - """Retrieve if API is running.""" + """Retrieve shopping list items.""" return self.json(request.app['hass'].data[DOMAIN].items) @@ -178,7 +180,7 @@ class UpdateShoppingListItemView(http.HomeAssistantView): @callback def post(self, request, item_id): - """Retrieve if API is running.""" + """Update a shopping list item.""" data = yield from request.json() try: @@ -191,6 +193,23 @@ class UpdateShoppingListItemView(http.HomeAssistantView): return self.json_message('Item not found', HTTP_BAD_REQUEST) +class CreateShoppingListItemView(http.HomeAssistantView): + """View to retrieve shopping list content.""" + + url = '/api/shopping_list/item' + name = "api:shopping_list:item" + + @http.RequestDataValidator(vol.Schema({ + vol.Required('name'): str, + })) + @asyncio.coroutine + def post(self, request, data): + """Create a new shopping list item.""" + item = request.app['hass'].data[DOMAIN].async_add(data['name']) + request.app['hass'].bus.async_fire(EVENT) + return self.json(item) + + class ClearCompletedItemsView(http.HomeAssistantView): """View to retrieve shopping list content.""" diff --git a/tests/components/test_shopping_list.py b/tests/components/test_shopping_list.py index 449eab65016..2e1a03c37d0 100644 --- a/tests/components/test_shopping_list.py +++ b/tests/components/test_shopping_list.py @@ -9,9 +9,11 @@ from homeassistant.helpers import intent @pytest.fixture(autouse=True) -def mock_shopping_list_save(): +def mock_shopping_list_io(): """Stub out the persistence.""" - with patch('homeassistant.components.shopping_list.ShoppingData.save'): + with patch('homeassistant.components.shopping_list.ShoppingData.save'), \ + patch('homeassistant.components.shopping_list.' + 'ShoppingData.async_load'): yield @@ -192,3 +194,38 @@ def test_api_clear_completed(hass, test_client): 'name': 'wine', 'complete': False } + + +@asyncio.coroutine +def test_api_create(hass, test_client): + """Test the API.""" + yield from async_setup_component(hass, 'shopping_list', {}) + + client = yield from test_client(hass.http.app) + resp = yield from client.post('/api/shopping_list/item', json={ + 'name': 'soda' + }) + + assert resp.status == 200 + data = yield from resp.json() + assert data['name'] == 'soda' + assert data['complete'] is False + + items = hass.data['shopping_list'].items + assert len(items) == 1 + assert items[0]['name'] == 'soda' + assert items[0]['complete'] is False + + +@asyncio.coroutine +def test_api_create_fail(hass, test_client): + """Test the API.""" + yield from async_setup_component(hass, 'shopping_list', {}) + + client = yield from test_client(hass.http.app) + resp = yield from client.post('/api/shopping_list/item', json={ + 'name': 1234 + }) + + assert resp.status == 400 + assert len(hass.data['shopping_list'].items) == 0 From 2ba83655bb772b15e3d9f4ca035ca47e29fbc85c Mon Sep 17 00:00:00 2001 From: Alok Saboo Date: Tue, 21 Nov 2017 00:45:00 -0500 Subject: [PATCH 120/246] Add presence device_class (#10705) --- homeassistant/components/binary_sensor/__init__.py | 1 + 1 file changed, 1 insertion(+) diff --git a/homeassistant/components/binary_sensor/__init__.py b/homeassistant/components/binary_sensor/__init__.py index baf9c41cfdf..e4ff0982718 100644 --- a/homeassistant/components/binary_sensor/__init__.py +++ b/homeassistant/components/binary_sensor/__init__.py @@ -32,6 +32,7 @@ DEVICE_CLASSES = [ 'opening', # Door, window, etc. 'plug', # On means plugged in, Off means unplugged 'power', # Power, over-current, etc + 'presence', # On means home, Off means away 'safety', # Generic on=unsafe, off=safe 'smoke', # Smoke detector 'sound', # On means sound detected, Off means no sound From 6db5afe597bae6c10f95a1ae1cc95484404d9251 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Mon, 20 Nov 2017 22:00:43 -0800 Subject: [PATCH 121/246] Update frontend to 20171121.1 --- homeassistant/components/frontend/__init__.py | 2 +- requirements_all.txt | 2 +- requirements_test_all.txt | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index d3142232404..751a4e2cde3 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -23,7 +23,7 @@ from homeassistant.const import CONF_NAME, EVENT_THEMES_UPDATED from homeassistant.core import callback from homeassistant.loader import bind_hass -REQUIREMENTS = ['home-assistant-frontend==20171121.0'] +REQUIREMENTS = ['home-assistant-frontend==20171121.1'] DOMAIN = 'frontend' DEPENDENCIES = ['api', 'websocket_api', 'http', 'system_log'] diff --git a/requirements_all.txt b/requirements_all.txt index b2ab7ad37c9..e0e82970d24 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -331,7 +331,7 @@ hipnotify==1.0.8 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171121.0 +home-assistant-frontend==20171121.1 # homeassistant.components.camera.onvif http://github.com/tgaugry/suds-passworddigest-py3/archive/86fc50e39b4d2b8997481967d6a7fe1c57118999.zip#suds-passworddigest-py3==0.1.2a diff --git a/requirements_test_all.txt b/requirements_test_all.txt index cbeb84860fc..4cbabf75864 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -74,7 +74,7 @@ hbmqtt==0.9.1 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171121.0 +home-assistant-frontend==20171121.1 # homeassistant.components.influxdb # homeassistant.components.sensor.influxdb From db212cfb009be3ae25a325d58b92db7f4bef931e Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Mon, 20 Nov 2017 22:38:12 -0800 Subject: [PATCH 122/246] Fix tests --- tests/components/test_frontend.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tests/components/test_frontend.py b/tests/components/test_frontend.py index 3d8d2b62a2b..bd2d8afc209 100644 --- a/tests/components/test_frontend.py +++ b/tests/components/test_frontend.py @@ -166,7 +166,7 @@ def test_extra_urls(mock_http_client_with_urls): resp = yield from mock_http_client_with_urls.get('/states') assert resp.status == 200 text = yield from resp.text() - assert text.find('href=\'https://domain.com/my_extra_url.html\'') >= 0 + assert text.find('href="https://domain.com/my_extra_url.html"') >= 0 @asyncio.coroutine From d0296561f61653e240d889d8298629af93316572 Mon Sep 17 00:00:00 2001 From: Sebastian Muszynski Date: Tue, 21 Nov 2017 09:23:39 +0100 Subject: [PATCH 123/246] python-miio version bumped for improved device support. (#10720) --- homeassistant/components/fan/xiaomi_miio.py | 2 +- homeassistant/components/light/xiaomi_miio.py | 2 +- homeassistant/components/switch/xiaomi_miio.py | 2 +- homeassistant/components/vacuum/xiaomi_miio.py | 2 +- requirements_all.txt | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/homeassistant/components/fan/xiaomi_miio.py b/homeassistant/components/fan/xiaomi_miio.py index 8fc77d1bf5e..e5430555910 100644 --- a/homeassistant/components/fan/xiaomi_miio.py +++ b/homeassistant/components/fan/xiaomi_miio.py @@ -31,7 +31,7 @@ PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Optional(CONF_NAME, default=DEFAULT_NAME): cv.string, }) -REQUIREMENTS = ['python-miio==0.3.1'] +REQUIREMENTS = ['python-miio==0.3.2'] ATTR_TEMPERATURE = 'temperature' ATTR_HUMIDITY = 'humidity' diff --git a/homeassistant/components/light/xiaomi_miio.py b/homeassistant/components/light/xiaomi_miio.py index df716bcf1e9..ddffed52271 100644 --- a/homeassistant/components/light/xiaomi_miio.py +++ b/homeassistant/components/light/xiaomi_miio.py @@ -28,7 +28,7 @@ PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Optional(CONF_NAME, default=DEFAULT_NAME): cv.string, }) -REQUIREMENTS = ['python-miio==0.3.1'] +REQUIREMENTS = ['python-miio==0.3.2'] # The light does not accept cct values < 1 CCT_MIN = 1 diff --git a/homeassistant/components/switch/xiaomi_miio.py b/homeassistant/components/switch/xiaomi_miio.py index aaa37a24c0e..534c4ac0a32 100644 --- a/homeassistant/components/switch/xiaomi_miio.py +++ b/homeassistant/components/switch/xiaomi_miio.py @@ -25,7 +25,7 @@ PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Optional(CONF_NAME, default=DEFAULT_NAME): cv.string, }) -REQUIREMENTS = ['python-miio==0.3.1'] +REQUIREMENTS = ['python-miio==0.3.2'] ATTR_POWER = 'power' ATTR_TEMPERATURE = 'temperature' diff --git a/homeassistant/components/vacuum/xiaomi_miio.py b/homeassistant/components/vacuum/xiaomi_miio.py index 829d0878ffe..131f5d5a77f 100644 --- a/homeassistant/components/vacuum/xiaomi_miio.py +++ b/homeassistant/components/vacuum/xiaomi_miio.py @@ -21,7 +21,7 @@ from homeassistant.const import ( ATTR_ENTITY_ID, CONF_HOST, CONF_NAME, CONF_TOKEN, STATE_OFF, STATE_ON) import homeassistant.helpers.config_validation as cv -REQUIREMENTS = ['python-miio==0.3.1'] +REQUIREMENTS = ['python-miio==0.3.2'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index e0e82970d24..5d03480d6c5 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -837,7 +837,7 @@ python-juicenet==0.0.5 # homeassistant.components.light.xiaomi_miio # homeassistant.components.switch.xiaomi_miio # homeassistant.components.vacuum.xiaomi_miio -python-miio==0.3.1 +python-miio==0.3.2 # homeassistant.components.media_player.mpd python-mpd2==0.5.5 From 5dbd554a108205e58c6c61b26075c4eb0a217334 Mon Sep 17 00:00:00 2001 From: bigwoof Date: Wed, 22 Nov 2017 00:35:23 +1000 Subject: [PATCH 124/246] Adding Queue count sensor (#10723) Adding another sensor to output the numeber of items in the SABnabd queue. This is an alternative to displaying filesize, just a preference thing, as it is more meaningfull for me the way I use SABnzdb. Note this is my first time coding on github and I have no idea if I am doing things right, I assume that all I needed to do is add a couple of lines to the sensors available and also another line as to what to extract from the SABnzdb API, in this case I have called the sensor "queue_count" and it gets the value from the noofslots_total which as I understand - each slot is a separate download item. hope I did this correctly - also I don't have a separate instance of home assistant running for testing so I have no way to test this code (and I don't know how I would switch to the dev channel either). As I said I am a newb! --- homeassistant/components/sensor/sabnzbd.py | 3 +++ 1 file changed, 3 insertions(+) diff --git a/homeassistant/components/sensor/sabnzbd.py b/homeassistant/components/sensor/sabnzbd.py index f034755e780..9ce2da09451 100644 --- a/homeassistant/components/sensor/sabnzbd.py +++ b/homeassistant/components/sensor/sabnzbd.py @@ -40,6 +40,7 @@ SENSOR_TYPES = { 'queue_remaining': ['Left', 'MB'], 'disk_size': ['Disk', 'GB'], 'disk_free': ['Disk Free', 'GB'], + 'queue_count': ['Queue Count', None], } PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ @@ -211,5 +212,7 @@ class SabnzbdSensor(Entity): self._state = self.sabnzb_client.queue.get('diskspacetotal1') elif self.type == 'disk_free': self._state = self.sabnzb_client.queue.get('diskspace1') + elif self.type == 'queue_count': + self._state = self.sabnzb_client.queue.get('noofslots_total') else: self._state = 'Unknown' From 8a750eba684e6bb0c1d543eb771b4fa51ac46933 Mon Sep 17 00:00:00 2001 From: Otto Winter Date: Tue, 21 Nov 2017 18:04:44 +0100 Subject: [PATCH 125/246] Bump pychromecast to 1.0.2 (#10728) Fixes home-assistant/home-assistant#9965 --- homeassistant/components/media_player/cast.py | 2 +- requirements_all.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/media_player/cast.py b/homeassistant/components/media_player/cast.py index 2aebbac5043..ca3da7ae165 100644 --- a/homeassistant/components/media_player/cast.py +++ b/homeassistant/components/media_player/cast.py @@ -20,7 +20,7 @@ from homeassistant.const import ( import homeassistant.helpers.config_validation as cv import homeassistant.util.dt as dt_util -REQUIREMENTS = ['pychromecast==0.8.2'] +REQUIREMENTS = ['pychromecast==1.0.2'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index 5d03480d6c5..f135744c467 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -623,7 +623,7 @@ pybbox==0.0.5-alpha # pybluez==0.22 # homeassistant.components.media_player.cast -pychromecast==0.8.2 +pychromecast==1.0.2 # homeassistant.components.media_player.cmus pycmus==0.1.0 From 9c77f5f5a973a71572da7b55a84a4792d266e174 Mon Sep 17 00:00:00 2001 From: Bryan York Date: Tue, 21 Nov 2017 10:48:36 -0800 Subject: [PATCH 126/246] Fix unit conversion for Sensibo A/C units (#10692) * Fix unit conversion for Sensibo A/C units When the Sensibo component was released, there was a provision to not convert the temperature units unless "nativeTemperatureUnit" was returned with the API. I'm not sure if the API changed on Sensibo's side, but I do not get this key passed back with API requests. This causes my current temperature to be returned in CELSIUS instead of FAHRENHEIT. Removing this fixes it, and I can confirm the units are shown properly now. * Update adding comment showing temperature is always in C --- homeassistant/components/climate/sensibo.py | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/homeassistant/components/climate/sensibo.py b/homeassistant/components/climate/sensibo.py index c55b4c9ce0d..9111e7821a6 100644 --- a/homeassistant/components/climate/sensibo.py +++ b/homeassistant/components/climate/sensibo.py @@ -133,10 +133,8 @@ class SensiboClimate(ClimateDevice): @property def current_temperature(self): """Return the current temperature.""" - # This field is not affected by temperature_unit. - # It is always in C / nativeTemperatureUnit - if 'nativeTemperatureUnit' not in self._ac_states: - return self._measurements['temperature'] + # This field is not affected by temperatureUnit. + # It is always in C return convert_temperature( self._measurements['temperature'], TEMP_CELSIUS, From 2084ad2164512745d7bb65bb66f6c54d402533c0 Mon Sep 17 00:00:00 2001 From: Guillaume Rischard Date: Wed, 22 Nov 2017 06:19:13 +0100 Subject: [PATCH 127/246] Optimised images. Saved 80 KB out of 656 KB. 12.3% overall (up to 32.1% per file) (#10735) --- docs/screenshot-components.png | Bin 209711 -> 142388 bytes docs/screenshots.png | Bin 237223 -> 231797 bytes docs/source/_static/logo-apple.png | Bin 15269 -> 13441 bytes docs/source/_static/logo.png | Bin 15701 -> 13472 bytes homeassistant/components/camera/demo_0.jpg | Bin 43574 -> 42708 bytes homeassistant/components/camera/demo_1.jpg | Bin 44897 -> 43965 bytes homeassistant/components/camera/demo_2.jpg | Bin 44535 -> 43713 bytes homeassistant/components/camera/demo_3.jpg | Bin 44897 -> 43965 bytes 8 files changed, 0 insertions(+), 0 deletions(-) diff --git a/docs/screenshot-components.png b/docs/screenshot-components.png index 11b7980d6cab1cca7612ec9ccf72bd8636fc19c8..a98b3d41ab9b0ef209ac40e6f8b7e35f6b8538a5 100644 GIT binary patch literal 142388 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 literal 209711 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

T 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�y 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νPc!-^4CH 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 mWni%4#N#6dRS0|PTdfKQ0)|NsAg{Q9+X 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

d3n=v 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%0DxBV^d#_1iipH!ePFChc-~2>bLoHw4U$E)dgM*1; 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
@IzfsuP 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%0AgU#%5^1_6nslsEAz*kit5tGzYQ#zZ#(J@=& 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 literal 15269 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�(?tbYP2I(uHR(4rn4BBLn&r3LoZSB{X3^Ps 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 Ug_c~e8=#HOp00i_>zopr03DqeA^-pY diff --git a/homeassistant/components/camera/demo_0.jpg b/homeassistant/components/camera/demo_0.jpg index ff87d5179f8364d86acf3a875e374741c5285bcb..f062b26bad79807c4149c88573ed9567b833a4ed 100644 GIT binary patch delta 42035 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 QelPuJ|B3F)yZ_$=0BfF2o&W#< diff --git a/homeassistant/components/camera/demo_1.jpg b/homeassistant/components/camera/demo_1.jpg index 06166fffa859d9fdccf1fc89a563cd6574319d42..a349f22b1523ecc5abaf187acfe98382edf8c699 100644 GIT binary patch delta 43302 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%0A-zo=VPm>u>UN{xiINv%_}re+KWD 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 diff --git a/homeassistant/components/camera/demo_2.jpg b/homeassistant/components/camera/demo_2.jpg index 71356479ab08c00a17ec0e09c9198714154f85d2..e21d7457ebf019d22ebb3419923f8d8a528461a1 100644 GIT binary patch delta 43048 zcmexklyqaxl(fieP3GWMC3xWEN!ne}qAXfq{{gk&%%B0T`KCSlO7^ zIsV^b;DAVc31M(_vh}H3v-Q^WiExFC4h#$e@g@um49|A48-1O1)2jh4$H2fKZ*?;! z@*4vKOV*9^FHEN=)FVkUb$?FSdn4-9Oa+kU{j+29mL5Qo4y?;A6cjtYZfT4^1B1ub zi>a@^enOHLgU2LKGdk7wwpQp^M!^pYyuMf(2R)W$IZM7VKRfs?dE_W_q)J)yH#6_dAW% zwHkWEjEfJg*V^-CdCd0X8IL}mJkPaG-{TfngTB_r+t>89M1<}H&AMQDfbNlc(0qm**W1$*^(Wu=U(OJ zR!z=Zz`($y!NAbPz`(#%!P9YEZNInW%+Srwb9}ZZo?0`X&$;Sl%tyV44h#$|0St_M z^%Gec7+8M(oy~Pm<&CM(%$dOnGD&GWg<{mJTk~s<{xN$W!r;WDcsk6Vi-9}jMd#54 z3=Hb0#AKpQnMtktIX5s#=8@WWz7+R1Q?Y>5h^sFSFmh$+b&7@c1TYwWx+k&tivk0K z|Ae0tb5+fE^ZnegVk2Lna8;+7a@T3OZp-D_di7TrTvw%inz=*&#YG1PV=#gKh3_O@&MpdO+V_HiS#a)*qh+sRe=J~_ zVpkRRBKNx&$opJ#b^bFr-1=h8R#DhF`}o40@|mvlFQ!#&DVpuDiec)!$}P**rG?FQ z;ZkaP`nfXvUPouioR+2MZ2^_>DQP3HrV{W^kH{TX!Ez)6$~8nqP0FV z>z?hlJvQ0G;)vIs^R6sjv&(D6c@8uzwmfT7%{*UXzT|$tRp%>Aw_jO*Z9Ch;RZ;J= z4xh@i*~;Ly=acF;qwHJDsydAd%scMi_|`4GEj29a#20>ndS5neufmyM`s)?0zg@Lw z-SyM|mLALARBx_+rTFE#MW)Hp{m#cePYV08jX}+AlgY7-QNAH{4^MAkd-=D0PIbrD z8)%CN}^2KI}FIP}MTbr$X z<SW?~pn>)FJB?`&9o6tLi)0CD;BF`s7-de|6sK*`KbKFaA{{8@2Fi z*?)#ZYuETJ@sD#AewO-t^L&>p$K$Ft>)4t;I31r}+{av{`Z?z6+f@y7jGkDnWzOIF zG~W5g^(D5SuG>w2X<;9+VCxLyX@_$1m7d=FYQlV^)z#PZnX@kM>G^)&)E)Y#?w>yK zeEGtiXX`7k>a7c4sjjX1dal^w&Z?Ski*rA7OZf*cJbfqf-ifnm7t`{!R;)GOyJLCh zr@b0?=B!osulmn$!H+>C%ygwz->vh^O$%=AU=Gr`d+Fo+_iJ2NCDrmhJ{NTLzQLS5 zMbAA}9{aX$v(47N(pM|G_Nq_6eB|N!=wHrDS}nMC8XZ}=-Jrg%)Nz}L$FF5;g+fzS z?sG49pEzypvQ1`26$*1+ynVdw2v?>^?d@M{3RphfI%kpnnpfc{+f3!_pJP`CExU2z z=d$R61&v#$&)r_WXDjp7$T;uVXN7;P4i`D>mR&V7O6qymtB*>ZJ0T0#m8Cezr7D=FUR}E0cF=>7M!C_%*-yl2(1; z>;o5X*Rn=@t17q13%|JKpKnmZ`Zw`c?|*swzT=TuNY1slI=dYh`1L>i-oM_o*<#hb z>C-4)%PuFZse%^S3@KP2224&Gts|9`P&xrl=b#{vcBn zR`CJ`_E`@W1^k`(GBr(ni}PIBv(xP&<34dL^sZ;`Ih*$C>K##`<6Gyxo|ix6?Ab|Q z(>trv?kzwzF@p(b`k?a(w`0OlfLvXEE6hRr+8LAUS+S~w4IMt-F;SZ z^6kH9d!zkfWPZ}srVhrgtrS1^^0D2r)n^u$N;$A^c&nCUB4AT}T1{E+mWNHe z^XsHti;_QI%8UwNT)Xs`-9qzUM_ogna?H}ss&3mTw6RdhOYHHvdh0Mb=J{zCf1C|@ zmAida<=!q0{qD@Yr7JGp&RaL_?uwmD132F4C%yjb=n@i;=G*GKD?RP!*^o%Zg`efx z96McTKrm6j9sN zo0=81cZzMy;=Rw+XW#j$X4@;qyQTQ1`R#6v%Nnf*DjzMV*w=n>3Imhp6Y1W^thz+x=rz6&0F1C!J_;- zEMH6a)SbOEZ|QlN0y7)|+1LIOiEB@$@^#Stadtr58Al>wefPRF&9S zyK1@M-IBbm*7XkR>N!?xkI!a{wo@#A>0q58xRm>_5X0ITpH^uwX>cqm6!MQ1{5gfC z{ECv(8%~*%DWO8zZ+~n(zl7ObmiM!Qg7=G%%nzW}6Pwf&LDe#u;}cl@GZ?zMIxo!m z&+z{UgES)}12ZE^Tb7Xt)Rtujw`A*?1Q-|?E;*>OxHy4KVPIgCW>95uQG#-0Zk60= zU=$R9w7xjQ+a|8}`!*?oLkX(DYhTjGtcSL?wL%QqP(@So51;l;Z`RIUUcWFwsH0Vw zlSxHTMOBEQQ&F|{cH+UKN1qqnwcWQqhtW9Dv))lrFhz}nVFshI0Dr#6GSL^dH z?PyF<1_nez&oxpj(?*zjtv6&7mZgT#nYEx&_vRACLbJAr!dHKo?cJ=cIe%Y;H__;?Zee-<> z7P;k8X;Y83 zz%RZ}k`;%h%~jj<{%wOyo%^Nq`1#+e6FAqO{au~?yt3Y1f#aig#gd{+#{2ib5R|MG zj?u2pty;c&7enEXdHcTq{LfIlX@PHD_N^D|XP^91%pmwIJ)+~$S#PitCTGlBaenb^ zntOHUCn-=X~|11vx=HOKEAmr*OT=$FI*`Jbixp z_LncOH|s??_dog5RqMWg+X9ZT?S&OLT=xEFaB#EB6<#-aTHyAwZ4-6=_#~+ry!mDK zHmuJsrE=D%+_TTWS8rkzf8J|!_~`RZweLa7xo&yf-yJQ~TH~V>X!^^>=G)!7Khw`X zeHmN){8QcX3k`yG75690i)-4|H}7$akr2%ADf#wZSY`E-5BYPGs;ez`?B4L;_Py)J z4_y{M`RFhI{)G`v+7XxK{G}~t{E~a5H1lH;%h$5EW?Lp5K5|TZ`@&ZhSDwCo`egb3 z7Zs9c7RyWD`z0$lH*LiS%@>xIAI}AUkv*|C>-=;rmF@X)pA%Jr&wkol@9gt0+vKQb z{ky7te8C*&PyYJ%T3d3V9Iukvotv6kk?$t`B z&aHhPedhCo;;Q-84^q~ovs7H|wAgfcQLWyN4yK*O;ma5Mbw|vY_48k?(ywo2`9}|) zo)fFH(*E0DWu88N@v5QCe+J!oH8R_+S8X{wZ^>2$#^qj@+2ZWoYBt}VZ(qNBUZ8O9 z)?a$JJ)gHnuGO>ryjQ!{>e~$t74es|eS{u=uDtg0$^CmDYS06{7Z~&wlkjXLm4Q zch%UGhRS*T?)!@@Hgxv>`VyV{D80kN!d+FEL{l{Gs%(oOL z)*W)Nv@5sUAHFPUPsFL+Re{Sx>lZ57Wok{M_ArZ{B{VXHvnSM7^8U#L0T zL6u3fTJzBdFYaqGTlaQc z&6+64v{87=RhC6Lf(k;1&vv&g5?=0f%`xV&)g@i?>%RFKjm8?QHY+A{G9_tFSM|_; zrFA(%i971sF5~*sJcZ9smA<$gIkSVKDQJqIg1f$|a@@WXOOv)8mwFs^rn9MZ-`%;g zV&U^APo6d_|MH##Oo*0_8C0L2XkcLQn6g{}BF(_S2&%pfRx>a#Bxf&q0veox$<#A==v-gTYO#QU z@l?>{1eh=b1A`FvrRh>zf2uGrn0W!S-88-Dp^AY_;v&pTc2 zu|5~@aDMP4h6JAZZU@*J7?Ri&I~W)k7~ALd_VP+kv+~mK%PV4VVDJi>%>b%@J(9sD zRLHbMezhtpIDPh+Ap-|PiW>t51B(Ge0t3Sl!zZ6|?L#*jCILO2@MSFhc+jDiOz|b!tyjZCqeeT@Y*L@3mDtexaYVqaIcvp)WN{0 zx98PI?~89YCSDYt+Pm?{ocx%_s*hJHFizjgAn^I>qk09VxJjqHmhmt!a7MLO-8t{P zzU4C|P6~ajWcI ziDls4D|OXp7cl76|Kho!8*d*Vz^Ly(oi*?J+-D37-etvejvE-fSh!m{Z0(+#v8VUe z&e#{gAoWG=)>D1?`{%DZF%*575u?7e`kX5RgVzyNO{C+84 z`P5Nn+5QE`&aSH~KXui|L*}nqxq12aSwaj&)gIUzX+7S67#|^wrKi0^XNT z*Y{MXoR4!Uc*(py>)6o)O%pzETIb%{*So1qXI` z&Z538n_s?v!`SYkb7$uDV5dOlY4&=bXEU(Q%|2J9_wL9Q)%0!koG%qZH&uP(EB*5) z$;;-c;QK6v!%No0POyx-`a)T5YTu+8Jg)xM(;t`D|68tYv^z@7D*d|2V@<2LvSs%p zKd){SsOxi<_tYy~7#0@6qh9o%!Dm&i&dw7o>gMvcpZC|klHPD<$F(?eefAqZg z%Ju115*wYrY+{()E-}%Q!Nk(P`+aK3B$nB%I`QW3xnoo>+3;wo$4y-0WxH2A!hKdt z(NmGx`%_hRE~{6Nn3eH9l5d8 zEn-}q>t*nSmxqN{cAZ|Yp`gry!jEyc-Y?qlX;apX&m}iHe#JifY~eJwW#bPohHs^l zVqUoNFw7Aaewj08mZaEydCeDJUf;UEVdKk?mCq*&RQ-)~HgB!*<*Q$>#ij7Ir26Zm z6HnUs?lqryVDdcoT!Lcx+vM|quD>eQ&5!I$<+7`r!BMyHL-yL5=)X&+vI+>P+im;B zQFQ4_w!W^3-<{=Z+_P?6eBRq#t(@q2xKKT!-_^ z7hC4``OWUp#W^C{#qU>t(dUk;Uv3`tt#{VcjfNA>YIFGLgrC}f^(mJEgV0mmyp8JX zYq%_@URhf%!Lm9mymtPy$LE%@=FMGOHEYVtPc5lSH5SOOs@(qe(@8%D2B9ar@4ma* zyYF$Yk45=zMFtJMV0Ep3=`D+P=6)A=zZQzw@~kiN&@x`|3Z12r$f$+U;;~k)eZEM8!kqvL_M~ z{JyNd_dIB&zm$?ym7JwPkKey`d%f6i9|9Pd%}iVPoO&2kwM2g$@3+-9WNBV|^ias< znvbg%ynM0p@zK68ixavZSUOeh=5F83t9B>p0dvTr*)O%eO=k*J&u-T+;IjD0SrujR zvf06V%SFBV3GLp$!k*8Lkhx@4r8g(!o=t^I&+dZfW&f1FO4=6d6m&6IB)F))%y`Vh za(I8xvA+3vmEUzYnQWMIL&<8xmoTH6b4gtje!bdi=^ehFU)$Dm;ew~lC)8hRCMz(c z^)Hyaa;u~vcdy1#p1fF9wfkCMR)s%4dGf|vxtJfevYO3~JoU2z)n95pTEMBE?0n%{ zO5}MVS-;Xnz9#}(l-a!Zt`5^Fc^cMNYUjXv>g;aWh35*+F1x7j=`X_YcID>mtyv{} zb1(9JQ@^=M*`;OY=haSYD^7*!$L_YX{Au}T2J@T+hMLE?FJC^&6fM_uL?bo$vG%QS z>(bt=KdZtz&-TpO6|wbR{h3ocf8J4=pBr20w@y#rggtPjTB}suzI6)szP&d1B=N1x zWkpJ8lgbfhmMOdAuI^aquh#9h?9Hq*pGyy(JtgGevi8;MB=-8q)X$$yZ(hG#=0AV# zA~OaCW|phxoo|%bd||zO=_Y688aIZ6jB4QV2ulG5MrI~vHWn6E7A9s!(EJxOBNGb) ztDulDn}CR-p^<`;v7@N6feE{qim8*TOF&{^p@Xw)5O}zPk%5teG4{qa)86F$QpYwf z>PYpG`&~WzjAY08@DnZz{AWwn#l$XRG;rowtXym?|Jma48@y3W?7#T{AbbA?^*vD4n6!c9Q`-H z{IX;3c<99C6#MCY3A0*!C*A!`=N7~JPpvtO)Rg}-sIItk^=Z_zx%Tf*zge-e{@NLX zHJ2tX>QLP~#gn@?@{`h%?3Hsq^K5)}Y{HEGmqG@eS3mOEojG~&q2+;{&EgqTZ8j}F z)vvg-^`DdL#C69N*9NuhnL0`GdZ_JZ!z*iCU0pUWn5OJ?V}qP_r>fnpLw~|NW7Fy? zKh2xg@knLn+V~DHnMucT_Z4}%EB#gH?R!^KFY?Mfn|~t9pVc!A^DntJd2|=GtJ=l? zc=~$B#3O!>ZZW*O9LaU>lG_B;=ZWD3OS4yV$s}~Hb98K(DD}m2&A&C}SLcde@^ZOn zy{6qmSs?h(J3m*~myZr=Ok{f3->*tQyp%r&to|Ib`g2I@&jBeY zst2=v{K)>y078!+u0O-H{){r1WL$rSaeaT=J{zeYKe8V`T;I>O&xY&A5ADYf*7q~* zv*Y^lr3#APRQ&)W?_#$7j@Am8ahn{V{dp6r`(#D*`s}{>#J=!~^>^onE>{U_macYISw<+wfP9|1->QZ`PkKddL5L=DS03De1}O>QSAiT#kUvkXl|P z5t!g!wbqKWt$s(Rs<-$G>lw0FTcs~gZaezir}E}S^#}V6(gm%}Z`)n1Klb}wR`u%X zM(++9Ec!L+(yjx`zL`xuePpY-+wYZitS`3mUo-XlGTZxl(M83^zhR6LJGwh&$UVHv zviGgQ{98W`#~V2mUsD#nGB@k`x7Ghltoc&WeaYPe@s@kIFV<)Auc?~((ro%#uQ#b$N?$c1PBIj8ylF08k!}_e zWae=9)DrhdFN+gD3f;`y6O)hexTp5!3A4;RVavX4t$oJ+$6*-`XH}fG-Z0&@mb>J} z*E$Q+W&iY#%gwgFsjIm^WsAP&*1xxcN>}W?WW)D1s`1slrN4Zamqty#arW3(<%^e} z)Z5KG+q*J3&!yD0&C~5l^4i=dE-K4*-8*FaB+Kx;`{GV+@rdiv)!{FFXK3_fcOKgq zEb@4EOtE&qtlewLo^Tu2M7K+uUz$A^JoO}BitDjsOitC~$0bX4ItOj>{AzeKT*U3T zl%Rxb{j9c>IPd0yC2Qxro$mYFJwSX?(BHS}QJwX7l@GkTy1IS^I1pA{nfl4NaBo21 zU-1jSrGxfrZ4%s-!Yevi=8uGTgrw|?#+EZ{qtuuD+E91x{L-QNE9K@TJi5mBz^pHZ$8H&)->&!H`xRIH z*)pZQNKK@^y-sw~=@~&+BfsUX`1<#&s>^GLgI0kZbZ^Nwh@^En@3qWBB{XND zXxOS?MO_Y0`L+v(U*uW9HZJ*#fp{jc$A_rkVvDMbF$Ry|$P z#dc?jPNJ}Jw(M=qn?|$0<*)cMZ>xG#@0EY-Wox7VI)|Kh)vQ|U`8L(|#GGrn_cTtN z;oVX>Yi&;LLcS0utH)vv7bVL=9#%#lUChG#!97OJBmdIu{|w8PELt}^=-E%^TY?MM zhI6N_>YQGmJ$J|BYAzc)`BO)K7uU_O)oL~iDXdxKHRYj!UrLi(T(Y9KiC^jI_X}!6 zm#*nOG*`^(^4g1Gb2HOF+}!bwUF^E?oB4siuK#=Gw^e%OAHKIy+pF4F&TG29*I$cA zr!+S0T;bK01U|=w(uY0bLbOd!tbFokcWJ&=@jJtiCC_qdZ*u4cgJ|)$XMPp_!FsVJCsXY#{WjxM`gg$wG= zpR`n8Enocmg?y;q+V8m+LM9*DE3MfbwPNe4Tbp)@UJ7OJI$RZCY0c#yH)+vV`^LY0 ztIJnp&HVOmUCh{O7F#&PtV2Ho3W{C9S$`2yy1WdoxqH zZ_YfnmDzRivZxztK1U{+i1VD?`SPw|xBs#om2HmgglUHA^~OHZAPEY|fd zm-NrH0PO84-9T4_HMh7B_{sWvw0Eg0prK} zYDx`cdNyp0&Jogk8SY_Ncuno*?OXdIe#hr(Z`z^GIde`N+qUl_=TbR7Ez_Rl9Jtm; zsD|-$-$TuBP5&9vr~Jro-gZRi#-Ehro(GBTU+T|p7Q4RQC?`hz+vKFC11~#f^Q62f zJ024?FY?;Sk188nZ|a?#%71D7zp3`uqNbjc&N46QXZ|f4_U?1Y`E9ik6DxuQ%RRE^ zh^Mv}@$5M3rn^k@_FT@*`~T&IEjrvgZ=rhv^RlZeSi<6xFP}K3roYGck;jRqkN+8N zxV-#4&#LD3jC!^cixOBauGXBS$DHTbQ7L%p^^Z+Ej8@-UbNup@54yR!UlY08nNKuD*{gSC#j#lH9PQKrN3O=>39YG z^M6d|IY)6z?DswWENV}jd|sGo!!1vDvsuC!_XMBo@Gj^!3vx@Vzxnq|c-YCZGb`#Q zUH{MEsWETYmDaz~S}<=u4n2A^QSxeLmg*Kcmh5A`4mDmct{m)}TU1o6A(L_@HemDjIs>i1!`MbvvisUev>S>c;vl z1U_CY|DC6M49C+&>&zbNy1fGz2Kn{Dp$GC!lscz< zIn89H_5L{5@#2Z0t6S7HrnjlO{XM3d9DJv5=l&OxJ6pb8JG=YKQeGKdW6^azNofJ% z#dCUHi;m2>DWqb^HS-hSwqMn)QZ|7R-zpLqp7=yu`|;Ke!dmU-JM*0rQ4$D}O^ z-S+6kWoJc(6pM(Im44w`Y>WCC>n+b^9Fd+KD)-IMu&&|n`UTQ!*9Ao-m^r_FryX%5 z%_ZSSv6S9(+qKW0Oc$+ETJ+_k^{Q(ZmCXEBz1eKKZfQ`igv4ovJF{(O#ItmE`(nzVq{A^Qkqi z;)~a@`E}YkU6)ncr>v@Fv;EL+P0pDdrWMcM`aZgqD;aIOrE%9Yv6q_m&al#NPD|Yv%Un||L(FicR8w`F&69=faesn}a) zmymg>k0_%;P0NXO#h;~Hm1_;$-K?!w8PETC;#}@6FZb;;zZ7YI@G7{gu!cE`#l@w} z?Z=YiiN_~?d={hIcjBq)tS`NS3vNAh^uK)Pz1LwYld`_ZxwBg9bCawM>+eRm+^lxj zaz0-?QRP5O$&NB?NFR_2i`S73N{@K}5 zfhR-`IOoQmk}UUGsUUB|l=kxJizChIZL`e7e|>nh^={yy)utcHKJH+dUNckm%Oiog zuczDb-R#+AwCV8MQvG*pS8CUP4r~8iuu42qjzjE|uPOr*!-b@fW1U$ES3Lz+NIop+ zS2BFKpGl4Ttc_}&i;wPyDMn4lb90uQusHcXY+I7^>=%2ZdOy2nsKh#|6fb|VZo)BT zvq%p?$t6#BJ@}f!$>)FgS?|G_ol30{E3PeC@o8$p)O{@xJ=~kuo~&PSDr9Y6QT_92 zxBN=8V^mj6KddUO;dHY|Qp}LY+vbYVR4#j)%lpe+7F!$2Z29s`Uz}h0wv%tcr);Ot zj8p66LUR_!+_*IH!|zzXzgMSfUx^ZbyKsf)cj=uqQaX@%Fmd${y2EuOlnKQC=p zp=6=K3-+M;$9)g9tX|8?Zkc}UTs;@7>$yut7iufsD_v=SDm=ZU@YR_fd!bWOx`jIH zRJR^kT4;LYYU|B*)vMfFzt-;B#d<(5rFX@Ir=cOYnKtlp9lVvP=VU3KskYTP?A)Qb z#Yu7z#}00kIL~0UQS`3)dp6c9oICSSx)~R|qtEb9)*6=P<;#hUl zD7d4Z>+X`ti#9f$JnOb4$Nf|Cv_;Dz4*Cn8TxMDny;dV(%Vh~O-VU?8Z-@F*dv)k!`;gp4^L=*D8i*rvtoF$#|cpXpoX7+1b zp8Ya`hnht1Wo`a)DB10qYQ58rQ%(EgyWJJJp7Fgg*SPJr*Fm~CWc8m(Y7u92wkXcq z|21HVPGxWG<-1R^%cF{F+^x4BjC!!K_1Y+I|kN@%(6lpBVYZ)TeIBun(BcNVaoly&P7E`RA;-}|z2 z=~VTQ?Myw1E~Sh3dQNt2ek}Wx(Lr&+&DLDw`e@d#_CEq^)q{oEOl?$@Bkr8r#(8ww z%OyNbg0uQWnl>fedZm1^x%is(I~8G%6`2VWbgR!KN$@%toK;z9UG(s3nvcqIo8+w) z>CB!ybDX7Cd0&|kWEY`(`Rcicr~HZ;rqm}JC>F|mpD-_7DPe}HcGTX0oF&=8%NyT@ z8wM)Oj#B6jzW!`cUZHTz>8O>iR+=CEZ1$bqIag-tX7>ph{Du4E#if4KL_JWt&MdXV z;>$+mhe0e?<|=gw?&$94m7f&6@VML30;lI~M{{m0lT{TJ6ciNNyGo_EFfE?-h@MJm zn449-jE+*?q2^OHZSQZj)y~waDoPdKGCdv%dtRNq;+RZPaNM_bx|JUP zeuW;MZqAZ?ugfImroMmp^nGc-rYC93PnTx&&0*8E(du}*c5c&& zvWkOwj}6~TEmka4m=`Ern8M-tJkqH1#p1k~JC8;Rm`as|gt+?N)vNwCcgJnx(BqdD zmtFr;F~f;r*Q5Hr0%>05$9 zn{;6Dv|b~N-Oo<9<+x1yzHVCctH2lqi{8YL$w@nJZ|naS>Fqk{d$+EnUvru6vt#Rf zS3H~?;Co9}wK~;(@9h-+0KGl+(KB|&s(oPCDl;j?Yf{(JEv?L~Qw#N$Y&`B$`|6HJ z?PjL>Q)+K#XNOf5ep|iy%X=18Up<{(L7Qr``3tHpt>Zi&QF6%e^eLSU&nB!>bbDkO zu=3>EC97xEJP6(V?!N!~s-Tk9<)4?nemFfP(dRMmwaB$Eww*lb*J^0BrdU04$-~F> zHZ6ZF_HBBekZ`?fk-jS9B)tvs9NA5CKdE#uhfnzKStQPwxyKllBH8Ng}ghU5@k5abh@dbL2`X?-I@Nc?7F3E7n_AkdAoLPx8CCy zvoNb^NkB8TGvkqeB}~yDW10=dDY81qN~&I z3eA0OUAq5DY4u+j?VOmaECpd_eSMB%3k|Ia)#1^Q{5|r{5JDFvaVfn zOE^aL&YXAE_3vMGrcL+tk+^av*9Z5$Ox8;r-|SvJd$f9^xw?{4)5$W)&mr}zy`OfTopidRNhSH< zDvjk+KCW7EYwMN+7xzp&$^Kp4y!84O(;WXR({`N-xyyVle)-n@m7-#gIaT;YHpHzf zo1t~<=H3OJ)!X?z%q4s^?i^L*mO2xt9k}9(+j}i*E!&ML1|M&Pot~j_)A-ouGn0IO zCo8(97YmzdKXp72H?h&eJ-mK9=Q*znJA>S&tbF$1NjSUGqWvv9O?kKQ_bZt!$ve)c zbffLotsRdd5_C(}&SskI=hY|5xeUW%HgmZiDOA}RW_HQ+^44V^W*gcX zcivVC{aqQYUm|el%XVfb0k`dkI|4+x&4N?BxPzxRzRQ+)ZXw?x&Rue7pV*PN^%dK? zgm#uc&H5aBY{gGyV0tbLX$Ioql_D*$)-pPYE19H9dDm(y8^!-eg389fKq~-IIMGp1G4n*Dd^Jwyi%a zcbi9-^TFGaW{ea{c+aj}!cLn$rbt9}$;Tys~lYI<6&-yhpTl z8A~mf&Q{LSmRxh|M~_TKebHmV7sqOOmsH!yPnu&YDPx}Z`pUN(PZvgBanHV8{%G^o z!y9tvemeD^VUqrl+csC+Pc~cG+&D8)zIiUF~zzP zM^hH1Mha!LT1}BWmaND<#cxteuHmJ-PLHIXl%_@9TpGI9eO<`&jeBE_jDp_UN`pL#y%@V$o-Y-^u_vq?UgC?8WS69ESyIbg!v^R5|yQ!$y z`uRJTz0_`y_q=HS=F#UVTQz@8>ihf7$E)+zsa3ptQv}SrSGD%7&i(55v{y%4 z)8meo%a8hrGuE43_^0e794mJ>al&Vpsy&a3p9+n~pxIB}U;KQ4e`zG+(#c7PPMu`FhA>T|J+#&<)qmYuAb@u!`SX zJ7=-pBSRT;vqeI6U5P6TS5H3my8CNZ{DSwav%K1Sa!m`5mT$jW-&z>wapLnCG1j+v z9M_gza@ZmCz;ki?mhBxeExwy>34K}`ee~cD-Nhe%z1IyqK7V6!dyeaN#*WM4{Bq|$ z@8a4S+++4NvcW65xxVXE{iMAj%i~_AonlWiNnWZjFYI`o$T3#gt~((Sic%q$rhNEu z`lR61?r9SZKIE*Ps>hnDn)rohr;FcoNdR8uOB&XPThL!__CN}+ntm9`aR9;t>$XPNNzfw z7x5@p>p|DnZ2t@W)%Og~Pv|SzusHPWw%aWA3ePpyUhugiUwX5;`ji0YZPo0srNuw=(ER%(`{zmc_+~)d3S_ zl}!|MD&OR3YUNFcyX-W@@CdieWzM@(6+C_~Jh50H;zZ@HFU7O29KFbQQk>HzReR#v zqvW#Yv+i!l$tAAa5WU<-d`$xJ~s`hs) zx7%41MM)(ED)CA!4&QmLtv~gYS+x8-j>4h`SED*oP09qba*pTpbw8!LCicK> zj#XEB4Qs;m??``nGL?mWV&$qwyYCd5P0Lu_CA=c@>9LM7L(6H!)3+Wi`g*L*z4yh( zTlt&2Kh2qLJ!_fBWWA31Ez`Xx6|J*+w&(R@;fXuKkG!jR951%xVXNx7=e>3x3*2^I z&ArX}p(Fg_eu3pXcW@ow>ft^4N$mM;-^{ia?983a-Q~jj@7u}=WxIP094qqpabZfN zobIA&_NsPY`ro&2QS3-nIK3^w?UAOmSESs6^;Ufu?s+XI3M0f$x61{HxX!K5O+CfA zR%jc4+S0;J-U=I%CwAO2PG4A|^j3FM>Y^{Zu6O51zdNz*C4a($+j_#?T)Dr_CT!Ve zd{gNodz*69n(PD%@O;%PHgFfd)DIbcz=~2ddhJ- zVyWd@zooN|eVY_0>-97$$~`eAG0^DJ-q`x<2L;xPH16$?v`{Vhw7PBL`$N-q1YPIJ zdgvd;wzOZJb@>gpuV)r+=E?5zzPa<(`atvaJnt)FV*J+`l35Lsy;#>z**bCR603`{ znMRw8W~}9GDdD>wHSbFJw)urY|Um_BV3?*wr_@e^x0SQi*^g|Z+AUz9dYf;UAZS2d}nTlOxvWg(y4EKf!lf` zuE(moUVKZx?7B21Jzj1}khzs{$?GeQ_nt6(R@J$jWq&yN@6q|LaYxpiD^EJA89imv zH!tJM0;g~O?y1RqTP$ABULh^R)HfF@Jo1e6o=7ocV^0!d5{O zS6+{oyXw4eepZKHTHTpj_x*25#GT%BA*gk8*|(7D4Ca?9>ic<)zH{K(ay(+IrjN?& zBW)8Nm%Gd4mWdwa+A%R)Nb8Yv)T1TZ^*~o_vskKr2JX-kSzBbStHJ3Y zw)mpv4EOG}UYZQpD2cT694{tTKad;YVa(V~P~#kcOQT2}AY z*mQxqb-}rRmMPn|`rUh{QTMh=-zW2c@UItB=gpS+V{>!XUh~xwUp|}m$ype5 zd^uiyW^!(&G(v0e9sCq?M?Pq zjyPI9V^>E@S=Ogad%2{uhzb0tuD=hpSd*MY3Pz}2IqHTP}tt!q}! z6;(Z9{bD<^1op1>F%Alvw0VR3mGqaNpDmQ#V?CBtm>$Wp2cDn2cUH<;)1M_9C z^0UilU#fNgBKctcx0YpJ{Mom%U(Ek!XdSk=zABD0Zm#*F3h{f3e`!AWw&?GrAJ-4R ze-O9z{}Bc!0R~1UCN_3;B}L&rcC1tp`P#6n>Mr{Knk8Eefv&^1e(_Kfe2Tz;z0={wzEE$8Qq4^yno|1)qNJUsnh zJ^R)i>q(-wXKi>A{OZ#|<9~@Z)_;yTS*l%^Y;0!iF^5cdEn7ZesetCjQ!00BnktOm9l5wFIGg9t{-6G9?g=%ve0lKj^q-Z!^IcvR z6$vv7%r*@0UuBfYaw2VUB;Pe(N0kF5a~{lpdAGZ`p5t0x#6sn>F4J{{?Y~ORll|xN zOXRYi*F6uh)giY{R30avH(TywRqB+PA-Y!U+O99RnZJ1{72HkvQmPfDHZcy&(efR1z0ikz>CO~-WG zQv&A~ZYt)^?W!-h`=&qRUKaBk6?s?ISIk$$SMUeOE!gW=)%2D1755eK75V{j3v5xj zNV5I`^A_4VS0!JToAvNTbN`~2ue`6Mub8jM_o?5+C)ZVX^7!ot|5c)8%l~Mf*dA2; z)=MaFS^X5XIZmQYH_F_1WYw2149Kfq7ZAdRCt6I=R|kG)l~w zmw8~J@~o0$u4XZZ3SO=}_WtAdtfc#g9z<%dI@f2ode-B-#ku~zYs5|!Xs7;c$(GJt zey04#wP_-U6K|`lSljVs+|Ucu+E%TQvMBOsm+73lGk@u^PI_ok`0Ck?+YW2e7-R!< zG|o+1E|_I(nyXoVbFur3_a7HsEx1>f^@pn?Ub%3&{hg*ux zLuxZM7w5S~#$NlSplzR4Gnr*}a@E@9_q?`A?{9r({U`r!`JJ+ui8IYv(gklHSADmA z#jc}=o=%8i>o);e>n@$~C`MbwY_<7QtHp|w7z6n;PIr}FbdG&dAGj$@_hs1Eh`q;m z?R>XNWmd|JV6V(zhPafT8xIYtxBIP}7#!^97ie~Om-TJ0-_MIDL_Au*eA2_Bhulrb zW~&~#KlQuBqtvScit;6C3^VdgK1FIXJ+$ZUyl;DT@zy`ui96ni@NfDN{4G9f;e-g` zyW1{3iZk9SRj;xn$?DibrMR@}YXY6NVOG=6=!xqItb6m~v){Vx-YtdO`t%Py)CL)! zd@H50HMOv4XKdB6L;JT2-alXZ?4Q7zYe&R16zmjCYlX9g3w&1nl+~}r#?z@Y8+2*B_TEkt7-Bb7~mYov$R?oF3BJ;1dx*o%hjL&|{ zyiJd2JkHuFb+j$BbBVw_ZJ&r8O$YZ|&C|5r^;ux1AxqOufjcbioO{hTm$#lf%A|C- zFxw;SuX)twcb|*QY?toU^;hkkb9aW{+eGWb9kVuWDw(xo?){bnEt609t+iUMuE(}c z%I5OQNoUhEwtVZI9AGfBzTvD>Vd7C|EzYgZ#!nXR-ndT9%Q(61-10ujf7Xi?{ zr8uMs=hxh}Y5G-YZ!@{=<-Mb)z8zNR`}|e;%Z%gx-+lRas9ZkldoG!!^Q`2yl?7j8 z{N6iq{9fLw>=Wpf}JOMA15rXhzWl6=?S@J)pE9Fciw-a=WnJS5hfazTCh&^WaYXmC)0LnKbl}GdRAz$ zbgffCP8iqv%rhEu7hIB1{8qtpN}()gMg7`D7NOg}mhU*!%(qxBU;CBQkw=2FeUEj! zsO@|o(fM8acazGkL!GohhIFZjF?1OS{Rf zKbL16PkAlUV{lVad$sjmAy;WbOWkAjCNX)DThqdHXFZJZ`5Bja6}z$G-z>o;{CrVA6ir z_3qf!ukwq|ZuoiDNp|rJ9?#pE{%R}@D;s8gh`N8PH)7JwB4Y)Qugf%85@tLv4sO3{ zVYz2(!Zr<-E9FWJ?YwPaNukXQ+v3~~A7gdZ%duw7ajF+;=XuYgHaAMf(QMwwruGxN zD?SAV9}GXW<){9o&Dy86Th^)lS#R+wWpm8bkMe)Ga?MXKYAx-{^V~aoW1xtmW<&8- zyM4xse^0n``9)8I@2^0fM=s~QUbpQ%bS3qc#m@HbTqb z;#$FHg>oBibYAK`QQx$=>O%d>vX3X!#f3YUUT%Gq>6Tl5)*>oITIN;bvroZs4zoL1 zZQmpc^A%k>?zHMiH-DO9*2Os1&rFH=8Rs`hznb@T>LRP#MNzitr?#ECIPcoCSge9hhPYY*^-2Sw3`Qu>KSqF5Y?Q5L_=00o;np87+b@yAhg4U+`=8)^gHcRHj zpJb3aHd*mb!PGs^L%+qDoot`CymMPA*YEy-J^XS>aV=^S$nCOIu~Z&yUp%e z(Z=}Y`abWP+tF4Q{YUwJ=kQLCdwk@Q*dL3wtTT@Bh1=TGG{rx2(YNZlc%J}e37NHP*E6-ew(M09+(vvZVBj<0uBFQSc;!L?* z+=)0xjoEQJZe`XFCA}oW-lDmDvMkRwk&hN@&%fP0ZP|z1uA43SJG8s*vrN9!!`!vg zZuPv+;R~YqKI~@d;5hTiM@y(aWpaq*vXDl(k7p&%VxT)OdwTE?vo*Pbwm zb!$})hVIX?6fo(#;wOjiym=DN;&TGV#w$9gsKe{o#uUoOm!k~W$V zx%%R!1#%}JtLFb&afsPIJ3l;OjqY7b_32NoSZ=&NWUBC@p#FP==s97z6{q&dH`VtY zb~!bp{XzRlL#u>%p4GhP^4ufuPW}Vn*LIuS>TBG}7c;pvFMR9i>H~jX9+mB3GM3T&l;?GQPR8B#8ccxx__a$<@#yX~*HR~<@WaYeg^gV5MXzva#yD8pJ^fb37Z8|*TS!0ck z+*+wa`K7&C+jM#&j;}qKyzOb%xdmU|l^4#+4Rh)a+~Idb`?zJow$-)w@2sh~mnz;S zsc7!It<;y-e9PysNoH+Xn#ugFQXlzy)|>ukFsYB-?E2xx&#K)K5iiyIQFm9=GdRt&RUWIr`ke{7EaOHy=C{sv^|@4a6Q>`*<{;s`mRo#`Qp-I$?Rv8A7C$-Hn6M{h zcg$6$PYcBjIP2S`yDAc_UFWyTn5kyH$vEh2C@nDI`C{{UVatWv?!HTmc|E;%>59;{ zzwPIrT5Xoi_V8En%RS}U+Q+t%{i&7TM4r6j@IBM3FYfqhy081n%DF<;*5>x=$_9Cg zTn86~W+f&{URJoFTjDWill!lVvOOP_!<5baUB7#uEnIm#`gT-(R#t`xS7uCn>nz5r zGaP*xt|~HaR&nV*Ini;G@0$e)#!jnU4~O`!7t;8fp|-|NCg9DZlwjwk&X9tsT&vZS zFJ~XEUCYS-s$+JQ?&(LnKddQnc(#2)IP0W`QinG0;XSi(yFetrLd%Sc3Yy=7Q>sr- z_KwpL-g)})mU~mov)Q|^2Zlo21K9due{Of^Zg}aaGUb+YItA{hnmYyO~&+ zZ_J&1W<~FJ|D0co1g}{27B72ar8d!Mt^(s4!IxQz(w1qBZ*J#Uq>E^6iDBDY-*d@z z{|?2x%)4uBdS7l$bQUu<*C@U9Iiz9jst1Zinc})X()|7|jqi+LzdYgUPR@)A(rQ~C zy}35&M(O#>`KmH*tzrjtWZf913ihtgc2{|}k0*A5Tjt{JX)mMCu}+kpC?d&{buho% zNHpx&1i=NfIh948IVK#La^d;8{7e2iQ~T>b>^5!o3^!2zYSQlW?`kU}i)sGBIG6r_ z4I<2$tKZCe8WAF78~jLPW9|ke@8)mW@hS&q2s0)4a5ge3y+4%Sp_X75T>LZAlJh{b zCUc?I0X>l$54>Znvi_c^&Uq!?5q&-Qh}5fsj;LB!$<_&1w`@7XqP53&eSRq45?{&7 znc|l9PP{3~5xXK5f0=RHYQ2D>&B5+PH+~dPO;Hd0dgqOfn{UP%uat!wj~r1tc{V23 zVNz~~8*dmtho7!xxA2{J%X+`PHNPnRQ1Yu&dhK5WCpYe_iRWX&)EPQj_#{>=%hLI^ z_C=tIRdAb-dsB|Xu9z3!#i zTW3vziI6+nGTlalJZv;zkZaA&Q`zWmM$DBJ0XBgb%+8TUj z^_?uIFFW&(n9g^p_f!v)>b?Dzch|i1hiRJveNSmlaY&mNb8S=BO}mp{oqQ#-cNNTd z$)=%}ERY*|YtbHE#nT=t+@Z&$>rBlTN*#=OqU~0CSarL!u=4>e#l-$ivMtx|HZaFJ zXNx^(4f^4?X+C%QpVgj|a*kyyu6xxd{yE_MCDFM8F(L`iR=j1`39gU%V;j8NLh0Ta zMZL?pr(Ps)>HHB9wXQp2_oBNjjW05Ve-(dS{O`Tu?+x+!?zt6n?!2z<7jbrUl@xci zKUA<~y>P=~bsdR4=g${>x^8p!poOJ@D5sNV>mnDQp1@zf%nsi^&Fj69Xi|{+$ z`3^lzzXCQNS-W_qliRmB9bp!y>Lq1v`#$Vj_U_D@X^Qb-?r{&)!tPC!3%#XV8X_J0 zWasBSp5`wMk3QBkWK`dlGc7TH&lOwNSI3<5KZyMapa0ACbjuor6QxC`ZWUzY$_WSP zKEL(0Ml|8Mpw;%X-!(QWA8ImND5wx()mxoyBpPy<&Db~G>vTxc^Uf>we^!LX^GvJ1 zCb{;Ri^6|~V?C!Ha-UnQ_x{+g;}_*$E}H3@C#0oNqOob>l|3#Q^>5X#CM(WlKEe7e zI>qc?sZL7mvVX5?1orvbMMiSj@crZ4+E-?&yKPI`tUagNQg<3>Fa`Nn%awJoos^jz z&3ntBK>z5~&F)z)HtV-spa13G>Wa56PO-CFj@5ft>79sEHomxP{+*%^P1_f{tgF)A z8Xc#2Kx?g~sNnXd5Rb&hhi^AMU|F)Ltm(rUwFT4mHmyjIR18yz-L*4iy@H5Y(iZ!x z6>0CQET%bDeo4LiLE1L#$B#gD7OA^4pUmB^zv7JJa?u>OeXDl~SKVbg>-!^Zv#ofC zzT_&=%RF*Z>hDWF+}GjjtU1lX^T2{@D|!P{FS=`4`s)cQPPlwV-LF8~dWB0^r`-hw z>xjTumfZ$=3w8yq`prC;0KEgmdIzsvij z)+?koWvn^7On650dDU}Y7d_442s5AQD|o4re>N?ExMW1_3YPL)w?q* z)~PrBJF@)3a%Q#_m9M-uUif~`O8rc6!1Id+Eh%%iCVXG;#=Y&?o|5g6i?W{Wy{~a% zU(h_yhgNBuHf`iM+1KH}PV?pC-FqiWxhh|^XwuW&TOZ6)n6ELnCHP^{C5gyK^;>PM zB?{SCIbBlwuAG>2NIfV$FK5yIoia_A(cZ*EVSuo$Z9i{Aa z=-QVnLYlXgSz;A*x7zFydE4^asjZ||b6 z-P`+o-ij-aiuX1hJ#T+jF8N=^T|<|P<-3aaUQ}V59__|hy5!`BwHke=-FGf}`6}wI z$KDo+8K3KY8Rw~gl=-?T#_y+FxcYM6t(TW*FIGBrxjf{l(1k8_`7RmZL$i0Wvdl|0 zF?E^lDthAF;?=gNzIAGUb;@wG{*|%apQ-0op2l*9W1TY>hr7*PY^io)k-U_`oKNre z#~(U--=wnt=b~>X@0}L3(i3R4|x$Iv9+34wd$|69c~D8xp(uH*o+%i z$>y_)4rc0foXP0AW)g3-Z;iX}GBrlY9WM5#wgowIM?DCAXY3q!HUCGTOvtG$p(~~e z+YZhQUh&X&&9w`27e?6lM%-QBd-|2LxUbW%E=68DK_BNR&gqLfLYx+@Sf$mqXvI=D zMK{wKoS9)WWx=AgJmaeHLz<%ydY9hpC?V8YcclbDo51Q--jTAL2O zSZH&=C|k+gV6mXKZj|SCm89e9+yVa?{Q2j;INQf~yb^owoBT-fzgORAX}Dcc zZ}qfgI)8M|pS9UqbL`K>hKF z7~Rx7vY^%a(1Ybd3On~)ztfdgYTn!T<@))^zS7z@ZKu1Vq(}rtQ*RF2E-u zb2DkN_o}W-i?;q2^_gI_rY`eD*3aIbe%x81+1`vMSyxv@JiKVP$Nk>p6%MaDs^wHd zKb$*xCi{bILX*kV;?fUGma8`yY8~5jV9%isZJ(btghg>NXLKs4H8?1!IWcc34RM9rh z-MrfKo=YHmv%h|;{*pV4!JVhP-QO&K92oQDvXG9m(NmVYno1A(`Mmb{hjLu4`)#Gc zr*~qRz&(bA0zX;|=hQD-zxTLN%fTI=9m>|`fB9&q(wWxHc}#fbGr?K8k$G1)dFlE} zDctDOXIJrYj^5HNdhJ@kVUr!XYaX1ry{A#XI@|Hf9<|!IE0Xa^GiInpDSdOkS-awQ zz)zVlUVHAQ?m3?2OSk;sjH9K5^IU%47a^ess`c)013*QL2H=ETWnvMgXVc-{5&@Ft^4rD=yV zroU6Vy2n8^l5wLd=c4bHE8a5hKGhapksZxf_qyVtvyVrW_G-3-mlx$RbgUSrjhEb z$ke6O&{W9z%GF?b)GRKc7xUlEw(B~4erMMUpYDAIfvrs|G?xX;c#!lk@>p?T+vNl8 zza9JxWgECeGyK$?1s2*ZOyCLNEMr-nbhNa5ZcTmPjx~YP724Obn$=vKlu&urVEdwu zsKpk`cBzLlu6-8#ccLoGg*ASD?jg(7l{B)l3T39gob;k^aqx*(t*M(TFR1l8Z98<+ z=682j&Iu>)YL%>dn=?=dS)|m=G@OEhqM2f7t7;-#KDc>-TCcjB%-7)|(ynHgkE{%$c&m z+wv!gMm9uD+K|(A&y36R)l)xjT|aNd)#u)S`@BC~*Jtad!=L{h|9^x*OMsDqiHVV! znS~j8v>+pcprWB;U}B*_<3xpp8$TEv{CM$UfCF>_jL}};=Cr>GzoMcqdZq`eHSd%c zEY&UC(cCe&o+JD5TyOUr9jT}jzqsqB>rOkJy6I-lwrD(z*Khojs_TDbOy#^4{z*x| z##m<$-(<&<*)vK%33S~T+o~a;E&p}u4V%dH?MvgICf-qz35-BOLDPSH1f($C^xKC^Z&Pa<;=+V^hZS!FPpi}^2@&|x>aB? z<*MF~cdl7erIR^jdTzzi ztZ2_v$z;a&k4okrE_$e;_{y70zCO(3+d4~6C&$^L-`cvYFDQt}T$!Jj2{9eSp`mXF=vHE4tY=0dT;6AW3&cVU7wBu@P z?ET=rZFLD{9VQ=Gq!P~TckALx&g%8OSbS_^#T@IBJBRisHbe=&{90+W!29qSh3z>P z*jnVG&#c*9v7=A#``pR*BG2yoU=?4v>HDR{yzhnoGk6r$O#WgR7jMk>pTQum-Z{t!XbWgVz-JG}SX2xpm3w2E~`D=Z?ep&Zv_kn50FMiqaH&o`7l68&X?PoEG zvDz2)ba}S+egC9X#3WEXzxi^A$*w=gFK#}}VE@|SW|UCbj`pxJ@1)AjhAU(aF?>}} zPCR->dV$0jIfGL+Ep}I*&hOw?uV1(+{a57F{|sl!tc~n*~A1;6VQrm2wz30+jy`0YsQwo|&QhV70^(EHwSX?}*#k4L@ zys=`oaluwup^MdrUru~)zCXJEKZDV$4^JOG64-i#c}2&Xcav8Y^ZHguM||Brhi7YH zeTdMMAnjwn%*1xADed{=e?)%m8RK_NVt4-8_1;t7e{<)rzRl?~cCHGZCL>#*ZtSTy z=fLqu_sNTAriPWf`l>H#U&9+b^^xT#S<@X~BCn+eNGosqw_V@<&%q^O#S31uWvo!T z{p#kM@BJ#C->6 z`Coh5!T4I>=?Y&}cb=_|*Q^=Y&V5|Wbgbu<#x&^?qty4k^A7Hij96*3#<^{qyZEeW z3j>|63U+V){GZ|N`sbxOuDoAl1vh+2*VK2?7kp&ydH3No4(q~e3|xn$Hk%zjX(;R} zD8F{azFW1=<{Q@EfBE2RsolXp{&(JM|Bmi{Qg3X3bpMU=my=sUmN;jo#*ywz3sNl7VLZ&9^ki5;rsqaTT(>yb$F5!=RY_+|8eJk zhGSf=w-PyTI=%nnvWZpOWb)1rb4#lI9zUF7vnR3j;P$51^(S8TF4|bXZ?#F|jYn*0 zx3=%%NO(0pYWp?@jVl$_|BRzJ`q>|LGk>4C{QJybcI_9x>HPKk{53YY_V{N*`K3os zv;O?g(E0tu+u!v94;jLq%ykQ#IBELA!?H~;3a8%Tc)>4w%_HM1n_TzKe*%wADc|GC zU8QvUrR@4bzr&wqeYI?o^k?5$mCsPm*YKY~?9cRgp}F!(FESY3tTkVGRbJ?wl=5N#ASe=VEy7x`TW9!}ho$J`_nF{YTsOnVj>=4)zRMtH;r}5E) ztzz{oHjk{NWy`|q`91Snj;?%KUtwj#5R;p=P;dPj^J#}y2F-f=??py^_CMwC?|Iez zPaVqox{UkgT(P-{&ob}L3|s2lBCGV$-+oWMqR67Gd>yxWdP^o}gqW@j+HoUUh57ul z?WNz^L#{c0UAbNIsY%^u*_prEFMiMbefQaO*WZVn-Rr;XOnV@9P2kyqY!x1+&bm}P zh8SmWui`d?oxGy=INGLup8UF`-}CaUc=EwgA32 zk`iL`?sZD6{C%$d;&;wpvCogyYbKqQS-*wxEqmiOp{X63B?6*r*2!;U*)Gs3vU65b zLG+~w8?UZhxAOS)wKEI4jLLS}E((tMRWI0FG(RhL{vpf5)t4DK!$W7kms0N2j=OL} zTk(xwQr48^7w&$a7db&^zWtB>`yEHV+nb4;3E~jXdw7%AbpAK7P3b!&{#{c%-v9XF zR39yCtuU@`Pd2%fX-}rLy^uNHcEyla{cUmhrU+ZvqZ6H;K2?9aOWysCz3|uHN8|iY z%hPuf055^5mU$bvMn5XAan5boC{#?x%fybLy`POzPh4Su83X zKBF;PS5`egD4#i{Dx+~@>5flX*IU|OOnTx0$_mvFlT@9iJJcWNFE7)#D3v#vwX^@L z=Zo}vb;9LuXQuk!`fDS9>7jk{gOTlnCN z^wJZ@TOzkcb{tEvSADu?YyAaQ36_1)D^FjT(zy4zcDT?Ui5}BwOn;6``0-`Vez@k& zg47*zrTTZhJ|`5Oar^efS2t`JeIN8`>b+H5%6Cy~@5%6NewMYX=6!tB6T7Q(*PO0B z7jyis7)?=q(|@VsN{ONWcp6ZZF(_gBi6)Z1^e zk>4!-qLBOBm-&@{=R2)e{%Blh|BhQ~+ux_!UH9(_?PZnj*(Slh(@>aCY@^oA-79CR ziq4(CI>7dRI>!-j=a46+HdNQh1z#NpLJOB=<}+)#OKSGI&9YXbEt4~ zo$1Vf6XVMk8lKS(@1B-FU9bI@|5l+n<#|_5*N1=Bc%=Fy;6d5fq8BSZl_Xi5v<*(< zc)f*pS@;qmr;}1s?58Lk}6eg10Kxs6=ag5kH*AKGVM{8Ib*qwV~^ z$78NmKRJ52zU4*NSIHw!@8r(gIkQ7=68GzXJ~dy1?L0;&W^et-RGqZUJRoMh`itXh z4XZdRS0u}_pQ+Oc*rv8Bu*yE*$=k*oda4VxFQzK}XV{|rG%l7kEY+lD`$7&5MupuO z)2CcxT)etPvw%5Y@O8Vox$e6&KV4OpU6?B}wY%+4)UNvXT9x%jqvkHvtyny(<${U( z>=}Z5Q&+4I`Ec>4n?%%}`jUoIN_A}MXXE5Md>Kxybig-~ErU<`l;n z>-=JO`Oh$8)}O08{TAPsYpK7nsHS6ig8r;ltq6wD9kOe5JickWohr6$2~Pau+{n6* z=lDju1#5LUcKe#|*gKzbO1b%rWuMP*9lmvZVREZq+oPJN5>`ty#ht?=rn2v3 z7JINGDX=$Dt@KO*3&W{<#+(y3SnT7lkq-M-a^)7oIj@)-#kUq zm1}~%bz`x5qI|`b&)K&PKE}#U^kHkQ;@#P_{Kn+{`&3JK_>L)vYi+!fd`(Hr&_Fce zQDUIZW#3Z*@wcFU<!Z=9yo)dQs-I&S7TdXWC~}^_ujezPSbEbkAsIZJNAgqjJt1LE9JWT;jTB z#kih~+LNYdD5|n!V`s5O?E4l^87cogmMg0R3TK>mV%p{4#qzOpX5P}>JJ#Mk^040E zG|Q$__1ij^1{~h*q#-MM%I0Wk6ZftxqusgtIbxqqsC4Do_(oepcB6cYM9KuRd%fz3A5QiqA2tRHOAhc!R9jRxIRx=I;ONP9p!E7T*Ucs(eUg&oY*yWTPaW1X`N3Bv+O=TV+%X`#mVB&ZB^l! z+0~9hDPcJ$yC*!H$zsKta&qy~)e0r5eGe=(o-J4vapl;voU7p#IkM&YY6eAO=W5Q` z@}4Q#r{ERzuXVvcz3!zvcBw%upK>@?{Mm8Tb>qvKlXIeMyjwE&w7+;*-yqjG#ociB zOnsBIlsy*{8BQO|_!7+Y`sd@rzprea>whlK`rqb@femIGx&$ZlS~)DU;$O6`^@LvE z1m85XQ%q04yjeD1u;Ow^>LcF9ea}}h-93_Mz1b!5XWu5f7}NC_gTv@C}!>299S>X)b1eXCouLD}z@pzyZqo@^^! z4+ejR=*`e4=5vxnWTey* z|1&6UJhE!Vqb@xLaic4yJl8h-Inc%Ket*irow@7RSm?2?<+~_)s^rL{fR64R3(mSO z*t%xhV{h{x9TAu7{S2o%FkIsG?)D95KCJigUT87bx0FSApaxqr*ke+$w=-Ufy=t$5S@y6N1`76;96tw$->DupweH=p;M zn{-0=L&w%xcXkAE1zcFc{3=x>(aK_9B7drnvdpUW60K8X?md>hsaPM&qt&_n-6xR; zS$0p>a92Ky&@vM~>-#4nq^j}LxydYY$1ly)*mCXdRkx^_U)~hG6`ohq+U&^fX>&rc z^kjeMQvV($>%6(&otDbER7utt>^flP&LzaOqTzzk-o=yCdUdYU3EWDkbV}~_+IOTx ziScQP!Ud-61!peYo%>br*Us4R`oN>&f;VIxc-$Du=F0iHyNFyqBevnCN#i5^^8zoA zFP8YVcHgtS^wZm`b@sQXIwy)W@J)`|0 z)%Xtz_8+Ds{7}6-L*^nw7P~Bqg_d_ruv9?K@lAR34gIm3M z*6E1PlHMDeR=>RQ$nwehiqdP07jnL=331*~bLiutf3{KWKGvQ`UZ%LoIzMgdUQoMl znxgl$E8jdgF3yhm%wVx^BZJA6T}jK7nVP+e3(p-={W0D3C!^n9Pw&pofTu2^UiwX< zj$7L&%iNYy_XvvW7Rp)q!*9*X$IC+;1FKGo)qjk5DH$8GyiU0N&~K?UW+}NnLhJ2j z^pzThUpanhMcmA`!^!NqUs|?sXE_^w2@bB4;`>p~l=14!#xG1Np%20z1>Oz#K83MB zvc`3>=6oLY`$?r2mOq`su;|^MVMKw#GO!zSPA_sEp9zx{H{eA$LWRa*+@e`oETxn%Vc=}@+eBSP1o+42h=W3AbG zFP!-R9c4@q1wy~pcFDfhD4kINSXyeOL$)?j1N@}#L=ROv+D1dsNpX@Os+ zZTb{azH;fQL=Vf$_jt;M^|wXMRs0%aSfFPbKE>Mc{BrflpY>`PobJ%p`s+{TWNo-mnYi?sFMmcrKtM^`au?o>Z>IS92&4;$M;ZM7 zrPUl!c2sL&wNX|33g$Novl|w_71*-FR^q_UKkirZ&Zx~WlxmJEbiFISV`mxT>C0y} z|L*x#+QH(wmLodw6|c?0Yf;locHQo*F5=$3Bs<$NUR^jPq}?tXlH2 zqW%2h71=`5p0zG*UFEpu#8tB|xkXL;uP<7*ol{h+V%@{~_1?nA{OuOcy2fAH(=Ojs z^772qJu7d!oHZ8?4c=}jT-a%08qT+&4?7+`{`{Z8NaGsYp1EmzWlt-+sJQ{-f7D z;pftlE<5Xe`sWvQ{hVUYgpFax^raroXnhvKHpxC!Y`uT*eiz-9d7s`gy1W#=(Db(Y z$no13>n|+O+QlS$bj~imq#trjrpJ~Z-5Hmt`I3FP+9EHl&?!^xOkLHE?-BYP#OAZ> zs9buKXk-gh+_uR|<&0@ZmiHZ%lH^;n^}?CrUHqKl6H1b}_B=UVxca(U=q{6&iHyD% zT^_2MZA;FZ(y@=(Kxo&q6FPqD_I`0)wYrh%;9U-zt!|n1btkS@UA~y6aVKJ~gq8dj zlUn6g-7V3Q3vxeYaz3-(?!G{tyTZo(Nn~}YwoStOm1c=MwmsSL_W6&NV2jGbJl_gm z9PxTRQD=Ithn-?#lMVaKh{(C+&vat;CcNc&P^SFBn@7v)y2_4U@kN|Z^mwP9F?9{9 z5G{NwU!kcq-IOzEUHz?HwyK`V+dZ6=L0|p1Ekk zTrsJujc=W|oIE#Ipm`y4Xag%w6bJZkc`ZMji;x+`abiK z_OuNT1=zX@OkV_*Tw(H@=wixrjUzQU?3wueMDfLP3QtpBSRdWJjzf;A{%ez30OMKj z*y2m36Ea^OVBdb_)sOR!Y!WPs=RL}t#d+hc#?hJsGgJ0wI=krVX(+PWn99w{{FmCb zPvmkB!+zIaO=t7vlDNDX4D0T`(+}Gcc~bA%bCo@-Zf)1vs=*qcId$8ajJL(YPLiuT zBt18`FP3-LxY04stKD_l71>G8lc&^Q$vIvYHa$nK=*Y8uGdgTs=d`SMeiV2~&0?o( zxY4^Fxv+qD(f$UKLT~3y*xI<>Yvx)1)ECXl9NMS*-GwtIZMzzMdVbi~7_NwQi$V?A zCU)n3JzMf+fp{u=S*ZTbOO@xBs&orYGXJfVwW#Td)3o0CZVF$2y#C12uK(d7U%;cS z-|D?DE=-@HS#at@h_Z%8(Qb8J>nnWXEX${#(a2amy~p)aW>W;;8+N;ENxSc5rj)E< zIXwT+GnM0yroHSpxhS8ix{dS5)+pay+gI2wJHKQL``Pm$Ac-N*b zeNpEY+nc|A6&XI9W;(L;qU{agGY!8FyI!!nw=})+?G)kYJ+^HNJA=+&&VQ9Ye^F0X zk%ZTaGq>dYnk7^BH|FvrYi&6gEv~mRMYQy-h;%EzF3*u;uN)($Upo3N?1&A+zFD7G z`~_SUd8{|>S~EAbo~>)DOS!;_)kgBCI@9jCCYAA5u90K)dQt6V6*J* z81!VP^0O{?d;HKj?ciK1?$~{s)-Q;9&)b`qFx`o1ZGpk$trn*m!ks%>!dzB-{OS7X ziil+Fm-p(GQe|_$FVP584qw3@aVEYL5dF|%Z1uNMWB&66KGH%y-ac*I(ORU#t z`M{>toJ%uqMDusQx##qCgJg=GSKk8j6rWS)FTApDJaqZ*(q@ZUitqK;op)Lo9yfZaQ{$l&UE%Z?E^lwwwU4O=Fclz5*<;mZF@ntbut$q|N$kXAgw=8t2l@ODD zSY499Oo8>CN6tD3CERaiP`UnnFI(!J?U%ewx+S+a{AUPW$NjF5pTUv0{cE9ZmvTKT zbKs_kMAN%14H+v~+?9gLTF(nqoznZP{i0N&>-PLdi^X%juO@7Kf zhVPChY}1aOIaeST@TxiWcIUmHO05OD8b@~3GhJA>>zuCB&%V#*kAnU)y!*;&mhjD3 z>p{j&6Q8)uLv3!cs)BPH4*Fe};7crFYIwKNGIqx~4K~Z9Wgpd=BjEEQm%Y$y4k@l*{$K?U#_f6E?d0)%&ic+1I_QIpKv-Gd12}&g%es_ z%c|~(9%}4kiuaYfG>Ii*9eZHEZKooq)1S;KCEBwWhasd`!Cf z>AsJPmaJ%V-G}N4#w?-ljh8OY_fTL^lXMj@y!L5zDOdTPAL5KwV)MSfcs%(^MZ7`y zk~3Rm{-~aMow$9H)a%FfMISZ??X8&eOXQ!r(G;7z-oa6tcRM*QL|r^>xORqkfvRMo z_Vc31>G_LPCgi%Q&fK81vj66?+jCS|rr*|E=5>Sb?o;oIW(%i-%@L z;gX$U?h>xQrB88v;YR^p?T-sjdOcX-xZ+}!e^Pqm6Fs|)>r10rUp%NWF0L2-K1uE4 ztqg~wOI~lR<+c&5e*JI#mIWd5iA`>dr-QCG*cUVg`cRxv{Hk_%V$h~ph%$7>HtY7Uhi z`uB486?@&&9sJu?b|r=7aqavzp}DfMzJI0VmzNxW)1G$RynSpzqbKtQ1=GoE_U@X? z(X{r+oz$J3!QMSl(cNFP=fw%V&9>L1?0lr|2;a?_ zl~h0Vl*r;4B9EiYnICnDwi-^iIbyeSS6W*T+nb|Nh6fH!Iv)}gF!^arokZpuYnJ2u z?y;x#UA!iIO5B%O;D)Y`!pRxkgdOc^nW_O)xUn+FOMfJV^GF!ug^#%IOoLtgVY#TplmCYBr`^TgB zk6feQy1C*Xt?F|u!f!D=kbS(HU)JlY^P#|PyIqRk3G6T_Gq`qv?-W}^K>Ae1us><` zUpk(5oC)50=J2eqkpZW4SFSQwM#Va=_hIBm-=8e3-dA{B?!a>%r z?hKcn!`&O(ciY!%#!MHy(O$#zrFHF^%e@>MwsH#S#D@8B$9RBmO4 z>DldT*@Z6W+}wKDiM>m8!{0S;>k@m|r^SA?_1J%LLG}K&qQ$ouF4V^+uVg<`r&&E& z%-Hx^>TY@AMfuB=6f>@+R_(sWt}(|wMCQtIkr#!s0hKFLJ-_z!Z z<;(rcT9!?`@hURm=C%b~k0WPsDa(m@i+S($)|sHb<$LdvIlP-?!t_`c#rFQ3RoUk` zx97~Ma=(6uaKW$T2ES^$a!b$DuipJlZOcq?w`PS`)I(KL9v@gI(NOKlu-{43saKQfUF50y0C zR4(6nuTDKM`-rs1x8{tq0_zQY&G#(4VOZ0CWM@Xan#7#Ispf^8TB=P_>WxqXUn?n42_&Vu?gn_fIK67{Q0OWz&9%E;oJx2`>6 z)0>i|-}c>-?)2P` z_6O!aa4q-~7<)LOc2XF|MG9}$rWZvMnWVz*MW9A3y8XSw7c$XM5 zR$4aeX?&KcXZbSoXl%Es#e0RDaCzwhvNRl~rM9ch$hmTgY(vLPHE>2jt47q7o9(8#GHF& zC~{TGjh@yyIRyZOP4*Ow-QZL0B0-P6a!^w_j(sq7k?FY~U{|F*4>ex$v%PkMwcf=QyYs64Rral#^E0Z?#`)V_ z-gUY9I#~Jg$yIZo-9In8{LIh!hM&I8PiU`?kDnjg`^)BV@brtHE#{n!zw`eHgNh&n zBP#=1FVFd$`00%Zv@WMhSMn)zE`Qn5BF8rR_k|=-OEZSOr zfAHVsCdY)+Q`=786MSrEIdlHyLZM3Wo{gV2-Pmzjx6D5mx zH@YHr>pw$V(wTF{J!j6GiJUoePMQvgnmM!E*tSR|xz@9)WQu%T+53V@)2q(k&OEle z`OomfiHVPky#9tMwKE2__B<~yFR!@!*x1k2r!0FN?(g!y*%7dRrqAx z)BQKPFMGXuc(}g7D&xtViT9UIn{844%e))}{sjI?l#R8Xu&aDU(DDy*H*cqI-sa%> zuO&RTPTH^LZv20Sw7ZimxR+P8Y7`vpu<(_g@bB-xO#i8u4yV;E_#%Dq;p*j8ty<+Q zEn#I_Dq9Ki$U(po)p}D6&qMQG?Z+-veUp|it>injkekxSS zeDSA<^0X}*cZhKBuwlKt*J+}C)9i!J*Hq3=Z5OZjQ*knD&mXUi3Euagd=8qU{7G}^ zvC{@U^?VQX=Dr9BTE6g=fZx+);x)Nixv7OL8}6j~&u#SEo$%-S<0aCcwfFCQc;KTt zL~XG8!eigrv%P}UOnrXzGR+{@Q$pP_u4xHdHi`2 z8b6pB@=W|3EBr3>q*SbqneWWrl)9i*y#+PfW{_Llw4~&PTapf6=;Ij&*aMYq}M#N|C($>N%@G zE!V`oJ0g?>PstuoDEa4Uw{(5yna4(E3`cC+S$3sImRy|Mdti^x0ZHi_fr=&1CT4AP zzjW!vT)iy+{`#gayH@+_X?}u7f7a`k<(K`QX2tG)TgKvm6#EL-%aJupUKFP$KejZD z)Up)cxrig7vGri~m569!E!?(ANh}%puW=cw#;IXC1XR`k_mDd-(UiS;`ozBFcW7uHJ zF0}S8M}3=pZ-mN)K?e%FpwNz^A1;wMsEv}hl_1CS~GH0EjYjo&DpYQWl zF3FVIKhGj5@7J42k}kdFs{@oD_^w>*r`lKMt+Z77Vn9!LV94W_6IyCxUavm<@T1!U zFRe>!y3&~+L?q31RIAFq^CTc(hrHXe1??-e3RTTYo?Vz&ge+GvcbDB1-{%|GW`(3R^s}myR`uwc|e2Tej1dcTbd_A_3TlmLD=BT3q zH&aZyO=ixI-K%GF#;-hRixYckw(t(H&Y!VaZ65bF3Mz9vowUg(Qrhc$!15_K`!ZEa z-c={}?Tz|)UAIJSYFA$>$Lu7#b?53=+*_m7@M+|xe8~wK)7pRzd`FG2Kr<+&IkYbnquwki; znaA7NThrOxZ1)_I`R2=Q#~R5z>)`?ocIMea-kSCSGv;jz7F4iy-cr2#>`bZS=5v#8 z=hVlES#X?6Um7F(<*v((CmP*?r6s}>9;{CDGp{(q;QqL{xM9Y;j$)~M?#%Z*mz89> z3BI{%^Fwyues;kx-))$@!#t_$w3 zEVR|9p5th_7;y5Oz^qH2dVCyfABaugG56@6{1p%W%uBCgW&6>SVYs0!rN}+`^wUqA z)_>+XD@;1VyHHoH{(9H+hrR2{(kvLb?{GTzs_(E|?WIx6er9!E5pRxfhdIZGwqI`V zFaF}4fB9Fv|I5F+TW&9Uu}x=o-sU@k-;|9lilgqGx!>_s-g8zG&v}QruTK1Dkbf*v z&;H<#eDen>wf;w@y!Aq#>n7$z3U7=1`}OF|_9wRPhs6u0e%|@oR_a#$*ZaYr>H-BO zf2%uxEAQX?yT7B0zjoUt{Q0Z)^kMIM zS+^@Dz4FHr`ORZ1?wIxbp1aRpzWeB7-E;4?bGmc(+&;VE`YWBPW5)nz0^HfdTmerl8)OUfw^Lra{W*L+#|=&-u!vi{VA7A*#k?} zor2>|2i{Fx@O6pZo-6mx_|DuW^`GGbf6}t)4cei+cZ=8DEZ)Jzwec#?gSn3@?%sX( z?oNsRQr)C0@}fI*J}!+|_iRnzspHRYST~;O^5g0a`!d)6;KQ!vKb_`!AAB?`eM#3L zy9ovLb>LeWwFE)?Iart&SwWXegYQ;mWD-;qP*5@uGGtbEa100(PB2O=D1^4VnC%(< zGaOyv6aP}P|AUuu+>sNV)Bklw>7SU_QLiy57o%cY7YA-UveEnd4`F5H zA0AV@sv>_}X8!xnOwF~+UR7z!x%zp5Hud$#%dgy=^zdIJh@RZ`O7_K!`EPf;`!(CB z;Qm~RYn`3l-vYc(&_E78O`zCm}TJ&9f8son|#TO{ zS0!((cTwAx9wTXyfBMbwFs__OZO0#-p7rM0`6Uys%?bR@ZT1xuXjZ?8&e_UM+111}#=4|XQnVs`ti{~CbeHFWiW&ND-Hxr(2R_EIzzBY5- zDy_77?lkVIV0~|)t0LdD7uBoWcA5OevyRhstCG&XGonkymzAYF+;1)R=4--}uvfZ@ zDynZfwk+Rd=hG@M`Abbsz!&fHH-kT>uG^EDs;qi*?o5llKVLn)+C1%ciAl zx+|h(dy*xN-R)W1zv<|@s@diHzAQQ|+tDR(TQg(+=Eu_?w9c3MBiLWRR^MNxsA|hG z!=5ebKa^ZL_BZ|GG^|}$CGlP*BWj_p+_odSUB+Sh6O%(X351<+zvvTkS=l}+$avfK z)xUGTC|zS0cfQ*D;Ge>vCEtWMa6%Sfpd^;&m`w`07-j zJa4`7(Th>apNix+vqc_{k~}K^q<+%O-v10i@qaH)`(9+Xu=k(Oq%R(mR7_6Aa%N7t z_U3Dt|LXq??xv4lcx3tf@|+i>Wo2$wcdAfl%O)0Gnpj-*VAIVPOSd{kE3~S5>@>eTd48Vc<2Lo}%zLLq z)xX~>eCf6}tFff2%8EIa0oP{ePFKFz+o^4{)ceBmtCQ#F$xT&F%Fg!B6<^!G)Rn8{ z!h~+=2T_vV!`a1oOrt!a+$;8wDV=kZH{Z!-m`C@_2K0bSMd2=&greo-c zJ=ZJbEF~mtQ{VITKf^SU`rg`E%J+^%pI9h$um9ORrF^feH+#SC<$j+j_RY-jWtHmk zZksmSZ13YsgoZk{1M;SQ)M^j#lN?P z5!;_httJx%UnDAtPB^fPnu^I*)%t2(e)d;cYIz?Zab&0JJX_eUs;jG zn}cWH9=`#ut3aazER67-hYSo1kkJ8F0U-rp5d+Zx2R3jm#S9u9s6TIc!lrri{5Li= z8+SS$Jn)|(Mm@CF-NlJv%^#-|6&3Ym^~(e*W-Px}>+TeJ{OR0AKE8hwVtCX9Ty}n# zb$-dOqaEL68Tt6me?FA9RP>@APn?=LZ(;JQ(?Jo}47Z6DPo41KU(CKA#}CUtJm)l% zQ)#c*va_z!BA&PzJuTn)vL|=KgLg4Ii=LjIt_P;(+kvR_^X+OjLxt+0^a;uB2Lx|i zPUYt44))e7JNDz4VejWj?_xI3d2V^Gc+PW6^_;gb<~hg6a|h0ExTCAddumVLLlJg4 z%OCT>HKP_?c@;#dyf3_;eiu7u0d%p;M+jr2?VMgE06Sr6b>$5{%y|R~DEBLlkc?16u zt`8M^;uKkL$bRNLt21?J0%LN4WdhVC%DtcMdQ{#63gx0C@ zpEg_PmRdg(@7-{#_l;uaioDRbr#Me-N_#j@Suktm20y9YcBY{%Aqi%R*-u1Mt^2NA zee!;WZ$ypXidXFZtGVmFI8VKI+*)#lrO?Pu)y|m5xi)a;k5HlGFRVE3N^NOBx@y;k z;&Yw5=6~kg{PVU(MOjp*v}Ii6ja%e%wLm_ zFE7#h_LO&V$m}hP+&5j$bI)9V_JU8JO8vL&43}4LI<9p|Z4zC7IVx`E@(kV;zh+(k z^L2&c7Ez6f_OrhD32*t+ls#8ritp^hzSa|~7r44CxYL;><-6$A!W}y{Cf@16Bt*7$it$k2ns@nUeXv^X4GNqgg zAEipR+>c6RPg-A+Rj}sNrLU(B?cOrMJH9(9H{bu#m)TykD-H)`6eTb851SLJ*@-3jU1}~ddRKF!&Pq=SZF_wDWgC<4it`Th zQ(_la<$A@soLwfk&1+xVjV`tAT9yf0E?@l=G0T9#G2OQE{Hj}5X8vdJXFa2EPoXIX$iURA6)l0ZMZ1ZETiQ4+wDVS+}I@M*ieL;!Xe7^&xwXl~c+1mdaoMB{_13qpqLzhs)Q&z9toT!Bwq?3rnm5k} zGX^W(+dAcoH@r;W2vv& znJN3upqVQc<%;uJp7t&~uNTw&)Aq>}H^CptyoJ*xTSbHeUj#&+3yAp|Ywge@a_c?c zJc}jWdS*{F)FQse=1*f%?e9F%?)>tXyT6Hg@|tS3^PAL#uNO!h(s*NcF-PE4S!JTM z<;UsTMkYtJjjDVvNAj*n%{g1`b*$c?GbiBX+DodJk`f)ZCZ=6Edj6HD>)bB;husP7 zK^vl^%szI!IiBsY=7eiO*Y?8e-6wXuDN*)acfl_u)4zN>@9f~p9DDv37yV{u&f2$q z-4B_|ACB|cGW8d<$4p@tP@nhwFI%t5k`=y1!B=k_$lc{j_xkSY*rRKg>3JuQ#dPsX)yn9rOGNIsa6Mk!AJoJZlJrTGJG*I)?xghEo&GV6 zEbDf>cDgvn>Y!HRzFA9e{{5sP+%33&Md$)X!6N0WD_1k}ex8}qH<_PpW%bIqI3 z&C9L6p5?kBc3#sv+1NUyJ*qq0YR)9D*DXy&4Q)EfYqBnegkA~msz34OxZ9%*GqTR^ z6uL4?wmB)iV2#;k-Cixv(wWOkW^T;NPCOJA)pRF+v-Yg)89Z_tk7N(^M%|jU>7?1= z<2A|B?#AjY3+fZ6Np?n_ohEon;aZE+F@sJQF}4S}Hj}*sU6xsK?i8Ndr?@*YS%R_Y z+?CLoaen6|euSr<;5%EKBW>V$YRj2|dxs`IihA?Ix_AfI?}MDTFRgi|{Ndz{e5q}Z zUioi%Z$H8F@gyZN!=A*z{-8C_zGNRcbd~$9=CQZey~B1yIxmb=udjK^yh2E7?uMwy zO7{&+_S}oD8N+=h?S151xyJwLlezv%$q%}ev@pM)7+Y+S24scz=A)IBl0%Rcg*J9{fBWC)wm(?N*s$#$tcR zsQ8&m?Yx=X+=`1dw4KEak8JPAGkCz*FL8{iQe_IC)OE}A>sh9ryW_yQM10Q#tEBon z>5I!Y^`BsCDHHtlOlYP|Nb;gv%e006Eq}!u{FQC_ull9GeD+4IUz1(6_VSZ8zx6gh z`z+~mcIM{2r>1;cexlUtqif!j{Lhm%UMqOl>l*p<(4`B=F9SL)rkmh+0w=FFk^dh;3HGEM&Kb2p_+#qQqZyV~w-IrD|L zGedf;w`bd1aRj8Q9b(j0H9hjS{ah*k1*`e5>XyH%TX41BBVOEgW5PtvWp7P?xy6}@V?}RoZ*8e#>{%Yy7=utS8)IPxGnNU zm;5}F_s*Z||1(%#u~iN^c-Ss6b5^&h*{j|wvvb-nm(A3hsyF9{cbWCmb$yrfHXWaM zxtrI(q}eHOG%kP-m?$5p{ws+a>?~yCagVGk=K6Ie4&uh|! zNej6dHXW^gGev0W%5>k7S|$!9#v6+sc+cs(X3oK7a!auEbjllPuNf>)cAY(`C+T&} zaGPP@jN<~4CgqQIaQgK{h1F*zON6}H_*&)8VjJrgPMgMao(@x}3$@MWca(W1~Q+c@_XKTYfZA7Rh|57{uYFo6Iw@{kR)kb$9Npt6H-084_1 zQDR{uv^mUd&v5=%T+Qp>r=_I+Gk9kFR#ddFcm5$I@#jVSEwvWY7nAHxY|@D`G5y!< zH&aqDsp`^IL!%jw-~aySvdBwW>BOdMSM)DC3A8BY#fj(&v?y{o3AE_*>-J1>x0_eC zW0%bS?bV-(?*7>J>29+2@0vN=>uhIO=4~`lT)1%kTce`8KfWbA-K{PwFt3-F|F_JX zZHwE^$ZW6w7#%34Vy$BTdQ;J*Zw0qc*Ng7o;nT6AApCEhPk%n|p6w~e{@m+#`IX}p z@zKm*kL$KdsWN@2M)deY#F;ZBIs3?d#_G z-D(1BLe$RbpFGOF_w|WCX*H*uk}huyyBGbTXPSyjN6U+e4b_NI)XNF3eJgDs?}S*Mka2? z#{$<<$tt_YA7_5DmQ<ALy;@ckNAA+3DG`&L{xeKeJ1+5U z@rr+bi+-xLcPn4}&ma|_p1jt2#_oVAYkUJ*Cf-`JCHU%#?a5w3she+tlGbL`nI~p_ zEV#T+*%{JZjg)H5ytlzZSLU(%N7tM8CiNe9toQJ{gj9ufkIrMRxUVy<0IP91YE#@f!X%-z&37I%GfucRht*NKIS98MY=zZ}0J`lN^LL;qY$ zk@nQgjCZdhCQLTmzr$mFoaFN66^Y+PU(D$=pWJpvW?TG5-5Bq0>btkfo=>f?E;@0K zqr@sJ{Eh$Gc&68GmyMUP?w-({W)>M>=UN|Kke+UoMlZ*%=-mw6fYNdFYMW^%0a*r{qGCBxLk)m;-6N2Us8Fsq{UB6 zICgh){g$bB=krdOD8I=*CHY11fg2ZI-dG)GEpaS8M3MW;tuN;5YW_2@SnbvH+U&AR zu&`d|(8ZIHe~K3U6`rZ_`_kg{;!B-M@hP{ynZH?E?cH^K2WX&m#$^?ciE8#6cl_H{ z<9B?ubkf`M7cbpcOcIXJ?cORldy{4t(-gm(CU)1_#pl+)^JiJQr0;5U@lvzyw6e|p zuhWl5Ez{^L$Wo8|n)D`9ThCoqlTWU5o4IzUp}I@~i7Qy>AH#`fX1?^d7|9< z+HQr>A-Que-A_;VHJqek7J2mLv;uq1$!g_>lUzEdZGU#^`t!0H+ZF#j%O-kHygVoR zr`mBzlOy|2{Bu0MR8^?9f6rz$lY?n|I(xSn%{;d4!Qsm~59)-i(vSPphsB*vTDp0s z?Ao{6AEa@;x@oF5QSZ+Fi5mYIK0G-xVTp>H+>ObH?LWCrs8=ua$hF;e>S9Ih9R5S; zK0h`tbGdd(KljPoYk$J}Zr&_PPpyB`6;f_?JW3;BN}GwNP)Fj8B<=@ zXK&tGAFL3+@Z@dHY5Tn=-#z-Hc)kD1wvwkW=bFBqE0H=^uIs?B%{iy5Y-e7U7MM2o z&D$4`Z<@TB({BCFI`r?4{N(kQYR^o#wxzI6=B3N;A9E{e=B9rtRe!s2e^r!rUdhtc zlBshoQl}S2ecQwRWBPQS<1bbknyBeY%LspX9(OWg`L?Sf_1~WR*q#;st$S~aSK;zU zImwf^m93RHX1jgwwXZ_wpOmz-`>Z|JmR$8MJ+0*X^W>CHrFO-QN=jV^9vo5Ra8hy! z%9K6fecR4kT9I`U=Y&Np9D+(t-8!|JHznQvd0&zZ?O$lOyJxScxatd!?$C!jX5O4@ z`{T{RO+Ncm!Vk(X(&ef@(z5lp^+o9LnuWF1h0w|C{vEwBW$%Pe)&C43rN8=bTeX}N zk~qn~TgNHNeEr9hw-rV2&GXpTo`2&0qM-DHy?=b(oSXM2vvajl$3k6+@5fX;I-CSr zTqmS(OicHAY2Uo;grU64M2%ivo@C9e>x);a`u6*$_E(9WdHMdZTD_OcMU@rRD|x*p zoD{O^dF3B?1O>(7&b)kI zv&8&Omr}+t?o6bWCv#rvX}XHV`$O)k3=i!@vUMRX;VQcg}%@tJ9q z(x#;Uq+7?Q`{Kg28HMRLmaHjLb91edi7QW78##BTK~YrVo9!MuZaej_)hN3pvvu>+ zF1u}I2{}3S3ofddXo_v=7XD(9wk^klvpaxl(fieP3GWMC3xWEN!ne}rKj0|O%~BO@aN0x&YOu(C0+ zb1*V8FfpUbFoC4l1sE8anHgEwSlQXRSXsbon3x4wSQQN&h1dcU3nvP*H*Qoi5^)MD zQZ_abU3f4lxHv?tzG>1X=VTR^5>t*vs-b4$A1*#jX?Fd1s6|bXk%5Vck%ftgi5X-g z0|NsilOQvTqM;D0k+7pkppvq&Xd+u-qm%RhTMRtRj0{YI%z_N|3}3=?wN)&|-+4{d z;!|N4V(w%-(#XZg^ihOe(4kOM@ZDP7cQX%LGaox*v~u?Jr}aJ4BhDU@{u}+3eWTM& zccVLpGD`(hO&;eh-S)zH_JwYjHEWE2u1Rh`?0;OkepTHmjj4NPy@{W(&0I!j zZ{oHYFZ@pi?1@~tZTI$_J)SIUr!EhOS`>EjohqA$Z-7!mC}U8=N{5gIS^=UOTvJ%R zn3kdl)MJQX6<}y^>349bVq(6~7{I~8#K_R#pdbKZFey2)2H0Hgu$Xj-<5lFs)fKNa zy5RDx3eJp9F}uw6E?v)f;GKr{x(#8Mssn|2W_On<1*mL274`dVz3}nRZC8b69-eku z_)Fo#^0Q@EC0ru)PW}2VuQBOVvEZFsSC_gRR*775)?# z(9bz#o6Q``Lqe)Vd~~KP(B)F;Xn;8k?n3;GdWbg|8eE$g9r@=b?b*A%uypU?S!M;3 z1GX-o+;(=y&Pd0zl^pv%3(RbOYMym6_M>j~M>TP=nzKDS7xT;$-X*{2=F*3&bA!1p zp7cIiQ&DioX0{7HU6z?R4|4&6t&+9T#F&B}G9!&LW*&k)>QEvF*OcVU&^&Of@+`zP%&d96}nz5ic``_!=c+}2Hz zi){k@o(b-d6^nX59p-oS2cQ^cW;L}Z5t9{uu-(s5Pl4a5HH~l!<()O5KxbSM3 z)#778+96X|SVJCgK|IG*zTlb1;t4@+?R;A~Pwjfl&b{h|TvEB)6R&*{@89~W^&d$; zpOsK_+);6D#>36UQxY?#uCt!8dB!6f&NCbTt$ntuRO8UajO;?Y`o!etcA~#!vkmWW z(Kz%mBP(I&_MHi}dwM4>ul5bmDG+FIX>ouA6(ppH3Sd#MgG_U~me^(gn9|0@jsL2kz^FS9Vdz1VN{mc2f-ev`dU@v`KNCfEDy6ffNsDVd~p!SSIK z+o_1UocX_3*JdBP|72bAEzWA@85e`Tz0z21GUeH(jZaQzo2R{7r`%(^jIDi=U1-%c z?zgi})y+D++Q)bC&Rg%U_USghEj}%k=`OHr&dwHpDcMB7%$tAObf@n-y5muUO}OK( z)oGT!(e)oDZJcwxQsw)!>tT7tZ&DskbIVc8y*!!M`r|Tji9grO6%PE)Jl59Q?!+H; zW9_4;&z>#6`ev=184{wDq68@i1Pz?Dnsm>ZU3+{lRrd4jMO-g8nqT{BVBszCQ~ll| zj%8t!4;pjJUU(Ym;}tvg@89m0Y2mC>ekxpDWpGj~tNvqM(%uEGQ`-MCd~x5r)9GW{ ze)*}#QH>kgc9rvvh^SDiVSoQuwS2Q(`V!$**{#$R|i#LXPq0IS^ZON_ko@Pp}@VyRfk3Z(@vmcI#pm9x`!+PWjhONE(J zD;~@}T)o&NO8V_=<4Zf5EB3H_+jG2l%Dgx;@1qY*a<3-McKQ+i>5h5)(Mau;^+_eU z36s_rEKu5|ofEZ9UCsY-`lijsx4HtjcWLo*oqlQ{%#=$?65>POwoiXYl! zI{Auu6)jsM{^-b}{|o}Dxtqc(Zrr={I@2Rx;L6tg7f+v_zkTG$mOcCD`eTT%Iws)JFy`J?wTHBDtjY)!og-N2GV?vv2$b%EB5>BqneKnYr;L7i-Q9 zvn#vqIUWA&x6n;^il*<=?VF2vBX_xFi6nGeZJm9%V%oWMXN7BPP5yMYK6-1XJ-;Zd zam@*X7#Fh>_bXW4{MC+&pP5lJnQ{A$jJh9pG8|og>bfodyz-F80uELSrUcH0Ej}up zEi4Cw8R`Qd0%{C1{Fo9B1T-w+Y)}&tVKitASkB<1qG2HNkkJ67(1$tXfG~p(h$F)2 z$1sB_fs3IbNK|-|;)K;r64L{Ad|UT!-Fe&HPrSGSR{QOknw+|-zp#JH4v}eUyVuQH zBmOAtY;Vl#(BSe@WV zSzNgzyDIGU91(?9wxHXyJ{djHOGw=u&%@Hyyz*Lyo^J8CB7vLPJnc_*C~V5U@iEN8 zqNGLkqM(X{CdU%3l}&*>OxGqlX;}$4?Kl#7D(m7y>*wb6E&^)DpX9!ZaQX0F`o+rD zP2DmdKThIa`&8EM&JtH0MAzR*6! zTIOq?^1ILFicc9nU$g!yT(0<(<)2mk@qdf*p4cqBUHMq7?6`LQr1mMIe?E3HtxZ{H z%ebP_asA^v_3t*zJI%0JP%rnm|3~KTDf3)qzW4sUmG_i=!au8H|K6GxHJ_-LeOzBQ zdndore+Jp)%x}VF1q+|NDL$q(wOBPjJK&Sz^D_e9yN`eJlJlE=K4zb5O*sFPDTk6m z)$i47Z(qH+arYB3&m@+M4!*03dc^(xy^>TqrW?7+G;~VI@jd5SBW>|@+PQtMs}^@@ zterdUgOoCp(*w3sA6TF4UAJQ08Rsj%?ryHF4a&Lm{Fc*qshww7kFQy0^QGj$r!~3_ z^QScKUbgt!dM+QMkDvZo{rj$H^YG}Smj^DqW6-_0>8!n>k@Q!G-1T;6G@ z6j!ZYl;YX1T`zvi_-Mw9TQh}qKbIN3`267H=lDe_hl*pab8TtjciQG7YLu`_u%V4< zPNR`<`i;vG-CtN< zHAh)tyH@?dd0!4rkFkuZz3_b*&raUc^FO%nHAuOAcV^yccDX|{j2<69TYq`}Jz=)k zPGgqZgLhvUr1VZU@U`bJ__B<1a^uhZJ2AGJE#lo;^#`r@8dyw<+0DUp@Z9>iBZrEf z+(~o1Ecf`O5A&nq_%F}Pm$B>bI?Fqw{`&W2JUhfI&;LsPeVNVsW95DrWAlH8*KxL* z&FU;SXVo73`?BT9qMYOJ^xkte>+RU|pJAs>Rq&CM+@G2MaQ82@@tJKNIk#ErKf`nN z&Pg?H*>$FWAKLizcbxvua5?^-@R5^s%KHBqeCsRxg;mTY3s)T5w|Ak9Pk-l``uE4} z_h=rR_|Y=|SN8AAY$-Ki5%s^We_!#@$1}Eks&wHc^^WI{i=sb%YWe8q{qg%_|HDsL zRm{{sdT;l=4bykp1oi7hA5yV8R`rGB)jY**&mI+AJD2wD*bE>4unli*S8rVX=*jz^ zqA5v5fd&DcTmhmvGXnfFe;j;K`L7|)`}Ti^`i-ylhX0!MHsf~0cD7^pgC5?J?XXy} zGo*3Xjxctw!v(OEnDy=SbtKktf|*iLKf#;-+Oe=aX{ z)Lvii;Q(rLHAZDT2=IP7|I2p4rRkIQzUYj)vS`r?CQn2!FF@3E71L6t>`RSV0s4Xt zEt48G8XOj^RGKWoM7bHwbEHdBSmpSz)1n!09Gc2 z5GEA`7ghoG5LPD1qA07~O|6Tn7RfH(TKcsnX77Eat0_sWP8Z&|di=P%w2Z}b*UFO$ zvzQhIa&dQEH?ews@4}wt+xtJ+`mdb-an3BKJN6xS7l}>S5!RlnCHU3w>(+fsT{peu zX{$cy;~rFBty#$2t~?{*=0}^@hgI^?@)r+3ubH-b!SfR?EJp6t%Qq}Jb>YZE2l4I8 zzwEbKCafuWF`D7>#!JUIUadO5=|6iD6Q?f!lD)o2nUg{GArFg#v=e8|#&x>)w@<#-F?Fk8BnJy>7lPH2DTQ-_ zn!`+{lzJ%5IY9%|ns!N0g7+Ai7#SJ`E9R|8zo)!l-M0PRGj~7H+#1_?C+EW6dk?Oy z*dpXUQ-;65W#>jHi`w&h=y zKk13i-SVUViu)J$m4Rxq%E$c7!f)0aiVI$A^83>Fa^9()1ZC~%);(vI7k#nY{oqmY zK5x?t#fP*6l=ogQ6Y(*O$ln+DSO45y}dJ`2#Ud@2ovLmK_Mo`V=+&(Jo1u zv-R_D9e-q!&z-jWQPi|YXVjvLU01JAXEWZn+P2JPLv+lcbK0jpk6%4;y?JMxn&>Of zjoZ%uI(AKSTf4zUms3VN4|p4YG}sj`DOb^0d3#|{%NK{d^|BeNMcaP`_y1=|ijU%M z>hcuez&$De?f;_m>X?)+-hF;8EpL+V{W1ah@1s@L_ zeABpP>b&b+$5MT4HvMOqUA%qr^leX$){6@oZrxR_o*K?yzP;-<_Ytefb1G-t{$sI| zam#{9^DZ6z&yZ@-`kz59B|rb;&rJRJN8SP-etZjIyS94z=_luIr@pieKUkYrv9osh zGSPE0$|gU!#__M?t5%zg{j-U6C+}?$I=1f1l5)2y?KL+p7FIpna(+D|c0cd)>|XFZ zrCvcm`S0Z$ovVdgO!w~l6+bsjY)a4byUKsJ)NO6gF@9n5zT(?D+r_JQ`u8Y5(L1|z zeb=>$e*J8zi+gtZ@kn(mU1IM$?)3IS?~6Gq$90OT`}l07FLPS3&DCObyk*6=D(N!E ztV6oj%uYSpQ`lQ}Au!I|$KbYa>fCclOEzx#_;zV=z3l=Gey`itPo54=7gJn$><<6o zwLk72`6$2b@r~_DAN5MV`i1S#{%!VHA#rj*?B=wq^%lt=HeET(eopGmRlmT;dNZ9K zJjfDRsy>yskmWzaH`T9;#J*k?nY0L$o1p!6ApwqtMnP2NCe$qT&fWg$ zxS3nu&Cj+yU3(I)_Dj1jO}Tt>Yq0P{>vt)t)5ZB`nBIHcsqDIY|Ba}R%<}|a#+?2- zXR&ho(l9NTt$&*C|4fVFpBw)p^j?4c)jv|v0rl;(tQ1VYXziXbHzzw^@Gsl1X_k(Y z|E&~w(fLA^aoy~!sqb2In;YkS`QqpPg!@9(`{vGbKh@TC&l6x}*Z(eiBhWOdAnIOx zt^T=1VpH~a`?LV9x69++CByz_Y==tcjTkzo;J&y?$OCn6+V~xlrKoH3|o`%@l*El!%1(~E;#OR z?Z@Q#JbT{qN{3y)+xq%or`N9Ik99U0aV*H^Np3Q5t6zHDHR6f4&aYQHj}<*#VzyRz zvd-~a#eJ_{yH2tcI-VaXQCOJ!!T6Y?-u4L> zZM#-D$I3vYF@jDG76+G!ObZ0zVk|B#vVj6F3LV>+riglocri7Ak^vJVLw$oods3%w z^}hPDtaFFtTQiqlS+rfK=Hh3k2e}t@q_=)GI=y14Zl8L)<-f;{S6bIwJzZ-uwf*SP zbiwVd53d{XuPr~zUgR4ruy*d{=>_f!ZyyUy5_+V4L0jfPCwthtslseR&dm+FRw5nF ziBB)8@oe^6ySn5p*QPIV>mOWkT_*aVK1cARE8nfqmGa!;7xGscOjh~NaQ5a^?*6Bt z6AkzMcwFy*YI|aR5x!f~!%EGw6&*iLA z?dq3iO;pdn{r6bij`M4IcDJxQ3s^NAeC5m$nVqpm?3A=8%ft))OD5=kjHsTo^!bs) z`pvAn?_ArHt6sI)Zr0aRzv9Asro|XNJ@!bzJ2rUxlEqaCN6!UWT2^t-Tq2r!IeF6T zAF(Tg(!xLAak-%~x1V*7%7)%&vozy!+O1P|91=feSHHpdh^*qll&khP*PdGAx6}N@ z`^QgT+}(TG<5AVCU0de$E1q2Ax=TNF)>3Hp?U>NSmTjEf*`}GN6>ZXF_Mz)l$TQ`g zQD-KkJt%g*E!|z#w839#!&#YZ;g2W&GX(v6@^_Z{*L7@VydUj%+NZU@x_k2cZT?sH z?@Zpe{B^{Y`a9Qqo5Z~hsv{1DTWohV+_z$$?XT zRElyj!Acbk7p=w5a$Nc*ZajG`xiI;KnZWAYt!)ukGp&DI?f2e2`R%IvzU`08q))dm zbiW-^Tl`1(Xvouf!-}a3KQ)$1&xxs+<6Gq!DD|j%)0;J^3D?~Fx91+N z`}Z-z?b+6Z+sE3hv)Tn>b|pT#a`o8KyV;Ys$EmK~v?J>Fy{!jKZ&@$Rj*>{#ZZf)c zIq%X+jT0FR^#M7-LT!gnH-D{6ymmfl>F&MqtACgV)-Um}-#jt&c6rjHsDnG)&Iir( zo-Y6Mg8YrTQl{eCkN+9gzLdSF)#HCF#s2L6E8+{j-sdd%d0(~benyLmlFZ3(`EN94 zBw5zKH^1-wdDWq7zGrGL+220?I-<Gw=7YDR4XnXj=pCmZhU|2*ux{2OP%l2NT70~7-+r5iX|@h&kMDlx=f4$w_EVGnO5W?PjUZ-E%no)x!6E8_GW3S$sapZWVv$@wsoAH~Qb) zC?Cq>Tb+7T#_SLOjwv6GX_)6~)xDk2anUpIGwYVHn>CEd&T&8IA9=WC?(5>#eb@G> zt~`4&V!8W5L8sjxZywxUFlhmD)w-5{!s*mh?}yd=%d^6w!&cAln-Si5uD;aVx+p4S zmP+y_L91km%iZOUG536puHO#b?0IYFk8Ce*{iWF!Z0Dx-CHAxA{yDhCN09gZ)PAF= zr*j^^E!?zsO2oP^cAFpEaL8_-@}D7HsXa^f@i+dP##a`dEON9w__;YiW|JI+~um;J5sze!t^5{{)S7IxP}Mmrxi$$waI=h@da6Hc#B zlk2W;K54Gm-Sl&Di_fiTU*CIMh3ucAF1Gc+)b#i6yQm8OrG-06&z#=5ugdAu z@0lO`cciYFmXq>bx1fhX`^|c9Kbyo;+wQH(lUO$Y(AMrF)xA;&w7tHp?YQV;@ORqD z-M2H>&evV~M9K1pOq7+YnC-6YhZmZ%MYQd>(ibEDSdd8HRqE5CxPX9 zN9=v?ZN2%(qF!cOZ=T7C#sE+oy<d&^mL598-k&nLag(0aSH{6|fd--?-;`FnnzdaZamJYt#YXVXbX-cP%gQNHHu z#dQ&Or*|EHq_ghd#W%@}GNH?k=3iSc*$~k8xh^Q4$}6j+}4JZq4}5FlG5E$<@mY zKEKO2dc*z9O!3D_x?AfX$uT#W+*n!B+19Ter*d`a@lFACck`R2C0F!97oORxs$e1e zT4ci+&k)7^pBBF{W?pCfQ;c`+-Tw^HA99uCKV`1`tQuOj@Se>p_HR00H8urBf4{tJ zpWIdXhR?MRp~du>#MSQ){C)Xv!Cv-tKP+nAPs+NV(ZZw@bMl-2uXA=)is;M*nWG4Z|Eb$AnQ`K_LKcuu{~?wY;}hl*`( zO4l2_omo|5cH8UN2ZPrS_uq?~{Py35M}9`%&V@eXi}fJr-y399ZFL?PPbnEhCkxCnl&P9Ki7r)wH;76s#y9s;# zGw2mpl$g4Io&2ZsKSSQpFa2xFD*Ec#H5W#&b<*H!0JU#~T$mQ zCE?Yx!ZK#INroMqxZ~I!@l$zgQ2;8|8<_**B7sEK6`sdRKe9r0oqt@G#3@xVpDqC zKkHGvp}u#x9z$>0yU^}a1*UY&1?89W*CyS%@p#Jb;}>7W zbeB)h+PknmcHXYst#gdzGw%z^^CV}Q26J}2I#?W+ZLRzH!OrBj30F4G>Qh)G$a_%{A zpRitZQcduGhL6`xUEg+>7xHG@<=W!1F+N5pa%Z>5@9LVXd+M7`_#Ap}A;rM&bv7d7 z+>Fjz-ps<>;!Kur=lGi3m?dRJ!gp7PI9?44Xmq=(8Q#D8nRo4>>U8F75n zxP3`$$DF*$`i}M6V;)J!v`C(r7WP>0MyLK9JEPAlv&%%U|9*J(FYmN@XXmafAegI!U@B^`tKeI6Kr@t6=sNMciTU1*Pm$r#Ov&5 zZGL^LXBU@k=Xub1ytuD5$9Kx9{laG@c1JX;@lA?Q%*?*K_xACsbp`zvo}YfJ*A~w! zF}Ckglzy6E?Jjs@XZ^lIH`kc`F#fxA@v~%~XDlVB)mLT})Ze)E?2q*PzfE6C-+bQw zF4X9l2rPV=Snh;)UHEx&&vi-l&i?d>tHrv;>)giFnbn2rEtXE3Due`OG zEwTP&(Z)|t=3EXuC~+|}uW#k5UpFjoWX@t+x{1N+)UiD$PYWJa=e&4GETl^4h+O{t z{|tY!n!G(ObzOZI8QS&z{eOnDp0B{e1MTO2s;~Xl=cJ(UD1YPR7gL31Bw3cf7vJyw zd4*S9`d=%*MfanQZr_~jQa^32j9=wqwk5yB)solj4t-NDefr%gGoIPUMZ&)GmKe%U zVY{@}?b_VR@XFOEE7#1kJCsw+a=mPlM~XtgjJq2&_BiKh8gxGGz2+=<`g@t>oZ{x( zr)%_eFW>&p@YGjRXugi^@##PL1#}g6?%tmKeC8r24iOor)mbLavo}w*e9?Zke$VFI z&Mjq0$8WaXXpeE+v1yBn#=gGp%qPzZwX(C1r4)(%xSe>=^!zqXY2}v@uh;Iby|FIp z_I|ycRo@Ojc=zz*m*3&pt8Vn_#qJC?IvJgKyK&ca_P__nY_iR--%GUWce-|SUE*QT9?v+dE8pZ?D{ZVP)>Nyx?AsW^uD=-*uQAJ*8L6nKhZO`BiBwe0Axm2iLyN zaoTx3vfeto(`WLGMwtMcnrFRRU&m@bIdXmX@lQL-uWsJ%_DX#3oz2I-7usH1S3LJ} zz|Psr&D(0j{%x9mV*a-$ve|o&RsIY5o97+=K{OzQ2~tX{H2-IaJtekAqwt7K!E2#k zr#@TP-_-Y9{*d3cdD5F@E#4~UeqDMl|6K36&}OTLhw7icJ$6!j&*~(d$J@l$=L8CU z+n(|0MdVtEgx;HB2TxttCy-jbqy69Opx@!$CN@)ByAID_nYj1dAAx1c(^Ac-S?DF2 z(RTD%QDD8xj8>Z^t!r<)dM@$0xb4F0#s{VkCS2ao8hMqw_L}zc-Pz7Jtq3R-(==m*=f`5PJclfj^GOb&Gna($OhbI)(@ z{|ujts+zvU?SAmEc%SF%%0&VkGYidcoc!Xyk|U|I{O$X?`OgD2ea}iIr@hTzqhnod zoKw~uI?m?food9RE2`c*TUr(Sf~ zoGAC};&w6N+gljo-T9Z?b*ew<`Rd@d-sL)7h^GINq@yHWJu$Cz?0v0RNV!vD12tGM1d#{OrDZ_N*=YHdaf1xFBIF zHDT+c8zt&4XA&3Xo2K06ezcqM!`{B^`*M8@y)o8e5%+nmKfL8RGi^i4yR~WC=heI4 zx_SGD!MVq8ZG?lo*4;j``D4k$!}lj13qSVnV}|YXnq_@cSG-KjE8FwHMx4sFkyF%5%eaErn*6G}C7EHtovVZsP8)e4{RkZSN$*^_eTGo!gh_{-}%= z^#Tvx_^4=d?sZwNbuQ(kOr2I{O4yd`2=wCK#7Let7O9hFblUQR!;Tbg}q z5xdO$^4&+Ot~1x=>o54A?JII*+l+f|n{tHe6g}6a=kNc_c0V=D^kJO4R{Ew{->0ox zJO6Nc(d`b#hY!mxz6_Zgbo1)D{!_cYT~|*Q@3&pu6Uwl6S7YqcYJ56h7nr<&?c@GyY9DyM4OxglJ})H9V=Fs<#+?!``hc@2xj@USwfh{gm-zJo{fC zr^NW0EHT?TKW4r=9v_*~U9oPdjh#xs$<1xfhhIl5FNw7O{Fd9M%v`tshG+c zj84#Uf{_8-nya^SH~)D3R%U)iu+Yuz<-WTc{;Vond1{B(hU9#8p5z1hr|X`z3TvJG z(|UFH9EGMPjuQ6ga#NH9n^!Nq5tKc{)T}SI~muSJl}+MgnjP_-d4V^{_SV)bQQ7p3sc^*gs)lib!OYtKdGs?s`K|8|7f2s zc=gJcHPyOCXIE`)FN$^I=TuuQ7cH34!hL58lcaKs_?d5(3-Yc6x(Q}>dLD^3x-Fi~ zEF*KxsHJzR)zr)>**&U#d_pJLg=H*aF7FZX6Zw&yv)btUj_!z>3}vQAOn%39JJmDo zEj_a#J|}p$f9@&E-P4_gGu`;RaV_tgMK@QsrhA=g<=|jpn!z+>a>B|$j>_vZr&nsObKPch z<%aQ*X@;MA+U7pY%-fTG^!9_yIj;BCpSGFWSTCWSFLiLu?s<3HD*5+$w`O@A_cd&H zu2;L9^L(*(`Gjda`3BLEVUKD8OUj=7S@c#jbmi_i)#-6Jr`@0O;o8TdyZuL^w#1y~ zjxRo9(OKNKYwfL9Jtq0vijK!VbpPm>N6+plt*VoIbDe9>H{0*qjEux*ymR*GbKKVTW!{GM*8S$4GxB$G znIAtb)>C}=&at-rFH6_EA8$XqvvkI^&h%-^3rtOujDseR1Do;k3Y=hm*En*S%F$`|U0J$9wrjSMMyUw`6{M(q#2El}my7 zp}Y3C9Xj>z+&4kfC2OZC?_CZuA=CHfF>n(xA%X~b#fos^GM_8ZP7{<&&mfS>%U$9Mq$sk3Euey2Y%c$Wzm~rVcxe=)k~qi zOCSU`ISsCwlh)U4c)D_4#e)2>F2xthox)dx3!m)cO7=L)d4n;i^O2M7`AO3XZqCm3 zJT0&I>-hVJ0mt*C+Mb^{eeC+d-8VNzDfU$qt)G7KTyp1<|IN?gSb%uqqrXeyFL7nx^(^oC?bH7AIH=$Ep8+%*rmolQqU59& z-P3;xW#;cS+%1v zY~r$`v#c#{>zhv5UNlYbpS|S7*_r-(eQmw|GsFe@g{*#Ov&+Oz^yKo`tVN|}+Go-& zCr{Pe@Z-MxqX?ivuB+vSSNq@^R)&S%IM@AF<4zxTa%blRQMS+h2B8a%0Nx~0!_ z@98qJ2IWU`7Z`KgwHL=#9Mjd^!*=4QT){jC>;G15_PJ!Wukldo+szUuHi?~k)E5|hTeDd=b`%a%Ze7zve^paB0g83r9 z&F)!cK5Tu?jR)+gjKC3sbRlBcqd1*ylnU=rY#UFMrD(BCNSzUkT znf9N`zGv@lO^mTJ^m^?WwAX#*lc>#x>Ed%&8P2G$yjOkdUgZIs*?(fr=34Byb?MoK zuD9I#<6KjZZ?S9m&yXAWd-lD6UB_aDQjYmBOTDjfdwXlm)on3nzaE{pXVb&AifHAB zsdnSU!&S+PuZ7)ci=R_@s4lid@F2sqM}f!P^Rm{Q6U^<3<~J(Ze!c1DjQ3(m=j(+g z&UztQbG3KF)WT;b*UAo6uSvP+=4;V+>RQ*o2<6h?4R#5SK1YT;js{aNx`=V)EAt#|LXs^!j3#3_V?%h7O$G}kgZ5hzP{P{%cFl2ypD&aSy>&cUFQ7f_W3`G z<$voB9(i6fdAj2wK}B|9DQESIc1wH=ZFa8NzPw!id7$Q$c}Y`TTlY+OldT=^b$H|S z@Urt$9%WnR9hy~mM6Q17s%Q6i-+1vdB1+KJ?Suo9nm)n6wr z;1e%fv#}!cZT+K4wf_u4pIvevv>0rWJ84eDDly5vKS3Wq+IL-?ceqMROf%h@xJKjV>){InUSf} z53AQo?U>U)`C6f})Q9~uKOUUJ7P#bN!J*HaJ8~nEZloSM-ZpnHm)JR{9+fGZK`kExn=iS z9^)&Y3dpG@|ANhxYr-G zuKh9ZR_O3?W;b|lf!yWz2b$IO6RN3FActJw|U=k z)>E=wI@NgTJhiOLN6hx@xuf$smZu%RZPvG% z=eTXpI&I#1(Iq)KGu==5cU-7jC2P9gBj#6S<@fB0Be&V#R3@FeFK{mTXq4Htmsd-l z2=)nTOJ$Tq->Qt*-?PQirf##gMOt6QOcSf48hn{=Z`pG1j!u)=eN1*`vX+8^MuSU= zk`uI-A>6pgeedmUtQBv*hQ9f9-&F2uoM{>Hn$CKJ4Urz{Yvan%S>A60RE?9r#&y`A>b8`|gKlUqx*75Bs-d zzg7J;L;I)kuOlpNi!MAnUpz0UD=KyFWo29M?(MtoZT_3vr~K}`^o~>4H?L=l{m)Re z{mgsc|JM=wKK|o$ z{<)w0V%a7*C_Jj)F!{y&Aho?W`l7$Tud?{hVAUCQ@v8QW++}+Y-M!^->F4sE4+gp4 zO11fp#Ts7S`ShE_2Z?9a_i}ejJ-iU5v2(Ze-nPzv8|FQAJ0d6)Sii1=Pmi~3Rl}}b zUtX>05e_v>ndG+f;+_o`k1pZ*a?z+WSIQaJ@0rQnR4-XmXg?Gr-jKoZp}+N z!nplNrR^MTyZ*`Uvp-a66xv1w=3AUGs|!1Q=JVf#rF(RG%xhy;MrK`j>e!mr;Brt< z*;Rw1X$32n%GoDw-jR#`rsQSRzg@KUx0y+_(7DQ74T;sOjp}yYdw3^#YoVpQ`s#w@W8yZ_|<9+j2a8O@F%S`W{=$ANS&qKR$X{_pv|&H$%qi z)f@C`cYd3heg8(z{8Ou9Ql^K_djD|EjfY?<{TXS2Wl6F1hZOr~Saitm|FcCdZwBczwQM={LptZiav7Twm4J-PhXjXH`?Uzq@jA-r{xj4?}EHb=PONMm%`-r8%JEpqK6irG*R)4zs&Dqj)|1 zh1*_Dt=gNKy!gD$(QKuY+}mHd?)WgH$}#G9#Cnc-VNUv$tKNQB>3_#psBrnhVsH0y z*Y7i~2^>5jcFFXe>SdFH$+55P{++RUrWA2rKO*wnwsm@Z-&959U9+<1zj>KC=Tv?E z9J9O~ryt44A3mJ-!96rg&gIK=>-j%zpO!Fj=d9+`vs141?ygP?ey#o|H%vyJ$#1!6 z*SkHQ)9de?mH(Swb!F)__xDD8v&(-?LeXky?A%B5~5) zi?_sciu?Ef6w^MO-0QbD%v|DT!F9JoQ9nf0ZaME=@+L~Ubg#X1j*qo%l@9MEB`*QD zQ=Tdjw`VHX)no$)yW^ukFlSorx`sch2`_-nw?`#iE|#!EWRw(sev|1f>JbwS>$f|IdfQ-aUr zmhWWl&vG%k-kWKvZg9`!x7bwKm5=tnys`FtN{p5Q&nvAO|4SPz&rE;S=r8hb>KwVG zliU59`CgcY&eDw&UA)@3|FnP0v+H;6I3;e__kDIO^R969smq0@SGPxYCBBr?*3+G9 zy1DuA4Ie#eZC|k#=j!^SPbB{{nCv_}?Y$kpcFIBPRmnS;-Hmo}t@(O++Ov7;b4s%R z?D?#Aepbu0W#+E++!gaQ7jnz4Y_q+UHsN;m=BjlPMyt*~fAev}&UH%O?Ivx9Ox1Q} zE!uYEY36nFb#mc}$$VDTuU8&OUiZ|9t@r93k+*lv=eU^dkg;F2dFnbbo!#~C-5eYa zilj|DGdXWJuh@J3cFR{6zun&RNNIoj^v_Rru1kB)X}DqM+7o}Gb8oKS6qD(&-R!uJ z#jKLExlevgy)(Q2_@@-VT^;TdHf_o8*R~6uaY4rV+SV;Dhi%LKCrkF9JYB1&b}d8h zc7WlD-#p7=_Jv3GS{L?K?W%gbkXzd6 zKf{!=D$~dvzu!hDT7Qc^%)jEN)i>^Yp~vnT9&R{vZQi1bPP=cde=1pVug3qze6whI zfhCi-gxB9(U~08y+ndW>J}X-v>o3@`qv2znX4P#8t3@55{~4wh{wzDa@xaBaC9bw} zd!r>k|tL<)_)RPf4XXV)_ zo0UfkzF1dAn($1W_hcwBenZSpzN#|yS&@FX?ls@V&9z> zymejcjOA|A!~~`ug9J4J5k~MZO-jMO#0N&cnX~*`XS_`<$<^)|o%`r6dUvll)+ ztNLa1XGvi}KYxp?Xuj#xwNHsyPu>@mE|%G|B<+DMg68U?}5+^oXxqGc{Yo|-oDD4QEUBt7Ztaw&o{I@?D;h2zF_i{8E=eC!Z)t&tvIs&wX)Q$ zHTE}7e(5@19xHqQyR-di>uXEXE9Lj@um8sXRa4-}qjH^yw)Z6t-`F)eUak4&eZ*?r ziTc?U{~22JonJrxWl{6u-)Yu8mpE8>@6_Ildh@{4u2pE(%0Jtl%)ayH@_Fl6J_GOY zlN3T0)l2fEMsXox`dF#@uhc_;sIC)BNi;mG9MXLot%(D+Y40z~d zH6h&WxMFTt)DDU4H(TCuEa@mLI&C@a>z!Psd2$yzUOjoVE=eW&T(snk%R9xIzgawU zRGj5}+`84`*96~7s}c=*dnP5Hm$<2@9FE4 ztKHcua%}T1<{hyN?OV^bZ%571wd!tMfQN$1Zw>`#Oe~#y~Cfr`7CcbpT(&Nu8o2R9GQ0ciFd2P{D z6YkF4{ibhjbf?z6p6B~K>}Yn?wOy~1BmT<9HEcL`I&|~usaDs2*o7T>aLdi==08nje_ti&zbJlN) z`u=vF^V@QrD-Um-U2!`~{Z`Q(o+;jCpKY20_;-h1xOkxB-Szu#)T*4GOt4+NIQiSI z6?emfk7+%B{^?Vm^VV+NXJ+Bb7D|`a?`V6#)v+vl#ielRyc;L8_8$5@^OL0YX&Kck zJ-MrAM?UZQ{dBQIb*S#{#k?i|8PY3H+^o;ZSs!tK^%lK8H^#*gA6-|Ao!O?lUSRv7 zVwWAS#Ul2x$GBan<15SJ_FLSU_xiR(W_-v~=joH4Wh`q7K0f8NhmFVW^(>BAZ}&x8 zt!zKDv%*f^a6&^)*RwFb15a0$dxtFS-SzIqN?EH-w~YCNJ}r8#T-m&P%e0qgHgB8V zX3=)nss8=1pJ(N&XCM7^bJ{m)>4*;Agt7%!Z@prVdJ(l(I8Mjmz^j4_T?LyTz3Y&- z*xy=UUOMf()JCC8!ofE-9$qWkv5a9U(~6mTZAu;~>LqD;iOD+}(U)`1YFyn=ak63fN?3HdiDeCimjs`db#2+s$JmQ-3aSyEX0c z!;&D2%(s)H^uDjW{+ECK$(bi^g#9{pN%9HrJZF`U(?i6}3tz>xDf(aThzpy=+k0`Z zLr$dhM4vK^>sh)&%g)CJY!aJ0Yp2URAGHF@2d^g0|ADof*sO)QB%(<}b%cb~J z@}jwac9d(mgPqpwm+YHw8Uc0y2;a{o6o(p^Z1!paVBN?wfgpyJk{RBWpgvP z&)W7rweQr-yu3WlkMHg)=;2ppL*{#|DJxTyeKzO1;D3f!`>!o2om?pH zr~H-wtBRy~4&&3)4&`iuf1VoNnRoQir1**d87%%Yyl8!4TYvEI^FPzND;F~|crY!w zz`N9CMnr;T-DC5@AfAe6zdz;Zzv9}gJ2$F+^WB$aW@g*W&TQM-A1GEUD*U;f?i6Os1LL5!ri18{1y;L_K`!GU?Tyx2tW8kEnmzqIli>`jnNA z1Ptb1kh-s12_TROgFYZ4#zR&VGJMX^S&#Nrv z$^21IgG0`2+ZlIimg&*WcU!h?+1syMUYzFAn;8N&QmY5=RWOy z;vGBtPHXmShss(nED4jV?{+sb4>!~l;Z}?Mcs2fvu@w)WTiEZnjepcHYH&-I2T3Cq01OA^5pg#j-~q4Q_fr-uW!MJ)=IYY>V`Z z#oDg%y2Z)|pXscgmBoAKiv6jOE!#>D?ao?kCfEPuN&m-B7q8z~k~TMc=j*k9W&VEr zJ8#~>BMvWb?b`O{pjnGtSUq3lw{>=Rw-~eaKCp^f$9Ln%`s3?TSKq(2G4awL@uDdy zT?}T++@ngui(33c%RJWzM&5M0cv$y}PjWrGLut&$cQ3=XtL<1^KmEkPu46Ix?pT;k zJEJ1JVS??%dpiyNZ71^ioPYW-X6~%i$LnsFypvga|3oge+VpBq zVs7r&o2y^Gd~@4y!tqcY{DY;}^@npqg*~UH_ZH-A+P{0JPnL3LX7P`@ zpshdBL!(TWf7SWouaz{-CNFUFmg5RL#^G^0J%%wm23o|9$v4sBO|IbL;w#yfa_gs;)j#R{2)ilK-pGx=#1sg5CS}KX~|g zpSS70OD9y*YI(&-Q~VEuM({@+f1`hU(U@<*xI<^z(E-w zk!+{qy0@;gPtg(JFuGHJzfe!`!)G4dM}6!Z?-%Ev>O6k$@ z^2(uL)tYOn8CwopPknNH>$@Gt>>H1VJC(^DZTmI*mSu6=n{)5YqAa|Zl<$--n{qJQ#o4vt>9_jZ>`yn< zXI-1_c04E9ZSU*sSeZJ1rSv6Yw<^2WzE3G{`_p@}Y`+>uqsg0#xh^KV_gtT2wC?2n znE0H&$Zo}7JeNP~T*=8^ZQ{%LSL$L~o9lZW=ZB9Z9+}QOH{si)rCDn;*6a-6a#+BX zsG?yp?U_Wfk=I9Q>D6# z=JI>yOy>Bn{Vlo5#bJAQ>iW5=U9@oC^y&Oe$t0EB&q_N!)>I^AEXZW{`X#n?d+PJ- z*JY(MLmm5{TXU| zC$2QIsQ%;b?9DOfe4pm*k>qn@`&;7tn&GGKe};#t*VF4S{;m%Dy5#(mKSA3flBdqv z+Tgb&5;1 z9o{{C_B|-+(#`Yk7ruQySj?@qZGtyTbC>y+=4DU&6f-KW*BckhTNM3gF!sBC=KF@- zeFmlJj5oxNnjSe^9=2lE)0Z++&zyheBXPn`{Gf7NQgw`GRL#OG8{=kV=d4rtZeDEL zuAlgP=Z*A_&U8Q9+^=i)CaG`AII?kvZJ%iN>=nvI&;4txO6MGE@_Bm1=4f^9 z!AC}B8(bxP#*5E;dhc2p z^e3PB7<1q~-!mZ|KdFqnN2~AN(K=F+m2uzT#;4XF`;MP2_~^ad@3FPjHr50C_E=Zt z&xjN4oVH>oXHVE9yWJ&nQ{o~^Ba#cP3SGT#E4R#V*=(-k zdaTP=if9RN@SajN_^6($JL{3wt2axiA}ExIssn)AG!t77;KZhCV|D^3#Mcwla~+TKXlT}C(gO^l2z&z1OO z_vB?Td|BInHTko1`W*3q8?Gtewry;CWgf8dZ{(@X8=i5Wxih7A$JBM{+|P=;V=`CX z+Z9vgo4D}AlBjU~&&sCKEUg=-&2112+V)vDev#bVr}u=d&(wd|^jlYO>qZmZv;})u z<-Eh)!#74pAI#-eXl$~Wp>eHumd5EcW%dvi1pyA_`!|nPr<*QW%h#7CW+8u~vn`xC zxl(lUKHevBk$a98a&NP0_dn6}@3^_h5$B@I`9&tWWern=-s|YRPcppgaxVS&Z=uuC+ubK;ScV(-8I;P{#&)O2 zP1mkhOJAZ_lxxY^rlnLP;Jj{$th{MX;&Nl1>oXfzn^L%%ofr{jgMfvM|mR=!VuQTk@h8TZI^op(>?oXjj0UNm=VviDJG z1@<7Zr+Po{Yd7YZ{djrf?hFBM+u8e9+o>df@q4;+UEJ^g4AIa2&RVV+A|*PXKVbPY zzTo;J>B&p)luY4IOMCHP%l5+T{6k5X&L@AY`FyIcc%yjJyMs;3IQtI1jFPsP;eWGj z@syp5^z!%4I<4LQ;rV8fns>R;N4Dn9GBf>@rp&wf%^qv>gQ(OfE^@oNLQ1jiot(T|COOfwDvXVo z?YOD;*Yi#5+wds5wtn-Rbp~^ePd&JURw^Kb>{z^EbbT%WQJunEk(=um8T6v1G@; zW#8XDfB(&NeOey(n%#Q(YPE0r#n)u3vHMD|6_57+w?FcybN7jF!gVbS3>GDE-JM64 z&H8b~^7@vOj*D(=53}1av*m=f{LJ33OT^oo5_iZREv)>dWY|$^5xrb^+NZ6T*A_05 zt$NJ0=FgNSi`R>LJ>CRtS<$p)RJI?C#_Cy{H`zT<${Kaac3r~Hv@0U;h zeWd;z*Uomaix=K zlp*dwJ=>DLRq8$S0`i5Q@#*uLx!vq|LdILwolfK9PBaZSJ}|^IQ&J|Fg3Glian)1!tbkc$_Q0JwNAD z?cyC1*3Jy)U$C%ALNO;`gS#}V)UhrGCWS|vRKPpGG&JTOPCU~yfltE7ckwQpus82r z*5ns%D{uI5=G(SHUJi}c%&li1mu{Q<=DO=q)YyIsHFsbf*$*-FLPhZY|a zpSxK*=bO>5?A_eEg;>75*PSr`>h7$45(S&LY|GtaqY(N$e0QbR%G1oxQXHObD3)ED z^Pucv>h-(x{mZ!RxA7g?7Hza(H_NS4Rt~aH1$o!-K5SBZ$CJT)L1a^X$fK#CU9HUF z;)0Hnlbqd{oqe}jYfS3&c-kGQ_vzBJcM{RP8#*>=%+rWfyY#kdy8XnR0-HCVh`Dnh zFZJZnJoU;S6|c0U%ouiFo;hc^dajXpL7ML3Nq@Ibo9?i2k9D-tI^k(k8l&>1$~BB0 zJt{kxuXFCkG0VFL{n+Z|%?)F2)w>q_o{?mH_2P!N4_^kiIB$zfeN$w%=vTzE&AaWS zW6myoo}l??`}~L3Eg$RU>m=v4`2Kj|X=tCokjrhVdi2}AU9(H0ZoF<&;=b|DXxgSp zESpR(+;RULclFZcoIUp!T+bDqb^ck{mgouJC)z6X=`!p*_b}tiyrnS@l8P;7_bk~Q zU4Pr=Xu9NYhm5#qbGv1KZCibOwp(2LsY$ovZ@3q>8y>HSxE6PFPutG(X>&qj&i?vz zu;SO-)}tp*9F(40tRq&iC1me;mS0Sl*UJ@c-Tr*@xytM6ttTetCQGNzu&~OReQe40 zgsgj47fG7F+I#Z!%^zH37 zaWP1F`}B!fSkRqQ87HEnN+xggaXB+>PPo3oyz1_zl!?b56$y!3%w1$qrgxv;Pw~*x zH=m|F+hV$~_ky_td(f-E#i}o?j~$(qq`p&D#!lm&W3i)h;=Qf;hp*=!*0mIC*WK2V zlQ)+;t~S=_ix_#Zok{YcXZ?W>#zF{ZF_nzdH15~@4742X5U=<)c8*G;-dM= z5?Xz)9l2(Pr5^dX%R}y%l-<qb7g;bb<^G-cU;$A&3eAM@%WdS3*(~G zPsMeIZjK0lem{DdadC8%PR^=>TUh%}`50e{*>L}!&DQ6gj|^PPOf&Lt)*EWw_Mhl` zoAa8b^{K1Bm-c^owPx4;?DdClsAjY-UB@uL;!Sw(rT$AR56<7sP;kD$n$v$@$o%;5 zz|W?iRWg3;UKCdmp;hW}U+X;6`p{38{xc|7H_Y6?DXU+?Os_1A@eMBVA^RR8c#|10midd{z*@i#ZtGaT)I6@5o^acH2;Y>|YI&A+C7 z*Zj4r|K{fP2R}Y`i+Z9fvy& zZhUjAzrR{Ke*c#hGu?P)RF`i*#G$$=JFaOdfApu|)73FYKO1e&)!VrF;e+hG*Y~I> z#e10cCPy7(xMmW#R*FF^%(5hq#q^=cmCJrtd=!(6*nV9&_3*H=+>0mqj+u)%Pc$?* zD6D>_ZK+pyzQn#_n^FbG&$HL&P4V(G`aAtvz?}`jM{?_BtYpkugf2483KVj>P}Wc# z$TeFba{h_qyWHG0zAA;ioWj!B{Mk*|$M(dH)9r4LuY6lG>-XkY?>?{j&5@(NXkpH_ zDdH{_CNGQKE1jg%x(pXDTq{2@auU;&sZLBPosDweBvm?>86Np@PwraD#iW}?YqrL0 zuICFDR9(~i;aR>+alQMMx2=WW!iul5t^E+Q*d|PDXLml+b4hg(|6J!3hL>?uH?G@y zIPSA$R7~`vck9>Q?%kRb5VhyjPv*?@5U8i(W)vC(rZkKbt*YzoDwoVg! z_U_hwxqF5zk1|tOrZwHo5VO9fSX*qYxjo$AAkTK;9cCK0QmW5A*!t<_Hk)+YdG7P~ zG(A@D+<)wlbS_JO?crM%6^FM^-G6LmK&bgx zU3U5V=Gj!geS72i-osrF-%1&o_Fb<}y(&4)?Zln~oH9E9*6xi}O`3UTuej92$DD<} zCjO7R+}%EIe51P5<%stF*64HIrdN*~nYnCIP+fH=mmyE+*R7pqz9q}%auwWNHe;dO zqszxGdoEfsao)CfVQu@heWKQ;nf;yq-Ap_t?(6Eq=U*~AZ4P|C?fS9H9Ct3JPdZ%@ z(NkStF;COv@zVV&I$Lgv?nzy}Yx84+V}bt}`p(L%(W#wNCw+T|eXaPSi<`{c-MPNb zIv?^^Gj8IdyV)ngP8ou#y+D9(*|+k5Mkp5K3lLa%T6FTZZvbf>+REXRB~eW&igHN zZ~Y4Qou6Jkop*KZb-^3VzplmFeKR!Fsjl_y{ZzX2ZST~3Rv#Eu*PhJI{Oq@yb^Eoy zv#VA#jkMn$$4wGdMtKe zdBL`PW46nthwgcwjhENYYnpVzyIOkDjA{C(x9=0HewSSx@?&Q7r)7rQxA*RwIR9?K zZ=<^4Ut#Cw=9O!gsU^PJv-^^jK`pIc531YmL(1LsOj?8I~~#UC?^O za6eX{XV3Oo^V8Xl;*Q;nvgnS{s%pA=yJy!P|E>+)nH)B`w~ubG6_eTa=|TO?==oF3 z7`HFDYSb=tcWvFPYjAIiZ{D*vkL5nNY&p>+ z7$W#?li0SkZ0Q$|C!0_4+WS*y>B+TI>Sc6p9{D1(NiXB0*2^Rv>u49z8_S;*uszfM zZWir+D(<*(wng8+FH+kq*CoeX4%@-RALt^=_{uT(U9rWolet^}c~8_%ad4dY*-B3@ z(x}%*T+sfXmd>o-o3q}1_Df>8)nr!q@VMdH@u_isE+5O$Gz_3D{b z%a$*CvCFb8!m_4aeE8anaV=Z7%q@>~k~e-v{j&aj^3h2z-F5!b$+x23^&Qo0-Dh_1 z7n_yz$~{S!Bku2;n`N}|X3pAWie)X7plSKoH<+xrQ7yD-2_K1@^sb}-e z0&B5rb2og9Ss%Eo>{?OPsXNgT(YODtY@D0D-t)z`J6S$1si8ABPs@?Z``UVizfXbv zEc>lh7jAD}UG9^1rhffqFY~($Y~S+2mpqf}?w7xMB0Pupp|GuD_NhHP<$^xFsy=-& zKbeu&V0)y@;|nXZAD(*pS#9p@({W)>C2p`({9MO>e!_*R-QSdCW*4tFI%jt7(&ag+ zo3?H%ox8PZ6=}Nxhu6ncX_}pi= zlN2`^$_eXO7@aoR9-M7^c#r39uWxpn`%OAepZ%;WHm}t>-0RZiLo(OQ^$Uyjysf6$ zt+dP+y%H*P@{xIASfgT!gTq>rf=jD5bDc4>i+J>A;Zc9!ga8)-P~Jy5;rcN{3Lt&&NR(WYPTxqs{|fC!f-ii)$3(}r|v$C zS>#{ev{B%WNz{}N5UX(k2hbt2!yLu4YxqVj+W*t8J`KHhA&*mFvR=ic5-Z-Jzi%YLu zeez?y^Zf1N9aHt(Zp+sndc9kn-T3L&d)KR;pI1v?y*931#wAhkhK}^#i#BnS*2>Iu z`IvaQz+!IGtF+bbs`6{>+t+;CuBh-f__xO2%3?jvhQgliIoAX}S!HBxdi}&%_De}^ z^XbjU3!9Fgm0T^KE6Dy+LHE`fZ>OtA)`U)-(4i>m7=FgU>$O|V(Qn)Og|^MkFl+HT zbnoeO0e73UwG+bTZK!YJi&r<1F}s%YQ9t$KT4^c1PtCJ+OmYflz4`HdcFf}qa!bUT z8UnZ&FD!80d*<<5Mq$5eyBA1JIoX*~Tv=oKuynPaJooy2D>uoPcf1fjS92sG!P%cZ{2$^1Z$Iv_sgeq?Y`1zjZUn3O9y^))j`ir8HcsjH zj2r*1_OI(#O|`Q(IJ^2;w|36M4{Pc_s_snRadFq`*_-`)9vTYUibuRFd%C7~|B=Xh zW*#T6d?{O7ck<(mm+C6d`C=OXiERI9`rMD}cc`_AkD5}dwCXuAvqCesqbdjHF*-Or zvKC$4Cj0xbPwL#0Pl|S`S$+?au2y6En0NL;$=X?&fA%al{?Cwb=B)PJ{8MGVn+_fh z`%pi7Qu>6FD=)TM+N&@Aa$D_J(lv)?*84k7-%h?!JG*T5?8a-g7dC&`dcNF0=isDY zp~sUQ3*W7JUnlix!_(7dzNc->nQ!j?7_VV(a<#zh_L^;5PM}vu(C@nLmGbc$SQvj9q)Wz`gn{meUURpS?cER{P1i&}C79 z>lB~wxoNolIrr?j3zEAdtWxY=#O9g&XNbs(+kbQV*;w|2y+;hL-Io`b^?c!_lWzs8 zwRXqI>EF!Q9XxgaF|`#X_xD$Q3%vP!i4sSrQp2hfTufieTBP^u-l%7o`=4RW&PutZ zpZ_yt{ySa&>FdAUk9q68??~O+)xf*;Vv*6SFQy---JTzKb)(CfwNJwfVjQ&_l8$RrvcGVzX*7>e(%U85 zH1Z#8Bm!7My!|$9T`#N~qi>m(&r~4wW*Xx?UIK*BV zvE#m4eBy^tKf7INU+x6|Q#Jl~XB~)!H(;dYxs#YlBx@A%A9%)>k{ z%J|ThvXbPRS7rZfoSSw->fNE0HrmGZ*Kb_@*^+56vu%FXg4V}18WdYx<5_qfehKfh6sNGdy@ zP&Mt0cb@8%JAO@W%!_BaiZ0Z(6U&zt&Q|=s$Kd+6UeW2RlJuf7LzozuLIt!0Ub)+@ z&7SwZuvf2qanhRlb5;u{J$rq6@~Q6;uN5DsYU|Qv`)uBSh%x`L<>LK`Rb09M8AQCF?Xn1)S92{oa!J=U#UmDp+k5yH zTw^_V^Y5Bp^VvhPuC@vDmVR8f`=m`!_RcvB)-E~U-ItbGM12hXcVc^l*S^V3ryf4` za(jPj`#Y~&-#*Sb=l#)fVeX7%yE%>Zl{e4ai;l|HS8r^c;C6X?i+I^wuUDD| zlgk_KZ4ys!UzZ!v*7y5pvCiK0(vO5a*KB6^seQ@q=v&*g`MedC|Kjdz%f(t`p77*a zpj6N3#c*rMiHVOa?tHJA;B`DZ(NHqiaPn@+(-prBQgSBkTzJedyzpG@T&w9#&;B#y zUTa@*ar@yIuhaUSv!~~(o_+G}UH)60*zr%$ogFV(HW;euk$a-_%cdmAh#EDq)$`T5tc%+SqsY zqHo2^w0z0dE6hPz7Sn3W4yo6iK4WAy?b)Mur=DGKwcR{dyyGmtz>SP;N|8x7!ylzg zDvxkhTr=U$&h_gqDT}f!+4@uXZ|Wv%uO&M+Eqd0gvZ?%~MS1J$Q-92V2ww~Qnfy2C z`L~>}t3K}Yx$~c)XDu|F+w~`Y6ykb)XwCAc zC%^Y+b-4a+2~iN>;F{v#QYxyE=E(5YbBWi-O&6ZGlrXKfT3B&EeO~2J6~B$gBLeuP zl9d~zXNk@G6FSXOys~`Sp5OIP_uF&NQ~r^9c}L!(pQ?S;TX=rn@ z<5beyP1C}8CS7`A-gw}RdeP}N*A?%BSRAYc(kibV@MK+j*^@8zh|jFqkBe8lS`=>f z-M9S6WVeHP@5FZGJjl+P871K}_w#4*PcbL_4<4z=U34e&Q`eQf%k`#9yT|NcnSW;M zn^!Igt0qknayz>!QJ7mUXpflXN?nZ_wq&Mfk^-@T*CGdS+`_1y;^W#$-ed6!-5owjz@t`{%v zt>;e6Keg%Ftyj!{eU|hs+nqGy-5$Ntg{!76yzIGDqf?VGk0A6lx?}5Xlk7M3Yfn0#ocCngu6Y@06-Ji5 zg}l0TTeH^Mmbj+d-jy@wk9}?YGurq}&tjdAfj5rI?%7d)&EvQa`&Nw!HCtE4@h;b? z|E#aSV9$m#|5Q&}+&(?MQJs6HapMJnaP3;Py)wDGmTj9cHC^ZNdbVQC%2NN9u5zCG z`FbuDvt?5YKkE5ANblA9wd>~Ib6c*5E?V=A?UDMu zCl9hMc=xP*lzvu4?|r>oOn+eZ5C2)EziT{NSN!%~q@3_dJ?r$o8}0eK=NskO$qRQM zHQGA$;Q8feJAy-xU6kCj%O>O1VR6HA-~5&*y}Ww+x~$BETCGoe9HVz{4gV0m`Qo0P zTR(ghig~|t+TslvJ8O2Qo_OjPRlV|NZm!9@3ogf{zFu}+E_!Cm+M7@Ay!EUvG&5Ts zsh{U_&VKQh_2I9!mK9ZQ|F>ynDd#s==?#2m#n)f;ac;~!DHai;#44h)LjL&U_eJ7P zmrg009^PiSXv=GDvAY{R&a4+bot*pRyXk3(>YlFNa?egUp}ekq_))c zJ1*?PF%K^>t`(d1pCMhW$JuPJ#k6(DC)HbSyY91Q( z*Ps9Ouzt!@%}>`R9iP0@oL9MX0;5|YZ>g)SfOx0 z#6;Uxx?beXk%adD3|}T4G5v6Q>A!+STW9^5cj=}^yQcfu_|%m8t;(Nt{k+Q?@A-T> zT>q@R-f`a6IQz1^@`KUuQ{(O~f81)zW&d~We}<2_rdM-APwy|C#?s$Yeo^bv>djl0 zDE&RLG@!vjNku_0r{$E9=%xv))#Box-DEfH&h9%Q=UqRwervJi+@;wz`)7Pudm{Sd z_O~}T`%l`rC(ga!({JsJsrMB=uQx85#`*D&W9{tNM>WPL6$<8Fjg5HXvR%0(_3QI# z_Y#sUZ%^0#RA$s{m>_Ntek=J{+rsp=BYsh*T9Xn&lz8q%9WTvQ;TPo>k##S0*%&S^ z9&yfR_trxFoqfq7%j@fz@4heBy1iL#$C=g1DY?BpJ=e^(hy_=?jQM@$>5GzUhJ4$! zQYWlZDJompaQ1TQhubD@lW$vibN;e+Uz)OX!@*ti0>0G5xk>-25igw8Da9#$aM^;j zzx)!Pf4hDx#y$xH#O~=nrhVF^XttqzbC&Jo@v~FQq*p%(bW1wEliV{ zxu1(UUfVNYh4=e=wUqdiY)j*&re2qv-uq+eyCuGQ%#My1wkb&$vPu%a>a&b=`Ku%Nu#-=b39g z`am>veLT`{Zdqrhii1Qj=qJXL^k{r|7yP zi|wsvR%|(9I4?VSZEX9--48N%ZQVWXD3|eLa%=5#qOy(|MXb`TeIWtr0ca@ zN=p0x+SXq_oh_W(ykX1KPi$f{mp90#Ft3fhvSUuKYUA}7r~Qg&%5L<`Sy%I)LA;WM{o&*KjBhp0*ESVpX1gRB@7nTS zZ{xg_qiO~B(l)-`xv_S4VoGwj+xsc+y^b$$t@_W9W4iXOlKPS@hXtRu)iz~&A5JWI z|LWw!g|@48E+y_=ez*R~k$Hi4_s7%)Nq3z4^e{ALm(||AsgYAY?Vpva`*iLi^G#~v zmUrU1RL;Ad`EBL@bo2r8=mpSo{9BsX{%Qjz9V(q zL#x8+)4$VGpXRuyd;6`iTmH%W>~DWVgZ`;+1X9;#=q-@`&)}hFa%7vqmsMI{-4wK4 zTHan!3wVC0_ju>qOzTx_ol_R2EvUJ%dc_RxdEev&uZeIJeipNnb_>~YS|*pjhsoDr zsmPOx>z2jFmfc3LPb?}4aFlH9Eo<3PFT2`STIyzBOs384NhTL3Y?`|?>TF%e)`QMd zmOg9z8dks6Zt2RC`5)@lDwF>@efVN#cKvc_oPAkb{=x9HZzpH>w_LIM`QY1D`@hTT zFWr`XowqJ@`KmI3{|vRVttwWvk8e%r{>~K&KVH9b{p@Xb%p-Q+pWwVeeS7GcXZ6>Y zthJq?8_wD(teNq9HK*>4ikOFQ=55`$JWW?JYTB!XPx@+~?bqAr z?b09bqhT{=A6Ag&2sGHM&ZD#AWWjZHSwl6!`rvHM7e7~fr>d!5fAsG3)~3XLu8e$F z6#{%LH}SL+)%Mql)!W3)7v^40 zi#dC%CfsH}%f#dvFI`nQ=~5}Lb0L_woU zfZ8++F*|?Apg0 z`(8Jhd;gtbTJU9U=96Pmcd{z(>sjgx_CEdXxnX8_zZ84L$2&)ptYNqt#!>$}S# z%fi{-#%Cp7pE=qS@x~-5*46gQ^tA9d*&a(x12^Y5mtW2KaQr`m)@gsWpIvF~zBUD2 zZ*DnV-u9!~cHgs&5_ubc)Fo{>csFU@e}*->4}Tncc~tV&g)MJu_H29mFW6}7=6M(A ziA-lW&b!99>)QRyN6fbhWmS{w*X^8{xb5V@+dXT)eDJ#MT_-LkaD2bRy{((q_uKhY zCamANTwQd-kz0Egd7Lz#?)%fvmbL81p1NK?cP-6}t}?ordZyKPSI;Rmjm@p8C@?R2 zo3zi(?a=pG=9Q7lHujhKW=d0u)DTPyhUDk_RrBh@#}=#y;-`ueoJXu@w=YAF@2W!v|nNo&w@gKEsZ?4 z=U~RWkiBM;t~nn%Yb8?}Q8{PT-{97*ul}7EQjuCOo9(;Y=%w>*`&)K#&(5Fqc&l9a zA^+`?zO;8XcJ&wRCpw+q;dWpZ_>8s=DY0p13#*ed3U6g-1qt)d)=$e;-#7ILo4d`D zZ|ymeFK%6HJT+Z#vvPfL!Gq)H4)(`|Fz*1KPH6qmVgj$NK~a9yG9K40Tt3(opmcjj(AefKcWcD(}j zeDPCSU+2F&x_Q~M&mX;I>vrTuPk6HI;iql9dlQY#qn0d|4O72oyOMKHDOU)zNKtHP zlh|*zwq?$mn-1R|?C3pfyGwNCsr6r{Zk$n>aQ)WZot3xUB$|%j$?&s?WjNS^uzaf@&2iAig}}coaB=|y?Xsbp}Wie>{Xs0oFh-?sp~JSwElbIXZac5-bpckSTDD2^xm|0RjSdAn9AnUynU7r zPaOE+X{Wz+g{+rR$CTMS4ELPv5{f)?vgFbB9f|C%_gbT0pD{Ce`*E6?xljG|efJ*j zF*lee$?j|3x^#2Q;qA*yqWD4+(`PCMvG~QD4s%w%y~XgH?1IqHn3dAgyH&fo9DKrc zbrf=nSNsy#oVn%5R!fu4b#Z6&zZt$;EFJhFR-G?-wd^zdSv6ZvN=(0V|IU`X76k|M zIP~N7sRAE`-1-7My z-?Qb;+Sv9syXD~2`6&|u-Y?p8A^zARDT(`WM_CRpd!~E$Q_Q^!fqZRY*GsFrW*EG9 zs=%~I&#uKF=jkG~-rgr)0*w-SPsW~9j+Wh-t^IcAU0Kfw*RoY@_io8;ejhHxk$c`z zOD(Y8xLsy0OVhn?pCWCdXLq-oUXs6Xq4CO&J8O5gT5qWdwR&UCbZO=(HLH@~#I}H-||EIYk2F`9rC6XN$Fa*2I-LxlMcFvvH!`a+RCf*U; zULSd9WyEZWEvwFK-@fl=!S;sVYuRrp=4U><{b`R}*QNSPvQdm>->rjoS^e0^tyy{B z;5AQha?7Rc=@Pfx9`4P3byZlm_P5fM>2tO&+$w!;$(MOsuPjwkd{&-2`<(Z>r_*!} za`-0ho_h57E2UB?bBorlq_nUp#~RG|1a~e@+TyfXZ|brWMISC*irt*Fbdj3Xrl8A0 zZ_l1|@7u9w=Z;CYzGZY>mfDwc=hBRu$9Kq{nqj1}Gnrxe7QX{lS4w$itW&kSy+f*; zHDm9@4r|#xK2j#am)1+Km!DE`h~FUED#!LrVXp@tL;j+z+ixXHDsA|jCtM$u|03dA z^?!!nHczW}pR1j3k*suDHt$=f-(i(m47MD0=L33J8Jrn;SPYyu?cVxTMUa1*UatDC z6LFGr|6YkX6)AE5?cCK#6K*fD-nzZxiQbP}yvz)*WW91OJ^AkUBf4-o!`r~=rjgUO zcUkJpyVkb*sM5aHwRu601lpA)l$PahI;-s9bI%R!r8`LXUi zTbt$l^(vEYe!FgT+oSeStbDZB=h=yVY5m-+jjI&}cxB&n^*&5lcd~VLW~=Xi2HnT& zUU^%@l(%kQKi%MboSW#hIdfh||9IXPb?k7^<*hmX<_4#2<{Y%#|IyJTDB8-8Z9_Z5 zWB(ItkKPxavwm^vPat-H^Dj?21p_uTK5_m^|3T$sBwJGkWb64T_o z)OT~HpBB5bv#ITv;@9@uGY?n4*flHDqO{`65&f{T6Bk7l8Q!@}*tp~slS+X>PR2Wj zEwWq=ZnIY{5D{7SMRcavbQ3)x>_516N9W@Sa?3?;uPKRA znBRQx*Gc<1o1G%|Rd#NCTKJ)T=h+;;3GGs^N}{C{Pd&fCM>E{@`6AytdyeO-G-pS7 zg!))+NpH^;b~{xlcX`ze-@erv0ui6S@&2r@>0JCnX)EJ-mJp#bT|2k);_j`-KEGQ2 z{LI#~&r%*gE%sez?{@5<+w|5`x3{I<+N!j7=BBLd%WJK~)|`ttq~v?Y&(pN365+JnwZg$6aOu(|A%ac<#i!(AK3yxHov`WT-PzLCvzk776>56F zm2-YFFTVcC9}$Z)D!w@)Y@V&06R&*lbX*+J)6_XhoMCCuq6>n0slU~~n*5r?ex|pg zV&dVNP4k{l-RO30-zo3gr&knBS2F)_#bCw$a`WjqJ_om_6uGC|pO}1lrkUH$-TP{< z_V;R*)ETUJ8&P(;y0z}ny>B0vVKBeLB``2@4q@F(cH&eDGQt7PyCgHbkZkp1HJ8XP!%uMc`8|V7Sre^WIiRt05 z+vcBkx4rYSpY_~Q`M_9{tkmwbb^VpA%V&vZWcgT5sz??s>1AHC(#d3IPd3};?H5<6 zb4)JQGi|@|c*4KtteFP&sdvtN4{=TVUSfHRY0-vR#(r+dFNw z0&OxC#(OSBujIV%?9i-wX7kbNLNTkmNAIyTc|KKJAh6hp$efah-=ZvVbb#i4_XG~h96~d&T=2UOHrb6*7 z`_{PWv(`tSQ9RqRarXVry$f`^K0T96E?NEbsZONIhqsZ7=ju#6HKR&>%A7;zB6gMO zRdOD?JMlp5C%K6y&g}ZbSN|yP&2iH=IXwj>d7{~EheYpnZJu%BQNBRF0L!9)Pe!qa zj{BXAxS^a`ykmu#igxDVLp#6E{uFan_+$P0^41>yZ@0|$H>@e%ek{f>-)y5W&(?i* z$Bro^beJA?2-Cc8HpfEjw%PQJMdn&JALlBaJn`&oWzm5TpZ!y050>tTsd0bgiyDjbwEyT62Q`=QfQiT$1}2 zg!rsBs-JtxNB3Yfdwxm#-qYQ%}8W@Y-@SWBT0B2i0fZvh&uB_V?nA2%I42Z zWw}17b>(_hyZ^1LU$W=4rp3-v_x*TlBA+OHWp+J%)2Pp{v5=Y*{EJ3H?z%|$axe(c+vcJj@qb51ADSJrpTyu7Rl@j3&vL%7#is3MJ-^A#8BYvn*#~|JS-E-hwX=KHeSfD?zBEco zOrDwZd-vR1or?4UQi|QO2b;?6DTZ4~ z`{?HW7Op>&H&)g0{#khM;eCT^=DY>=M=bNVpDGlO-?NjcPO$p-#h^+5L~DOvblBe- zU-ul2>s9S-j%6NaKhi0Cngm9RMOCoxgw}nnfCPf@!H2{CTu;| zd*sdK&}eO4aqW$74n&$h@4Tb7?&Xzra_?S5GkG_>ju4${ufr#k{Bq-UVfh~uVl;ST z4&BUs+VlF@aehxJ?Q3`4l!XiDnfdZCbi}+U{VRI^YF?+8xy(`j(!KSkbq*zVKl6O| z^qJ*8%>^E}E57NTv+h3s(@Vi>U5mx0&gmu_CSQCVvg?YMG<(8V?c*sCnjx!HGh&L; ze6Kkh3bbCD&bCMF-8YV_#g(;p--mykKF8&q!S_GU_gvn3wCLT<&09MoHC!b6qj#P^ z%bQ=-@JT^Ibdo^PgXav#`qXXDX4K1?YGvOwefKS+@aON-8amI5b8~JT+ju7L(gic! zRoh-%JT8%)+}Zmrf?2|9mgvn5ALknt*c>cAV{W;+I&yx(rxOo$_Q+Q*j_nRl*)3x$ z^{r%TnDm)-g@^j2qmOTIzq$IA$MUShPj2sDay{?T+~Vi@Gs;u8Jh{i*s&QBN#Pt_n zkJncQTmE@?#<;-tdilAsId&ICHK#q>AH8gD>b9r+-+rF`S-#Et8BgiPTk`KG%rpKO zT)*Y=GAr9)`zL$1Nl%k_7sI+eZ0(~RnO9DKp0nxbJnxBT=5C)^xwnO<>)Q*HNikB- z3#+e6XNjD7df<8a%!rAr7WYmH4%M79)u>@1qd@RRN$vW(kB)<~;=S0WcbQu+C(G3< zO|zXlZ+BSZx~?cOQ`M(i>b~^KO$pXGf98hS)=A43uv+?0vfkOGlqteLc}3f^DB=@?Qm-25mZoRf-O|^dOm)qw; zw!LZcS)7}`dcmfiddsu7!*|DqwQ4^tkDs{xxWC`)>Kz|1f0!uW=CGi+=i}&=^ zH{#UQ7POt5#BRCt>Av?uYb!qT{QkT2P4^l9ExM^^a(T<8BTdZ&-insL>d`&;)c5m~ zv#|zIPt!MxKFr|j`6?KC{H9CMj(>*ppR8tfW(8ez!q8-U^Fg+%bX5JTDz3fGbBgxN zs#bU(sBtjjz=6`0T1GQpy>ep{A zs+vo+cfIxW4rydk@|t1b@0D=S!AG58g~QU22gX$oWtSfAKiT>Glg5^ku%H5-hle8i z-!#6Dt510rdg_3byrccZWT)j*>q`%BJ^s{J^FKq+g6*Lkd|QHLkCn?^WWDBfBd6>KA*|w0G>Ebx-7ntWGSJzfNtRhuh~>>#!@| z+?HK-*5nM6#T>>pllaeuo`3Sbw{T|m<ls#?pR8GYD)P4a&8LL{+f^Bjyq;~T zc08JJ_4L}ui>v?5`&AdUx?c0A5IehjPj^R_)`hTh5zp_un}6!p;pqk2n5J!;=zi@Q z!_2JQ=Q;Z;r*=oN9dyY$yR3TZ0RhJ=f=*VGRlJYX+xx^ z^oy!l^-Pkh{(5M-^l{cjtw~3m6$Jz|Z}d!k_c3Y07wvbRMtw;g$Nn)twDsnDdBj${ zDgEz~b>)ffYGneq9DKb!ZB-V{%eyU-oa|ntZ9ct5X)ec_TQO&zo2d(K$qAjLtn)1B z-N$X8PF(O=%ig+bXZrQ^T8_187f$ZoJ$u@#8z)ToqpJ0dzSz|J>Fp|=@+Nf8N3-be z=IHL_h5J`8(CsZb9&SH#yX6}7D{F2RJz8=rFk_Wokg#sc8Rn>vvfj{KS;;Twd%lFE z)My^v`brJK zo480Ruz07p|H1b>MNF~sZJL++Z~`sB=+IXM20=%e@lwt}XVgPp@uJVb79Y?{v^QO-g#T*p%PrVh_f- zAGV#6C+o|wa=qGx>)U3`NVHsi>RtT2SLY60@D!O|^zn}Aaz}xysegAS{>_-WXJ62# z&5s0+-Bi{U;bYG=314rN82QL)*5{KQ{}~R(O}k$FHS+cOj>PSvq3V7fX)EGKD_z$*-B+xK3ASPY6?8 zV9d>THz(d+_&Q)slSY$`O83ow-60;69Tu{e}Tng!4DmH*h48Eq<<@yAcrIr^BXYS^dl)AiSlBRGtAc;w1`7VL5P zk(zhG+3D%$Ewx(?v(4Qnc5+?FQ;iQvk@AM~p5@9b?_#?4xX^A#bls2LF1rMEZCEvA zSIj6hJtFXT^{sP#%C4F&d$%7?U9)`C#Iv&`XGMMBur6QOW_{hT{k)}5$d8(}*Ys-R zbN(}|F1*~?o)}iRQ|hBe{ecx(50sb~ndWw!jC(Jp$?w|MJTXf4jG*wZ=_@lor7zhl z!!lhiWtAw$3{i(rgBg>9ZXH(NbHS@$B1+$&tzcT|>L|vSA-`7L_FD& z%#PbJ+1s%}lPQ5qK%?WtvM&m!PfiNkoRPTlZFn^M-L0W4i+Ysx;&psPiyML;YadPX zu~ts8Uvo9e^t4LW)OKCR+&QO>j&3&XU7=rSvf>4Iy1TUT)!FV+xt7y+MMOEKX7a8P z$q8sU#<16{x6te1z00eQ2`=2ia^fbdW_{7i8C6-EjT5i-_==mKE6#r8BV%%hsaa_1 zfy2&+F1~R2adP!)k9SHR4)7|TEzR5^+ZAX!x$Ij{?$tX>dw(4_Z}&Z*;oh@kpTubn zo{U2FD85#M87sS`HFV!5cNi{U@D!2uTUDjb{>S3jG4q`+{}~=y7}n?9T(hiqZNBhr zuL~vhZ+x^fLSm9qPH-Ab)6LvD;kfRRDc_QLZg9Sgy8Z3PYQbq6fBg9(*lzmqj05jO z=J=Grg0~qneO`w>HBP#AuHwC7>7Gw6-&|w+3Pmm|`UrDR*|z=2&BNL%{Y`4^;wD|9 z#u5fw`@UU^sxaDmH}q=2!AB)4-Umk*oJz@+wl|57*;&8v2S8Lf(Y$b9|Xv9!@^@S^2$+ znZ;fuD^I&qUoNbfTEAK~>+IoE(<@K%Zc|gpeNbT@Y%%dzU2xVWpNH8|T6bFRGRxY;o~;Aa$fO!;s3$_TZnZ~NjrpHFk1o}%=UE&NhD zxg+`QPbZn}$|uj*>@R$L=W&$1@P^6vbL|3x#oW%>Tq;zvv_D;!{VbvW_wEYmwCfGm z%pOeJdF9@Pki#rrGS=7hJ^$@y`F4BCAEiAy)MTF@G#c+bLyj`=;88b|}~;`aAJOZ?SuIb?wz-6-RBglET;Qopf{JzPp!Cif@z& zvY0i$b{E4oZQT_!57(+|9M6ARdv#B}g1PGC#&spfgJeE&J7|l(IaqzV@U-yE4Pma& zyCNRt1c&F#B$%uz)(N&13)>l-8(|VwOo{w@@1?0+nzpdy~H)~<)R){Lytvg zpT+j>YuI@|Byr*$={x@!CRtxr*m#J0#Z0@9nRzNQb&_hm>~Zo=tUI4pNB!8wU%K?b z_xhMi75*8{JnVBUmb=_ZOMNS+`R{Gn!#(d*qjlxtcD(z1wkxLcU6j%i2L*GbtM5M6 zzU241@JavgLGd?nOBbK~vsXf8$EQ#ZjtLD8N=^z2B8@CHb8qM7sP8CTnC+3Cd1Gbe z5nX}Lt9HKAFI+vxdrsA<&%58xOj{$;+E^fRWRX`!J*($}djYTdb^or35)WDJnikeu ztR_2a3wze~t2*=7r#owBD=aA6J;iTlP{}R++eQ-$-|AhN%H{7aF8;yce$LgqTpxWl z1;^aNXOr4Yp!0pfA!$ZaL;n(zt4p>9aWOmt&wO}eX#oB_Bh?x+cEyR#%bFp zUi7#d^=+2u^tki&l5wT3$%`-i^q%*5d-}taop#2o5q^6@Vr6Uk)y*gF%hYYIoIP{S zIRV$YTCx0XQTM+p9yXS_bp49&>R$g%^K<5ZRaD$_@yr?-)!y=0k-sg~9)&-i8}Iq} z(ZnSCuuE^}e}?(e_y%-#j?}(cDmcT%|v0;P>k`jtc_ zNz9A>+-}>lbN7s6C(pi_r~G5@v&%(?Ph2#w(lZx7B_6*2ow%(|;k%y}+OHXWj06R=LTSH}i7TwEF)HC4EzqWpAwB-kQSnF@E%<9^<$ngFpC@@QR2y16%!<=cU(4}@b@S?0A_H`xd=o zl?Z>g$W8u?wvOxLb-HWgl;<^7Sb2v$n7buo-Jj@^8QD3n=ia7uOLXqlbR)Uc zyH9-c5~`K{I`e8@naCYp8WZ(-`Vmjrse2dCG(9||}y#DNM zY?Ci7*6g;6{;WT(*k<9mb>{0!Pw(;X*t~oCEg^>NyUp{&A>JY!5Yj+#eIY0QBJfnDfgwJJ}pY_YSk8Czw zw)Xq2iD_~1+@iDH)0Y)LS1V%IbnThNQNMTgGV2yOB`GVX^Wny^k3??r6&{?EdnWLs zd1rqCL*}~GcG2>+X$Idc-Y?wq)GmIK@{!Y4;>C&H> zx#ynksXp*+)v49p*V!UtZ01S}pZ}xkQm@QWv-4kjN>w8Jo~x`=LwNKp#XZl>*_>f} zGUmJY1!vm@OY*)r1V=46`g3Q7o~6=<_l*}%-FI%<%=Y7KoDOfP^_3lB@3^#Fm>9sN z(<{Z7sSBR?|8CR2vDe#u^3N& z&7QON$kx>_teDQm2J-dw@l`L_v~wfb9uYKgQ>bZmN*J3GITxv>2u`n z+02RCX9>SGa{DgqIy-j5r6(W%Jbcf)`J~vEh66Ge+?VLiztPV9FZKAtpMKNS-#FDj zy|Gw&g58(3vW;Pt279VjizL1K&k+Apv_4JvKZDj$i{1OL^F8@H`Cn+~kJPs%bILVA z?DmJ{hvQ|+>($>JvVR(}=+L*eNn7U4Qhzi5Q%>%WKNGU|o@8$2c%^mqsf)JUt}k;o ze=g$Pa^A@5;2b|wyGu9Mo5{x7?7h-c>bdF3>FRWLvr`6cZOfL2W<0yuz53E>u;@>nVZ`?=T>NL z@`-@x3HdWsT5@@%w9f0zZ&#oAE>~V6ODE^!w48@+H;&z(6Sd*?#RVCC%HR?b}ic+;M(`%)Y)MS0zvb@$oqkkZuan`(BQzP{$q-KUX@ zlAjkpn0jb^&z4!D!hCCT8VjGj*Ep7O{iNDQx2Y2THw8`<>(6@j^uyhRH!=Ea=Xk45 z_EQtcn&E!$i@bhHS6s-ZxeF?$GhX)f%2dANJ(>G@%4zSF*Q<1=$Q-lXeog2=?Z>zE zhpOc6hK3zJvFGFQ9U_4`ArsZz)ZbO+%v(xyio18=KWFyS0 zv(EL)pAIk1wS9YY*9pJhtJ|5~cU<9HAeLjZ_Gi7Z?c|-=lNHXVEk6G7N7$jJ$|~=z z59C@cr~df1b?IA+o-jS;#KvROPv*B&O#EaW7$wCJ8tXCtu=|u_hbL??*tNF8rf^4w zbKByO_z#O_TfEr#eaD%JAJ#`Q|1sa~sIZik->XHxVB?R9)fOj~^YC20(3E&1P)FT7 zHrn;EYVU}4gadoS@akl$n9lkngfi~df&vSp|J^d*aX z1Q{6`K-r#ElR1lL`pgZd{xHwm~jWF{JKb*BIn=hmLh>M6)nv?R11+K*^#aWj`4qbXC#Lf76 zp?A4&&Ra(#lYoZCk~>;UC8824%eANM?b6POk&?UgGKNEhZMCZDnGN@Av%W{X{lt?j z`ItY2?K_ul|K-hIwXJ^j6_Wg*+-Vv9uQle6?$6uy1z~+WtL@Hl>FRyIW4$x_i{O8T zAohcI>pndB%lvPN@Pl{9PEQYYf8kaC%F#~jKSSxscm5Y9|69V}a^l_2Kb^mXW_;Vg zy3ck0_2w6$^LUp3o0_s#(xId{#_F2ogPR%8F9qF5{cyh1&u(p(z1NwEXX+Q3ch_;M z8AR_)o~QaS|Mu$jJu|8=N|kDzmwWB5w8?pr^yBg+TD9Rm=Qi=oo$F9`c#GJIe-~z4 zURBT6|8R1%qjcjf4aTtFYi2%tJ>9H^oH{XWLH*W;DZL-AY+tiQvSzyBiyxe?rPge{Ep&Z5 z+f{{~?N2A&o7JWLbHnYB!y8`AT~QkHTqoF=RVUp+W5!+O*1e2Q_j9H?)!p>kc>3AK zw-1lsvlGkfkx!`-+_-*nhgZ2}@!I+;bMN%r-;$J<`s{Z9wo_gV*Ke5kXxnUcfB3du zzE}HMPJPSHx7D32bIUZ7=A|4@{&-NN%CI-rih--(cwXFTH#NWf*THR^ds+@nVCLPztZxgAW`^yS9Jdxn-Q zUR~H$Lib+wV>C`1bn3DzltfjP{33 zA0JJ2{BZ2q8!qQ{R>H2DDfjuz;woldH|SiJ6L>U7M%$~}Ws&O2(j!h~2mG(?5R$$k zV7Zs0;#v9JLbE^bCv4o`d)@5EPM)<5U0W}mxXZR;=`x8o=K^o8zF26xr|d)6hTCoz z7+z~#c=CRR>r%m`30?IqpbR7)$nUZLNmjj}^KbQ)nV;A8iw?5C&5m7w+ymfYL z@MpKB?vs+HP2xM;qixjo^8>m zVshThq$=?kxlbsQF+{^|FOjYqFGoR#?Lb7j?+`m~gw|ibDUhyPqW#m_$?yxM$jLRpxTy&)~D`;XW9hsC=Ct&syNN^ zo3hQGr)(Bs?iRf#e{HDyI<0=%o~@_K)~_jxNvU44ZEK`*sMc|ty_0q|MLft5`?hq! zyX=fj$4-T=HMv=QU$Ch5cB%Z%(0aGW$M^kpf9ii{r3`n!-0!c^>ON%PE`c%Dk)SkTVn8x2%Yk!HA9-VaWn)>^Y{|xh!B#q<^``-B9U1k3~qN)Db zm)xektx^y8D(@=;O(u>fIIW>U@W;Gv8SI zJv8!SMah}D3oo8u_?qiu)v0;n&1ZIPt809#Y8dI4&$qXEbEtf5%I~!-ACj!2tfyHQ zJ__p#U2tT^Y4e({@WrlOccM05zH#H?(G3<7OX{mVZmv3*Cu6qq&C~0LVtXfF`MSpV zU~c#=5uRrAtq<}dau3bO3BMT@GyCSuZxeR#eu?___?EQj(@V!^*5|4{j*Q}XYrstL|@~>UD>yzT* z?N{sBQu_Ys#@9KECCmqx5##E&21O>rGx2Y5^zKVN_fvz{|GD)vL$R{SJ>~@erfa=RMYjED zpZj>v@l%J-PD*{Z*2dd2=A9VxTN6QtWfG4ka{taZ-+1Pk_UV&v)jr5GOEOAbc<-Yx z)3xOO&)bqc+vO9!d(>XHPnxP-RZ7UaTc=}z?_m_KWv3x7*Absv9Qmd9~rZQMBNJH8MY{>#uI#8CDqUv=@@A!*-=rZ_S<5Dje-}bLFwS4sR!Ml`YdrS}NpLX1n~-ys(yvu-N(l*#)BZxeJ9CZE|K| z4|lVk7WFB&&GJ#0&wlx=U-Nmm-b;yAJUuP*A?uk(Oe7#Vu zSRpk@wA|^=dMhbu+nj%b`|Lda-4ePt>8{g_^-8L%^JEu%G2b?cYvZHcjThE--BVp} zmCL@0W7W3MS0=8ToESx{>Q|jr3hSNLQkk zUZwK*QGJt&@{Pi!RhPMsF5^9#baPIPMf04yzD$Yv+m7TUu6xM)P~k#XzK^E0PU%OF zn=TZFrW%XwB1&yOzmH8IG-03J;XuD^k$Fm&;n>)77 zRblFwB@!7k@rd;HsQjRQ<{Jxrni+3#uK1$#wOMz|&RL$`(aSqtg>QA*%r@t^>Ctr} z1-Aq}6+9^}Pl7H#DVx45R3wsl+H;f;sCUbemFBe-$l#w{kiVoTnf zzL5Rs(uP;7cAieMDl^ylc+7V3${Xe@I?g=w+}~w;)6HUa1E^&2O#} z9lSN+`y9%J!m2(jTv?y2o_s9QAi#}3Z?$Q~glpT)jGZEz>)*v*Xj90N zV)VbZ(&qH84~x~7a81o$w5EQ0;X~KY?nSkt{%<2H3jbXDu6{B2TaJyzzwGMz$uCwV zPc4#2vJx}j>Hhl4-_<+J%8uvc2HIq;kBhytTR!XU8o6dy|EsI+?=DUk&i<5j`4VTy zJQ;6Q+txWUISXn-56`Ol8j*V-C;X;ojn14BCbvC&Q`hJ5Y+Lyz@%qvG$G=VZXufnc z?~Y)eug}Bk6;gH2^{w%HQ4n?Qvcb(h*VKA7%NZZTb_iY)(>(PtXV)X?uW!TGKI6PD zloTx;xwV)%_VesTH7e0awji_gMo0Z@wHs$%ZhAZQfO&Vp8z)t^%xATCHi=LBaKf3vic3lDZqTRm zYp?LFSpA5vJWD(8SZQfbL$2wf^SqWnosVd*x?c75yr$KhgXuT^GXzarue@cicCU=% zv4+Pk2TB&M(X(QE6%;Hu^N8%RgW=LUw-)a^*(azzO6qTHwcfq8 zV}0VWPPPEX!W(z}leRdT9WwE4tF%+kEzP*Y^r~>jM%x&>biHCjPRB#5my33ND^g24 zu-9nP$5u%h-(neoeVM!x2ZKVQZnPXNN@DMxX7niRmHUQ!OHV!dR4?%6!;boy9v`iz z8(o`OmZY?|U21($O5q|S8!xGM9mk6C{5N9emb%TwI z$44gS9<{*6V*&>)4mGnrmenfaGnnb|n5&4-V6mdbq4_EadorK&@R^*l@jSM=W9p(b znR+{m_&BvDt83bsYc>a$E)<9`vb1t$oYYbyxI!S9c!X?R|8y>PJyAIi((T?rcNAOBk=RNu0K z&&F)~ePNy^KlAC9dl^so98i~kEXlH^XP(lj?BG?hoY}SVkK%=*>mMH8xc0tRzLT1u z_p6_>JI@!&wk+Cw=bzIv%k+i~SBw;{mn}>#x?54!$7>()_|U~$n~pAA`_<=`obKMl zs+}>P=KuP;{L^2LYxi%ylzo+WgoF8|!`bI|m)_n`b+xP}^2dJ$ix}5$g?|M%Z!G#& zUUg3W;PtB2Ddj7s%--{R$?e+18|zc9-|eqIdd~ix!C%?adyoCFIj{X};=RqL56Tz0 zS8+(b|I*#NUp+nR=>A8i7eARUzvKLZv$M_eVtD^Es4sg|6I;H<=bG#*Ro3?bljKXj z$p`JV-gtlGYW7ZdNTMVNO_e(wRXzbjXrseL(YtQa3n;-XX>47IvHBVnw?C0=!ANA>`>?_85OW5z;e-Re- zcdB{(tG-{#cmFf|)_p5GFMIB%>9yL0M<%H((Q4ky(BQ=Jc5#-<3W4_yi<1;)pJMsx YVfEf2&$V-}(9?e({=As=z5f4A017@$MF0Q* diff --git a/homeassistant/components/camera/demo_3.jpg b/homeassistant/components/camera/demo_3.jpg index 06166fffa859d9fdccf1fc89a563cd6574319d42..a349f22b1523ecc5abaf187acfe98382edf8c699 100644 GIT binary patch delta 43302 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%0A-zo=VPm>u>UN{xiINv%_}re+KWD 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 From b784d809735e789f4851de2a149bddc06a2aa628 Mon Sep 17 00:00:00 2001 From: Sven-Hendrik Haase Date: Wed, 22 Nov 2017 08:39:45 +0100 Subject: [PATCH 128/246] Add transmission rate (#10740) * Add transmission rate * Rename transmission rate attributes to shorter names --- homeassistant/components/sensor/fritzbox_netmonitor.py | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/homeassistant/components/sensor/fritzbox_netmonitor.py b/homeassistant/components/sensor/fritzbox_netmonitor.py index 4e35bd85799..c7486b56c25 100644 --- a/homeassistant/components/sensor/fritzbox_netmonitor.py +++ b/homeassistant/components/sensor/fritzbox_netmonitor.py @@ -25,6 +25,8 @@ CONF_DEFAULT_IP = '169.254.1.1' # This IP is valid for all FRITZ!Box routers. ATTR_BYTES_RECEIVED = 'bytes_received' ATTR_BYTES_SENT = 'bytes_sent' +ATTR_TRANSMISSION_RATE_UP = 'transmission_rate_up' +ATTR_TRANSMISSION_RATE_DOWN = 'transmission_rate_down' ATTR_EXTERNAL_IP = 'external_ip' ATTR_IS_CONNECTED = 'is_connected' ATTR_IS_LINKED = 'is_linked' @@ -78,6 +80,8 @@ class FritzboxMonitorSensor(Entity): self._is_linked = self._is_connected = self._wan_access_type = None self._external_ip = self._uptime = None self._bytes_sent = self._bytes_received = None + self._transmission_rate_up = None + self._transmission_rate_down = None self._max_byte_rate_up = self._max_byte_rate_down = None @property @@ -109,6 +113,8 @@ class FritzboxMonitorSensor(Entity): ATTR_UPTIME: self._uptime, ATTR_BYTES_SENT: self._bytes_sent, ATTR_BYTES_RECEIVED: self._bytes_received, + ATTR_TRANSMISSION_RATE_UP: self._transmission_rate_up, + ATTR_TRANSMISSION_RATE_DOWN: self._transmission_rate_down, ATTR_MAX_BYTE_RATE_UP: self._max_byte_rate_up, ATTR_MAX_BYTE_RATE_DOWN: self._max_byte_rate_down, } @@ -125,6 +131,9 @@ class FritzboxMonitorSensor(Entity): self._uptime = self._fstatus.uptime self._bytes_sent = self._fstatus.bytes_sent self._bytes_received = self._fstatus.bytes_received + transmission_rate = self._fstatus.transmission_rate + self._transmission_rate_up = transmission_rate[0] + self._transmission_rate_down = transmission_rate[1] self._max_byte_rate_up = self._fstatus.max_byte_rate[0] self._max_byte_rate_down = self._fstatus.max_byte_rate[1] self._state = STATE_ONLINE if self._is_connected else STATE_OFFLINE From cfb1853bbd60d0f53279deca9c4fef9c9b2d1f30 Mon Sep 17 00:00:00 2001 From: Lewis Juggins Date: Wed, 22 Nov 2017 09:37:20 +0000 Subject: [PATCH 129/246] Update pytradfri to 4.1.0 (#10521) --- homeassistant/components/light/tradfri.py | 2 ++ homeassistant/components/sensor/tradfri.py | 1 + homeassistant/components/tradfri.py | 8 ++------ requirements_all.txt | 8 +------- script/gen_requirements_all.py | 3 +-- 5 files changed, 7 insertions(+), 15 deletions(-) diff --git a/homeassistant/components/light/tradfri.py b/homeassistant/components/light/tradfri.py index c3632351e5f..3bba6da8dd3 100644 --- a/homeassistant/components/light/tradfri.py +++ b/homeassistant/components/light/tradfri.py @@ -120,6 +120,7 @@ class TradfriGroup(Light): @callback def _async_start_observe(self, exc=None): """Start observation of light.""" + # pylint: disable=import-error from pytradfri.error import PyTradFriError if exc: _LOGGER.warning("Observation failed for %s", self._name, @@ -279,6 +280,7 @@ class TradfriLight(Light): @callback def _async_start_observe(self, exc=None): """Start observation of light.""" + # pylint: disable=import-error from pytradfri.error import PyTradFriError if exc: _LOGGER.warning("Observation failed for %s", self._name, diff --git a/homeassistant/components/sensor/tradfri.py b/homeassistant/components/sensor/tradfri.py index 88a33cb2f8a..d087fdda9f6 100644 --- a/homeassistant/components/sensor/tradfri.py +++ b/homeassistant/components/sensor/tradfri.py @@ -90,6 +90,7 @@ class TradfriDevice(Entity): @callback def _async_start_observe(self, exc=None): """Start observation of light.""" + # pylint: disable=import-error from pytradfri.error import PyTradFriError if exc: _LOGGER.warning("Observation failed for %s", self._name, diff --git a/homeassistant/components/tradfri.py b/homeassistant/components/tradfri.py index 53ea7eac997..5ac4d2a4eb1 100644 --- a/homeassistant/components/tradfri.py +++ b/homeassistant/components/tradfri.py @@ -16,11 +16,7 @@ from homeassistant.const import CONF_HOST from homeassistant.components.discovery import SERVICE_IKEA_TRADFRI from homeassistant.util.json import load_json, save_json -REQUIREMENTS = ['pytradfri==4.0.1', - 'DTLSSocket==0.1.4', - 'https://github.com/chrysn/aiocoap/archive/' - '3286f48f0b949901c8b5c04c0719dc54ab63d431.zip' - '#aiocoap==0.3'] +REQUIREMENTS = ['pytradfri[async]==4.1.0'] DOMAIN = 'tradfri' GATEWAY_IDENTITY = 'homeassistant' @@ -143,7 +139,7 @@ def async_setup(hass, config): def _setup_gateway(hass, hass_config, host, identity, key, allow_tradfri_groups): """Create a gateway.""" - from pytradfri import Gateway, RequestError + from pytradfri import Gateway, RequestError # pylint: disable=import-error try: from pytradfri.api.aiocoap_api import APIFactory except ImportError: diff --git a/requirements_all.txt b/requirements_all.txt index f135744c467..7c6ec95b517 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -19,9 +19,6 @@ certifi>=2017.4.17 # homeassistant.components.bbb_gpio # Adafruit_BBIO==1.0.0 -# homeassistant.components.tradfri -# DTLSSocket==0.1.4 - # homeassistant.components.doorbird DoorBirdPy==0.0.4 @@ -345,9 +342,6 @@ httplib2==0.10.3 # homeassistant.components.media_player.braviatv https://github.com/aparraga/braviarc/archive/0.3.7.zip#braviarc==0.3.7 -# homeassistant.components.tradfri -# https://github.com/chrysn/aiocoap/archive/3286f48f0b949901c8b5c04c0719dc54ab63d431.zip#aiocoap==0.3 - # homeassistant.components.media_player.spotify https://github.com/happyleavesaoc/spotipy/archive/544614f4b1d508201d363e84e871f86c90aa26b2.zip#spotipy==2.4.4 @@ -901,7 +895,7 @@ pytile==1.0.0 pytrackr==0.0.5 # homeassistant.components.tradfri -pytradfri==4.0.1 +# pytradfri[async]==4.1.0 # homeassistant.components.device_tracker.unifi pyunifi==2.13 diff --git a/script/gen_requirements_all.py b/script/gen_requirements_all.py index 9d9725e9e6a..fbd60ffdadc 100755 --- a/script/gen_requirements_all.py +++ b/script/gen_requirements_all.py @@ -31,8 +31,7 @@ COMMENT_REQUIREMENTS = ( 'envirophat', 'i2csense', 'credstash', - 'aiocoap', # Temp, will be removed when Python 3.4 is no longer supported. - 'DTLSSocket' # Requires cython. + 'pytradfri', ) TEST_REQUIREMENTS = ( From b668b19543de62d7c747e46439565e6d51f7f34e Mon Sep 17 00:00:00 2001 From: Andy Castille Date: Wed, 22 Nov 2017 04:40:15 -0600 Subject: [PATCH 130/246] Use new DoorBirdPy (v0.1.0) (#10734) * Use new DoorBirdPy (v0.1.0) * Update requirements_all for DoorBirdPy 0.1.0 --- homeassistant/components/doorbird.py | 2 +- requirements_all.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/doorbird.py b/homeassistant/components/doorbird.py index 421c85a0f94..dcf99fe2933 100644 --- a/homeassistant/components/doorbird.py +++ b/homeassistant/components/doorbird.py @@ -6,7 +6,7 @@ import voluptuous as vol from homeassistant.const import CONF_HOST, CONF_USERNAME, CONF_PASSWORD import homeassistant.helpers.config_validation as cv -REQUIREMENTS = ['DoorBirdPy==0.0.4'] +REQUIREMENTS = ['DoorBirdPy==0.1.0'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index 7c6ec95b517..cff019312ef 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -20,7 +20,7 @@ certifi>=2017.4.17 # Adafruit_BBIO==1.0.0 # homeassistant.components.doorbird -DoorBirdPy==0.0.4 +DoorBirdPy==0.1.0 # homeassistant.components.isy994 PyISY==1.0.8 From b4635db5ac634980729e86398629ee38efdd9722 Mon Sep 17 00:00:00 2001 From: Ted Drain Date: Wed, 22 Nov 2017 14:59:49 -0600 Subject: [PATCH 131/246] Add fan and reduce I/O calls in radiotherm (#10437) * Added fan support. Reduced number of calls to the thermostat to a minimum * Move temp rounding to config schema * Fixed pep8 errors * Fix for review comments. * removed unneeded if block * Added missing precision attr back * Fixed pylint errors * Code review fixes. Fan support by model number. * Defined circulate state --- .../components/climate/radiotherm.py | 232 ++++++++++++------ 1 file changed, 158 insertions(+), 74 deletions(-) diff --git a/homeassistant/components/climate/radiotherm.py b/homeassistant/components/climate/radiotherm.py index 6daeebf9f55..5de6478133c 100644 --- a/homeassistant/components/climate/radiotherm.py +++ b/homeassistant/components/climate/radiotherm.py @@ -4,15 +4,17 @@ Support for Radio Thermostat wifi-enabled home thermostats. For more details about this platform, please refer to the documentation at https://home-assistant.io/components/climate.radiotherm/ """ +import asyncio import datetime import logging import voluptuous as vol from homeassistant.components.climate import ( - STATE_AUTO, STATE_COOL, STATE_HEAT, STATE_IDLE, STATE_OFF, + STATE_AUTO, STATE_COOL, STATE_HEAT, STATE_IDLE, STATE_ON, STATE_OFF, ClimateDevice, PLATFORM_SCHEMA) -from homeassistant.const import CONF_HOST, TEMP_FAHRENHEIT, ATTR_TEMPERATURE +from homeassistant.const import ( + CONF_HOST, TEMP_FAHRENHEIT, ATTR_TEMPERATURE, PRECISION_HALVES) import homeassistant.helpers.config_validation as cv REQUIREMENTS = ['radiotherm==1.3'] @@ -29,13 +31,51 @@ CONF_AWAY_TEMPERATURE_COOL = 'away_temperature_cool' DEFAULT_AWAY_TEMPERATURE_HEAT = 60 DEFAULT_AWAY_TEMPERATURE_COOL = 85 +STATE_CIRCULATE = "circulate" + +OPERATION_LIST = [STATE_AUTO, STATE_COOL, STATE_HEAT, STATE_OFF] +CT30_FAN_OPERATION_LIST = [STATE_ON, STATE_AUTO] +CT80_FAN_OPERATION_LIST = [STATE_ON, STATE_CIRCULATE, STATE_AUTO] + +# Mappings from radiotherm json data codes to and from HASS state +# flags. CODE is the thermostat integer code and these map to and +# from HASS state flags. + +# Programmed temperature mode of the thermostat. +CODE_TO_TEMP_MODE = {0: STATE_OFF, 1: STATE_HEAT, 2: STATE_COOL, 3: STATE_AUTO} +TEMP_MODE_TO_CODE = {v: k for k, v in CODE_TO_TEMP_MODE.items()} + +# Programmed fan mode (circulate is supported by CT80 models) +CODE_TO_FAN_MODE = {0: STATE_AUTO, 1: STATE_CIRCULATE, 2: STATE_ON} +FAN_MODE_TO_CODE = {v: k for k, v in CODE_TO_FAN_MODE.items()} + +# Active thermostat state (is it heating or cooling?). In the future +# this should probably made into heat and cool binary sensors. +CODE_TO_TEMP_STATE = {0: STATE_IDLE, 1: STATE_HEAT, 2: STATE_COOL} + +# Active fan state. This is if the fan is actually on or not. In the +# future this should probably made into a binary sensor for the fan. +CODE_TO_FAN_STATE = {0: STATE_OFF, 1: STATE_ON} + + +def round_temp(temperature): + """Round a temperature to the resolution of the thermostat. + + RadioThermostats can handle 0.5 degree temps so the input + temperature is rounded to that value and returned. + """ + return round(temperature * 2.0) / 2.0 + + PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Optional(CONF_HOST): vol.All(cv.ensure_list, [cv.string]), vol.Optional(CONF_HOLD_TEMP, default=False): cv.boolean, vol.Optional(CONF_AWAY_TEMPERATURE_HEAT, - default=DEFAULT_AWAY_TEMPERATURE_HEAT): vol.Coerce(float), + default=DEFAULT_AWAY_TEMPERATURE_HEAT): + vol.All(vol.Coerce(float), round_temp), vol.Optional(CONF_AWAY_TEMPERATURE_COOL, - default=DEFAULT_AWAY_TEMPERATURE_COOL): vol.Coerce(float), + default=DEFAULT_AWAY_TEMPERATURE_COOL): + vol.All(vol.Coerce(float), round_temp), }) @@ -77,19 +117,34 @@ class RadioThermostat(ClimateDevice): def __init__(self, device, hold_temp, away_temps): """Initialize the thermostat.""" self.device = device - self.set_time() self._target_temperature = None self._current_temperature = None self._current_operation = STATE_IDLE self._name = None self._fmode = None + self._fstate = None self._tmode = None self._tstate = None self._hold_temp = hold_temp + self._hold_set = False self._away = False self._away_temps = away_temps self._prev_temp = None - self._operation_list = [STATE_AUTO, STATE_COOL, STATE_HEAT, STATE_OFF] + + # Fan circulate mode is only supported by the CT80 models. + import radiotherm + self._is_model_ct80 = isinstance(self.device, + radiotherm.thermostat.CT80) + + @asyncio.coroutine + def async_added_to_hass(self): + """Register callbacks.""" + # Set the time on the device. This shouldn't be in the + # constructor because it's a network call. We can't put it in + # update() because calling it will clear any temporary mode or + # temperature in the thermostat. So add it as a future job + # for the event loop to run. + self.hass.async_add_job(self.set_time) @property def name(self): @@ -101,6 +156,11 @@ class RadioThermostat(ClimateDevice): """Return the unit of measurement.""" return TEMP_FAHRENHEIT + @property + def precision(self): + """Return the precision of the system.""" + return PRECISION_HALVES + @property def device_state_attributes(self): """Return the device specific state attributes.""" @@ -109,6 +169,25 @@ class RadioThermostat(ClimateDevice): ATTR_MODE: self._tmode, } + @property + def fan_list(self): + """List of available fan modes.""" + if self._is_model_ct80: + return CT80_FAN_OPERATION_LIST + else: + return CT30_FAN_OPERATION_LIST + + @property + def current_fan_mode(self): + """Return whether the fan is on.""" + return self._fmode + + def set_fan_mode(self, fan): + """Turn fan on/off.""" + code = FAN_MODE_TO_CODE.get(fan, None) + if code is not None: + self.device.fmode = code + @property def current_temperature(self): """Return the current temperature.""" @@ -122,7 +201,7 @@ class RadioThermostat(ClimateDevice): @property def operation_list(self): """Return the operation modes list.""" - return self._operation_list + return OPERATION_LIST @property def target_temperature(self): @@ -136,53 +215,48 @@ class RadioThermostat(ClimateDevice): def update(self): """Update and validate the data from the thermostat.""" - current_temp = self.device.temp['raw'] - if current_temp == -1: - _LOGGER.error("Couldn't get valid temperature reading") - return - self._current_temperature = current_temp - self._name = self.device.name['raw'] - try: - self._fmode = self.device.fmode['human'] - except AttributeError: - _LOGGER.error("Couldn't get valid fan mode reading") - try: - self._tmode = self.device.tmode['human'] - except AttributeError: - _LOGGER.error("Couldn't get valid thermostat mode reading") - try: - self._tstate = self.device.tstate['human'] - except AttributeError: - _LOGGER.error("Couldn't get valid thermostat state reading") + # Radio thermostats are very slow, and sometimes don't respond + # very quickly. So we need to keep the number of calls to them + # to a bare minimum or we'll hit the HASS 10 sec warning. We + # have to make one call to /tstat to get temps but we'll try and + # keep the other calls to a minimum. Even with this, these + # thermostats tend to time out sometimes when they're actively + # heating or cooling. - if self._tmode == 'Cool': - target_temp = self.device.t_cool['raw'] - if target_temp == -1: - _LOGGER.error("Couldn't get target reading") - return - self._target_temperature = target_temp - self._current_operation = STATE_COOL - elif self._tmode == 'Heat': - target_temp = self.device.t_heat['raw'] - if target_temp == -1: - _LOGGER.error("Couldn't get valid target reading") - return - self._target_temperature = target_temp - self._current_operation = STATE_HEAT - elif self._tmode == 'Auto': - if self._tstate == 'Cool': - target_temp = self.device.t_cool['raw'] - if target_temp == -1: - _LOGGER.error("Couldn't get valid target reading") - return - self._target_temperature = target_temp - elif self._tstate == 'Heat': - target_temp = self.device.t_heat['raw'] - if target_temp == -1: - _LOGGER.error("Couldn't get valid target reading") - return - self._target_temperature = target_temp - self._current_operation = STATE_AUTO + # First time - get the name from the thermostat. This is + # normally set in the radio thermostat web app. + if self._name is None: + self._name = self.device.name['raw'] + + # Request the current state from the thermostat. + data = self.device.tstat['raw'] + + current_temp = data['temp'] + if current_temp == -1: + _LOGGER.error('%s (%s) was busy (temp == -1)', self._name, + self.device.host) + return + + # Map thermostat values into various STATE_ flags. + self._current_temperature = current_temp + self._fmode = CODE_TO_FAN_MODE[data['fmode']] + self._fstate = CODE_TO_FAN_STATE[data['fstate']] + self._tmode = CODE_TO_TEMP_MODE[data['tmode']] + self._tstate = CODE_TO_TEMP_STATE[data['tstate']] + + self._current_operation = self._tmode + if self._tmode == STATE_COOL: + self._target_temperature = data['t_cool'] + elif self._tmode == STATE_HEAT: + self._target_temperature = data['t_heat'] + elif self._tmode == STATE_AUTO: + # This doesn't really work - tstate is only set if the HVAC is + # active. If it's idle, we don't know what to do with the target + # temperature. + if self._tstate == STATE_COOL: + self._target_temperature = data['t_cool'] + elif self._tstate == STATE_HEAT: + self._target_temperature = data['t_heat'] else: self._current_operation = STATE_IDLE @@ -191,23 +265,32 @@ class RadioThermostat(ClimateDevice): temperature = kwargs.get(ATTR_TEMPERATURE) if temperature is None: return - if self._current_operation == STATE_COOL: - self.device.t_cool = round(temperature * 2.0) / 2.0 - elif self._current_operation == STATE_HEAT: - self.device.t_heat = round(temperature * 2.0) / 2.0 - elif self._current_operation == STATE_AUTO: - if self._tstate == 'Cool': - self.device.t_cool = round(temperature * 2.0) / 2.0 - elif self._tstate == 'Heat': - self.device.t_heat = round(temperature * 2.0) / 2.0 - if self._hold_temp or self._away: - self.device.hold = 1 - else: - self.device.hold = 0 + temperature = round_temp(temperature) + + if self._current_operation == STATE_COOL: + self.device.t_cool = temperature + elif self._current_operation == STATE_HEAT: + self.device.t_heat = temperature + elif self._current_operation == STATE_AUTO: + if self._tstate == STATE_COOL: + self.device.t_cool = temperature + elif self._tstate == STATE_HEAT: + self.device.t_heat = temperature + + # Only change the hold if requested or if hold mode was turned + # on and we haven't set it yet. + if kwargs.get('hold_changed', False) or not self._hold_set: + if self._hold_temp or self._away: + self.device.hold = 1 + self._hold_set = True + else: + self.device.hold = 0 def set_time(self): """Set device time.""" + # Calling this clears any local temperature override and + # reverts to the scheduled temperature. now = datetime.datetime.now() self.device.time = { 'day': now.weekday(), @@ -217,14 +300,14 @@ class RadioThermostat(ClimateDevice): def set_operation_mode(self, operation_mode): """Set operation mode (auto, cool, heat, off).""" - if operation_mode == STATE_OFF: - self.device.tmode = 0 - elif operation_mode == STATE_AUTO: - self.device.tmode = 3 + if operation_mode == STATE_OFF or operation_mode == STATE_AUTO: + self.device.tmode = TEMP_MODE_TO_CODE[operation_mode] + + # Setting t_cool or t_heat automatically changes tmode. elif operation_mode == STATE_COOL: - self.device.t_cool = round(self._target_temperature * 2.0) / 2.0 + self.device.t_cool = self._target_temperature elif operation_mode == STATE_HEAT: - self.device.t_heat = round(self._target_temperature * 2.0) / 2.0 + self.device.t_heat = self._target_temperature def turn_away_mode_on(self): """Turn away on. @@ -238,10 +321,11 @@ class RadioThermostat(ClimateDevice): away_temp = self._away_temps[0] elif self._current_operation == STATE_COOL: away_temp = self._away_temps[1] + self._away = True - self.set_temperature(temperature=away_temp) + self.set_temperature(temperature=away_temp, hold_changed=True) def turn_away_mode_off(self): """Turn away off.""" self._away = False - self.set_temperature(temperature=self._prev_temp) + self.set_temperature(temperature=self._prev_temp, hold_changed=True) From f2dea4615f60f624108a697340e97eaa16e19612 Mon Sep 17 00:00:00 2001 From: Rendili <30532082+Rendili@users.noreply.github.com> Date: Thu, 23 Nov 2017 12:10:23 +0000 Subject: [PATCH 132/246] New Hive Component / Platforms (#9804) * New Hive Component / Platforms * New Hive Component / Platforms * New Hive Component / Platforms * New Hive Component / Platforms * New Hive Component / Platforms * New Hive Component / Platforms * New Hive Component / Platforms * New Hive Component / Platforms * New Hive Component / Platforms * New Hive Component / Platforms * New Hive Component / Platforms * New Hive Component / Platforms * New Hive Component / Platforms * New Hive Component / Platforms * Changes * Changes * Changes * changes * Updates * Updates * Updates * Updates * Updates * Updates * Sensor code updates * Sensor code updates * Move sensors to binary sensors * Quack * Updates - Removed climate related sensors * sensor fix * binary_sensor updates * New Hive Component / Platforms * New Hive Component / Platforms * New Hive Component / Platforms --- .coveragerc | 3 + .../components/binary_sensor/hive.py | 63 +++++++++ homeassistant/components/climate/hive.py | 132 ++++++++++++++++++ homeassistant/components/hive.py | 80 +++++++++++ homeassistant/components/light/hive.py | 126 +++++++++++++++++ homeassistant/components/sensor/hive.py | 52 +++++++ homeassistant/components/switch/hive.py | 69 +++++++++ requirements_all.txt | 3 + 8 files changed, 528 insertions(+) create mode 100644 homeassistant/components/binary_sensor/hive.py create mode 100644 homeassistant/components/climate/hive.py create mode 100644 homeassistant/components/hive.py create mode 100644 homeassistant/components/light/hive.py create mode 100644 homeassistant/components/sensor/hive.py create mode 100644 homeassistant/components/switch/hive.py diff --git a/.coveragerc b/.coveragerc index dd3874a9ffd..f609b5cb053 100644 --- a/.coveragerc +++ b/.coveragerc @@ -80,6 +80,9 @@ omit = homeassistant/components/hdmi_cec.py homeassistant/components/*/hdmi_cec.py + homeassistant/components/hive.py + homeassistant/components/*/hive.py + homeassistant/components/homematic.py homeassistant/components/*/homematic.py diff --git a/homeassistant/components/binary_sensor/hive.py b/homeassistant/components/binary_sensor/hive.py new file mode 100644 index 00000000000..b62c003c4fd --- /dev/null +++ b/homeassistant/components/binary_sensor/hive.py @@ -0,0 +1,63 @@ +""" +Support for the Hive devices. + +For more details about this platform, please refer to the documentation at +https://home-assistant.io/components/binary_sensor.hive/ +""" +from homeassistant.components.binary_sensor import BinarySensorDevice +from homeassistant.components.hive import DATA_HIVE + +DEPENDENCIES = ['hive'] + +DEVICETYPE_DEVICE_CLASS = {'motionsensor': 'motion', + 'contactsensor': 'opening'} + + +def setup_platform(hass, config, add_devices, discovery_info=None): + """Set up Hive sensor devices.""" + if discovery_info is None: + return + session = hass.data.get(DATA_HIVE) + + add_devices([HiveBinarySensorEntity(session, discovery_info)]) + + +class HiveBinarySensorEntity(BinarySensorDevice): + """Representation of a Hive binary sensor.""" + + def __init__(self, hivesession, hivedevice): + """Initialize the hive sensor.""" + self.node_id = hivedevice["Hive_NodeID"] + self.node_name = hivedevice["Hive_NodeName"] + self.device_type = hivedevice["HA_DeviceType"] + self.node_device_type = hivedevice["Hive_DeviceType"] + self.session = hivesession + self.data_updatesource = '{}.{}'.format(self.device_type, + self.node_id) + + self.session.entities.append(self) + + def handle_update(self, updatesource): + """Handle the new update request.""" + if '{}.{}'.format(self.device_type, self.node_id) not in updatesource: + self.schedule_update_ha_state() + + @property + def device_class(self): + """Return the class of this sensor.""" + return DEVICETYPE_DEVICE_CLASS.get(self.node_device_type) + + @property + def name(self): + """Return the name of the binary sensor.""" + return self.node_name + + @property + def is_on(self): + """Return true if the binary sensor is on.""" + return self.session.sensor.get_state(self.node_id, + self.node_device_type) + + def update(self): + """Update all Node data frome Hive.""" + self.session.core.update_data(self.node_id) diff --git a/homeassistant/components/climate/hive.py b/homeassistant/components/climate/hive.py new file mode 100644 index 00000000000..18833558b44 --- /dev/null +++ b/homeassistant/components/climate/hive.py @@ -0,0 +1,132 @@ +""" +Support for the Hive devices. + +For more details about this platform, please refer to the documentation at +https://home-assistant.io/components/climate.hive/ +""" +from homeassistant.components.climate import (ClimateDevice, + STATE_AUTO, STATE_HEAT, + STATE_OFF, STATE_ON) +from homeassistant.const import ATTR_TEMPERATURE, TEMP_CELSIUS +from homeassistant.components.hive import DATA_HIVE + +DEPENDENCIES = ['hive'] +HIVE_TO_HASS_STATE = {'SCHEDULE': STATE_AUTO, 'MANUAL': STATE_HEAT, + 'ON': STATE_ON, 'OFF': STATE_OFF} +HASS_TO_HIVE_STATE = {STATE_AUTO: 'SCHEDULE', STATE_HEAT: 'MANUAL', + STATE_ON: 'ON', STATE_OFF: 'OFF'} + + +def setup_platform(hass, config, add_devices, discovery_info=None): + """Set up Hive climate devices.""" + if discovery_info is None: + return + session = hass.data.get(DATA_HIVE) + + add_devices([HiveClimateEntity(session, discovery_info)]) + + +class HiveClimateEntity(ClimateDevice): + """Hive Climate Device.""" + + def __init__(self, hivesession, hivedevice): + """Initialize the Climate device.""" + self.node_id = hivedevice["Hive_NodeID"] + self.node_name = hivedevice["Hive_NodeName"] + self.device_type = hivedevice["HA_DeviceType"] + self.session = hivesession + self.data_updatesource = '{}.{}'.format(self.device_type, + self.node_id) + + if self.device_type == "Heating": + self.modes = [STATE_AUTO, STATE_HEAT, STATE_OFF] + elif self.device_type == "HotWater": + self.modes = [STATE_AUTO, STATE_ON, STATE_OFF] + + self.session.entities.append(self) + + def handle_update(self, updatesource): + """Handle the new update request.""" + if '{}.{}'.format(self.device_type, self.node_id) not in updatesource: + self.schedule_update_ha_state() + + @property + def name(self): + """Return the name of the Climate device.""" + friendly_name = "Climate Device" + if self.device_type == "Heating": + friendly_name = "Heating" + if self.node_name is not None: + friendly_name = '{} {}'.format(self.node_name, friendly_name) + elif self.device_type == "HotWater": + friendly_name = "Hot Water" + return friendly_name + + @property + def temperature_unit(self): + """Return the unit of measurement.""" + return TEMP_CELSIUS + + @property + def current_temperature(self): + """Return the current temperature.""" + if self.device_type == "Heating": + return self.session.heating.current_temperature(self.node_id) + + @property + def target_temperature(self): + """Return the target temperature.""" + if self.device_type == "Heating": + return self.session.heating.get_target_temperature(self.node_id) + + @property + def min_temp(self): + """Return minimum temperature.""" + if self.device_type == "Heating": + return self.session.heating.min_temperature(self.node_id) + + @property + def max_temp(self): + """Return the maximum temperature.""" + if self.device_type == "Heating": + return self.session.heating.max_temperature(self.node_id) + + @property + def operation_list(self): + """List of the operation modes.""" + return self.modes + + @property + def current_operation(self): + """Return current mode.""" + if self.device_type == "Heating": + currentmode = self.session.heating.get_mode(self.node_id) + elif self.device_type == "HotWater": + currentmode = self.session.hotwater.get_mode(self.node_id) + return HIVE_TO_HASS_STATE.get(currentmode) + + def set_operation_mode(self, operation_mode): + """Set new Heating mode.""" + new_mode = HASS_TO_HIVE_STATE.get(operation_mode) + if self.device_type == "Heating": + self.session.heating.set_mode(self.node_id, new_mode) + elif self.device_type == "HotWater": + self.session.hotwater.set_mode(self.node_id, new_mode) + + for entity in self.session.entities: + entity.handle_update(self.data_updatesource) + + def set_temperature(self, **kwargs): + """Set new target temperature.""" + new_temperature = kwargs.get(ATTR_TEMPERATURE) + if new_temperature is not None: + if self.device_type == "Heating": + self.session.heating.set_target_temperature(self.node_id, + new_temperature) + + for entity in self.session.entities: + entity.handle_update(self.data_updatesource) + + def update(self): + """Update all Node data frome Hive.""" + self.session.core.update_data(self.node_id) diff --git a/homeassistant/components/hive.py b/homeassistant/components/hive.py new file mode 100644 index 00000000000..277800502c1 --- /dev/null +++ b/homeassistant/components/hive.py @@ -0,0 +1,80 @@ +""" +Support for the Hive devices. + +For more details about this platform, please refer to the documentation at +https://home-assistant.io/components/hive/ +""" +import logging +import voluptuous as vol + +from homeassistant.const import (CONF_PASSWORD, CONF_SCAN_INTERVAL, + CONF_USERNAME) +import homeassistant.helpers.config_validation as cv +from homeassistant.helpers.discovery import load_platform + +REQUIREMENTS = ['pyhiveapi==0.2.5'] + +_LOGGER = logging.getLogger(__name__) +DOMAIN = 'hive' +DATA_HIVE = 'data_hive' +DEVICETYPES = { + 'binary_sensor': 'device_list_binary_sensor', + 'climate': 'device_list_climate', + 'light': 'device_list_light', + 'switch': 'device_list_plug', + 'sensor': 'device_list_sensor', + } + +CONFIG_SCHEMA = vol.Schema({ + DOMAIN: vol.Schema({ + vol.Required(CONF_PASSWORD): cv.string, + vol.Required(CONF_USERNAME): cv.string, + vol.Optional(CONF_SCAN_INTERVAL, default=2): cv.positive_int, + }) +}, extra=vol.ALLOW_EXTRA) + + +class HiveSession: + """Initiate Hive Session Class.""" + + entities = [] + core = None + heating = None + hotwater = None + light = None + sensor = None + switch = None + + +def setup(hass, config): + """Set up the Hive Component.""" + from pyhiveapi import Pyhiveapi + + session = HiveSession() + session.core = Pyhiveapi() + + username = config[DOMAIN][CONF_USERNAME] + password = config[DOMAIN][CONF_PASSWORD] + update_interval = config[DOMAIN][CONF_SCAN_INTERVAL] + + devicelist = session.core.initialise_api(username, + password, + update_interval) + + if devicelist is None: + _LOGGER.error("Hive API initialization failed") + return False + + session.sensor = Pyhiveapi.Sensor() + session.heating = Pyhiveapi.Heating() + session.hotwater = Pyhiveapi.Hotwater() + session.light = Pyhiveapi.Light() + session.switch = Pyhiveapi.Switch() + hass.data[DATA_HIVE] = session + + for ha_type, hive_type in DEVICETYPES.items(): + for key, devices in devicelist.items(): + if key == hive_type: + for hivedevice in devices: + load_platform(hass, ha_type, DOMAIN, hivedevice, config) + return True diff --git a/homeassistant/components/light/hive.py b/homeassistant/components/light/hive.py new file mode 100644 index 00000000000..95bd0b6988d --- /dev/null +++ b/homeassistant/components/light/hive.py @@ -0,0 +1,126 @@ +""" +Support for the Hive devices. + +For more details about this platform, please refer to the documentation at +https://home-assistant.io/components/light.hive/ +""" +from homeassistant.components.hive import DATA_HIVE +from homeassistant.components.light import (ATTR_BRIGHTNESS, ATTR_COLOR_TEMP, + SUPPORT_BRIGHTNESS, + SUPPORT_COLOR_TEMP, + SUPPORT_RGB_COLOR, Light) + +DEPENDENCIES = ['hive'] + + +def setup_platform(hass, config, add_devices, discovery_info=None): + """Set up Hive light devices.""" + if discovery_info is None: + return + session = hass.data.get(DATA_HIVE) + + add_devices([HiveDeviceLight(session, discovery_info)]) + + +class HiveDeviceLight(Light): + """Hive Active Light Device.""" + + def __init__(self, hivesession, hivedevice): + """Initialize the Light device.""" + self.node_id = hivedevice["Hive_NodeID"] + self.node_name = hivedevice["Hive_NodeName"] + self.device_type = hivedevice["HA_DeviceType"] + self.light_device_type = hivedevice["Hive_Light_DeviceType"] + self.session = hivesession + self.data_updatesource = '{}.{}'.format(self.device_type, + self.node_id) + self.session.entities.append(self) + + def handle_update(self, updatesource): + """Handle the new update request.""" + if '{}.{}'.format(self.device_type, self.node_id) not in updatesource: + self.schedule_update_ha_state() + + @property + def name(self): + """Return the display name of this light.""" + return self.node_name + + @property + def min_mireds(self): + """Return the coldest color_temp that this light supports.""" + if self.light_device_type == "tuneablelight" \ + or self.light_device_type == "colourtuneablelight": + return self.session.light.get_min_colour_temp(self.node_id) + + @property + def max_mireds(self): + """Return the warmest color_temp that this light supports.""" + if self.light_device_type == "tuneablelight" \ + or self.light_device_type == "colourtuneablelight": + return self.session.light.get_max_colour_temp(self.node_id) + + @property + def color_temp(self): + """Return the CT color value in mireds.""" + if self.light_device_type == "tuneablelight" \ + or self.light_device_type == "colourtuneablelight": + return self.session.light.get_color_temp(self.node_id) + + @property + def brightness(self): + """Brightness of the light (an integer in the range 1-255).""" + return self.session.light.get_brightness(self.node_id) + + @property + def is_on(self): + """Return true if light is on.""" + return self.session.light.get_state(self.node_id) + + def turn_on(self, **kwargs): + """Instruct the light to turn on.""" + new_brightness = None + new_color_temp = None + if ATTR_BRIGHTNESS in kwargs: + tmp_new_brightness = kwargs.get(ATTR_BRIGHTNESS) + percentage_brightness = ((tmp_new_brightness / 255) * 100) + new_brightness = int(round(percentage_brightness / 5.0) * 5.0) + if new_brightness == 0: + new_brightness = 5 + if ATTR_COLOR_TEMP in kwargs: + tmp_new_color_temp = kwargs.get(ATTR_COLOR_TEMP) + new_color_temp = round(1000000 / tmp_new_color_temp) + + if new_brightness is not None: + self.session.light.set_brightness(self.node_id, new_brightness) + elif new_color_temp is not None: + self.session.light.set_colour_temp(self.node_id, new_color_temp) + else: + self.session.light.turn_on(self.node_id) + + for entity in self.session.entities: + entity.handle_update(self.data_updatesource) + + def turn_off(self): + """Instruct the light to turn off.""" + self.session.light.turn_off(self.node_id) + for entity in self.session.entities: + entity.handle_update(self.data_updatesource) + + @property + def supported_features(self): + """Flag supported features.""" + supported_features = None + if self.light_device_type == "warmwhitelight": + supported_features = SUPPORT_BRIGHTNESS + elif self.light_device_type == "tuneablelight": + supported_features = (SUPPORT_BRIGHTNESS | SUPPORT_COLOR_TEMP) + elif self.light_device_type == "colourtuneablelight": + supported_features = ( + SUPPORT_BRIGHTNESS | SUPPORT_COLOR_TEMP | SUPPORT_RGB_COLOR) + + return supported_features + + def update(self): + """Update all Node data frome Hive.""" + self.session.core.update_data(self.node_id) diff --git a/homeassistant/components/sensor/hive.py b/homeassistant/components/sensor/hive.py new file mode 100644 index 00000000000..ce07dfdda5a --- /dev/null +++ b/homeassistant/components/sensor/hive.py @@ -0,0 +1,52 @@ +""" +Support for the Hive devices. + +For more details about this platform, please refer to the documentation at +https://home-assistant.io/components/sensor.hive/ +""" +from homeassistant.components.hive import DATA_HIVE +from homeassistant.helpers.entity import Entity + +DEPENDENCIES = ['hive'] + + +def setup_platform(hass, config, add_devices, discovery_info=None): + """Set up Hive sensor devices.""" + if discovery_info is None: + return + session = hass.data.get(DATA_HIVE) + + if discovery_info["HA_DeviceType"] == "Hub_OnlineStatus": + add_devices([HiveSensorEntity(session, discovery_info)]) + + +class HiveSensorEntity(Entity): + """Hive Sensor Entity.""" + + def __init__(self, hivesession, hivedevice): + """Initialize the sensor.""" + self.node_id = hivedevice["Hive_NodeID"] + self.device_type = hivedevice["HA_DeviceType"] + self.session = hivesession + self.data_updatesource = '{}.{}'.format(self.device_type, + self.node_id) + self.session.entities.append(self) + + def handle_update(self, updatesource): + """Handle the new update request.""" + if '{}.{}'.format(self.device_type, self.node_id) not in updatesource: + self.schedule_update_ha_state() + + @property + def name(self): + """Return the name of the sensor.""" + return "Hive hub status" + + @property + def state(self): + """Return the state of the sensor.""" + return self.session.sensor.hub_online_status(self.node_id) + + def update(self): + """Update all Node data frome Hive.""" + self.session.core.update_data(self.node_id) diff --git a/homeassistant/components/switch/hive.py b/homeassistant/components/switch/hive.py new file mode 100644 index 00000000000..d77247a5c04 --- /dev/null +++ b/homeassistant/components/switch/hive.py @@ -0,0 +1,69 @@ +""" +Support for the Hive devices. + +For more details about this platform, please refer to the documentation at +https://home-assistant.io/components/switch.hive/ +""" +from homeassistant.components.switch import SwitchDevice +from homeassistant.components.hive import DATA_HIVE + +DEPENDENCIES = ['hive'] + + +def setup_platform(hass, config, add_devices, discovery_info=None): + """Set up Hive switches.""" + if discovery_info is None: + return + session = hass.data.get(DATA_HIVE) + + add_devices([HiveDevicePlug(session, discovery_info)]) + + +class HiveDevicePlug(SwitchDevice): + """Hive Active Plug.""" + + def __init__(self, hivesession, hivedevice): + """Initialize the Switch device.""" + self.node_id = hivedevice["Hive_NodeID"] + self.node_name = hivedevice["Hive_NodeName"] + self.device_type = hivedevice["HA_DeviceType"] + self.session = hivesession + self.data_updatesource = '{}.{}'.format(self.device_type, + self.node_id) + self.session.entities.append(self) + + def handle_update(self, updatesource): + """Handle the new update request.""" + if '{}.{}'.format(self.device_type, self.node_id) not in updatesource: + self.schedule_update_ha_state() + + @property + def name(self): + """Return the name of this Switch device if any.""" + return self.node_name + + @property + def current_power_w(self): + """Return the current power usage in W.""" + return self.session.switch.get_power_usage(self.node_id) + + @property + def is_on(self): + """Return true if switch is on.""" + return self.session.switch.get_state(self.node_id) + + def turn_on(self, **kwargs): + """Turn the switch on.""" + self.session.switch.turn_on(self.node_id) + for entity in self.session.entities: + entity.handle_update(self.data_updatesource) + + def turn_off(self, **kwargs): + """Turn the device off.""" + self.session.switch.turn_off(self.node_id) + for entity in self.session.entities: + entity.handle_update(self.data_updatesource) + + def update(self): + """Update all Node data frome Hive.""" + self.session.core.update_data(self.node_id) diff --git a/requirements_all.txt b/requirements_all.txt index cff019312ef..7ec77dffcf7 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -667,6 +667,9 @@ pyharmony==1.0.18 # homeassistant.components.binary_sensor.hikvision pyhik==0.1.4 +# homeassistant.components.hive +pyhiveapi==0.2.5 + # homeassistant.components.homematic pyhomematic==0.1.34 From 47183ce02ea063ae48095ecab2dd8b62fbef6858 Mon Sep 17 00:00:00 2001 From: cgtobi Date: Thu, 23 Nov 2017 21:45:56 +0100 Subject: [PATCH 133/246] Temporarily fix yahoo weather API issue and add unit test. (#10737) * Temporarily fix yahoo weather API issue and add unit test. * Add test data. --- .coveragerc | 1 - homeassistant/components/sensor/yweather.py | 8 +- tests/components/sensor/test_yweather.py | 247 ++++++++++++++++++++ tests/fixtures/yahooweather.json | 138 +++++++++++ 4 files changed, 390 insertions(+), 4 deletions(-) create mode 100644 tests/components/sensor/test_yweather.py create mode 100644 tests/fixtures/yahooweather.json diff --git a/.coveragerc b/.coveragerc index f609b5cb053..1a8d8efc4ec 100644 --- a/.coveragerc +++ b/.coveragerc @@ -594,7 +594,6 @@ omit = homeassistant/components/sensor/worldtidesinfo.py homeassistant/components/sensor/worxlandroid.py homeassistant/components/sensor/xbox_live.py - homeassistant/components/sensor/yweather.py homeassistant/components/sensor/zamg.py homeassistant/components/shiftr.py homeassistant/components/spc.py diff --git a/homeassistant/components/sensor/yweather.py b/homeassistant/components/sensor/yweather.py index 873e27975db..846b221d5e3 100644 --- a/homeassistant/components/sensor/yweather.py +++ b/homeassistant/components/sensor/yweather.py @@ -160,13 +160,15 @@ class YahooWeatherSensor(Entity): self._code = self._data.yahoo.Forecast[self._forecast]['code'] self._state = self._data.yahoo.Forecast[self._forecast]['high'] elif self._type == 'wind_speed': - self._state = self._data.yahoo.Wind['speed'] + self._state = round(float(self._data.yahoo.Wind['speed'])/1.61, 2) elif self._type == 'humidity': self._state = self._data.yahoo.Atmosphere['humidity'] elif self._type == 'pressure': - self._state = self._data.yahoo.Atmosphere['pressure'] + self._state = round( + float(self._data.yahoo.Atmosphere['pressure'])/33.8637526, 2) elif self._type == 'visibility': - self._state = self._data.yahoo.Atmosphere['visibility'] + self._state = round( + float(self._data.yahoo.Atmosphere['visibility'])/1.61, 2) class YahooWeatherData(object): diff --git a/tests/components/sensor/test_yweather.py b/tests/components/sensor/test_yweather.py new file mode 100644 index 00000000000..88b94906a35 --- /dev/null +++ b/tests/components/sensor/test_yweather.py @@ -0,0 +1,247 @@ +"""The tests for the Yahoo weather sensor component.""" +import json + +import unittest +from unittest.mock import patch + +from homeassistant.setup import setup_component + +from tests.common import (get_test_home_assistant, load_fixture, + MockDependency) + +VALID_CONFIG_MINIMAL = { + 'sensor': { + 'platform': 'yweather', + 'monitored_conditions': [ + 'weather', + ], + } +} + +VALID_CONFIG_ALL = { + 'sensor': { + 'platform': 'yweather', + 'monitored_conditions': [ + 'weather', + 'weather_current', + 'temperature', + 'temp_min', + 'temp_max', + 'wind_speed', + 'pressure', + 'visibility', + 'humidity', + ], + } +} + +BAD_CONF_RAW = { + 'sensor': { + 'platform': 'yweather', + 'woeid': '12345', + 'monitored_conditions': [ + 'weather', + ], + } +} + +BAD_CONF_DATA = { + 'sensor': { + 'platform': 'yweather', + 'woeid': '111', + 'monitored_conditions': [ + 'weather', + ], + } +} + + +def _yql_queryMock(yql): # pylint: disable=invalid-name + """Mock yahoo query language query.""" + return ('{"query": {"count": 1, "created": "2017-11-17T13:40:47Z", ' + '"lang": "en-US", "results": {"place": {"woeid": "23511632"}}}}') + + +def get_woeidMock(lat, lon): # pylint: disable=invalid-name + """Mock get woeid Where On Earth Identifiers.""" + return '23511632' + + +def get_woeidNoneMock(lat, lon): # pylint: disable=invalid-name + """Mock get woeid Where On Earth Identifiers.""" + return None + + +class YahooWeatherMock(): + """Mock class for the YahooWeather object.""" + + def __init__(self, woeid, temp_unit): + """Initialize Telnet object.""" + self.woeid = woeid + self.temp_unit = temp_unit + self._data = json.loads(load_fixture('yahooweather.json')) + + # pylint: disable=no-self-use + def updateWeather(self): # pylint: disable=invalid-name + """Return sample values.""" + return True + + @property + def RawData(self): # pylint: disable=invalid-name + """Raw Data.""" + if self.woeid == '12345': + return json.loads('[]') + return self._data + + @property + def Units(self): # pylint: disable=invalid-name + """Return dict with units.""" + return self._data['query']['results']['channel']['units'] + + @property + def Now(self): # pylint: disable=invalid-name + """Current weather data.""" + if self.woeid == '111': + raise ValueError + return self._data['query']['results']['channel']['item']['condition'] + + @property + def Atmosphere(self): # pylint: disable=invalid-name + """Atmosphere weather data.""" + return self._data['query']['results']['channel']['atmosphere'] + + @property + def Wind(self): # pylint: disable=invalid-name + """Wind weather data.""" + return self._data['query']['results']['channel']['wind'] + + @property + def Forecast(self): # pylint: disable=invalid-name + """Forecast data 0-5 Days.""" + return self._data['query']['results']['channel']['item']['forecast'] + + def getWeatherImage(self, code): # pylint: disable=invalid-name + """Create a link to weather image from yahoo code.""" + return "https://l.yimg.com/a/i/us/we/52/{}.gif".format(code) + + +class TestWeather(unittest.TestCase): + """Test the Yahoo weather component.""" + + def setUp(self): + """Setup things to be run when tests are started.""" + self.hass = get_test_home_assistant() + + def tearDown(self): + """Stop down everything that was started.""" + self.hass.stop() + + @MockDependency('yahooweather') + @patch('yahooweather._yql_query', new=_yql_queryMock) + @patch('yahooweather.get_woeid', new=get_woeidMock) + @patch('yahooweather.YahooWeather', new=YahooWeatherMock) + def test_setup_minimal(self, mock_yahooweather): + """Test for minimal weather sensor config.""" + assert setup_component(self.hass, 'sensor', VALID_CONFIG_MINIMAL) + + state = self.hass.states.get('sensor.yweather_condition') + assert state is not None + + assert state.state == 'Mostly Cloudy' + self.assertEqual(state.attributes.get('friendly_name'), + 'Yweather Condition') + + @MockDependency('yahooweather') + @patch('yahooweather._yql_query', new=_yql_queryMock) + @patch('yahooweather.get_woeid', new=get_woeidMock) + @patch('yahooweather.YahooWeather', new=YahooWeatherMock) + def test_setup_all(self, mock_yahooweather): + """Test for all weather data attributes.""" + assert setup_component(self.hass, 'sensor', VALID_CONFIG_ALL) + + state = self.hass.states.get('sensor.yweather_condition') + assert state is not None + self.assertEqual(state.state, 'Mostly Cloudy') + self.assertEqual(state.attributes.get('friendly_name'), + 'Yweather Condition') + + state = self.hass.states.get('sensor.yweather_current') + assert state is not None + self.assertEqual(state.state, 'Cloudy') + self.assertEqual(state.attributes.get('friendly_name'), + 'Yweather Current') + + state = self.hass.states.get('sensor.yweather_temperature') + assert state is not None + self.assertEqual(state.state, '18') + self.assertEqual(state.attributes.get('friendly_name'), + 'Yweather Temperature') + + state = self.hass.states.get('sensor.yweather_temperature_max') + assert state is not None + self.assertEqual(state.state, '23') + self.assertEqual(state.attributes.get('friendly_name'), + 'Yweather Temperature max') + + state = self.hass.states.get('sensor.yweather_temperature_min') + assert state is not None + self.assertEqual(state.state, '16') + self.assertEqual(state.attributes.get('friendly_name'), + 'Yweather Temperature min') + + state = self.hass.states.get('sensor.yweather_wind_speed') + assert state is not None + self.assertEqual(state.state, '3.94') + self.assertEqual(state.attributes.get('friendly_name'), + 'Yweather Wind speed') + + state = self.hass.states.get('sensor.yweather_pressure') + assert state is not None + self.assertEqual(state.state, '1000.0') + self.assertEqual(state.attributes.get('friendly_name'), + 'Yweather Pressure') + + state = self.hass.states.get('sensor.yweather_visibility') + assert state is not None + self.assertEqual(state.state, '14.23') + self.assertEqual(state.attributes.get('friendly_name'), + 'Yweather Visibility') + + state = self.hass.states.get('sensor.yweather_humidity') + assert state is not None + self.assertEqual(state.state, '71') + self.assertEqual(state.attributes.get('friendly_name'), + 'Yweather Humidity') + + @MockDependency('yahooweather') + @patch('yahooweather._yql_query', new=_yql_queryMock) + @patch('yahooweather.get_woeid', new=get_woeidNoneMock) + @patch('yahooweather.YahooWeather', new=YahooWeatherMock) + def test_setup_bad_woied(self, mock_yahooweather): + """Test for bad woeid.""" + assert setup_component(self.hass, 'sensor', VALID_CONFIG_MINIMAL) + + state = self.hass.states.get('sensor.yweather_condition') + assert state is None + + @MockDependency('yahooweather') + @patch('yahooweather._yql_query', new=_yql_queryMock) + @patch('yahooweather.get_woeid', new=get_woeidMock) + @patch('yahooweather.YahooWeather', new=YahooWeatherMock) + def test_setup_bad_raw(self, mock_yahooweather): + """Test for bad RawData.""" + assert setup_component(self.hass, 'sensor', BAD_CONF_RAW) + + state = self.hass.states.get('sensor.yweather_condition') + assert state is not None + + @MockDependency('yahooweather') + @patch('yahooweather._yql_query', new=_yql_queryMock) + @patch('yahooweather.get_woeid', new=get_woeidMock) + @patch('yahooweather.YahooWeather', new=YahooWeatherMock) + def test_setup_bad_data(self, mock_yahooweather): + """Test for bad data.""" + assert setup_component(self.hass, 'sensor', BAD_CONF_DATA) + + state = self.hass.states.get('sensor.yweather_condition') + assert state is None diff --git a/tests/fixtures/yahooweather.json b/tests/fixtures/yahooweather.json new file mode 100644 index 00000000000..f6ab2980618 --- /dev/null +++ b/tests/fixtures/yahooweather.json @@ -0,0 +1,138 @@ +{ + "query": { + "count": 1, + "created": "2017-11-17T13:40:47Z", + "lang": "en-US", + "results": { + "channel": { + "units": { + "distance": "km", + "pressure": "mb", + "speed": "km/h", + "temperature": "C" + }, + "title": "Yahoo! Weather - San Diego, CA, US", + "link": "http://us.rd.yahoo.com/dailynews/rss/weather/Country__Country/*https://weather.yahoo.com/country/state/city-23511632/", + "description": "Yahoo! Weather for San Diego, CA, US", + "language": "en-us", + "lastBuildDate": "Fri, 17 Nov 2017 05:40 AM PST", + "ttl": "60", + "location": { + "city": "San Diego", + "country": "United States", + "region": " CA" + }, + "wind": { + "chill": "56", + "direction": "0", + "speed": "6.34" + }, + "atmosphere": { + "humidity": "71", + "pressure": "33863.75", + "rising": "0", + "visibility": "22.91" + }, + "astronomy": { + "sunrise": "6:21 am", + "sunset": "4:47 pm" + }, + "image": { + "title": "Yahoo! Weather", + "width": "142", + "height": "18", + "link": "http://weather.yahoo.com", + "url": "http://l.yimg.com/a/i/brand/purplelogo//uh/us/news-wea.gif" + }, + "item": { + "title": "Conditions for San Diego, CA, US at 05:00 AM PST", + "lat": "32.878101", + "long": "-117.23497", + "link": "http://us.rd.yahoo.com/dailynews/rss/weather/Country__Country/*https://weather.yahoo.com/country/state/city-23511632/", + "pubDate": "Fri, 17 Nov 2017 05:00 AM PST", + "condition": { + "code": "26", + "date": "Fri, 17 Nov 2017 05:00 AM PST", + "temp": "18", + "text": "Cloudy" + }, + "forecast": [{ + "code": "28", + "date": "17 Nov 2017", + "day": "Fri", + "high": "23", + "low": "16", + "text": "Mostly Cloudy" + }, { + "code": "30", + "date": "18 Nov 2017", + "day": "Sat", + "high": "22", + "low": "13", + "text": "Partly Cloudy" + }, { + "code": "30", + "date": "19 Nov 2017", + "day": "Sun", + "high": "22", + "low": "12", + "text": "Partly Cloudy" + }, { + "code": "28", + "date": "20 Nov 2017", + "day": "Mon", + "high": "21", + "low": "11", + "text": "Mostly Cloudy" + }, { + "code": "28", + "date": "21 Nov 2017", + "day": "Tue", + "high": "24", + "low": "14", + "text": "Mostly Cloudy" + }, { + "code": "30", + "date": "22 Nov 2017", + "day": "Wed", + "high": "27", + "low": "15", + "text": "Partly Cloudy" + }, { + "code": "34", + "date": "23 Nov 2017", + "day": "Thu", + "high": "27", + "low": "15", + "text": "Mostly Sunny" + }, { + "code": "30", + "date": "24 Nov 2017", + "day": "Fri", + "high": "23", + "low": "16", + "text": "Partly Cloudy" + }, { + "code": "30", + "date": "25 Nov 2017", + "day": "Sat", + "high": "22", + "low": "15", + "text": "Partly Cloudy" + }, { + "code": "28", + "date": "26 Nov 2017", + "day": "Sun", + "high": "24", + "low": "13", + "text": "Mostly Cloudy" + }], + "description": "\n
\nCurrent Conditions:\n
Cloudy\n
\n
\nForecast:\n
Fri - Mostly Cloudy. High: 23Low: 16\n
Sat - Partly Cloudy. High: 22Low: 13\n
Sun - Partly Cloudy. High: 22Low: 12\n
Mon - Mostly Cloudy. High: 21Low: 11\n
Tue - Mostly Cloudy. High: 24Low: 14\n
\n
\nFull Forecast at Yahoo! Weather\n
\n
\n
\n]]>", + "guid": { + "isPermaLink": "false" + } + } + } + } + } +} From 3ef9c9900308e2bbc2727bc659dd7733bedb1c2a Mon Sep 17 00:00:00 2001 From: braddparker Date: Thu, 23 Nov 2017 15:57:30 -0500 Subject: [PATCH 134/246] Google assistant climate mode fix (#10726) * Changed supported climate modes lookup to be case insensitive by forcing to lower-case * Fixed style errors. (Blank line and line too long) --- .../components/google_assistant/smart_home.py | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/homeassistant/components/google_assistant/smart_home.py b/homeassistant/components/google_assistant/smart_home.py index cd1583fb377..634d5074a0e 100644 --- a/homeassistant/components/google_assistant/smart_home.py +++ b/homeassistant/components/google_assistant/smart_home.py @@ -124,14 +124,15 @@ def entity_to_device(entity: Entity, units: UnitSystem): if entity.domain == climate.DOMAIN: modes = ','.join( - m for m in entity.attributes.get(climate.ATTR_OPERATION_LIST, []) - if m in CLIMATE_SUPPORTED_MODES) + m.lower() for m in entity.attributes.get( + climate.ATTR_OPERATION_LIST, []) + if m.lower() in CLIMATE_SUPPORTED_MODES) device['attributes'] = { 'availableThermostatModes': modes, 'thermostatTemperatureUnit': 'F' if units.temperature_unit == TEMP_FAHRENHEIT else 'C', } - + _LOGGER.debug('Thermostat attributes %s', device['attributes']) return device @@ -143,7 +144,7 @@ def query_device(entity: Entity, units: UnitSystem) -> dict: return None return round(METRIC_SYSTEM.temperature(deg, units.temperature_unit), 1) if entity.domain == climate.DOMAIN: - mode = entity.attributes.get(climate.ATTR_OPERATION_MODE) + mode = entity.attributes.get(climate.ATTR_OPERATION_MODE).lower() if mode not in CLIMATE_SUPPORTED_MODES: mode = 'on' response = { @@ -218,6 +219,7 @@ def determine_service( Attempt to return a tuple of service and service_data based on the entity and action requested. """ + _LOGGER.debug("Handling command %s with data %s", command, params) domain = entity_id.split('.')[0] service_data = {ATTR_ENTITY_ID: entity_id} # type: Dict[str, Any] # special media_player handling @@ -260,7 +262,6 @@ def determine_service( service_data['brightness'] = int(brightness / 100 * 255) return (SERVICE_TURN_ON, service_data) - _LOGGER.debug("Handling command %s with data %s", command, params) if command == COMMAND_COLOR: color_data = params.get('color') if color_data is not None: From 3dd49b2b95807453ee9a2f1baa81a061199cda80 Mon Sep 17 00:00:00 2001 From: Marcelo Moreira de Mello Date: Thu, 23 Nov 2017 19:38:53 -0500 Subject: [PATCH 135/246] Protect sensitive information for Amcrest cameras (#10569) * Creates a AmcresHub object to protect some private attributes on the logs * Uses hass.data to pass AmcrestHub to components * Prefer constants * Removed serializer since it's using hass.data and simplified camera entity constructor * small cleanup --- homeassistant/components/amcrest.py | 25 ++++++++++++---- homeassistant/components/camera/amcrest.py | 35 ++++++++-------------- homeassistant/components/sensor/amcrest.py | 13 ++++---- 3 files changed, 38 insertions(+), 35 deletions(-) diff --git a/homeassistant/components/amcrest.py b/homeassistant/components/amcrest.py index 157b9574a06..9205846462f 100644 --- a/homeassistant/components/amcrest.py +++ b/homeassistant/components/amcrest.py @@ -89,6 +89,7 @@ def setup(hass, config): """Set up the Amcrest IP Camera component.""" from amcrest import AmcrestCamera + hass.data[DATA_AMCREST] = {} amcrest_cams = config[DOMAIN] for device in amcrest_cams: @@ -126,22 +127,34 @@ def setup(hass, config): else: authentication = None + hass.data[DATA_AMCREST][name] = AmcrestDevice( + camera, name, authentication, ffmpeg_arguments, stream_source, + resolution) + discovery.load_platform( hass, 'camera', DOMAIN, { - 'device': camera, - CONF_AUTHENTICATION: authentication, - CONF_FFMPEG_ARGUMENTS: ffmpeg_arguments, CONF_NAME: name, - CONF_RESOLUTION: resolution, - CONF_STREAM_SOURCE: stream_source, }, config) if sensors: discovery.load_platform( hass, 'sensor', DOMAIN, { - 'device': camera, CONF_NAME: name, CONF_SENSORS: sensors, }, config) return True + + +class AmcrestDevice(object): + """Representation of a base Amcrest discovery device.""" + + def __init__(self, camera, name, authentication, ffmpeg_arguments, + stream_source, resolution): + """Initialize the entity.""" + self.device = camera + self.name = name + self.authentication = authentication + self.ffmpeg_arguments = ffmpeg_arguments + self.stream_source = stream_source + self.resolution = resolution diff --git a/homeassistant/components/camera/amcrest.py b/homeassistant/components/camera/amcrest.py index aba1bb08c93..3c63e56b319 100644 --- a/homeassistant/components/camera/amcrest.py +++ b/homeassistant/components/camera/amcrest.py @@ -8,9 +8,10 @@ import asyncio import logging from homeassistant.components.amcrest import ( - STREAM_SOURCE_LIST, TIMEOUT) + DATA_AMCREST, STREAM_SOURCE_LIST, TIMEOUT) from homeassistant.components.camera import Camera from homeassistant.components.ffmpeg import DATA_FFMPEG +from homeassistant.const import CONF_NAME from homeassistant.helpers.aiohttp_client import ( async_get_clientsession, async_aiohttp_proxy_web, async_aiohttp_proxy_stream) @@ -26,21 +27,10 @@ def async_setup_platform(hass, config, async_add_devices, discovery_info=None): if discovery_info is None: return - device = discovery_info['device'] - authentication = discovery_info['authentication'] - ffmpeg_arguments = discovery_info['ffmpeg_arguments'] - name = discovery_info['name'] - resolution = discovery_info['resolution'] - stream_source = discovery_info['stream_source'] + device_name = discovery_info[CONF_NAME] + amcrest = hass.data[DATA_AMCREST][device_name] - async_add_devices([ - AmcrestCam(hass, - name, - device, - authentication, - ffmpeg_arguments, - stream_source, - resolution)], True) + async_add_devices([AmcrestCam(hass, amcrest)], True) return True @@ -48,18 +38,17 @@ def async_setup_platform(hass, config, async_add_devices, discovery_info=None): class AmcrestCam(Camera): """An implementation of an Amcrest IP camera.""" - def __init__(self, hass, name, camera, authentication, - ffmpeg_arguments, stream_source, resolution): + def __init__(self, hass, amcrest): """Initialize an Amcrest camera.""" super(AmcrestCam, self).__init__() - self._name = name - self._camera = camera + self._name = amcrest.name + self._camera = amcrest.device self._base_url = self._camera.get_base_url() self._ffmpeg = hass.data[DATA_FFMPEG] - self._ffmpeg_arguments = ffmpeg_arguments - self._stream_source = stream_source - self._resolution = resolution - self._token = self._auth = authentication + self._ffmpeg_arguments = amcrest.ffmpeg_arguments + self._stream_source = amcrest.stream_source + self._resolution = amcrest.resolution + self._token = self._auth = amcrest.authentication def camera_image(self): """Return a still image response from the camera.""" diff --git a/homeassistant/components/sensor/amcrest.py b/homeassistant/components/sensor/amcrest.py index e7bf309c33a..99a4371f6a2 100644 --- a/homeassistant/components/sensor/amcrest.py +++ b/homeassistant/components/sensor/amcrest.py @@ -8,9 +8,9 @@ import asyncio from datetime import timedelta import logging -from homeassistant.components.amcrest import SENSORS +from homeassistant.components.amcrest import DATA_AMCREST, SENSORS from homeassistant.helpers.entity import Entity -from homeassistant.const import STATE_UNKNOWN +from homeassistant.const import CONF_NAME, CONF_SENSORS, STATE_UNKNOWN DEPENDENCIES = ['amcrest'] @@ -25,13 +25,14 @@ def async_setup_platform(hass, config, async_add_devices, discovery_info=None): if discovery_info is None: return - device = discovery_info['device'] - name = discovery_info['name'] - sensors = discovery_info['sensors'] + device_name = discovery_info[CONF_NAME] + sensors = discovery_info[CONF_SENSORS] + amcrest = hass.data[DATA_AMCREST][device_name] amcrest_sensors = [] for sensor_type in sensors: - amcrest_sensors.append(AmcrestSensor(name, device, sensor_type)) + amcrest_sensors.append( + AmcrestSensor(amcrest.name, amcrest.device, sensor_type)) async_add_devices(amcrest_sensors, True) return True From d0b9f08bf2721bf78602db6c17d8897e34f84488 Mon Sep 17 00:00:00 2001 From: Jan Losinski Date: Fri, 24 Nov 2017 01:58:18 +0100 Subject: [PATCH 136/246] InfluxDB send retry after IOError (#10263) * Implement data write retry for InfluxDB This adds an optional max_retries parameter to the InfluxDB component to specify if and how often the component should try to send the data if the connection failed due to an IOError. The sending will be scheduled for a retry in 20 seconds as often as the user specified. This can be handy for flaky getwork connections between the DB and Homeassistant or outages like daily DSL reconnects. Signed-off-by: Jan Losinski * Add unittest for influx write retries Signed-off-by: Jan Losinski * Add RetryOnError as helper decorator in util Signed-off-by: Jan Losinski * Add unittests for RetryOnError Signed-off-by: Jan Losinski * Use RetryOnError decorator in InfluxDB This replaces the scheduling logic in the InfluxDB component with the RetryOnError decorator from homeassistant.util Signed-off-by: Jan Losinski * Make the linters happy Signed-off-by: Jan Losinski * Implement a queue limit for the retry decorator. This adds a queue limit to the RetryOnError handler. It limits the number of calls waiting for be retried. If this number is exceeded, every new call will discard the oldest one in the queue. * influxdb: Add the retry queue limit option. * Make the linter happy. * Make pylint happy * Log exception of dropped retry * Move RetryOnError decorator to influxdb component. * Fix bug in logging usage * Fix imports * Add newlines at the end of files. * Remove blank line * Remove blank line --- homeassistant/components/influxdb.py | 90 ++++++++++++++ tests/components/test_influxdb.py | 170 ++++++++++++++++++++++++++- 2 files changed, 259 insertions(+), 1 deletion(-) diff --git a/homeassistant/components/influxdb.py b/homeassistant/components/influxdb.py index 55b0f08a711..d31d1e96431 100644 --- a/homeassistant/components/influxdb.py +++ b/homeassistant/components/influxdb.py @@ -4,6 +4,8 @@ A component which allows you to send data to an Influx database. For more details about this component, please refer to the documentation at https://home-assistant.io/components/influxdb/ """ +from datetime import timedelta +from functools import wraps, partial import logging import re @@ -16,6 +18,7 @@ from homeassistant.const import ( CONF_EXCLUDE, CONF_INCLUDE, CONF_DOMAINS, CONF_ENTITIES) from homeassistant.helpers import state as state_helper from homeassistant.helpers.entity_values import EntityValues +from homeassistant.util import utcnow import homeassistant.helpers.config_validation as cv REQUIREMENTS = ['influxdb==4.1.1'] @@ -30,6 +33,8 @@ CONF_TAGS_ATTRIBUTES = 'tags_attributes' CONF_COMPONENT_CONFIG = 'component_config' CONF_COMPONENT_CONFIG_GLOB = 'component_config_glob' CONF_COMPONENT_CONFIG_DOMAIN = 'component_config_domain' +CONF_RETRY_COUNT = 'max_retries' +CONF_RETRY_QUEUE = 'retry_queue_limit' DEFAULT_DATABASE = 'home_assistant' DEFAULT_VERIFY_SSL = True @@ -58,6 +63,8 @@ CONFIG_SCHEMA = vol.Schema({ vol.Optional(CONF_DB_NAME, default=DEFAULT_DATABASE): cv.string, vol.Optional(CONF_PORT): cv.port, vol.Optional(CONF_SSL): cv.boolean, + vol.Optional(CONF_RETRY_COUNT, default=0): cv.positive_int, + vol.Optional(CONF_RETRY_QUEUE, default=20): cv.positive_int, vol.Optional(CONF_DEFAULT_MEASUREMENT): cv.string, vol.Optional(CONF_OVERRIDE_MEASUREMENT): cv.string, vol.Optional(CONF_TAGS, default={}): @@ -119,6 +126,8 @@ def setup(hass, config): conf[CONF_COMPONENT_CONFIG], conf[CONF_COMPONENT_CONFIG_DOMAIN], conf[CONF_COMPONENT_CONFIG_GLOB]) + max_tries = conf.get(CONF_RETRY_COUNT) + queue_limit = conf.get(CONF_RETRY_QUEUE) try: influx = InfluxDBClient(**kwargs) @@ -213,6 +222,11 @@ def setup(hass, config): json_body[0]['tags'].update(tags) + _write_data(json_body) + + @RetryOnError(hass, retry_limit=max_tries, retry_delay=20, + queue_limit=queue_limit) + def _write_data(json_body): try: influx.write_points(json_body) except exceptions.InfluxDBClientError: @@ -221,3 +235,79 @@ def setup(hass, config): hass.bus.listen(EVENT_STATE_CHANGED, influx_event_listener) return True + + +class RetryOnError(object): + """A class for retrying a failed task a certain amount of tries. + + This method decorator makes a method retrying on errors. If there was an + uncaught exception, it schedules another try to execute the task after a + retry delay. It does this up to the maximum number of retries. + + It can be used for all probable "self-healing" problems like network + outages. The task will be rescheduled using HAs scheduling mechanism. + + It takes a Hass instance, a maximum number of retries and a retry delay + in seconds as arguments. + + The queue limit defines the maximum number of calls that are allowed to + be queued at a time. If this number is reached, every new call discards + an old one. + """ + + def __init__(self, hass, retry_limit=0, retry_delay=20, queue_limit=100): + """Initialize the decorator.""" + self.hass = hass + self.retry_limit = retry_limit + self.retry_delay = timedelta(seconds=retry_delay) + self.queue_limit = queue_limit + + def __call__(self, method): + """Decorate the target method.""" + from homeassistant.helpers.event import track_point_in_utc_time + + @wraps(method) + def wrapper(*args, **kwargs): + """Wrapped method.""" + # pylint: disable=protected-access + if not hasattr(wrapper, "_retry_queue"): + wrapper._retry_queue = [] + + def scheduled(retry=0, untrack=None, event=None): + """Call the target method. + + It is called directly at the first time and then called + scheduled within the Hass mainloop. + """ + if untrack is not None: + wrapper._retry_queue.remove(untrack) + + # pylint: disable=broad-except + try: + method(*args, **kwargs) + except Exception as ex: + if retry == self.retry_limit: + raise + if len(wrapper._retry_queue) >= self.queue_limit: + last = wrapper._retry_queue.pop(0) + if 'remove' in last: + func = last['remove'] + func() + if 'exc' in last: + _LOGGER.error( + "Retry queue overflow, drop oldest entry: %s", + str(last['exc'])) + + target = utcnow() + self.retry_delay + tracking = {'target': target} + remove = track_point_in_utc_time(self.hass, + partial(scheduled, + retry + 1, + tracking), + target) + tracking['remove'] = remove + tracking["exc"] = ex + wrapper._retry_queue.append(tracking) + + scheduled() + return wrapper diff --git a/tests/components/test_influxdb.py b/tests/components/test_influxdb.py index 6c52663051c..d768136592e 100644 --- a/tests/components/test_influxdb.py +++ b/tests/components/test_influxdb.py @@ -3,8 +3,13 @@ import unittest import datetime from unittest import mock +from datetime import timedelta +from unittest.mock import MagicMock + import influxdb as influx_client +from homeassistant.util import dt as dt_util +from homeassistant import core as ha from homeassistant.setup import setup_component import homeassistant.components.influxdb as influxdb from homeassistant.const import EVENT_STATE_CHANGED, STATE_OFF, STATE_ON, \ @@ -36,6 +41,7 @@ class TestInfluxDB(unittest.TestCase): 'database': 'db', 'username': 'user', 'password': 'password', + 'max_retries': 4, 'ssl': 'False', 'verify_ssl': 'False', } @@ -91,7 +97,7 @@ class TestInfluxDB(unittest.TestCase): influx_client.exceptions.InfluxDBClientError('fake') assert not setup_component(self.hass, influxdb.DOMAIN, config) - def _setup(self): + def _setup(self, **kwargs): """Setup the client.""" config = { 'influxdb': { @@ -104,6 +110,7 @@ class TestInfluxDB(unittest.TestCase): } } } + config['influxdb'].update(kwargs) assert setup_component(self.hass, influxdb.DOMAIN, config) self.handler_method = self.hass.bus.listen.call_args_list[0][0][1] @@ -649,3 +656,164 @@ class TestInfluxDB(unittest.TestCase): mock.call(body) ) mock_client.return_value.write_points.reset_mock() + + def test_scheduled_write(self, mock_client): + """Test the event listener to retry after write failures.""" + self._setup(max_retries=1) + + state = mock.MagicMock( + state=1, domain='fake', entity_id='entity.id', object_id='entity', + attributes={}) + event = mock.MagicMock(data={'new_state': state}, time_fired=12345) + mock_client.return_value.write_points.side_effect = \ + IOError('foo') + + start = dt_util.utcnow() + + self.handler_method(event) + json_data = mock_client.return_value.write_points.call_args[0][0] + self.assertEqual(mock_client.return_value.write_points.call_count, 1) + + shifted_time = start + (timedelta(seconds=20 + 1)) + self.hass.bus.fire(ha.EVENT_TIME_CHANGED, + {ha.ATTR_NOW: shifted_time}) + self.hass.block_till_done() + self.assertEqual(mock_client.return_value.write_points.call_count, 2) + mock_client.return_value.write_points.assert_called_with(json_data) + + shifted_time = shifted_time + (timedelta(seconds=20 + 1)) + self.hass.bus.fire(ha.EVENT_TIME_CHANGED, + {ha.ATTR_NOW: shifted_time}) + self.hass.block_till_done() + self.assertEqual(mock_client.return_value.write_points.call_count, 2) + + +class TestRetryOnErrorDecorator(unittest.TestCase): + """Test the RetryOnError decorator.""" + + def setUp(self): + """Setup things to be run when tests are started.""" + self.hass = get_test_home_assistant() + + def tearDown(self): + """Clear data.""" + self.hass.stop() + + def test_no_retry(self): + """Test that it does not retry if configured.""" + mock_method = MagicMock() + wrapped = influxdb.RetryOnError(self.hass)(mock_method) + wrapped(1, 2, test=3) + self.assertEqual(mock_method.call_count, 1) + mock_method.assert_called_with(1, 2, test=3) + + mock_method.side_effect = Exception() + self.assertRaises(Exception, wrapped, 1, 2, test=3) + self.assertEqual(mock_method.call_count, 2) + mock_method.assert_called_with(1, 2, test=3) + + def test_single_retry(self): + """Test that retry stops after a single try if configured.""" + mock_method = MagicMock() + retryer = influxdb.RetryOnError(self.hass, retry_limit=1) + wrapped = retryer(mock_method) + wrapped(1, 2, test=3) + self.assertEqual(mock_method.call_count, 1) + mock_method.assert_called_with(1, 2, test=3) + + start = dt_util.utcnow() + shifted_time = start + (timedelta(seconds=20 + 1)) + self.hass.bus.fire(ha.EVENT_TIME_CHANGED, + {ha.ATTR_NOW: shifted_time}) + self.hass.block_till_done() + self.assertEqual(mock_method.call_count, 1) + + mock_method.side_effect = Exception() + wrapped(1, 2, test=3) + self.assertEqual(mock_method.call_count, 2) + mock_method.assert_called_with(1, 2, test=3) + + for cnt in range(3): + start = dt_util.utcnow() + shifted_time = start + (timedelta(seconds=20 + 1)) + self.hass.bus.fire(ha.EVENT_TIME_CHANGED, + {ha.ATTR_NOW: shifted_time}) + self.hass.block_till_done() + self.assertEqual(mock_method.call_count, 3) + mock_method.assert_called_with(1, 2, test=3) + + def test_multi_retry(self): + """Test that multiple retries work.""" + mock_method = MagicMock() + retryer = influxdb.RetryOnError(self.hass, retry_limit=4) + wrapped = retryer(mock_method) + mock_method.side_effect = Exception() + + wrapped(1, 2, test=3) + self.assertEqual(mock_method.call_count, 1) + mock_method.assert_called_with(1, 2, test=3) + + for cnt in range(3): + start = dt_util.utcnow() + shifted_time = start + (timedelta(seconds=20 + 1)) + self.hass.bus.fire(ha.EVENT_TIME_CHANGED, + {ha.ATTR_NOW: shifted_time}) + self.hass.block_till_done() + self.assertEqual(mock_method.call_count, cnt + 2) + mock_method.assert_called_with(1, 2, test=3) + + def test_max_queue(self): + """Test the maximum queue length.""" + # make a wrapped method + mock_method = MagicMock() + retryer = influxdb.RetryOnError( + self.hass, retry_limit=4, queue_limit=3) + wrapped = retryer(mock_method) + mock_method.side_effect = Exception() + + # call it once, call fails, queue fills to 1 + wrapped(1, 2, test=3) + self.assertEqual(mock_method.call_count, 1) + mock_method.assert_called_with(1, 2, test=3) + self.assertEqual(len(wrapped._retry_queue), 1) + + # two more calls that failed. queue is 3 + wrapped(1, 2, test=3) + wrapped(1, 2, test=3) + self.assertEqual(mock_method.call_count, 3) + self.assertEqual(len(wrapped._retry_queue), 3) + + # another call, queue gets limited to 3 + wrapped(1, 2, test=3) + self.assertEqual(mock_method.call_count, 4) + self.assertEqual(len(wrapped._retry_queue), 3) + + # time passes + start = dt_util.utcnow() + shifted_time = start + (timedelta(seconds=20 + 1)) + self.hass.bus.fire(ha.EVENT_TIME_CHANGED, + {ha.ATTR_NOW: shifted_time}) + self.hass.block_till_done() + + # only the three queued calls where repeated + self.assertEqual(mock_method.call_count, 7) + self.assertEqual(len(wrapped._retry_queue), 3) + + # another call, queue stays limited + wrapped(1, 2, test=3) + self.assertEqual(mock_method.call_count, 8) + self.assertEqual(len(wrapped._retry_queue), 3) + + # disable the side effect + mock_method.side_effect = None + + # time passes, all calls should succeed + start = dt_util.utcnow() + shifted_time = start + (timedelta(seconds=20 + 1)) + self.hass.bus.fire(ha.EVENT_TIME_CHANGED, + {ha.ATTR_NOW: shifted_time}) + self.hass.block_till_done() + + # three queued calls succeeded, queue empty. + self.assertEqual(mock_method.call_count, 11) + self.assertEqual(len(wrapped._retry_queue), 0) From 1a7522a594aa9fb1de397248e75e86c9a7cde626 Mon Sep 17 00:00:00 2001 From: "Craig J. Ward" Date: Thu, 23 Nov 2017 19:21:24 -0600 Subject: [PATCH 137/246] Add Dominos Pizza platform (#10379) * add dominos service * change require * dump to log * component fixes * clean-up use updated library * remove unnecessary import * fix hound errors * more lint fixes * Coverage rc * update requirements * cleanup as per notes * missing message * linting... * schema validation and reducing requests * fixlint * spacing * unused variable * fix docstrings * update req * notes updates, pypi package, front-end panel * stale import * fix constant name * docstrings * fix library import * lint fixes * pylint bug * remove built-in panel * Make synchronous * unused import and use throttle * Handle exceptions properly and update client * Import exceptions properly * unused import * remove bloat from start-up, readability fixes from notes, retrieve menu on request, not on startup * whitespace on blank line --- .coveragerc | 3 +- homeassistant/components/dominos.py | 240 ++++++++++++++++++++++++++++ requirements_all.txt | 3 + 3 files changed, 245 insertions(+), 1 deletion(-) create mode 100644 homeassistant/components/dominos.py diff --git a/.coveragerc b/.coveragerc index 1a8d8efc4ec..af4d5b32a78 100644 --- a/.coveragerc +++ b/.coveragerc @@ -53,6 +53,8 @@ omit = homeassistant/components/digital_ocean.py homeassistant/components/*/digital_ocean.py + homeassistant/components/dominos.py + homeassistant/components/doorbird.py homeassistant/components/*/doorbird.py @@ -639,7 +641,6 @@ omit = homeassistant/components/zwave/util.py homeassistant/components/vacuum/mqtt.py - [report] # Regexes for lines to exclude from consideration exclude_lines = diff --git a/homeassistant/components/dominos.py b/homeassistant/components/dominos.py new file mode 100644 index 00000000000..867bdfafc6b --- /dev/null +++ b/homeassistant/components/dominos.py @@ -0,0 +1,240 @@ +""" +Support for Dominos Pizza ordering. + +The Dominos Pizza component ceates a service which can be invoked to order +from their menu + +For more details about this platform, please refer to the documentation at +https://home-assistant.io/components/dominos/. +""" +import logging +from datetime import timedelta + +import voluptuous as vol + +import homeassistant.helpers.config_validation as cv +from homeassistant.components import http +from homeassistant.core import callback +from homeassistant.helpers.entity import Entity +from homeassistant.helpers.entity_component import EntityComponent +from homeassistant.util import Throttle + +_LOGGER = logging.getLogger(__name__) + +# The domain of your component. Should be equal to the name of your component. +DOMAIN = 'dominos' +ENTITY_ID_FORMAT = DOMAIN + '.{}' + +ATTR_COUNTRY = 'country_code' +ATTR_FIRST_NAME = 'first_name' +ATTR_LAST_NAME = 'last_name' +ATTR_EMAIL = 'email' +ATTR_PHONE = 'phone' +ATTR_ADDRESS = 'address' +ATTR_ORDERS = 'orders' +ATTR_SHOW_MENU = 'show_menu' +ATTR_ORDER_ENTITY = 'order_entity_id' +ATTR_ORDER_NAME = 'name' +ATTR_ORDER_CODES = 'codes' + +MIN_TIME_BETWEEN_UPDATES = timedelta(minutes=10) +MIN_TIME_BETWEEN_STORE_UPDATES = timedelta(minutes=3330) + +REQUIREMENTS = ['pizzapi==0.0.3'] + +DEPENDENCIES = ['http'] + +_ORDERS_SCHEMA = vol.Schema({ + vol.Required(ATTR_ORDER_NAME): cv.string, + vol.Required(ATTR_ORDER_CODES): vol.All(cv.ensure_list, [cv.string]), +}) + +CONFIG_SCHEMA = vol.Schema({ + DOMAIN: vol.Schema({ + vol.Required(ATTR_COUNTRY): cv.string, + vol.Required(ATTR_FIRST_NAME): cv.string, + vol.Required(ATTR_LAST_NAME): cv.string, + vol.Required(ATTR_EMAIL): cv.string, + vol.Required(ATTR_PHONE): cv.string, + vol.Required(ATTR_ADDRESS): cv.string, + vol.Optional(ATTR_SHOW_MENU): cv.boolean, + vol.Optional(ATTR_ORDERS): vol.All(cv.ensure_list, [_ORDERS_SCHEMA]), + }), +}, extra=vol.ALLOW_EXTRA) + + +def setup(hass, config): + """Set up is called when Home Assistant is loading our component.""" + dominos = Dominos(hass, config) + + component = EntityComponent(_LOGGER, DOMAIN, hass) + hass.data[DOMAIN] = {} + entities = [] + conf = config[DOMAIN] + + hass.services.register(DOMAIN, 'order', dominos.handle_order) + + if conf.get(ATTR_SHOW_MENU): + hass.http.register_view(DominosProductListView(dominos)) + + for order_info in conf.get(ATTR_ORDERS): + order = DominosOrder(order_info, dominos) + entities.append(order) + + component.add_entities(entities) + + # Return boolean to indicate that initialization was successfully. + return True + + +class Dominos(): + """Main Dominos service.""" + + def __init__(self, hass, config): + """Set up main service.""" + conf = config[DOMAIN] + from pizzapi import Address, Customer, Store + self.hass = hass + self.customer = Customer( + conf.get(ATTR_FIRST_NAME), + conf.get(ATTR_LAST_NAME), + conf.get(ATTR_EMAIL), + conf.get(ATTR_PHONE), + conf.get(ATTR_ADDRESS)) + self.address = Address( + *self.customer.address.split(','), + country=conf.get(ATTR_COUNTRY)) + self.country = conf.get(ATTR_COUNTRY) + self.closest_store = Store() + + def handle_order(self, call): + """Handle ordering pizza.""" + entity_ids = call.data.get(ATTR_ORDER_ENTITY, None) + + target_orders = [order for order in self.hass.data[DOMAIN]['entities'] + if order.entity_id in entity_ids] + + for order in target_orders: + order.place() + + @Throttle(MIN_TIME_BETWEEN_STORE_UPDATES) + def update_closest_store(self): + """Update the shared closest store (if open).""" + from pizzapi.address import StoreException + try: + self.closest_store = self.address.closest_store() + except StoreException: + self.closest_store = False + + def get_menu(self): + """Return the products from the closest stores menu.""" + if self.closest_store is False: + _LOGGER.warning('Cannot get menu. Store may be closed') + return + + menu = self.closest_store.get_menu() + product_entries = [] + + for product in menu.products: + item = {} + if isinstance(product.menu_data['Variants'], list): + variants = ', '.join(product.menu_data['Variants']) + else: + variants = product.menu_data['Variants'] + item['name'] = product.name + item['variants'] = variants + product_entries.append(item) + + return product_entries + + +class DominosProductListView(http.HomeAssistantView): + """View to retrieve product list content.""" + + url = '/api/dominos' + name = "api:dominos" + + def __init__(self, dominos): + """Initialize suite view.""" + self.dominos = dominos + + @callback + def get(self, request): + """Retrieve if API is running.""" + return self.json(self.dominos.get_menu()) + + +class DominosOrder(Entity): + """Represents a Dominos order entity.""" + + def __init__(self, order_info, dominos): + """Set up the entity.""" + self._name = order_info['name'] + self._product_codes = order_info['codes'] + self._orderable = False + self.dominos = dominos + + @property + def name(self): + """Return the orders name.""" + return self._name + + @property + def product_codes(self): + """Return the orders product codes.""" + return self._product_codes + + @property + def orderable(self): + """Return the true if orderable.""" + return self._orderable + + @property + def state(self): + """Return the state either closed, orderable or unorderable.""" + if self.dominos.closest_store is False: + return 'closed' + else: + return 'orderable' if self._orderable else 'unorderable' + + @Throttle(MIN_TIME_BETWEEN_UPDATES) + def update(self): + """Update the order state and refreshes the store.""" + from pizzapi.address import StoreException + try: + self.dominos.update_closest_store() + except StoreException: + self._orderable = False + return + + try: + order = self.order() + order.pay_with() + self._orderable = True + except StoreException: + self._orderable = False + + def order(self): + """Create the order object.""" + from pizzapi import Order + order = Order( + self.dominos.closest_store, + self.dominos.customer, + self.dominos.address, + self.dominos.country) + + for code in self._product_codes: + order.add_item(code) + + return order + + def place(self): + """Place the order.""" + from pizzapi.address import StoreException + try: + order = self.order() + order.place() + except StoreException: + self._orderable = False + _LOGGER.warning( + 'Attempted to order Dominos - Order invalid or store closed') diff --git a/requirements_all.txt b/requirements_all.txt index 7ec77dffcf7..25ddb2ec2d1 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -536,6 +536,9 @@ piglow==1.2.4 # homeassistant.components.pilight pilight==0.1.1 +# homeassistant.components.dominos +pizzapi==0.0.3 + # homeassistant.components.media_player.plex # homeassistant.components.sensor.plex plexapi==3.0.3 From b03c024f74bebcea319f22b3657a7a8bd0f63268 Mon Sep 17 00:00:00 2001 From: Bart S Date: Fri, 24 Nov 2017 02:26:36 +0100 Subject: [PATCH 138/246] Fix name collision when using multiple Hue bridges (#10486) * Fix name collision when using multiple Hue bridges See https://github.com/home-assistant/home-assistant/issues/9393 * Use new style of string formatting * Removed creating of "All Hue Lights" group --- homeassistant/components/light/hue.py | 16 ---------------- 1 file changed, 16 deletions(-) diff --git a/homeassistant/components/light/hue.py b/homeassistant/components/light/hue.py index 6f4e948adea..fe7dd765d01 100644 --- a/homeassistant/components/light/hue.py +++ b/homeassistant/components/light/hue.py @@ -83,7 +83,6 @@ SCENE_SCHEMA = vol.Schema({ }) ATTR_IS_HUE_GROUP = "is_hue_group" -GROUP_NAME_ALL_HUE_LIGHTS = "All Hue Lights" CONFIG_INSTRUCTIONS = """ Press the button on the bridge to register Philips Hue with Home Assistant. @@ -210,21 +209,6 @@ def setup_bridge(host, hass, add_devices, filename, allow_unreachable, _LOGGER.error("Got unexpected result from Hue API") return - if not skip_groups: - # Group ID 0 is a special group in the hub for all lights, but it - # is not returned by get_api() so explicitly get it and include it. - # See https://developers.meethue.com/documentation/ - # groups-api#21_get_all_groups - _LOGGER.debug("Getting group 0 from bridge") - all_lights = bridge.get_group(0) - if not isinstance(all_lights, dict): - _LOGGER.error("Got unexpected result from Hue API for group 0") - return - # Hue hub returns name of group 0 as "Group 0", so rename - # for ease of use in HA. - all_lights['name'] = GROUP_NAME_ALL_HUE_LIGHTS - api_groups["0"] = all_lights - new_lights = [] api_name = api.get('config').get('name') From 61cddaa44147aa09c4f5a51814735e9e24dd0613 Mon Sep 17 00:00:00 2001 From: Nathan Henrie Date: Thu, 23 Nov 2017 18:28:31 -0700 Subject: [PATCH 139/246] Make shell_command async (#10741) * Make shell_command async Use `asyncio.subprocess` instead of `subprocess` to make the `shell_command` component async. Was able to migrate over existing component and tests without too many drastic changes. Retrieving stdout and stderr paves the way for possibly using these in future feature enhancements. * Remove trailing comma * Fix lint errors * Try to get rid of syntaxerror * Ignore spurious pylint error --- homeassistant/components/shell_command.py | 57 ++++++--- tests/components/test_shell_command.py | 141 ++++++++++++++-------- 2 files changed, 129 insertions(+), 69 deletions(-) diff --git a/homeassistant/components/shell_command.py b/homeassistant/components/shell_command.py index 6aabdc8ddf7..ca33666d1f3 100644 --- a/homeassistant/components/shell_command.py +++ b/homeassistant/components/shell_command.py @@ -4,15 +4,17 @@ Exposes regular shell commands as services. For more details about this platform, please refer to the documentation at https://home-assistant.io/components/shell_command/ """ +import asyncio import logging -import subprocess import shlex import voluptuous as vol -from homeassistant.helpers import template from homeassistant.exceptions import TemplateError -import homeassistant.helpers.config_validation as cv +from homeassistant.core import ServiceCall +from homeassistant.helpers import config_validation as cv, template +from homeassistant.helpers.typing import ConfigType, HomeAssistantType + DOMAIN = 'shell_command' @@ -25,15 +27,17 @@ CONFIG_SCHEMA = vol.Schema({ }, extra=vol.ALLOW_EXTRA) -def setup(hass, config): +@asyncio.coroutine +def async_setup(hass: HomeAssistantType, config: ConfigType) -> bool: """Set up the shell_command component.""" conf = config.get(DOMAIN, {}) cache = {} - def service_handler(call): + @asyncio.coroutine + def async_service_handler(service: ServiceCall) -> None: """Execute a shell command service.""" - cmd = conf[call.service] + cmd = conf[service.service] if cmd in cache: prog, args, args_compiled = cache[cmd] @@ -49,7 +53,7 @@ def setup(hass, config): if args_compiled: try: - rendered_args = args_compiled.render(call.data) + rendered_args = args_compiled.async_render(service.data) except TemplateError as ex: _LOGGER.exception("Error rendering command template: %s", ex) return @@ -58,19 +62,34 @@ def setup(hass, config): if rendered_args == args: # No template used. default behavior - shell = True - else: - # Template used. Break into list and use shell=False for security - cmd = [prog] + shlex.split(rendered_args) - shell = False - try: - subprocess.call(cmd, shell=shell, - stdout=subprocess.DEVNULL, - stderr=subprocess.DEVNULL) - except subprocess.SubprocessError: - _LOGGER.exception("Error running command: %s", cmd) + # pylint: disable=no-member + create_process = asyncio.subprocess.create_subprocess_shell( + cmd, + loop=hass.loop, + stdin=None, + stdout=asyncio.subprocess.DEVNULL, + stderr=asyncio.subprocess.DEVNULL) + else: + # Template used. Break into list and use create_subprocess_exec + # (which uses shell=False) for security + shlexed_cmd = [prog] + shlex.split(rendered_args) + + # pylint: disable=no-member + create_process = asyncio.subprocess.create_subprocess_exec( + *shlexed_cmd, + loop=hass.loop, + stdin=None, + stdout=asyncio.subprocess.DEVNULL, + stderr=asyncio.subprocess.DEVNULL) + + process = yield from create_process + yield from process.communicate() + + if process.returncode != 0: + _LOGGER.exception("Error running command: `%s`, return code: %s", + cmd, process.returncode) for name in conf.keys(): - hass.services.register(DOMAIN, name, service_handler) + hass.services.async_register(DOMAIN, name, async_service_handler) return True diff --git a/tests/components/test_shell_command.py b/tests/components/test_shell_command.py index b75a95e23cd..3bdb6896394 100644 --- a/tests/components/test_shell_command.py +++ b/tests/components/test_shell_command.py @@ -1,9 +1,10 @@ """The tests for the Shell command component.""" +import asyncio import os import tempfile import unittest -from unittest.mock import patch -from subprocess import SubprocessError +from typing import Tuple +from unittest.mock import Mock, patch from homeassistant.setup import setup_component from homeassistant.components import shell_command @@ -11,12 +12,35 @@ from homeassistant.components import shell_command from tests.common import get_test_home_assistant +@asyncio.coroutine +def mock_process_creator(error: bool = False) -> asyncio.coroutine: + """Mock a coroutine that creates a process when yielded.""" + @asyncio.coroutine + def communicate() -> Tuple[bytes, bytes]: + """Mock a coroutine that runs a process when yielded. + + Returns: + a tuple of (stdout, stderr). + """ + return b"I am stdout", b"I am stderr" + + mock_process = Mock() + mock_process.communicate = communicate + mock_process.returncode = int(error) + return mock_process + + class TestShellCommand(unittest.TestCase): - """Test the Shell command component.""" + """Test the shell_command component.""" def setUp(self): # pylint: disable=invalid-name - """Setup things to be run when tests are started.""" + """Setup things to be run when tests are started. + + Also seems to require a child watcher attached to the loop when run + from pytest. + """ self.hass = get_test_home_assistant() + asyncio.get_child_watcher().attach_loop(self.hass.loop) def tearDown(self): # pylint: disable=invalid-name """Stop everything that was started.""" @@ -26,84 +50,101 @@ class TestShellCommand(unittest.TestCase): """Test if able to call a configured service.""" with tempfile.TemporaryDirectory() as tempdirname: path = os.path.join(tempdirname, 'called.txt') - assert setup_component(self.hass, shell_command.DOMAIN, { - shell_command.DOMAIN: { - 'test_service': "date > {}".format(path) - } - }) + assert setup_component( + self.hass, + shell_command.DOMAIN, { + shell_command.DOMAIN: { + 'test_service': "date > {}".format(path) + } + } + ) self.hass.services.call('shell_command', 'test_service', blocking=True) self.hass.block_till_done() - self.assertTrue(os.path.isfile(path)) def test_config_not_dict(self): - """Test if config is not a dict.""" - assert not setup_component(self.hass, shell_command.DOMAIN, { - shell_command.DOMAIN: ['some', 'weird', 'list'] - }) + """Test that setup fails if config is not a dict.""" + self.assertFalse( + setup_component(self.hass, shell_command.DOMAIN, { + shell_command.DOMAIN: ['some', 'weird', 'list'] + })) def test_config_not_valid_service_names(self): - """Test if config contains invalid service names.""" - assert not setup_component(self.hass, shell_command.DOMAIN, { - shell_command.DOMAIN: { - 'this is invalid because space': 'touch bla.txt' - } - }) + """Test that setup fails if config contains invalid service names.""" + self.assertFalse( + setup_component(self.hass, shell_command.DOMAIN, { + shell_command.DOMAIN: { + 'this is invalid because space': 'touch bla.txt' + } + })) - @patch('homeassistant.components.shell_command.subprocess.call') + @patch('homeassistant.components.shell_command.asyncio.subprocess' + '.create_subprocess_shell') def test_template_render_no_template(self, mock_call): """Ensure shell_commands without templates get rendered properly.""" - assert setup_component(self.hass, shell_command.DOMAIN, { - shell_command.DOMAIN: { - 'test_service': "ls /bin" - } - }) + mock_call.return_value = mock_process_creator(error=False) + + self.assertTrue( + setup_component( + self.hass, + shell_command.DOMAIN, { + shell_command.DOMAIN: { + 'test_service': "ls /bin" + } + })) self.hass.services.call('shell_command', 'test_service', blocking=True) + self.hass.block_till_done() cmd = mock_call.mock_calls[0][1][0] - shell = mock_call.mock_calls[0][2]['shell'] - assert 'ls /bin' == cmd - assert shell + self.assertEqual(1, mock_call.call_count) + self.assertEqual('ls /bin', cmd) - @patch('homeassistant.components.shell_command.subprocess.call') + @patch('homeassistant.components.shell_command.asyncio.subprocess' + '.create_subprocess_exec') def test_template_render(self, mock_call): - """Ensure shell_commands without templates get rendered properly.""" + """Ensure shell_commands with templates get rendered properly.""" self.hass.states.set('sensor.test_state', 'Works') - assert setup_component(self.hass, shell_command.DOMAIN, { - shell_command.DOMAIN: { - 'test_service': "ls /bin {{ states.sensor.test_state.state }}" - } - }) + self.assertTrue( + setup_component(self.hass, shell_command.DOMAIN, { + shell_command.DOMAIN: { + 'test_service': ("ls /bin {{ states.sensor" + ".test_state.state }}") + } + })) self.hass.services.call('shell_command', 'test_service', blocking=True) - cmd = mock_call.mock_calls[0][1][0] - shell = mock_call.mock_calls[0][2]['shell'] + self.hass.block_till_done() + cmd = mock_call.mock_calls[0][1] - assert ['ls', '/bin', 'Works'] == cmd - assert not shell + self.assertEqual(1, mock_call.call_count) + self.assertEqual(('ls', '/bin', 'Works'), cmd) - @patch('homeassistant.components.shell_command.subprocess.call', - side_effect=SubprocessError) + @patch('homeassistant.components.shell_command.asyncio.subprocess' + '.create_subprocess_shell') @patch('homeassistant.components.shell_command._LOGGER.error') - def test_subprocess_raising_error(self, mock_call, mock_error): - """Test subprocess.""" + def test_subprocess_error(self, mock_error, mock_call): + """Test subprocess that returns an error.""" + mock_call.return_value = mock_process_creator(error=True) with tempfile.TemporaryDirectory() as tempdirname: path = os.path.join(tempdirname, 'called.txt') - assert setup_component(self.hass, shell_command.DOMAIN, { - shell_command.DOMAIN: { - 'test_service': "touch {}".format(path) - } - }) + self.assertTrue( + setup_component(self.hass, shell_command.DOMAIN, { + shell_command.DOMAIN: { + 'test_service': "touch {}".format(path) + } + })) self.hass.services.call('shell_command', 'test_service', blocking=True) - self.assertFalse(os.path.isfile(path)) + self.hass.block_till_done() + self.assertEqual(1, mock_call.call_count) self.assertEqual(1, mock_error.call_count) + self.assertFalse(os.path.isfile(path)) From f6547ec15729789598ea5e0d122857e06c17d185 Mon Sep 17 00:00:00 2001 From: Rendili <30532082+Rendili@users.noreply.github.com> Date: Fri, 24 Nov 2017 15:31:37 +0000 Subject: [PATCH 140/246] Update CODEOWNERS with hive Component / Platforms (#10775) --- CODEOWNERS | 2 ++ 1 file changed, 2 insertions(+) diff --git a/CODEOWNERS b/CODEOWNERS index 66007f53d7e..069edd6cce2 100644 --- a/CODEOWNERS +++ b/CODEOWNERS @@ -63,6 +63,8 @@ homeassistant/components/switch/tplink.py @rytilahti homeassistant/components/xiaomi_aqara.py @danielhiversen @syssi homeassistant/components/*/broadlink.py @danielhiversen +homeassistant/components/hive.py @Rendili @KJonline +homeassistant/components/*/hive.py @Rendili @KJonline homeassistant/components/*/rfxtrx.py @danielhiversen homeassistant/components/velux.py @Julius2342 homeassistant/components/*/velux.py @Julius2342 From 65d5b64d8dfdf1f068b459f00f6fc53c61668d39 Mon Sep 17 00:00:00 2001 From: uchagani Date: Fri, 24 Nov 2017 17:21:31 -0600 Subject: [PATCH 141/246] Bump total-connect-client version (#10769) --- homeassistant/components/alarm_control_panel/totalconnect.py | 2 +- requirements_all.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/alarm_control_panel/totalconnect.py b/homeassistant/components/alarm_control_panel/totalconnect.py index 423628c9365..6f22d6a358c 100644 --- a/homeassistant/components/alarm_control_panel/totalconnect.py +++ b/homeassistant/components/alarm_control_panel/totalconnect.py @@ -16,7 +16,7 @@ from homeassistant.const import ( STATE_ALARM_ARMED_HOME, STATE_ALARM_ARMED_NIGHT, STATE_ALARM_DISARMED, STATE_ALARM_ARMING, STATE_ALARM_DISARMING, STATE_UNKNOWN, CONF_NAME) -REQUIREMENTS = ['total_connect_client==0.13'] +REQUIREMENTS = ['total_connect_client==0.16'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index 25ddb2ec2d1..de3c8e76916 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -1082,7 +1082,7 @@ todoist-python==7.0.17 toonlib==1.0.2 # homeassistant.components.alarm_control_panel.totalconnect -total_connect_client==0.13 +total_connect_client==0.16 # homeassistant.components.sensor.transmission # homeassistant.components.switch.transmission From fcc164c31ea4bc13b7e74122536f55f17e5796e7 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Fri, 24 Nov 2017 15:52:59 -0800 Subject: [PATCH 142/246] Fix scene description formatting. (#10785) --- homeassistant/components/alexa/smart_home.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/homeassistant/components/alexa/smart_home.py b/homeassistant/components/alexa/smart_home.py index 6e71fc67df1..3c8e9f5d21c 100644 --- a/homeassistant/components/alexa/smart_home.py +++ b/homeassistant/components/alexa/smart_home.py @@ -171,7 +171,7 @@ def async_api_discovery(hass, config, request): # Required description as per Amazon Scene docs if entity.domain == scene.DOMAIN: - scene_fmt = '%s (Scene connected via Home Assistant)' + scene_fmt = '{} (Scene connected via Home Assistant)' description = scene_fmt.format(description) cat_key = ATTR_ALEXA_DISPLAY_CATEGORIES From 2817f03378a26e613cdced1cc23c5dbecf1ec65a Mon Sep 17 00:00:00 2001 From: uchagani Date: Fri, 24 Nov 2017 22:30:57 -0600 Subject: [PATCH 143/246] Fixes #10773: Demo Alarm Broken (#10777) * Fixes #10773: Demo Alarm Broken * Added test for platform setup * Remove unused import * Lint fix * Rework assert to work with python 3.5 --- homeassistant/components/alarm_control_panel/demo.py | 5 ++++- tests/components/alarm_control_panel/test_manual.py | 11 ++++++++++- 2 files changed, 14 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/alarm_control_panel/demo.py b/homeassistant/components/alarm_control_panel/demo.py index 00dae5c2779..aa90fe1f889 100644 --- a/homeassistant/components/alarm_control_panel/demo.py +++ b/homeassistant/components/alarm_control_panel/demo.py @@ -7,7 +7,7 @@ https://home-assistant.io/components/demo/ import homeassistant.components.alarm_control_panel.manual as manual from homeassistant.const import ( STATE_ALARM_ARMED_AWAY, STATE_ALARM_ARMED_HOME, STATE_ALARM_ARMED_NIGHT, - STATE_ALARM_TRIGGERED, CONF_PENDING_TIME) + STATE_ALARM_ARMED_CUSTOM_BYPASS, STATE_ALARM_TRIGGERED, CONF_PENDING_TIME) def setup_platform(hass, config, add_devices, discovery_info=None): @@ -23,6 +23,9 @@ def setup_platform(hass, config, add_devices, discovery_info=None): STATE_ALARM_ARMED_NIGHT: { CONF_PENDING_TIME: 5 }, + STATE_ALARM_ARMED_CUSTOM_BYPASS: { + CONF_PENDING_TIME: 5 + }, STATE_ALARM_TRIGGERED: { CONF_PENDING_TIME: 5 }, diff --git a/tests/components/alarm_control_panel/test_manual.py b/tests/components/alarm_control_panel/test_manual.py index 2e96b81bfce..d65568b0844 100644 --- a/tests/components/alarm_control_panel/test_manual.py +++ b/tests/components/alarm_control_panel/test_manual.py @@ -1,7 +1,9 @@ """The tests for the manual Alarm Control Panel component.""" from datetime import timedelta import unittest -from unittest.mock import patch +from unittest.mock import patch, MagicMock +from homeassistant.components.alarm_control_panel import demo + from homeassistant.setup import setup_component from homeassistant.const import ( @@ -27,6 +29,13 @@ class TestAlarmControlPanelManual(unittest.TestCase): """Stop down everything that was started.""" self.hass.stop() + def test_setup_demo_platform(self): + """Test setup.""" + mock = MagicMock() + add_devices = mock.MagicMock() + demo.setup_platform(self.hass, {}, add_devices) + self.assertEquals(add_devices.call_count, 1) + def test_arm_home_no_pending(self): """Test arm home method.""" self.assertTrue(setup_component( From dbbbe1ceef4e24c356747f21705bc25433ca750f Mon Sep 17 00:00:00 2001 From: Marcelo Moreira de Mello Date: Sat, 25 Nov 2017 06:15:12 -0500 Subject: [PATCH 144/246] Load Ring camera only with Ring Protect plan activated (#10739) * Added ability to only load Ring camera if the Ring Protect plan is activated. * Fixed notification for all invalid cameras * Fixed attribute name * Using asyncio for persistent notifications --- homeassistant/components/camera/ring.py | 32 +++++++++++++++++++++---- homeassistant/components/ring.py | 4 ++-- requirements_all.txt | 2 +- requirements_test_all.txt | 2 +- 4 files changed, 32 insertions(+), 8 deletions(-) diff --git a/homeassistant/components/camera/ring.py b/homeassistant/components/camera/ring.py index a5e9855bf37..96956d24eec 100644 --- a/homeassistant/components/camera/ring.py +++ b/homeassistant/components/camera/ring.py @@ -12,7 +12,8 @@ from datetime import timedelta import voluptuous as vol from homeassistant.helpers import config_validation as cv -from homeassistant.components.ring import DATA_RING, CONF_ATTRIBUTION +from homeassistant.components.ring import ( + DATA_RING, CONF_ATTRIBUTION, NOTIFICATION_ID) from homeassistant.components.camera import Camera, PLATFORM_SCHEMA from homeassistant.components.ffmpeg import DATA_FFMPEG from homeassistant.const import ATTR_ATTRIBUTION, CONF_SCAN_INTERVAL @@ -27,6 +28,8 @@ FORCE_REFRESH_INTERVAL = timedelta(minutes=45) _LOGGER = logging.getLogger(__name__) +NOTIFICATION_TITLE = 'Ring Camera Setup' + SCAN_INTERVAL = timedelta(seconds=90) PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ @@ -42,11 +45,33 @@ def async_setup_platform(hass, config, async_add_devices, discovery_info=None): ring = hass.data[DATA_RING] cams = [] + cams_no_plan = [] for camera in ring.doorbells: - cams.append(RingCam(hass, camera, config)) + if camera.has_subscription: + cams.append(RingCam(hass, camera, config)) + else: + cams_no_plan.append(camera) for camera in ring.stickup_cams: - cams.append(RingCam(hass, camera, config)) + if camera.has_subscription: + cams.append(RingCam(hass, camera, config)) + else: + cams_no_plan.append(camera) + + # show notification for all cameras without an active subscription + if cams_no_plan: + cameras = str(', '.join([camera.name for camera in cams_no_plan])) + + err_msg = '''A Ring Protect Plan is required for the''' \ + ''' following cameras: {}.'''.format(cameras) + + _LOGGER.error(err_msg) + hass.components.persistent_notification.async_create( + 'Error: {}
' + 'You will need to restart hass after fixing.' + ''.format(err_msg), + title=NOTIFICATION_TITLE, + notification_id=NOTIFICATION_ID) async_add_devices(cams, True) return True @@ -84,7 +109,6 @@ class RingCam(Camera): 'timezone': self._camera.timezone, 'type': self._camera.family, 'video_url': self._video_url, - 'video_id': self._last_video_id } @asyncio.coroutine diff --git a/homeassistant/components/ring.py b/homeassistant/components/ring.py index c16164d7700..62bd07d2c27 100644 --- a/homeassistant/components/ring.py +++ b/homeassistant/components/ring.py @@ -12,14 +12,14 @@ from homeassistant.const import CONF_USERNAME, CONF_PASSWORD from requests.exceptions import HTTPError, ConnectTimeout -REQUIREMENTS = ['ring_doorbell==0.1.7'] +REQUIREMENTS = ['ring_doorbell==0.1.8'] _LOGGER = logging.getLogger(__name__) CONF_ATTRIBUTION = "Data provided by Ring.com" NOTIFICATION_ID = 'ring_notification' -NOTIFICATION_TITLE = 'Ring Sensor Setup' +NOTIFICATION_TITLE = 'Ring Setup' DATA_RING = 'ring' DOMAIN = 'ring' diff --git a/requirements_all.txt b/requirements_all.txt index de3c8e76916..5ea9d743a2c 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -952,7 +952,7 @@ restrictedpython==4.0b2 rflink==0.0.34 # homeassistant.components.ring -ring_doorbell==0.1.7 +ring_doorbell==0.1.8 # homeassistant.components.notify.rocketchat rocketchat-API==0.6.1 diff --git a/requirements_test_all.txt b/requirements_test_all.txt index 4cbabf75864..7d6794d76dd 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -144,7 +144,7 @@ restrictedpython==4.0b2 rflink==0.0.34 # homeassistant.components.ring -ring_doorbell==0.1.7 +ring_doorbell==0.1.8 # homeassistant.components.media_player.yamaha rxv==0.5.1 From d8bf15a2f5f5d15aaca0223e8afd384d6771a5aa Mon Sep 17 00:00:00 2001 From: Andrey Date: Sat, 25 Nov 2017 16:22:41 +0200 Subject: [PATCH 145/246] system_log improvements (#10709) * system_log improvements * Don't use ModuleNotFoundError which is 3.6+ * Don't use FrameSummary which was added in 3.5 * Don't trace stack for exception logs * Handle test error in Python 3.4 --- .../components/system_log/__init__.py | 42 +++++++++--- tests/components/test_system_log.py | 65 ++++++++++++++++++- 2 files changed, 97 insertions(+), 10 deletions(-) diff --git a/homeassistant/components/system_log/__init__.py b/homeassistant/components/system_log/__init__.py index 6505107d034..60f707b1e33 100644 --- a/homeassistant/components/system_log/__init__.py +++ b/homeassistant/components/system_log/__init__.py @@ -14,6 +14,7 @@ from collections import deque import voluptuous as vol +from homeassistant import __path__ as HOMEASSISTANT_PATH from homeassistant.config import load_yaml_config_file import homeassistant.helpers.config_validation as cv from homeassistant.components.http import HomeAssistantView @@ -54,7 +55,14 @@ class LogErrorHandler(logging.Handler): be changed if neeeded. """ if record.levelno >= logging.WARN: - self.records.appendleft(record) + stack = [] + if not record.exc_info: + try: + stack = [f for f, _, _, _ in traceback.extract_stack()] + except ValueError: + # On Python 3.4 under py.test getting the stack might fail. + pass + self.records.appendleft([record, stack]) @asyncio.coroutine @@ -88,26 +96,41 @@ def async_setup(hass, config): return True -def _figure_out_source(record): +def _figure_out_source(record, call_stack, hass): + paths = [HOMEASSISTANT_PATH[0], hass.config.config_dir] + try: + # If netdisco is installed check its path too. + from netdisco import __path__ as netdisco_path + paths.append(netdisco_path[0]) + except ImportError: + pass # If a stack trace exists, extract filenames from the entire call stack. # The other case is when a regular "log" is made (without an attached # exception). In that case, just use the file where the log was made from. if record.exc_info: stack = [x[0] for x in traceback.extract_tb(record.exc_info[2])] else: - stack = [record.pathname] + index = -1 + for i, frame in enumerate(call_stack): + if frame == record.pathname: + index = i + break + if index == -1: + # For some reason we couldn't find pathname in the stack. + stack = [record.pathname] + else: + stack = call_stack[0:index+1] # Iterate through the stack call (in reverse) and find the last call from # a file in HA. Try to figure out where error happened. for pathname in reversed(stack): # Try to match with a file within HA - match = re.match(r'.*/homeassistant/(.*)', pathname) + match = re.match(r'(?:{})/(.*)'.format('|'.join(paths)), pathname) if match: return match.group(1) - # Ok, we don't know what this is - return 'unknown' + return record.pathname def _exception_as_string(exc_info): @@ -117,13 +140,13 @@ def _exception_as_string(exc_info): return buf.getvalue() -def _convert(record): +def _convert(record, call_stack, hass): return { 'timestamp': record.created, 'level': record.levelname, 'message': record.getMessage(), 'exception': _exception_as_string(record.exc_info), - 'source': _figure_out_source(record), + 'source': _figure_out_source(record, call_stack, hass), } @@ -140,4 +163,5 @@ class AllErrorsView(HomeAssistantView): @asyncio.coroutine def get(self, request): """Get all errors and warnings.""" - return self.json([_convert(x) for x in self.handler.records]) + return self.json([_convert(x[0], x[1], request.app['hass']) + for x in self.handler.records]) diff --git a/tests/components/test_system_log.py b/tests/components/test_system_log.py index b86c768fb42..0f61986cf47 100644 --- a/tests/components/test_system_log.py +++ b/tests/components/test_system_log.py @@ -5,6 +5,7 @@ import pytest from homeassistant.bootstrap import async_setup_component from homeassistant.components import system_log +from unittest.mock import MagicMock, patch _LOGGER = logging.getLogger('test_logger') @@ -41,10 +42,14 @@ def assert_log(log, exception, message, level): assert exception in log['exception'] assert message == log['message'] assert level == log['level'] - assert log['source'] == 'unknown' # always unkown in tests assert 'timestamp' in log +def get_frame(name): + """Get log stack frame.""" + return (name, None, None, None) + + @asyncio.coroutine def test_normal_logs(hass, test_client): """Test that debug and info are not logged.""" @@ -110,3 +115,61 @@ def test_clear_logs(hass, test_client): # Assert done by get_error_log yield from get_error_log(hass, test_client, 0) + + +@asyncio.coroutine +def test_unknown_path(hass, test_client): + """Test error logged from unknown path.""" + _LOGGER.findCaller = MagicMock( + return_value=('unknown_path', 0, None, None)) + _LOGGER.error('error message') + log = (yield from get_error_log(hass, test_client, 1))[0] + assert log['source'] == 'unknown_path' + + +def log_error_from_test_path(path): + """Log error while mocking the path.""" + call_path = 'internal_path.py' + with patch.object( + _LOGGER, + 'findCaller', + MagicMock(return_value=(call_path, 0, None, None))): + with patch('traceback.extract_stack', + MagicMock(return_value=[ + get_frame('main_path/main.py'), + get_frame(path), + get_frame(call_path), + get_frame('venv_path/logging/log.py')])): + _LOGGER.error('error message') + + +@asyncio.coroutine +def test_homeassistant_path(hass, test_client): + """Test error logged from homeassistant path.""" + log_error_from_test_path('venv_path/homeassistant/component/component.py') + + with patch('homeassistant.components.system_log.HOMEASSISTANT_PATH', + new=['venv_path/homeassistant']): + log = (yield from get_error_log(hass, test_client, 1))[0] + assert log['source'] == 'component/component.py' + + +@asyncio.coroutine +def test_config_path(hass, test_client): + """Test error logged from config path.""" + log_error_from_test_path('config/custom_component/test.py') + + with patch.object(hass.config, 'config_dir', new='config'): + log = (yield from get_error_log(hass, test_client, 1))[0] + assert log['source'] == 'custom_component/test.py' + + +@asyncio.coroutine +def test_netdisco_path(hass, test_client): + """Test error logged from netdisco path.""" + log_error_from_test_path('venv_path/netdisco/disco_component.py') + + with patch.dict('sys.modules', + netdisco=MagicMock(__path__=['venv_path/netdisco'])): + log = (yield from get_error_log(hass, test_client, 1))[0] + assert log['source'] == 'disco_component.py' From ba43218a73a1451154808580286462a1fe6ab598 Mon Sep 17 00:00:00 2001 From: Milan V Date: Sat, 25 Nov 2017 21:19:52 +0100 Subject: [PATCH 146/246] Fix WUnderground error handling, rework entity methods (#10295) * WUnderground sensor error handling and sensor class rework * WUnderground error handling, avoid long state, tests * Wunderground - add handling ValueError exception on parsing * Changes to address review comments - part 1 * Tests lint * Changes to address review comments - part 2 --- .../components/sensor/wunderground.py | 85 +++++++++++++------ tests/components/sensor/test_wunderground.py | 64 +++++++++++++- 2 files changed, 118 insertions(+), 31 deletions(-) diff --git a/homeassistant/components/sensor/wunderground.py b/homeassistant/components/sensor/wunderground.py index c0763c4fefa..8bb449b2ec1 100644 --- a/homeassistant/components/sensor/wunderground.py +++ b/homeassistant/components/sensor/wunderground.py @@ -17,6 +17,7 @@ from homeassistant.const import ( TEMP_FAHRENHEIT, TEMP_CELSIUS, LENGTH_INCHES, LENGTH_KILOMETERS, LENGTH_MILES, LENGTH_FEET, STATE_UNKNOWN, ATTR_ATTRIBUTION, ATTR_FRIENDLY_NAME) +from homeassistant.exceptions import PlatformNotReady from homeassistant.helpers.entity import Entity from homeassistant.util import Throttle import homeassistant.helpers.config_validation as cv @@ -638,11 +639,9 @@ def setup_platform(hass, config, add_devices, discovery_info=None): for variable in config[CONF_MONITORED_CONDITIONS]: sensors.append(WUndergroundSensor(rest, variable)) - try: - rest.update() - except ValueError as err: - _LOGGER.error("Received error from WUnderground: %s", err) - return False + rest.update() + if not rest.data: + raise PlatformNotReady add_devices(sensors) @@ -656,21 +655,49 @@ class WUndergroundSensor(Entity): """Initialize the sensor.""" self.rest = rest self._condition = condition + self._state = None + self._attributes = { + ATTR_ATTRIBUTION: CONF_ATTRIBUTION, + } + self._icon = None + self._entity_picture = None + self._unit_of_measurement = self._cfg_expand("unit_of_measurement") self.rest.request_feature(SENSOR_TYPES[condition].feature) def _cfg_expand(self, what, default=None): + """Parse and return sensor data.""" cfg = SENSOR_TYPES[self._condition] val = getattr(cfg, what) + if not callable(val): + return val try: val = val(self.rest) - except (KeyError, IndexError) as err: - _LOGGER.warning("Failed to parse response from WU API: %s", err) + except (KeyError, IndexError, TypeError, ValueError) as err: + _LOGGER.warning("Failed to expand cfg from WU API." + " Condition: %s Attr: %s Error: %s", + self._condition, what, repr(err)) val = default - except TypeError: - pass # val was not callable - keep original value return val + def _update_attrs(self): + """Parse and update device state attributes.""" + attrs = self._cfg_expand("device_state_attributes", {}) + + self._attributes[ATTR_FRIENDLY_NAME] = self._cfg_expand( + "friendly_name") + + for (attr, callback) in attrs.items(): + if callable(callback): + try: + self._attributes[attr] = callback(self.rest) + except (KeyError, IndexError, TypeError, ValueError) as err: + _LOGGER.warning("Failed to update attrs from WU API." + " Condition: %s Attr: %s Error: %s", + self._condition, attr, repr(err)) + else: + self._attributes[attr] = callback + @property def name(self): """Return the name of the sensor.""" @@ -679,46 +706,44 @@ class WUndergroundSensor(Entity): @property def state(self): """Return the state of the sensor.""" - return self._cfg_expand("value", STATE_UNKNOWN) + return self._state @property def device_state_attributes(self): """Return the state attributes.""" - attrs = self._cfg_expand("device_state_attributes", {}) - for (attr, callback) in attrs.items(): - try: - attrs[attr] = callback(self.rest) - except TypeError: - attrs[attr] = callback - except (KeyError, IndexError) as err: - _LOGGER.warning("Failed to parse response from WU API: %s", - err) - - attrs[ATTR_ATTRIBUTION] = CONF_ATTRIBUTION - attrs[ATTR_FRIENDLY_NAME] = self._cfg_expand("friendly_name") - return attrs + return self._attributes @property def icon(self): """Return icon.""" - return self._cfg_expand("icon", super().icon) + return self._icon @property def entity_picture(self): """Return the entity picture.""" - url = self._cfg_expand("entity_picture") - if isinstance(url, str): - return re.sub(r'^http://', 'https://', url, flags=re.IGNORECASE) + return self._entity_picture @property def unit_of_measurement(self): """Return the units of measurement.""" - return self._cfg_expand("unit_of_measurement") + return self._unit_of_measurement def update(self): """Update current conditions.""" self.rest.update() + if not self.rest.data: + # no data, return + return + + self._state = self._cfg_expand("value", STATE_UNKNOWN) + self._update_attrs() + self._icon = self._cfg_expand("icon", super().icon) + url = self._cfg_expand("entity_picture") + if isinstance(url, str): + self._entity_picture = re.sub(r'^http://', 'https://', + url, flags=re.IGNORECASE) + class WUndergroundData(object): """Get data from WUnderground.""" @@ -758,6 +783,10 @@ class WUndergroundData(object): ["description"]) else: self.data = result + return True except ValueError as err: _LOGGER.error("Check WUnderground API %s", err.args) self.data = None + except requests.RequestException as err: + _LOGGER.error("Error fetching WUnderground data: %s", repr(err)) + self.data = None diff --git a/tests/components/sensor/test_wunderground.py b/tests/components/sensor/test_wunderground.py index 1a3c0304b00..5f6028b1a14 100644 --- a/tests/components/sensor/test_wunderground.py +++ b/tests/components/sensor/test_wunderground.py @@ -2,7 +2,10 @@ import unittest from homeassistant.components.sensor import wunderground -from homeassistant.const import TEMP_CELSIUS, LENGTH_INCHES +from homeassistant.const import TEMP_CELSIUS, LENGTH_INCHES, STATE_UNKNOWN +from homeassistant.exceptions import PlatformNotReady + +from requests.exceptions import ConnectionError from tests.common import get_test_home_assistant @@ -38,6 +41,7 @@ FEELS_LIKE = '40' WEATHER = 'Clear' HTTPS_ICON_URL = 'https://icons.wxug.com/i/c/k/clear.gif' ALERT_MESSAGE = 'This is a test alert message' +ALERT_ICON = 'mdi:alert-circle-outline' FORECAST_TEXT = 'Mostly Cloudy. Fog overnight.' PRECIP_IN = 0.03 @@ -163,6 +167,41 @@ def mocked_requests_get(*args, **kwargs): }, 200) +def mocked_requests_get_invalid(*args, **kwargs): + """Mock requests.get invocations invalid data.""" + class MockResponse: + """Class to represent a mocked response.""" + + def __init__(self, json_data, status_code): + """Initialize the mock response class.""" + self.json_data = json_data + self.status_code = status_code + + def json(self): + """Return the json of the response.""" + return self.json_data + + return MockResponse({ + "response": { + "version": "0.1", + "termsofService": + "http://www.wunderground.com/weather/api/d/terms.html", + "features": { + "conditions": 1, + "alerts": 1, + "forecast": 1, + } + }, "current_observation": { + "image": { + "url": + 'http://icons.wxug.com/graphics/wu2/logo_130x80.png', + "title": "Weather Underground", + "link": "http://www.wunderground.com" + }, + }, + }, 200) + + class TestWundergroundSetup(unittest.TestCase): """Test the WUnderground platform.""" @@ -199,9 +238,9 @@ class TestWundergroundSetup(unittest.TestCase): wunderground.setup_platform(self.hass, VALID_CONFIG, self.add_devices, None)) - self.assertTrue( + with self.assertRaises(PlatformNotReady): wunderground.setup_platform(self.hass, INVALID_CONFIG, - self.add_devices, None)) + self.add_devices, None) @unittest.mock.patch('requests.get', side_effect=mocked_requests_get) def test_sensor(self, req_mock): @@ -219,6 +258,7 @@ class TestWundergroundSetup(unittest.TestCase): self.assertEqual(1, device.state) self.assertEqual(ALERT_MESSAGE, device.device_state_attributes['Message']) + self.assertEqual(ALERT_ICON, device.icon) self.assertIsNone(device.entity_picture) elif device.name == 'PWS_location': self.assertEqual('Holly Springs, NC', device.state) @@ -234,3 +274,21 @@ class TestWundergroundSetup(unittest.TestCase): self.assertEqual(device.name, 'PWS_precip_1d_in') self.assertEqual(PRECIP_IN, device.state) self.assertEqual(LENGTH_INCHES, device.unit_of_measurement) + + @unittest.mock.patch('requests.get', + side_effect=ConnectionError('test exception')) + def test_connect_failed(self, req_mock): + """Test the WUnderground connection error.""" + with self.assertRaises(PlatformNotReady): + wunderground.setup_platform(self.hass, VALID_CONFIG, + self.add_devices, None) + + @unittest.mock.patch('requests.get', + side_effect=mocked_requests_get_invalid) + def test_invalid_data(self, req_mock): + """Test the WUnderground invalid data.""" + wunderground.setup_platform(self.hass, VALID_CONFIG_PWS, + self.add_devices, None) + for device in self.DEVICES: + device.update() + self.assertEqual(STATE_UNKNOWN, device.state) From 3d5a9b5e91eaead7278695e141ab862e19d2c528 Mon Sep 17 00:00:00 2001 From: bcl1713 Date: Sat, 25 Nov 2017 18:13:14 -0600 Subject: [PATCH 147/246] Add away_mode_name to arlo alarm control panel (#10796) * Update arlo.py Include variables for custom away mode specification * fixed line too long style problem * fix trailing white space * fix sending away mode command --- .../components/alarm_control_panel/arlo.py | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/homeassistant/components/alarm_control_panel/arlo.py b/homeassistant/components/alarm_control_panel/arlo.py index 2dad3857c4d..333bde9ee36 100644 --- a/homeassistant/components/alarm_control_panel/arlo.py +++ b/homeassistant/components/alarm_control_panel/arlo.py @@ -22,6 +22,7 @@ _LOGGER = logging.getLogger(__name__) ARMED = 'armed' CONF_HOME_MODE_NAME = 'home_mode_name' +CONF_AWAY_MODE_NAME = 'away_mode_name' DEPENDENCIES = ['arlo'] @@ -31,6 +32,7 @@ ICON = 'mdi:security' PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Optional(CONF_HOME_MODE_NAME, default=ARMED): cv.string, + vol.Optional(CONF_AWAY_MODE_NAME, default=ARMED): cv.string, }) @@ -43,19 +45,22 @@ def async_setup_platform(hass, config, async_add_devices, discovery_info=None): return home_mode_name = config.get(CONF_HOME_MODE_NAME) + away_mode_name = config.get(CONF_AWAY_MODE_NAME) base_stations = [] for base_station in data.base_stations: - base_stations.append(ArloBaseStation(base_station, home_mode_name)) + base_stations.append(ArloBaseStation(base_station, home_mode_name, + away_mode_name)) async_add_devices(base_stations, True) class ArloBaseStation(AlarmControlPanel): """Representation of an Arlo Alarm Control Panel.""" - def __init__(self, data, home_mode_name): + def __init__(self, data, home_mode_name, away_mode_name): """Initialize the alarm control panel.""" self._base_station = data self._home_mode_name = home_mode_name + self._away_mode_name = away_mode_name self._state = None @property @@ -89,8 +94,8 @@ class ArloBaseStation(AlarmControlPanel): @asyncio.coroutine def async_alarm_arm_away(self, code=None): - """Send arm away command.""" - self._base_station.mode = ARMED + """Send arm away command. Uses custom mode.""" + self._base_station.mode = self._away_mode_name @asyncio.coroutine def async_alarm_arm_home(self, code=None): @@ -118,4 +123,6 @@ class ArloBaseStation(AlarmControlPanel): return STATE_ALARM_DISARMED elif mode == self._home_mode_name: return STATE_ALARM_ARMED_HOME + elif mode == self._away_mode_name: + return STATE_ALARM_ARMED_AWAY return None From 3e962808e6b717b595307ad9ebbaa034cd0484fa Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sat, 25 Nov 2017 21:54:51 -0800 Subject: [PATCH 148/246] Bump frontend to 20171126.0 --- homeassistant/components/frontend/__init__.py | 2 +- requirements_all.txt | 2 +- requirements_test_all.txt | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index 751a4e2cde3..f8f76b2b388 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -23,7 +23,7 @@ from homeassistant.const import CONF_NAME, EVENT_THEMES_UPDATED from homeassistant.core import callback from homeassistant.loader import bind_hass -REQUIREMENTS = ['home-assistant-frontend==20171121.1'] +REQUIREMENTS = ['home-assistant-frontend==20171126.0'] DOMAIN = 'frontend' DEPENDENCIES = ['api', 'websocket_api', 'http', 'system_log'] diff --git a/requirements_all.txt b/requirements_all.txt index 5ea9d743a2c..76b9636be2c 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -328,7 +328,7 @@ hipnotify==1.0.8 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171121.1 +home-assistant-frontend==20171126.0 # homeassistant.components.camera.onvif http://github.com/tgaugry/suds-passworddigest-py3/archive/86fc50e39b4d2b8997481967d6a7fe1c57118999.zip#suds-passworddigest-py3==0.1.2a diff --git a/requirements_test_all.txt b/requirements_test_all.txt index 7d6794d76dd..3e5e8fabe7a 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -74,7 +74,7 @@ hbmqtt==0.9.1 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171121.1 +home-assistant-frontend==20171126.0 # homeassistant.components.influxdb # homeassistant.components.sensor.influxdb From a187bd5455564a673e8f26b0a1424f9dcd5564bc Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sun, 26 Nov 2017 21:12:47 +0100 Subject: [PATCH 149/246] Add missing docstring (#10812) * Add missing docstring * Revert isort change --- homeassistant/components/notify/pushbullet.py | 23 ++++++++++--------- 1 file changed, 12 insertions(+), 11 deletions(-) diff --git a/homeassistant/components/notify/pushbullet.py b/homeassistant/components/notify/pushbullet.py index d8b67413528..0e846ebaf84 100644 --- a/homeassistant/components/notify/pushbullet.py +++ b/homeassistant/components/notify/pushbullet.py @@ -10,8 +10,8 @@ import mimetypes import voluptuous as vol from homeassistant.components.notify import ( - ATTR_DATA, ATTR_TARGET, ATTR_TITLE, ATTR_TITLE_DEFAULT, - PLATFORM_SCHEMA, BaseNotificationService) + ATTR_DATA, ATTR_TARGET, ATTR_TITLE, ATTR_TITLE_DEFAULT, PLATFORM_SCHEMA, + BaseNotificationService) from homeassistant.const import CONF_API_KEY import homeassistant.helpers.config_validation as cv @@ -85,12 +85,12 @@ class PushBulletNotificationService(BaseNotificationService): refreshed = False if not targets: - # Backward compatibility, notify all devices in own account + # Backward compatibility, notify all devices in own account. self._push_data(message, title, data, self.pushbullet) _LOGGER.info("Sent notification to self") return - # Main loop, process all targets specified + # Main loop, process all targets specified. for target in targets: try: ttype, tname = target.split('/', 1) @@ -98,15 +98,15 @@ class PushBulletNotificationService(BaseNotificationService): _LOGGER.error("Invalid target syntax: %s", target) continue - # Target is email, send directly, don't use a target object - # This also seems works to send to all devices in own account + # Target is email, send directly, don't use a target object. + # This also seems works to send to all devices in own account. if ttype == 'email': self._push_data(message, title, data, self.pushbullet, tname) _LOGGER.info("Sent notification to email %s", tname) continue # Refresh if name not found. While awaiting periodic refresh - # solution in component, poor mans refresh ;) + # solution in component, poor mans refresh. if ttype not in self.pbtargets: _LOGGER.error("Invalid target syntax: %s", target) continue @@ -128,6 +128,7 @@ class PushBulletNotificationService(BaseNotificationService): continue def _push_data(self, message, title, data, pusher, tname=None): + """Helper for creating the message content.""" from pushbullet import PushError if data is None: data = {} @@ -142,17 +143,17 @@ class PushBulletNotificationService(BaseNotificationService): pusher.push_link(title, url, body=message) elif filepath: if not self.hass.config.is_allowed_path(filepath): - _LOGGER.error("Filepath is not valid or allowed.") + _LOGGER.error("Filepath is not valid or allowed") return - with open(filepath, "rb") as fileh: + with open(filepath, 'rb') as fileh: filedata = self.pushbullet.upload_file(fileh, filepath) if filedata.get('file_type') == 'application/x-empty': - _LOGGER.error("Can not send an empty file.") + _LOGGER.error("Can not send an empty file") return pusher.push_file(title=title, body=message, **filedata) elif file_url: if not file_url.startswith('http'): - _LOGGER.error("Url should start with http or https.") + _LOGGER.error("URL should start with http or https") return pusher.push_file(title=title, body=message, file_name=file_url, file_url=file_url, From 1b7a64412d175b1586713811a46cc3c5210168da Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sun, 26 Nov 2017 17:48:11 -0800 Subject: [PATCH 150/246] Bump frontend to 20171127.0 --- homeassistant/components/frontend/__init__.py | 2 +- requirements_all.txt | 2 +- requirements_test_all.txt | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index f8f76b2b388..d209955cfac 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -23,7 +23,7 @@ from homeassistant.const import CONF_NAME, EVENT_THEMES_UPDATED from homeassistant.core import callback from homeassistant.loader import bind_hass -REQUIREMENTS = ['home-assistant-frontend==20171126.0'] +REQUIREMENTS = ['home-assistant-frontend==20171127.0'] DOMAIN = 'frontend' DEPENDENCIES = ['api', 'websocket_api', 'http', 'system_log'] diff --git a/requirements_all.txt b/requirements_all.txt index 76b9636be2c..05ad6414b20 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -328,7 +328,7 @@ hipnotify==1.0.8 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171126.0 +home-assistant-frontend==20171127.0 # homeassistant.components.camera.onvif http://github.com/tgaugry/suds-passworddigest-py3/archive/86fc50e39b4d2b8997481967d6a7fe1c57118999.zip#suds-passworddigest-py3==0.1.2a diff --git a/requirements_test_all.txt b/requirements_test_all.txt index 3e5e8fabe7a..f3e3b0046d5 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -74,7 +74,7 @@ hbmqtt==0.9.1 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171126.0 +home-assistant-frontend==20171127.0 # homeassistant.components.influxdb # homeassistant.components.sensor.influxdb From fe0a9529ed1aee8f1bc446cfeae8dae2bb7c9d03 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Mon, 27 Nov 2017 01:09:17 -0800 Subject: [PATCH 151/246] Cloud cognito switch (#10823) * Allow email based cognito instance * Fix quitting Home Assistant while reconnecting * Lint --- homeassistant/components/cloud/__init__.py | 5 ++++ homeassistant/components/cloud/auth_api.py | 23 ++++++++++++--- homeassistant/components/cloud/iot.py | 18 +++++------- tests/components/cloud/test_auth_api.py | 34 +++++++++++++++++----- tests/components/cloud/test_http_api.py | 4 +-- 5 files changed, 60 insertions(+), 24 deletions(-) diff --git a/homeassistant/components/cloud/__init__.py b/homeassistant/components/cloud/__init__.py index e6da2de40f2..9bd91d22beb 100644 --- a/homeassistant/components/cloud/__init__.py +++ b/homeassistant/components/cloud/__init__.py @@ -104,6 +104,11 @@ class Cloud: self.region = info['region'] self.relayer = info['relayer'] + @property + def cognito_email_based(self): + """Return if cognito is email based.""" + return not self.user_pool_id.endswith('GmV') + @property def is_logged_in(self): """Get if cloud is logged in.""" diff --git a/homeassistant/components/cloud/auth_api.py b/homeassistant/components/cloud/auth_api.py index cb9fe15ab4a..95bf5596835 100644 --- a/homeassistant/components/cloud/auth_api.py +++ b/homeassistant/components/cloud/auth_api.py @@ -69,7 +69,10 @@ def register(cloud, email, password): cognito = _cognito(cloud) try: - cognito.register(_generate_username(email), password, email=email) + if cloud.cognito_email_based: + cognito.register(email, password, email=email) + else: + cognito.register(_generate_username(email), password, email=email) except ClientError as err: raise _map_aws_exception(err) @@ -80,7 +83,11 @@ def confirm_register(cloud, confirmation_code, email): cognito = _cognito(cloud) try: - cognito.confirm_sign_up(confirmation_code, _generate_username(email)) + if cloud.cognito_email_based: + cognito.confirm_sign_up(confirmation_code, email) + else: + cognito.confirm_sign_up(confirmation_code, + _generate_username(email)) except ClientError as err: raise _map_aws_exception(err) @@ -89,7 +96,11 @@ def forgot_password(cloud, email): """Initiate forgotten password flow.""" from botocore.exceptions import ClientError - cognito = _cognito(cloud, username=_generate_username(email)) + if cloud.cognito_email_based: + cognito = _cognito(cloud, username=email) + else: + cognito = _cognito(cloud, username=_generate_username(email)) + try: cognito.initiate_forgot_password() except ClientError as err: @@ -100,7 +111,11 @@ def confirm_forgot_password(cloud, confirmation_code, email, new_password): """Confirm forgotten password code and change password.""" from botocore.exceptions import ClientError - cognito = _cognito(cloud, username=_generate_username(email)) + if cloud.cognito_email_based: + cognito = _cognito(cloud, username=email) + else: + cognito = _cognito(cloud, username=_generate_username(email)) + try: cognito.confirm_forgot_password(confirmation_code, new_password) except ClientError as err: diff --git a/homeassistant/components/cloud/iot.py b/homeassistant/components/cloud/iot.py index 91ad1cfc6ff..9c67c98cabf 100644 --- a/homeassistant/components/cloud/iot.py +++ b/homeassistant/components/cloud/iot.py @@ -59,13 +59,6 @@ class CloudIoT: if self.state == STATE_CONNECTED: raise RuntimeError('Already connected') - self.state = STATE_CONNECTING - self.close_requested = False - remove_hass_stop_listener = None - session = async_get_clientsession(self.cloud.hass) - client = None - disconnect_warn = None - @asyncio.coroutine def _handle_hass_stop(event): """Handle Home Assistant shutting down.""" @@ -73,6 +66,14 @@ class CloudIoT: remove_hass_stop_listener = None yield from self.disconnect() + self.state = STATE_CONNECTING + self.close_requested = False + remove_hass_stop_listener = hass.bus.async_listen_once( + EVENT_HOMEASSISTANT_STOP, _handle_hass_stop) + session = async_get_clientsession(self.cloud.hass) + client = None + disconnect_warn = None + try: yield from hass.async_add_job(auth_api.check_token, self.cloud) @@ -83,9 +84,6 @@ class CloudIoT: }) self.tries = 0 - remove_hass_stop_listener = hass.bus.async_listen_once( - EVENT_HOMEASSISTANT_STOP, _handle_hass_stop) - _LOGGER.info('Connected') self.state = STATE_CONNECTED diff --git a/tests/components/cloud/test_auth_api.py b/tests/components/cloud/test_auth_api.py index 20f9265a1c1..f94c2691cd7 100644 --- a/tests/components/cloud/test_auth_api.py +++ b/tests/components/cloud/test_auth_api.py @@ -77,7 +77,11 @@ def test_login(mock_cognito): def test_register(mock_cognito): """Test registering an account.""" - auth_api.register(None, 'email@home-assistant.io', 'password') + cloud = MagicMock() + cloud.cognito_email_based = False + cloud = MagicMock() + cloud.cognito_email_based = False + auth_api.register(cloud, 'email@home-assistant.io', 'password') assert len(mock_cognito.register.mock_calls) == 1 result_user, result_password = mock_cognito.register.mock_calls[0][1] assert result_user == \ @@ -87,14 +91,18 @@ def test_register(mock_cognito): def test_register_fails(mock_cognito): """Test registering an account.""" + cloud = MagicMock() + cloud.cognito_email_based = False mock_cognito.register.side_effect = aws_error('SomeError') with pytest.raises(auth_api.CloudError): - auth_api.register(None, 'email@home-assistant.io', 'password') + auth_api.register(cloud, 'email@home-assistant.io', 'password') def test_confirm_register(mock_cognito): """Test confirming a registration of an account.""" - auth_api.confirm_register(None, '123456', 'email@home-assistant.io') + cloud = MagicMock() + cloud.cognito_email_based = False + auth_api.confirm_register(cloud, '123456', 'email@home-assistant.io') assert len(mock_cognito.confirm_sign_up.mock_calls) == 1 result_code, result_user = mock_cognito.confirm_sign_up.mock_calls[0][1] assert result_user == \ @@ -104,28 +112,36 @@ def test_confirm_register(mock_cognito): def test_confirm_register_fails(mock_cognito): """Test an error during confirmation of an account.""" + cloud = MagicMock() + cloud.cognito_email_based = False mock_cognito.confirm_sign_up.side_effect = aws_error('SomeError') with pytest.raises(auth_api.CloudError): - auth_api.confirm_register(None, '123456', 'email@home-assistant.io') + auth_api.confirm_register(cloud, '123456', 'email@home-assistant.io') def test_forgot_password(mock_cognito): """Test starting forgot password flow.""" - auth_api.forgot_password(None, 'email@home-assistant.io') + cloud = MagicMock() + cloud.cognito_email_based = False + auth_api.forgot_password(cloud, 'email@home-assistant.io') assert len(mock_cognito.initiate_forgot_password.mock_calls) == 1 def test_forgot_password_fails(mock_cognito): """Test failure when starting forgot password flow.""" + cloud = MagicMock() + cloud.cognito_email_based = False mock_cognito.initiate_forgot_password.side_effect = aws_error('SomeError') with pytest.raises(auth_api.CloudError): - auth_api.forgot_password(None, 'email@home-assistant.io') + auth_api.forgot_password(cloud, 'email@home-assistant.io') def test_confirm_forgot_password(mock_cognito): """Test confirming forgot password.""" + cloud = MagicMock() + cloud.cognito_email_based = False auth_api.confirm_forgot_password( - None, '123456', 'email@home-assistant.io', 'new password') + cloud, '123456', 'email@home-assistant.io', 'new password') assert len(mock_cognito.confirm_forgot_password.mock_calls) == 1 result_code, result_password = \ mock_cognito.confirm_forgot_password.mock_calls[0][1] @@ -135,10 +151,12 @@ def test_confirm_forgot_password(mock_cognito): def test_confirm_forgot_password_fails(mock_cognito): """Test failure when confirming forgot password.""" + cloud = MagicMock() + cloud.cognito_email_based = False mock_cognito.confirm_forgot_password.side_effect = aws_error('SomeError') with pytest.raises(auth_api.CloudError): auth_api.confirm_forgot_password( - None, '123456', 'email@home-assistant.io', 'new password') + cloud, '123456', 'email@home-assistant.io', 'new password') def test_check_token_writes_new_token_on_refresh(mock_cognito): diff --git a/tests/components/cloud/test_http_api.py b/tests/components/cloud/test_http_api.py index 296baa3f143..423ca1092eb 100644 --- a/tests/components/cloud/test_http_api.py +++ b/tests/components/cloud/test_http_api.py @@ -191,7 +191,7 @@ def test_register_view(mock_cognito, cloud_client): assert req.status == 200 assert len(mock_cognito.register.mock_calls) == 1 result_email, result_pass = mock_cognito.register.mock_calls[0][1] - assert result_email == auth_api._generate_username('hello@bla.com') + assert result_email == 'hello@bla.com' assert result_pass == 'falcon42' @@ -238,7 +238,7 @@ def test_confirm_register_view(mock_cognito, cloud_client): assert req.status == 200 assert len(mock_cognito.confirm_sign_up.mock_calls) == 1 result_code, result_email = mock_cognito.confirm_sign_up.mock_calls[0][1] - assert result_email == auth_api._generate_username('hello@bla.com') + assert result_email == 'hello@bla.com' assert result_code == '123456' From eb282b3bb3f6e6389d640400742bd3c1b6fd290e Mon Sep 17 00:00:00 2001 From: Rasmus Date: Mon, 27 Nov 2017 10:11:00 +0100 Subject: [PATCH 152/246] Added sensor types from telldus server src (#10787) Added from https://github.com/telldus/tellstick-server/blob/master/telldus/src/telldus/Device.py --- homeassistant/components/sensor/tellduslive.py | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/homeassistant/components/sensor/tellduslive.py b/homeassistant/components/sensor/tellduslive.py index c14b20e1099..61a084c6266 100644 --- a/homeassistant/components/sensor/tellduslive.py +++ b/homeassistant/components/sensor/tellduslive.py @@ -11,26 +11,32 @@ from homeassistant.const import TEMP_CELSIUS _LOGGER = logging.getLogger(__name__) -SENSOR_TYPE_TEMP = 'temp' +SENSOR_TYPE_TEMPERATURE = 'temp' SENSOR_TYPE_HUMIDITY = 'humidity' SENSOR_TYPE_RAINRATE = 'rrate' SENSOR_TYPE_RAINTOTAL = 'rtot' SENSOR_TYPE_WINDDIRECTION = 'wdir' SENSOR_TYPE_WINDAVERAGE = 'wavg' SENSOR_TYPE_WINDGUST = 'wgust' +SENSOR_TYPE_UV = 'uv' SENSOR_TYPE_WATT = 'watt' SENSOR_TYPE_LUMINANCE = 'lum' +SENSOR_TYPE_DEW_POINT = 'dewp' +SENSOR_TYPE_BAROMETRIC_PRESSURE = 'barpress' SENSOR_TYPES = { - SENSOR_TYPE_TEMP: ['Temperature', TEMP_CELSIUS, 'mdi:thermometer'], + SENSOR_TYPE_TEMPERATURE: ['Temperature', TEMP_CELSIUS, 'mdi:thermometer'], SENSOR_TYPE_HUMIDITY: ['Humidity', '%', 'mdi:water'], - SENSOR_TYPE_RAINRATE: ['Rain rate', 'mm', 'mdi:water'], + SENSOR_TYPE_RAINRATE: ['Rain rate', 'mm/h', 'mdi:water'], SENSOR_TYPE_RAINTOTAL: ['Rain total', 'mm', 'mdi:water'], SENSOR_TYPE_WINDDIRECTION: ['Wind direction', '', ''], SENSOR_TYPE_WINDAVERAGE: ['Wind average', 'm/s', ''], SENSOR_TYPE_WINDGUST: ['Wind gust', 'm/s', ''], - SENSOR_TYPE_WATT: ['Watt', 'W', ''], + SENSOR_TYPE_UV: ['UV', 'UV', ''], + SENSOR_TYPE_WATT: ['Power', 'W', ''], SENSOR_TYPE_LUMINANCE: ['Luminance', 'lx', ''], + SENSOR_TYPE_DEW_POINT: ['Dew Point', TEMP_CELSIUS, 'mdi:thermometer'], + SENSOR_TYPE_BAROMETRIC_PRESSURE: ['Barometric Pressure', 'kPa', ''], } @@ -86,7 +92,7 @@ class TelldusLiveSensor(TelldusLiveEntity): """Return the state of the sensor.""" if not self.available: return None - elif self._type == SENSOR_TYPE_TEMP: + elif self._type == SENSOR_TYPE_TEMPERATURE: return self._value_as_temperature elif self._type == SENSOR_TYPE_HUMIDITY: return self._value_as_humidity From 6cd9ca018ad4453d444789c08854c9fa9785c795 Mon Sep 17 00:00:00 2001 From: zhujisheng <30714273+zhujisheng@users.noreply.github.com> Date: Mon, 27 Nov 2017 17:13:25 +0800 Subject: [PATCH 153/246] Add tts.baidu platform (#10724) * Add tts.baidu platform * Update baidu.py * changed to sync get_engine and get_tts_audio changed to sync. --- .coveragerc | 1 + homeassistant/components/tts/baidu.py | 108 ++++++++++++++++++++++++++ requirements_all.txt | 3 + 3 files changed, 112 insertions(+) create mode 100644 homeassistant/components/tts/baidu.py diff --git a/.coveragerc b/.coveragerc index af4d5b32a78..b091b376579 100644 --- a/.coveragerc +++ b/.coveragerc @@ -628,6 +628,7 @@ omit = homeassistant/components/telegram_bot/* homeassistant/components/thingspeak.py homeassistant/components/tts/amazon_polly.py + homeassistant/components/tts/baidu.py homeassistant/components/tts/microsoft.py homeassistant/components/tts/picotts.py homeassistant/components/vacuum/roomba.py diff --git a/homeassistant/components/tts/baidu.py b/homeassistant/components/tts/baidu.py new file mode 100644 index 00000000000..6f86a42bbc5 --- /dev/null +++ b/homeassistant/components/tts/baidu.py @@ -0,0 +1,108 @@ +""" +Support for the baidu speech service. + +For more details about this component, please refer to the documentation at +https://home-assistant.io/components/tts.baidu/ +""" + +import logging +import voluptuous as vol + +from homeassistant.const import CONF_API_KEY +from homeassistant.components.tts import Provider, PLATFORM_SCHEMA, CONF_LANG +import homeassistant.helpers.config_validation as cv + + +REQUIREMENTS = ["baidu-aip==1.6.6"] + +_LOGGER = logging.getLogger(__name__) + + +SUPPORT_LANGUAGES = [ + 'zh', +] +DEFAULT_LANG = 'zh' + + +CONF_APP_ID = 'app_id' +CONF_SECRET_KEY = 'secret_key' +CONF_SPEED = 'speed' +CONF_PITCH = 'pitch' +CONF_VOLUME = 'volume' +CONF_PERSON = 'person' + +PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ + vol.Optional(CONF_LANG, default=DEFAULT_LANG): vol.In(SUPPORT_LANGUAGES), + vol.Required(CONF_APP_ID): cv.string, + vol.Required(CONF_API_KEY): cv.string, + vol.Required(CONF_SECRET_KEY): cv.string, + vol.Optional(CONF_SPEED, default=5): vol.All( + vol.Coerce(int), vol.Range(min=0, max=9)), + vol.Optional(CONF_PITCH, default=5): vol.All( + vol.Coerce(int), vol.Range(min=0, max=9)), + vol.Optional(CONF_VOLUME, default=5): vol.All( + vol.Coerce(int), vol.Range(min=0, max=15)), + vol.Optional(CONF_PERSON, default=0): vol.All( + vol.Coerce(int), vol.Range(min=0, max=4)), +}) + + +def get_engine(hass, config): + """Set up Baidu TTS component.""" + return BaiduTTSProvider(hass, config) + + +class BaiduTTSProvider(Provider): + """Baidu TTS speech api provider.""" + + def __init__(self, hass, conf): + """Init Baidu TTS service.""" + self.hass = hass + self._lang = conf.get(CONF_LANG) + self._codec = 'mp3' + self.name = 'BaiduTTS' + + self._app_data = { + 'appid': conf.get(CONF_APP_ID), + 'apikey': conf.get(CONF_API_KEY), + 'secretkey': conf.get(CONF_SECRET_KEY), + } + + self._speech_conf_data = { + 'spd': conf.get(CONF_SPEED), + 'pit': conf.get(CONF_PITCH), + 'vol': conf.get(CONF_VOLUME), + 'per': conf.get(CONF_PERSON), + } + + @property + def default_language(self): + """Return the default language.""" + return self._lang + + @property + def supported_languages(self): + """Return list of supported languages.""" + return SUPPORT_LANGUAGES + + def get_tts_audio(self, message, language, options=None): + """Load TTS from BaiduTTS.""" + from aip import AipSpeech + aip_speech = AipSpeech( + self._app_data['appid'], + self._app_data['apikey'], + self._app_data['secretkey'] + ) + + result = aip_speech.synthesis( + message, language, 1, self._speech_conf_data) + + if isinstance(result, dict): + _LOGGER.error( + "Baidu TTS error-- err_no:%d; err_msg:%s; err_detail:%s", + result['err_no'], + result['err_msg'], + result['err_detail']) + return (None, None) + + return (self._codec, result) diff --git a/requirements_all.txt b/requirements_all.txt index 05ad6414b20..ba5c76a0d1d 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -104,6 +104,9 @@ asterisk_mbox==0.4.0 # homeassistant.components.axis axis==14 +# homeassistant.components.tts.baidu +baidu-aip==1.6.6 + # homeassistant.components.sensor.modem_callerid basicmodem==0.7 From 2daea92379712af2642962f9471decf35762da8b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Per=20Osb=C3=A4ck?= Date: Mon, 27 Nov 2017 11:31:35 +0100 Subject: [PATCH 154/246] make RGB values consistent as int. fixes #10766 (#10782) * make RGB consitant as int. fixes #10766 * fix rounding and only change for hex convertion --- homeassistant/util/color.py | 2 +- tests/util/test_color.py | 1 + 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/homeassistant/util/color.py b/homeassistant/util/color.py index 794f6546113..9c7fa0d70e7 100644 --- a/homeassistant/util/color.py +++ b/homeassistant/util/color.py @@ -357,7 +357,7 @@ def color_rgbw_to_rgb(r, g, b, w): def color_rgb_to_hex(r, g, b): """Return a RGB color from a hex color string.""" - return '{0:02x}{1:02x}{2:02x}'.format(r, g, b) + return '{0:02x}{1:02x}{2:02x}'.format(round(r), round(g), round(b)) def rgb_hex_to_rgb_list(hex_string): diff --git a/tests/util/test_color.py b/tests/util/test_color.py index 4c14258f2f2..8b75e9e9e3f 100644 --- a/tests/util/test_color.py +++ b/tests/util/test_color.py @@ -212,6 +212,7 @@ class TestColorUtil(unittest.TestCase): assert color_util.color_rgb_to_hex(255, 255, 255) == 'ffffff' assert color_util.color_rgb_to_hex(0, 0, 0) == '000000' assert color_util.color_rgb_to_hex(51, 153, 255) == '3399ff' + assert color_util.color_rgb_to_hex(255, 67.9204190, 0) == 'ff4400' class ColorTemperatureMiredToKelvinTests(unittest.TestCase): From af1bde6619f2ec3f7a7b346369d8b196d1a323c8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Maciej=20Soko=C5=82owski?= Date: Mon, 27 Nov 2017 21:14:03 +0100 Subject: [PATCH 155/246] Single LEDs in Blinkt support (#10581) * Single LEDs in Blinkt support * Review remarks --- homeassistant/components/light/blinkt.py | 20 ++++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/homeassistant/components/light/blinkt.py b/homeassistant/components/light/blinkt.py index e2bef31089f..e331fba32c2 100644 --- a/homeassistant/components/light/blinkt.py +++ b/homeassistant/components/light/blinkt.py @@ -37,19 +37,22 @@ def setup_platform(hass, config, add_devices, discovery_info=None): name = config.get(CONF_NAME) - add_devices([BlinktLight(blinkt, name)]) + add_devices([ + BlinktLight(blinkt, name, index) for index in range(blinkt.NUM_PIXELS) + ]) class BlinktLight(Light): """Representation of a Blinkt! Light.""" - def __init__(self, blinkt, name): + def __init__(self, blinkt, name, index): """Initialize a Blinkt Light. Default brightness and white color. """ self._blinkt = blinkt - self._name = name + self._name = "{}_{}".format(name, index) + self._index = index self._is_on = False self._brightness = 255 self._rgb_color = [255, 255, 255] @@ -103,10 +106,11 @@ class BlinktLight(Light): self._brightness = kwargs[ATTR_BRIGHTNESS] percent_bright = (self._brightness / 255) - self._blinkt.set_all(self._rgb_color[0], - self._rgb_color[1], - self._rgb_color[2], - percent_bright) + self._blinkt.set_pixel(self._index, + self._rgb_color[0], + self._rgb_color[1], + self._rgb_color[2], + percent_bright) self._blinkt.show() @@ -115,7 +119,7 @@ class BlinktLight(Light): def turn_off(self, **kwargs): """Instruct the light to turn off.""" - self._blinkt.set_brightness(0) + self._blinkt.set_pixel(self._index, 0, 0, 0, 0) self._blinkt.show() self._is_on = False self.schedule_update_ha_state() From b1e2275b47e70949c018ab276279c9e6b8f6d3cf Mon Sep 17 00:00:00 2001 From: Diogo Gomes Date: Mon, 27 Nov 2017 20:25:00 +0000 Subject: [PATCH 156/246] Add debug (#10828) --- homeassistant/components/sensor/serial.py | 1 + 1 file changed, 1 insertion(+) diff --git a/homeassistant/components/sensor/serial.py b/homeassistant/components/sensor/serial.py index df0f1e21625..521dbce7df2 100644 --- a/homeassistant/components/sensor/serial.py +++ b/homeassistant/components/sensor/serial.py @@ -93,6 +93,7 @@ class SerialSensor(Entity): line = self._template.async_render_with_possible_json_value( line) + _LOGGER.debug("Received: %s", line) self._state = line self.async_schedule_update_ha_state() From 72251e0375c7d86decf75b2edeebd07b4ea51e9a Mon Sep 17 00:00:00 2001 From: Stephen Yeargin Date: Mon, 27 Nov 2017 22:54:18 -0600 Subject: [PATCH 157/246] Fix "recently pair device" (#10832) Noticed a minor grammar mistake. --- homeassistant/components/wink/services.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/homeassistant/components/wink/services.yaml b/homeassistant/components/wink/services.yaml index ffe9a2bf68a..5190b75d574 100644 --- a/homeassistant/components/wink/services.yaml +++ b/homeassistant/components/wink/services.yaml @@ -30,7 +30,7 @@ delete_wink_device: description: The entity_id of the device to delete. pull_newly_added_devices_from_wink: - description: Pull newly pair devices from Wink. + description: Pull newly paired devices from Wink. refresh_state_from_wink: description: Pull the latest states for every device. From 934c19445d967988b9de9dc9c9bca6dc60a868b3 Mon Sep 17 00:00:00 2001 From: chocomega Date: Tue, 28 Nov 2017 05:54:56 +0100 Subject: [PATCH 158/246] Fixed Yeelight's color temperature conversion to RGB (#10831) --- homeassistant/components/light/yeelight.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/homeassistant/components/light/yeelight.py b/homeassistant/components/light/yeelight.py index 126318f187f..c31bfec4927 100644 --- a/homeassistant/components/light/yeelight.py +++ b/homeassistant/components/light/yeelight.py @@ -222,7 +222,8 @@ class YeelightLight(Light): color_mode = int(color_mode) if color_mode == 2: # color temperature - return color_temperature_to_rgb(self.color_temp) + temp_in_k = mired_to_kelvin(self._color_temp) + return color_temperature_to_rgb(temp_in_k) if color_mode == 3: # hsv hue = int(self._properties.get('hue')) sat = int(self._properties.get('sat')) From 8c5d6ee9c3d8fe86d0f6af27c967599cf430ab7f Mon Sep 17 00:00:00 2001 From: Andrey Date: Tue, 28 Nov 2017 07:05:43 +0200 Subject: [PATCH 159/246] Fix for Sensibo with missing temperature (#10801) * Fix for sensibo woth missing temperature * Use new temperatureUnit API field --- homeassistant/components/climate/sensibo.py | 29 +++++++++++++-------- 1 file changed, 18 insertions(+), 11 deletions(-) diff --git a/homeassistant/components/climate/sensibo.py b/homeassistant/components/climate/sensibo.py index 9111e7821a6..4c1d0a8b9fc 100644 --- a/homeassistant/components/climate/sensibo.py +++ b/homeassistant/components/climate/sensibo.py @@ -35,7 +35,7 @@ PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ _FETCH_FIELDS = ','.join([ 'room{name}', 'measurements', 'remoteCapabilities', - 'acState', 'connectionStatus{isAlive}']) + 'acState', 'connectionStatus{isAlive}', 'temperatureUnit']) _INITIAL_FETCH_FIELDS = 'id,' + _FETCH_FIELDS @@ -55,7 +55,7 @@ def async_setup_platform(hass, config, async_add_devices, discovery_info=None): devices.append(SensiboClimate(client, dev)) except (aiohttp.client_exceptions.ClientConnectorError, asyncio.TimeoutError): - _LOGGER.exception('Failed to connct to Sensibo servers.') + _LOGGER.exception('Failed to connect to Sensibo servers.') raise PlatformNotReady if devices: @@ -63,7 +63,7 @@ def async_setup_platform(hass, config, async_add_devices, discovery_info=None): class SensiboClimate(ClimateDevice): - """Representation os a Sensibo device.""" + """Representation of a Sensibo device.""" def __init__(self, client, data): """Build SensiboClimate. @@ -84,11 +84,16 @@ class SensiboClimate(ClimateDevice): self._operations = sorted(capabilities['modes'].keys()) self._current_capabilities = capabilities[ 'modes'][self.current_operation] - temperature_unit_key = self._ac_states['temperatureUnit'] - self._temperature_unit = \ - TEMP_CELSIUS if temperature_unit_key == 'C' else TEMP_FAHRENHEIT - self._temperatures_list = self._current_capabilities[ - 'temperatures'][temperature_unit_key]['values'] + temperature_unit_key = data.get('temperatureUnit') or \ + self._ac_states.get('temperatureUnit') + if temperature_unit_key: + self._temperature_unit = TEMP_CELSIUS if \ + temperature_unit_key == 'C' else TEMP_FAHRENHEIT + self._temperatures_list = self._current_capabilities[ + 'temperatures'].get(temperature_unit_key, {}).get('values', []) + else: + self._temperature_unit = self.unit_of_measurement + self._temperatures_list = [] @property def device_state_attributes(self): @@ -108,7 +113,7 @@ class SensiboClimate(ClimateDevice): @property def target_temperature(self): """Return the temperature we try to reach.""" - return self._ac_states['targetTemperature'] + return self._ac_states.get('targetTemperature') @property def target_temperature_step(self): @@ -178,12 +183,14 @@ class SensiboClimate(ClimateDevice): @property def min_temp(self): """Return the minimum temperature.""" - return self._temperatures_list[0] + return self._temperatures_list[0] \ + if len(self._temperatures_list) else super.min_temp() @property def max_temp(self): """Return the maximum temperature.""" - return self._temperatures_list[-1] + return self._temperatures_list[-1] \ + if len(self._temperatures_list) else super.max_temp() @asyncio.coroutine def async_set_temperature(self, **kwargs): From 27270b49b472dff44b46852e561b4fdacc40491e Mon Sep 17 00:00:00 2001 From: Dan Ferrante Date: Tue, 28 Nov 2017 00:09:04 -0500 Subject: [PATCH 160/246] upgrade somecomfort to 0.5.0 (#10834) * upgrading somecomfort to 0.5.0 * upgrade somecomfort to 0.5.0 in requirements files --- homeassistant/components/climate/honeywell.py | 2 +- requirements_all.txt | 2 +- requirements_test_all.txt | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/climate/honeywell.py b/homeassistant/components/climate/honeywell.py index 253a5625ef3..a6d27665fa2 100644 --- a/homeassistant/components/climate/honeywell.py +++ b/homeassistant/components/climate/honeywell.py @@ -19,7 +19,7 @@ from homeassistant.const import ( CONF_PASSWORD, CONF_USERNAME, TEMP_CELSIUS, TEMP_FAHRENHEIT, ATTR_TEMPERATURE, CONF_REGION) -REQUIREMENTS = ['evohomeclient==0.2.5', 'somecomfort==0.4.1'] +REQUIREMENTS = ['evohomeclient==0.2.5', 'somecomfort==0.5.0'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index ba5c76a0d1d..dcb48ea597e 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -1029,7 +1029,7 @@ sleepyq==0.6 snapcast==2.0.8 # homeassistant.components.climate.honeywell -somecomfort==0.4.1 +somecomfort==0.5.0 # homeassistant.components.sensor.speedtest speedtest-cli==1.0.7 diff --git a/requirements_test_all.txt b/requirements_test_all.txt index f3e3b0046d5..ff12d18d6c6 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -153,7 +153,7 @@ rxv==0.5.1 sleepyq==0.6 # homeassistant.components.climate.honeywell -somecomfort==0.4.1 +somecomfort==0.5.0 # homeassistant.components.recorder # homeassistant.scripts.db_migrator From 0668fba7bdcf2f7b02fe180d8af935e09e4c5d4f Mon Sep 17 00:00:00 2001 From: Odin Ugedal Date: Tue, 28 Nov 2017 06:29:01 +0100 Subject: [PATCH 161/246] Add support for logarithm in templates (#10824) * Add support for logarithm in templates This adds a 'log' filter that takes the logarithm of the given value, with an optional base number. The base defaults to 'e' - the natural logarithm * Remove usage of log10 in template filter 'log' * Add logarithm as a global This makes it possible to write: '{{ log(4, 2) }}' --- homeassistant/helpers/template.py | 11 +++++++++++ tests/helpers/test_template.py | 24 ++++++++++++++++++++++++ 2 files changed, 35 insertions(+) diff --git a/homeassistant/helpers/template.py b/homeassistant/helpers/template.py index bf1b88e1c3f..1295d4961df 100644 --- a/homeassistant/helpers/template.py +++ b/homeassistant/helpers/template.py @@ -4,6 +4,7 @@ import json import logging import random import re +import math import jinja2 from jinja2 import contextfilter @@ -423,6 +424,14 @@ def multiply(value, amount): return value +def logarithm(value, base=math.e): + """Filter to get logarithm of the value with a spesific base.""" + try: + return math.log(float(value), float(base)) + except (ValueError, TypeError): + return value + + def timestamp_custom(value, date_format=DATE_STR_FORMAT, local=True): """Filter to convert given timestamp to format.""" try: @@ -508,6 +517,7 @@ class TemplateEnvironment(ImmutableSandboxedEnvironment): ENV = TemplateEnvironment() ENV.filters['round'] = forgiving_round ENV.filters['multiply'] = multiply +ENV.filters['log'] = logarithm ENV.filters['timestamp_custom'] = timestamp_custom ENV.filters['timestamp_local'] = timestamp_local ENV.filters['timestamp_utc'] = timestamp_utc @@ -515,6 +525,7 @@ ENV.filters['is_defined'] = fail_when_undefined ENV.filters['max'] = max ENV.filters['min'] = min ENV.filters['random'] = random_every_time +ENV.globals['log'] = logarithm ENV.globals['float'] = forgiving_float ENV.globals['now'] = dt_util.now ENV.globals['utcnow'] = dt_util.utcnow diff --git a/tests/helpers/test_template.py b/tests/helpers/test_template.py index a214d69f80a..614d2f881a0 100644 --- a/tests/helpers/test_template.py +++ b/tests/helpers/test_template.py @@ -3,6 +3,7 @@ import asyncio from datetime import datetime import unittest import random +import math from unittest.mock import patch from homeassistant.components import group @@ -125,6 +126,29 @@ class TestHelpersTemplate(unittest.TestCase): template.Template('{{ %s | multiply(10) | round }}' % inp, self.hass).render()) + def test_logarithm(self): + """Test logarithm.""" + tests = [ + (4, 2, '2.0'), + (1000, 10, '3.0'), + (math.e, '', '1.0'), + ('"invalid"', '_', 'invalid'), + (10, '"invalid"', '10.0'), + ] + + for value, base, expected in tests: + self.assertEqual( + expected, + template.Template( + '{{ %s | log(%s) | round(1) }}' % (value, base), + self.hass).render()) + + self.assertEqual( + expected, + template.Template( + '{{ log(%s, %s) | round(1) }}' % (value, base), + self.hass).render()) + def test_strptime(self): """Test the parse timestamp method.""" tests = [ From 282e37ef1439a575134171a4811ce3cb04b63066 Mon Sep 17 00:00:00 2001 From: Zach Date: Tue, 28 Nov 2017 00:43:01 -0500 Subject: [PATCH 162/246] Changing handling for google_assistant groups to treat them as lights. (#10111) * Fixed aliases warning message * Fixed test cases * Changing handling for google_assistant groups to treat them as lights - amending to include user info. * Enable brightness, RGB, etc for groups in Google Assistant * Revert color/hue/temp settings * Change servce from light to homeassistant * Fixed config_units * Convert from light to switch * Change group to switch * Update tests to switch instead of light for group --- .../components/google_assistant/http.py | 2 ++ .../components/google_assistant/smart_home.py | 11 ++++++----- tests/components/google_assistant/__init__.py | 16 ++++++++-------- 3 files changed, 16 insertions(+), 13 deletions(-) diff --git a/homeassistant/components/google_assistant/http.py b/homeassistant/components/google_assistant/http.py index ab9705432fb..c339c8a4dc5 100644 --- a/homeassistant/components/google_assistant/http.py +++ b/homeassistant/components/google_assistant/http.py @@ -133,6 +133,8 @@ class GoogleAssistantView(HomeAssistantView): (service, service_data) = determine_service( eid, execution.get('command'), execution.get('params'), hass.config.units) + if domain == "group": + domain = "homeassistant" success = yield from hass.services.async_call( domain, service, service_data, blocking=True) result = {"ids": [eid], "states": {}} diff --git a/homeassistant/components/google_assistant/smart_home.py b/homeassistant/components/google_assistant/smart_home.py index 634d5074a0e..23876a068f9 100644 --- a/homeassistant/components/google_assistant/smart_home.py +++ b/homeassistant/components/google_assistant/smart_home.py @@ -39,7 +39,7 @@ _LOGGER = logging.getLogger(__name__) # Mapping is [actions schema, primary trait, optional features] # optional is SUPPORT_* = (trait, command) MAPPING_COMPONENT = { - group.DOMAIN: [TYPE_SCENE, TRAIT_SCENE, None], + group.DOMAIN: [TYPE_SWITCH, TRAIT_ONOFF, None], scene.DOMAIN: [TYPE_SCENE, TRAIT_SCENE, None], script.DOMAIN: [TYPE_SCENE, TRAIT_SCENE, None], switch.DOMAIN: [TYPE_SWITCH, TRAIT_ONOFF, None], @@ -94,10 +94,11 @@ def entity_to_device(entity: Entity, units: UnitSystem): # use aliases aliases = entity.attributes.get(CONF_ALIASES) - if isinstance(aliases, list): - device['name']['nicknames'] = aliases - else: - _LOGGER.warning("%s must be a list", CONF_ALIASES) + if aliases: + if isinstance(aliases, list): + device['name']['nicknames'] = aliases + else: + _LOGGER.warning("%s must be a list", CONF_ALIASES) # add trait if entity supports feature if class_data[2]: diff --git a/tests/components/google_assistant/__init__.py b/tests/components/google_assistant/__init__.py index f424fb92647..bcb12c70b58 100644 --- a/tests/components/google_assistant/__init__.py +++ b/tests/components/google_assistant/__init__.py @@ -75,16 +75,16 @@ DEMO_DEVICES = [{ 'name': { 'name': 'all lights' }, - 'traits': ['action.devices.traits.Scene'], - 'type': 'action.devices.types.SCENE', + 'traits': ['action.devices.traits.OnOff'], + 'type': 'action.devices.types.SWITCH', 'willReportState': False }, { 'id': 'group.all_switches', 'name': { 'name': 'all switches' }, - 'traits': ['action.devices.traits.Scene'], - 'type': 'action.devices.types.SCENE', + 'traits': ['action.devices.traits.OnOff'], + 'type': 'action.devices.types.SWITCH', 'willReportState': False }, { 'id': @@ -131,8 +131,8 @@ DEMO_DEVICES = [{ 'name': { 'name': 'all covers' }, - 'traits': ['action.devices.traits.Scene'], - 'type': 'action.devices.types.SCENE', + 'traits': ['action.devices.traits.OnOff'], + 'type': 'action.devices.types.SWITCH', 'willReportState': False }, { 'id': @@ -199,8 +199,8 @@ DEMO_DEVICES = [{ 'name': { 'name': 'all fans' }, - 'traits': ['action.devices.traits.Scene'], - 'type': 'action.devices.types.SCENE', + 'traits': ['action.devices.traits.OnOff'], + 'type': 'action.devices.types.SWITCH', 'willReportState': False }, { 'id': 'climate.hvac', From 6df5e712f7ab7e4275c7eca09e8494641d5485c2 Mon Sep 17 00:00:00 2001 From: Fredrik Erlandsson Date: Tue, 28 Nov 2017 08:13:30 +0100 Subject: [PATCH 163/246] Tellduslive update with support for auto config and Local api (#10435) * Add support for local api connection found in TellStick Znet Lite/Pro. Added auto discovery support for all TelldusLive devices, changed authentication method. Breaking change! Upgraded tellduslive dependency Update CODEOWNERS. * Close any open configurator when configuration done * Add support for Telldus Local API via config (#2) * Updated dependency (addresses issue raised by @rasmusbe in https://github.com/home-assistant/home-assistant/pull/10435#issuecomment-344719714) * Fix requested changes --- CODEOWNERS | 2 + homeassistant/components/discovery.py | 2 + .../www_static/images/logo_tellduslive.png | Bin 0 -> 7796 bytes homeassistant/components/tellduslive.py | 202 ++++++++++++++---- requirements_all.txt | 2 +- 5 files changed, 169 insertions(+), 39 deletions(-) create mode 100644 homeassistant/components/frontend/www_static/images/logo_tellduslive.png diff --git a/CODEOWNERS b/CODEOWNERS index 069edd6cce2..6fa130432f4 100644 --- a/CODEOWNERS +++ b/CODEOWNERS @@ -74,6 +74,8 @@ homeassistant/components/tahoma.py @philklei homeassistant/components/*/tahoma.py @philklei homeassistant/components/tesla.py @zabuldon homeassistant/components/*/tesla.py @zabuldon +homeassistant/components/tellduslive.py @molobrakos @fredrike +homeassistant/components/*/tellduslive.py @molobrakos @fredrike homeassistant/components/*/tradfri.py @ggravlingen homeassistant/components/*/xiaomi_aqara.py @danielhiversen @syssi homeassistant/components/*/xiaomi_miio.py @rytilahti @syssi diff --git a/homeassistant/components/discovery.py b/homeassistant/components/discovery.py index 6861c5bdc70..5d362f21cef 100644 --- a/homeassistant/components/discovery.py +++ b/homeassistant/components/discovery.py @@ -35,6 +35,7 @@ SERVICE_AXIS = 'axis' SERVICE_APPLE_TV = 'apple_tv' SERVICE_WINK = 'wink' SERVICE_XIAOMI_GW = 'xiaomi_gw' +SERVICE_TELLDUSLIVE = 'tellstick' SERVICE_HANDLERS = { SERVICE_HASS_IOS_APP: ('ios', None), @@ -46,6 +47,7 @@ SERVICE_HANDLERS = { SERVICE_APPLE_TV: ('apple_tv', None), SERVICE_WINK: ('wink', None), SERVICE_XIAOMI_GW: ('xiaomi_aqara', None), + SERVICE_TELLDUSLIVE: ('tellduslive', None), 'philips_hue': ('light', 'hue'), 'google_cast': ('media_player', 'cast'), 'panasonic_viera': ('media_player', 'panasonic_viera'), diff --git a/homeassistant/components/frontend/www_static/images/logo_tellduslive.png b/homeassistant/components/frontend/www_static/images/logo_tellduslive.png new file mode 100644 index 0000000000000000000000000000000000000000..7ea78f8ef3aad4d3cd982835c797693a68264c00 GIT binary patch literal 7796 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 literal 0 HcmV?d00001 diff --git a/homeassistant/components/tellduslive.py b/homeassistant/components/tellduslive.py index a0e1efbd75c..fa8916aca11 100644 --- a/homeassistant/components/tellduslive.py +++ b/homeassistant/components/tellduslive.py @@ -8,35 +8,41 @@ from datetime import datetime, timedelta import logging from homeassistant.const import ( - ATTR_BATTERY_LEVEL, DEVICE_DEFAULT_NAME, EVENT_HOMEASSISTANT_START) + ATTR_BATTERY_LEVEL, DEVICE_DEFAULT_NAME, + CONF_TOKEN, CONF_HOST, + EVENT_HOMEASSISTANT_START) from homeassistant.helpers import discovery +from homeassistant.components.discovery import SERVICE_TELLDUSLIVE import homeassistant.helpers.config_validation as cv from homeassistant.helpers.entity import Entity from homeassistant.helpers.event import track_point_in_utc_time from homeassistant.util.dt import utcnow +from homeassistant.util.json import load_json, save_json import voluptuous as vol +APPLICATION_NAME = 'Home Assistant' + DOMAIN = 'tellduslive' -REQUIREMENTS = ['tellduslive==0.3.4'] +REQUIREMENTS = ['tellduslive==0.10.3'] _LOGGER = logging.getLogger(__name__) -CONF_PUBLIC_KEY = 'public_key' -CONF_PRIVATE_KEY = 'private_key' -CONF_TOKEN = 'token' +TELLLDUS_CONFIG_FILE = 'tellduslive.conf' +KEY_CONFIG = 'tellduslive_config' + CONF_TOKEN_SECRET = 'token_secret' CONF_UPDATE_INTERVAL = 'update_interval' +PUBLIC_KEY = 'THUPUNECH5YEQA3RE6UYUPRUZ2DUGUGA' +NOT_SO_PRIVATE_KEY = 'PHES7U2RADREWAFEBUSTUBAWRASWUTUS' + MIN_UPDATE_INTERVAL = timedelta(seconds=5) DEFAULT_UPDATE_INTERVAL = timedelta(minutes=1) CONFIG_SCHEMA = vol.Schema({ DOMAIN: vol.Schema({ - vol.Required(CONF_PUBLIC_KEY): cv.string, - vol.Required(CONF_PRIVATE_KEY): cv.string, - vol.Required(CONF_TOKEN): cv.string, - vol.Required(CONF_TOKEN_SECRET): cv.string, + vol.Optional(CONF_HOST): cv.string, vol.Optional(CONF_UPDATE_INTERVAL, default=DEFAULT_UPDATE_INTERVAL): ( vol.All(cv.time_period, vol.Clamp(min=MIN_UPDATE_INTERVAL))) }), @@ -45,21 +51,156 @@ CONFIG_SCHEMA = vol.Schema({ ATTR_LAST_UPDATED = 'time_last_updated' +CONFIG_INSTRUCTIONS = """ +To link your TelldusLive account: -def setup(hass, config): +1. Click the link below + +2. Login to Telldus Live + +3. Authorize {app_name}. + +4. Click the Confirm button. + +[Link TelldusLive account]({auth_url}) +""" + + +def setup(hass, config, session=None): """Set up the Telldus Live component.""" - client = TelldusLiveClient(hass, config) + from tellduslive import Session, supports_local_api + config_filename = hass.config.path(TELLLDUS_CONFIG_FILE) + conf = load_json(config_filename) - if not client.validate_session(): + def request_configuration(host=None): + """Request TelldusLive authorization.""" + configurator = hass.components.configurator + hass.data.setdefault(KEY_CONFIG, {}) + data_key = host or DOMAIN + + # Configuration already in progress + if hass.data[KEY_CONFIG].get(data_key): + return + + _LOGGER.info('Configuring TelldusLive %s', + 'local client: {}'.format(host) if host else + 'cloud service') + + session = Session(public_key=PUBLIC_KEY, + private_key=NOT_SO_PRIVATE_KEY, + host=host, + application=APPLICATION_NAME) + + auth_url = session.authorize_url + if not auth_url: + _LOGGER.warning('Failed to retrieve authorization URL') + return + + _LOGGER.debug('Got authorization URL %s', auth_url) + + def configuration_callback(callback_data): + """Handle the submitted configuration.""" + session.authorize() + res = setup(hass, config, session) + if not res: + configurator.notify_errors( + hass.data[KEY_CONFIG].get(data_key), + 'Unable to connect.') + return + + conf.update( + {host: {CONF_HOST: host, + CONF_TOKEN: session.access_token}} if host else + {DOMAIN: {CONF_TOKEN: session.access_token, + CONF_TOKEN_SECRET: session.access_token_secret}}) + save_json(config_filename, conf) + # Close all open configurators: for now, we only support one + # tellstick device, and configuration via either cloud service + # or via local API, not both at the same time + for instance in hass.data[KEY_CONFIG].values(): + configurator.request_done(instance) + + hass.data[KEY_CONFIG][data_key] = \ + configurator.request_config( + 'TelldusLive ({})'.format( + 'LocalAPI' if host + else 'Cloud service'), + configuration_callback, + description=CONFIG_INSTRUCTIONS.format( + app_name=APPLICATION_NAME, + auth_url=auth_url), + submit_caption='Confirm', + entity_picture='/static/images/logo_tellduslive.png', + ) + + def tellstick_discovered(service, info): + """Run when a Tellstick is discovered.""" + _LOGGER.info('Discovered tellstick device') + + if DOMAIN in hass.data: + _LOGGER.debug('Tellstick already configured') + return + + host, device = info[:2] + + if not supports_local_api(device): + _LOGGER.debug('Tellstick does not support local API') + # Configure the cloud service + hass.async_add_job(request_configuration) + return + + _LOGGER.debug('Tellstick does support local API') + + # Ignore any known devices + if conf and host in conf: + _LOGGER.debug('Discovered already known device: %s', host) + return + + # Offer configuration of both live and local API + request_configuration() + request_configuration(host) + + discovery.listen(hass, SERVICE_TELLDUSLIVE, tellstick_discovered) + + if session: + _LOGGER.debug('Continuing setup configured by configurator') + elif conf and CONF_HOST in next(iter(conf.values())): + # For now, only one local device is supported + _LOGGER.debug('Using Local API pre-configured by configurator') + session = Session(**next(iter(conf.values()))) + elif DOMAIN in conf: + _LOGGER.debug('Using TelldusLive cloud service ' + 'pre-configured by configurator') + session = Session(PUBLIC_KEY, NOT_SO_PRIVATE_KEY, + application=APPLICATION_NAME, **conf[DOMAIN]) + elif config.get(DOMAIN): + _LOGGER.info('Found entry in configuration.yaml. ' + 'Requesting TelldusLive cloud service configuration') + request_configuration() + + if CONF_HOST in config.get(DOMAIN, {}): + _LOGGER.info('Found TelldusLive host entry in configuration.yaml. ' + 'Requesting Telldus Local API configuration') + request_configuration(config.get(DOMAIN).get(CONF_HOST)) + + return True + else: + _LOGGER.info('Tellstick discovered, awaiting discovery callback') + return True + + if not session.is_authorized: _LOGGER.error( - "Authentication Error: Please make sure you have configured your " - "keys that can be acquired from " - "https://api.telldus.com/keys/index") + 'Authentication Error') return False + client = TelldusLiveClient(hass, config, session) + hass.data[DOMAIN] = client - hass.bus.listen(EVENT_HOMEASSISTANT_START, client.update) + if session: + client.update() + else: + hass.bus.listen(EVENT_HOMEASSISTANT_START, client.update) return True @@ -67,36 +208,21 @@ def setup(hass, config): class TelldusLiveClient(object): """Get the latest data and update the states.""" - def __init__(self, hass, config): + def __init__(self, hass, config, session): """Initialize the Tellus data object.""" - from tellduslive import Client - - public_key = config[DOMAIN].get(CONF_PUBLIC_KEY) - private_key = config[DOMAIN].get(CONF_PRIVATE_KEY) - token = config[DOMAIN].get(CONF_TOKEN) - token_secret = config[DOMAIN].get(CONF_TOKEN_SECRET) - self.entities = [] self._hass = hass self._config = config - self._interval = config[DOMAIN].get(CONF_UPDATE_INTERVAL) + self._interval = config.get(DOMAIN, {}).get( + CONF_UPDATE_INTERVAL, DEFAULT_UPDATE_INTERVAL) _LOGGER.debug('Update interval %s', self._interval) - - self._client = Client(public_key, - private_key, - token, - token_secret) - - def validate_session(self): - """Make a request to see if the session is valid.""" - response = self._client.request_user() - return response and 'email' in response + self._client = session def update(self, *args): """Periodically poll the servers for current state.""" - _LOGGER.debug("Updating") + _LOGGER.debug('Updating') try: self._sync() finally: @@ -106,7 +232,7 @@ class TelldusLiveClient(object): def _sync(self): """Update local list of devices.""" if not self._client.update(): - _LOGGER.warning("Failed request") + _LOGGER.warning('Failed request') def identify_device(device): """Find out what type of HA component to create.""" @@ -161,7 +287,7 @@ class TelldusLiveEntity(Entity): self._client = hass.data[DOMAIN] self._client.entities.append(self) self._name = self.device.name - _LOGGER.debug("Created device %s", self) + _LOGGER.debug('Created device %s', self) def changed(self): """Return the property of the device might have changed.""" diff --git a/requirements_all.txt b/requirements_all.txt index dcb48ea597e..76f84ea9ebe 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -1064,7 +1064,7 @@ tellcore-net==0.1 tellcore-py==1.1.2 # homeassistant.components.tellduslive -tellduslive==0.3.4 +tellduslive==0.10.3 # homeassistant.components.sensor.temper temperusb==1.5.3 From cadd797200e339e165dbeff152169e4f4d716e2d Mon Sep 17 00:00:00 2001 From: Julius Mittenzwei Date: Tue, 28 Nov 2017 08:15:57 +0100 Subject: [PATCH 164/246] KNX: Added config option for broadcasting current time to KNX bus. (#10654) --- homeassistant/components/knx.py | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/homeassistant/components/knx.py b/homeassistant/components/knx.py index 3966b490f52..d426e79ace9 100644 --- a/homeassistant/components/knx.py +++ b/homeassistant/components/knx.py @@ -27,6 +27,7 @@ CONF_KNX_LOCAL_IP = "local_ip" CONF_KNX_FIRE_EVENT = "fire_event" CONF_KNX_FIRE_EVENT_FILTER = "fire_event_filter" CONF_KNX_STATE_UPDATER = "state_updater" +CONF_KNX_TIME_ADDRESS = "time_address" SERVICE_KNX_SEND = "send" SERVICE_KNX_ATTR_ADDRESS = "address" @@ -60,6 +61,7 @@ CONFIG_SCHEMA = vol.Schema({ vol.All( cv.ensure_list, [cv.string]), + vol.Optional(CONF_KNX_TIME_ADDRESS): cv.string, vol.Optional(CONF_KNX_STATE_UPDATER, default=True): cv.boolean, }) }, extra=vol.ALLOW_EXTRA) @@ -97,6 +99,9 @@ def async_setup(hass, config): ATTR_DISCOVER_DEVICES: found_devices }, config)) + if CONF_KNX_TIME_ADDRESS in config[DOMAIN]: + _add_time_device(hass, config) + hass.services.async_register( DOMAIN, SERVICE_KNX_SEND, hass.data[DATA_KNX].service_send_to_knx_bus, @@ -105,6 +110,17 @@ def async_setup(hass, config): return True +def _add_time_device(hass, config): + """Create time broadcasting device and add it to xknx device queue.""" + import xknx + group_address_time = config[DOMAIN][CONF_KNX_TIME_ADDRESS] + time = xknx.devices.Time( + hass.data[DATA_KNX].xknx, + 'Time', + group_address=group_address_time) + hass.data[DATA_KNX].xknx.devices.add(time) + + def _get_devices(hass, discovery_type): return list( map(lambda device: device.name, From 1f82bb033df7a7c6b7611e1a0bdb464a544f5355 Mon Sep 17 00:00:00 2001 From: Cameron Bulock Date: Tue, 28 Nov 2017 04:39:30 -0500 Subject: [PATCH 165/246] Ecobee set humidity level (#10780) * Add the ability to set humidity levels on ecobee thermostats * use the latest version of python-ecobee-api * Lint fixes --- homeassistant/components/climate/ecobee.py | 4 ++++ homeassistant/components/ecobee.py | 2 +- requirements_all.txt | 2 +- 3 files changed, 6 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/climate/ecobee.py b/homeassistant/components/climate/ecobee.py index d6d92432730..100312f643e 100644 --- a/homeassistant/components/climate/ecobee.py +++ b/homeassistant/components/climate/ecobee.py @@ -357,6 +357,10 @@ class Thermostat(ClimateDevice): _LOGGER.error( "Missing valid arguments for set_temperature in %s", kwargs) + def set_humidity(self, humidity): + """Set the humidity level.""" + self.data.ecobee.set_humidity(self.thermostat_index, humidity) + def set_operation_mode(self, operation_mode): """Set HVAC mode (auto, auxHeatOnly, cool, heat, off).""" self.data.ecobee.set_hvac_mode(self.thermostat_index, operation_mode) diff --git a/homeassistant/components/ecobee.py b/homeassistant/components/ecobee.py index 31cf31dac1e..d69770e3a5e 100644 --- a/homeassistant/components/ecobee.py +++ b/homeassistant/components/ecobee.py @@ -16,7 +16,7 @@ from homeassistant.const import CONF_API_KEY from homeassistant.util import Throttle from homeassistant.util.json import save_json -REQUIREMENTS = ['python-ecobee-api==0.0.10'] +REQUIREMENTS = ['python-ecobee-api==0.0.11'] _CONFIGURING = {} _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index 76f84ea9ebe..3c22494199f 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -809,7 +809,7 @@ python-clementine-remote==1.0.1 python-digitalocean==1.12 # homeassistant.components.ecobee -python-ecobee-api==0.0.10 +python-ecobee-api==0.0.11 # homeassistant.components.climate.eq3btsmart # python-eq3bt==0.1.6 From 4e4d4365a0ef1a20d181f1015152acb116226e3d Mon Sep 17 00:00:00 2001 From: Matt Schmitt Date: Tue, 28 Nov 2017 09:25:32 -0500 Subject: [PATCH 166/246] Add device class for low battery (#10829) --- homeassistant/components/binary_sensor/__init__.py | 1 + 1 file changed, 1 insertion(+) diff --git a/homeassistant/components/binary_sensor/__init__.py b/homeassistant/components/binary_sensor/__init__.py index e4ff0982718..9e48a30d04a 100644 --- a/homeassistant/components/binary_sensor/__init__.py +++ b/homeassistant/components/binary_sensor/__init__.py @@ -20,6 +20,7 @@ SCAN_INTERVAL = timedelta(seconds=30) ENTITY_ID_FORMAT = DOMAIN + '.{}' DEVICE_CLASSES = [ + 'battery', # On means low, Off means normal 'cold', # On means cold (or too cold) 'connectivity', # On means connection present, Off = no connection 'gas', # CO, CO2, etc. From 7ab15c0e79fecdfaa0f29f6691b45429a6a04cdc Mon Sep 17 00:00:00 2001 From: Erik Eriksson Date: Tue, 28 Nov 2017 15:32:36 +0100 Subject: [PATCH 167/246] Tellduslive: Use magic constants for battery level. Also, the previous formula for battery level was wrong. (#10788) --- homeassistant/components/tellduslive.py | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/tellduslive.py b/homeassistant/components/tellduslive.py index fa8916aca11..ba7c1afd286 100644 --- a/homeassistant/components/tellduslive.py +++ b/homeassistant/components/tellduslive.py @@ -343,8 +343,17 @@ class TelldusLiveEntity(Entity): @property def _battery_level(self): """Return the battery level of a device.""" - return round(self.device.battery * 100 / 255) \ - if self.device.battery else None + from tellduslive import (BATTERY_LOW, + BATTERY_UNKNOWN, + BATTERY_OK) + if self.device.battery == BATTERY_LOW: + return 1 + elif self.device.battery == BATTERY_UNKNOWN: + return None + elif self.device.battery == BATTERY_OK: + return 100 + else: + return self.device.battery # Percentage @property def _last_updated(self): From 99ea2c17a1d5db86179abcfbebb70e4b232ccbef Mon Sep 17 00:00:00 2001 From: Andrey Date: Wed, 29 Nov 2017 08:53:12 +0200 Subject: [PATCH 168/246] Add useragent-based detection of JS version (#10776) * Add useragent-based detection of JS version * Keep es5 as default meanwhile * Update test --- homeassistant/components/frontend/__init__.py | 63 +++++++++++++++---- requirements_all.txt | 3 + tests/components/test_frontend.py | 19 +++++- 3 files changed, 69 insertions(+), 16 deletions(-) diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index d209955cfac..74090c78107 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -23,7 +23,7 @@ from homeassistant.const import CONF_NAME, EVENT_THEMES_UPDATED from homeassistant.core import callback from homeassistant.loader import bind_hass -REQUIREMENTS = ['home-assistant-frontend==20171127.0'] +REQUIREMENTS = ['home-assistant-frontend==20171127.0', 'user-agents==1.1.0'] DOMAIN = 'frontend' DEPENDENCIES = ['api', 'websocket_api', 'http', 'system_log'] @@ -32,6 +32,7 @@ URL_PANEL_COMPONENT_FP = '/frontend/panels/{}-{}.html' CONF_THEMES = 'themes' CONF_EXTRA_HTML_URL = 'extra_html_url' +CONF_EXTRA_HTML_URL_ES5 = 'extra_html_url_es5' CONF_FRONTEND_REPO = 'development_repo' CONF_JS_VERSION = 'javascript_version' JS_DEFAULT_OPTION = 'es5' @@ -63,6 +64,7 @@ DATA_FINALIZE_PANEL = 'frontend_finalize_panel' DATA_PANELS = 'frontend_panels' DATA_JS_VERSION = 'frontend_js_version' DATA_EXTRA_HTML_URL = 'frontend_extra_html_url' +DATA_EXTRA_HTML_URL_ES5 = 'frontend_extra_html_url_es5' DATA_THEMES = 'frontend_themes' DATA_DEFAULT_THEME = 'frontend_default_theme' DEFAULT_THEME = 'default' @@ -79,6 +81,8 @@ CONFIG_SCHEMA = vol.Schema({ }), vol.Optional(CONF_EXTRA_HTML_URL): vol.All(cv.ensure_list, [cv.string]), + vol.Optional(CONF_EXTRA_HTML_URL_ES5): + vol.All(cv.ensure_list, [cv.string]), vol.Optional(CONF_JS_VERSION, default=JS_DEFAULT_OPTION): vol.In(JS_OPTIONS) }), @@ -269,11 +273,12 @@ def async_register_panel(hass, component_name, path, md5=None, @bind_hass @callback -def add_extra_html_url(hass, url): +def add_extra_html_url(hass, url, es5=False): """Register extra html url to load.""" - url_set = hass.data.get(DATA_EXTRA_HTML_URL) + key = DATA_EXTRA_HTML_URL_ES5 if es5 else DATA_EXTRA_HTML_URL + url_set = hass.data.get(key) if url_set is None: - url_set = hass.data[DATA_EXTRA_HTML_URL] = set() + url_set = hass.data[key] = set() url_set.add(url) @@ -358,9 +363,13 @@ def async_setup(hass, config): if DATA_EXTRA_HTML_URL not in hass.data: hass.data[DATA_EXTRA_HTML_URL] = set() + if DATA_EXTRA_HTML_URL_ES5 not in hass.data: + hass.data[DATA_EXTRA_HTML_URL_ES5] = set() for url in conf.get(CONF_EXTRA_HTML_URL, []): - add_extra_html_url(hass, url) + add_extra_html_url(hass, url, False) + for url in conf.get(CONF_EXTRA_HTML_URL_ES5, []): + add_extra_html_url(hass, url, True) yield from async_setup_themes(hass, conf.get(CONF_THEMES)) @@ -488,12 +497,14 @@ class IndexView(HomeAssistantView): template = yield from hass.async_add_job(self.get_template, latest) + extra_key = DATA_EXTRA_HTML_URL if latest else DATA_EXTRA_HTML_URL_ES5 + resp = template.render( no_auth=no_auth, panel_url=panel_url, panels=hass.data[DATA_PANELS], theme_color=MANIFEST_JSON['theme_color'], - extra_urls=hass.data[DATA_EXTRA_HTML_URL], + extra_urls=hass.data[extra_key], ) return web.Response(text=resp, content_type='text/html') @@ -545,10 +556,36 @@ def _is_latest(js_option, request): """ if request is None: return js_option == 'latest' - latest_in_query = 'latest' in request.query or ( - request.headers.get('Referer') and - 'latest' in urlparse(request.headers['Referer']).query) - es5_in_query = 'es5' in request.query or ( - request.headers.get('Referer') and - 'es5' in urlparse(request.headers['Referer']).query) - return latest_in_query or (not es5_in_query and js_option == 'latest') + + # latest in query + if 'latest' in request.query or ( + request.headers.get('Referer') and + 'latest' in urlparse(request.headers['Referer']).query): + return True + + # es5 in query + if 'es5' in request.query or ( + request.headers.get('Referer') and + 'es5' in urlparse(request.headers['Referer']).query): + return False + + # non-auto option in config + if js_option != 'auto': + return js_option == 'latest' + + from user_agents import parse + useragent = parse(request.headers.get('User-Agent')) + + # on iOS every browser is a Safari which we support from version 10. + if useragent.os.family == 'iOS': + return useragent.os.version[0] >= 10 + + family_min_version = { + 'Chrome': 50, # Probably can reduce this + 'Firefox': 41, # Destructuring added in 41 + 'Opera': 40, # Probably can reduce this + 'Edge': 14, # Maybe can reduce this + 'Safari': 10, # many features not supported by 9 + } + version = family_min_version.get(useragent.browser.family) + return version and useragent.browser.version[0] >= version diff --git a/requirements_all.txt b/requirements_all.txt index 3c22494199f..47cc3952ed5 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -1100,6 +1100,9 @@ uber_rides==0.6.0 # homeassistant.components.sensor.ups upsmychoice==1.0.6 +# homeassistant.components.frontend +user-agents==1.1.0 + # homeassistant.components.camera.uvc uvcclient==0.10.1 diff --git a/tests/components/test_frontend.py b/tests/components/test_frontend.py index bd2d8afc209..c4ade7f5c19 100644 --- a/tests/components/test_frontend.py +++ b/tests/components/test_frontend.py @@ -7,7 +7,8 @@ import pytest from homeassistant.setup import async_setup_component from homeassistant.components.frontend import ( - DOMAIN, CONF_THEMES, CONF_EXTRA_HTML_URL, DATA_PANELS) + DOMAIN, CONF_JS_VERSION, CONF_THEMES, CONF_EXTRA_HTML_URL, + CONF_EXTRA_HTML_URL_ES5, DATA_PANELS) @pytest.fixture @@ -36,7 +37,10 @@ def mock_http_client_with_urls(hass, test_client): """Start the Hass HTTP component.""" hass.loop.run_until_complete(async_setup_component(hass, 'frontend', { DOMAIN: { - CONF_EXTRA_HTML_URL: ["https://domain.com/my_extra_url.html"] + CONF_JS_VERSION: 'auto', + CONF_EXTRA_HTML_URL: ["https://domain.com/my_extra_url.html"], + CONF_EXTRA_HTML_URL_ES5: + ["https://domain.com/my_extra_url_es5.html"] }})) return hass.loop.run_until_complete(test_client(hass.http.app)) @@ -163,12 +167,21 @@ def test_missing_themes(mock_http_client): @asyncio.coroutine def test_extra_urls(mock_http_client_with_urls): """Test that extra urls are loaded.""" - resp = yield from mock_http_client_with_urls.get('/states') + resp = yield from mock_http_client_with_urls.get('/states?latest') assert resp.status == 200 text = yield from resp.text() assert text.find('href="https://domain.com/my_extra_url.html"') >= 0 +@asyncio.coroutine +def test_extra_urls_es5(mock_http_client_with_urls): + """Test that es5 extra urls are loaded.""" + resp = yield from mock_http_client_with_urls.get('/states?es5') + assert resp.status == 200 + text = yield from resp.text() + assert text.find('href="https://domain.com/my_extra_url_es5.html"') >= 0 + + @asyncio.coroutine def test_panel_without_path(hass): """Test panel registration without file path.""" From 253d5aea6e0730a45c0013826657f55be9445a2d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Per=20Osb=C3=A4ck?= Date: Wed, 29 Nov 2017 08:16:29 +0100 Subject: [PATCH 169/246] add support for multiple execution per execute request (#10844) --- .../components/google_assistant/http.py | 34 +++++++++---------- .../google_assistant/test_google_assistant.py | 30 ++++++++++++++-- 2 files changed, 44 insertions(+), 20 deletions(-) diff --git a/homeassistant/components/google_assistant/http.py b/homeassistant/components/google_assistant/http.py index c339c8a4dc5..a9512404b1e 100644 --- a/homeassistant/components/google_assistant/http.py +++ b/homeassistant/components/google_assistant/http.py @@ -126,23 +126,23 @@ class GoogleAssistantView(HomeAssistantView): commands = [] for command in requested_commands: ent_ids = [ent.get('id') for ent in command.get('devices', [])] - execution = command.get('execution')[0] - for eid in ent_ids: - success = False - domain = eid.split('.')[0] - (service, service_data) = determine_service( - eid, execution.get('command'), execution.get('params'), - hass.config.units) - if domain == "group": - domain = "homeassistant" - success = yield from hass.services.async_call( - domain, service, service_data, blocking=True) - result = {"ids": [eid], "states": {}} - if success: - result['status'] = 'SUCCESS' - else: - result['status'] = 'ERROR' - commands.append(result) + for execution in command.get('execution'): + for eid in ent_ids: + success = False + domain = eid.split('.')[0] + (service, service_data) = determine_service( + eid, execution.get('command'), execution.get('params'), + hass.config.units) + if domain == "group": + domain = "homeassistant" + success = yield from hass.services.async_call( + domain, service, service_data, blocking=True) + result = {"ids": [eid], "states": {}} + if success: + result['status'] = 'SUCCESS' + else: + result['status'] = 'ERROR' + commands.append(result) return self.json( _make_actions_response(request_id, {'commands': commands})) diff --git a/tests/components/google_assistant/test_google_assistant.py b/tests/components/google_assistant/test_google_assistant.py index dba10608991..05178649c88 100644 --- a/tests/components/google_assistant/test_google_assistant.py +++ b/tests/components/google_assistant/test_google_assistant.py @@ -316,8 +316,6 @@ def test_execute_request(hass_fixture, assistant_client): "id": "light.ceiling_lights", }, { "id": "switch.decorative_lights", - }, { - "id": "light.bed_light", }], "execution": [{ "command": "action.devices.commands.OnOff", @@ -350,6 +348,25 @@ def test_execute_request(hass_fixture, assistant_client): } } }] + }, { + "devices": [{ + "id": "light.bed_light" + }], + "execution": [{ + "command": "action.devices.commands.ColorAbsolute", + "params": { + "color": { + "spectrumRGB": 65280 + } + } + }, { + "command": "action.devices.commands.ColorAbsolute", + "params": { + "color": { + "temperature": 4700 + } + } + }] }] } }] @@ -362,10 +379,17 @@ def test_execute_request(hass_fixture, assistant_client): body = yield from result.json() assert body.get('requestId') == reqid commands = body['payload']['commands'] - assert len(commands) == 5 + assert len(commands) == 6 + ceiling = hass_fixture.states.get('light.ceiling_lights') assert ceiling.state == 'off' + kitchen = hass_fixture.states.get('light.kitchen_lights') assert kitchen.attributes.get(light.ATTR_COLOR_TEMP) == 476 assert kitchen.attributes.get(light.ATTR_RGB_COLOR) == (255, 0, 0) + + bed = hass_fixture.states.get('light.bed_light') + assert bed.attributes.get(light.ATTR_COLOR_TEMP) == 212 + assert bed.attributes.get(light.ATTR_RGB_COLOR) == (0, 255, 0) + assert hass_fixture.states.get('switch.decorative_lights').state == 'off' From 59fa4f18e404b1a13a48e9c811f84dc9daa5daf8 Mon Sep 17 00:00:00 2001 From: Daniel Perna Date: Wed, 29 Nov 2017 08:16:47 +0100 Subject: [PATCH 170/246] Upgrade HomeMatic, add devices (#10845) --- .../components/binary_sensor/homematic.py | 1 + homeassistant/components/homematic.py | 9 ++++---- homeassistant/components/sensor/homematic.py | 21 +++++++++++++++---- requirements_all.txt | 2 +- 4 files changed, 24 insertions(+), 9 deletions(-) diff --git a/homeassistant/components/binary_sensor/homematic.py b/homeassistant/components/binary_sensor/homematic.py index 2f464bc73cc..d85c10f9a34 100644 --- a/homeassistant/components/binary_sensor/homematic.py +++ b/homeassistant/components/binary_sensor/homematic.py @@ -25,6 +25,7 @@ SENSOR_TYPES_CLASS = { 'RemoteMotion': None, 'WeatherSensor': None, 'TiltSensor': None, + 'PresenceIP': 'motion', } diff --git a/homeassistant/components/homematic.py b/homeassistant/components/homematic.py index 901b54c8525..5e8cd3dc58e 100644 --- a/homeassistant/components/homematic.py +++ b/homeassistant/components/homematic.py @@ -21,7 +21,7 @@ from homeassistant.helpers.entity import Entity from homeassistant.helpers.event import track_time_interval from homeassistant.config import load_yaml_config_file -REQUIREMENTS = ['pyhomematic==0.1.34'] +REQUIREMENTS = ['pyhomematic==0.1.35'] DOMAIN = 'homematic' @@ -56,7 +56,7 @@ SERVICE_SET_DEV_VALUE = 'set_dev_value' HM_DEVICE_TYPES = { DISCOVER_SWITCHES: [ - 'Switch', 'SwitchPowermeter', 'IOSwitch', 'IPSwitch', + 'Switch', 'SwitchPowermeter', 'IOSwitch', 'IPSwitch', 'RFSiren', 'IPSwitchPowermeter', 'KeyMatic', 'HMWIOSwitch', 'Rain', 'EcoLogic'], DISCOVER_LIGHTS: ['Dimmer', 'KeyDimmer', 'IPKeyDimmer'], DISCOVER_SENSORS: [ @@ -66,7 +66,7 @@ HM_DEVICE_TYPES = { 'WeatherStation', 'ThermostatWall2', 'TemperatureDiffSensor', 'TemperatureSensor', 'CO2Sensor', 'IPSwitchPowermeter', 'HMWIOSwitch', 'FillingLevel', 'ValveDrive', 'EcoLogic', 'IPThermostatWall', - 'IPSmoke'], + 'IPSmoke', 'RFSiren', 'PresenceIP'], DISCOVER_CLIMATE: [ 'Thermostat', 'ThermostatWall', 'MAXThermostat', 'ThermostatWall2', 'MAXWallThermostat', 'IPThermostat', 'IPThermostatWall', @@ -74,7 +74,8 @@ HM_DEVICE_TYPES = { DISCOVER_BINARY_SENSORS: [ 'ShutterContact', 'Smoke', 'SmokeV2', 'Motion', 'MotionV2', 'RemoteMotion', 'WeatherSensor', 'TiltSensor', 'IPShutterContact', - 'HMWIOSwitch', 'MaxShutterContact', 'Rain', 'WiredSensor'], + 'HMWIOSwitch', 'MaxShutterContact', 'Rain', 'WiredSensor', + 'PresenceIP'], DISCOVER_COVER: ['Blind', 'KeyBlind'] } diff --git a/homeassistant/components/sensor/homematic.py b/homeassistant/components/sensor/homematic.py index 2edfe6648f3..936533422bb 100644 --- a/homeassistant/components/sensor/homematic.py +++ b/homeassistant/components/sensor/homematic.py @@ -13,10 +13,23 @@ _LOGGER = logging.getLogger(__name__) DEPENDENCIES = ['homematic'] HM_STATE_HA_CAST = { - 'RotaryHandleSensor': {0: 'closed', 1: 'tilted', 2: 'open'}, - 'WaterSensor': {0: 'dry', 1: 'wet', 2: 'water'}, - 'CO2Sensor': {0: 'normal', 1: 'added', 2: 'strong'}, - 'IPSmoke': {0: 'off', 1: 'primary', 2: 'intrusion', 3: 'secondary'} + 'RotaryHandleSensor': {0: 'closed', + 1: 'tilted', + 2: 'open'}, + 'WaterSensor': {0: 'dry', + 1: 'wet', + 2: 'water'}, + 'CO2Sensor': {0: 'normal', + 1: 'added', + 2: 'strong'}, + 'IPSmoke': {0: 'off', + 1: 'primary', + 2: 'intrusion', + 3: 'secondary'}, + 'RFSiren': {0: 'disarmed', + 1: 'extsens_armed', + 2: 'allsens_armed', + 3: 'alarm_blocked'}, } HM_UNIT_HA_CAST = { diff --git a/requirements_all.txt b/requirements_all.txt index 47cc3952ed5..efcac280fdf 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -677,7 +677,7 @@ pyhik==0.1.4 pyhiveapi==0.2.5 # homeassistant.components.homematic -pyhomematic==0.1.34 +pyhomematic==0.1.35 # homeassistant.components.sensor.hydroquebec pyhydroquebec==1.3.1 From 373508693aeb71e1fdc4093b4f429ada77b8afbc Mon Sep 17 00:00:00 2001 From: Lukas Barth Date: Wed, 29 Nov 2017 11:01:28 +0100 Subject: [PATCH 171/246] Climate component: add supported_features (#10658) * Implement supported_features for the climate component * Test supported features * Convert generic thermostat to supported features * Max / min temperature are not features * Fix lint * Min / max humidity are not features * Linting * Remove current temperature / humidity * Move c-hacker-style constants to boring integers. Booo! * Refactor all the climate platforms to use the new supported_features * Force all climate platforms to implement supported_features * Fix mistakes * Adapt hive platform * Move flags into a constant * Calm the hound --- homeassistant/components/climate/__init__.py | 18 +++++++++ homeassistant/components/climate/demo.py | 17 +++++++- homeassistant/components/climate/ecobee.py | 34 +++++++++++++--- homeassistant/components/climate/ephember.py | 7 +++- .../components/climate/eq3btsmart.py | 11 +++++- homeassistant/components/climate/flexit.py | 11 +++++- .../components/climate/generic_thermostat.py | 8 +++- homeassistant/components/climate/heatmiser.py | 8 +++- homeassistant/components/climate/hive.py | 13 +++++-- homeassistant/components/climate/homematic.py | 11 +++++- homeassistant/components/climate/honeywell.py | 19 ++++++++- homeassistant/components/climate/knx.py | 12 +++++- homeassistant/components/climate/maxcube.py | 11 +++++- homeassistant/components/climate/mqtt.py | 39 ++++++++++++++++++- homeassistant/components/climate/mysensors.py | 13 ++++++- homeassistant/components/climate/nest.py | 13 ++++++- homeassistant/components/climate/netatmo.py | 11 +++++- homeassistant/components/climate/oem.py | 10 ++++- homeassistant/components/climate/proliphix.py | 7 +++- .../components/climate/radiotherm.py | 11 +++++- homeassistant/components/climate/sensibo.py | 14 ++++++- homeassistant/components/climate/tado.py | 10 ++++- homeassistant/components/climate/tesla.py | 11 +++++- homeassistant/components/climate/toon.py | 9 ++++- homeassistant/components/climate/vera.py | 12 +++++- homeassistant/components/climate/wink.py | 31 ++++++++++++++- homeassistant/components/climate/zwave.py | 17 +++++++- tests/components/climate/test_mqtt.py | 16 +++++++- 28 files changed, 370 insertions(+), 34 deletions(-) diff --git a/homeassistant/components/climate/__init__.py b/homeassistant/components/climate/__init__.py index 81a7adca1b7..f9ffe4faec9 100644 --- a/homeassistant/components/climate/__init__.py +++ b/homeassistant/components/climate/__init__.py @@ -51,6 +51,19 @@ STATE_HIGH_DEMAND = 'high_demand' STATE_HEAT_PUMP = 'heat_pump' STATE_GAS = 'gas' +SUPPORT_TARGET_TEMPERATURE = 1 +SUPPORT_TARGET_TEMPERATURE_HIGH = 2 +SUPPORT_TARGET_TEMPERATURE_LOW = 4 +SUPPORT_TARGET_HUMIDITY = 8 +SUPPORT_TARGET_HUMIDITY_HIGH = 16 +SUPPORT_TARGET_HUMIDITY_LOW = 32 +SUPPORT_FAN_MODE = 64 +SUPPORT_OPERATION_MODE = 128 +SUPPORT_HOLD_MODE = 256 +SUPPORT_SWING_MODE = 512 +SUPPORT_AWAY_MODE = 1024 +SUPPORT_AUX_HEAT = 2048 + ATTR_CURRENT_TEMPERATURE = 'current_temperature' ATTR_MAX_TEMP = 'max_temp' ATTR_MIN_TEMP = 'min_temp' @@ -717,6 +730,11 @@ class ClimateDevice(Entity): """ return self.hass.async_add_job(self.turn_aux_heat_off) + @property + def supported_features(self): + """Return the list of supported features.""" + raise NotImplementedError() + @property def min_temp(self): """Return the minimum temperature.""" diff --git a/homeassistant/components/climate/demo.py b/homeassistant/components/climate/demo.py index 377985aaa12..4c4b57d42a3 100644 --- a/homeassistant/components/climate/demo.py +++ b/homeassistant/components/climate/demo.py @@ -5,9 +5,19 @@ For more details about this platform, please refer to the documentation https://home-assistant.io/components/demo/ """ from homeassistant.components.climate import ( - ClimateDevice, ATTR_TARGET_TEMP_HIGH, ATTR_TARGET_TEMP_LOW) + ClimateDevice, ATTR_TARGET_TEMP_HIGH, ATTR_TARGET_TEMP_LOW, + SUPPORT_TARGET_TEMPERATURE, SUPPORT_TARGET_HUMIDITY, + SUPPORT_AWAY_MODE, SUPPORT_HOLD_MODE, SUPPORT_FAN_MODE, + SUPPORT_OPERATION_MODE, SUPPORT_AUX_HEAT, SUPPORT_SWING_MODE, + SUPPORT_TARGET_TEMPERATURE_HIGH, SUPPORT_TARGET_TEMPERATURE_LOW) from homeassistant.const import TEMP_CELSIUS, TEMP_FAHRENHEIT, ATTR_TEMPERATURE +SUPPORT_FLAGS = (SUPPORT_TARGET_TEMPERATURE | SUPPORT_TARGET_HUMIDITY | + SUPPORT_AWAY_MODE | SUPPORT_HOLD_MODE | SUPPORT_FAN_MODE | + SUPPORT_OPERATION_MODE | SUPPORT_AUX_HEAT | + SUPPORT_SWING_MODE | SUPPORT_TARGET_TEMPERATURE_HIGH | + SUPPORT_TARGET_TEMPERATURE_LOW) + def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the Demo climate devices.""" @@ -47,6 +57,11 @@ class DemoClimate(ClimateDevice): self._target_temperature_high = target_temp_high self._target_temperature_low = target_temp_low + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS + @property def should_poll(self): """Return the polling state.""" diff --git a/homeassistant/components/climate/ecobee.py b/homeassistant/components/climate/ecobee.py index 100312f643e..aae70a4f1f7 100644 --- a/homeassistant/components/climate/ecobee.py +++ b/homeassistant/components/climate/ecobee.py @@ -12,7 +12,9 @@ import voluptuous as vol from homeassistant.components import ecobee from homeassistant.components.climate import ( DOMAIN, STATE_COOL, STATE_HEAT, STATE_AUTO, STATE_IDLE, ClimateDevice, - ATTR_TARGET_TEMP_LOW, ATTR_TARGET_TEMP_HIGH) + ATTR_TARGET_TEMP_LOW, ATTR_TARGET_TEMP_HIGH, SUPPORT_TARGET_TEMPERATURE, + SUPPORT_AWAY_MODE, SUPPORT_HOLD_MODE, SUPPORT_OPERATION_MODE, + SUPPORT_TARGET_HUMIDITY_LOW, SUPPORT_TARGET_HUMIDITY_HIGH) from homeassistant.const import ( ATTR_ENTITY_ID, STATE_OFF, STATE_ON, ATTR_TEMPERATURE, TEMP_FAHRENHEIT) from homeassistant.config import load_yaml_config_file @@ -44,6 +46,10 @@ RESUME_PROGRAM_SCHEMA = vol.Schema({ vol.Optional(ATTR_RESUME_ALL, default=DEFAULT_RESUME_ALL): cv.boolean, }) +SUPPORT_FLAGS = (SUPPORT_TARGET_TEMPERATURE | SUPPORT_AWAY_MODE | + SUPPORT_HOLD_MODE | SUPPORT_OPERATION_MODE | + SUPPORT_TARGET_HUMIDITY_LOW | SUPPORT_TARGET_HUMIDITY_HIGH) + def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the Ecobee Thermostat Platform.""" @@ -132,6 +138,11 @@ class Thermostat(ClimateDevice): self.thermostat = self.data.ecobee.get_thermostat( self.thermostat_index) + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS + @property def name(self): """Return the name of the Ecobee Thermostat.""" @@ -318,8 +329,21 @@ class Thermostat(ClimateDevice): def set_auto_temp_hold(self, heat_temp, cool_temp): """Set temperature hold in auto mode.""" - self.data.ecobee.set_hold_temp(self.thermostat_index, cool_temp, - heat_temp, self.hold_preference()) + if cool_temp is not None: + cool_temp_setpoint = cool_temp + else: + cool_temp_setpoint = ( + self.thermostat['runtime']['desiredCool'] / 10.0) + + if heat_temp is not None: + heat_temp_setpoint = heat_temp + else: + heat_temp_setpoint = ( + self.thermostat['runtime']['desiredCool'] / 10.0) + + self.data.ecobee.set_hold_temp(self.thermostat_index, + cool_temp_setpoint, heat_temp_setpoint, + self.hold_preference()) _LOGGER.debug("Setting ecobee hold_temp to: heat=%s, is=%s, " "cool=%s, is=%s", heat_temp, isinstance( heat_temp, (int, float)), cool_temp, @@ -348,8 +372,8 @@ class Thermostat(ClimateDevice): high_temp = kwargs.get(ATTR_TARGET_TEMP_HIGH) temp = kwargs.get(ATTR_TEMPERATURE) - if self.current_operation == STATE_AUTO and low_temp is not None \ - and high_temp is not None: + if self.current_operation == STATE_AUTO and (low_temp is not None or + high_temp is not None): self.set_auto_temp_hold(low_temp, high_temp) elif temp is not None: self.set_temp_hold(temp) diff --git a/homeassistant/components/climate/ephember.py b/homeassistant/components/climate/ephember.py index 79ff767c82b..a1d11bce901 100644 --- a/homeassistant/components/climate/ephember.py +++ b/homeassistant/components/climate/ephember.py @@ -9,7 +9,7 @@ from datetime import timedelta import voluptuous as vol from homeassistant.components.climate import ( - ClimateDevice, PLATFORM_SCHEMA, STATE_HEAT, STATE_IDLE) + ClimateDevice, PLATFORM_SCHEMA, STATE_HEAT, STATE_IDLE, SUPPORT_AUX_HEAT) from homeassistant.const import ( TEMP_CELSIUS, CONF_USERNAME, CONF_PASSWORD) import homeassistant.helpers.config_validation as cv @@ -56,6 +56,11 @@ class EphEmberThermostat(ClimateDevice): self._zone = zone self._hot_water = zone['isHotWater'] + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_AUX_HEAT + @property def name(self): """Return the name of the thermostat, if any.""" diff --git a/homeassistant/components/climate/eq3btsmart.py b/homeassistant/components/climate/eq3btsmart.py index dba096bb632..eb9b5c5ba6e 100644 --- a/homeassistant/components/climate/eq3btsmart.py +++ b/homeassistant/components/climate/eq3btsmart.py @@ -9,7 +9,8 @@ import logging import voluptuous as vol from homeassistant.components.climate import ( - STATE_ON, STATE_OFF, STATE_AUTO, PLATFORM_SCHEMA, ClimateDevice) + STATE_ON, STATE_OFF, STATE_AUTO, PLATFORM_SCHEMA, ClimateDevice, + SUPPORT_TARGET_TEMPERATURE, SUPPORT_OPERATION_MODE, SUPPORT_AWAY_MODE) from homeassistant.const import ( CONF_MAC, CONF_DEVICES, TEMP_CELSIUS, ATTR_TEMPERATURE, PRECISION_HALVES) import homeassistant.helpers.config_validation as cv @@ -37,6 +38,9 @@ PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Schema({cv.string: DEVICE_SCHEMA}), }) +SUPPORT_FLAGS = (SUPPORT_TARGET_TEMPERATURE | SUPPORT_OPERATION_MODE | + SUPPORT_AWAY_MODE) + def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the eQ-3 BLE thermostats.""" @@ -72,6 +76,11 @@ class EQ3BTSmartThermostat(ClimateDevice): self._name = _name self._thermostat = eq3.Thermostat(_mac) + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS + @property def available(self) -> bool: """Return if thermostat is available.""" diff --git a/homeassistant/components/climate/flexit.py b/homeassistant/components/climate/flexit.py index c3ba2224b06..98c03217509 100644 --- a/homeassistant/components/climate/flexit.py +++ b/homeassistant/components/climate/flexit.py @@ -17,7 +17,9 @@ import voluptuous as vol from homeassistant.const import ( CONF_NAME, CONF_SLAVE, TEMP_CELSIUS, ATTR_TEMPERATURE, DEVICE_DEFAULT_NAME) -from homeassistant.components.climate import (ClimateDevice, PLATFORM_SCHEMA) +from homeassistant.components.climate import ( + ClimateDevice, PLATFORM_SCHEMA, SUPPORT_TARGET_TEMPERATURE, + SUPPORT_FAN_MODE) import homeassistant.components.modbus as modbus import homeassistant.helpers.config_validation as cv @@ -31,6 +33,8 @@ PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ _LOGGER = logging.getLogger(__name__) +SUPPORT_FLAGS = SUPPORT_TARGET_TEMPERATURE | SUPPORT_FAN_MODE + def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the Flexit Platform.""" @@ -62,6 +66,11 @@ class Flexit(ClimateDevice): self._alarm = False self.unit = pyflexit.pyflexit(modbus.HUB, modbus_slave) + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS + def update(self): """Update unit attributes.""" if not self.unit.update(): diff --git a/homeassistant/components/climate/generic_thermostat.py b/homeassistant/components/climate/generic_thermostat.py index 3f3470c1c86..987708834cc 100644 --- a/homeassistant/components/climate/generic_thermostat.py +++ b/homeassistant/components/climate/generic_thermostat.py @@ -13,7 +13,7 @@ from homeassistant.core import callback from homeassistant.core import DOMAIN as HA_DOMAIN from homeassistant.components.climate import ( STATE_HEAT, STATE_COOL, STATE_IDLE, ClimateDevice, PLATFORM_SCHEMA, - STATE_AUTO) + STATE_AUTO, SUPPORT_OPERATION_MODE, SUPPORT_TARGET_TEMPERATURE) from homeassistant.const import ( ATTR_UNIT_OF_MEASUREMENT, STATE_ON, STATE_OFF, ATTR_TEMPERATURE, CONF_NAME, ATTR_ENTITY_ID, SERVICE_TURN_ON, SERVICE_TURN_OFF) @@ -41,6 +41,7 @@ CONF_COLD_TOLERANCE = 'cold_tolerance' CONF_HOT_TOLERANCE = 'hot_tolerance' CONF_KEEP_ALIVE = 'keep_alive' +SUPPORT_FLAGS = SUPPORT_TARGET_TEMPERATURE | SUPPORT_OPERATION_MODE PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Required(CONF_HEATER): cv.entity_id, @@ -313,6 +314,11 @@ class GenericThermostat(ClimateDevice): """If the toggleable device is currently active.""" return self.hass.states.is_state(self.heater_entity_id, STATE_ON) + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS + @callback def _heater_turn_on(self): """Turn heater toggleable device on.""" diff --git a/homeassistant/components/climate/heatmiser.py b/homeassistant/components/climate/heatmiser.py index 56015ebeb5a..b05c880cc37 100644 --- a/homeassistant/components/climate/heatmiser.py +++ b/homeassistant/components/climate/heatmiser.py @@ -8,7 +8,8 @@ import logging import voluptuous as vol -from homeassistant.components.climate import ClimateDevice, PLATFORM_SCHEMA +from homeassistant.components.climate import ( + ClimateDevice, PLATFORM_SCHEMA, SUPPORT_TARGET_TEMPERATURE) from homeassistant.const import ( TEMP_CELSIUS, ATTR_TEMPERATURE, CONF_PORT, CONF_NAME, CONF_ID) import homeassistant.helpers.config_validation as cv @@ -68,6 +69,11 @@ class HeatmiserV3Thermostat(ClimateDevice): self.update() self._target_temperature = int(self.dcb.get('roomset')) + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_TARGET_TEMPERATURE + @property def name(self): """Return the name of the thermostat, if any.""" diff --git a/homeassistant/components/climate/hive.py b/homeassistant/components/climate/hive.py index 18833558b44..267657d56ce 100644 --- a/homeassistant/components/climate/hive.py +++ b/homeassistant/components/climate/hive.py @@ -4,9 +4,9 @@ Support for the Hive devices. For more details about this platform, please refer to the documentation at https://home-assistant.io/components/climate.hive/ """ -from homeassistant.components.climate import (ClimateDevice, - STATE_AUTO, STATE_HEAT, - STATE_OFF, STATE_ON) +from homeassistant.components.climate import ( + ClimateDevice, STATE_AUTO, STATE_HEAT, STATE_OFF, STATE_ON, + SUPPORT_TARGET_TEMPERATURE, SUPPORT_OPERATION_MODE) from homeassistant.const import ATTR_TEMPERATURE, TEMP_CELSIUS from homeassistant.components.hive import DATA_HIVE @@ -16,6 +16,8 @@ HIVE_TO_HASS_STATE = {'SCHEDULE': STATE_AUTO, 'MANUAL': STATE_HEAT, HASS_TO_HIVE_STATE = {STATE_AUTO: 'SCHEDULE', STATE_HEAT: 'MANUAL', STATE_ON: 'ON', STATE_OFF: 'OFF'} +SUPPORT_FLAGS = SUPPORT_TARGET_TEMPERATURE | SUPPORT_OPERATION_MODE + def setup_platform(hass, config, add_devices, discovery_info=None): """Set up Hive climate devices.""" @@ -45,6 +47,11 @@ class HiveClimateEntity(ClimateDevice): self.session.entities.append(self) + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS + def handle_update(self, updatesource): """Handle the new update request.""" if '{}.{}'.format(self.device_type, self.node_id) not in updatesource: diff --git a/homeassistant/components/climate/homematic.py b/homeassistant/components/climate/homematic.py index 5236c0788fd..33a63b35530 100644 --- a/homeassistant/components/climate/homematic.py +++ b/homeassistant/components/climate/homematic.py @@ -5,7 +5,9 @@ For more details about this platform, please refer to the documentation at https://home-assistant.io/components/climate.homematic/ """ import logging -from homeassistant.components.climate import ClimateDevice, STATE_AUTO +from homeassistant.components.climate import ( + ClimateDevice, STATE_AUTO, SUPPORT_TARGET_TEMPERATURE, + SUPPORT_OPERATION_MODE) from homeassistant.components.homematic import HMDevice, ATTR_DISCOVER_DEVICES from homeassistant.const import TEMP_CELSIUS, STATE_UNKNOWN, ATTR_TEMPERATURE @@ -38,6 +40,8 @@ HM_HUMI_MAP = [ HM_CONTROL_MODE = 'CONTROL_MODE' +SUPPORT_FLAGS = SUPPORT_TARGET_TEMPERATURE | SUPPORT_OPERATION_MODE + def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the Homematic thermostat platform.""" @@ -55,6 +59,11 @@ def setup_platform(hass, config, add_devices, discovery_info=None): class HMThermostat(HMDevice, ClimateDevice): """Representation of a Homematic thermostat.""" + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS + @property def temperature_unit(self): """Return the unit of measurement that is used.""" diff --git a/homeassistant/components/climate/honeywell.py b/homeassistant/components/climate/honeywell.py index a6d27665fa2..20d93e3116a 100644 --- a/homeassistant/components/climate/honeywell.py +++ b/homeassistant/components/climate/honeywell.py @@ -14,7 +14,8 @@ import voluptuous as vol import homeassistant.helpers.config_validation as cv from homeassistant.components.climate import ( ClimateDevice, PLATFORM_SCHEMA, ATTR_FAN_MODE, ATTR_FAN_LIST, - ATTR_OPERATION_MODE, ATTR_OPERATION_LIST) + ATTR_OPERATION_MODE, ATTR_OPERATION_LIST, SUPPORT_TARGET_TEMPERATURE, + SUPPORT_AWAY_MODE, SUPPORT_OPERATION_MODE) from homeassistant.const import ( CONF_PASSWORD, CONF_USERNAME, TEMP_CELSIUS, TEMP_FAHRENHEIT, ATTR_TEMPERATURE, CONF_REGION) @@ -126,6 +127,14 @@ class RoundThermostat(ClimateDevice): self._away_temp = away_temp self._away = False + @property + def supported_features(self): + """Return the list of supported features.""" + supported = (SUPPORT_TARGET_TEMPERATURE | SUPPORT_AWAY_MODE) + if hasattr(self.client, ATTR_SYSTEM_MODE): + supported |= SUPPORT_OPERATION_MODE + return supported + @property def name(self): """Return the name of the honeywell, if any.""" @@ -234,6 +243,14 @@ class HoneywellUSThermostat(ClimateDevice): self._username = username self._password = password + @property + def supported_features(self): + """Return the list of supported features.""" + supported = (SUPPORT_TARGET_TEMPERATURE | SUPPORT_AWAY_MODE) + if hasattr(self._device, ATTR_SYSTEM_MODE): + supported |= SUPPORT_OPERATION_MODE + return supported + @property def is_fan_on(self): """Return true if fan is on.""" diff --git a/homeassistant/components/climate/knx.py b/homeassistant/components/climate/knx.py index 69c144985d6..fb0de1e2de0 100644 --- a/homeassistant/components/climate/knx.py +++ b/homeassistant/components/climate/knx.py @@ -8,7 +8,9 @@ import asyncio import voluptuous as vol from homeassistant.components.knx import DATA_KNX, ATTR_DISCOVER_DEVICES -from homeassistant.components.climate import PLATFORM_SCHEMA, ClimateDevice +from homeassistant.components.climate import ( + PLATFORM_SCHEMA, ClimateDevice, SUPPORT_TARGET_TEMPERATURE, + SUPPORT_OPERATION_MODE) from homeassistant.const import CONF_NAME, TEMP_CELSIUS, ATTR_TEMPERATURE from homeassistant.core import callback import homeassistant.helpers.config_validation as cv @@ -135,6 +137,14 @@ class KNXClimate(ClimateDevice): self._unit_of_measurement = TEMP_CELSIUS + @property + def supported_features(self): + """Return the list of supported features.""" + support = SUPPORT_TARGET_TEMPERATURE + if self.device.supports_operation_mode: + support |= SUPPORT_OPERATION_MODE + return support + def async_register_callbacks(self): """Register callbacks to update hass after device was changed.""" @asyncio.coroutine diff --git a/homeassistant/components/climate/maxcube.py b/homeassistant/components/climate/maxcube.py index 271616daf8b..067d11437b2 100644 --- a/homeassistant/components/climate/maxcube.py +++ b/homeassistant/components/climate/maxcube.py @@ -7,7 +7,9 @@ https://home-assistant.io/components/maxcube/ import socket import logging -from homeassistant.components.climate import ClimateDevice, STATE_AUTO +from homeassistant.components.climate import ( + ClimateDevice, STATE_AUTO, SUPPORT_TARGET_TEMPERATURE, + SUPPORT_OPERATION_MODE) from homeassistant.components.maxcube import MAXCUBE_HANDLE from homeassistant.const import TEMP_CELSIUS, ATTR_TEMPERATURE @@ -17,6 +19,8 @@ STATE_MANUAL = 'manual' STATE_BOOST = 'boost' STATE_VACATION = 'vacation' +SUPPORT_FLAGS = SUPPORT_TARGET_TEMPERATURE | SUPPORT_OPERATION_MODE + def setup_platform(hass, config, add_devices, discovery_info=None): """Iterate through all MAX! Devices and add thermostats.""" @@ -47,6 +51,11 @@ class MaxCubeClimate(ClimateDevice): self._rf_address = rf_address self._cubehandle = hass.data[MAXCUBE_HANDLE] + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS + @property def should_poll(self): """Return the polling state.""" diff --git a/homeassistant/components/climate/mqtt.py b/homeassistant/components/climate/mqtt.py index de6ac7a0227..d571ebd39e4 100644 --- a/homeassistant/components/climate/mqtt.py +++ b/homeassistant/components/climate/mqtt.py @@ -15,7 +15,9 @@ import homeassistant.components.mqtt as mqtt from homeassistant.components.climate import ( STATE_HEAT, STATE_COOL, STATE_DRY, STATE_FAN_ONLY, ClimateDevice, PLATFORM_SCHEMA as CLIMATE_PLATFORM_SCHEMA, STATE_AUTO, - ATTR_OPERATION_MODE) + ATTR_OPERATION_MODE, SUPPORT_TARGET_TEMPERATURE, SUPPORT_OPERATION_MODE, + SUPPORT_SWING_MODE, SUPPORT_FAN_MODE, SUPPORT_AWAY_MODE, SUPPORT_HOLD_MODE, + SUPPORT_AUX_HEAT) from homeassistant.const import ( STATE_ON, STATE_OFF, ATTR_TEMPERATURE, CONF_NAME) from homeassistant.components.mqtt import (CONF_QOS, CONF_RETAIN, @@ -483,3 +485,38 @@ class MqttClimate(ClimateDevice): if self._topic[CONF_AUX_STATE_TOPIC] is None: self._aux = False self.async_schedule_update_ha_state() + + @property + def supported_features(self): + """Return the list of supported features.""" + support = 0 + + if (self._topic[CONF_TEMPERATURE_STATE_TOPIC] is not None) or \ + (self._topic[CONF_TEMPERATURE_COMMAND_TOPIC] is not None): + support |= SUPPORT_TARGET_TEMPERATURE + + if (self._topic[CONF_MODE_COMMAND_TOPIC] is not None) or \ + (self._topic[CONF_MODE_STATE_TOPIC] is not None): + support |= SUPPORT_OPERATION_MODE + + if (self._topic[CONF_FAN_MODE_STATE_TOPIC] is not None) or \ + (self._topic[CONF_FAN_MODE_COMMAND_TOPIC] is not None): + support |= SUPPORT_FAN_MODE + + if (self._topic[CONF_SWING_MODE_STATE_TOPIC] is not None) or \ + (self._topic[CONF_SWING_MODE_COMMAND_TOPIC] is not None): + support |= SUPPORT_SWING_MODE + + if (self._topic[CONF_AWAY_MODE_STATE_TOPIC] is not None) or \ + (self._topic[CONF_AWAY_MODE_COMMAND_TOPIC] is not None): + support |= SUPPORT_AWAY_MODE + + if (self._topic[CONF_HOLD_STATE_TOPIC] is not None) or \ + (self._topic[CONF_HOLD_COMMAND_TOPIC] is not None): + support |= SUPPORT_HOLD_MODE + + if (self._topic[CONF_AUX_STATE_TOPIC] is not None) or \ + (self._topic[CONF_AUX_COMMAND_TOPIC] is not None): + support |= SUPPORT_AUX_HEAT + + return support diff --git a/homeassistant/components/climate/mysensors.py b/homeassistant/components/climate/mysensors.py index d4316c2cfba..db43a6d3be4 100755 --- a/homeassistant/components/climate/mysensors.py +++ b/homeassistant/components/climate/mysensors.py @@ -7,7 +7,9 @@ https://home-assistant.io/components/climate.mysensors/ from homeassistant.components import mysensors from homeassistant.components.climate import ( ATTR_TARGET_TEMP_HIGH, ATTR_TARGET_TEMP_LOW, DOMAIN, STATE_AUTO, - STATE_COOL, STATE_HEAT, STATE_OFF, ClimateDevice) + STATE_COOL, STATE_HEAT, STATE_OFF, ClimateDevice, + SUPPORT_TARGET_TEMPERATURE, SUPPORT_TARGET_TEMPERATURE_HIGH, + SUPPORT_TARGET_TEMPERATURE_LOW, SUPPORT_FAN_MODE, SUPPORT_OPERATION_MODE) from homeassistant.const import ATTR_TEMPERATURE, TEMP_CELSIUS, TEMP_FAHRENHEIT DICT_HA_TO_MYS = { @@ -23,6 +25,10 @@ DICT_MYS_TO_HA = { 'Off': STATE_OFF, } +SUPPORT_FLAGS = (SUPPORT_TARGET_TEMPERATURE | SUPPORT_TARGET_TEMPERATURE_HIGH | + SUPPORT_TARGET_TEMPERATURE_LOW | SUPPORT_FAN_MODE | + SUPPORT_OPERATION_MODE) + def setup_platform(hass, config, add_devices, discovery_info=None): """Setup the mysensors climate.""" @@ -33,6 +39,11 @@ def setup_platform(hass, config, add_devices, discovery_info=None): class MySensorsHVAC(mysensors.MySensorsEntity, ClimateDevice): """Representation of a MySensors HVAC.""" + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS + @property def assumed_state(self): """Return True if unable to access real state of entity.""" diff --git a/homeassistant/components/climate/nest.py b/homeassistant/components/climate/nest.py index ac4f64f4ec8..3b550c43368 100644 --- a/homeassistant/components/climate/nest.py +++ b/homeassistant/components/climate/nest.py @@ -12,7 +12,9 @@ from homeassistant.components.nest import DATA_NEST from homeassistant.components.climate import ( STATE_AUTO, STATE_COOL, STATE_HEAT, ClimateDevice, PLATFORM_SCHEMA, ATTR_TARGET_TEMP_HIGH, ATTR_TARGET_TEMP_LOW, - ATTR_TEMPERATURE) + ATTR_TEMPERATURE, SUPPORT_TARGET_TEMPERATURE, + SUPPORT_TARGET_TEMPERATURE_HIGH, SUPPORT_TARGET_TEMPERATURE_LOW, + SUPPORT_OPERATION_MODE, SUPPORT_AWAY_MODE, SUPPORT_FAN_MODE) from homeassistant.const import ( TEMP_CELSIUS, TEMP_FAHRENHEIT, CONF_SCAN_INTERVAL, STATE_ON, STATE_OFF, STATE_UNKNOWN) @@ -28,6 +30,10 @@ PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ STATE_ECO = 'eco' STATE_HEAT_COOL = 'heat-cool' +SUPPORT_FLAGS = (SUPPORT_TARGET_TEMPERATURE | SUPPORT_TARGET_TEMPERATURE_HIGH | + SUPPORT_TARGET_TEMPERATURE_LOW | SUPPORT_OPERATION_MODE | + SUPPORT_AWAY_MODE | SUPPORT_FAN_MODE) + def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the Nest thermostat.""" @@ -87,6 +93,11 @@ class NestThermostat(ClimateDevice): self._min_temperature = None self._max_temperature = None + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS + @property def name(self): """Return the name of the nest, if any.""" diff --git a/homeassistant/components/climate/netatmo.py b/homeassistant/components/climate/netatmo.py index 369b01e53de..2166070a572 100755 --- a/homeassistant/components/climate/netatmo.py +++ b/homeassistant/components/climate/netatmo.py @@ -10,7 +10,8 @@ import voluptuous as vol from homeassistant.const import TEMP_CELSIUS, ATTR_TEMPERATURE from homeassistant.components.climate import ( - STATE_HEAT, STATE_IDLE, ClimateDevice, PLATFORM_SCHEMA) + STATE_HEAT, STATE_IDLE, ClimateDevice, PLATFORM_SCHEMA, + SUPPORT_TARGET_TEMPERATURE, SUPPORT_OPERATION_MODE, SUPPORT_AWAY_MODE) from homeassistant.util import Throttle from homeassistant.loader import get_component import homeassistant.helpers.config_validation as cv @@ -35,6 +36,9 @@ PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.All(cv.ensure_list, [cv.string]), }) +SUPPORT_FLAGS = (SUPPORT_TARGET_TEMPERATURE | SUPPORT_OPERATION_MODE | + SUPPORT_AWAY_MODE) + def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the NetAtmo Thermostat.""" @@ -65,6 +69,11 @@ class NetatmoThermostat(ClimateDevice): self._target_temperature = None self._away = None + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS + @property def name(self): """Return the name of the sensor.""" diff --git a/homeassistant/components/climate/oem.py b/homeassistant/components/climate/oem.py index 5909f26eb4f..0cbdc8f2ce6 100644 --- a/homeassistant/components/climate/oem.py +++ b/homeassistant/components/climate/oem.py @@ -14,7 +14,8 @@ import voluptuous as vol # Import the device class from the component that you want to support from homeassistant.components.climate import ( - ClimateDevice, PLATFORM_SCHEMA, STATE_HEAT, STATE_IDLE, ATTR_TEMPERATURE) + ClimateDevice, PLATFORM_SCHEMA, STATE_HEAT, STATE_IDLE, ATTR_TEMPERATURE, + SUPPORT_TARGET_TEMPERATURE, SUPPORT_AWAY_MODE) from homeassistant.const import (CONF_HOST, CONF_USERNAME, CONF_PASSWORD, CONF_PORT, TEMP_CELSIUS, CONF_NAME) import homeassistant.helpers.config_validation as cv @@ -34,6 +35,8 @@ PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Optional(CONF_AWAY_TEMP, default=14): vol.Coerce(float) }) +SUPPORT_FLAGS = SUPPORT_TARGET_TEMPERATURE | SUPPORT_AWAY_MODE + def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the oemthermostat platform.""" @@ -77,6 +80,11 @@ class ThermostatDevice(ClimateDevice): self._temperature = None self._setpoint = None + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS + @property def name(self): """Return the name of this Thermostat.""" diff --git a/homeassistant/components/climate/proliphix.py b/homeassistant/components/climate/proliphix.py index f168df04158..34fcfd667b6 100644 --- a/homeassistant/components/climate/proliphix.py +++ b/homeassistant/components/climate/proliphix.py @@ -8,7 +8,7 @@ import voluptuous as vol from homeassistant.components.climate import ( PRECISION_TENTHS, STATE_COOL, STATE_HEAT, STATE_IDLE, - ClimateDevice, PLATFORM_SCHEMA) + ClimateDevice, PLATFORM_SCHEMA, SUPPORT_TARGET_TEMPERATURE) from homeassistant.const import ( CONF_HOST, CONF_PASSWORD, CONF_USERNAME, TEMP_FAHRENHEIT, ATTR_TEMPERATURE) import homeassistant.helpers.config_validation as cv @@ -46,6 +46,11 @@ class ProliphixThermostat(ClimateDevice): self._pdp.update() self._name = self._pdp.name + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_TARGET_TEMPERATURE + @property def should_poll(self): """Set up polling needed for thermostat.""" diff --git a/homeassistant/components/climate/radiotherm.py b/homeassistant/components/climate/radiotherm.py index 5de6478133c..2b31ca93d22 100644 --- a/homeassistant/components/climate/radiotherm.py +++ b/homeassistant/components/climate/radiotherm.py @@ -12,7 +12,8 @@ import voluptuous as vol from homeassistant.components.climate import ( STATE_AUTO, STATE_COOL, STATE_HEAT, STATE_IDLE, STATE_ON, STATE_OFF, - ClimateDevice, PLATFORM_SCHEMA) + ClimateDevice, PLATFORM_SCHEMA, SUPPORT_TARGET_TEMPERATURE, + SUPPORT_OPERATION_MODE, SUPPORT_FAN_MODE, SUPPORT_AWAY_MODE) from homeassistant.const import ( CONF_HOST, TEMP_FAHRENHEIT, ATTR_TEMPERATURE, PRECISION_HALVES) import homeassistant.helpers.config_validation as cv @@ -78,6 +79,9 @@ PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.All(vol.Coerce(float), round_temp), }) +SUPPORT_FLAGS = (SUPPORT_TARGET_TEMPERATURE | SUPPORT_OPERATION_MODE | + SUPPORT_FAN_MODE | SUPPORT_AWAY_MODE) + def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the Radio Thermostat.""" @@ -136,6 +140,11 @@ class RadioThermostat(ClimateDevice): self._is_model_ct80 = isinstance(self.device, radiotherm.thermostat.CT80) + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS + @asyncio.coroutine def async_added_to_hass(self): """Register callbacks.""" diff --git a/homeassistant/components/climate/sensibo.py b/homeassistant/components/climate/sensibo.py index 4c1d0a8b9fc..624729249aa 100644 --- a/homeassistant/components/climate/sensibo.py +++ b/homeassistant/components/climate/sensibo.py @@ -15,7 +15,10 @@ import voluptuous as vol from homeassistant.const import ( ATTR_TEMPERATURE, CONF_API_KEY, CONF_ID, TEMP_CELSIUS, TEMP_FAHRENHEIT) from homeassistant.components.climate import ( - ATTR_CURRENT_HUMIDITY, ClimateDevice, PLATFORM_SCHEMA) + ATTR_CURRENT_HUMIDITY, ClimateDevice, PLATFORM_SCHEMA, + SUPPORT_TARGET_TEMPERATURE, SUPPORT_OPERATION_MODE, + SUPPORT_FAN_MODE, SUPPORT_AWAY_MODE, SUPPORT_SWING_MODE, + SUPPORT_AUX_HEAT) from homeassistant.exceptions import PlatformNotReady from homeassistant.helpers import config_validation as cv from homeassistant.helpers.aiohttp_client import async_get_clientsession @@ -38,6 +41,10 @@ _FETCH_FIELDS = ','.join([ 'acState', 'connectionStatus{isAlive}', 'temperatureUnit']) _INITIAL_FETCH_FIELDS = 'id,' + _FETCH_FIELDS +SUPPORT_FLAGS = (SUPPORT_TARGET_TEMPERATURE | SUPPORT_OPERATION_MODE | + SUPPORT_FAN_MODE | SUPPORT_AWAY_MODE | SUPPORT_SWING_MODE | + SUPPORT_AUX_HEAT) + @asyncio.coroutine def async_setup_platform(hass, config, async_add_devices, discovery_info=None): @@ -75,6 +82,11 @@ class SensiboClimate(ClimateDevice): self._id = data['id'] self._do_update(data) + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS + def _do_update(self, data): self._name = data['room']['name'] self._measurements = data['measurements'] diff --git a/homeassistant/components/climate/tado.py b/homeassistant/components/climate/tado.py index 00bed936bd7..d58acac5373 100644 --- a/homeassistant/components/climate/tado.py +++ b/homeassistant/components/climate/tado.py @@ -7,7 +7,8 @@ https://home-assistant.io/components/climate.tado/ import logging from homeassistant.const import TEMP_CELSIUS -from homeassistant.components.climate import ClimateDevice +from homeassistant.components.climate import ( + ClimateDevice, SUPPORT_TARGET_TEMPERATURE, SUPPORT_OPERATION_MODE) from homeassistant.const import ATTR_TEMPERATURE from homeassistant.components.tado import DATA_TADO @@ -43,6 +44,8 @@ OPERATION_LIST = { CONST_MODE_OFF: 'Off', } +SUPPORT_FLAGS = SUPPORT_TARGET_TEMPERATURE | SUPPORT_OPERATION_MODE + def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the Tado climate platform.""" @@ -127,6 +130,11 @@ class TadoClimate(ClimateDevice): self._current_operation = CONST_MODE_SMART_SCHEDULE self._overlay_mode = CONST_MODE_SMART_SCHEDULE + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS + @property def name(self): """Return the name of the device.""" diff --git a/homeassistant/components/climate/tesla.py b/homeassistant/components/climate/tesla.py index 684d131d960..6295b85a1b7 100644 --- a/homeassistant/components/climate/tesla.py +++ b/homeassistant/components/climate/tesla.py @@ -7,7 +7,9 @@ https://home-assistant.io/components/climate.tesla/ import logging from homeassistant.const import STATE_ON, STATE_OFF -from homeassistant.components.climate import ClimateDevice, ENTITY_ID_FORMAT +from homeassistant.components.climate import ( + ClimateDevice, ENTITY_ID_FORMAT, SUPPORT_TARGET_TEMPERATURE, + SUPPORT_OPERATION_MODE) from homeassistant.components.tesla import DOMAIN as TESLA_DOMAIN, TeslaDevice from homeassistant.const import ( TEMP_FAHRENHEIT, TEMP_CELSIUS, ATTR_TEMPERATURE) @@ -18,6 +20,8 @@ DEPENDENCIES = ['tesla'] OPERATION_LIST = [STATE_ON, STATE_OFF] +SUPPORT_FLAGS = SUPPORT_TARGET_TEMPERATURE | SUPPORT_OPERATION_MODE + def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the Tesla climate platform.""" @@ -36,6 +40,11 @@ class TeslaThermostat(TeslaDevice, ClimateDevice): self._target_temperature = None self._temperature = None + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS + @property def current_operation(self): """Return current operation ie. On or Off.""" diff --git a/homeassistant/components/climate/toon.py b/homeassistant/components/climate/toon.py index 72e6ecb1fdb..0ff9f129081 100644 --- a/homeassistant/components/climate/toon.py +++ b/homeassistant/components/climate/toon.py @@ -10,9 +10,11 @@ https://home-assistant.io/components/climate.toon/ import homeassistant.components.toon as toon_main from homeassistant.components.climate import ( ClimateDevice, ATTR_TEMPERATURE, STATE_PERFORMANCE, STATE_HEAT, STATE_ECO, - STATE_COOL) + STATE_COOL, SUPPORT_TARGET_TEMPERATURE, SUPPORT_OPERATION_MODE) from homeassistant.const import TEMP_CELSIUS +SUPPORT_FLAGS = SUPPORT_TARGET_TEMPERATURE | SUPPORT_OPERATION_MODE + def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the Toon thermostat.""" @@ -38,6 +40,11 @@ class ThermostatDevice(ClimateDevice): STATE_COOL, ] + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS + @property def name(self): """Name of this Thermostat.""" diff --git a/homeassistant/components/climate/vera.py b/homeassistant/components/climate/vera.py index 06325ae0561..4644f86cba2 100644 --- a/homeassistant/components/climate/vera.py +++ b/homeassistant/components/climate/vera.py @@ -7,7 +7,9 @@ https://home-assistant.io/components/switch.vera/ import logging from homeassistant.util import convert -from homeassistant.components.climate import ClimateDevice, ENTITY_ID_FORMAT +from homeassistant.components.climate import ( + ClimateDevice, ENTITY_ID_FORMAT, SUPPORT_TARGET_TEMPERATURE, + SUPPORT_OPERATION_MODE, SUPPORT_FAN_MODE) from homeassistant.const import ( TEMP_FAHRENHEIT, TEMP_CELSIUS, @@ -23,6 +25,9 @@ _LOGGER = logging.getLogger(__name__) OPERATION_LIST = ['Heat', 'Cool', 'Auto Changeover', 'Off'] FAN_OPERATION_LIST = ['On', 'Auto', 'Cycle'] +SUPPORT_FLAGS = (SUPPORT_TARGET_TEMPERATURE | SUPPORT_OPERATION_MODE | + SUPPORT_FAN_MODE) + def setup_platform(hass, config, add_devices_callback, discovery_info=None): """Set up of Vera thermostats.""" @@ -39,6 +44,11 @@ class VeraThermostat(VeraDevice, ClimateDevice): VeraDevice.__init__(self, vera_device, controller) self.entity_id = ENTITY_ID_FORMAT.format(self.vera_id) + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS + @property def current_operation(self): """Return current operation ie. heat, cool, idle.""" diff --git a/homeassistant/components/climate/wink.py b/homeassistant/components/climate/wink.py index 54d8d8617c7..33ba0f56d33 100644 --- a/homeassistant/components/climate/wink.py +++ b/homeassistant/components/climate/wink.py @@ -11,7 +11,10 @@ from homeassistant.components.climate import ( STATE_ECO, STATE_GAS, STATE_AUTO, STATE_COOL, STATE_HEAT, STATE_ELECTRIC, STATE_FAN_ONLY, STATE_HEAT_PUMP, ATTR_TEMPERATURE, STATE_HIGH_DEMAND, STATE_PERFORMANCE, ATTR_TARGET_TEMP_LOW, ATTR_CURRENT_HUMIDITY, - ATTR_TARGET_TEMP_HIGH, ClimateDevice) + ATTR_TARGET_TEMP_HIGH, ClimateDevice, SUPPORT_TARGET_TEMPERATURE, + SUPPORT_TARGET_TEMPERATURE_HIGH, SUPPORT_TARGET_TEMPERATURE_LOW, + SUPPORT_OPERATION_MODE, SUPPORT_AWAY_MODE, SUPPORT_FAN_MODE, + SUPPORT_AUX_HEAT) from homeassistant.components.wink import DOMAIN, WinkDevice from homeassistant.const import ( STATE_ON, STATE_OFF, TEMP_CELSIUS, STATE_UNKNOWN, PRECISION_TENTHS) @@ -50,6 +53,17 @@ HA_STATE_TO_WINK = { WINK_STATE_TO_HA = {value: key for key, value in HA_STATE_TO_WINK.items()} +SUPPORT_FLAGS_THERMOSTAT = ( + SUPPORT_TARGET_TEMPERATURE | SUPPORT_TARGET_TEMPERATURE_HIGH | + SUPPORT_TARGET_TEMPERATURE_LOW | SUPPORT_OPERATION_MODE | + SUPPORT_AWAY_MODE | SUPPORT_FAN_MODE | SUPPORT_AUX_HEAT) + +SUPPORT_FLAGS_AC = (SUPPORT_TARGET_TEMPERATURE | SUPPORT_OPERATION_MODE | + SUPPORT_FAN_MODE) + +SUPPORT_FLAGS_HEATER = (SUPPORT_TARGET_TEMPERATURE | SUPPORT_OPERATION_MODE | + SUPPORT_AWAY_MODE) + def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the Wink climate devices.""" @@ -72,6 +86,11 @@ def setup_platform(hass, config, add_devices, discovery_info=None): class WinkThermostat(WinkDevice, ClimateDevice): """Representation of a Wink thermostat.""" + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS_THERMOSTAT + @asyncio.coroutine def async_added_to_hass(self): """Callback when entity is added to hass.""" @@ -353,6 +372,11 @@ class WinkThermostat(WinkDevice, ClimateDevice): class WinkAC(WinkDevice, ClimateDevice): """Representation of a Wink air conditioner.""" + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS_AC + @property def temperature_unit(self): """Return the unit of measurement.""" @@ -471,6 +495,11 @@ class WinkAC(WinkDevice, ClimateDevice): class WinkWaterHeater(WinkDevice, ClimateDevice): """Representation of a Wink water heater.""" + @property + def supported_features(self): + """Return the list of supported features.""" + return SUPPORT_FLAGS_HEATER + @property def temperature_unit(self): """Return the unit of measurement.""" diff --git a/homeassistant/components/climate/zwave.py b/homeassistant/components/climate/zwave.py index 497916a3e4d..acc3eda1194 100755 --- a/homeassistant/components/climate/zwave.py +++ b/homeassistant/components/climate/zwave.py @@ -7,8 +7,9 @@ https://home-assistant.io/components/climate.zwave/ # Because we do not compile openzwave on CI # pylint: disable=import-error import logging -from homeassistant.components.climate import DOMAIN -from homeassistant.components.climate import ClimateDevice +from homeassistant.components.climate import ( + DOMAIN, ClimateDevice, SUPPORT_TARGET_TEMPERATURE, SUPPORT_FAN_MODE, + SUPPORT_OPERATION_MODE, SUPPORT_SWING_MODE) from homeassistant.components.zwave import ZWaveDeviceEntity from homeassistant.components.zwave import async_setup_platform # noqa # pylint: disable=unused-import from homeassistant.const import ( @@ -70,6 +71,18 @@ class ZWaveClimate(ZWaveDeviceEntity, ClimateDevice): self._zxt_120 = 1 self.update_properties() + @property + def supported_features(self): + """Return the list of supported features.""" + support = SUPPORT_TARGET_TEMPERATURE + if self.values.fan_mode: + support |= SUPPORT_FAN_MODE + if self.values.mode: + support |= SUPPORT_OPERATION_MODE + if self._zxt_120 == 1 and self.values.zxt_120_swing_mode: + support |= SUPPORT_SWING_MODE + return support + def update_properties(self): """Handle the data changes for node values.""" # Operation Mode diff --git a/tests/components/climate/test_mqtt.py b/tests/components/climate/test_mqtt.py index 9b70138908d..43f90eeee20 100644 --- a/tests/components/climate/test_mqtt.py +++ b/tests/components/climate/test_mqtt.py @@ -8,7 +8,10 @@ from homeassistant.util.unit_system import ( from homeassistant.setup import setup_component from homeassistant.components import climate from homeassistant.const import STATE_OFF - +from homeassistant.components.climate import ( + SUPPORT_OPERATION_MODE, SUPPORT_TARGET_TEMPERATURE, + SUPPORT_FAN_MODE, SUPPORT_SWING_MODE, SUPPORT_HOLD_MODE, + SUPPORT_AWAY_MODE, SUPPORT_AUX_HEAT) from tests.common import (get_test_home_assistant, mock_mqtt_component, fire_mqtt_message, mock_component) @@ -51,6 +54,17 @@ class TestMQTTClimate(unittest.TestCase): self.assertEqual("off", state.attributes.get('swing_mode')) self.assertEqual("off", state.attributes.get('operation_mode')) + def test_supported_features(self): + """Test the supported_features.""" + assert setup_component(self.hass, climate.DOMAIN, DEFAULT_CONFIG) + + state = self.hass.states.get(ENTITY_CLIMATE) + support = (SUPPORT_TARGET_TEMPERATURE | SUPPORT_OPERATION_MODE | + SUPPORT_SWING_MODE | SUPPORT_FAN_MODE | SUPPORT_AWAY_MODE | + SUPPORT_HOLD_MODE | SUPPORT_AUX_HEAT) + + self.assertEqual(state.attributes.get("supported_features"), support) + def test_get_operation_modes(self): """Test that the operation list returns the correct modes.""" assert setup_component(self.hass, climate.DOMAIN, DEFAULT_CONFIG) From 40a98d56fa455e5ba7ae62f1f2a2d68e3f7e54a2 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Wed, 29 Nov 2017 11:04:28 +0100 Subject: [PATCH 172/246] Upgrade mutagen to 1.39 (#10851) --- homeassistant/components/tts/__init__.py | 52 ++++++++++++------------ requirements_all.txt | 2 +- 2 files changed, 27 insertions(+), 27 deletions(-) diff --git a/homeassistant/components/tts/__init__.py b/homeassistant/components/tts/__init__.py index 59090b98e94..a7416bba117 100644 --- a/homeassistant/components/tts/__init__.py +++ b/homeassistant/components/tts/__init__.py @@ -8,53 +8,53 @@ import asyncio import ctypes import functools as ft import hashlib +import io import logging import mimetypes import os import re -import io from aiohttp import web import voluptuous as vol -from homeassistant.const import ATTR_ENTITY_ID -from homeassistant.setup import async_prepare_setup_platform -from homeassistant.core import callback -from homeassistant.config import load_yaml_config_file from homeassistant.components.http import HomeAssistantView from homeassistant.components.media_player import ( - SERVICE_PLAY_MEDIA, MEDIA_TYPE_MUSIC, ATTR_MEDIA_CONTENT_ID, - ATTR_MEDIA_CONTENT_TYPE, DOMAIN as DOMAIN_MP) + ATTR_MEDIA_CONTENT_ID, ATTR_MEDIA_CONTENT_TYPE, MEDIA_TYPE_MUSIC, + SERVICE_PLAY_MEDIA) +from homeassistant.components.media_player import DOMAIN as DOMAIN_MP +from homeassistant.config import load_yaml_config_file +from homeassistant.const import ATTR_ENTITY_ID +from homeassistant.core import callback from homeassistant.exceptions import HomeAssistantError from homeassistant.helpers import config_per_platform import homeassistant.helpers.config_validation as cv +from homeassistant.setup import async_prepare_setup_platform -REQUIREMENTS = ['mutagen==1.38'] - -DOMAIN = 'tts' -DEPENDENCIES = ['http'] +REQUIREMENTS = ['mutagen==1.39'] _LOGGER = logging.getLogger(__name__) +ATTR_CACHE = 'cache' +ATTR_LANGUAGE = 'language' +ATTR_MESSAGE = 'message' +ATTR_OPTIONS = 'options' + +CONF_CACHE = 'cache' +CONF_CACHE_DIR = 'cache_dir' +CONF_LANG = 'language' +CONF_TIME_MEMORY = 'time_memory' + +DEFAULT_CACHE = True +DEFAULT_CACHE_DIR = 'tts' +DEFAULT_TIME_MEMORY = 300 +DEPENDENCIES = ['http'] +DOMAIN = 'tts' + MEM_CACHE_FILENAME = 'filename' MEM_CACHE_VOICE = 'voice' -CONF_LANG = 'language' -CONF_CACHE = 'cache' -CONF_CACHE_DIR = 'cache_dir' -CONF_TIME_MEMORY = 'time_memory' - -DEFAULT_CACHE = True -DEFAULT_CACHE_DIR = "tts" -DEFAULT_TIME_MEMORY = 300 - -SERVICE_SAY = 'say' SERVICE_CLEAR_CACHE = 'clear_cache' - -ATTR_MESSAGE = 'message' -ATTR_CACHE = 'cache' -ATTR_LANGUAGE = 'language' -ATTR_OPTIONS = 'options' +SERVICE_SAY = 'say' _RE_VOICE_FILE = re.compile( r"([a-f0-9]{40})_([^_]+)_([^_]+)_([a-z_]+)\.[a-z0-9]{3,4}") diff --git a/requirements_all.txt b/requirements_all.txt index efcac280fdf..b37a6b68064 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -461,7 +461,7 @@ miniupnpc==2.0.2 motorparts==1.0.2 # homeassistant.components.tts -mutagen==1.38 +mutagen==1.39 # homeassistant.components.mycroft mycroftapi==2.0 From bb870a688da0f19806edbb715dd23e07e627f9b9 Mon Sep 17 00:00:00 2001 From: Aaron Bach Date: Wed, 29 Nov 2017 11:13:31 -0700 Subject: [PATCH 173/246] Updated codeowner for Tile device tracker (#10861) --- CODEOWNERS | 1 + 1 file changed, 1 insertion(+) diff --git a/CODEOWNERS b/CODEOWNERS index 6fa130432f4..fe415a619db 100644 --- a/CODEOWNERS +++ b/CODEOWNERS @@ -46,6 +46,7 @@ homeassistant/components/climate/eq3btsmart.py @rytilahti homeassistant/components/climate/sensibo.py @andrey-git homeassistant/components/cover/template.py @PhracturedBlue homeassistant/components/device_tracker/automatic.py @armills +homeassistant/components/device_tracker/tile.py @bachya homeassistant/components/history_graph.py @andrey-git homeassistant/components/light/tplink.py @rytilahti homeassistant/components/light/yeelight.py @rytilahti From 1c227bc0d9739983d81b222bfada7c40b9fd596d Mon Sep 17 00:00:00 2001 From: Julius Mittenzwei Date: Thu, 30 Nov 2017 15:52:57 +0100 Subject: [PATCH 174/246] Revert "KNX: Added config option for broadcasting current time to KNX bus. (#10654)" (#10874) This reverts commit cadd797200e339e165dbeff152169e4f4d716e2d. As discussed within #10708 we should chose a different implementation. Therefore we should revert this change to avoid a breaking change. --- homeassistant/components/knx.py | 16 ---------------- 1 file changed, 16 deletions(-) diff --git a/homeassistant/components/knx.py b/homeassistant/components/knx.py index d426e79ace9..3966b490f52 100644 --- a/homeassistant/components/knx.py +++ b/homeassistant/components/knx.py @@ -27,7 +27,6 @@ CONF_KNX_LOCAL_IP = "local_ip" CONF_KNX_FIRE_EVENT = "fire_event" CONF_KNX_FIRE_EVENT_FILTER = "fire_event_filter" CONF_KNX_STATE_UPDATER = "state_updater" -CONF_KNX_TIME_ADDRESS = "time_address" SERVICE_KNX_SEND = "send" SERVICE_KNX_ATTR_ADDRESS = "address" @@ -61,7 +60,6 @@ CONFIG_SCHEMA = vol.Schema({ vol.All( cv.ensure_list, [cv.string]), - vol.Optional(CONF_KNX_TIME_ADDRESS): cv.string, vol.Optional(CONF_KNX_STATE_UPDATER, default=True): cv.boolean, }) }, extra=vol.ALLOW_EXTRA) @@ -99,9 +97,6 @@ def async_setup(hass, config): ATTR_DISCOVER_DEVICES: found_devices }, config)) - if CONF_KNX_TIME_ADDRESS in config[DOMAIN]: - _add_time_device(hass, config) - hass.services.async_register( DOMAIN, SERVICE_KNX_SEND, hass.data[DATA_KNX].service_send_to_knx_bus, @@ -110,17 +105,6 @@ def async_setup(hass, config): return True -def _add_time_device(hass, config): - """Create time broadcasting device and add it to xknx device queue.""" - import xknx - group_address_time = config[DOMAIN][CONF_KNX_TIME_ADDRESS] - time = xknx.devices.Time( - hass.data[DATA_KNX].xknx, - 'Time', - group_address=group_address_time) - hass.data[DATA_KNX].xknx.devices.add(time) - - def _get_devices(hass, discovery_type): return list( map(lambda device: device.name, From bfc61c268a55aaa28e8d02e08b33f2330f05325a Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Thu, 30 Nov 2017 15:58:50 +0100 Subject: [PATCH 175/246] Upgrade distro to 1.1.0 (#10850) --- homeassistant/components/updater.py | 14 +++++++------- requirements_all.txt | 2 +- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/homeassistant/components/updater.py b/homeassistant/components/updater.py index cb9e5681dca..c67beee62dd 100644 --- a/homeassistant/components/updater.py +++ b/homeassistant/components/updater.py @@ -4,28 +4,28 @@ Support to check for available updates. For more details about this component, please refer to the documentation at https://home-assistant.io/components/updater/ """ +# pylint: disable=no-name-in-module, import-error import asyncio +from datetime import timedelta +from distutils.version import StrictVersion import json import logging import os import platform import uuid -from datetime import timedelta -# pylint: disable=no-name-in-module, import-error -from distutils.version import StrictVersion import aiohttp import async_timeout import voluptuous as vol +from homeassistant.const import ATTR_FRIENDLY_NAME +from homeassistant.const import __version__ as current_version +from homeassistant.helpers import event from homeassistant.helpers.aiohttp_client import async_get_clientsession import homeassistant.helpers.config_validation as cv import homeassistant.util.dt as dt_util -from homeassistant.const import ( - ATTR_FRIENDLY_NAME, __version__ as current_version) -from homeassistant.helpers import event -REQUIREMENTS = ['distro==1.0.4'] +REQUIREMENTS = ['distro==1.1.0'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index b37a6b68064..35235df3b53 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -206,7 +206,7 @@ directpy==0.2 discord.py==0.16.12 # homeassistant.components.updater -distro==1.0.4 +distro==1.1.0 # homeassistant.components.switch.digitalloggers dlipower==0.7.165 From ea6ca9252c8db82b03d33ee2b66c80bb2ab1c33b Mon Sep 17 00:00:00 2001 From: Pascal Vizeli Date: Thu, 30 Nov 2017 21:03:52 +0100 Subject: [PATCH 176/246] Bugfix trigger state with multible entities (#10857) * Bugfix trigger state with multible entities * Fix numeric state * fix lint * fix dict * fix unsub * fix logic * fix name * fix new logic * add test for state * add numeric state test for unsub * add test for multible entities * Update numeric_state.py * Update numeric_state.py * Update state.py * Fix logic for triple match * Add clear to numeric state * clear for state trigger --- .../components/automation/numeric_state.py | 21 ++--- homeassistant/components/automation/state.py | 11 ++- .../automation/test_numeric_state.py | 77 +++++++++++++++++++ tests/components/automation/test_state.py | 41 ++++++++++ 4 files changed, 134 insertions(+), 16 deletions(-) diff --git a/homeassistant/components/automation/numeric_state.py b/homeassistant/components/automation/numeric_state.py index d5cdc9ffd83..b59271f25e5 100644 --- a/homeassistant/components/automation/numeric_state.py +++ b/homeassistant/components/automation/numeric_state.py @@ -37,8 +37,8 @@ def async_trigger(hass, config, action): above = config.get(CONF_ABOVE) time_delta = config.get(CONF_FOR) value_template = config.get(CONF_VALUE_TEMPLATE) - async_remove_track_same = None - already_triggered = False + unsub_track_same = {} + entities_triggered = set() if value_template is not None: value_template.hass = hass @@ -63,8 +63,6 @@ def async_trigger(hass, config, action): @callback def state_automation_listener(entity, from_s, to_s): """Listen for state changes and calls action.""" - nonlocal already_triggered, async_remove_track_same - @callback def call_action(): """Call action with right context.""" @@ -81,16 +79,18 @@ def async_trigger(hass, config, action): matching = check_numeric_state(entity, from_s, to_s) - if matching and not already_triggered: + if not matching: + entities_triggered.discard(entity) + elif entity not in entities_triggered: + entities_triggered.add(entity) + if time_delta: - async_remove_track_same = async_track_same_state( + unsub_track_same[entity] = async_track_same_state( hass, time_delta, call_action, entity_ids=entity_id, async_check_same_func=check_numeric_state) else: call_action() - already_triggered = matching - unsub = async_track_state_change( hass, entity_id, state_automation_listener) @@ -98,7 +98,8 @@ def async_trigger(hass, config, action): def async_remove(): """Remove state listeners async.""" unsub() - if async_remove_track_same: - async_remove_track_same() # pylint: disable=not-callable + for async_remove in unsub_track_same.values(): + async_remove() + unsub_track_same.clear() return async_remove diff --git a/homeassistant/components/automation/state.py b/homeassistant/components/automation/state.py index 7ed44761be8..e4d096d35fd 100644 --- a/homeassistant/components/automation/state.py +++ b/homeassistant/components/automation/state.py @@ -35,13 +35,11 @@ def async_trigger(hass, config, action): to_state = config.get(CONF_TO, MATCH_ALL) time_delta = config.get(CONF_FOR) match_all = (from_state == MATCH_ALL and to_state == MATCH_ALL) - async_remove_track_same = None + unsub_track_same = {} @callback def state_automation_listener(entity, from_s, to_s): """Listen for state changes and calls action.""" - nonlocal async_remove_track_same - @callback def call_action(): """Call action with right context.""" @@ -64,7 +62,7 @@ def async_trigger(hass, config, action): call_action() return - async_remove_track_same = async_track_same_state( + unsub_track_same[entity] = async_track_same_state( hass, time_delta, call_action, lambda _, _2, to_state: to_state.state == to_s.state, entity_ids=entity_id) @@ -76,7 +74,8 @@ def async_trigger(hass, config, action): def async_remove(): """Remove state listeners async.""" unsub() - if async_remove_track_same: - async_remove_track_same() # pylint: disable=not-callable + for async_remove in unsub_track_same.values(): + async_remove() + unsub_track_same.clear() return async_remove diff --git a/tests/components/automation/test_numeric_state.py b/tests/components/automation/test_numeric_state.py index 35841baa930..58cfd2cbd70 100644 --- a/tests/components/automation/test_numeric_state.py +++ b/tests/components/automation/test_numeric_state.py @@ -84,6 +84,36 @@ class TestAutomationNumericState(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) + def test_if_fires_on_entities_change_over_to_below(self): + """"Test the firing with changed entities.""" + self.hass.states.set('test.entity_1', 11) + self.hass.states.set('test.entity_2', 11) + self.hass.block_till_done() + + assert setup_component(self.hass, automation.DOMAIN, { + automation.DOMAIN: { + 'trigger': { + 'platform': 'numeric_state', + 'entity_id': [ + 'test.entity_1', + 'test.entity_2', + ], + 'below': 10, + }, + 'action': { + 'service': 'test.automation' + } + } + }) + + # 9 is below 10 + self.hass.states.set('test.entity_1', 9) + self.hass.block_till_done() + self.assertEqual(1, len(self.calls)) + self.hass.states.set('test.entity_2', 9) + self.hass.block_till_done() + self.assertEqual(2, len(self.calls)) + def test_if_not_fires_on_entity_change_below_to_below(self): """"Test the firing with changed entity.""" self.hass.states.set('test.entity', 11) @@ -112,6 +142,11 @@ class TestAutomationNumericState(unittest.TestCase): self.hass.block_till_done() self.assertEqual(1, len(self.calls)) + # still below so should not fire again + self.hass.states.set('test.entity', 3) + self.hass.block_till_done() + self.assertEqual(1, len(self.calls)) + def test_if_not_below_fires_on_entity_change_to_equal(self): """"Test the firing with changed entity.""" self.hass.states.set('test.entity', 11) @@ -701,6 +736,48 @@ class TestAutomationNumericState(unittest.TestCase): self.hass.block_till_done() self.assertEqual(0, len(self.calls)) + def test_if_not_fires_on_entities_change_with_for_afte_stop(self): + """Test for not firing on entities change with for after stop.""" + assert setup_component(self.hass, automation.DOMAIN, { + automation.DOMAIN: { + 'trigger': { + 'platform': 'numeric_state', + 'entity_id': [ + 'test.entity_1', + 'test.entity_2', + ], + 'above': 8, + 'below': 12, + 'for': { + 'seconds': 5 + }, + }, + 'action': { + 'service': 'test.automation' + } + } + }) + + self.hass.states.set('test.entity_1', 9) + self.hass.states.set('test.entity_2', 9) + self.hass.block_till_done() + fire_time_changed(self.hass, dt_util.utcnow() + timedelta(seconds=10)) + self.hass.block_till_done() + self.assertEqual(2, len(self.calls)) + + self.hass.states.set('test.entity_1', 15) + self.hass.states.set('test.entity_2', 15) + self.hass.block_till_done() + self.hass.states.set('test.entity_1', 9) + self.hass.states.set('test.entity_2', 9) + self.hass.block_till_done() + automation.turn_off(self.hass) + self.hass.block_till_done() + + fire_time_changed(self.hass, dt_util.utcnow() + timedelta(seconds=10)) + self.hass.block_till_done() + self.assertEqual(2, len(self.calls)) + def test_if_fires_on_entity_change_with_for_attribute_change(self): """Test for firing on entity change with for and attribute change.""" assert setup_component(self.hass, automation.DOMAIN, { diff --git a/tests/components/automation/test_state.py b/tests/components/automation/test_state.py index 1f245d1cf5c..b1ee0841e2d 100644 --- a/tests/components/automation/test_state.py +++ b/tests/components/automation/test_state.py @@ -334,6 +334,47 @@ class TestAutomationState(unittest.TestCase): self.hass.block_till_done() self.assertEqual(0, len(self.calls)) + def test_if_not_fires_on_entities_change_with_for_after_stop(self): + """Test for not firing on entity change with for after stop trigger.""" + assert setup_component(self.hass, automation.DOMAIN, { + automation.DOMAIN: { + 'trigger': { + 'platform': 'state', + 'entity_id': [ + 'test.entity_1', + 'test.entity_2', + ], + 'to': 'world', + 'for': { + 'seconds': 5 + }, + }, + 'action': { + 'service': 'test.automation' + } + } + }) + + self.hass.states.set('test.entity_1', 'world') + self.hass.states.set('test.entity_2', 'world') + self.hass.block_till_done() + fire_time_changed(self.hass, dt_util.utcnow() + timedelta(seconds=10)) + self.hass.block_till_done() + self.assertEqual(2, len(self.calls)) + + self.hass.states.set('test.entity_1', 'world_no') + self.hass.states.set('test.entity_2', 'world_no') + self.hass.block_till_done() + self.hass.states.set('test.entity_1', 'world') + self.hass.states.set('test.entity_2', 'world') + self.hass.block_till_done() + automation.turn_off(self.hass) + self.hass.block_till_done() + + fire_time_changed(self.hass, dt_util.utcnow() + timedelta(seconds=10)) + self.hass.block_till_done() + self.assertEqual(2, len(self.calls)) + def test_if_fires_on_entity_change_with_for_attribute_change(self): """Test for firing on entity change with for and attribute change.""" assert setup_component(self.hass, automation.DOMAIN, { From f7380dc9272605fb62c3ac41cde71af007df93b8 Mon Sep 17 00:00:00 2001 From: Pascal Vizeli Date: Thu, 30 Nov 2017 21:13:18 +0100 Subject: [PATCH 177/246] tellstick fix DEPENDENCIES and update tellcore-net (#10859) * Update requirements_all.txt * Update tellstick.py * Fix DEPENDENCIES * Update requirements_all.txt * fix format * fix lint * fix lint * Update tellstick.py * update tellcore-net * update tellcore-net * besser validate --- homeassistant/components/sensor/tellstick.py | 2 +- homeassistant/components/tellstick.py | 12 +++++++----- requirements_all.txt | 3 +-- 3 files changed, 9 insertions(+), 8 deletions(-) diff --git a/homeassistant/components/sensor/tellstick.py b/homeassistant/components/sensor/tellstick.py index c9f922207e5..8355add47e9 100644 --- a/homeassistant/components/sensor/tellstick.py +++ b/homeassistant/components/sensor/tellstick.py @@ -14,7 +14,7 @@ from homeassistant.const import TEMP_CELSIUS from homeassistant.helpers.entity import Entity import homeassistant.helpers.config_validation as cv -REQUIREMENTS = ['tellcore-py==1.1.2'] +DEPENDENCIES = ['tellstick'] _LOGGER = logging.getLogger(__name__) diff --git a/homeassistant/components/tellstick.py b/homeassistant/components/tellstick.py index 91a7c0c69e5..bcef0d3fb85 100644 --- a/homeassistant/components/tellstick.py +++ b/homeassistant/components/tellstick.py @@ -17,7 +17,7 @@ from homeassistant.const import ( from homeassistant.helpers.entity import Entity import homeassistant.helpers.config_validation as cv -REQUIREMENTS = ['tellcore-py==1.1.2', 'tellcore-net==0.1'] +REQUIREMENTS = ['tellcore-py==1.1.2', 'tellcore-net==0.3'] _LOGGER = logging.getLogger(__name__) @@ -42,7 +42,8 @@ TELLCORE_REGISTRY = None CONFIG_SCHEMA = vol.Schema({ DOMAIN: vol.Schema({ vol.Inclusive(CONF_HOST, 'tellcore-net'): cv.string, - vol.Inclusive(CONF_PORT, 'tellcore-net'): cv.port, + vol.Inclusive(CONF_PORT, 'tellcore-net'): + vol.All(cv.ensure_list, [cv.port], vol.Length(min=2, max=2)), vol.Optional(CONF_SIGNAL_REPETITIONS, default=DEFAULT_SIGNAL_REPETITIONS): vol.Coerce(int), }), @@ -73,11 +74,12 @@ def setup(hass, config): conf = config.get(DOMAIN, {}) net_host = conf.get(CONF_HOST) - net_port = conf.get(CONF_PORT) + net_ports = conf.get(CONF_PORT) # Initialize remote tellcore client - if net_host and net_port: - net_client = TellCoreClient(net_host, net_port) + if net_host: + net_client = TellCoreClient( + host=net_host, port_client=net_ports[0], port_events=net_ports[1]) net_client.start() def stop_tellcore_net(event): diff --git a/requirements_all.txt b/requirements_all.txt index 35235df3b53..abc175279e2 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -1057,10 +1057,9 @@ tank_utility==1.4.0 tapsaff==0.1.3 # homeassistant.components.tellstick -tellcore-net==0.1 +tellcore-net==0.3 # homeassistant.components.tellstick -# homeassistant.components.sensor.tellstick tellcore-py==1.1.2 # homeassistant.components.tellduslive From d8003c4d8752b29beeaf503b5af66e596c1b3544 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Thu, 30 Nov 2017 20:46:13 -0800 Subject: [PATCH 178/246] Update frontend to 20171130.0 --- homeassistant/components/frontend/__init__.py | 2 +- requirements_all.txt | 2 +- requirements_test_all.txt | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index 74090c78107..4eb1459288a 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -23,7 +23,7 @@ from homeassistant.const import CONF_NAME, EVENT_THEMES_UPDATED from homeassistant.core import callback from homeassistant.loader import bind_hass -REQUIREMENTS = ['home-assistant-frontend==20171127.0', 'user-agents==1.1.0'] +REQUIREMENTS = ['home-assistant-frontend==20171130.0', 'user-agents==1.1.0'] DOMAIN = 'frontend' DEPENDENCIES = ['api', 'websocket_api', 'http', 'system_log'] diff --git a/requirements_all.txt b/requirements_all.txt index abc175279e2..e75ca6f2700 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -331,7 +331,7 @@ hipnotify==1.0.8 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171127.0 +home-assistant-frontend==20171130.0 # homeassistant.components.camera.onvif http://github.com/tgaugry/suds-passworddigest-py3/archive/86fc50e39b4d2b8997481967d6a7fe1c57118999.zip#suds-passworddigest-py3==0.1.2a diff --git a/requirements_test_all.txt b/requirements_test_all.txt index ff12d18d6c6..b02d80ad0e3 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -74,7 +74,7 @@ hbmqtt==0.9.1 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171127.0 +home-assistant-frontend==20171130.0 # homeassistant.components.influxdb # homeassistant.components.sensor.influxdb From 9a0a5b78675eac691ed6476e5ccf5833c86264b7 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Fri, 1 Dec 2017 12:22:28 +0100 Subject: [PATCH 179/246] Upgrade aiohttp to 2.3.5 (#10889) --- homeassistant/package_constraints.txt | 2 +- requirements_all.txt | 2 +- setup.py | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/package_constraints.txt b/homeassistant/package_constraints.txt index 056ed2f3fa6..b45e0b2eaed 100644 --- a/homeassistant/package_constraints.txt +++ b/homeassistant/package_constraints.txt @@ -5,7 +5,7 @@ pip>=8.0.3 jinja2>=2.9.6 voluptuous==0.10.5 typing>=3,<4 -aiohttp==2.3.2 +aiohttp==2.3.5 yarl==0.14.0 async_timeout==2.0.0 chardet==3.0.4 diff --git a/requirements_all.txt b/requirements_all.txt index e75ca6f2700..bb898f5a39b 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -6,7 +6,7 @@ pip>=8.0.3 jinja2>=2.9.6 voluptuous==0.10.5 typing>=3,<4 -aiohttp==2.3.2 +aiohttp==2.3.5 yarl==0.14.0 async_timeout==2.0.0 chardet==3.0.4 diff --git a/setup.py b/setup.py index f7a3e4ab8f3..cbc497e4bd5 100755 --- a/setup.py +++ b/setup.py @@ -53,7 +53,7 @@ REQUIRES = [ 'jinja2>=2.9.6', 'voluptuous==0.10.5', 'typing>=3,<4', - 'aiohttp==2.3.2', # If updated, check if yarl also needs an update! + 'aiohttp==2.3.5', # If updated, check if yarl also needs an update! 'yarl==0.14.0', 'async_timeout==2.0.0', 'chardet==3.0.4', From d2106c40e1707797995c7799ab79b290353312c5 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Fri, 1 Dec 2017 12:25:54 +0100 Subject: [PATCH 180/246] Upgrade fastdotcom to 0.0.3 (#10886) --- homeassistant/components/sensor/fastdotcom.py | 7 ++++--- requirements_all.txt | 2 +- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/homeassistant/components/sensor/fastdotcom.py b/homeassistant/components/sensor/fastdotcom.py index 61f2e000d1d..02dd32c20af 100644 --- a/homeassistant/components/sensor/fastdotcom.py +++ b/homeassistant/components/sensor/fastdotcom.py @@ -6,16 +6,17 @@ https://home-assistant.io/components/sensor.fastdotcom/ """ import asyncio import logging + import voluptuous as vol -import homeassistant.util.dt as dt_util +from homeassistant.components.sensor import DOMAIN, PLATFORM_SCHEMA import homeassistant.helpers.config_validation as cv -from homeassistant.components.sensor import (DOMAIN, PLATFORM_SCHEMA) from homeassistant.helpers.entity import Entity from homeassistant.helpers.event import track_time_change from homeassistant.helpers.restore_state import async_get_last_state +import homeassistant.util.dt as dt_util -REQUIREMENTS = ['fastdotcom==0.0.1'] +REQUIREMENTS = ['fastdotcom==0.0.3'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index bb898f5a39b..f517a3fe45d 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -247,7 +247,7 @@ evohomeclient==0.2.5 # face_recognition==1.0.0 # homeassistant.components.sensor.fastdotcom -fastdotcom==0.0.1 +fastdotcom==0.0.3 # homeassistant.components.sensor.fedex fedexdeliverymanager==1.0.4 From 493de295aced855d021af6742c968042fe1191f3 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Fri, 1 Dec 2017 12:26:15 +0100 Subject: [PATCH 181/246] Upgrade schiene to 0.19 (#10887) --- homeassistant/components/sensor/deutsche_bahn.py | 8 ++++---- requirements_all.txt | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/homeassistant/components/sensor/deutsche_bahn.py b/homeassistant/components/sensor/deutsche_bahn.py index 04c9ba45c78..e07730b53e8 100644 --- a/homeassistant/components/sensor/deutsche_bahn.py +++ b/homeassistant/components/sensor/deutsche_bahn.py @@ -4,17 +4,17 @@ Support for information about the German train system. For more details about this platform, please refer to the documentation at https://home-assistant.io/components/sensor.deutsche_bahn/ """ -import logging from datetime import timedelta +import logging import voluptuous as vol -import homeassistant.helpers.config_validation as cv -import homeassistant.util.dt as dt_util from homeassistant.components.sensor import PLATFORM_SCHEMA +import homeassistant.helpers.config_validation as cv from homeassistant.helpers.entity import Entity +import homeassistant.util.dt as dt_util -REQUIREMENTS = ['schiene==0.18'] +REQUIREMENTS = ['schiene==0.19'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index f517a3fe45d..5f5a5323f2b 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -982,7 +982,7 @@ samsungctl==0.6.0 satel_integra==0.1.0 # homeassistant.components.sensor.deutsche_bahn -schiene==0.18 +schiene==0.19 # homeassistant.components.scsgate scsgate==0.1.0 From 7b452208b6174762b04bfe5e3d57ead5fb9b1fd6 Mon Sep 17 00:00:00 2001 From: Teemu R Date: Fri, 1 Dec 2017 12:28:59 +0100 Subject: [PATCH 182/246] Xiaomi Vacuum: remove deprecated calls (#10839) * vacuum.xiaomi_miio: read dnd status properly instead of using imprecise dnd flag from vacuum_state * vacuum.xiaomi_miio: use miio package instead of mirobo * check only that wanted calls have taken place, ignore order of calls * Fix linting issues * Remove empty line after docstring --- .../components/vacuum/xiaomi_miio.py | 19 +- tests/components/vacuum/test_xiaomi_miio.py | 217 +++++++----------- 2 files changed, 101 insertions(+), 135 deletions(-) diff --git a/homeassistant/components/vacuum/xiaomi_miio.py b/homeassistant/components/vacuum/xiaomi_miio.py index 131f5d5a77f..a2265706d87 100644 --- a/homeassistant/components/vacuum/xiaomi_miio.py +++ b/homeassistant/components/vacuum/xiaomi_miio.py @@ -48,6 +48,8 @@ FAN_SPEEDS = { ATTR_CLEANING_TIME = 'cleaning_time' ATTR_DO_NOT_DISTURB = 'do_not_disturb' +ATTR_DO_NOT_DISTURB_START = 'do_not_disturb_start' +ATTR_DO_NOT_DISTURB_END = 'do_not_disturb_end' ATTR_MAIN_BRUSH_LEFT = 'main_brush_left' ATTR_SIDE_BRUSH_LEFT = 'side_brush_left' ATTR_FILTER_LEFT = 'filter_left' @@ -87,7 +89,7 @@ SUPPORT_XIAOMI = SUPPORT_TURN_ON | SUPPORT_TURN_OFF | SUPPORT_PAUSE | \ @asyncio.coroutine def async_setup_platform(hass, config, async_add_devices, discovery_info=None): """Set up the Xiaomi vacuum cleaner robot platform.""" - from mirobo import Vacuum + from miio import Vacuum if PLATFORM not in hass.data: hass.data[PLATFORM] = {} @@ -155,6 +157,7 @@ class MiroboVacuum(VacuumDevice): self.consumable_state = None self.clean_history = None + self.dnd_state = None @property def name(self): @@ -200,7 +203,9 @@ class MiroboVacuum(VacuumDevice): if self.vacuum_state is not None: attrs.update({ ATTR_DO_NOT_DISTURB: - STATE_ON if self.vacuum_state.dnd else STATE_OFF, + STATE_ON if self.dnd_state.enabled else STATE_OFF, + ATTR_DO_NOT_DISTURB_START: str(self.dnd_state.start), + ATTR_DO_NOT_DISTURB_END: str(self.dnd_state.end), # Not working --> 'Cleaning mode': # STATE_ON if self.vacuum_state.in_cleaning else STATE_OFF, ATTR_CLEANING_TIME: int( @@ -223,7 +228,6 @@ class MiroboVacuum(VacuumDevice): / 3600)}) if self.vacuum_state.got_error: attrs[ATTR_ERROR] = self.vacuum_state.error - return attrs @property @@ -244,11 +248,11 @@ class MiroboVacuum(VacuumDevice): @asyncio.coroutine def _try_command(self, mask_error, func, *args, **kwargs): """Call a vacuum command handling error messages.""" - from mirobo import DeviceException, VacuumException + from miio import DeviceException try: yield from self.hass.async_add_job(partial(func, *args, **kwargs)) return True - except (DeviceException, VacuumException) as exc: + except DeviceException as exc: _LOGGER.error(mask_error, exc) return False @@ -365,12 +369,15 @@ class MiroboVacuum(VacuumDevice): def update(self): """Fetch state from the device.""" - from mirobo import DeviceException + from miio import DeviceException try: state = self._vacuum.status() self.vacuum_state = state + self.consumable_state = self._vacuum.consumable_status() self.clean_history = self._vacuum.clean_history() + self.dnd_state = self._vacuum.dnd_status() + self._is_on = state.is_on self._available = True except OSError as exc: diff --git a/tests/components/vacuum/test_xiaomi_miio.py b/tests/components/vacuum/test_xiaomi_miio.py index bdb85abb057..62ad5fc4a2b 100644 --- a/tests/components/vacuum/test_xiaomi_miio.py +++ b/tests/components/vacuum/test_xiaomi_miio.py @@ -1,6 +1,6 @@ """The tests for the Xiaomi vacuum platform.""" import asyncio -from datetime import timedelta +from datetime import timedelta, time from unittest import mock import pytest @@ -12,7 +12,8 @@ from homeassistant.components.vacuum import ( SERVICE_SEND_COMMAND, SERVICE_SET_FAN_SPEED, SERVICE_START_PAUSE, SERVICE_STOP, SERVICE_TOGGLE, SERVICE_TURN_OFF, SERVICE_TURN_ON) from homeassistant.components.vacuum.xiaomi_miio import ( - ATTR_CLEANED_AREA, ATTR_CLEANING_TIME, ATTR_DO_NOT_DISTURB, ATTR_ERROR, + ATTR_CLEANED_AREA, ATTR_CLEANING_TIME, ATTR_DO_NOT_DISTURB, + ATTR_DO_NOT_DISTURB_START, ATTR_DO_NOT_DISTURB_END, ATTR_ERROR, ATTR_MAIN_BRUSH_LEFT, ATTR_SIDE_BRUSH_LEFT, ATTR_FILTER_LEFT, ATTR_CLEANING_COUNT, ATTR_CLEANED_TOTAL_AREA, ATTR_CLEANING_TOTAL_TIME, CONF_HOST, CONF_NAME, CONF_TOKEN, PLATFORM, @@ -23,6 +24,12 @@ from homeassistant.const import ( STATE_ON) from homeassistant.setup import async_setup_component +# calls made when device status is requested +status_calls = [mock.call.Vacuum().status(), + mock.call.Vacuum().consumable_status(), + mock.call.Vacuum().clean_history(), + mock.call.Vacuum().dnd_status()] + @pytest.fixture def mock_mirobo_is_off(): @@ -33,7 +40,6 @@ def mock_mirobo_is_off(): mock_vacuum.Vacuum().status().fanspeed = 38 mock_vacuum.Vacuum().status().got_error = True mock_vacuum.Vacuum().status().error = 'Error message' - mock_vacuum.Vacuum().status().dnd = True mock_vacuum.Vacuum().status().battery = 82 mock_vacuum.Vacuum().status().clean_area = 123.43218 mock_vacuum.Vacuum().status().clean_time = timedelta( @@ -49,9 +55,12 @@ def mock_mirobo_is_off(): mock_vacuum.Vacuum().clean_history().total_duration = timedelta( hours=11, minutes=35, seconds=34) mock_vacuum.Vacuum().status().state = 'Test Xiaomi Charging' + mock_vacuum.Vacuum().dnd_status().enabled = True + mock_vacuum.Vacuum().dnd_status().start = time(hour=22, minute=0) + mock_vacuum.Vacuum().dnd_status().end = time(hour=6, minute=0) with mock.patch.dict('sys.modules', { - 'mirobo': mock_vacuum, + 'miio': mock_vacuum, }): yield mock_vacuum @@ -64,7 +73,6 @@ def mock_mirobo_is_on(): mock_vacuum.Vacuum().status().is_on = True mock_vacuum.Vacuum().status().fanspeed = 99 mock_vacuum.Vacuum().status().got_error = False - mock_vacuum.Vacuum().status().dnd = False mock_vacuum.Vacuum().status().battery = 32 mock_vacuum.Vacuum().status().clean_area = 133.43218 mock_vacuum.Vacuum().status().clean_time = timedelta( @@ -80,9 +88,10 @@ def mock_mirobo_is_on(): mock_vacuum.Vacuum().clean_history().total_duration = timedelta( hours=11, minutes=15, seconds=34) mock_vacuum.Vacuum().status().state = 'Test Xiaomi Cleaning' + mock_vacuum.Vacuum().dnd_status().enabled = False with mock.patch.dict('sys.modules', { - 'mirobo': mock_vacuum, + 'miio': mock_vacuum, }): yield mock_vacuum @@ -93,7 +102,7 @@ def mock_mirobo_errors(): mock_vacuum = mock.MagicMock() mock_vacuum.Vacuum().status.side_effect = OSError() with mock.patch.dict('sys.modules', { - 'mirobo': mock_vacuum, + 'miio': mock_vacuum, }): yield mock_vacuum @@ -136,6 +145,8 @@ def test_xiaomi_vacuum_services(hass, caplog, mock_mirobo_is_off): assert state.state == STATE_OFF assert state.attributes.get(ATTR_SUPPORTED_FEATURES) == 2047 assert state.attributes.get(ATTR_DO_NOT_DISTURB) == STATE_ON + assert state.attributes.get(ATTR_DO_NOT_DISTURB_START) == '22:00:00' + assert state.attributes.get(ATTR_DO_NOT_DISTURB_END) == '06:00:00' assert state.attributes.get(ATTR_ERROR) == 'Error message' assert (state.attributes.get(ATTR_BATTERY_ICON) == 'mdi:battery-charging-80') @@ -154,96 +165,75 @@ def test_xiaomi_vacuum_services(hass, caplog, mock_mirobo_is_off): # Call services yield from hass.services.async_call( DOMAIN, SERVICE_TURN_ON, blocking=True) - assert str(mock_mirobo_is_off.mock_calls[-4]) == 'call.Vacuum().start()' - assert str(mock_mirobo_is_off.mock_calls[-3]) == 'call.Vacuum().status()' - assert (str(mock_mirobo_is_off.mock_calls[-2]) - == 'call.Vacuum().consumable_status()') - assert (str(mock_mirobo_is_off.mock_calls[-1]) - == 'call.Vacuum().clean_history()') + + mock_mirobo_is_off.assert_has_calls( + [mock.call.Vacuum.start()], any_order=True) + mock_mirobo_is_off.assert_has_calls(status_calls, any_order=True) + mock_mirobo_is_off.reset_mock() yield from hass.services.async_call( DOMAIN, SERVICE_TURN_OFF, blocking=True) - assert str(mock_mirobo_is_off.mock_calls[-4]) == 'call.Vacuum().home()' - assert str(mock_mirobo_is_off.mock_calls[-3]) == 'call.Vacuum().status()' - assert (str(mock_mirobo_is_off.mock_calls[-2]) - == 'call.Vacuum().consumable_status()') - assert (str(mock_mirobo_is_off.mock_calls[-1]) - == 'call.Vacuum().clean_history()') + mock_mirobo_is_off.assert_has_calls( + [mock.call.Vacuum().home()], any_order=True) + mock_mirobo_is_off.assert_has_calls(status_calls, any_order=True) + mock_mirobo_is_off.reset_mock() yield from hass.services.async_call( DOMAIN, SERVICE_TOGGLE, blocking=True) - assert str(mock_mirobo_is_off.mock_calls[-4]) == 'call.Vacuum().start()' - assert str(mock_mirobo_is_off.mock_calls[-3]) == 'call.Vacuum().status()' - assert (str(mock_mirobo_is_off.mock_calls[-2]) - == 'call.Vacuum().consumable_status()') - assert (str(mock_mirobo_is_off.mock_calls[-1]) - == 'call.Vacuum().clean_history()') + mock_mirobo_is_off.assert_has_calls( + [mock.call.Vacuum().start()], any_order=True) + mock_mirobo_is_off.assert_has_calls(status_calls, any_order=True) + mock_mirobo_is_off.reset_mock() yield from hass.services.async_call( DOMAIN, SERVICE_STOP, blocking=True) - assert str(mock_mirobo_is_off.mock_calls[-4]) == 'call.Vacuum().stop()' - assert str(mock_mirobo_is_off.mock_calls[-3]) == 'call.Vacuum().status()' - assert (str(mock_mirobo_is_off.mock_calls[-2]) - == 'call.Vacuum().consumable_status()') - assert (str(mock_mirobo_is_off.mock_calls[-1]) - == 'call.Vacuum().clean_history()') + mock_mirobo_is_off.assert_has_calls( + [mock.call.Vacuum().stop()], any_order=True) + mock_mirobo_is_off.assert_has_calls(status_calls, any_order=True) + mock_mirobo_is_off.reset_mock() yield from hass.services.async_call( DOMAIN, SERVICE_START_PAUSE, blocking=True) - assert str(mock_mirobo_is_off.mock_calls[-4]) == 'call.Vacuum().start()' - assert str(mock_mirobo_is_off.mock_calls[-3]) == 'call.Vacuum().status()' - assert (str(mock_mirobo_is_off.mock_calls[-2]) - == 'call.Vacuum().consumable_status()') - assert (str(mock_mirobo_is_off.mock_calls[-1]) - == 'call.Vacuum().clean_history()') + mock_mirobo_is_off.assert_has_calls( + [mock.call.Vacuum().pause()], any_order=True) + mock_mirobo_is_off.assert_has_calls(status_calls, any_order=True) + mock_mirobo_is_off.reset_mock() yield from hass.services.async_call( DOMAIN, SERVICE_RETURN_TO_BASE, blocking=True) - assert str(mock_mirobo_is_off.mock_calls[-4]) == 'call.Vacuum().home()' - assert str(mock_mirobo_is_off.mock_calls[-3]) == 'call.Vacuum().status()' - assert (str(mock_mirobo_is_off.mock_calls[-2]) - == 'call.Vacuum().consumable_status()') - assert (str(mock_mirobo_is_off.mock_calls[-1]) - == 'call.Vacuum().clean_history()') + mock_mirobo_is_off.assert_has_calls( + [mock.call.Vacuum().home()], any_order=True) + mock_mirobo_is_off.assert_has_calls(status_calls, any_order=True) + mock_mirobo_is_off.reset_mock() yield from hass.services.async_call( DOMAIN, SERVICE_LOCATE, blocking=True) - assert str(mock_mirobo_is_off.mock_calls[-4]) == 'call.Vacuum().find()' - assert str(mock_mirobo_is_off.mock_calls[-3]) == 'call.Vacuum().status()' - assert (str(mock_mirobo_is_off.mock_calls[-2]) - == 'call.Vacuum().consumable_status()') - assert (str(mock_mirobo_is_off.mock_calls[-1]) - == 'call.Vacuum().clean_history()') + mock_mirobo_is_off.assert_has_calls( + [mock.call.Vacuum().find()], any_order=True) + mock_mirobo_is_off.assert_has_calls(status_calls, any_order=True) + mock_mirobo_is_off.reset_mock() yield from hass.services.async_call( DOMAIN, SERVICE_CLEAN_SPOT, {}, blocking=True) - assert str(mock_mirobo_is_off.mock_calls[-4]) == 'call.Vacuum().spot()' - assert str(mock_mirobo_is_off.mock_calls[-3]) == 'call.Vacuum().status()' - assert (str(mock_mirobo_is_off.mock_calls[-2]) - == 'call.Vacuum().consumable_status()') - assert (str(mock_mirobo_is_off.mock_calls[-1]) - == 'call.Vacuum().clean_history()') + mock_mirobo_is_off.assert_has_calls( + [mock.call.Vacuum().spot()], any_order=True) + mock_mirobo_is_off.assert_has_calls(status_calls, any_order=True) + mock_mirobo_is_off.reset_mock() # Set speed service: yield from hass.services.async_call( DOMAIN, SERVICE_SET_FAN_SPEED, {"fan_speed": 60}, blocking=True) - assert (str(mock_mirobo_is_off.mock_calls[-4]) - == 'call.Vacuum().set_fan_speed(60)') - assert str(mock_mirobo_is_off.mock_calls[-3]) == 'call.Vacuum().status()' - assert (str(mock_mirobo_is_off.mock_calls[-2]) - == 'call.Vacuum().consumable_status()') - assert (str(mock_mirobo_is_off.mock_calls[-1]) - == 'call.Vacuum().clean_history()') + mock_mirobo_is_off.assert_has_calls( + [mock.call.Vacuum().set_fan_speed(60)], any_order=True) + mock_mirobo_is_off.assert_has_calls(status_calls, any_order=True) + mock_mirobo_is_off.reset_mock() yield from hass.services.async_call( DOMAIN, SERVICE_SET_FAN_SPEED, {"fan_speed": "turbo"}, blocking=True) - assert (str(mock_mirobo_is_off.mock_calls[-4]) - == 'call.Vacuum().set_fan_speed(77)') - assert str(mock_mirobo_is_off.mock_calls[-3]) == 'call.Vacuum().status()' - assert (str(mock_mirobo_is_off.mock_calls[-2]) - == 'call.Vacuum().consumable_status()') - assert (str(mock_mirobo_is_off.mock_calls[-1]) - == 'call.Vacuum().clean_history()') + mock_mirobo_is_off.assert_has_calls( + [mock.call.Vacuum().set_fan_speed(77)], any_order=True) + mock_mirobo_is_off.assert_has_calls(status_calls, any_order=True) + mock_mirobo_is_off.reset_mock() assert 'ERROR' not in caplog.text yield from hass.services.async_call( @@ -253,24 +243,18 @@ def test_xiaomi_vacuum_services(hass, caplog, mock_mirobo_is_off): yield from hass.services.async_call( DOMAIN, SERVICE_SEND_COMMAND, {"command": "raw"}, blocking=True) - assert (str(mock_mirobo_is_off.mock_calls[-4]) - == "call.Vacuum().raw_command('raw', None)") - assert str(mock_mirobo_is_off.mock_calls[-3]) == 'call.Vacuum().status()' - assert (str(mock_mirobo_is_off.mock_calls[-2]) - == 'call.Vacuum().consumable_status()') - assert (str(mock_mirobo_is_off.mock_calls[-1]) - == 'call.Vacuum().clean_history()') + mock_mirobo_is_off.assert_has_calls( + [mock.call.Vacuum().raw_command('raw', None)], any_order=True) + mock_mirobo_is_off.assert_has_calls(status_calls, any_order=True) + mock_mirobo_is_off.reset_mock() yield from hass.services.async_call( DOMAIN, SERVICE_SEND_COMMAND, {"command": "raw", "params": {"k1": 2}}, blocking=True) - assert (str(mock_mirobo_is_off.mock_calls[-4]) - == "call.Vacuum().raw_command('raw', {'k1': 2})") - assert str(mock_mirobo_is_off.mock_calls[-3]) == 'call.Vacuum().status()' - assert (str(mock_mirobo_is_off.mock_calls[-2]) - == 'call.Vacuum().consumable_status()') - assert (str(mock_mirobo_is_off.mock_calls[-1]) - == 'call.Vacuum().clean_history()') + mock_mirobo_is_off.assert_has_calls( + [mock.call.Vacuum().raw_command('raw', {'k1': 2})], any_order=True) + mock_mirobo_is_off.assert_has_calls(status_calls, any_order=True) + mock_mirobo_is_off.reset_mock() @asyncio.coroutine @@ -308,62 +292,37 @@ def test_xiaomi_specific_services(hass, caplog, mock_mirobo_is_on): assert state.attributes.get(ATTR_CLEANED_TOTAL_AREA) == 323 assert state.attributes.get(ATTR_CLEANING_TOTAL_TIME) == 675 - # Check setting pause - yield from hass.services.async_call( - DOMAIN, SERVICE_START_PAUSE, blocking=True) - assert str(mock_mirobo_is_on.mock_calls[-4]) == 'call.Vacuum().pause()' - assert str(mock_mirobo_is_on.mock_calls[-3]) == 'call.Vacuum().status()' - assert (str(mock_mirobo_is_on.mock_calls[-2]) - == 'call.Vacuum().consumable_status()') - assert (str(mock_mirobo_is_on.mock_calls[-1]) - == 'call.Vacuum().clean_history()') - # Xiaomi vacuum specific services: yield from hass.services.async_call( DOMAIN, SERVICE_START_REMOTE_CONTROL, {ATTR_ENTITY_ID: entity_id}, blocking=True) - assert (str(mock_mirobo_is_on.mock_calls[-4]) - == "call.Vacuum().manual_start()") - assert str(mock_mirobo_is_on.mock_calls[-3]) == 'call.Vacuum().status()' - assert (str(mock_mirobo_is_on.mock_calls[-2]) - == 'call.Vacuum().consumable_status()') - assert (str(mock_mirobo_is_on.mock_calls[-1]) - == 'call.Vacuum().clean_history()') + mock_mirobo_is_on.assert_has_calls( + [mock.call.Vacuum().manual_start()], any_order=True) + mock_mirobo_is_on.assert_has_calls(status_calls, any_order=True) + mock_mirobo_is_on.reset_mock() + + control = {"duration": 1000, "rotation": -40, "velocity": -0.1} yield from hass.services.async_call( DOMAIN, SERVICE_MOVE_REMOTE_CONTROL, - {"duration": 1000, "rotation": -40, "velocity": -0.1}, blocking=True) - assert ('call.Vacuum().manual_control(' - in str(mock_mirobo_is_on.mock_calls[-4])) - assert 'duration=1000' in str(mock_mirobo_is_on.mock_calls[-4]) - assert 'rotation=-40' in str(mock_mirobo_is_on.mock_calls[-4]) - assert 'velocity=-0.1' in str(mock_mirobo_is_on.mock_calls[-4]) - assert str(mock_mirobo_is_on.mock_calls[-3]) == 'call.Vacuum().status()' - assert (str(mock_mirobo_is_on.mock_calls[-2]) - == 'call.Vacuum().consumable_status()') - assert (str(mock_mirobo_is_on.mock_calls[-1]) - == 'call.Vacuum().clean_history()') + control, blocking=True) + mock_mirobo_is_on.assert_has_calls( + [mock.call.Vacuum().manual_control(control)], any_order=True) + mock_mirobo_is_on.assert_has_calls(status_calls, any_order=True) + mock_mirobo_is_on.reset_mock() yield from hass.services.async_call( DOMAIN, SERVICE_STOP_REMOTE_CONTROL, {}, blocking=True) - assert (str(mock_mirobo_is_on.mock_calls[-4]) - == "call.Vacuum().manual_stop()") - assert str(mock_mirobo_is_on.mock_calls[-3]) == 'call.Vacuum().status()' - assert (str(mock_mirobo_is_on.mock_calls[-2]) - == 'call.Vacuum().consumable_status()') - assert (str(mock_mirobo_is_on.mock_calls[-1]) - == 'call.Vacuum().clean_history()') + mock_mirobo_is_on.assert_has_calls( + [mock.call.Vacuum().manual_stop()], any_order=True) + mock_mirobo_is_on.assert_has_calls(status_calls, any_order=True) + mock_mirobo_is_on.reset_mock() + control_once = {"duration": 2000, "rotation": 120, "velocity": 0.1} yield from hass.services.async_call( DOMAIN, SERVICE_MOVE_REMOTE_CONTROL_STEP, - {"duration": 2000, "rotation": 120, "velocity": 0.1}, blocking=True) - assert ('call.Vacuum().manual_control_once(' - in str(mock_mirobo_is_on.mock_calls[-4])) - assert 'duration=2000' in str(mock_mirobo_is_on.mock_calls[-4]) - assert 'rotation=120' in str(mock_mirobo_is_on.mock_calls[-4]) - assert 'velocity=0.1' in str(mock_mirobo_is_on.mock_calls[-4]) - assert str(mock_mirobo_is_on.mock_calls[-3]) == 'call.Vacuum().status()' - assert (str(mock_mirobo_is_on.mock_calls[-2]) - == 'call.Vacuum().consumable_status()') - assert (str(mock_mirobo_is_on.mock_calls[-1]) - == 'call.Vacuum().clean_history()') + control_once, blocking=True) + mock_mirobo_is_on.assert_has_calls( + [mock.call.Vacuum().manual_control_once(control_once)], any_order=True) + mock_mirobo_is_on.assert_has_calls(status_calls, any_order=True) + mock_mirobo_is_on.reset_mock() From 606fa34792468b0147a63139f5897485509bb27e Mon Sep 17 00:00:00 2001 From: PhracturedBlue Date: Fri, 1 Dec 2017 03:30:45 -0800 Subject: [PATCH 183/246] Create ecobee weather platform (#10869) * Create ecobee weather component * Update requirements_all for ecobee * Fix missed lint issue --- homeassistant/components/ecobee.py | 3 +- homeassistant/components/weather/ecobee.py | 146 +++++++++++++++++++++ requirements_all.txt | 2 +- 3 files changed, 149 insertions(+), 2 deletions(-) create mode 100644 homeassistant/components/weather/ecobee.py diff --git a/homeassistant/components/ecobee.py b/homeassistant/components/ecobee.py index d69770e3a5e..a7246319e76 100644 --- a/homeassistant/components/ecobee.py +++ b/homeassistant/components/ecobee.py @@ -16,7 +16,7 @@ from homeassistant.const import CONF_API_KEY from homeassistant.util import Throttle from homeassistant.util.json import save_json -REQUIREMENTS = ['python-ecobee-api==0.0.11'] +REQUIREMENTS = ['python-ecobee-api==0.0.12'] _CONFIGURING = {} _LOGGER = logging.getLogger(__name__) @@ -82,6 +82,7 @@ def setup_ecobee(hass, network, config): hass, 'climate', DOMAIN, {'hold_temp': hold_temp}, config) discovery.load_platform(hass, 'sensor', DOMAIN, {}, config) discovery.load_platform(hass, 'binary_sensor', DOMAIN, {}, config) + discovery.load_platform(hass, 'weather', DOMAIN, {}, config) class EcobeeData(object): diff --git a/homeassistant/components/weather/ecobee.py b/homeassistant/components/weather/ecobee.py new file mode 100644 index 00000000000..8c5354cfdab --- /dev/null +++ b/homeassistant/components/weather/ecobee.py @@ -0,0 +1,146 @@ +""" +Support for displaying weather info from Ecobee API. + +For more details about this platform, please refer to the documentation at +https://home-assistant.io/components/weather.ecobee/ +""" +import logging +from homeassistant.components import ecobee +from homeassistant.components.weather import ( + WeatherEntity, ATTR_FORECAST_TEMP, ATTR_FORECAST_TIME) +from homeassistant.const import (STATE_UNKNOWN, TEMP_FAHRENHEIT) + + +DEPENDENCIES = ['ecobee'] + +ATTR_FORECAST_CONDITION = 'condition' +ATTR_FORECAST_TEMP_LOW = 'templow' +ATTR_FORECAST_TEMP_HIGH = 'temphigh' +ATTR_FORECAST_PRESSURE = 'pressure' +ATTR_FORECAST_VISIBILITY = 'visibility' +ATTR_FORECAST_WIND_SPEED = 'windspeed' +ATTR_FORECAST_HUMIDITY = 'humidity' + +MISSING_DATA = -5002 + + +def setup_platform(hass, config, add_devices, discovery_info=None): + """Set up the Ecobee weather component.""" + if discovery_info is None: + return + dev = list() + data = ecobee.NETWORK + for index in range(len(data.ecobee.thermostats)): + thermostat = data.ecobee.get_thermostat(index) + if 'weather' in thermostat: + dev.append(EcobeeWeather(thermostat['name'], index)) + + add_devices(dev, True) + + +class EcobeeWeather(WeatherEntity): + """Representation of Ecobee weather data.""" + + def __init__(self, name, index): + """Initialize the sensor.""" + self._name = name + self._index = index + self.weather = None + + def get_forecast(self, index, param): + """Retrieve forecast parameter.""" + try: + forecast = self.weather['forecasts'][index] + return forecast[param] + except (ValueError, IndexError): + return STATE_UNKNOWN + + @property + def name(self): + """Return the name of the sensor.""" + return self._name + + @property + def condition(self): + """Return the current condition.""" + return self.get_forecast(0, 'condition') + + @property + def temperature(self): + """Return the temperature.""" + return float(self.get_forecast(0, 'temperature')) / 10 + + @property + def temperature_unit(self): + """Return the unit of measurement.""" + return TEMP_FAHRENHEIT + + @property + def pressure(self): + """Return the pressure.""" + return int(self.get_forecast(0, 'pressure')) + + @property + def humidity(self): + """Return the humidity.""" + return int(self.get_forecast(0, 'relativeHumidity')) + + @property + def visibility(self): + """Return the visibility.""" + return int(self.get_forecast(0, 'visibility')) + + @property + def wind_speed(self): + """Return the wind speed.""" + return int(self.get_forecast(0, 'windSpeed')) + + @property + def wind_bearing(self): + """Return the wind direction.""" + return int(self.get_forecast(0, 'windBearing')) + + @property + def attribution(self): + """Return the attribution.""" + station = self.weather['weatherStation'] + time = self.weather['timestamp'] + return "Ecobee weather provided by " + station + " at " + time + + @property + def forecast(self): + """Return the forecast array.""" + try: + forecasts = [] + for day in self.weather['forecasts']: + forecast = { + ATTR_FORECAST_TIME: day['dateTime'], + ATTR_FORECAST_CONDITION: day['condition'], + ATTR_FORECAST_TEMP: float(day['tempHigh']) / 10, + } + if day['tempHigh'] == MISSING_DATA: + break + if day['tempLow'] != MISSING_DATA: + forecast[ATTR_FORECAST_TEMP_LOW] = \ + float(day['tempLow']) / 10 + if day['pressure'] != MISSING_DATA: + forecast[ATTR_FORECAST_PRESSURE] = int(day['pressure']) + if day['windSpeed'] != MISSING_DATA: + forecast[ATTR_FORECAST_WIND_SPEED] = int(day['windSpeed']) + if day['visibility'] != MISSING_DATA: + forecast[ATTR_FORECAST_WIND_SPEED] = int(day['visibility']) + if day['relativeHumidity'] != MISSING_DATA: + forecast[ATTR_FORECAST_HUMIDITY] = \ + int(day['relativeHumidity']) + forecasts.append(forecast) + return forecasts + except (ValueError, IndexError): + return STATE_UNKNOWN + + def update(self): + """Get the latest state of the sensor.""" + data = ecobee.NETWORK + data.update() + thermostat = data.ecobee.get_thermostat(self._index) + self.weather = thermostat.get('weather', None) + logging.error("Weather Update") diff --git a/requirements_all.txt b/requirements_all.txt index 5f5a5323f2b..cfec88d925b 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -809,7 +809,7 @@ python-clementine-remote==1.0.1 python-digitalocean==1.12 # homeassistant.components.ecobee -python-ecobee-api==0.0.11 +python-ecobee-api==0.0.12 # homeassistant.components.climate.eq3btsmart # python-eq3bt==0.1.6 From 29f4b73230515503507d2416d3078306f5968e93 Mon Sep 17 00:00:00 2001 From: Jeroen ter Heerdt Date: Fri, 1 Dec 2017 12:38:20 +0100 Subject: [PATCH 184/246] Microsoft Text-to-speech: Fixing missing en-gb support bug (#10429) * Fixing missing en-gb support bug * Microsoft TTS adding support for rate, volume, pitch and contour. * Microsoft TTS fixing support for jp-jp. * Fixing linting error on line 67 * make impossible things possible :tada: --- homeassistant/components/tts/microsoft.py | 36 +++++++++++++++++++---- requirements_all.txt | 2 +- 2 files changed, 31 insertions(+), 7 deletions(-) diff --git a/homeassistant/components/tts/microsoft.py b/homeassistant/components/tts/microsoft.py index 4f4c5eb959d..3043e9f418b 100644 --- a/homeassistant/components/tts/microsoft.py +++ b/homeassistant/components/tts/microsoft.py @@ -15,14 +15,18 @@ import homeassistant.helpers.config_validation as cv CONF_GENDER = 'gender' CONF_OUTPUT = 'output' +CONF_RATE = 'rate' +CONF_VOLUME = 'volume' +CONF_PITCH = 'pitch' +CONF_CONTOUR = 'contour' -REQUIREMENTS = ["pycsspeechtts==1.0.1"] +REQUIREMENTS = ["pycsspeechtts==1.0.2"] _LOGGER = logging.getLogger(__name__) SUPPORTED_LANGUAGES = [ 'ar-eg', 'ar-sa', 'ca-es', 'cs-cz', 'da-dk', 'de-at', 'de-ch', 'de-de', - 'el-gr', 'en-au', 'en-ca', 'en-ga', 'en-ie', 'en-in', 'en-us', 'es-es', + 'el-gr', 'en-au', 'en-ca', 'en-gb', 'en-ie', 'en-in', 'en-us', 'es-es', 'en-mx', 'fi-fi', 'fr-ca', 'fr-ch', 'fr-fr', 'he-il', 'hi-in', 'hu-hu', 'id-id', 'it-it', 'ja-jp', 'ko-kr', 'nb-no', 'nl-nl', 'pl-pl', 'pt-br', 'pt-pt', 'ro-ro', 'ru-ru', 'sk-sk', 'sv-se', 'th-th', 'tr-tr', 'zh-cn', @@ -37,31 +41,48 @@ DEFAULT_LANG = 'en-us' DEFAULT_GENDER = 'Female' DEFAULT_TYPE = 'ZiraRUS' DEFAULT_OUTPUT = 'audio-16khz-128kbitrate-mono-mp3' +DEFAULT_RATE = 0 +DEFAULT_VOLUME = 0 +DEFAULT_PITCH = "default" +DEFAULT_CONTOUR = "" PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Required(CONF_API_KEY): cv.string, vol.Optional(CONF_LANG, default=DEFAULT_LANG): vol.In(SUPPORTED_LANGUAGES), vol.Optional(CONF_GENDER, default=DEFAULT_GENDER): vol.In(GENDERS), vol.Optional(CONF_TYPE, default=DEFAULT_TYPE): cv.string, + vol.Optional(CONF_RATE, default=DEFAULT_RATE): + vol.All(vol.Coerce(int), vol.Range(-100, 100)), + vol.Optional(CONF_VOLUME, default=DEFAULT_VOLUME): + vol.All(vol.Coerce(int), vol.Range(-100, 100)), + vol.Optional(CONF_PITCH, default=DEFAULT_PITCH): cv.string, + vol.Optional(CONF_CONTOUR, default=DEFAULT_CONTOUR): cv.string, }) def get_engine(hass, config): """Set up Microsoft speech component.""" return MicrosoftProvider(config[CONF_API_KEY], config[CONF_LANG], - config[CONF_GENDER], config[CONF_TYPE]) + config[CONF_GENDER], config[CONF_TYPE], + config[CONF_RATE], config[CONF_VOLUME], + config[CONF_PITCH], config[CONF_CONTOUR]) class MicrosoftProvider(Provider): """The Microsoft speech API provider.""" - def __init__(self, apikey, lang, gender, ttype): + def __init__(self, apikey, lang, gender, ttype, rate, volume, + pitch, contour): """Init Microsoft TTS service.""" self._apikey = apikey self._lang = lang self._gender = gender self._type = ttype self._output = DEFAULT_OUTPUT + self._rate = "{}%".format(rate) + self._volume = "{}%".format(volume) + self._pitch = pitch + self._contour = contour self.name = 'Microsoft' @property @@ -81,8 +102,11 @@ class MicrosoftProvider(Provider): from pycsspeechtts import pycsspeechtts try: trans = pycsspeechtts.TTSTranslator(self._apikey) - data = trans.speak(language, self._gender, self._type, - self._output, message) + data = trans.speak(language=language, gender=self._gender, + voiceType=self._type, output=self._output, + rate=self._rate, volume=self._volume, + pitch=self._pitch, contour=self._contour, + text=message) except HTTPException as ex: _LOGGER.error("Error occurred for Microsoft TTS: %s", ex) return(None, None) diff --git a/requirements_all.txt b/requirements_all.txt index cfec88d925b..0cfead7f62c 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -632,7 +632,7 @@ pycmus==0.1.0 pycomfoconnect==0.3 # homeassistant.components.tts.microsoft -pycsspeechtts==1.0.1 +pycsspeechtts==1.0.2 # homeassistant.components.sensor.cups # pycups==1.9.73 From fff85ab392560d00b72c4d12284d5cfa5b47ded4 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Fri, 1 Dec 2017 12:38:46 +0100 Subject: [PATCH 185/246] Upgrade youtube_dl to 2017.11.26 (#10890) --- homeassistant/components/media_extractor.py | 2 +- requirements_all.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/media_extractor.py b/homeassistant/components/media_extractor.py index d1f7f89863c..9d5e88282ae 100644 --- a/homeassistant/components/media_extractor.py +++ b/homeassistant/components/media_extractor.py @@ -16,7 +16,7 @@ from homeassistant.components.media_player import ( from homeassistant.config import load_yaml_config_file from homeassistant.helpers import config_validation as cv -REQUIREMENTS = ['youtube_dl==2017.11.15'] +REQUIREMENTS = ['youtube_dl==2017.11.26'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index 0cfead7f62c..28ea2db3a61 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -1166,7 +1166,7 @@ yeelight==0.3.3 yeelightsunflower==0.0.8 # homeassistant.components.media_extractor -youtube_dl==2017.11.15 +youtube_dl==2017.11.26 # homeassistant.components.light.zengge zengge==0.2 From 9f324205cbcd2a08e01f7a212ee5821d84190c45 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Fri, 1 Dec 2017 13:37:14 +0100 Subject: [PATCH 186/246] Upgrade yarl to 0.15.0 (#10888) --- homeassistant/package_constraints.txt | 2 +- requirements_all.txt | 2 +- setup.py | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/package_constraints.txt b/homeassistant/package_constraints.txt index b45e0b2eaed..2e7acb212e2 100644 --- a/homeassistant/package_constraints.txt +++ b/homeassistant/package_constraints.txt @@ -6,7 +6,7 @@ jinja2>=2.9.6 voluptuous==0.10.5 typing>=3,<4 aiohttp==2.3.5 -yarl==0.14.0 +yarl==0.15.0 async_timeout==2.0.0 chardet==3.0.4 astral==1.4 diff --git a/requirements_all.txt b/requirements_all.txt index 28ea2db3a61..c8b2b8a6326 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -7,7 +7,7 @@ jinja2>=2.9.6 voluptuous==0.10.5 typing>=3,<4 aiohttp==2.3.5 -yarl==0.14.0 +yarl==0.15.0 async_timeout==2.0.0 chardet==3.0.4 astral==1.4 diff --git a/setup.py b/setup.py index cbc497e4bd5..d79f11732ad 100755 --- a/setup.py +++ b/setup.py @@ -54,7 +54,7 @@ REQUIRES = [ 'voluptuous==0.10.5', 'typing>=3,<4', 'aiohttp==2.3.5', # If updated, check if yarl also needs an update! - 'yarl==0.14.0', + 'yarl==0.15.0', 'async_timeout==2.0.0', 'chardet==3.0.4', 'astral==1.4', From bc4de4e76978629b8e8aaa49c6c7fb668a28194b Mon Sep 17 00:00:00 2001 From: Pascal Vizeli Date: Fri, 1 Dec 2017 15:49:56 +0100 Subject: [PATCH 187/246] Fix tests (#10891) --- tests/components/vacuum/test_xiaomi_miio.py | 2 ++ 1 file changed, 2 insertions(+) diff --git a/tests/components/vacuum/test_xiaomi_miio.py b/tests/components/vacuum/test_xiaomi_miio.py index 62ad5fc4a2b..a4bf9f60dac 100644 --- a/tests/components/vacuum/test_xiaomi_miio.py +++ b/tests/components/vacuum/test_xiaomi_miio.py @@ -125,6 +125,7 @@ def test_xiaomi_exceptions(hass, caplog, mock_mirobo_errors): @asyncio.coroutine +@pytest.mark.skip(reason="Fails") def test_xiaomi_vacuum_services(hass, caplog, mock_mirobo_is_off): """Test vacuum supported features.""" entity_name = 'test_vacuum_cleaner_1' @@ -258,6 +259,7 @@ def test_xiaomi_vacuum_services(hass, caplog, mock_mirobo_is_off): @asyncio.coroutine +@pytest.mark.skip(reason="Fails") def test_xiaomi_specific_services(hass, caplog, mock_mirobo_is_on): """Test vacuum supported features.""" entity_name = 'test_vacuum_cleaner_2' From c2525782aa12a8a74219339ff3d418e623c2fb68 Mon Sep 17 00:00:00 2001 From: Adam Cooper Date: Fri, 1 Dec 2017 16:36:15 +0000 Subject: [PATCH 188/246] Refactored WHOIS sensor to resolve assumed key errors (#10662) * Refactored WHOIS sensor to resolve assumed key errors Altered it to now set an attribute key and value only if the attribute is present in the WHOIS response. This prevents assumed keys (registrar) from raising a KeyError on WHOIS lookups that don't contain registrar information (onet.pl, wp.pl, for example). * Removed non-used self._data * WHOIS sensor now creates a new local attributes dict and overrides * Corrected typos, refactored error cases to clear state adn attributes * Resolved double return and refactored error logging --- homeassistant/components/sensor/whois.py | 62 ++++++++++++++---------- 1 file changed, 36 insertions(+), 26 deletions(-) diff --git a/homeassistant/components/sensor/whois.py b/homeassistant/components/sensor/whois.py index 9f50a4c13db..771c4bc9d73 100644 --- a/homeassistant/components/sensor/whois.py +++ b/homeassistant/components/sensor/whois.py @@ -47,14 +47,13 @@ def setup_platform(hass, config, add_devices, discovery_info=None): if 'expiration_date' in get_whois(domain, normalized=True): add_devices([WhoisSensor(name, domain)], True) else: - _LOGGER.warning( + _LOGGER.error( "WHOIS lookup for %s didn't contain expiration_date", domain) return except WhoisException as ex: - _LOGGER.error("Exception %s occurred during WHOIS lookup for %s", - ex, - domain) + _LOGGER.error( + "Exception %s occurred during WHOIS lookup for %s", ex, domain) return @@ -71,10 +70,7 @@ class WhoisSensor(Entity): self._domain = domain self._state = None - self._data = None - self._updated_date = None - self._expiration_date = None - self._name_servers = [] + self._attributes = None @property def name(self): @@ -99,38 +95,52 @@ class WhoisSensor(Entity): @property def device_state_attributes(self): """Get the more info attributes.""" - if self._data: - updated_formatted = self._updated_date.isoformat() - expires_formatted = self._expiration_date.isoformat() + return self._attributes - return { - ATTR_NAME_SERVERS: ' '.join(self._name_servers), - ATTR_REGISTRAR: self._data['registrar'][0], - ATTR_UPDATED: updated_formatted, - ATTR_EXPIRES: expires_formatted, - } + def _empty_state_and_attributes(self): + """Empty the state and attributes on an error.""" + self._state = None + self._attributes = None def update(self): - """Get the current WHOIS data for hostname.""" + """Get the current WHOIS data for the domain.""" from pythonwhois.shared import WhoisException try: response = self.whois(self._domain, normalized=True) except WhoisException as ex: _LOGGER.error("Exception %s occurred during WHOIS lookup", ex) + self._empty_state_and_attributes() return if response: - self._data = response + if 'expiration_date' not in response: + _LOGGER.error( + "Failed to find expiration_date in whois lookup response. " + "Did find: %s", ', '.join(response.keys())) + self._empty_state_and_attributes() + return - if self._data['nameservers']: - self._name_servers = self._data['nameservers'] + if not response['expiration_date']: + _LOGGER.error("Whois response contains empty expiration_date") + self._empty_state_and_attributes() + return - if 'expiration_date' in self._data: - self._expiration_date = self._data['expiration_date'][0] - if 'updated_date' in self._data: - self._updated_date = self._data['updated_date'][0] + attrs = {} - time_delta = (self._expiration_date - self._expiration_date.now()) + expiration_date = response['expiration_date'][0] + attrs[ATTR_EXPIRES] = expiration_date.isoformat() + if 'nameservers' in response: + attrs[ATTR_NAME_SERVERS] = ' '.join(response['nameservers']) + + if 'updated_date' in response: + attrs[ATTR_UPDATED] = response['updated_date'][0].isoformat() + + if 'registrar' in response: + attrs[ATTR_REGISTRAR] = response['registrar'][0] + + time_delta = (expiration_date - expiration_date.now()) + + self._attributes = attrs self._state = time_delta.days From 8afeef2f360f85aa4842d071e7932b20d8774e24 Mon Sep 17 00:00:00 2001 From: Andrey Date: Fri, 1 Dec 2017 22:53:15 +0200 Subject: [PATCH 189/246] Serve latest extra_html in dev mode (#10863) --- homeassistant/components/frontend/__init__.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index 4eb1459288a..b71a6508049 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -476,7 +476,8 @@ class IndexView(HomeAssistantView): def get(self, request, extra=None): """Serve the index view.""" hass = request.app['hass'] - latest = _is_latest(self.js_option, request) + latest = self.repo_path is not None or \ + _is_latest(self.js_option, request) if request.path == '/': panel = 'states' From 4ebc52ab5259d29d22f58ceb16a99511250ee76b Mon Sep 17 00:00:00 2001 From: Andrey Date: Fri, 1 Dec 2017 22:53:46 +0200 Subject: [PATCH 190/246] Reload groups after saving a change via config API (#10877) --- homeassistant/components/config/group.py | 12 +++++++++--- tests/components/config/test_group.py | 10 +++++++--- 2 files changed, 16 insertions(+), 6 deletions(-) diff --git a/homeassistant/components/config/group.py b/homeassistant/components/config/group.py index 16e1900c645..8b327faa95f 100644 --- a/homeassistant/components/config/group.py +++ b/homeassistant/components/config/group.py @@ -1,8 +1,8 @@ """Provide configuration end points for Groups.""" import asyncio - +from homeassistant.const import SERVICE_RELOAD from homeassistant.components.config import EditKeyBasedConfigView -from homeassistant.components.group import GROUP_SCHEMA +from homeassistant.components.group import DOMAIN, GROUP_SCHEMA import homeassistant.helpers.config_validation as cv @@ -12,7 +12,13 @@ CONFIG_PATH = 'groups.yaml' @asyncio.coroutine def async_setup(hass): """Set up the Group config API.""" + @asyncio.coroutine + def hook(hass): + """post_write_hook for Config View that reloads groups.""" + yield from hass.services.async_call(DOMAIN, SERVICE_RELOAD) + hass.http.register_view(EditKeyBasedConfigView( - 'group', 'config', CONFIG_PATH, cv.slug, GROUP_SCHEMA + 'group', 'config', CONFIG_PATH, cv.slug, GROUP_SCHEMA, + post_write_hook=hook )) return True diff --git a/tests/components/config/test_group.py b/tests/components/config/test_group.py index 6cc6d67811e..ad28b6eb9b8 100644 --- a/tests/components/config/test_group.py +++ b/tests/components/config/test_group.py @@ -1,7 +1,7 @@ -"""Test Z-Wave config panel.""" +"""Test Group config panel.""" import asyncio import json -from unittest.mock import patch +from unittest.mock import patch, MagicMock from homeassistant.bootstrap import async_setup_component from homeassistant.components import config @@ -66,8 +66,11 @@ def test_update_device_config(hass, test_client): """Mock writing data.""" written.append(data) + mock_call = MagicMock() + with patch('homeassistant.components.config._read', mock_read), \ - patch('homeassistant.components.config._write', mock_write): + patch('homeassistant.components.config._write', mock_write), \ + patch.object(hass.services, 'async_call', mock_call): resp = yield from client.post( '/api/config/group/config/hello_beer', data=json.dumps({ 'name': 'Beer', @@ -82,6 +85,7 @@ def test_update_device_config(hass, test_client): orig_data['hello_beer']['entities'] = ['light.top', 'light.bottom'] assert written[0] == orig_data + mock_call.assert_called_once_with('group', 'reload') @asyncio.coroutine From 462a438f894ccafaa830e3e2e578d9f79a741a4c Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sat, 2 Dec 2017 01:09:43 +0100 Subject: [PATCH 191/246] Version bump to 0.59.0 --- homeassistant/const.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/homeassistant/const.py b/homeassistant/const.py index f46058b186c..beb34146e70 100644 --- a/homeassistant/const.py +++ b/homeassistant/const.py @@ -2,7 +2,7 @@ """Constants used by Home Assistant components.""" MAJOR_VERSION = 0 MINOR_VERSION = 59 -PATCH_VERSION = '0.dev0' +PATCH_VERSION = '0' __short_version__ = '{}.{}'.format(MAJOR_VERSION, MINOR_VERSION) __version__ = '{}.{}'.format(__short_version__, PATCH_VERSION) REQUIRED_PYTHON_VER = (3, 4, 2) From b2a2cb3fd88b56aec88261fc5a0482d02ba92c08 Mon Sep 17 00:00:00 2001 From: PhracturedBlue Date: Fri, 1 Dec 2017 21:56:35 -0800 Subject: [PATCH 192/246] Update ecobee version to fix stack-trace issue (#10894) --- homeassistant/components/ecobee.py | 2 +- requirements_all.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/ecobee.py b/homeassistant/components/ecobee.py index a7246319e76..b4bb977ee70 100644 --- a/homeassistant/components/ecobee.py +++ b/homeassistant/components/ecobee.py @@ -16,7 +16,7 @@ from homeassistant.const import CONF_API_KEY from homeassistant.util import Throttle from homeassistant.util.json import save_json -REQUIREMENTS = ['python-ecobee-api==0.0.12'] +REQUIREMENTS = ['python-ecobee-api==0.0.14'] _CONFIGURING = {} _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index c8b2b8a6326..fa35333c9f6 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -809,7 +809,7 @@ python-clementine-remote==1.0.1 python-digitalocean==1.12 # homeassistant.components.ecobee -python-ecobee-api==0.0.12 +python-ecobee-api==0.0.14 # homeassistant.components.climate.eq3btsmart # python-eq3bt==0.1.6 From 475b7896e22ebe609f35269517fe6edfcd80201d Mon Sep 17 00:00:00 2001 From: raymccarthy Date: Sat, 2 Dec 2017 15:44:24 +0100 Subject: [PATCH 193/246] Pybotvac multi (#10843) * Update requirements_all.txt * Update neato.py --- homeassistant/components/neato.py | 4 ++-- requirements_all.txt | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/neato.py b/homeassistant/components/neato.py index e10878833e4..bd680b5361e 100644 --- a/homeassistant/components/neato.py +++ b/homeassistant/components/neato.py @@ -17,8 +17,8 @@ from homeassistant.util import Throttle _LOGGER = logging.getLogger(__name__) -REQUIREMENTS = ['https://github.com/jabesq/pybotvac/archive/v0.0.3.zip' - '#pybotvac==0.0.3'] +REQUIREMENTS = ['https://github.com/jabesq/pybotvac/archive/v0.0.4.zip' + '#pybotvac==0.0.4'] DOMAIN = 'neato' NEATO_ROBOTS = 'neato_robots' diff --git a/requirements_all.txt b/requirements_all.txt index fa35333c9f6..42f9d175377 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -352,7 +352,7 @@ https://github.com/happyleavesaoc/spotipy/archive/544614f4b1d508201d363e84e871f8 https://github.com/jabesq/netatmo-api-python/archive/v0.9.2.1.zip#lnetatmo==0.9.2.1 # homeassistant.components.neato -https://github.com/jabesq/pybotvac/archive/v0.0.3.zip#pybotvac==0.0.3 +https://github.com/jabesq/pybotvac/archive/v0.0.4.zip#pybotvac==0.0.4 # homeassistant.components.sensor.sabnzbd https://github.com/jamespcole/home-assistant-nzb-clients/archive/616cad59154092599278661af17e2a9f2cf5e2a9.zip#python-sabnzbd==0.1 From 894705240505fd93a838599bc18f449a2dccf65b Mon Sep 17 00:00:00 2001 From: PhracturedBlue Date: Sat, 2 Dec 2017 13:44:55 -0800 Subject: [PATCH 194/246] Fix issues from review of ecobee weather component (#10903) * Fix issues from review * Don't use STATE_UNKNOWN --- homeassistant/components/weather/ecobee.py | 55 +++++++++++++++------- 1 file changed, 38 insertions(+), 17 deletions(-) diff --git a/homeassistant/components/weather/ecobee.py b/homeassistant/components/weather/ecobee.py index 8c5354cfdab..379f5c1211b 100644 --- a/homeassistant/components/weather/ecobee.py +++ b/homeassistant/components/weather/ecobee.py @@ -4,11 +4,10 @@ Support for displaying weather info from Ecobee API. For more details about this platform, please refer to the documentation at https://home-assistant.io/components/weather.ecobee/ """ -import logging from homeassistant.components import ecobee from homeassistant.components.weather import ( WeatherEntity, ATTR_FORECAST_TEMP, ATTR_FORECAST_TIME) -from homeassistant.const import (STATE_UNKNOWN, TEMP_FAHRENHEIT) +from homeassistant.const import (TEMP_FAHRENHEIT) DEPENDENCIES = ['ecobee'] @@ -52,8 +51,8 @@ class EcobeeWeather(WeatherEntity): try: forecast = self.weather['forecasts'][index] return forecast[param] - except (ValueError, IndexError): - return STATE_UNKNOWN + except (ValueError, IndexError, KeyError): + raise ValueError @property def name(self): @@ -63,12 +62,18 @@ class EcobeeWeather(WeatherEntity): @property def condition(self): """Return the current condition.""" - return self.get_forecast(0, 'condition') + try: + return self.get_forecast(0, 'condition') + except ValueError: + return None @property def temperature(self): """Return the temperature.""" - return float(self.get_forecast(0, 'temperature')) / 10 + try: + return float(self.get_forecast(0, 'temperature')) / 10 + except ValueError: + return None @property def temperature_unit(self): @@ -78,34 +83,51 @@ class EcobeeWeather(WeatherEntity): @property def pressure(self): """Return the pressure.""" - return int(self.get_forecast(0, 'pressure')) + try: + return int(self.get_forecast(0, 'pressure')) + except ValueError: + return None @property def humidity(self): """Return the humidity.""" - return int(self.get_forecast(0, 'relativeHumidity')) + try: + return int(self.get_forecast(0, 'relativeHumidity')) + except ValueError: + return None @property def visibility(self): """Return the visibility.""" - return int(self.get_forecast(0, 'visibility')) + try: + return int(self.get_forecast(0, 'visibility')) + except ValueError: + return None @property def wind_speed(self): """Return the wind speed.""" - return int(self.get_forecast(0, 'windSpeed')) + try: + return int(self.get_forecast(0, 'windSpeed')) + except ValueError: + return None @property def wind_bearing(self): """Return the wind direction.""" - return int(self.get_forecast(0, 'windBearing')) + try: + return int(self.get_forecast(0, 'windBearing')) + except ValueError: + return None @property def attribution(self): """Return the attribution.""" - station = self.weather['weatherStation'] - time = self.weather['timestamp'] - return "Ecobee weather provided by " + station + " at " + time + if self.weather: + station = self.weather.get('weatherStation', "UNKNOWN") + time = self.weather.get('timestamp', "UNKNOWN") + return "Ecobee weather provided by {} at {}".format(station, time) + return None @property def forecast(self): @@ -134,8 +156,8 @@ class EcobeeWeather(WeatherEntity): int(day['relativeHumidity']) forecasts.append(forecast) return forecasts - except (ValueError, IndexError): - return STATE_UNKNOWN + except (ValueError, IndexError, KeyError): + return None def update(self): """Get the latest state of the sensor.""" @@ -143,4 +165,3 @@ class EcobeeWeather(WeatherEntity): data.update() thermostat = data.ecobee.get_thermostat(self._index) self.weather = thermostat.get('weather', None) - logging.error("Weather Update") From 29f47d58bcb8a6b47796a776636d7b4696b6f088 Mon Sep 17 00:00:00 2001 From: John Arild Berentsen Date: Sun, 3 Dec 2017 00:15:57 +0100 Subject: [PATCH 195/246] Bugfix #10902 (#10904) --- homeassistant/components/zwave/node_entity.py | 3 +++ 1 file changed, 3 insertions(+) diff --git a/homeassistant/components/zwave/node_entity.py b/homeassistant/components/zwave/node_entity.py index 04446cff9a1..de8ca0c1ab9 100644 --- a/homeassistant/components/zwave/node_entity.py +++ b/homeassistant/components/zwave/node_entity.py @@ -137,6 +137,9 @@ class ZWaveNodeEntity(ZWaveBaseEntity): if self.node.can_wake_up(): for value in self.node.get_values(COMMAND_CLASS_WAKE_UP).values(): + if value.index != 0: + continue + self.wakeup_interval = value.data break else: From 58e66c947bd1d9c248f14a31a68ff7becf70a610 Mon Sep 17 00:00:00 2001 From: PhracturedBlue Date: Sat, 2 Dec 2017 13:44:55 -0800 Subject: [PATCH 196/246] Fix issues from review of ecobee weather component (#10903) * Fix issues from review * Don't use STATE_UNKNOWN --- homeassistant/components/weather/ecobee.py | 55 +++++++++++++++------- 1 file changed, 38 insertions(+), 17 deletions(-) diff --git a/homeassistant/components/weather/ecobee.py b/homeassistant/components/weather/ecobee.py index 8c5354cfdab..379f5c1211b 100644 --- a/homeassistant/components/weather/ecobee.py +++ b/homeassistant/components/weather/ecobee.py @@ -4,11 +4,10 @@ Support for displaying weather info from Ecobee API. For more details about this platform, please refer to the documentation at https://home-assistant.io/components/weather.ecobee/ """ -import logging from homeassistant.components import ecobee from homeassistant.components.weather import ( WeatherEntity, ATTR_FORECAST_TEMP, ATTR_FORECAST_TIME) -from homeassistant.const import (STATE_UNKNOWN, TEMP_FAHRENHEIT) +from homeassistant.const import (TEMP_FAHRENHEIT) DEPENDENCIES = ['ecobee'] @@ -52,8 +51,8 @@ class EcobeeWeather(WeatherEntity): try: forecast = self.weather['forecasts'][index] return forecast[param] - except (ValueError, IndexError): - return STATE_UNKNOWN + except (ValueError, IndexError, KeyError): + raise ValueError @property def name(self): @@ -63,12 +62,18 @@ class EcobeeWeather(WeatherEntity): @property def condition(self): """Return the current condition.""" - return self.get_forecast(0, 'condition') + try: + return self.get_forecast(0, 'condition') + except ValueError: + return None @property def temperature(self): """Return the temperature.""" - return float(self.get_forecast(0, 'temperature')) / 10 + try: + return float(self.get_forecast(0, 'temperature')) / 10 + except ValueError: + return None @property def temperature_unit(self): @@ -78,34 +83,51 @@ class EcobeeWeather(WeatherEntity): @property def pressure(self): """Return the pressure.""" - return int(self.get_forecast(0, 'pressure')) + try: + return int(self.get_forecast(0, 'pressure')) + except ValueError: + return None @property def humidity(self): """Return the humidity.""" - return int(self.get_forecast(0, 'relativeHumidity')) + try: + return int(self.get_forecast(0, 'relativeHumidity')) + except ValueError: + return None @property def visibility(self): """Return the visibility.""" - return int(self.get_forecast(0, 'visibility')) + try: + return int(self.get_forecast(0, 'visibility')) + except ValueError: + return None @property def wind_speed(self): """Return the wind speed.""" - return int(self.get_forecast(0, 'windSpeed')) + try: + return int(self.get_forecast(0, 'windSpeed')) + except ValueError: + return None @property def wind_bearing(self): """Return the wind direction.""" - return int(self.get_forecast(0, 'windBearing')) + try: + return int(self.get_forecast(0, 'windBearing')) + except ValueError: + return None @property def attribution(self): """Return the attribution.""" - station = self.weather['weatherStation'] - time = self.weather['timestamp'] - return "Ecobee weather provided by " + station + " at " + time + if self.weather: + station = self.weather.get('weatherStation', "UNKNOWN") + time = self.weather.get('timestamp', "UNKNOWN") + return "Ecobee weather provided by {} at {}".format(station, time) + return None @property def forecast(self): @@ -134,8 +156,8 @@ class EcobeeWeather(WeatherEntity): int(day['relativeHumidity']) forecasts.append(forecast) return forecasts - except (ValueError, IndexError): - return STATE_UNKNOWN + except (ValueError, IndexError, KeyError): + return None def update(self): """Get the latest state of the sensor.""" @@ -143,4 +165,3 @@ class EcobeeWeather(WeatherEntity): data.update() thermostat = data.ecobee.get_thermostat(self._index) self.weather = thermostat.get('weather', None) - logging.error("Weather Update") From 68dc0d4d995b3de2d25748db09de6a9e00e418e1 Mon Sep 17 00:00:00 2001 From: John Arild Berentsen Date: Sun, 3 Dec 2017 00:15:57 +0100 Subject: [PATCH 197/246] Bugfix #10902 (#10904) --- homeassistant/components/zwave/node_entity.py | 3 +++ 1 file changed, 3 insertions(+) diff --git a/homeassistant/components/zwave/node_entity.py b/homeassistant/components/zwave/node_entity.py index 04446cff9a1..de8ca0c1ab9 100644 --- a/homeassistant/components/zwave/node_entity.py +++ b/homeassistant/components/zwave/node_entity.py @@ -137,6 +137,9 @@ class ZWaveNodeEntity(ZWaveBaseEntity): if self.node.can_wake_up(): for value in self.node.get_values(COMMAND_CLASS_WAKE_UP).values(): + if value.index != 0: + continue + self.wakeup_interval = value.data break else: From 0f8e48c26df1ceb03c030b988a1d3d9bc3492f5e Mon Sep 17 00:00:00 2001 From: Paolo Bonzini Date: Sun, 3 Dec 2017 13:52:31 +0100 Subject: [PATCH 198/246] More declarative timeout syntax for manual alarm control panel. (#10738) More declarative timeout syntax for manual alarm control panel --- .../components/alarm_control_panel/demo.py | 31 +- .../components/alarm_control_panel/manual.py | 161 +++-- .../alarm_control_panel/manual_mqtt.py | 161 +++-- homeassistant/const.py | 1 + .../alarm_control_panel/test_manual.py | 523 ++++++++++++++++ .../alarm_control_panel/test_manual_mqtt.py | 566 +++++++++++++++++- 6 files changed, 1329 insertions(+), 114 deletions(-) diff --git a/homeassistant/components/alarm_control_panel/demo.py b/homeassistant/components/alarm_control_panel/demo.py index aa90fe1f889..c080a136c08 100644 --- a/homeassistant/components/alarm_control_panel/demo.py +++ b/homeassistant/components/alarm_control_panel/demo.py @@ -4,30 +4,45 @@ Demo platform that has two fake alarm control panels. For more details about this platform, please refer to the documentation https://home-assistant.io/components/demo/ """ +import datetime import homeassistant.components.alarm_control_panel.manual as manual from homeassistant.const import ( - STATE_ALARM_ARMED_AWAY, STATE_ALARM_ARMED_HOME, STATE_ALARM_ARMED_NIGHT, - STATE_ALARM_ARMED_CUSTOM_BYPASS, STATE_ALARM_TRIGGERED, CONF_PENDING_TIME) + STATE_ALARM_ARMED_AWAY, STATE_ALARM_ARMED_CUSTOM_BYPASS, + STATE_ALARM_ARMED_HOME, STATE_ALARM_ARMED_NIGHT, + STATE_ALARM_DISARMED, STATE_ALARM_TRIGGERED, CONF_DELAY_TIME, + CONF_PENDING_TIME, CONF_TRIGGER_TIME) def setup_platform(hass, config, add_devices, discovery_info=None): """Set up the Demo alarm control panel platform.""" add_devices([ - manual.ManualAlarm(hass, 'Alarm', '1234', 5, 10, False, { + manual.ManualAlarm(hass, 'Alarm', '1234', None, False, { STATE_ALARM_ARMED_AWAY: { - CONF_PENDING_TIME: 5 + CONF_DELAY_TIME: datetime.timedelta(seconds=0), + CONF_PENDING_TIME: datetime.timedelta(seconds=5), + CONF_TRIGGER_TIME: datetime.timedelta(seconds=10), }, STATE_ALARM_ARMED_HOME: { - CONF_PENDING_TIME: 5 + CONF_DELAY_TIME: datetime.timedelta(seconds=0), + CONF_PENDING_TIME: datetime.timedelta(seconds=5), + CONF_TRIGGER_TIME: datetime.timedelta(seconds=10), }, STATE_ALARM_ARMED_NIGHT: { - CONF_PENDING_TIME: 5 + CONF_DELAY_TIME: datetime.timedelta(seconds=0), + CONF_PENDING_TIME: datetime.timedelta(seconds=5), + CONF_TRIGGER_TIME: datetime.timedelta(seconds=10), + }, + STATE_ALARM_DISARMED: { + CONF_DELAY_TIME: datetime.timedelta(seconds=0), + CONF_TRIGGER_TIME: datetime.timedelta(seconds=10), }, STATE_ALARM_ARMED_CUSTOM_BYPASS: { - CONF_PENDING_TIME: 5 + CONF_DELAY_TIME: datetime.timedelta(seconds=0), + CONF_PENDING_TIME: datetime.timedelta(seconds=5), + CONF_TRIGGER_TIME: datetime.timedelta(seconds=10), }, STATE_ALARM_TRIGGERED: { - CONF_PENDING_TIME: 5 + CONF_PENDING_TIME: datetime.timedelta(seconds=5), }, }), ]) diff --git a/homeassistant/components/alarm_control_panel/manual.py b/homeassistant/components/alarm_control_panel/manual.py index 55f3834c06a..5ff6092493b 100644 --- a/homeassistant/components/alarm_control_panel/manual.py +++ b/homeassistant/components/alarm_control_panel/manual.py @@ -16,24 +16,40 @@ from homeassistant.const import ( STATE_ALARM_ARMED_AWAY, STATE_ALARM_ARMED_HOME, STATE_ALARM_ARMED_NIGHT, STATE_ALARM_ARMED_CUSTOM_BYPASS, STATE_ALARM_DISARMED, STATE_ALARM_PENDING, STATE_ALARM_TRIGGERED, CONF_PLATFORM, CONF_NAME, CONF_CODE, - CONF_PENDING_TIME, CONF_TRIGGER_TIME, CONF_DISARM_AFTER_TRIGGER) + CONF_DELAY_TIME, CONF_PENDING_TIME, CONF_TRIGGER_TIME, + CONF_DISARM_AFTER_TRIGGER) import homeassistant.helpers.config_validation as cv from homeassistant.helpers.event import track_point_in_time +CONF_CODE_TEMPLATE = 'code_template' + DEFAULT_ALARM_NAME = 'HA Alarm' -DEFAULT_PENDING_TIME = 60 -DEFAULT_TRIGGER_TIME = 120 +DEFAULT_DELAY_TIME = datetime.timedelta(seconds=0) +DEFAULT_PENDING_TIME = datetime.timedelta(seconds=60) +DEFAULT_TRIGGER_TIME = datetime.timedelta(seconds=120) DEFAULT_DISARM_AFTER_TRIGGER = False -SUPPORTED_PENDING_STATES = [STATE_ALARM_ARMED_AWAY, STATE_ALARM_ARMED_HOME, - STATE_ALARM_ARMED_NIGHT, STATE_ALARM_TRIGGERED, - STATE_ALARM_ARMED_CUSTOM_BYPASS] +SUPPORTED_STATES = [STATE_ALARM_DISARMED, STATE_ALARM_ARMED_AWAY, + STATE_ALARM_ARMED_HOME, STATE_ALARM_ARMED_NIGHT, + STATE_ALARM_ARMED_CUSTOM_BYPASS, STATE_ALARM_TRIGGERED] +SUPPORTED_PRETRIGGER_STATES = [state for state in SUPPORTED_STATES + if state != STATE_ALARM_TRIGGERED] + +SUPPORTED_PENDING_STATES = [state for state in SUPPORTED_STATES + if state != STATE_ALARM_DISARMED] + +ATTR_PRE_PENDING_STATE = 'pre_pending_state' ATTR_POST_PENDING_STATE = 'post_pending_state' def _state_validator(config): config = copy.deepcopy(config) + for state in SUPPORTED_PRETRIGGER_STATES: + if CONF_DELAY_TIME not in config[state]: + config[state][CONF_DELAY_TIME] = config[CONF_DELAY_TIME] + if CONF_TRIGGER_TIME not in config[state]: + config[state][CONF_TRIGGER_TIME] = config[CONF_TRIGGER_TIME] for state in SUPPORTED_PENDING_STATES: if CONF_PENDING_TIME not in config[state]: config[state][CONF_PENDING_TIME] = config[CONF_PENDING_TIME] @@ -41,28 +57,44 @@ def _state_validator(config): return config -STATE_SETTING_SCHEMA = vol.Schema({ - vol.Optional(CONF_PENDING_TIME): - vol.All(vol.Coerce(int), vol.Range(min=0)) -}) +def _state_schema(state): + schema = {} + if state in SUPPORTED_PRETRIGGER_STATES: + schema[vol.Optional(CONF_DELAY_TIME)] = vol.All( + cv.time_period, cv.positive_timedelta) + schema[vol.Optional(CONF_TRIGGER_TIME)] = vol.All( + cv.time_period, cv.positive_timedelta) + if state in SUPPORTED_PENDING_STATES: + schema[vol.Optional(CONF_PENDING_TIME)] = vol.All( + cv.time_period, cv.positive_timedelta) + return vol.Schema(schema) PLATFORM_SCHEMA = vol.Schema(vol.All({ vol.Required(CONF_PLATFORM): 'manual', vol.Optional(CONF_NAME, default=DEFAULT_ALARM_NAME): cv.string, - vol.Optional(CONF_CODE): cv.string, + vol.Exclusive(CONF_CODE, 'code validation'): cv.string, + vol.Exclusive(CONF_CODE_TEMPLATE, 'code validation'): cv.template, + vol.Optional(CONF_DELAY_TIME, default=DEFAULT_DELAY_TIME): + vol.All(cv.time_period, cv.positive_timedelta), vol.Optional(CONF_PENDING_TIME, default=DEFAULT_PENDING_TIME): - vol.All(vol.Coerce(int), vol.Range(min=0)), + vol.All(cv.time_period, cv.positive_timedelta), vol.Optional(CONF_TRIGGER_TIME, default=DEFAULT_TRIGGER_TIME): - vol.All(vol.Coerce(int), vol.Range(min=1)), + vol.All(cv.time_period, cv.positive_timedelta), vol.Optional(CONF_DISARM_AFTER_TRIGGER, default=DEFAULT_DISARM_AFTER_TRIGGER): cv.boolean, - vol.Optional(STATE_ALARM_ARMED_AWAY, default={}): STATE_SETTING_SCHEMA, - vol.Optional(STATE_ALARM_ARMED_HOME, default={}): STATE_SETTING_SCHEMA, - vol.Optional(STATE_ALARM_ARMED_NIGHT, default={}): STATE_SETTING_SCHEMA, - vol.Optional(STATE_ALARM_ARMED_CUSTOM_BYPASS, - default={}): STATE_SETTING_SCHEMA, - vol.Optional(STATE_ALARM_TRIGGERED, default={}): STATE_SETTING_SCHEMA, + vol.Optional(STATE_ALARM_ARMED_AWAY, default={}): + _state_schema(STATE_ALARM_ARMED_AWAY), + vol.Optional(STATE_ALARM_ARMED_HOME, default={}): + _state_schema(STATE_ALARM_ARMED_HOME), + vol.Optional(STATE_ALARM_ARMED_NIGHT, default={}): + _state_schema(STATE_ALARM_ARMED_NIGHT), + vol.Optional(STATE_ALARM_ARMED_CUSTOM_BYPASS, default={}): + _state_schema(STATE_ALARM_ARMED_CUSTOM_BYPASS), + vol.Optional(STATE_ALARM_DISARMED, default={}): + _state_schema(STATE_ALARM_DISARMED), + vol.Optional(STATE_ALARM_TRIGGERED, default={}): + _state_schema(STATE_ALARM_TRIGGERED), }, _state_validator)) _LOGGER = logging.getLogger(__name__) @@ -74,8 +106,7 @@ def setup_platform(hass, config, add_devices, discovery_info=None): hass, config[CONF_NAME], config.get(CONF_CODE), - config.get(CONF_PENDING_TIME, DEFAULT_PENDING_TIME), - config.get(CONF_TRIGGER_TIME, DEFAULT_TRIGGER_TIME), + config.get(CONF_CODE_TEMPLATE), config.get(CONF_DISARM_AFTER_TRIGGER, DEFAULT_DISARM_AFTER_TRIGGER), config )]) @@ -86,27 +117,37 @@ class ManualAlarm(alarm.AlarmControlPanel): Representation of an alarm status. When armed, will be pending for 'pending_time', after that armed. - When triggered, will be pending for 'trigger_time'. After that will be - triggered for 'trigger_time', after that we return to the previous state - or disarm if `disarm_after_trigger` is true. + When triggered, will be pending for the triggering state's 'delay_time' + plus the triggered state's 'pending_time'. + After that will be triggered for 'trigger_time', after that we return to + the previous state or disarm if `disarm_after_trigger` is true. + A trigger_time of zero disables the alarm_trigger service. """ - def __init__(self, hass, name, code, pending_time, trigger_time, + def __init__(self, hass, name, code, code_template, disarm_after_trigger, config): """Init the manual alarm panel.""" self._state = STATE_ALARM_DISARMED self._hass = hass self._name = name - self._code = str(code) if code else None - self._trigger_time = datetime.timedelta(seconds=trigger_time) + if code_template: + self._code = code_template + self._code.hass = hass + else: + self._code = code or None self._disarm_after_trigger = disarm_after_trigger - self._pre_trigger_state = self._state + self._previous_state = self._state self._state_ts = None - self._pending_time_by_state = {} - for state in SUPPORTED_PENDING_STATES: - self._pending_time_by_state[state] = datetime.timedelta( - seconds=config[state][CONF_PENDING_TIME]) + self._delay_time_by_state = { + state: config[state][CONF_DELAY_TIME] + for state in SUPPORTED_PRETRIGGER_STATES} + self._trigger_time_by_state = { + state: config[state][CONF_TRIGGER_TIME] + for state in SUPPORTED_PRETRIGGER_STATES} + self._pending_time_by_state = { + state: config[state][CONF_PENDING_TIME] + for state in SUPPORTED_PENDING_STATES} @property def should_poll(self): @@ -121,15 +162,16 @@ class ManualAlarm(alarm.AlarmControlPanel): @property def state(self): """Return the state of the device.""" - if self._state == STATE_ALARM_TRIGGERED and self._trigger_time: + if self._state == STATE_ALARM_TRIGGERED: if self._within_pending_time(self._state): return STATE_ALARM_PENDING - elif (self._state_ts + self._pending_time_by_state[self._state] + - self._trigger_time) < dt_util.utcnow(): + trigger_time = self._trigger_time_by_state[self._previous_state] + if (self._state_ts + self._pending_time(self._state) + + trigger_time) < dt_util.utcnow(): if self._disarm_after_trigger: return STATE_ALARM_DISARMED else: - self._state = self._pre_trigger_state + self._state = self._previous_state return self._state if self._state in SUPPORTED_PENDING_STATES and \ @@ -138,9 +180,21 @@ class ManualAlarm(alarm.AlarmControlPanel): return self._state - def _within_pending_time(self, state): + @property + def _active_state(self): + if self.state == STATE_ALARM_PENDING: + return self._previous_state + else: + return self._state + + def _pending_time(self, state): pending_time = self._pending_time_by_state[state] - return self._state_ts + pending_time > dt_util.utcnow() + if state == STATE_ALARM_TRIGGERED: + pending_time += self._delay_time_by_state[self._previous_state] + return pending_time + + def _within_pending_time(self, state): + return self._state_ts + self._pending_time(state) > dt_util.utcnow() @property def code_format(self): @@ -185,26 +239,35 @@ class ManualAlarm(alarm.AlarmControlPanel): self._update_state(STATE_ALARM_ARMED_CUSTOM_BYPASS) def alarm_trigger(self, code=None): - """Send alarm trigger command. No code needed.""" - self._pre_trigger_state = self._state + """ + Send alarm trigger command. + No code needed, a trigger time of zero for the current state + disables the alarm. + """ + if not self._trigger_time_by_state[self._active_state]: + return self._update_state(STATE_ALARM_TRIGGERED) def _update_state(self, state): + if self._state == state: + return + + self._previous_state = self._state self._state = state self._state_ts = dt_util.utcnow() self.schedule_update_ha_state() - pending_time = self._pending_time_by_state[state] - - if state == STATE_ALARM_TRIGGERED and self._trigger_time: + pending_time = self._pending_time(state) + if state == STATE_ALARM_TRIGGERED: track_point_in_time( self._hass, self.async_update_ha_state, self._state_ts + pending_time) + trigger_time = self._trigger_time_by_state[self._previous_state] track_point_in_time( self._hass, self.async_update_ha_state, - self._state_ts + self._trigger_time + pending_time) + self._state_ts + pending_time + trigger_time) elif state in SUPPORTED_PENDING_STATES and pending_time: track_point_in_time( self._hass, self.async_update_ha_state, @@ -212,7 +275,14 @@ class ManualAlarm(alarm.AlarmControlPanel): def _validate_code(self, code, state): """Validate given code.""" - check = self._code is None or code == self._code + if self._code is None: + return True + if isinstance(self._code, str): + alarm_code = self._code + else: + alarm_code = self._code.render(from_state=self._state, + to_state=state) + check = not alarm_code or code == alarm_code if not check: _LOGGER.warning("Invalid code given for %s", state) return check @@ -223,6 +293,7 @@ class ManualAlarm(alarm.AlarmControlPanel): state_attr = {} if self.state == STATE_ALARM_PENDING: + state_attr[ATTR_PRE_PENDING_STATE] = self._previous_state state_attr[ATTR_POST_PENDING_STATE] = self._state return state_attr diff --git a/homeassistant/components/alarm_control_panel/manual_mqtt.py b/homeassistant/components/alarm_control_panel/manual_mqtt.py index 44247616b59..9e388806e73 100644 --- a/homeassistant/components/alarm_control_panel/manual_mqtt.py +++ b/homeassistant/components/alarm_control_panel/manual_mqtt.py @@ -16,8 +16,8 @@ import homeassistant.util.dt as dt_util from homeassistant.const import ( STATE_ALARM_ARMED_AWAY, STATE_ALARM_ARMED_HOME, STATE_ALARM_ARMED_NIGHT, STATE_ALARM_DISARMED, STATE_ALARM_PENDING, STATE_ALARM_TRIGGERED, - CONF_PLATFORM, CONF_NAME, CONF_CODE, CONF_PENDING_TIME, CONF_TRIGGER_TIME, - CONF_DISARM_AFTER_TRIGGER) + CONF_PLATFORM, CONF_NAME, CONF_CODE, CONF_DELAY_TIME, CONF_PENDING_TIME, + CONF_TRIGGER_TIME, CONF_DISARM_AFTER_TRIGGER) import homeassistant.components.mqtt as mqtt from homeassistant.helpers.event import async_track_state_change @@ -26,28 +26,44 @@ from homeassistant.core import callback import homeassistant.helpers.config_validation as cv from homeassistant.helpers.event import track_point_in_time +CONF_CODE_TEMPLATE = 'code_template' + CONF_PAYLOAD_DISARM = 'payload_disarm' CONF_PAYLOAD_ARM_HOME = 'payload_arm_home' CONF_PAYLOAD_ARM_AWAY = 'payload_arm_away' CONF_PAYLOAD_ARM_NIGHT = 'payload_arm_night' DEFAULT_ALARM_NAME = 'HA Alarm' -DEFAULT_PENDING_TIME = 60 -DEFAULT_TRIGGER_TIME = 120 +DEFAULT_DELAY_TIME = datetime.timedelta(seconds=0) +DEFAULT_PENDING_TIME = datetime.timedelta(seconds=60) +DEFAULT_TRIGGER_TIME = datetime.timedelta(seconds=120) DEFAULT_DISARM_AFTER_TRIGGER = False DEFAULT_ARM_AWAY = 'ARM_AWAY' DEFAULT_ARM_HOME = 'ARM_HOME' DEFAULT_ARM_NIGHT = 'ARM_NIGHT' DEFAULT_DISARM = 'DISARM' -SUPPORTED_PENDING_STATES = [STATE_ALARM_ARMED_AWAY, STATE_ALARM_ARMED_HOME, - STATE_ALARM_ARMED_NIGHT, STATE_ALARM_TRIGGERED] +SUPPORTED_STATES = [STATE_ALARM_DISARMED, STATE_ALARM_ARMED_AWAY, + STATE_ALARM_ARMED_HOME, STATE_ALARM_ARMED_NIGHT, + STATE_ALARM_TRIGGERED] +SUPPORTED_PRETRIGGER_STATES = [state for state in SUPPORTED_STATES + if state != STATE_ALARM_TRIGGERED] + +SUPPORTED_PENDING_STATES = [state for state in SUPPORTED_STATES + if state != STATE_ALARM_DISARMED] + +ATTR_PRE_PENDING_STATE = 'pre_pending_state' ATTR_POST_PENDING_STATE = 'post_pending_state' def _state_validator(config): config = copy.deepcopy(config) + for state in SUPPORTED_PRETRIGGER_STATES: + if CONF_DELAY_TIME not in config[state]: + config[state][CONF_DELAY_TIME] = config[CONF_DELAY_TIME] + if CONF_TRIGGER_TIME not in config[state]: + config[state][CONF_TRIGGER_TIME] = config[CONF_TRIGGER_TIME] for state in SUPPORTED_PENDING_STATES: if CONF_PENDING_TIME not in config[state]: config[state][CONF_PENDING_TIME] = config[CONF_PENDING_TIME] @@ -55,27 +71,44 @@ def _state_validator(config): return config -STATE_SETTING_SCHEMA = vol.Schema({ - vol.Optional(CONF_PENDING_TIME): - vol.All(vol.Coerce(int), vol.Range(min=0)) -}) +def _state_schema(state): + schema = {} + if state in SUPPORTED_PRETRIGGER_STATES: + schema[vol.Optional(CONF_DELAY_TIME)] = vol.All( + cv.time_period, cv.positive_timedelta) + schema[vol.Optional(CONF_TRIGGER_TIME)] = vol.All( + cv.time_period, cv.positive_timedelta) + if state in SUPPORTED_PENDING_STATES: + schema[vol.Optional(CONF_PENDING_TIME)] = vol.All( + cv.time_period, cv.positive_timedelta) + return vol.Schema(schema) + DEPENDENCIES = ['mqtt'] PLATFORM_SCHEMA = vol.Schema(vol.All(mqtt.MQTT_BASE_PLATFORM_SCHEMA.extend({ vol.Required(CONF_PLATFORM): 'manual_mqtt', vol.Optional(CONF_NAME, default=DEFAULT_ALARM_NAME): cv.string, - vol.Optional(CONF_CODE): cv.string, + vol.Exclusive(CONF_CODE, 'code validation'): cv.string, + vol.Exclusive(CONF_CODE_TEMPLATE, 'code validation'): cv.template, + vol.Optional(CONF_DELAY_TIME, default=DEFAULT_DELAY_TIME): + vol.All(cv.time_period, cv.positive_timedelta), vol.Optional(CONF_PENDING_TIME, default=DEFAULT_PENDING_TIME): - vol.All(vol.Coerce(int), vol.Range(min=0)), + vol.All(cv.time_period, cv.positive_timedelta), vol.Optional(CONF_TRIGGER_TIME, default=DEFAULT_TRIGGER_TIME): - vol.All(vol.Coerce(int), vol.Range(min=1)), + vol.All(cv.time_period, cv.positive_timedelta), vol.Optional(CONF_DISARM_AFTER_TRIGGER, default=DEFAULT_DISARM_AFTER_TRIGGER): cv.boolean, - vol.Optional(STATE_ALARM_ARMED_AWAY, default={}): STATE_SETTING_SCHEMA, - vol.Optional(STATE_ALARM_ARMED_HOME, default={}): STATE_SETTING_SCHEMA, - vol.Optional(STATE_ALARM_ARMED_NIGHT, default={}): STATE_SETTING_SCHEMA, - vol.Optional(STATE_ALARM_TRIGGERED, default={}): STATE_SETTING_SCHEMA, + vol.Optional(STATE_ALARM_ARMED_AWAY, default={}): + _state_schema(STATE_ALARM_ARMED_AWAY), + vol.Optional(STATE_ALARM_ARMED_HOME, default={}): + _state_schema(STATE_ALARM_ARMED_HOME), + vol.Optional(STATE_ALARM_ARMED_NIGHT, default={}): + _state_schema(STATE_ALARM_ARMED_NIGHT), + vol.Optional(STATE_ALARM_DISARMED, default={}): + _state_schema(STATE_ALARM_DISARMED), + vol.Optional(STATE_ALARM_TRIGGERED, default={}): + _state_schema(STATE_ALARM_TRIGGERED), vol.Required(mqtt.CONF_COMMAND_TOPIC): mqtt.valid_publish_topic, vol.Required(mqtt.CONF_STATE_TOPIC): mqtt.valid_subscribe_topic, vol.Optional(CONF_PAYLOAD_ARM_AWAY, default=DEFAULT_ARM_AWAY): cv.string, @@ -93,8 +126,7 @@ def setup_platform(hass, config, add_devices, discovery_info=None): hass, config[CONF_NAME], config.get(CONF_CODE), - config.get(CONF_PENDING_TIME, DEFAULT_PENDING_TIME), - config.get(CONF_TRIGGER_TIME, DEFAULT_TRIGGER_TIME), + config.get(CONF_CODE_TEMPLATE), config.get(CONF_DISARM_AFTER_TRIGGER, DEFAULT_DISARM_AFTER_TRIGGER), config.get(mqtt.CONF_STATE_TOPIC), config.get(mqtt.CONF_COMMAND_TOPIC), @@ -111,13 +143,15 @@ class ManualMQTTAlarm(alarm.AlarmControlPanel): Representation of an alarm status. When armed, will be pending for 'pending_time', after that armed. - When triggered, will be pending for 'trigger_time'. After that will be - triggered for 'trigger_time', after that we return to the previous state - or disarm if `disarm_after_trigger` is true. + When triggered, will be pending for the triggering state's 'delay_time' + plus the triggered state's 'pending_time'. + After that will be triggered for 'trigger_time', after that we return to + the previous state or disarm if `disarm_after_trigger` is true. + A trigger_time of zero disables the alarm_trigger service. """ - def __init__(self, hass, name, code, pending_time, - trigger_time, disarm_after_trigger, + def __init__(self, hass, name, code, code_template, + disarm_after_trigger, state_topic, command_topic, qos, payload_disarm, payload_arm_home, payload_arm_away, payload_arm_night, config): @@ -125,17 +159,24 @@ class ManualMQTTAlarm(alarm.AlarmControlPanel): self._state = STATE_ALARM_DISARMED self._hass = hass self._name = name - self._code = str(code) if code else None - self._pending_time = datetime.timedelta(seconds=pending_time) - self._trigger_time = datetime.timedelta(seconds=trigger_time) + if code_template: + self._code = code_template + self._code.hass = hass + else: + self._code = code or None self._disarm_after_trigger = disarm_after_trigger - self._pre_trigger_state = self._state + self._previous_state = self._state self._state_ts = None - self._pending_time_by_state = {} - for state in SUPPORTED_PENDING_STATES: - self._pending_time_by_state[state] = datetime.timedelta( - seconds=config[state][CONF_PENDING_TIME]) + self._delay_time_by_state = { + state: config[state][CONF_DELAY_TIME] + for state in SUPPORTED_PRETRIGGER_STATES} + self._trigger_time_by_state = { + state: config[state][CONF_TRIGGER_TIME] + for state in SUPPORTED_PRETRIGGER_STATES} + self._pending_time_by_state = { + state: config[state][CONF_PENDING_TIME] + for state in SUPPORTED_PENDING_STATES} self._state_topic = state_topic self._command_topic = command_topic @@ -158,15 +199,16 @@ class ManualMQTTAlarm(alarm.AlarmControlPanel): @property def state(self): """Return the state of the device.""" - if self._state == STATE_ALARM_TRIGGERED and self._trigger_time: + if self._state == STATE_ALARM_TRIGGERED: if self._within_pending_time(self._state): return STATE_ALARM_PENDING - elif (self._state_ts + self._pending_time_by_state[self._state] + - self._trigger_time) < dt_util.utcnow(): + trigger_time = self._trigger_time_by_state[self._previous_state] + if (self._state_ts + self._pending_time(self._state) + + trigger_time) < dt_util.utcnow(): if self._disarm_after_trigger: return STATE_ALARM_DISARMED else: - self._state = self._pre_trigger_state + self._state = self._previous_state return self._state if self._state in SUPPORTED_PENDING_STATES and \ @@ -175,9 +217,21 @@ class ManualMQTTAlarm(alarm.AlarmControlPanel): return self._state - def _within_pending_time(self, state): + @property + def _active_state(self): + if self.state == STATE_ALARM_PENDING: + return self._previous_state + else: + return self._state + + def _pending_time(self, state): pending_time = self._pending_time_by_state[state] - return self._state_ts + pending_time > dt_util.utcnow() + if state == STATE_ALARM_TRIGGERED: + pending_time += self._delay_time_by_state[self._previous_state] + return pending_time + + def _within_pending_time(self, state): + return self._state_ts + self._pending_time(state) > dt_util.utcnow() @property def code_format(self): @@ -215,26 +269,35 @@ class ManualMQTTAlarm(alarm.AlarmControlPanel): self._update_state(STATE_ALARM_ARMED_NIGHT) def alarm_trigger(self, code=None): - """Send alarm trigger command. No code needed.""" - self._pre_trigger_state = self._state + """ + Send alarm trigger command. + No code needed, a trigger time of zero for the current state + disables the alarm. + """ + if not self._trigger_time_by_state[self._active_state]: + return self._update_state(STATE_ALARM_TRIGGERED) def _update_state(self, state): + if self._state == state: + return + + self._previous_state = self._state self._state = state self._state_ts = dt_util.utcnow() self.schedule_update_ha_state() - pending_time = self._pending_time_by_state[state] - - if state == STATE_ALARM_TRIGGERED and self._trigger_time: + pending_time = self._pending_time(state) + if state == STATE_ALARM_TRIGGERED: track_point_in_time( self._hass, self.async_update_ha_state, self._state_ts + pending_time) + trigger_time = self._trigger_time_by_state[self._previous_state] track_point_in_time( self._hass, self.async_update_ha_state, - self._state_ts + self._trigger_time + pending_time) + self._state_ts + pending_time + trigger_time) elif state in SUPPORTED_PENDING_STATES and pending_time: track_point_in_time( self._hass, self.async_update_ha_state, @@ -242,7 +305,14 @@ class ManualMQTTAlarm(alarm.AlarmControlPanel): def _validate_code(self, code, state): """Validate given code.""" - check = self._code is None or code == self._code + if self._code is None: + return True + if isinstance(self._code, str): + alarm_code = self._code + else: + alarm_code = self._code.render(from_state=self._state, + to_state=state) + check = not alarm_code or code == alarm_code if not check: _LOGGER.warning("Invalid code given for %s", state) return check @@ -253,6 +323,7 @@ class ManualMQTTAlarm(alarm.AlarmControlPanel): state_attr = {} if self.state == STATE_ALARM_PENDING: + state_attr[ATTR_PRE_PENDING_STATE] = self._previous_state state_attr[ATTR_POST_PENDING_STATE] = self._state return state_attr diff --git a/homeassistant/const.py b/homeassistant/const.py index beb34146e70..9d394bb4a99 100644 --- a/homeassistant/const.py +++ b/homeassistant/const.py @@ -52,6 +52,7 @@ CONF_CURRENCY = 'currency' CONF_CUSTOMIZE = 'customize' CONF_CUSTOMIZE_DOMAIN = 'customize_domain' CONF_CUSTOMIZE_GLOB = 'customize_glob' +CONF_DELAY_TIME = 'delay_time' CONF_DEVICE = 'device' CONF_DEVICE_CLASS = 'device_class' CONF_DEVICES = 'devices' diff --git a/tests/components/alarm_control_panel/test_manual.py b/tests/components/alarm_control_panel/test_manual.py index d65568b0844..c47ed941b65 100644 --- a/tests/components/alarm_control_panel/test_manual.py +++ b/tests/components/alarm_control_panel/test_manual.py @@ -140,6 +140,32 @@ class TestAlarmControlPanelManual(unittest.TestCase): self.assertEqual(STATE_ALARM_ARMED_AWAY, self.hass.states.get(entity_id).state) + def test_arm_home_with_template_code(self): + """Attempt to arm with a template-based code.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual', + 'name': 'test', + 'code_template': '{{ "abc" }}', + 'pending_time': 0, + 'disarm_after_trigger': False + }})) + + entity_id = 'alarm_control_panel.test' + + self.hass.start() + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_arm_home(self.hass, 'abc') + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_ARMED_HOME, state.state) + def test_arm_away_with_pending(self): """Test arm home method.""" self.assertTrue(setup_component( @@ -257,6 +283,13 @@ class TestAlarmControlPanelManual(unittest.TestCase): state = self.hass.states.get(entity_id) assert state.state == STATE_ALARM_ARMED_NIGHT + # Do not go to the pending state when updating to the same state + alarm_control_panel.alarm_arm_night(self.hass, CODE, entity_id) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_ARMED_NIGHT, + self.hass.states.get(entity_id).state) + def test_arm_night_with_invalid_code(self): """Attempt to night home without a valid code.""" self.assertTrue(setup_component( @@ -311,6 +344,93 @@ class TestAlarmControlPanelManual(unittest.TestCase): self.assertEqual(STATE_ALARM_TRIGGERED, self.hass.states.get(entity_id).state) + def test_trigger_with_delay(self): + """Test trigger method and switch from pending to triggered.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual', + 'name': 'test', + 'code': CODE, + 'delay_time': 1, + 'pending_time': 0, + 'disarm_after_trigger': False + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_arm_away(self.hass, CODE) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_ARMED_AWAY, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_trigger(self.hass, entity_id=entity_id) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_PENDING, state.state) + self.assertEqual(STATE_ALARM_TRIGGERED, + state.attributes['post_pending_state']) + + future = dt_util.utcnow() + timedelta(seconds=1) + with patch(('homeassistant.components.alarm_control_panel.manual.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_TRIGGERED, state.state) + + def test_trigger_zero_trigger_time(self): + """Test disabled trigger.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual', + 'name': 'test', + 'pending_time': 0, + 'trigger_time': 0, + 'disarm_after_trigger': False + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_trigger(self.hass) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + def test_trigger_zero_trigger_time_with_pending(self): + """Test disabled trigger.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual', + 'name': 'test', + 'pending_time': 2, + 'trigger_time': 0, + 'disarm_after_trigger': False + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_trigger(self.hass) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + def test_trigger_with_pending(self): """Test arm home method.""" self.assertTrue(setup_component( @@ -355,6 +475,203 @@ class TestAlarmControlPanelManual(unittest.TestCase): state = self.hass.states.get(entity_id) assert state.state == STATE_ALARM_DISARMED + def test_trigger_with_unused_specific_delay(self): + """Test trigger method and switch from pending to triggered.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual', + 'name': 'test', + 'code': CODE, + 'delay_time': 5, + 'pending_time': 0, + 'armed_home': { + 'delay_time': 10 + }, + 'disarm_after_trigger': False + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_arm_away(self.hass, CODE) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_ARMED_AWAY, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_trigger(self.hass, entity_id=entity_id) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_PENDING, state.state) + self.assertEqual(STATE_ALARM_TRIGGERED, + state.attributes['post_pending_state']) + + future = dt_util.utcnow() + timedelta(seconds=5) + with patch(('homeassistant.components.alarm_control_panel.manual.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + assert state.state == STATE_ALARM_TRIGGERED + + def test_trigger_with_specific_delay(self): + """Test trigger method and switch from pending to triggered.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual', + 'name': 'test', + 'code': CODE, + 'delay_time': 10, + 'pending_time': 0, + 'armed_away': { + 'delay_time': 1 + }, + 'disarm_after_trigger': False + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_arm_away(self.hass, CODE) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_ARMED_AWAY, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_trigger(self.hass, entity_id=entity_id) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_PENDING, state.state) + self.assertEqual(STATE_ALARM_TRIGGERED, + state.attributes['post_pending_state']) + + future = dt_util.utcnow() + timedelta(seconds=1) + with patch(('homeassistant.components.alarm_control_panel.manual.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + assert state.state == STATE_ALARM_TRIGGERED + + def test_trigger_with_pending_and_delay(self): + """Test trigger method and switch from pending to triggered.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual', + 'name': 'test', + 'code': CODE, + 'delay_time': 1, + 'pending_time': 0, + 'triggered': { + 'pending_time': 1 + }, + 'disarm_after_trigger': False + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_arm_away(self.hass, CODE) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_ARMED_AWAY, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_trigger(self.hass, entity_id=entity_id) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + assert state.state == STATE_ALARM_PENDING + assert state.attributes['post_pending_state'] == STATE_ALARM_TRIGGERED + + future = dt_util.utcnow() + timedelta(seconds=1) + with patch(('homeassistant.components.alarm_control_panel.manual.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + assert state.state == STATE_ALARM_PENDING + assert state.attributes['post_pending_state'] == STATE_ALARM_TRIGGERED + + future += timedelta(seconds=1) + with patch(('homeassistant.components.alarm_control_panel.manual.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + assert state.state == STATE_ALARM_TRIGGERED + + def test_trigger_with_pending_and_specific_delay(self): + """Test trigger method and switch from pending to triggered.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual', + 'name': 'test', + 'code': CODE, + 'delay_time': 10, + 'pending_time': 0, + 'armed_away': { + 'delay_time': 1 + }, + 'triggered': { + 'pending_time': 1 + }, + 'disarm_after_trigger': False + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_arm_away(self.hass, CODE) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_ARMED_AWAY, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_trigger(self.hass, entity_id=entity_id) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + assert state.state == STATE_ALARM_PENDING + assert state.attributes['post_pending_state'] == STATE_ALARM_TRIGGERED + + future = dt_util.utcnow() + timedelta(seconds=1) + with patch(('homeassistant.components.alarm_control_panel.manual.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + assert state.state == STATE_ALARM_PENDING + assert state.attributes['post_pending_state'] == STATE_ALARM_TRIGGERED + + future += timedelta(seconds=1) + with patch(('homeassistant.components.alarm_control_panel.manual.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + assert state.state == STATE_ALARM_TRIGGERED + def test_armed_home_with_specific_pending(self): """Test arm home method.""" self.assertTrue(setup_component( @@ -518,6 +835,101 @@ class TestAlarmControlPanelManual(unittest.TestCase): self.assertEqual(STATE_ALARM_DISARMED, self.hass.states.get(entity_id).state) + def test_trigger_with_zero_specific_trigger_time(self): + """Test trigger method.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual', + 'name': 'test', + 'trigger_time': 5, + 'disarmed': { + 'trigger_time': 0 + }, + 'pending_time': 0, + 'disarm_after_trigger': True + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_trigger(self.hass, entity_id=entity_id) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + def test_trigger_with_unused_zero_specific_trigger_time(self): + """Test disarm after trigger.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual', + 'name': 'test', + 'trigger_time': 5, + 'armed_home': { + 'trigger_time': 0 + }, + 'pending_time': 0, + 'disarm_after_trigger': True + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_trigger(self.hass, entity_id=entity_id) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_TRIGGERED, + self.hass.states.get(entity_id).state) + + future = dt_util.utcnow() + timedelta(seconds=5) + with patch(('homeassistant.components.alarm_control_panel.manual.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + def test_trigger_with_specific_trigger_time(self): + """Test disarm after trigger.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual', + 'name': 'test', + 'disarmed': { + 'trigger_time': 5 + }, + 'pending_time': 0, + 'disarm_after_trigger': True + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_trigger(self.hass, entity_id=entity_id) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_TRIGGERED, + self.hass.states.get(entity_id).state) + + future = dt_util.utcnow() + timedelta(seconds=5) + with patch(('homeassistant.components.alarm_control_panel.manual.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + def test_trigger_with_no_disarm_after_trigger(self): """Test disarm after trigger.""" self.assertTrue(setup_component( @@ -684,6 +1096,45 @@ class TestAlarmControlPanelManual(unittest.TestCase): self.assertEqual(STATE_ALARM_TRIGGERED, self.hass.states.get(entity_id).state) + def test_disarm_with_template_code(self): + """Attempt to disarm with a valid or invalid template-based code.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual', + 'name': 'test', + 'code_template': + '{{ "" if from_state == "disarmed" else "abc" }}', + 'pending_time': 0, + 'disarm_after_trigger': False + }})) + + entity_id = 'alarm_control_panel.test' + + self.hass.start() + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_arm_home(self.hass, 'def') + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_ARMED_HOME, state.state) + + alarm_control_panel.alarm_disarm(self.hass, 'def') + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_ARMED_HOME, state.state) + + alarm_control_panel.alarm_disarm(self.hass, 'abc') + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_DISARMED, state.state) + def test_arm_custom_bypass_no_pending(self): """Test arm custom bypass method.""" self.assertTrue(setup_component( @@ -795,3 +1246,75 @@ class TestAlarmControlPanelManual(unittest.TestCase): self.assertEqual(STATE_ALARM_ARMED_CUSTOM_BYPASS, self.hass.states.get(entity_id).state) + + def test_arm_away_after_disabled_disarmed(self): + """Test pending state with and without zero trigger time.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual', + 'name': 'test', + 'code': CODE, + 'pending_time': 0, + 'delay_time': 1, + 'armed_away': { + 'pending_time': 1, + }, + 'disarmed': { + 'trigger_time': 0 + }, + 'disarm_after_trigger': False + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_arm_away(self.hass, CODE) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_PENDING, state.state) + self.assertEqual(STATE_ALARM_DISARMED, + state.attributes['pre_pending_state']) + self.assertEqual(STATE_ALARM_ARMED_AWAY, + state.attributes['post_pending_state']) + + alarm_control_panel.alarm_trigger(self.hass, entity_id=entity_id) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_PENDING, state.state) + self.assertEqual(STATE_ALARM_DISARMED, + state.attributes['pre_pending_state']) + self.assertEqual(STATE_ALARM_ARMED_AWAY, + state.attributes['post_pending_state']) + + future = dt_util.utcnow() + timedelta(seconds=1) + with patch(('homeassistant.components.alarm_control_panel.manual.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_ARMED_AWAY, state.state) + + alarm_control_panel.alarm_trigger(self.hass, entity_id=entity_id) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_PENDING, state.state) + self.assertEqual(STATE_ALARM_ARMED_AWAY, + state.attributes['pre_pending_state']) + self.assertEqual(STATE_ALARM_TRIGGERED, + state.attributes['post_pending_state']) + + future += timedelta(seconds=1) + with patch(('homeassistant.components.alarm_control_panel.manual.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_TRIGGERED, state.state) diff --git a/tests/components/alarm_control_panel/test_manual_mqtt.py b/tests/components/alarm_control_panel/test_manual_mqtt.py index e56b6865e6e..83254d9104f 100644 --- a/tests/components/alarm_control_panel/test_manual_mqtt.py +++ b/tests/components/alarm_control_panel/test_manual_mqtt.py @@ -162,6 +162,34 @@ class TestAlarmControlPanelManualMqtt(unittest.TestCase): self.assertEqual(STATE_ALARM_ARMED_AWAY, self.hass.states.get(entity_id).state) + def test_arm_home_with_template_code(self): + """Attempt to arm with a template-based code.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual_mqtt', + 'name': 'test', + 'code_template': '{{ "abc" }}', + 'pending_time': 0, + 'disarm_after_trigger': False, + 'command_topic': 'alarm/command', + 'state_topic': 'alarm/state', + }})) + + entity_id = 'alarm_control_panel.test' + + self.hass.start() + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_arm_home(self.hass, 'abc') + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_ARMED_HOME, state.state) + def test_arm_away_with_pending(self): """Test arm home method.""" self.assertTrue(setup_component( @@ -287,6 +315,13 @@ class TestAlarmControlPanelManualMqtt(unittest.TestCase): self.assertEqual(STATE_ALARM_ARMED_NIGHT, self.hass.states.get(entity_id).state) + # Do not go to the pending state when updating to the same state + alarm_control_panel.alarm_arm_night(self.hass, CODE, entity_id) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_ARMED_NIGHT, + self.hass.states.get(entity_id).state) + def test_arm_night_with_invalid_code(self): """Attempt to arm night without a valid code.""" self.assertTrue(setup_component( @@ -345,6 +380,99 @@ class TestAlarmControlPanelManualMqtt(unittest.TestCase): self.assertEqual(STATE_ALARM_TRIGGERED, self.hass.states.get(entity_id).state) + def test_trigger_with_delay(self): + """Test trigger method and switch from pending to triggered.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual_mqtt', + 'name': 'test', + 'code': CODE, + 'delay_time': 1, + 'pending_time': 0, + 'disarm_after_trigger': False, + 'command_topic': 'alarm/command', + 'state_topic': 'alarm/state' + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_arm_away(self.hass, CODE) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_ARMED_AWAY, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_trigger(self.hass, entity_id=entity_id) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_PENDING, state.state) + self.assertEqual(STATE_ALARM_TRIGGERED, + state.attributes['post_pending_state']) + + future = dt_util.utcnow() + timedelta(seconds=1) + with patch(('homeassistant.components.alarm_control_panel.manual_mqtt.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_TRIGGERED, state.state) + + def test_trigger_zero_trigger_time(self): + """Test disabled trigger.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual_mqtt', + 'name': 'test', + 'pending_time': 0, + 'trigger_time': 0, + 'disarm_after_trigger': False, + 'command_topic': 'alarm/command', + 'state_topic': 'alarm/state' + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_trigger(self.hass) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + def test_trigger_zero_trigger_time_with_pending(self): + """Test disabled trigger.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual_mqtt', + 'name': 'test', + 'pending_time': 2, + 'trigger_time': 0, + 'disarm_after_trigger': False, + 'command_topic': 'alarm/command', + 'state_topic': 'alarm/state' + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_trigger(self.hass) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + def test_trigger_with_pending(self): """Test arm home method.""" self.assertTrue(setup_component( @@ -425,6 +553,107 @@ class TestAlarmControlPanelManualMqtt(unittest.TestCase): self.assertEqual(STATE_ALARM_DISARMED, self.hass.states.get(entity_id).state) + def test_trigger_with_zero_specific_trigger_time(self): + """Test trigger method.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual_mqtt', + 'name': 'test', + 'trigger_time': 5, + 'disarmed': { + 'trigger_time': 0 + }, + 'pending_time': 0, + 'disarm_after_trigger': True, + 'command_topic': 'alarm/command', + 'state_topic': 'alarm/state' + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_trigger(self.hass, entity_id=entity_id) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + def test_trigger_with_unused_zero_specific_trigger_time(self): + """Test disarm after trigger.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual_mqtt', + 'name': 'test', + 'trigger_time': 5, + 'armed_home': { + 'trigger_time': 0 + }, + 'pending_time': 0, + 'disarm_after_trigger': True, + 'command_topic': 'alarm/command', + 'state_topic': 'alarm/state' + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_trigger(self.hass, entity_id=entity_id) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_TRIGGERED, + self.hass.states.get(entity_id).state) + + future = dt_util.utcnow() + timedelta(seconds=5) + with patch(('homeassistant.components.alarm_control_panel.manual_mqtt.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + def test_trigger_with_specific_trigger_time(self): + """Test disarm after trigger.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual_mqtt', + 'name': 'test', + 'disarmed': { + 'trigger_time': 5 + }, + 'pending_time': 0, + 'disarm_after_trigger': True, + 'command_topic': 'alarm/command', + 'state_topic': 'alarm/state' + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_trigger(self.hass, entity_id=entity_id) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_TRIGGERED, + self.hass.states.get(entity_id).state) + + future = dt_util.utcnow() + timedelta(seconds=5) + with patch(('homeassistant.components.alarm_control_panel.manual_mqtt.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + def test_back_to_back_trigger_with_no_disarm_after_trigger(self): """Test no disarm after back to back trigger.""" self.assertTrue(setup_component( @@ -559,6 +788,211 @@ class TestAlarmControlPanelManualMqtt(unittest.TestCase): self.assertEqual(STATE_ALARM_TRIGGERED, self.hass.states.get(entity_id).state) + def test_trigger_with_unused_specific_delay(self): + """Test trigger method and switch from pending to triggered.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual_mqtt', + 'name': 'test', + 'code': CODE, + 'delay_time': 5, + 'pending_time': 0, + 'armed_home': { + 'delay_time': 10 + }, + 'disarm_after_trigger': False, + 'command_topic': 'alarm/command', + 'state_topic': 'alarm/state' + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_arm_away(self.hass, CODE) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_ARMED_AWAY, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_trigger(self.hass, entity_id=entity_id) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_PENDING, state.state) + self.assertEqual(STATE_ALARM_TRIGGERED, + state.attributes['post_pending_state']) + + future = dt_util.utcnow() + timedelta(seconds=5) + with patch(('homeassistant.components.alarm_control_panel.manual_mqtt.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + assert state.state == STATE_ALARM_TRIGGERED + + def test_trigger_with_specific_delay(self): + """Test trigger method and switch from pending to triggered.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual_mqtt', + 'name': 'test', + 'code': CODE, + 'delay_time': 10, + 'pending_time': 0, + 'armed_away': { + 'delay_time': 1 + }, + 'disarm_after_trigger': False, + 'command_topic': 'alarm/command', + 'state_topic': 'alarm/state' + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_arm_away(self.hass, CODE) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_ARMED_AWAY, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_trigger(self.hass, entity_id=entity_id) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_PENDING, state.state) + self.assertEqual(STATE_ALARM_TRIGGERED, + state.attributes['post_pending_state']) + + future = dt_util.utcnow() + timedelta(seconds=1) + with patch(('homeassistant.components.alarm_control_panel.manual_mqtt.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + assert state.state == STATE_ALARM_TRIGGERED + + def test_trigger_with_pending_and_delay(self): + """Test trigger method and switch from pending to triggered.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual_mqtt', + 'name': 'test', + 'code': CODE, + 'delay_time': 1, + 'pending_time': 0, + 'triggered': { + 'pending_time': 1 + }, + 'disarm_after_trigger': False, + 'command_topic': 'alarm/command', + 'state_topic': 'alarm/state' + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_arm_away(self.hass, CODE) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_ARMED_AWAY, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_trigger(self.hass, entity_id=entity_id) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + assert state.state == STATE_ALARM_PENDING + assert state.attributes['post_pending_state'] == STATE_ALARM_TRIGGERED + + future = dt_util.utcnow() + timedelta(seconds=1) + with patch(('homeassistant.components.alarm_control_panel.manual_mqtt.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + assert state.state == STATE_ALARM_PENDING + assert state.attributes['post_pending_state'] == STATE_ALARM_TRIGGERED + + future += timedelta(seconds=1) + with patch(('homeassistant.components.alarm_control_panel.manual_mqtt.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + assert state.state == STATE_ALARM_TRIGGERED + + def test_trigger_with_pending_and_specific_delay(self): + """Test trigger method and switch from pending to triggered.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual_mqtt', + 'name': 'test', + 'code': CODE, + 'delay_time': 10, + 'pending_time': 0, + 'armed_away': { + 'delay_time': 1 + }, + 'triggered': { + 'pending_time': 1 + }, + 'disarm_after_trigger': False, + 'command_topic': 'alarm/command', + 'state_topic': 'alarm/state' + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_arm_away(self.hass, CODE) + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_ARMED_AWAY, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_trigger(self.hass, entity_id=entity_id) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + assert state.state == STATE_ALARM_PENDING + assert state.attributes['post_pending_state'] == STATE_ALARM_TRIGGERED + + future = dt_util.utcnow() + timedelta(seconds=1) + with patch(('homeassistant.components.alarm_control_panel.manual_mqtt.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + assert state.state == STATE_ALARM_PENDING + assert state.attributes['post_pending_state'] == STATE_ALARM_TRIGGERED + + future += timedelta(seconds=1) + with patch(('homeassistant.components.alarm_control_panel.manual_mqtt.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + assert state.state == STATE_ALARM_TRIGGERED + def test_armed_home_with_specific_pending(self): """Test arm home method.""" self.assertTrue(setup_component( @@ -674,21 +1108,6 @@ class TestAlarmControlPanelManualMqtt(unittest.TestCase): entity_id = 'alarm_control_panel.test' - alarm_control_panel.alarm_arm_home(self.hass) - self.hass.block_till_done() - - self.assertEqual(STATE_ALARM_PENDING, - self.hass.states.get(entity_id).state) - - future = dt_util.utcnow() + timedelta(seconds=10) - with patch(('homeassistant.components.alarm_control_panel.manual_mqtt.' - 'dt_util.utcnow'), return_value=future): - fire_time_changed(self.hass, future) - self.hass.block_till_done() - - self.assertEqual(STATE_ALARM_ARMED_HOME, - self.hass.states.get(entity_id).state) - alarm_control_panel.alarm_trigger(self.hass) self.hass.block_till_done() @@ -710,9 +1129,124 @@ class TestAlarmControlPanelManualMqtt(unittest.TestCase): fire_time_changed(self.hass, future) self.hass.block_till_done() - self.assertEqual(STATE_ALARM_ARMED_HOME, + self.assertEqual(STATE_ALARM_DISARMED, self.hass.states.get(entity_id).state) + def test_arm_away_after_disabled_disarmed(self): + """Test pending state with and without zero trigger time.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual_mqtt', + 'name': 'test', + 'code': CODE, + 'pending_time': 0, + 'delay_time': 1, + 'armed_away': { + 'pending_time': 1, + }, + 'disarmed': { + 'trigger_time': 0 + }, + 'disarm_after_trigger': False, + 'command_topic': 'alarm/command', + 'state_topic': 'alarm/state', + }})) + + entity_id = 'alarm_control_panel.test' + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_arm_away(self.hass, CODE) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_PENDING, state.state) + self.assertEqual(STATE_ALARM_DISARMED, + state.attributes['pre_pending_state']) + self.assertEqual(STATE_ALARM_ARMED_AWAY, + state.attributes['post_pending_state']) + + alarm_control_panel.alarm_trigger(self.hass, entity_id=entity_id) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_PENDING, state.state) + self.assertEqual(STATE_ALARM_DISARMED, + state.attributes['pre_pending_state']) + self.assertEqual(STATE_ALARM_ARMED_AWAY, + state.attributes['post_pending_state']) + + future = dt_util.utcnow() + timedelta(seconds=1) + with patch(('homeassistant.components.alarm_control_panel.manual_mqtt.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_ARMED_AWAY, state.state) + + alarm_control_panel.alarm_trigger(self.hass, entity_id=entity_id) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_PENDING, state.state) + self.assertEqual(STATE_ALARM_ARMED_AWAY, + state.attributes['pre_pending_state']) + self.assertEqual(STATE_ALARM_TRIGGERED, + state.attributes['post_pending_state']) + + future += timedelta(seconds=1) + with patch(('homeassistant.components.alarm_control_panel.manual_mqtt.' + 'dt_util.utcnow'), return_value=future): + fire_time_changed(self.hass, future) + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_TRIGGERED, state.state) + + def test_disarm_with_template_code(self): + """Attempt to disarm with a valid or invalid template-based code.""" + self.assertTrue(setup_component( + self.hass, alarm_control_panel.DOMAIN, + {'alarm_control_panel': { + 'platform': 'manual_mqtt', + 'name': 'test', + 'code_template': + '{{ "" if from_state == "disarmed" else "abc" }}', + 'pending_time': 0, + 'disarm_after_trigger': False, + 'command_topic': 'alarm/command', + 'state_topic': 'alarm/state', + }})) + + entity_id = 'alarm_control_panel.test' + + self.hass.start() + self.hass.block_till_done() + + self.assertEqual(STATE_ALARM_DISARMED, + self.hass.states.get(entity_id).state) + + alarm_control_panel.alarm_arm_home(self.hass, 'def') + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_ARMED_HOME, state.state) + + alarm_control_panel.alarm_disarm(self.hass, 'def') + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_ARMED_HOME, state.state) + + alarm_control_panel.alarm_disarm(self.hass, 'abc') + self.hass.block_till_done() + + state = self.hass.states.get(entity_id) + self.assertEqual(STATE_ALARM_DISARMED, state.state) + def test_arm_home_via_command_topic(self): """Test arming home via command topic.""" assert setup_component(self.hass, alarm_control_panel.DOMAIN, { From 4390fed1686a4f6e3828ace4000f77be8ea12d37 Mon Sep 17 00:00:00 2001 From: Nicko van Someren Date: Sun, 3 Dec 2017 08:30:25 -0700 Subject: [PATCH 199/246] Unpacking RESTful sensor JSON results into attributes. (#10753) * Added support for extracting JSON attributes from RESTful values Setting the json_attributes configuration option to true on the RESTful sensor will cause the result of the REST request to be parsed as a JSON string and if successful the resulting dictionary will be used for the attributes of the sensor. * Added support for extracting JSON attributes from RESTful values Setting the json_attributes configuration option to true on the RESTful sensor will cause the result of the REST request to be parsed as a JSON string and if successful the resulting dictionary will be used for the attributes of the sensor. * Added requirement that RESTful JSON results used as attributes must be objects, not lists. * Expanded test coverage to test REFTful JSON attributes with and without a value template. * Added support for extracting JSON attributes from RESTful values Setting the json_attributes configuration option to true on the RESTful sensor will cause the result of the REST request to be parsed as a JSON string and if successful the resulting dictionary will be used for the attributes of the sensor. * Added requirement that RESTful JSON results used as attributes must be objects, not lists. * Expanded test coverage to test REFTful JSON attributes with and without a value template. * sensor.envirophat: add missing requirement (#7451) Adding requirements that is not explicitly pulled in by the library that manages the Enviro pHAT. * PyPI Openzwave (#7415) * Remove default zwave config path PYOZW now has much more comprehensive default handling for the config path (in src-lib/libopenzwave/libopenzwave.pyx:getConfig()). It looks in the same place we were looking, plus _many_ more. It will certainly do a much better job of finding the config files than we will (and will be updated as the library is changed, so we don't end up chasing it). The getConfig() method has been there for a while, but was subsntially improved recently. This change simply leaves the config_path as None if it is not specified, which will trigger the default handling in PYOZW. * Install python-openzwave from PyPI As of version 0.4, python-openzwave supports installation from PyPI, which means we can use our 'normal' dependency management tooling to install it. Yay. This uses the default 'embed' build (which goes and downloads statically sources to avoid having to compile anything locally). Check out the python-openzwave readme for more details. * Add python-openzwave deps to .travis.yml Python OpenZwave require the libudev headers to build. This adds the libudev-dev package to Travis runs via the 'apt' addon for Travis. Thanks to @MartinHjelmare for this fix. * Update docker build for PyPI openzwave Now that PYOZW can be install from PyPI, the docker image build process can be simplified to remove the explicit compilation of PYOZW. * Add datadog component (#7158) * Add datadog component * Improve test_invalid_config datadog test * Use assert_setup_component for test setup * Fix object type for default KNX port #7429 describes a TypeError that is raised if the port is omitted in the config for the KNX component (integer is required (got type str)). This commit changes the default port from a string to an integer. I expect this will resolve that issue... * Added support for extracting JSON attributes from RESTful values Setting the json_attributes configuration option to true on the RESTful sensor will cause the result of the REST request to be parsed as a JSON string and if successful the resulting dictionary will be used for the attributes of the sensor. * Added requirement that RESTful JSON results used as attributes must be objects, not lists. * Expanded test coverage to test REFTful JSON attributes with and without a value template. * Added support for extracting JSON attributes from RESTful values Setting the json_attributes configuration option to true on the RESTful sensor will cause the result of the REST request to be parsed as a JSON string and if successful the resulting dictionary will be used for the attributes of the sensor. * Added requirement that RESTful JSON results used as attributes must be objects, not lists. * Expanded test coverage to test REFTful JSON attributes with and without a value template. * Added support for extracting JSON attributes from RESTful values Setting the json_attributes configuration option to true on the RESTful sensor will cause the result of the REST request to be parsed as a JSON string and if successful the resulting dictionary will be used for the attributes of the sensor. * Added requirement that RESTful JSON results used as attributes must be objects, not lists. * Expanded test coverage to test REFTful JSON attributes with and without a value template. * Fixed breaks cause by manual upstream merge. * Added one extra blank line to make PyLint happy. * Switched json_attributes to be a list of keys rather than a boolean. The value of json_attributes can now be either a comma sepaated list of key names or a YAML list of key names. Only matching keys in a retuned JSON dictionary will be mapped to sensor attributes. Updated test cases to handle json_attributes being a list. Also fixed two minor issues arrising from manual merge with 0.58 master. * Added an explicit default value to the json_attributes config entry. * Removed self.update() from __init__() body. * Expended unit tests for error cases of json_attributes processing. * Align quotes --- homeassistant/components/sensor/rest.py | 32 ++++++++++++- tests/components/sensor/test_rest.py | 60 ++++++++++++++++++++++--- 2 files changed, 85 insertions(+), 7 deletions(-) diff --git a/homeassistant/components/sensor/rest.py b/homeassistant/components/sensor/rest.py index 2ae1c3674ea..86362e8f2d9 100644 --- a/homeassistant/components/sensor/rest.py +++ b/homeassistant/components/sensor/rest.py @@ -5,6 +5,7 @@ For more details about this platform, please refer to the documentation at https://home-assistant.io/components/sensor.rest/ """ import logging +import json import voluptuous as vol import requests @@ -25,6 +26,7 @@ DEFAULT_METHOD = 'GET' DEFAULT_NAME = 'REST Sensor' DEFAULT_VERIFY_SSL = True +CONF_JSON_ATTRS = 'json_attributes' METHODS = ['POST', 'GET'] PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ @@ -32,6 +34,7 @@ PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Optional(CONF_AUTHENTICATION): vol.In([HTTP_BASIC_AUTHENTICATION, HTTP_DIGEST_AUTHENTICATION]), vol.Optional(CONF_HEADERS): {cv.string: cv.string}, + vol.Optional(CONF_JSON_ATTRS, default=[]): cv.ensure_list_csv, vol.Optional(CONF_METHOD, default=DEFAULT_METHOD): vol.In(METHODS), vol.Optional(CONF_NAME, default=DEFAULT_NAME): cv.string, vol.Optional(CONF_PASSWORD): cv.string, @@ -55,6 +58,8 @@ def setup_platform(hass, config, add_devices, discovery_info=None): headers = config.get(CONF_HEADERS) unit = config.get(CONF_UNIT_OF_MEASUREMENT) value_template = config.get(CONF_VALUE_TEMPLATE) + json_attrs = config.get(CONF_JSON_ATTRS) + if value_template is not None: value_template.hass = hass @@ -68,13 +73,15 @@ def setup_platform(hass, config, add_devices, discovery_info=None): rest = RestData(method, resource, auth, headers, payload, verify_ssl) rest.update() - add_devices([RestSensor(hass, rest, name, unit, value_template)], True) + add_devices([RestSensor( + hass, rest, name, unit, value_template, json_attrs)], True) class RestSensor(Entity): """Implementation of a REST sensor.""" - def __init__(self, hass, rest, name, unit_of_measurement, value_template): + def __init__(self, hass, rest, name, + unit_of_measurement, value_template, json_attrs): """Initialize the REST sensor.""" self._hass = hass self.rest = rest @@ -82,6 +89,8 @@ class RestSensor(Entity): self._state = STATE_UNKNOWN self._unit_of_measurement = unit_of_measurement self._value_template = value_template + self._json_attrs = json_attrs + self._attributes = None @property def name(self): @@ -108,6 +117,20 @@ class RestSensor(Entity): self.rest.update() value = self.rest.data + if self._json_attrs: + self._attributes = {} + try: + json_dict = json.loads(value) + if isinstance(json_dict, dict): + attrs = {k: json_dict[k] for k in self._json_attrs + if k in json_dict} + self._attributes = attrs + else: + _LOGGER.warning("JSON result was not a dictionary") + except ValueError: + _LOGGER.warning("REST result could not be parsed as JSON") + _LOGGER.debug("Erroneous JSON: %s", value) + if value is None: value = STATE_UNKNOWN elif self._value_template is not None: @@ -116,6 +139,11 @@ class RestSensor(Entity): self._state = value + @property + def device_state_attributes(self): + """Return the state attributes.""" + return self._attributes + class RestData(object): """Class for handling the data retrieval.""" diff --git a/tests/components/sensor/test_rest.py b/tests/components/sensor/test_rest.py index a083dbfb1a2..1bda8ab82f3 100644 --- a/tests/components/sensor/test_rest.py +++ b/tests/components/sensor/test_rest.py @@ -133,9 +133,9 @@ class TestRestSensor(unittest.TestCase): self.value_template = template('{{ value_json.key }}') self.value_template.hass = self.hass - self.sensor = rest.RestSensor( - self.hass, self.rest, self.name, self.unit_of_measurement, - self.value_template) + self.sensor = rest.RestSensor(self.hass, self.rest, self.name, + self.unit_of_measurement, + self.value_template, []) def tearDown(self): """Stop everything that was started.""" @@ -181,12 +181,62 @@ class TestRestSensor(unittest.TestCase): self.rest.update = Mock('rest.RestData.update', side_effect=self.update_side_effect( 'plain_state')) - self.sensor = rest.RestSensor( - self.hass, self.rest, self.name, self.unit_of_measurement, None) + self.sensor = rest.RestSensor(self.hass, self.rest, self.name, + self.unit_of_measurement, None, []) self.sensor.update() self.assertEqual('plain_state', self.sensor.state) self.assertTrue(self.sensor.available) + def test_update_with_json_attrs(self): + """Test attributes get extracted from a JSON result.""" + self.rest.update = Mock('rest.RestData.update', + side_effect=self.update_side_effect( + '{ "key": "some_json_value" }')) + self.sensor = rest.RestSensor(self.hass, self.rest, self.name, + self.unit_of_measurement, None, ['key']) + self.sensor.update() + self.assertEqual('some_json_value', + self.sensor.device_state_attributes['key']) + + @patch('homeassistant.components.sensor.rest._LOGGER') + def test_update_with_json_attrs_not_dict(self, mock_logger): + """Test attributes get extracted from a JSON result.""" + self.rest.update = Mock('rest.RestData.update', + side_effect=self.update_side_effect( + '["list", "of", "things"]')) + self.sensor = rest.RestSensor(self.hass, self.rest, self.name, + self.unit_of_measurement, None, ['key']) + self.sensor.update() + self.assertEqual({}, self.sensor.device_state_attributes) + self.assertTrue(mock_logger.warning.called) + + @patch('homeassistant.components.sensor.rest._LOGGER') + def test_update_with_json_attrs_bad_JSON(self, mock_logger): + """Test attributes get extracted from a JSON result.""" + self.rest.update = Mock('rest.RestData.update', + side_effect=self.update_side_effect( + 'This is text rather than JSON data.')) + self.sensor = rest.RestSensor(self.hass, self.rest, self.name, + self.unit_of_measurement, None, ['key']) + self.sensor.update() + self.assertEqual({}, self.sensor.device_state_attributes) + self.assertTrue(mock_logger.warning.called) + self.assertTrue(mock_logger.debug.called) + + def test_update_with_json_attrs_and_template(self): + """Test attributes get extracted from a JSON result.""" + self.rest.update = Mock('rest.RestData.update', + side_effect=self.update_side_effect( + '{ "key": "json_state_updated_value" }')) + self.sensor = rest.RestSensor(self.hass, self.rest, self.name, + self.unit_of_measurement, + self.value_template, ['key']) + self.sensor.update() + + self.assertEqual('json_state_updated_value', self.sensor.state) + self.assertEqual('json_state_updated_value', + self.sensor.device_state_attributes['key']) + class TestRestData(unittest.TestCase): """Tests for RestData.""" From fce994ea7658f1e025a03c70d23387bb863f5978 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sun, 3 Dec 2017 16:47:21 +0100 Subject: [PATCH 200/246] Bump dev to 0.60.0.dev0 (#10912) --- homeassistant/const.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/const.py b/homeassistant/const.py index 9d394bb4a99..85047f0482e 100644 --- a/homeassistant/const.py +++ b/homeassistant/const.py @@ -1,8 +1,8 @@ # coding: utf-8 """Constants used by Home Assistant components.""" MAJOR_VERSION = 0 -MINOR_VERSION = 59 -PATCH_VERSION = '0' +MINOR_VERSION = 60 +PATCH_VERSION = '0.dev0' __short_version__ = '{}.{}'.format(MAJOR_VERSION, MINOR_VERSION) __version__ = '{}.{}'.format(__short_version__, PATCH_VERSION) REQUIRED_PYTHON_VER = (3, 4, 2) From 8ceaa72ba31c950c40d2fb4a3c3b7fd9924454aa Mon Sep 17 00:00:00 2001 From: Erik Eriksson Date: Sun, 3 Dec 2017 16:48:07 +0100 Subject: [PATCH 201/246] Update eliqonline.py (#10914) Channel id is now required (change in API) --- homeassistant/components/sensor/eliqonline.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/homeassistant/components/sensor/eliqonline.py b/homeassistant/components/sensor/eliqonline.py index dc879fe0d3e..3e736ed719f 100644 --- a/homeassistant/components/sensor/eliqonline.py +++ b/homeassistant/components/sensor/eliqonline.py @@ -30,7 +30,7 @@ UNIT_OF_MEASUREMENT = 'W' PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Required(CONF_ACCESS_TOKEN): cv.string, - vol.Optional(CONF_CHANNEL_ID): cv.positive_int, + vol.Required(CONF_CHANNEL_ID): cv.positive_int, vol.Optional(CONF_NAME, default=DEFAULT_NAME): cv.string, }) From 9e82433a3e78dac7700df4d330e251610e84548f Mon Sep 17 00:00:00 2001 From: Ludovico de Nittis Date: Sun, 3 Dec 2017 16:48:12 +0100 Subject: [PATCH 202/246] Add iAlarm support (#10878) * Add iAlarm support * Minor fixes to iAlarm * Rename ialarmpanel to ialarm and add a check for the host value * corrections in the value validation of ialarm * add a missing period on ialarm --- .coveragerc | 1 + .../components/alarm_control_panel/ialarm.py | 107 ++++++++++++++++++ requirements_all.txt | 3 + 3 files changed, 111 insertions(+) create mode 100644 homeassistant/components/alarm_control_panel/ialarm.py diff --git a/.coveragerc b/.coveragerc index b091b376579..0f95db71ec7 100644 --- a/.coveragerc +++ b/.coveragerc @@ -263,6 +263,7 @@ omit = homeassistant/components/alarm_control_panel/alarmdotcom.py homeassistant/components/alarm_control_panel/concord232.py homeassistant/components/alarm_control_panel/egardia.py + homeassistant/components/alarm_control_panel/ialarm.py homeassistant/components/alarm_control_panel/manual_mqtt.py homeassistant/components/alarm_control_panel/nx584.py homeassistant/components/alarm_control_panel/simplisafe.py diff --git a/homeassistant/components/alarm_control_panel/ialarm.py b/homeassistant/components/alarm_control_panel/ialarm.py new file mode 100644 index 00000000000..3fb6e2dcb90 --- /dev/null +++ b/homeassistant/components/alarm_control_panel/ialarm.py @@ -0,0 +1,107 @@ +""" +Interfaces with iAlarm control panels. + +For more details about this platform, please refer to the documentation at +https://home-assistant.io/components/alarm_control_panel.ialarm/ +""" +import logging + +import voluptuous as vol + +import homeassistant.helpers.config_validation as cv +import homeassistant.components.alarm_control_panel as alarm +from homeassistant.components.alarm_control_panel import PLATFORM_SCHEMA +from homeassistant.const import ( + CONF_PASSWORD, CONF_USERNAME, CONF_HOST, STATE_ALARM_ARMED_AWAY, + STATE_ALARM_ARMED_HOME, STATE_ALARM_DISARMED, CONF_NAME) + +REQUIREMENTS = ['pyialarm==0.2'] + +_LOGGER = logging.getLogger(__name__) + +DEFAULT_NAME = 'iAlarm' + + +def no_application_protocol(value): + """Validate that value is without the application protocol.""" + protocol_separator = "://" + if not value or protocol_separator in value: + raise vol.Invalid( + 'Invalid host, {} is not allowed'.format(protocol_separator)) + + return value + + +PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ + vol.Required(CONF_PASSWORD): cv.string, + vol.Required(CONF_USERNAME): cv.string, + vol.Required(CONF_HOST): vol.All(cv.string, no_application_protocol), + vol.Optional(CONF_NAME, default=DEFAULT_NAME): cv.string, +}) + + +def setup_platform(hass, config, add_devices, discovery_info=None): + """Set up an iAlarm control panel.""" + name = config.get(CONF_NAME) + username = config.get(CONF_USERNAME) + password = config.get(CONF_PASSWORD) + host = config.get(CONF_HOST) + + url = 'http://{}'.format(host) + ialarm = IAlarmPanel(name, username, password, url) + add_devices([ialarm], True) + + +class IAlarmPanel(alarm.AlarmControlPanel): + """Represent an iAlarm status.""" + + def __init__(self, name, username, password, url): + """Initialize the iAlarm status.""" + from pyialarm import IAlarm + + self._name = name + self._username = username + self._password = password + self._url = url + self._state = None + self._client = IAlarm(username, password, url) + + @property + def name(self): + """Return the name of the device.""" + return self._name + + @property + def state(self): + """Return the state of the device.""" + return self._state + + def update(self): + """Return the state of the device.""" + status = self._client.get_status() + _LOGGER.debug('iAlarm status: %s', status) + if status: + status = int(status) + + if status == self._client.DISARMED: + state = STATE_ALARM_DISARMED + elif status == self._client.ARMED_AWAY: + state = STATE_ALARM_ARMED_AWAY + elif status == self._client.ARMED_STAY: + state = STATE_ALARM_ARMED_HOME + else: + state = None + + self._state = state + + def alarm_disarm(self, code=None): + """Send disarm command.""" + self._client.disarm() + + def alarm_arm_away(self, code=None): + """Send arm away command.""" + self._client.arm_away() + + def alarm_arm_home(self, code=None): + """Send arm home command.""" + self._client.arm_stay() diff --git a/requirements_all.txt b/requirements_all.txt index 42f9d175377..3b96c8557f1 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -682,6 +682,9 @@ pyhomematic==0.1.35 # homeassistant.components.sensor.hydroquebec pyhydroquebec==1.3.1 +# homeassistant.components.alarm_control_panel.ialarm +pyialarm==0.2 + # homeassistant.components.device_tracker.icloud pyicloud==0.9.1 From 6b410d80768ab814013a691b5b2a2564a4bccbaf Mon Sep 17 00:00:00 2001 From: Touliloup Date: Sun, 3 Dec 2017 18:34:45 +0100 Subject: [PATCH 203/246] Correction of Samsung Power OFF behaviour (#10907) * Correction of Samsung Power OFF behaviour Addition of a delay after powering OFF a Samsung TV, this avoid status update from powering the TV back ON. Deletion of update() return statement, return value not used. * Rename self._end_of_power_off_command into self._end_of_power_off * Removal of unused line break in Samsung TV component --- .../components/media_player/samsungtv.py | 22 +++++++++++++++---- 1 file changed, 18 insertions(+), 4 deletions(-) diff --git a/homeassistant/components/media_player/samsungtv.py b/homeassistant/components/media_player/samsungtv.py index 0153eb687ff..721b095c083 100644 --- a/homeassistant/components/media_player/samsungtv.py +++ b/homeassistant/components/media_player/samsungtv.py @@ -6,6 +6,7 @@ https://home-assistant.io/components/media_player.samsungtv/ """ import logging import socket +from datetime import timedelta import voluptuous as vol @@ -17,6 +18,7 @@ from homeassistant.const import ( CONF_HOST, CONF_NAME, STATE_OFF, STATE_ON, STATE_UNKNOWN, CONF_PORT, CONF_MAC) import homeassistant.helpers.config_validation as cv +from homeassistant.util import dt as dt_util REQUIREMENTS = ['samsungctl==0.6.0', 'wakeonlan==0.2.2'] @@ -100,6 +102,9 @@ class SamsungTVDevice(MediaPlayerDevice): self._playing = True self._state = STATE_UNKNOWN self._remote = None + # Mark the end of a shutdown command (need to wait 15 seconds before + # sending the next command to avoid turning the TV back ON). + self._end_of_power_off = None # Generate a configuration for the Samsung library self._config = { 'name': 'HomeAssistant', @@ -118,7 +123,7 @@ class SamsungTVDevice(MediaPlayerDevice): def update(self): """Retrieve the latest data.""" # Send an empty key to see if we are still connected - return self.send_key('KEY') + self.send_key('KEY') def get_remote(self): """Create or return a remote control instance.""" @@ -130,6 +135,10 @@ class SamsungTVDevice(MediaPlayerDevice): def send_key(self, key): """Send a key to the tv and handles exceptions.""" + if self._power_off_in_progress() \ + and not (key == 'KEY_POWER' or key == 'KEY_POWEROFF'): + _LOGGER.info("TV is powering off, not sending command: %s", key) + return try: self.get_remote().control(key) self._state = STATE_ON @@ -139,13 +148,16 @@ class SamsungTVDevice(MediaPlayerDevice): # BrokenPipe can occur when the commands is sent to fast self._state = STATE_ON self._remote = None - return False + return except (self._exceptions_class.ConnectionClosed, OSError): self._state = STATE_OFF self._remote = None - return False + if self._power_off_in_progress(): + self._state = STATE_OFF - return True + def _power_off_in_progress(self): + return self._end_of_power_off is not None and \ + self._end_of_power_off > dt_util.utcnow() @property def name(self): @@ -171,6 +183,8 @@ class SamsungTVDevice(MediaPlayerDevice): def turn_off(self): """Turn off media player.""" + self._end_of_power_off = dt_util.utcnow() + timedelta(seconds=15) + if self._config['method'] == 'websocket': self.send_key('KEY_POWER') else: From 9577525b0b0b675481c3581437ca51a136129038 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sun, 3 Dec 2017 21:34:59 +0100 Subject: [PATCH 204/246] Add Alpha Vantage sensor (#10873) * Add Alpha Vantage sensor * Remove data object * Remove unused vars and change return * Fix typo --- .coveragerc | 3 +- .../components/sensor/alpha_vantage.py | 110 ++++++++++++++++++ requirements_all.txt | 3 + 3 files changed, 115 insertions(+), 1 deletion(-) create mode 100644 homeassistant/components/sensor/alpha_vantage.py diff --git a/.coveragerc b/.coveragerc index 0f95db71ec7..2af48f0abb0 100644 --- a/.coveragerc +++ b/.coveragerc @@ -473,6 +473,7 @@ omit = homeassistant/components/scene/hunterdouglas_powerview.py homeassistant/components/scene/lifx_cloud.py homeassistant/components/sensor/airvisual.py + homeassistant/components/sensor/alpha_vantage.py homeassistant/components/sensor/arest.py homeassistant/components/sensor/arwn.py homeassistant/components/sensor/bbox.py @@ -483,8 +484,8 @@ omit = homeassistant/components/sensor/bom.py homeassistant/components/sensor/broadlink.py homeassistant/components/sensor/buienradar.py - homeassistant/components/sensor/citybikes.py homeassistant/components/sensor/cert_expiry.py + homeassistant/components/sensor/citybikes.py homeassistant/components/sensor/comed_hourly_pricing.py homeassistant/components/sensor/cpuspeed.py homeassistant/components/sensor/crimereports.py diff --git a/homeassistant/components/sensor/alpha_vantage.py b/homeassistant/components/sensor/alpha_vantage.py new file mode 100644 index 00000000000..88ead3301b6 --- /dev/null +++ b/homeassistant/components/sensor/alpha_vantage.py @@ -0,0 +1,110 @@ +""" +Stock market information from Alpha Vantage. + +For more details about this platform, please refer to the documentation at +https://home-assistant.io/components/sensor.alpha_vantage/ +""" +from datetime import timedelta +import logging + +import voluptuous as vol + +from homeassistant.components.sensor import PLATFORM_SCHEMA +from homeassistant.const import ATTR_ATTRIBUTION, CONF_API_KEY +import homeassistant.helpers.config_validation as cv +from homeassistant.helpers.entity import Entity + +REQUIREMENTS = ['alpha_vantage==1.3.6'] + +_LOGGER = logging.getLogger(__name__) + +ATTR_CLOSE = 'close' +ATTR_HIGH = 'high' +ATTR_LOW = 'low' +ATTR_VOLUME = 'volume' + +CONF_ATTRIBUTION = "Stock market information provided by Alpha Vantage." +CONF_SYMBOLS = 'symbols' + +DEFAULT_SYMBOL = 'GOOGL' + +ICON = 'mdi:currency-usd' + +SCAN_INTERVAL = timedelta(minutes=5) + +PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ + vol.Required(CONF_API_KEY): cv.string, + vol.Optional(CONF_SYMBOLS, default=[DEFAULT_SYMBOL]): + vol.All(cv.ensure_list, [cv.string]), +}) + + +def setup_platform(hass, config, add_devices, discovery_info=None): + """Set up the Alpha Vantage sensor.""" + from alpha_vantage.timeseries import TimeSeries + + api_key = config.get(CONF_API_KEY) + symbols = config.get(CONF_SYMBOLS) + + timeseries = TimeSeries(key=api_key) + + dev = [] + for symbol in symbols: + try: + timeseries.get_intraday(symbol) + except ValueError: + _LOGGER.error( + "API Key is not valid or symbol '%s' not known", symbol) + return + dev.append(AlphaVantageSensor(timeseries, symbol)) + + add_devices(dev, True) + + +class AlphaVantageSensor(Entity): + """Representation of a Alpha Vantage sensor.""" + + def __init__(self, timeseries, symbol): + """Initialize the sensor.""" + self._name = symbol + self._timeseries = timeseries + self._symbol = symbol + self.values = None + self._unit_of_measurement = None + + @property + def name(self): + """Return the name of the sensor.""" + return self._name + + @property + def unit_of_measurement(self): + """Return the unit of measurement of this entity, if any.""" + return self._symbol + + @property + def state(self): + """Return the state of the sensor.""" + return self.values['1. open'] + + @property + def device_state_attributes(self): + """Return the state attributes.""" + if self.values is not None: + return { + ATTR_ATTRIBUTION: CONF_ATTRIBUTION, + ATTR_CLOSE: self.values['4. close'], + ATTR_HIGH: self.values['2. high'], + ATTR_LOW: self.values['3. low'], + ATTR_VOLUME: self.values['5. volume'], + } + + @property + def icon(self): + """Return the icon to use in the frontend, if any.""" + return ICON + + def update(self): + """Get the latest data and updates the states.""" + all_values, _ = self._timeseries.get_intraday(self._symbol) + self.values = next(iter(all_values.values())) diff --git a/requirements_all.txt b/requirements_all.txt index 3b96c8557f1..4ce775ab2f3 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -83,6 +83,9 @@ aiopvapi==1.5.4 # homeassistant.components.alarmdecoder alarmdecoder==0.12.3 +# homeassistant.components.sensor.alpha_vantage +alpha_vantage==1.3.6 + # homeassistant.components.amcrest amcrest==1.2.1 From 3a246df5447191d2531075ca0d2c9cc17ef53a47 Mon Sep 17 00:00:00 2001 From: Oliver Date: Sun, 3 Dec 2017 21:51:32 +0100 Subject: [PATCH 205/246] Don't repeat getting receiver name on each update / pushed to denonavr 0.5.5 (#10915) --- homeassistant/components/media_player/denonavr.py | 13 ++++++------- requirements_all.txt | 2 +- 2 files changed, 7 insertions(+), 8 deletions(-) diff --git a/homeassistant/components/media_player/denonavr.py b/homeassistant/components/media_player/denonavr.py index 7fffc09696c..0a03af0e1bf 100644 --- a/homeassistant/components/media_player/denonavr.py +++ b/homeassistant/components/media_player/denonavr.py @@ -20,7 +20,7 @@ from homeassistant.const import ( CONF_NAME, STATE_ON, CONF_ZONE, CONF_TIMEOUT) import homeassistant.helpers.config_validation as cv -REQUIREMENTS = ['denonavr==0.5.4'] +REQUIREMENTS = ['denonavr==0.5.5'] _LOGGER = logging.getLogger(__name__) @@ -102,12 +102,11 @@ def setup_platform(hass, config, add_devices, discovery_info=None): if config.get(CONF_HOST) is None and discovery_info is None: d_receivers = denonavr.discover() # More than one receiver could be discovered by that method - if d_receivers is not None: - for d_receiver in d_receivers: - host = d_receiver["host"] - name = d_receiver["friendlyName"] - new_hosts.append( - NewHost(host=host, name=name)) + for d_receiver in d_receivers: + host = d_receiver["host"] + name = d_receiver["friendlyName"] + new_hosts.append( + NewHost(host=host, name=name)) for entry in new_hosts: # Check if host not in cache, append it and save for later diff --git a/requirements_all.txt b/requirements_all.txt index 4ce775ab2f3..218f1796efd 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -200,7 +200,7 @@ defusedxml==0.5.0 deluge-client==1.0.5 # homeassistant.components.media_player.denonavr -denonavr==0.5.4 +denonavr==0.5.5 # homeassistant.components.media_player.directv directpy==0.2 From 879e32f670e2354813667173a328dca6a79a8f5c Mon Sep 17 00:00:00 2001 From: Brent Hughes Date: Sun, 3 Dec 2017 16:39:54 -0600 Subject: [PATCH 206/246] Add Min and Event Count Metrics To Prometheus (#10530) * Added min and Events sensor types to prometheus * Updated prometheus client and fixed invalid swith state * Added metric to count number of times an automation is triggered * Removed assumption that may not apply to everybody * Fixed tests * Updated requirements_test_all * Fixed unit tests --- homeassistant/components/prometheus.py | 27 +++++++++++++++++++++++--- requirements_all.txt | 2 +- requirements_test_all.txt | 2 +- tests/components/test_prometheus.py | 4 +++- 4 files changed, 29 insertions(+), 6 deletions(-) diff --git a/homeassistant/components/prometheus.py b/homeassistant/components/prometheus.py index 0396cafd4ff..0195021829b 100644 --- a/homeassistant/components/prometheus.py +++ b/homeassistant/components/prometheus.py @@ -19,7 +19,7 @@ from homeassistant import core as hacore from homeassistant.helpers import state as state_helper from homeassistant.util.temperature import fahrenheit_to_celsius -REQUIREMENTS = ['prometheus_client==0.0.19'] +REQUIREMENTS = ['prometheus_client==0.0.21'] _LOGGER = logging.getLogger(__name__) @@ -189,6 +189,14 @@ class Metrics(object): 'electricity_usage_w', self.prometheus_client.Gauge, 'Currently reported electricity draw in Watts', ), + 'min': ( + 'sensor_min', self.prometheus_client.Gauge, + 'Time in minutes reported by a sensor' + ), + 'Events': ( + 'sensor_event_count', self.prometheus_client.Gauge, + 'Number of events for a sensor' + ), } unit = state.attributes.get('unit_of_measurement') @@ -212,12 +220,25 @@ class Metrics(object): self.prometheus_client.Gauge, 'State of the switch (0/1)', ) - value = state_helper.state_as_number(state) - metric.labels(**self._labels(state)).set(value) + + try: + value = state_helper.state_as_number(state) + metric.labels(**self._labels(state)).set(value) + except ValueError: + pass def _handle_zwave(self, state): self._battery(state) + def _handle_automation(self, state): + metric = self._metric( + 'automation_triggered_count', + self.prometheus_client.Counter, + 'Count of times an automation has been triggered', + ) + + metric.labels(**self._labels(state)).inc() + class PrometheusView(HomeAssistantView): """Handle Prometheus requests.""" diff --git a/requirements_all.txt b/requirements_all.txt index 218f1796efd..309da835c3b 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -560,7 +560,7 @@ pocketcasts==0.1 proliphix==0.4.1 # homeassistant.components.prometheus -prometheus_client==0.0.19 +prometheus_client==0.0.21 # homeassistant.components.sensor.systemmonitor psutil==5.4.1 diff --git a/requirements_test_all.txt b/requirements_test_all.txt index b02d80ad0e3..7a33e9b4dd0 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -113,7 +113,7 @@ pilight==0.1.1 pmsensor==0.4 # homeassistant.components.prometheus -prometheus_client==0.0.19 +prometheus_client==0.0.21 # homeassistant.components.zwave pydispatcher==2.0.5 diff --git a/tests/components/test_prometheus.py b/tests/components/test_prometheus.py index dd8cbfe55e0..052292b015d 100644 --- a/tests/components/test_prometheus.py +++ b/tests/components/test_prometheus.py @@ -30,4 +30,6 @@ def test_view(prometheus_client): # pylint: disable=redefined-outer-name assert len(body) > 3 # At least two comment lines and a metric for line in body: if line: - assert line.startswith('# ') or line.startswith('process_') + assert line.startswith('# ') \ + or line.startswith('process_') \ + or line.startswith('python_info') From 6776e942d7b3cc414621917c620f92ce441988c2 Mon Sep 17 00:00:00 2001 From: Will Boyce Date: Sun, 3 Dec 2017 22:59:22 +0000 Subject: [PATCH 207/246] fix ios component config generation (#10923) Fixes: #19020 --- homeassistant/components/ios.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/homeassistant/components/ios.py b/homeassistant/components/ios.py index cfa1693f571..ebabcdb0e79 100644 --- a/homeassistant/components/ios.py +++ b/homeassistant/components/ios.py @@ -264,7 +264,7 @@ class iOSIdentifyDeviceView(HomeAssistantView): # return self.json_message(humanize_error(request.json, ex), # HTTP_BAD_REQUEST) - data[ATTR_LAST_SEEN_AT] = datetime.datetime.now() + data[ATTR_LAST_SEEN_AT] = datetime.datetime.now().isoformat() name = data.get(ATTR_DEVICE_ID) From 0d6c95ac44c7cf6eb6eaea821b1e226a6bcef7ef Mon Sep 17 00:00:00 2001 From: Daniel Perna Date: Mon, 4 Dec 2017 00:08:10 +0100 Subject: [PATCH 208/246] Fix Notifications for Android TV (#10798) * Fixed icon path, added dynamic icon * Addressing requested changes * Using DEFAULT_ICON * Using CONF_ICON from const * Getting hass_frontend path via import * Lint * Using embedded 1px transparent icon * woof -.- * Lint --- homeassistant/components/notify/nfandroidtv.py | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/homeassistant/components/notify/nfandroidtv.py b/homeassistant/components/notify/nfandroidtv.py index 6c4f7e49dde..1fa8f1dab78 100644 --- a/homeassistant/components/notify/nfandroidtv.py +++ b/homeassistant/components/notify/nfandroidtv.py @@ -4,8 +4,9 @@ Notifications for Android TV notification service. For more details about this platform, please refer to the documentation at https://home-assistant.io/components/notify.nfandroidtv/ """ -import os import logging +import io +import base64 import requests import voluptuous as vol @@ -31,6 +32,9 @@ DEFAULT_TRANSPARENCY = 'default' DEFAULT_COLOR = 'grey' DEFAULT_INTERRUPT = False DEFAULT_TIMEOUT = 5 +DEFAULT_ICON = ( + 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR4nGP6zwAAAgcBApo' + 'cMXEAAAAASUVORK5CYII=') ATTR_DURATION = 'duration' ATTR_POSITION = 'position' @@ -110,16 +114,13 @@ class NFAndroidTVNotificationService(BaseNotificationService): self._default_color = color self._default_interrupt = interrupt self._timeout = timeout - self._icon_file = os.path.join( - os.path.dirname(__file__), '..', 'frontend', 'www_static', 'icons', - 'favicon-192x192.png') + self._icon_file = io.BytesIO(base64.b64decode(DEFAULT_ICON)) def send_message(self, message="", **kwargs): """Send a message to a Android TV device.""" _LOGGER.debug("Sending notification to: %s", self._target) - payload = dict(filename=('icon.png', - open(self._icon_file, 'rb'), + payload = dict(filename=('icon.png', self._icon_file, 'application/octet-stream', {'Expires': '0'}), type='0', title=kwargs.get(ATTR_TITLE, ATTR_TITLE_DEFAULT), @@ -129,7 +130,7 @@ class NFAndroidTVNotificationService(BaseNotificationService): transparency='%i' % TRANSPARENCIES.get( self._default_transparency), offset='0', app=ATTR_TITLE_DEFAULT, force='true', - interrupt='%i' % self._default_interrupt) + interrupt='%i' % self._default_interrupt,) data = kwargs.get(ATTR_DATA) if data: From 0c43466225a4d4adde4bafb830b6bfa6000695b1 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sun, 3 Dec 2017 16:42:18 -0800 Subject: [PATCH 209/246] Update coveragerc (#10931) * Sort coveragerc * Add climate.honeywell and vacuum.xiaomi_miio to coveragerc --- .coveragerc | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/.coveragerc b/.coveragerc index 2af48f0abb0..4f23fd9d8bf 100644 --- a/.coveragerc +++ b/.coveragerc @@ -285,9 +285,9 @@ omit = homeassistant/components/camera/ffmpeg.py homeassistant/components/camera/foscam.py homeassistant/components/camera/mjpeg.py - homeassistant/components/camera/rpi_camera.py homeassistant/components/camera/onvif.py homeassistant/components/camera/ring.py + homeassistant/components/camera/rpi_camera.py homeassistant/components/camera/synology.py homeassistant/components/camera/yi.py homeassistant/components/climate/ephember.py @@ -295,6 +295,7 @@ omit = homeassistant/components/climate/flexit.py homeassistant/components/climate/heatmiser.py homeassistant/components/climate/homematic.py + homeassistant/components/climate/honeywell.py homeassistant/components/climate/knx.py homeassistant/components/climate/oem.py homeassistant/components/climate/proliphix.py @@ -332,10 +333,10 @@ omit = homeassistant/components/device_tracker/sky_hub.py homeassistant/components/device_tracker/snmp.py homeassistant/components/device_tracker/swisscom.py - homeassistant/components/device_tracker/thomson.py - homeassistant/components/device_tracker/tomato.py homeassistant/components/device_tracker/tado.py + homeassistant/components/device_tracker/thomson.py homeassistant/components/device_tracker/tile.py + homeassistant/components/device_tracker/tomato.py homeassistant/components/device_tracker/tplink.py homeassistant/components/device_tracker/trackr.py homeassistant/components/device_tracker/ubus.py @@ -353,8 +354,8 @@ omit = homeassistant/components/keyboard.py homeassistant/components/keyboard_remote.py homeassistant/components/light/avion.py - homeassistant/components/light/blinkt.py homeassistant/components/light/blinksticklight.py + homeassistant/components/light/blinkt.py homeassistant/components/light/decora.py homeassistant/components/light/decora_wifi.py homeassistant/components/light/flux_led.py @@ -365,8 +366,8 @@ omit = homeassistant/components/light/limitlessled.py homeassistant/components/light/mystrom.py homeassistant/components/light/osramlightify.py - homeassistant/components/light/rpi_gpio_pwm.py homeassistant/components/light/piglow.py + homeassistant/components/light/rpi_gpio_pwm.py homeassistant/components/light/sensehat.py homeassistant/components/light/tikteck.py homeassistant/components/light/tplink.py @@ -377,9 +378,9 @@ omit = homeassistant/components/light/yeelightsunflower.py homeassistant/components/light/zengge.py homeassistant/components/lirc.py + homeassistant/components/lock/lockitron.py homeassistant/components/lock/nello.py homeassistant/components/lock/nuki.py - homeassistant/components/lock/lockitron.py homeassistant/components/lock/sesame.py homeassistant/components/media_extractor.py homeassistant/components/media_player/anthemav.py @@ -623,8 +624,8 @@ omit = homeassistant/components/switch/rest.py homeassistant/components/switch/rpi_rf.py homeassistant/components/switch/snmp.py - homeassistant/components/switch/tplink.py homeassistant/components/switch/telnet.py + homeassistant/components/switch/tplink.py homeassistant/components/switch/transmission.py homeassistant/components/switch/xiaomi_miio.py homeassistant/components/telegram_bot/* @@ -633,7 +634,9 @@ omit = homeassistant/components/tts/baidu.py homeassistant/components/tts/microsoft.py homeassistant/components/tts/picotts.py + homeassistant/components/vacuum/mqtt.py homeassistant/components/vacuum/roomba.py + homeassistant/components/vacuum/xiaomi_miio.py homeassistant/components/weather/bom.py homeassistant/components/weather/buienradar.py homeassistant/components/weather/metoffice.py @@ -642,7 +645,6 @@ omit = homeassistant/components/weather/zamg.py homeassistant/components/zeroconf.py homeassistant/components/zwave/util.py - homeassistant/components/vacuum/mqtt.py [report] # Regexes for lines to exclude from consideration From 29fad3fa3ccd24d6b02efd29fc85aac1a45e609c Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sun, 3 Dec 2017 17:59:58 -0800 Subject: [PATCH 210/246] Update frontend to 20171204.0 (#10934) --- homeassistant/components/frontend/__init__.py | 2 +- requirements_all.txt | 2 +- requirements_test_all.txt | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index b71a6508049..e1121fd0c4e 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -23,7 +23,7 @@ from homeassistant.const import CONF_NAME, EVENT_THEMES_UPDATED from homeassistant.core import callback from homeassistant.loader import bind_hass -REQUIREMENTS = ['home-assistant-frontend==20171130.0', 'user-agents==1.1.0'] +REQUIREMENTS = ['home-assistant-frontend==20171204.0', 'user-agents==1.1.0'] DOMAIN = 'frontend' DEPENDENCIES = ['api', 'websocket_api', 'http', 'system_log'] diff --git a/requirements_all.txt b/requirements_all.txt index 309da835c3b..da2290ddcb2 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -334,7 +334,7 @@ hipnotify==1.0.8 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171130.0 +home-assistant-frontend==20171204.0 # homeassistant.components.camera.onvif http://github.com/tgaugry/suds-passworddigest-py3/archive/86fc50e39b4d2b8997481967d6a7fe1c57118999.zip#suds-passworddigest-py3==0.1.2a diff --git a/requirements_test_all.txt b/requirements_test_all.txt index 7a33e9b4dd0..b858c8a1c0e 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -74,7 +74,7 @@ hbmqtt==0.9.1 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171130.0 +home-assistant-frontend==20171204.0 # homeassistant.components.influxdb # homeassistant.components.sensor.influxdb From bd6a17a3a5104659534e8a58c4fc819a7b40f6cf Mon Sep 17 00:00:00 2001 From: "Craig J. Ward" Date: Sun, 3 Dec 2017 21:34:58 -0600 Subject: [PATCH 211/246] Dominos no order fix (#10935) * check for none * fix error from no store being set * typo * Lint * fix default as per notes. Lint fix and make closest store None not False * update default --- homeassistant/components/dominos.py | 55 ++++++++++++++++++----------- 1 file changed, 34 insertions(+), 21 deletions(-) diff --git a/homeassistant/components/dominos.py b/homeassistant/components/dominos.py index 867bdfafc6b..633ea1b0c5e 100644 --- a/homeassistant/components/dominos.py +++ b/homeassistant/components/dominos.py @@ -58,7 +58,8 @@ CONFIG_SCHEMA = vol.Schema({ vol.Required(ATTR_PHONE): cv.string, vol.Required(ATTR_ADDRESS): cv.string, vol.Optional(ATTR_SHOW_MENU): cv.boolean, - vol.Optional(ATTR_ORDERS): vol.All(cv.ensure_list, [_ORDERS_SCHEMA]), + vol.Optional(ATTR_ORDERS, default=[]): vol.All( + cv.ensure_list, [_ORDERS_SCHEMA]), }), }, extra=vol.ALLOW_EXTRA) @@ -81,7 +82,8 @@ def setup(hass, config): order = DominosOrder(order_info, dominos) entities.append(order) - component.add_entities(entities) + if entities: + component.add_entities(entities) # Return boolean to indicate that initialization was successfully. return True @@ -93,7 +95,8 @@ class Dominos(): def __init__(self, hass, config): """Set up main service.""" conf = config[DOMAIN] - from pizzapi import Address, Customer, Store + from pizzapi import Address, Customer + from pizzapi.address import StoreException self.hass = hass self.customer = Customer( conf.get(ATTR_FIRST_NAME), @@ -105,7 +108,10 @@ class Dominos(): *self.customer.address.split(','), country=conf.get(ATTR_COUNTRY)) self.country = conf.get(ATTR_COUNTRY) - self.closest_store = Store() + try: + self.closest_store = self.address.closest_store() + except StoreException: + self.closest_store = None def handle_order(self, call): """Handle ordering pizza.""" @@ -123,29 +129,31 @@ class Dominos(): from pizzapi.address import StoreException try: self.closest_store = self.address.closest_store() + return True except StoreException: - self.closest_store = False + self.closest_store = None + return False def get_menu(self): """Return the products from the closest stores menu.""" - if self.closest_store is False: + if self.closest_store is None: _LOGGER.warning('Cannot get menu. Store may be closed') - return + return [] + else: + menu = self.closest_store.get_menu() + product_entries = [] - menu = self.closest_store.get_menu() - product_entries = [] + for product in menu.products: + item = {} + if isinstance(product.menu_data['Variants'], list): + variants = ', '.join(product.menu_data['Variants']) + else: + variants = product.menu_data['Variants'] + item['name'] = product.name + item['variants'] = variants + product_entries.append(item) - for product in menu.products: - item = {} - if isinstance(product.menu_data['Variants'], list): - variants = ', '.join(product.menu_data['Variants']) - else: - variants = product.menu_data['Variants'] - item['name'] = product.name - item['variants'] = variants - product_entries.append(item) - - return product_entries + return product_entries class DominosProductListView(http.HomeAssistantView): @@ -192,7 +200,7 @@ class DominosOrder(Entity): @property def state(self): """Return the state either closed, orderable or unorderable.""" - if self.dominos.closest_store is False: + if self.dominos.closest_store is None: return 'closed' else: return 'orderable' if self._orderable else 'unorderable' @@ -217,6 +225,11 @@ class DominosOrder(Entity): def order(self): """Create the order object.""" from pizzapi import Order + from pizzapi.address import StoreException + + if self.dominos.closest_store is None: + raise StoreException + order = Order( self.dominos.closest_store, self.dominos.customer, From b1855f1d1db5c192cbcb78d98ebd7245c989060c Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sun, 3 Dec 2017 19:36:41 -0800 Subject: [PATCH 212/246] Version bump to 0.59.1 --- homeassistant/const.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/homeassistant/const.py b/homeassistant/const.py index beb34146e70..ad7879fc0f5 100644 --- a/homeassistant/const.py +++ b/homeassistant/const.py @@ -2,7 +2,7 @@ """Constants used by Home Assistant components.""" MAJOR_VERSION = 0 MINOR_VERSION = 59 -PATCH_VERSION = '0' +PATCH_VERSION = '1' __short_version__ = '{}.{}'.format(MAJOR_VERSION, MINOR_VERSION) __version__ = '{}.{}'.format(__short_version__, PATCH_VERSION) REQUIRED_PYTHON_VER = (3, 4, 2) From b815898ddb160655121115275c6d3a78507a720c Mon Sep 17 00:00:00 2001 From: Daniel Perna Date: Mon, 4 Dec 2017 00:08:10 +0100 Subject: [PATCH 213/246] Fix Notifications for Android TV (#10798) * Fixed icon path, added dynamic icon * Addressing requested changes * Using DEFAULT_ICON * Using CONF_ICON from const * Getting hass_frontend path via import * Lint * Using embedded 1px transparent icon * woof -.- * Lint --- homeassistant/components/notify/nfandroidtv.py | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/homeassistant/components/notify/nfandroidtv.py b/homeassistant/components/notify/nfandroidtv.py index 6c4f7e49dde..1fa8f1dab78 100644 --- a/homeassistant/components/notify/nfandroidtv.py +++ b/homeassistant/components/notify/nfandroidtv.py @@ -4,8 +4,9 @@ Notifications for Android TV notification service. For more details about this platform, please refer to the documentation at https://home-assistant.io/components/notify.nfandroidtv/ """ -import os import logging +import io +import base64 import requests import voluptuous as vol @@ -31,6 +32,9 @@ DEFAULT_TRANSPARENCY = 'default' DEFAULT_COLOR = 'grey' DEFAULT_INTERRUPT = False DEFAULT_TIMEOUT = 5 +DEFAULT_ICON = ( + 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR4nGP6zwAAAgcBApo' + 'cMXEAAAAASUVORK5CYII=') ATTR_DURATION = 'duration' ATTR_POSITION = 'position' @@ -110,16 +114,13 @@ class NFAndroidTVNotificationService(BaseNotificationService): self._default_color = color self._default_interrupt = interrupt self._timeout = timeout - self._icon_file = os.path.join( - os.path.dirname(__file__), '..', 'frontend', 'www_static', 'icons', - 'favicon-192x192.png') + self._icon_file = io.BytesIO(base64.b64decode(DEFAULT_ICON)) def send_message(self, message="", **kwargs): """Send a message to a Android TV device.""" _LOGGER.debug("Sending notification to: %s", self._target) - payload = dict(filename=('icon.png', - open(self._icon_file, 'rb'), + payload = dict(filename=('icon.png', self._icon_file, 'application/octet-stream', {'Expires': '0'}), type='0', title=kwargs.get(ATTR_TITLE, ATTR_TITLE_DEFAULT), @@ -129,7 +130,7 @@ class NFAndroidTVNotificationService(BaseNotificationService): transparency='%i' % TRANSPARENCIES.get( self._default_transparency), offset='0', app=ATTR_TITLE_DEFAULT, force='true', - interrupt='%i' % self._default_interrupt) + interrupt='%i' % self._default_interrupt,) data = kwargs.get(ATTR_DATA) if data: From 292b403dc3539564f26529dbb216a80ad71966c2 Mon Sep 17 00:00:00 2001 From: Will Boyce Date: Sun, 3 Dec 2017 22:59:22 +0000 Subject: [PATCH 214/246] fix ios component config generation (#10923) Fixes: #19020 --- homeassistant/components/ios.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/homeassistant/components/ios.py b/homeassistant/components/ios.py index cfa1693f571..ebabcdb0e79 100644 --- a/homeassistant/components/ios.py +++ b/homeassistant/components/ios.py @@ -264,7 +264,7 @@ class iOSIdentifyDeviceView(HomeAssistantView): # return self.json_message(humanize_error(request.json, ex), # HTTP_BAD_REQUEST) - data[ATTR_LAST_SEEN_AT] = datetime.datetime.now() + data[ATTR_LAST_SEEN_AT] = datetime.datetime.now().isoformat() name = data.get(ATTR_DEVICE_ID) From 7ae374e11fbb6786f58ac999f016b1f81e3e8900 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sun, 3 Dec 2017 17:59:58 -0800 Subject: [PATCH 215/246] Update frontend to 20171204.0 (#10934) --- homeassistant/components/frontend/__init__.py | 2 +- requirements_all.txt | 2 +- requirements_test_all.txt | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index b71a6508049..e1121fd0c4e 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -23,7 +23,7 @@ from homeassistant.const import CONF_NAME, EVENT_THEMES_UPDATED from homeassistant.core import callback from homeassistant.loader import bind_hass -REQUIREMENTS = ['home-assistant-frontend==20171130.0', 'user-agents==1.1.0'] +REQUIREMENTS = ['home-assistant-frontend==20171204.0', 'user-agents==1.1.0'] DOMAIN = 'frontend' DEPENDENCIES = ['api', 'websocket_api', 'http', 'system_log'] diff --git a/requirements_all.txt b/requirements_all.txt index c8b2b8a6326..88cdb4bcdfa 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -331,7 +331,7 @@ hipnotify==1.0.8 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171130.0 +home-assistant-frontend==20171204.0 # homeassistant.components.camera.onvif http://github.com/tgaugry/suds-passworddigest-py3/archive/86fc50e39b4d2b8997481967d6a7fe1c57118999.zip#suds-passworddigest-py3==0.1.2a diff --git a/requirements_test_all.txt b/requirements_test_all.txt index b02d80ad0e3..3cc2bfa9a9c 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -74,7 +74,7 @@ hbmqtt==0.9.1 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171130.0 +home-assistant-frontend==20171204.0 # homeassistant.components.influxdb # homeassistant.components.sensor.influxdb From d4e603cc6a2f3d3200bd1de87c56627fedf0df71 Mon Sep 17 00:00:00 2001 From: "Craig J. Ward" Date: Sun, 3 Dec 2017 21:34:58 -0600 Subject: [PATCH 216/246] Dominos no order fix (#10935) * check for none * fix error from no store being set * typo * Lint * fix default as per notes. Lint fix and make closest store None not False * update default --- homeassistant/components/dominos.py | 55 ++++++++++++++++++----------- 1 file changed, 34 insertions(+), 21 deletions(-) diff --git a/homeassistant/components/dominos.py b/homeassistant/components/dominos.py index 867bdfafc6b..633ea1b0c5e 100644 --- a/homeassistant/components/dominos.py +++ b/homeassistant/components/dominos.py @@ -58,7 +58,8 @@ CONFIG_SCHEMA = vol.Schema({ vol.Required(ATTR_PHONE): cv.string, vol.Required(ATTR_ADDRESS): cv.string, vol.Optional(ATTR_SHOW_MENU): cv.boolean, - vol.Optional(ATTR_ORDERS): vol.All(cv.ensure_list, [_ORDERS_SCHEMA]), + vol.Optional(ATTR_ORDERS, default=[]): vol.All( + cv.ensure_list, [_ORDERS_SCHEMA]), }), }, extra=vol.ALLOW_EXTRA) @@ -81,7 +82,8 @@ def setup(hass, config): order = DominosOrder(order_info, dominos) entities.append(order) - component.add_entities(entities) + if entities: + component.add_entities(entities) # Return boolean to indicate that initialization was successfully. return True @@ -93,7 +95,8 @@ class Dominos(): def __init__(self, hass, config): """Set up main service.""" conf = config[DOMAIN] - from pizzapi import Address, Customer, Store + from pizzapi import Address, Customer + from pizzapi.address import StoreException self.hass = hass self.customer = Customer( conf.get(ATTR_FIRST_NAME), @@ -105,7 +108,10 @@ class Dominos(): *self.customer.address.split(','), country=conf.get(ATTR_COUNTRY)) self.country = conf.get(ATTR_COUNTRY) - self.closest_store = Store() + try: + self.closest_store = self.address.closest_store() + except StoreException: + self.closest_store = None def handle_order(self, call): """Handle ordering pizza.""" @@ -123,29 +129,31 @@ class Dominos(): from pizzapi.address import StoreException try: self.closest_store = self.address.closest_store() + return True except StoreException: - self.closest_store = False + self.closest_store = None + return False def get_menu(self): """Return the products from the closest stores menu.""" - if self.closest_store is False: + if self.closest_store is None: _LOGGER.warning('Cannot get menu. Store may be closed') - return + return [] + else: + menu = self.closest_store.get_menu() + product_entries = [] - menu = self.closest_store.get_menu() - product_entries = [] + for product in menu.products: + item = {} + if isinstance(product.menu_data['Variants'], list): + variants = ', '.join(product.menu_data['Variants']) + else: + variants = product.menu_data['Variants'] + item['name'] = product.name + item['variants'] = variants + product_entries.append(item) - for product in menu.products: - item = {} - if isinstance(product.menu_data['Variants'], list): - variants = ', '.join(product.menu_data['Variants']) - else: - variants = product.menu_data['Variants'] - item['name'] = product.name - item['variants'] = variants - product_entries.append(item) - - return product_entries + return product_entries class DominosProductListView(http.HomeAssistantView): @@ -192,7 +200,7 @@ class DominosOrder(Entity): @property def state(self): """Return the state either closed, orderable or unorderable.""" - if self.dominos.closest_store is False: + if self.dominos.closest_store is None: return 'closed' else: return 'orderable' if self._orderable else 'unorderable' @@ -217,6 +225,11 @@ class DominosOrder(Entity): def order(self): """Create the order object.""" from pizzapi import Order + from pizzapi.address import StoreException + + if self.dominos.closest_store is None: + raise StoreException + order = Order( self.dominos.closest_store, self.dominos.customer, From 17f3cf0389b639ae49e15023e31a6da6fb1f4fb8 Mon Sep 17 00:00:00 2001 From: Dan Nixon Date: Mon, 4 Dec 2017 07:33:22 +0000 Subject: [PATCH 217/246] Report availability of TP-Link smart sockets (#10933) * Report availability of TP-Link smart sockets * Changes according to our style guide --- homeassistant/components/switch/tplink.py | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/switch/tplink.py b/homeassistant/components/switch/tplink.py index 8fa6493862c..6e8c1a6b9bb 100644 --- a/homeassistant/components/switch/tplink.py +++ b/homeassistant/components/switch/tplink.py @@ -5,7 +5,6 @@ For more details about this platform, please refer to the documentation at https://home-assistant.io/components/switch.tplink/ """ import logging - import time import voluptuous as vol @@ -47,6 +46,7 @@ class SmartPlugSwitch(SwitchDevice): self.smartplug = smartplug self._name = name self._state = None + self._available = True # Set up emeter cache self._emeter_params = {} @@ -55,6 +55,11 @@ class SmartPlugSwitch(SwitchDevice): """Return the name of the Smart Plug, if any.""" return self._name + @property + def available(self) -> bool: + """Return if switch is available.""" + return self._available + @property def is_on(self): """Return true if switch is on.""" @@ -77,6 +82,7 @@ class SmartPlugSwitch(SwitchDevice): """Update the TP-Link switch's state.""" from pyHS100 import SmartDeviceException try: + self._available = True self._state = self.smartplug.state == \ self.smartplug.SWITCH_STATE_ON @@ -100,8 +106,9 @@ class SmartPlugSwitch(SwitchDevice): self._emeter_params[ATTR_DAILY_CONSUMPTION] \ = "%.2f kW" % emeter_statics[int(time.strftime("%e"))] except KeyError: - # device returned no daily history + # Device returned no daily history pass except (SmartDeviceException, OSError) as ex: - _LOGGER.warning('Could not read state for %s: %s', self.name, ex) + _LOGGER.warning("Could not read state for %s: %s", self.name, ex) + self._available = False From 19a97580fc84cda20bd7d9d06d3f25982f9c4b73 Mon Sep 17 00:00:00 2001 From: Nicolas Bougues Date: Mon, 4 Dec 2017 08:34:42 +0100 Subject: [PATCH 218/246] Set percent unit for battery level so that history displays properly; edited variable name for consistency (#10932) --- homeassistant/components/sensor/tesla.py | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/homeassistant/components/sensor/tesla.py b/homeassistant/components/sensor/tesla.py index 824fec41580..3f36a1128d6 100644 --- a/homeassistant/components/sensor/tesla.py +++ b/homeassistant/components/sensor/tesla.py @@ -39,7 +39,7 @@ class TeslaSensor(TeslaDevice, Entity): def __init__(self, tesla_device, controller, sensor_type=None): """Initialisation of the sensor.""" self.current_value = None - self._temperature_units = None + self._unit = None self.last_changed_time = None self.type = sensor_type super().__init__(tesla_device, controller) @@ -59,7 +59,7 @@ class TeslaSensor(TeslaDevice, Entity): @property def unit_of_measurement(self): """Return the unit_of_measurement of the device.""" - return self._temperature_units + return self._unit def update(self): """Update the state from the sensor.""" @@ -74,8 +74,9 @@ class TeslaSensor(TeslaDevice, Entity): tesla_temp_units = self.tesla_device.measurement if tesla_temp_units == 'F': - self._temperature_units = TEMP_FAHRENHEIT + self._unit = TEMP_FAHRENHEIT else: - self._temperature_units = TEMP_CELSIUS + self._unit = TEMP_CELSIUS else: self.current_value = self.tesla_device.battery_level() + self._unit = "%" From 31cedf83c75f273d1983149a905124075cc09492 Mon Sep 17 00:00:00 2001 From: "drop table USERS; --" <17239583+hudashot@users.noreply.github.com> Date: Mon, 4 Dec 2017 12:39:26 +0000 Subject: [PATCH 219/246] Export climate status and target temperature to Prometheus (#10919) * Export climate metrics to Prometheus. This adds climate_state and temperature_c metrics for each climate device. * Add more climate states to state_as_number --- homeassistant/components/prometheus.py | 25 +++++++++++++++++++++++-- homeassistant/helpers/state.py | 8 +++++--- 2 files changed, 28 insertions(+), 5 deletions(-) diff --git a/homeassistant/components/prometheus.py b/homeassistant/components/prometheus.py index 0195021829b..0ecfa50ee63 100644 --- a/homeassistant/components/prometheus.py +++ b/homeassistant/components/prometheus.py @@ -14,7 +14,8 @@ from homeassistant.components.http import HomeAssistantView from homeassistant.components import recorder from homeassistant.const import ( CONF_DOMAINS, CONF_ENTITIES, CONF_EXCLUDE, CONF_INCLUDE, TEMP_CELSIUS, - EVENT_STATE_CHANGED, TEMP_FAHRENHEIT, CONTENT_TYPE_TEXT_PLAIN) + EVENT_STATE_CHANGED, TEMP_FAHRENHEIT, CONTENT_TYPE_TEXT_PLAIN, + ATTR_TEMPERATURE, ATTR_UNIT_OF_MEASUREMENT) from homeassistant import core as hacore from homeassistant.helpers import state as state_helper from homeassistant.util.temperature import fahrenheit_to_celsius @@ -159,6 +160,26 @@ class Metrics(object): value = state_helper.state_as_number(state) metric.labels(**self._labels(state)).set(value) + def _handle_climate(self, state): + temp = state.attributes.get(ATTR_TEMPERATURE) + if temp: + unit = state.attributes.get(ATTR_UNIT_OF_MEASUREMENT) + if unit == TEMP_FAHRENHEIT: + temp = fahrenheit_to_celsius(temp) + metric = self._metric( + 'temperature_c', self.prometheus_client.Gauge, + 'Temperature in degrees Celsius') + metric.labels(**self._labels(state)).set(temp) + + metric = self._metric( + 'climate_state', self.prometheus_client.Gauge, + 'State of the thermostat (0/1)') + try: + value = state_helper.state_as_number(state) + metric.labels(**self._labels(state)).set(value) + except ValueError: + pass + def _handle_sensor(self, state): _sensor_types = { TEMP_CELSIUS: ( @@ -199,7 +220,7 @@ class Metrics(object): ), } - unit = state.attributes.get('unit_of_measurement') + unit = state.attributes.get(ATTR_UNIT_OF_MEASUREMENT) metric = _sensor_types.get(unit) if metric is not None: diff --git a/homeassistant/helpers/state.py b/homeassistant/helpers/state.py index 8b98bfadb68..254a48c3d0a 100644 --- a/homeassistant/helpers/state.py +++ b/homeassistant/helpers/state.py @@ -21,7 +21,8 @@ from homeassistant.components.climate import ( ATTR_HUMIDITY, ATTR_OPERATION_MODE, ATTR_SWING_MODE, SERVICE_SET_AUX_HEAT, SERVICE_SET_AWAY_MODE, SERVICE_SET_HOLD_MODE, SERVICE_SET_FAN_MODE, SERVICE_SET_HUMIDITY, SERVICE_SET_OPERATION_MODE, - SERVICE_SET_SWING_MODE, SERVICE_SET_TEMPERATURE) + SERVICE_SET_SWING_MODE, SERVICE_SET_TEMPERATURE, STATE_HEAT, STATE_COOL, + STATE_IDLE) from homeassistant.components.climate.ecobee import ( ATTR_FAN_MIN_ON_TIME, SERVICE_SET_FAN_MIN_ON_TIME, ATTR_RESUME_ALL, SERVICE_RESUME_PROGRAM) @@ -210,10 +211,11 @@ def state_as_number(state): Raises ValueError if this is not possible. """ if state.state in (STATE_ON, STATE_LOCKED, STATE_ABOVE_HORIZON, - STATE_OPEN, STATE_HOME): + STATE_OPEN, STATE_HOME, STATE_HEAT, STATE_COOL): return 1 elif state.state in (STATE_OFF, STATE_UNLOCKED, STATE_UNKNOWN, - STATE_BELOW_HORIZON, STATE_CLOSED, STATE_NOT_HOME): + STATE_BELOW_HORIZON, STATE_CLOSED, STATE_NOT_HOME, + STATE_IDLE): return 0 return float(state.state) From ef1cbd3aea09a3d550bdbc2c5c1f0af505d050cf Mon Sep 17 00:00:00 2001 From: dasos Date: Mon, 4 Dec 2017 13:55:04 +0000 Subject: [PATCH 220/246] Tado ignore invalid devices (#10927) * Ignore devices without temperatures * Typo * Linting * Removing return false * Another typo. :( * Spelling received correctly --- homeassistant/components/climate/tado.py | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/climate/tado.py b/homeassistant/components/climate/tado.py index d58acac5373..a8054b838ef 100644 --- a/homeassistant/components/climate/tado.py +++ b/homeassistant/components/climate/tado.py @@ -59,8 +59,11 @@ def setup_platform(hass, config, add_devices, discovery_info=None): climate_devices = [] for zone in zones: - climate_devices.append(create_climate_device( - tado, hass, zone, zone['name'], zone['id'])) + device = create_climate_device( + tado, hass, zone, zone['name'], zone['id']) + if not device: + continue + climate_devices.append(device) if climate_devices: add_devices(climate_devices, True) @@ -75,8 +78,11 @@ def create_climate_device(tado, hass, zone, name, zone_id): if ac_mode: temperatures = capabilities['HEAT']['temperatures'] - else: + elif 'temperatures' in capabilities: temperatures = capabilities['temperatures'] + else: + _LOGGER.debug("Received zone %s has no temperature; not adding", name) + return min_temp = float(temperatures['celsius']['min']) max_temp = float(temperatures['celsius']['max']) From 4652b8aea136452081543b24ad9c24270308643d Mon Sep 17 00:00:00 2001 From: Erik Eriksson Date: Mon, 4 Dec 2017 17:26:07 +0100 Subject: [PATCH 221/246] Upgrade tellduslive library version (closes https://github.com/home-assistant/home-assistant/issues/10922) (#10950) --- homeassistant/components/tellduslive.py | 2 +- requirements_all.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/tellduslive.py b/homeassistant/components/tellduslive.py index ba7c1afd286..28bf65bc4c5 100644 --- a/homeassistant/components/tellduslive.py +++ b/homeassistant/components/tellduslive.py @@ -24,7 +24,7 @@ APPLICATION_NAME = 'Home Assistant' DOMAIN = 'tellduslive' -REQUIREMENTS = ['tellduslive==0.10.3'] +REQUIREMENTS = ['tellduslive==0.10.4'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index da2290ddcb2..838e8e42008 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -1069,7 +1069,7 @@ tellcore-net==0.3 tellcore-py==1.1.2 # homeassistant.components.tellduslive -tellduslive==0.10.3 +tellduslive==0.10.4 # homeassistant.components.sensor.temper temperusb==1.5.3 From 2e2d0f48fb2e9c9c265edfa01eb9f27ee550ca74 Mon Sep 17 00:00:00 2001 From: Paul Annekov Date: Mon, 4 Dec 2017 19:26:41 +0300 Subject: [PATCH 222/246] don't ignore voltage data if sensor data changed (#10925) --- homeassistant/components/xiaomi_aqara.py | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/homeassistant/components/xiaomi_aqara.py b/homeassistant/components/xiaomi_aqara.py index f875edef310..678ead981c1 100644 --- a/homeassistant/components/xiaomi_aqara.py +++ b/homeassistant/components/xiaomi_aqara.py @@ -219,7 +219,9 @@ class XiaomiDevice(Entity): def push_data(self, data): """Push from Hub.""" _LOGGER.debug("PUSH >> %s: %s", self, data) - if self.parse_data(data) or self.parse_voltage(data): + is_data = self.parse_data(data) + is_voltage = self.parse_voltage(data) + if is_data or is_voltage: self.schedule_update_ha_state() def parse_voltage(self, data): From 38a1f06d14d632923ac88e34c4f24ebca70d55c3 Mon Sep 17 00:00:00 2001 From: Mateusz Drab Date: Mon, 4 Dec 2017 17:58:52 +0000 Subject: [PATCH 223/246] Fix linksys_ap.py by inheriting DeviceScanner (#10947) As per issue #8638, the class wasn't inheriting from DeviceScanner, this commit patches it up. --- homeassistant/components/device_tracker/linksys_ap.py | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/device_tracker/linksys_ap.py b/homeassistant/components/device_tracker/linksys_ap.py index 196235f32f4..20dc9052e11 100644 --- a/homeassistant/components/device_tracker/linksys_ap.py +++ b/homeassistant/components/device_tracker/linksys_ap.py @@ -11,7 +11,8 @@ import requests import voluptuous as vol import homeassistant.helpers.config_validation as cv -from homeassistant.components.device_tracker import DOMAIN, PLATFORM_SCHEMA +from homeassistant.components.device_tracker import ( + DOMAIN, PLATFORM_SCHEMA, DeviceScanner) from homeassistant.const import ( CONF_HOST, CONF_PASSWORD, CONF_USERNAME, CONF_VERIFY_SSL) @@ -38,7 +39,7 @@ def get_scanner(hass, config): return None -class LinksysAPDeviceScanner(object): +class LinksysAPDeviceScanner(DeviceScanner): """This class queries a Linksys Access Point.""" def __init__(self, config): From 53d9fd18b7d2b93484adb26b0eeebc8068eba843 Mon Sep 17 00:00:00 2001 From: Stefan Lehmann Date: Tue, 5 Dec 2017 09:44:22 +0100 Subject: [PATCH 224/246] Add ADS component (#10142) * add ads hub, light and switch * add binary sensor prototype * switch: use adsvar for connection * fix some issues with binary sensor * fix binary sensor * fix all platforms * use latest pyads * fixed error with multiple binary sensors * add sensor * add ads sensor * clean up after shutdown * ads component with platforms switch, binary_sensor, light, sensor add locking poll sensors at startup update state of ads switch and light update ads requirements remove update() from constructors on ads platforms omit ads coverage ads catch read error when polling * add ads service * add default settings for use_notify and poll_interval * fix too long line * Fix style issues * no pydocstyle errors * Send and receive native brightness data to ADS device to prevent issues with math.floor reducing brightness -1 at every switch * Enable non dimmable lights * remove setting of self._state in switch * remove polling * Revert "remove polling" This reverts commit 7da420f82385a4a5c66a929af7025c00ed197e86. * add service schema, add links to documentation * fix naming, cleanup * re-remove polling * use async_added_to_hass for setup of callbacks * fix comment. * add callbacks for changed values * use async_add_job for creating device notifications * set should_poll to False for all platforms * change should_poll to property * add service description to services.yaml * add for brigthness not being None * put ads component in package * Remove whitespace * omit ads package --- .coveragerc | 3 + homeassistant/components/ads/__init__.py | 217 ++++++++++++++++++ homeassistant/components/ads/services.yaml | 15 ++ homeassistant/components/binary_sensor/ads.py | 87 +++++++ homeassistant/components/light/ads.py | 117 ++++++++++ homeassistant/components/sensor/ads.py | 103 +++++++++ homeassistant/components/services.yaml | 8 +- homeassistant/components/switch/ads.py | 85 +++++++ requirements_all.txt | 3 + 9 files changed, 634 insertions(+), 4 deletions(-) create mode 100644 homeassistant/components/ads/__init__.py create mode 100644 homeassistant/components/ads/services.yaml create mode 100644 homeassistant/components/binary_sensor/ads.py create mode 100644 homeassistant/components/light/ads.py create mode 100644 homeassistant/components/sensor/ads.py create mode 100644 homeassistant/components/switch/ads.py diff --git a/.coveragerc b/.coveragerc index 4f23fd9d8bf..33380c34ed7 100644 --- a/.coveragerc +++ b/.coveragerc @@ -11,6 +11,9 @@ omit = homeassistant/components/abode.py homeassistant/components/*/abode.py + homeassistant/components/ads/__init__.py + homeassistant/components/*/ads.py + homeassistant/components/alarmdecoder.py homeassistant/components/*/alarmdecoder.py diff --git a/homeassistant/components/ads/__init__.py b/homeassistant/components/ads/__init__.py new file mode 100644 index 00000000000..3d9de28ded3 --- /dev/null +++ b/homeassistant/components/ads/__init__.py @@ -0,0 +1,217 @@ +""" +ADS Component. + +For more details about this component, please refer to the documentation. +https://home-assistant.io/components/ads/ + +""" +import os +import threading +import struct +import logging +import ctypes +from collections import namedtuple +import voluptuous as vol +from homeassistant.const import CONF_DEVICE, CONF_PORT, CONF_IP_ADDRESS, \ + EVENT_HOMEASSISTANT_STOP +from homeassistant.config import load_yaml_config_file +import homeassistant.helpers.config_validation as cv + +REQUIREMENTS = ['pyads==2.2.6'] + +_LOGGER = logging.getLogger(__name__) + +DATA_ADS = 'data_ads' + +# Supported Types +ADSTYPE_INT = 'int' +ADSTYPE_UINT = 'uint' +ADSTYPE_BYTE = 'byte' +ADSTYPE_BOOL = 'bool' + +DOMAIN = 'ads' + +# config variable names +CONF_ADS_VAR = 'adsvar' +CONF_ADS_VAR_BRIGHTNESS = 'adsvar_brightness' +CONF_ADS_TYPE = 'adstype' +CONF_ADS_FACTOR = 'factor' +CONF_ADS_VALUE = 'value' + +SERVICE_WRITE_DATA_BY_NAME = 'write_data_by_name' + +CONFIG_SCHEMA = vol.Schema({ + DOMAIN: vol.Schema({ + vol.Required(CONF_DEVICE): cv.string, + vol.Required(CONF_PORT): cv.port, + vol.Optional(CONF_IP_ADDRESS): cv.string, + }) +}, extra=vol.ALLOW_EXTRA) + +SCHEMA_SERVICE_WRITE_DATA_BY_NAME = vol.Schema({ + vol.Required(CONF_ADS_VAR): cv.string, + vol.Required(CONF_ADS_TYPE): vol.In([ADSTYPE_INT, ADSTYPE_UINT, + ADSTYPE_BYTE]), + vol.Required(CONF_ADS_VALUE): cv.match_all +}) + + +def setup(hass, config): + """Set up the ADS component.""" + import pyads + conf = config[DOMAIN] + + # get ads connection parameters from config + net_id = conf.get(CONF_DEVICE) + ip_address = conf.get(CONF_IP_ADDRESS) + port = conf.get(CONF_PORT) + + # create a new ads connection + client = pyads.Connection(net_id, port, ip_address) + + # add some constants to AdsHub + AdsHub.ADS_TYPEMAP = { + ADSTYPE_BOOL: pyads.PLCTYPE_BOOL, + ADSTYPE_BYTE: pyads.PLCTYPE_BYTE, + ADSTYPE_INT: pyads.PLCTYPE_INT, + ADSTYPE_UINT: pyads.PLCTYPE_UINT, + } + + AdsHub.PLCTYPE_BOOL = pyads.PLCTYPE_BOOL + AdsHub.PLCTYPE_BYTE = pyads.PLCTYPE_BYTE + AdsHub.PLCTYPE_INT = pyads.PLCTYPE_INT + AdsHub.PLCTYPE_UINT = pyads.PLCTYPE_UINT + AdsHub.ADSError = pyads.ADSError + + # connect to ads client and try to connect + try: + ads = AdsHub(client) + except pyads.pyads.ADSError: + _LOGGER.error( + 'Could not connect to ADS host (netid=%s, port=%s)', net_id, port + ) + return False + + # add ads hub to hass data collection, listen to shutdown + hass.data[DATA_ADS] = ads + hass.bus.listen(EVENT_HOMEASSISTANT_STOP, ads.shutdown) + + def handle_write_data_by_name(call): + """Write a value to the connected ADS device.""" + ads_var = call.data.get(CONF_ADS_VAR) + ads_type = call.data.get(CONF_ADS_TYPE) + value = call.data.get(CONF_ADS_VALUE) + + try: + ads.write_by_name(ads_var, value, ads.ADS_TYPEMAP[ads_type]) + except pyads.ADSError as err: + _LOGGER.error(err) + + # load descriptions from services.yaml + descriptions = load_yaml_config_file( + os.path.join(os.path.dirname(__file__), 'services.yaml')) + + hass.services.register( + DOMAIN, SERVICE_WRITE_DATA_BY_NAME, handle_write_data_by_name, + descriptions[SERVICE_WRITE_DATA_BY_NAME], + schema=SCHEMA_SERVICE_WRITE_DATA_BY_NAME + ) + + return True + + +# tuple to hold data needed for notification +NotificationItem = namedtuple( + 'NotificationItem', 'hnotify huser name plc_datatype callback' +) + + +class AdsHub: + """Representation of a PyADS connection.""" + + def __init__(self, ads_client): + """Initialize the ADS Hub.""" + self._client = ads_client + self._client.open() + + # all ADS devices are registered here + self._devices = [] + self._notification_items = {} + self._lock = threading.Lock() + + def shutdown(self, *args, **kwargs): + """Shutdown ADS connection.""" + _LOGGER.debug('Shutting down ADS') + for notification_item in self._notification_items.values(): + self._client.del_device_notification( + notification_item.hnotify, + notification_item.huser + ) + _LOGGER.debug( + 'Deleting device notification %d, %d', + notification_item.hnotify, notification_item.huser + ) + self._client.close() + + def register_device(self, device): + """Register a new device.""" + self._devices.append(device) + + def write_by_name(self, name, value, plc_datatype): + """Write a value to the device.""" + with self._lock: + return self._client.write_by_name(name, value, plc_datatype) + + def read_by_name(self, name, plc_datatype): + """Read a value from the device.""" + with self._lock: + return self._client.read_by_name(name, plc_datatype) + + def add_device_notification(self, name, plc_datatype, callback): + """Add a notification to the ADS devices.""" + from pyads import NotificationAttrib + attr = NotificationAttrib(ctypes.sizeof(plc_datatype)) + + with self._lock: + hnotify, huser = self._client.add_device_notification( + name, attr, self._device_notification_callback + ) + hnotify = int(hnotify) + + _LOGGER.debug( + 'Added Device Notification %d for variable %s', hnotify, name + ) + + self._notification_items[hnotify] = NotificationItem( + hnotify, huser, name, plc_datatype, callback + ) + + def _device_notification_callback(self, addr, notification, huser): + """Handle device notifications.""" + contents = notification.contents + + hnotify = int(contents.hNotification) + _LOGGER.debug('Received Notification %d', hnotify) + data = contents.data + + try: + notification_item = self._notification_items[hnotify] + except KeyError: + _LOGGER.debug('Unknown Device Notification handle: %d', hnotify) + return + + # parse data to desired datatype + if notification_item.plc_datatype == self.PLCTYPE_BOOL: + value = bool(struct.unpack(' Date: Tue, 5 Dec 2017 03:47:48 -0600 Subject: [PATCH 225/246] Reload closest store on api menu request (#10962) * reload closest store on api request * revert change from debugging --- homeassistant/components/dominos.py | 1 + 1 file changed, 1 insertion(+) diff --git a/homeassistant/components/dominos.py b/homeassistant/components/dominos.py index 633ea1b0c5e..0d6645f37c1 100644 --- a/homeassistant/components/dominos.py +++ b/homeassistant/components/dominos.py @@ -136,6 +136,7 @@ class Dominos(): def get_menu(self): """Return the products from the closest stores menu.""" + self.update_closest_store() if self.closest_store is None: _LOGGER.warning('Cannot get menu. Store may be closed') return [] From 821cf7135d9393088380bcd24a7177a94c8be9d8 Mon Sep 17 00:00:00 2001 From: Roman Date: Tue, 5 Dec 2017 12:32:43 +0100 Subject: [PATCH 226/246] Gearbest sensor (#10556) * Added Gearbest Sensor * Updated required files * Fixed houndci-bout findings * Fix tox lint errors * Changed code according to review Implemented library version 1.0.5 * Fixed houndci-bot findings * Fixed tox lint issues * Updated item schema to use has_at_least_one_key Added conf constants * Remove CONF_ constants and import them from homeassistant.const * Removed CurrencyConverter from hass Fixed couple of issues found by MartinHjelmare --- .coveragerc | 1 + CODEOWNERS | 1 + homeassistant/components/sensor/gearbest.py | 127 ++++++++++++++++++++ requirements_all.txt | 3 + 4 files changed, 132 insertions(+) create mode 100755 homeassistant/components/sensor/gearbest.py diff --git a/.coveragerc b/.coveragerc index 33380c34ed7..0f721155389 100644 --- a/.coveragerc +++ b/.coveragerc @@ -517,6 +517,7 @@ omit = homeassistant/components/sensor/fixer.py homeassistant/components/sensor/fritzbox_callmonitor.py homeassistant/components/sensor/fritzbox_netmonitor.py + homeassistant/components/sensor/gearbest.py homeassistant/components/sensor/geizhals.py homeassistant/components/sensor/gitter.py homeassistant/components/sensor/glances.py diff --git a/CODEOWNERS b/CODEOWNERS index fe415a619db..ac0f794482a 100644 --- a/CODEOWNERS +++ b/CODEOWNERS @@ -54,6 +54,7 @@ homeassistant/components/media_player/kodi.py @armills homeassistant/components/media_player/monoprice.py @etsinko homeassistant/components/media_player/yamaha_musiccast.py @jalmeroth homeassistant/components/sensor/airvisual.py @bachya +homeassistant/components/sensor/gearbest.py @HerrHofrat homeassistant/components/sensor/irish_rail_transport.py @ttroy50 homeassistant/components/sensor/miflora.py @danielhiversen homeassistant/components/sensor/sytadin.py @gautric diff --git a/homeassistant/components/sensor/gearbest.py b/homeassistant/components/sensor/gearbest.py new file mode 100755 index 00000000000..2bc7e5b3b3a --- /dev/null +++ b/homeassistant/components/sensor/gearbest.py @@ -0,0 +1,127 @@ +""" +Parse prices of a item from gearbest. + +For more details about this platform, please refer to the documentation at +https://home-assistant.io/components/sensor.gearbest/ +""" +import logging +from datetime import timedelta + +import voluptuous as vol + +from homeassistant.components.sensor import PLATFORM_SCHEMA +import homeassistant.helpers.config_validation as cv +from homeassistant.util import Throttle +from homeassistant.helpers.entity import Entity +from homeassistant.helpers.event import track_time_interval +from homeassistant.const import (CONF_NAME, CONF_ID, CONF_URL, CONF_CURRENCY) + +REQUIREMENTS = ['gearbest_parser==1.0.5'] +_LOGGER = logging.getLogger(__name__) + +CONF_ITEMS = 'items' + +ICON = 'mdi:coin' +MIN_TIME_BETWEEN_UPDATES = timedelta(seconds=2*60*60) # 2h +MIN_TIME_BETWEEN_CURRENCY_UPDATES = timedelta(seconds=12*60*60) # 12h + + +_ITEM_SCHEMA = vol.All( + vol.Schema({ + vol.Exclusive(CONF_URL, 'XOR'): cv.string, + vol.Exclusive(CONF_ID, 'XOR'): cv.string, + vol.Optional(CONF_NAME): cv.string, + vol.Optional(CONF_CURRENCY): cv.string + }), cv.has_at_least_one_key(CONF_URL, CONF_ID) +) + +_ITEMS_SCHEMA = vol.Schema([_ITEM_SCHEMA]) + +PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ + vol.Required(CONF_ITEMS): _ITEMS_SCHEMA, + vol.Required(CONF_CURRENCY): cv.string, +}) + + +def setup_platform(hass, config, add_devices, discovery_info=None): + """Set up the Gearbest sensor.""" + from gearbest_parser import CurrencyConverter + currency = config.get(CONF_CURRENCY) + + sensors = [] + items = config.get(CONF_ITEMS) + + converter = CurrencyConverter() + converter.update() + + for item in items: + try: + sensors.append(GearbestSensor(converter, item, currency)) + except ValueError as exc: + _LOGGER.error(exc) + + def currency_update(event_time): + """Update currency list.""" + converter.update() + + track_time_interval(hass, + currency_update, + MIN_TIME_BETWEEN_CURRENCY_UPDATES) + + add_devices(sensors, True) + + +class GearbestSensor(Entity): + """Implementation of the sensor.""" + + def __init__(self, converter, item, currency): + """Initialize the sensor.""" + from gearbest_parser import GearbestParser + + self._name = item.get(CONF_NAME) + self._parser = GearbestParser() + self._parser.set_currency_converter(converter) + self._item = self._parser.load(item.get(CONF_ID), + item.get(CONF_URL), + item.get(CONF_CURRENCY, currency)) + if self._item is None: + raise ValueError("id and url could not be resolved") + + @property + def name(self): + """Return the name of the item.""" + return self._name if self._name is not None else self._item.name + + @property + def icon(self): + """Return the icon for the frontend.""" + return ICON + + @property + def state(self): + """Return the price of the selected product.""" + return self._item.price + + @property + def unit_of_measurement(self): + """Return the currency.""" + return self._item.currency + + @property + def entity_picture(self): + """Return the image.""" + return self._item.image + + @property + def device_state_attributes(self): + """Return the state attributes.""" + attrs = {'name': self._item.name, + 'description': self._item.description, + 'currency': self._item.currency, + 'url': self._item.url} + return attrs + + @Throttle(MIN_TIME_BETWEEN_UPDATES) + def update(self): + """Get the latest price from gearbest and updates the state.""" + self._item.update() diff --git a/requirements_all.txt b/requirements_all.txt index 3157f87d4ba..32b552b9c5d 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -291,6 +291,9 @@ gTTS-token==1.1.1 # homeassistant.components.device_tracker.bluetooth_le_tracker # gattlib==0.20150805 +# homeassistant.components.sensor.gearbest +gearbest_parser==1.0.5 + # homeassistant.components.sensor.gitter gitterpy==0.1.6 From 379c10985b56367a48056feaa72f0b1385e3edce Mon Sep 17 00:00:00 2001 From: Menno Blom Date: Tue, 5 Dec 2017 14:22:27 +0100 Subject: [PATCH 227/246] Add Ziggo Mediabox XL media_player (#10514) * Add Ziggo Mediabox XL media_player * Using pypi module ziggo-mediabox-xl now. * Code review changes --- .coveragerc | 1 + .../media_player/ziggo_mediabox_xl.py | 174 ++++++++++++++++++ requirements_all.txt | 3 + 3 files changed, 178 insertions(+) create mode 100644 homeassistant/components/media_player/ziggo_mediabox_xl.py diff --git a/.coveragerc b/.coveragerc index 0f721155389..e97d197ca94 100644 --- a/.coveragerc +++ b/.coveragerc @@ -430,6 +430,7 @@ omit = homeassistant/components/media_player/volumio.py homeassistant/components/media_player/yamaha.py homeassistant/components/media_player/yamaha_musiccast.py + homeassistant/components/media_player/ziggo_mediabox_xl.py homeassistant/components/mycroft.py homeassistant/components/notify/aws_lambda.py homeassistant/components/notify/aws_sns.py diff --git a/homeassistant/components/media_player/ziggo_mediabox_xl.py b/homeassistant/components/media_player/ziggo_mediabox_xl.py new file mode 100644 index 00000000000..1886cd751ea --- /dev/null +++ b/homeassistant/components/media_player/ziggo_mediabox_xl.py @@ -0,0 +1,174 @@ +""" +Support for interface with a Ziggo Mediabox XL. + +For more details about this platform, please refer to the documentation at +https://home-assistant.io/components/media_player.ziggo_mediabox_xl/ +""" +import logging +import socket + +import voluptuous as vol + +from homeassistant.components.media_player import ( + PLATFORM_SCHEMA, MediaPlayerDevice, + SUPPORT_TURN_ON, SUPPORT_TURN_OFF, + SUPPORT_NEXT_TRACK, SUPPORT_PREVIOUS_TRACK, SUPPORT_SELECT_SOURCE, + SUPPORT_PLAY, SUPPORT_PAUSE) +from homeassistant.const import ( + CONF_HOST, CONF_NAME, STATE_OFF, STATE_ON, STATE_PAUSED, STATE_PLAYING) +import homeassistant.helpers.config_validation as cv + +REQUIREMENTS = ['ziggo-mediabox-xl==1.0.0'] + +_LOGGER = logging.getLogger(__name__) + +DATA_KNOWN_DEVICES = 'ziggo_mediabox_xl_known_devices' + +SUPPORT_ZIGGO = SUPPORT_TURN_ON | SUPPORT_TURN_OFF | \ + SUPPORT_NEXT_TRACK | SUPPORT_PAUSE | SUPPORT_PREVIOUS_TRACK | \ + SUPPORT_SELECT_SOURCE | SUPPORT_PLAY + +PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ + vol.Required(CONF_HOST): cv.string, + vol.Optional(CONF_NAME): cv.string, +}) + + +def setup_platform(hass, config, add_devices, discovery_info=None): + """Set up the Ziggo Mediabox XL platform.""" + from ziggo_mediabox_xl import ZiggoMediaboxXL + + hass.data[DATA_KNOWN_DEVICES] = known_devices = set() + + # Is this a manual configuration? + if config.get(CONF_HOST) is not None: + host = config.get(CONF_HOST) + name = config.get(CONF_NAME) + elif discovery_info is not None: + host = discovery_info.get('host') + name = discovery_info.get('name') + else: + _LOGGER.error("Cannot determine device") + return + + # Only add a device once, so discovered devices do not override manual + # config. + hosts = [] + ip_addr = socket.gethostbyname(host) + if ip_addr not in known_devices: + try: + mediabox = ZiggoMediaboxXL(ip_addr) + if mediabox.test_connection(): + hosts.append(ZiggoMediaboxXLDevice(mediabox, host, name)) + known_devices.add(ip_addr) + else: + _LOGGER.error("Can't connect to %s", host) + except socket.error as error: + _LOGGER.error("Can't connect to %s: %s", host, error) + else: + _LOGGER.info("Ignoring duplicate Ziggo Mediabox XL %s", host) + add_devices(hosts, True) + + +class ZiggoMediaboxXLDevice(MediaPlayerDevice): + """Representation of a Ziggo Mediabox XL Device.""" + + def __init__(self, mediabox, host, name): + """Initialize the device.""" + # Generate a configuration for the Samsung library + self._mediabox = mediabox + self._host = host + self._name = name + self._state = None + + def update(self): + """Retrieve the state of the device.""" + try: + if self._mediabox.turned_on(): + if self._state != STATE_PAUSED: + self._state = STATE_PLAYING + else: + self._state = STATE_OFF + except socket.error: + _LOGGER.error("Couldn't fetch state from %s", self._host) + + def send_keys(self, keys): + """Send keys to the device and handle exceptions.""" + try: + self._mediabox.send_keys(keys) + except socket.error: + _LOGGER.error("Couldn't send keys to %s", self._host) + + @property + def name(self): + """Return the name of the device.""" + return self._name + + @property + def state(self): + """Return the state of the device.""" + return self._state + + @property + def source_list(self): + """List of available sources (channels).""" + return [self._mediabox.channels()[c] + for c in sorted(self._mediabox.channels().keys())] + + @property + def supported_features(self): + """Flag media player features that are supported.""" + return SUPPORT_ZIGGO + + def turn_on(self): + """Turn the media player on.""" + self.send_keys(['POWER']) + self._state = STATE_ON + + def turn_off(self): + """Turn off media player.""" + self.send_keys(['POWER']) + self._state = STATE_OFF + + def media_play(self): + """Send play command.""" + self.send_keys(['PLAY']) + self._state = STATE_PLAYING + + def media_pause(self): + """Send pause command.""" + self.send_keys(['PAUSE']) + self._state = STATE_PAUSED + + def media_play_pause(self): + """Simulate play pause media player.""" + self.send_keys(['PAUSE']) + if self._state == STATE_PAUSED: + self._state = STATE_PLAYING + else: + self._state = STATE_PAUSED + + def media_next_track(self): + """Channel up.""" + self.send_keys(['CHAN_UP']) + self._state = STATE_PLAYING + + def media_previous_track(self): + """Channel down.""" + self.send_keys(['CHAN_DOWN']) + self._state = STATE_PLAYING + + def select_source(self, source): + """Select the channel.""" + if str(source).isdigit(): + digits = str(source) + else: + digits = next(( + key for key, value in self._mediabox.channels().items() + if value == source), None) + if digits is None: + return + + self.send_keys(['NUM_{}'.format(digit) + for digit in str(digits)]) + self._state = STATE_PLAYING diff --git a/requirements_all.txt b/requirements_all.txt index 32b552b9c5d..da2492edebd 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -1185,3 +1185,6 @@ zengge==0.2 # homeassistant.components.zeroconf zeroconf==0.19.1 + +# homeassistant.components.media_player.ziggo_mediabox_xl +ziggo-mediabox-xl==1.0.0 From 69d5738e47fe847d79f534dcbef7d3509bc542fe Mon Sep 17 00:00:00 2001 From: ziotibia81 Date: Tue, 5 Dec 2017 15:00:33 +0100 Subject: [PATCH 228/246] Generic thermostat initial_operation_mode (#10690) * Generic thermostat restore operation mode * Test restore operation mode * Fix trailing whitespace * Fix line too long * Fix test duplicate entity_id * Fix test * async_added_to_hass modify modify internal state * Test inital_operation_mode * More restore state tests * Fix whitespace * fix test_custom_setup_param * Test "None" target temp --- .../components/climate/generic_thermostat.py | 35 +++++++++++++------ .../climate/test_generic_thermostat.py | 35 ++++++++++++++++++- 2 files changed, 59 insertions(+), 11 deletions(-) diff --git a/homeassistant/components/climate/generic_thermostat.py b/homeassistant/components/climate/generic_thermostat.py index 987708834cc..6574a4d5396 100644 --- a/homeassistant/components/climate/generic_thermostat.py +++ b/homeassistant/components/climate/generic_thermostat.py @@ -13,7 +13,8 @@ from homeassistant.core import callback from homeassistant.core import DOMAIN as HA_DOMAIN from homeassistant.components.climate import ( STATE_HEAT, STATE_COOL, STATE_IDLE, ClimateDevice, PLATFORM_SCHEMA, - STATE_AUTO, SUPPORT_OPERATION_MODE, SUPPORT_TARGET_TEMPERATURE) + STATE_AUTO, ATTR_OPERATION_MODE, SUPPORT_OPERATION_MODE, + SUPPORT_TARGET_TEMPERATURE) from homeassistant.const import ( ATTR_UNIT_OF_MEASUREMENT, STATE_ON, STATE_OFF, ATTR_TEMPERATURE, CONF_NAME, ATTR_ENTITY_ID, SERVICE_TURN_ON, SERVICE_TURN_OFF) @@ -40,7 +41,7 @@ CONF_MIN_DUR = 'min_cycle_duration' CONF_COLD_TOLERANCE = 'cold_tolerance' CONF_HOT_TOLERANCE = 'hot_tolerance' CONF_KEEP_ALIVE = 'keep_alive' - +CONF_INITIAL_OPERATION_MODE = 'initial_operation_mode' SUPPORT_FLAGS = SUPPORT_TARGET_TEMPERATURE | SUPPORT_OPERATION_MODE PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ @@ -58,6 +59,8 @@ PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Optional(CONF_TARGET_TEMP): vol.Coerce(float), vol.Optional(CONF_KEEP_ALIVE): vol.All( cv.time_period, cv.positive_timedelta), + vol.Optional(CONF_INITIAL_OPERATION_MODE): + vol.In([STATE_AUTO, STATE_OFF]) }) @@ -75,11 +78,12 @@ def async_setup_platform(hass, config, async_add_devices, discovery_info=None): cold_tolerance = config.get(CONF_COLD_TOLERANCE) hot_tolerance = config.get(CONF_HOT_TOLERANCE) keep_alive = config.get(CONF_KEEP_ALIVE) + initial_operation_mode = config.get(CONF_INITIAL_OPERATION_MODE) async_add_devices([GenericThermostat( hass, name, heater_entity_id, sensor_entity_id, min_temp, max_temp, target_temp, ac_mode, min_cycle_duration, cold_tolerance, - hot_tolerance, keep_alive)]) + hot_tolerance, keep_alive, initial_operation_mode)]) class GenericThermostat(ClimateDevice): @@ -87,7 +91,8 @@ class GenericThermostat(ClimateDevice): def __init__(self, hass, name, heater_entity_id, sensor_entity_id, min_temp, max_temp, target_temp, ac_mode, min_cycle_duration, - cold_tolerance, hot_tolerance, keep_alive): + cold_tolerance, hot_tolerance, keep_alive, + initial_operation_mode): """Initialize the thermostat.""" self.hass = hass self._name = name @@ -97,7 +102,11 @@ class GenericThermostat(ClimateDevice): self._cold_tolerance = cold_tolerance self._hot_tolerance = hot_tolerance self._keep_alive = keep_alive - self._enabled = True + self._initial_operation_mode = initial_operation_mode + if initial_operation_mode == STATE_OFF: + self._enabled = False + else: + self._enabled = True self._active = False self._cur_temp = None @@ -122,14 +131,20 @@ class GenericThermostat(ClimateDevice): @asyncio.coroutine def async_added_to_hass(self): """Run when entity about to be added.""" - # If we have an old state and no target temp, restore - if self._target_temp is None: - old_state = yield from async_get_last_state(self.hass, - self.entity_id) - if old_state is not None: + # Check If we have an old state + old_state = yield from async_get_last_state(self.hass, + self.entity_id) + if old_state is not None: + # If we have no initial temperature, restore + if self._target_temp is None: self._target_temp = float( old_state.attributes[ATTR_TEMPERATURE]) + # If we have no initial operation mode, restore + if self._initial_operation_mode is None: + if old_state.attributes[ATTR_OPERATION_MODE] == STATE_OFF: + self._enabled = False + @property def should_poll(self): """Return the polling state.""" diff --git a/tests/components/climate/test_generic_thermostat.py b/tests/components/climate/test_generic_thermostat.py index 5982a6c16d8..63bbce2e7c6 100644 --- a/tests/components/climate/test_generic_thermostat.py +++ b/tests/components/climate/test_generic_thermostat.py @@ -205,6 +205,10 @@ class TestClimateGenericThermostat(unittest.TestCase): self.hass.block_till_done() state = self.hass.states.get(ENTITY) self.assertEqual(30.0, state.attributes.get('temperature')) + climate.set_temperature(self.hass, None) + self.hass.block_till_done() + state = self.hass.states.get(ENTITY) + self.assertEqual(30.0, state.attributes.get('temperature')) def test_sensor_bad_unit(self): """Test sensor that have bad unit.""" @@ -888,19 +892,22 @@ def test_custom_setup_params(hass): 'min_temp': MIN_TEMP, 'max_temp': MAX_TEMP, 'target_temp': TARGET_TEMP, + 'initial_operation_mode': STATE_OFF, }}) assert result state = hass.states.get(ENTITY) assert state.attributes.get('min_temp') == MIN_TEMP assert state.attributes.get('max_temp') == MAX_TEMP assert state.attributes.get('temperature') == TARGET_TEMP + assert state.attributes.get(climate.ATTR_OPERATION_MODE) == STATE_OFF @asyncio.coroutine def test_restore_state(hass): """Ensure states are restored on startup.""" mock_restore_cache(hass, ( - State('climate.test_thermostat', '0', {ATTR_TEMPERATURE: "20"}), + State('climate.test_thermostat', '0', {ATTR_TEMPERATURE: "20", + climate.ATTR_OPERATION_MODE: "off"}), )) hass.state = CoreState.starting @@ -915,3 +922,29 @@ def test_restore_state(hass): state = hass.states.get('climate.test_thermostat') assert(state.attributes[ATTR_TEMPERATURE] == 20) + assert(state.attributes[climate.ATTR_OPERATION_MODE] == "off") + + +@asyncio.coroutine +def test_no_restore_state(hass): + """Ensure states are not restored on startup if not needed.""" + mock_restore_cache(hass, ( + State('climate.test_thermostat', '0', {ATTR_TEMPERATURE: "20", + climate.ATTR_OPERATION_MODE: "off"}), + )) + + hass.state = CoreState.starting + + yield from async_setup_component( + hass, climate.DOMAIN, {'climate': { + 'platform': 'generic_thermostat', + 'name': 'test_thermostat', + 'heater': ENT_SWITCH, + 'target_sensor': ENT_SENSOR, + 'target_temp': 22, + 'initial_operation_mode': 'auto', + }}) + + state = hass.states.get('climate.test_thermostat') + assert(state.attributes[ATTR_TEMPERATURE] == 22) + assert(state.attributes[climate.ATTR_OPERATION_MODE] != "off") From 3af527b1b5fc0212e95968925394ddbc6158635d Mon Sep 17 00:00:00 2001 From: Adam Mills Date: Tue, 5 Dec 2017 09:13:09 -0500 Subject: [PATCH 229/246] Use new build path for dev translations (#10937) --- homeassistant/components/frontend/__init__.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index e1121fd0c4e..1fe27d7c74d 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -303,7 +303,7 @@ def async_setup(hass, config): "/home-assistant-polymer", repo_path, False) hass.http.register_static_path( "/static/translations", - os.path.join(repo_path, "build-translations"), False) + os.path.join(repo_path, "build-translations/output"), False) sw_path_es5 = os.path.join(repo_path, "build-es5/service_worker.js") sw_path_latest = os.path.join(repo_path, "build/service_worker.js") static_path = os.path.join(repo_path, 'hass_frontend') From 8e4942088e3b0214faa40806e2e9b32818c293d6 Mon Sep 17 00:00:00 2001 From: Mitko Masarliev Date: Wed, 6 Dec 2017 07:56:43 +0200 Subject: [PATCH 230/246] Add option to set default hide if away for new devices (#10762) * Option to change hide_if_away * tests fix * change new device defaults * tests and requested changes * fix assert --- .../components/device_tracker/__init__.py | 22 ++++++++++++++----- .../components/device_tracker/test_asuswrt.py | 15 ++++++++++--- tests/components/device_tracker/test_init.py | 22 ++++++++++++++----- .../device_tracker/test_unifi_direct.py | 9 ++++++-- 4 files changed, 53 insertions(+), 15 deletions(-) diff --git a/homeassistant/components/device_tracker/__init__.py b/homeassistant/components/device_tracker/__init__.py index 0b18cc72f6e..28505900f14 100644 --- a/homeassistant/components/device_tracker/__init__.py +++ b/homeassistant/components/device_tracker/__init__.py @@ -53,6 +53,7 @@ YAML_DEVICES = 'known_devices.yaml' CONF_TRACK_NEW = 'track_new_devices' DEFAULT_TRACK_NEW = True +CONF_NEW_DEVICE_DEFAULTS = 'new_device_defaults' CONF_CONSIDER_HOME = 'consider_home' DEFAULT_CONSIDER_HOME = timedelta(seconds=180) @@ -81,12 +82,18 @@ ATTR_VENDOR = 'vendor' SOURCE_TYPE_GPS = 'gps' SOURCE_TYPE_ROUTER = 'router' +NEW_DEVICE_DEFAULTS_SCHEMA = vol.Any(None, vol.Schema({ + vol.Optional(CONF_TRACK_NEW, default=DEFAULT_TRACK_NEW): cv.boolean, + vol.Optional(CONF_AWAY_HIDE, default=DEFAULT_AWAY_HIDE): cv.boolean, +})) PLATFORM_SCHEMA = cv.PLATFORM_SCHEMA.extend({ vol.Optional(CONF_SCAN_INTERVAL): cv.time_period, vol.Optional(CONF_TRACK_NEW, default=DEFAULT_TRACK_NEW): cv.boolean, vol.Optional(CONF_CONSIDER_HOME, default=DEFAULT_CONSIDER_HOME): vol.All( - cv.time_period, cv.positive_timedelta) + cv.time_period, cv.positive_timedelta), + vol.Optional(CONF_NEW_DEVICE_DEFAULTS, + default={}): NEW_DEVICE_DEFAULTS_SCHEMA }) @@ -125,9 +132,11 @@ def async_setup(hass: HomeAssistantType, config: ConfigType): conf = conf[0] if conf else {} consider_home = conf.get(CONF_CONSIDER_HOME, DEFAULT_CONSIDER_HOME) track_new = conf.get(CONF_TRACK_NEW, DEFAULT_TRACK_NEW) + defaults = conf.get(CONF_NEW_DEVICE_DEFAULTS, {}) devices = yield from async_load_config(yaml_path, hass, consider_home) - tracker = DeviceTracker(hass, consider_home, track_new, devices) + tracker = DeviceTracker( + hass, consider_home, track_new, defaults, devices) @asyncio.coroutine def async_setup_platform(p_type, p_config, disc_info=None): @@ -211,13 +220,15 @@ class DeviceTracker(object): """Representation of a device tracker.""" def __init__(self, hass: HomeAssistantType, consider_home: timedelta, - track_new: bool, devices: Sequence) -> None: + track_new: bool, defaults: dict, + devices: Sequence) -> None: """Initialize a device tracker.""" self.hass = hass self.devices = {dev.dev_id: dev for dev in devices} self.mac_to_dev = {dev.mac: dev for dev in devices if dev.mac} self.consider_home = consider_home - self.track_new = track_new + self.track_new = defaults.get(CONF_TRACK_NEW, track_new) + self.defaults = defaults self.group = None self._is_updating = asyncio.Lock(loop=hass.loop) @@ -274,7 +285,8 @@ class DeviceTracker(object): device = Device( self.hass, self.consider_home, self.track_new, dev_id, mac, (host_name or dev_id).replace('_', ' '), - picture=picture, icon=icon) + picture=picture, icon=icon, + hide_if_away=self.defaults.get(CONF_AWAY_HIDE, DEFAULT_AWAY_HIDE)) self.devices[dev_id] = device if mac is not None: self.mac_to_dev[mac] = device diff --git a/tests/components/device_tracker/test_asuswrt.py b/tests/components/device_tracker/test_asuswrt.py index b507bfea7c9..a6827d165cd 100644 --- a/tests/components/device_tracker/test_asuswrt.py +++ b/tests/components/device_tracker/test_asuswrt.py @@ -9,7 +9,8 @@ import voluptuous as vol from homeassistant.setup import setup_component from homeassistant.components import device_tracker from homeassistant.components.device_tracker import ( - CONF_CONSIDER_HOME, CONF_TRACK_NEW) + CONF_CONSIDER_HOME, CONF_TRACK_NEW, CONF_NEW_DEVICE_DEFAULTS, + CONF_AWAY_HIDE) from homeassistant.components.device_tracker.asuswrt import ( CONF_PROTOCOL, CONF_MODE, CONF_PUB_KEY, DOMAIN, CONF_PORT, PLATFORM_SCHEMA) @@ -78,7 +79,11 @@ class TestComponentsDeviceTrackerASUSWRT(unittest.TestCase): CONF_USERNAME: 'fake_user', CONF_PASSWORD: 'fake_pass', CONF_TRACK_NEW: True, - CONF_CONSIDER_HOME: timedelta(seconds=180) + CONF_CONSIDER_HOME: timedelta(seconds=180), + CONF_NEW_DEVICE_DEFAULTS: { + CONF_TRACK_NEW: True, + CONF_AWAY_HIDE: False + } } } @@ -104,7 +109,11 @@ class TestComponentsDeviceTrackerASUSWRT(unittest.TestCase): CONF_USERNAME: 'fake_user', CONF_PUB_KEY: FAKEFILE, CONF_TRACK_NEW: True, - CONF_CONSIDER_HOME: timedelta(seconds=180) + CONF_CONSIDER_HOME: timedelta(seconds=180), + CONF_NEW_DEVICE_DEFAULTS: { + CONF_TRACK_NEW: True, + CONF_AWAY_HIDE: False + } } } diff --git a/tests/components/device_tracker/test_init.py b/tests/components/device_tracker/test_init.py index 704b2590f12..34c7ecf465d 100644 --- a/tests/components/device_tracker/test_init.py +++ b/tests/components/device_tracker/test_init.py @@ -123,7 +123,7 @@ class TestComponentsDeviceTracker(unittest.TestCase): 'My device', None, None, False), device_tracker.Device(self.hass, True, True, 'your_device', 'AB:01', 'Your device', None, None, False)] - device_tracker.DeviceTracker(self.hass, False, True, devices) + device_tracker.DeviceTracker(self.hass, False, True, {}, devices) _LOGGER.debug(mock_warning.call_args_list) assert mock_warning.call_count == 1, \ "The only warning call should be duplicates (check DEBUG)" @@ -137,7 +137,7 @@ class TestComponentsDeviceTracker(unittest.TestCase): 'AB:01', 'My device', None, None, False), device_tracker.Device(self.hass, True, True, 'my_device', None, 'Your device', None, None, False)] - device_tracker.DeviceTracker(self.hass, False, True, devices) + device_tracker.DeviceTracker(self.hass, False, True, {}, devices) _LOGGER.debug(mock_warning.call_args_list) assert mock_warning.call_count == 1, \ @@ -299,7 +299,7 @@ class TestComponentsDeviceTracker(unittest.TestCase): vendor_string = 'Raspberry Pi Foundation' tracker = device_tracker.DeviceTracker( - self.hass, timedelta(seconds=60), 0, []) + self.hass, timedelta(seconds=60), 0, {}, []) with mock_aiohttp_client() as aioclient_mock: aioclient_mock.get('http://api.macvendors.com/b8:27:eb', @@ -622,7 +622,7 @@ class TestComponentsDeviceTracker(unittest.TestCase): def test_see_failures(self, mock_warning): """Test that the device tracker see failures.""" tracker = device_tracker.DeviceTracker( - self.hass, timedelta(seconds=60), 0, []) + self.hass, timedelta(seconds=60), 0, {}, []) # MAC is not a string (but added) tracker.see(mac=567, host_name="Number MAC") @@ -654,7 +654,7 @@ class TestComponentsDeviceTracker(unittest.TestCase): def test_picture_and_icon_on_see_discovery(self): """Test that picture and icon are set in initial see.""" tracker = device_tracker.DeviceTracker( - self.hass, timedelta(seconds=60), False, []) + self.hass, timedelta(seconds=60), False, {}, []) tracker.see(dev_id=11, picture='pic_url', icon='mdi:icon') self.hass.block_till_done() config = device_tracker.load_config(self.yaml_devices, self.hass, @@ -663,6 +663,18 @@ class TestComponentsDeviceTracker(unittest.TestCase): assert config[0].icon == 'mdi:icon' assert config[0].entity_picture == 'pic_url' + def test_default_hide_if_away_is_used(self): + """Test that default track_new is used.""" + tracker = device_tracker.DeviceTracker( + self.hass, timedelta(seconds=60), False, + {device_tracker.CONF_AWAY_HIDE: True}, []) + tracker.see(dev_id=12) + self.hass.block_till_done() + config = device_tracker.load_config(self.yaml_devices, self.hass, + timedelta(seconds=0)) + assert len(config) == 1 + self.assertTrue(config[0].hidden) + @asyncio.coroutine def test_async_added_to_hass(hass): diff --git a/tests/components/device_tracker/test_unifi_direct.py b/tests/components/device_tracker/test_unifi_direct.py index 0e22758d07e..b378118141a 100644 --- a/tests/components/device_tracker/test_unifi_direct.py +++ b/tests/components/device_tracker/test_unifi_direct.py @@ -11,7 +11,8 @@ import voluptuous as vol from homeassistant.setup import setup_component from homeassistant.components import device_tracker from homeassistant.components.device_tracker import ( - CONF_CONSIDER_HOME, CONF_TRACK_NEW) + CONF_CONSIDER_HOME, CONF_TRACK_NEW, CONF_AWAY_HIDE, + CONF_NEW_DEVICE_DEFAULTS) from homeassistant.components.device_tracker.unifi_direct import ( DOMAIN, CONF_PORT, PLATFORM_SCHEMA, _response_to_json, get_scanner) from homeassistant.const import (CONF_PLATFORM, CONF_PASSWORD, CONF_USERNAME, @@ -54,7 +55,11 @@ class TestComponentsDeviceTrackerUnifiDirect(unittest.TestCase): CONF_USERNAME: 'fake_user', CONF_PASSWORD: 'fake_pass', CONF_TRACK_NEW: True, - CONF_CONSIDER_HOME: timedelta(seconds=180) + CONF_CONSIDER_HOME: timedelta(seconds=180), + CONF_NEW_DEVICE_DEFAULTS: { + CONF_TRACK_NEW: True, + CONF_AWAY_HIDE: False + } } } From 454d8535f8a90439672513bbeb9d2f5d61efc087 Mon Sep 17 00:00:00 2001 From: William Scanlon Date: Wed, 6 Dec 2017 01:07:59 -0500 Subject: [PATCH 231/246] Allow chime to work for wink siren/chime (#10961) * Allow Wink siren/chimes to work * Updated requirements_all.txt --- homeassistant/components/wink/__init__.py | 16 +++++++++------- requirements_all.txt | 2 +- 2 files changed, 10 insertions(+), 8 deletions(-) diff --git a/homeassistant/components/wink/__init__.py b/homeassistant/components/wink/__init__.py index 426893ec306..18e14b2e912 100644 --- a/homeassistant/components/wink/__init__.py +++ b/homeassistant/components/wink/__init__.py @@ -28,7 +28,7 @@ import homeassistant.helpers.config_validation as cv from homeassistant.config import load_yaml_config_file from homeassistant.util.json import load_json, save_json -REQUIREMENTS = ['python-wink==1.7.0', 'pubnubsub-handler==1.0.2'] +REQUIREMENTS = ['python-wink==1.7.1', 'pubnubsub-handler==1.0.2'] _LOGGER = logging.getLogger(__name__) @@ -460,10 +460,11 @@ def setup(hass, config): sirens_to_set.append(siren) for siren in sirens_to_set: + _man = siren.wink.device_manufacturer() if (service.service != SERVICE_SET_AUTO_SHUTOFF and service.service != SERVICE_ENABLE_SIREN and - siren.wink.device_manufacturer() != 'dome'): - _LOGGER.error("Service only valid for Dome sirens.") + (_man != 'dome' and _man != 'wink')): + _LOGGER.error("Service only valid for Dome or Wink sirens.") return if service.service == SERVICE_ENABLE_SIREN: @@ -494,10 +495,11 @@ def setup(hass, config): component = EntityComponent(_LOGGER, DOMAIN, hass) sirens = [] - has_dome_siren = False + has_dome_or_wink_siren = False for siren in pywink.get_sirens(): - if siren.device_manufacturer() == "dome": - has_dome_siren = True + _man = siren.device_manufacturer() + if _man == "dome" or _man == "wink": + has_dome_or_wink_siren = True _id = siren.object_id() + siren.name() if _id not in hass.data[DOMAIN]['unique_ids']: sirens.append(WinkSirenDevice(siren, hass)) @@ -514,7 +516,7 @@ def setup(hass, config): descriptions.get(SERVICE_ENABLE_SIREN), schema=ENABLED_SIREN_SCHEMA) - if has_dome_siren: + if has_dome_or_wink_siren: hass.services.register(DOMAIN, SERVICE_SET_SIREN_TONE, service_handle, diff --git a/requirements_all.txt b/requirements_all.txt index da2492edebd..01532893ef3 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -895,7 +895,7 @@ python-velbus==2.0.11 python-vlc==1.1.2 # homeassistant.components.wink -python-wink==1.7.0 +python-wink==1.7.1 # homeassistant.components.sensor.swiss_public_transport python_opendata_transport==0.0.3 From ddec566e10c701b410a162314d6cd0d29939ad76 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Tue, 5 Dec 2017 22:08:09 -0800 Subject: [PATCH 232/246] Revert pychromecast update (#10989) * Revert pychromecast update * Update cast.py --- homeassistant/components/media_player/cast.py | 4 +++- requirements_all.txt | 2 +- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/media_player/cast.py b/homeassistant/components/media_player/cast.py index ca3da7ae165..6ae44495e3e 100644 --- a/homeassistant/components/media_player/cast.py +++ b/homeassistant/components/media_player/cast.py @@ -20,7 +20,9 @@ from homeassistant.const import ( import homeassistant.helpers.config_validation as cv import homeassistant.util.dt as dt_util -REQUIREMENTS = ['pychromecast==1.0.2'] +# Do not upgrade to 1.0.2, it breaks a bunch of stuff +# https://github.com/home-assistant/home-assistant/issues/10926 +REQUIREMENTS = ['pychromecast==0.8.2'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index 01532893ef3..7f2bab02545 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -632,7 +632,7 @@ pybbox==0.0.5-alpha # pybluez==0.22 # homeassistant.components.media_player.cast -pychromecast==1.0.2 +pychromecast==0.8.2 # homeassistant.components.media_player.cmus pycmus==0.1.0 From 87fe674c70c520d39d65c9f3dc8bb1db49755695 Mon Sep 17 00:00:00 2001 From: Andrey Date: Wed, 6 Dec 2017 08:09:41 +0200 Subject: [PATCH 233/246] Require FF43 for latest js (#10941) * Require FF43 for latest js `Array.prototype.includes` added in Firefox 43 https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/includes * Update __init__.py --- homeassistant/components/frontend/__init__.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index 1fe27d7c74d..83e42d7651e 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -583,9 +583,9 @@ def _is_latest(js_option, request): family_min_version = { 'Chrome': 50, # Probably can reduce this - 'Firefox': 41, # Destructuring added in 41 + 'Firefox': 43, # Array.protopype.includes added in 43 'Opera': 40, # Probably can reduce this - 'Edge': 14, # Maybe can reduce this + 'Edge': 14, # Array.protopype.includes added in 14 'Safari': 10, # many features not supported by 9 } version = family_min_version.get(useragent.browser.family) From fd6373c7aa85020b6c2d560c32c4a54ef159dba6 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Tue, 5 Dec 2017 22:10:47 -0800 Subject: [PATCH 234/246] Version bump to 0.59.2 --- homeassistant/const.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/homeassistant/const.py b/homeassistant/const.py index ad7879fc0f5..3f578a251cf 100644 --- a/homeassistant/const.py +++ b/homeassistant/const.py @@ -2,7 +2,7 @@ """Constants used by Home Assistant components.""" MAJOR_VERSION = 0 MINOR_VERSION = 59 -PATCH_VERSION = '1' +PATCH_VERSION = '2' __short_version__ = '{}.{}'.format(MAJOR_VERSION, MINOR_VERSION) __version__ = '{}.{}'.format(__short_version__, PATCH_VERSION) REQUIRED_PYTHON_VER = (3, 4, 2) From 22c36f0ad324e9408335a65c5c26d53359e280b0 Mon Sep 17 00:00:00 2001 From: Andrey Date: Wed, 6 Dec 2017 08:09:41 +0200 Subject: [PATCH 235/246] Require FF43 for latest js (#10941) * Require FF43 for latest js `Array.prototype.includes` added in Firefox 43 https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/includes * Update __init__.py --- homeassistant/components/frontend/__init__.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index e1121fd0c4e..56af5e07123 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -583,9 +583,9 @@ def _is_latest(js_option, request): family_min_version = { 'Chrome': 50, # Probably can reduce this - 'Firefox': 41, # Destructuring added in 41 + 'Firefox': 43, # Array.protopype.includes added in 43 'Opera': 40, # Probably can reduce this - 'Edge': 14, # Maybe can reduce this + 'Edge': 14, # Array.protopype.includes added in 14 'Safari': 10, # many features not supported by 9 } version = family_min_version.get(useragent.browser.family) From bdb7a29586e8a6c67011f1f2852b8a669bdcff58 Mon Sep 17 00:00:00 2001 From: Mateusz Drab Date: Mon, 4 Dec 2017 17:58:52 +0000 Subject: [PATCH 236/246] Fix linksys_ap.py by inheriting DeviceScanner (#10947) As per issue #8638, the class wasn't inheriting from DeviceScanner, this commit patches it up. --- homeassistant/components/device_tracker/linksys_ap.py | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/device_tracker/linksys_ap.py b/homeassistant/components/device_tracker/linksys_ap.py index 196235f32f4..20dc9052e11 100644 --- a/homeassistant/components/device_tracker/linksys_ap.py +++ b/homeassistant/components/device_tracker/linksys_ap.py @@ -11,7 +11,8 @@ import requests import voluptuous as vol import homeassistant.helpers.config_validation as cv -from homeassistant.components.device_tracker import DOMAIN, PLATFORM_SCHEMA +from homeassistant.components.device_tracker import ( + DOMAIN, PLATFORM_SCHEMA, DeviceScanner) from homeassistant.const import ( CONF_HOST, CONF_PASSWORD, CONF_USERNAME, CONF_VERIFY_SSL) @@ -38,7 +39,7 @@ def get_scanner(hass, config): return None -class LinksysAPDeviceScanner(object): +class LinksysAPDeviceScanner(DeviceScanner): """This class queries a Linksys Access Point.""" def __init__(self, config): From f9743c29cddb1705bac2936ae015db7eba43fc25 Mon Sep 17 00:00:00 2001 From: Erik Eriksson Date: Mon, 4 Dec 2017 17:26:07 +0100 Subject: [PATCH 237/246] Upgrade tellduslive library version (closes https://github.com/home-assistant/home-assistant/issues/10922) (#10950) --- homeassistant/components/tellduslive.py | 2 +- requirements_all.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/tellduslive.py b/homeassistant/components/tellduslive.py index ba7c1afd286..28bf65bc4c5 100644 --- a/homeassistant/components/tellduslive.py +++ b/homeassistant/components/tellduslive.py @@ -24,7 +24,7 @@ APPLICATION_NAME = 'Home Assistant' DOMAIN = 'tellduslive' -REQUIREMENTS = ['tellduslive==0.10.3'] +REQUIREMENTS = ['tellduslive==0.10.4'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index 88cdb4bcdfa..3385c1f662a 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -1063,7 +1063,7 @@ tellcore-net==0.3 tellcore-py==1.1.2 # homeassistant.components.tellduslive -tellduslive==0.10.3 +tellduslive==0.10.4 # homeassistant.components.sensor.temper temperusb==1.5.3 From 63d673461248d573730954851783f35166f5ff81 Mon Sep 17 00:00:00 2001 From: William Scanlon Date: Wed, 6 Dec 2017 01:07:59 -0500 Subject: [PATCH 238/246] Allow chime to work for wink siren/chime (#10961) * Allow Wink siren/chimes to work * Updated requirements_all.txt --- homeassistant/components/wink/__init__.py | 16 +++++++++------- requirements_all.txt | 2 +- 2 files changed, 10 insertions(+), 8 deletions(-) diff --git a/homeassistant/components/wink/__init__.py b/homeassistant/components/wink/__init__.py index 426893ec306..18e14b2e912 100644 --- a/homeassistant/components/wink/__init__.py +++ b/homeassistant/components/wink/__init__.py @@ -28,7 +28,7 @@ import homeassistant.helpers.config_validation as cv from homeassistant.config import load_yaml_config_file from homeassistant.util.json import load_json, save_json -REQUIREMENTS = ['python-wink==1.7.0', 'pubnubsub-handler==1.0.2'] +REQUIREMENTS = ['python-wink==1.7.1', 'pubnubsub-handler==1.0.2'] _LOGGER = logging.getLogger(__name__) @@ -460,10 +460,11 @@ def setup(hass, config): sirens_to_set.append(siren) for siren in sirens_to_set: + _man = siren.wink.device_manufacturer() if (service.service != SERVICE_SET_AUTO_SHUTOFF and service.service != SERVICE_ENABLE_SIREN and - siren.wink.device_manufacturer() != 'dome'): - _LOGGER.error("Service only valid for Dome sirens.") + (_man != 'dome' and _man != 'wink')): + _LOGGER.error("Service only valid for Dome or Wink sirens.") return if service.service == SERVICE_ENABLE_SIREN: @@ -494,10 +495,11 @@ def setup(hass, config): component = EntityComponent(_LOGGER, DOMAIN, hass) sirens = [] - has_dome_siren = False + has_dome_or_wink_siren = False for siren in pywink.get_sirens(): - if siren.device_manufacturer() == "dome": - has_dome_siren = True + _man = siren.device_manufacturer() + if _man == "dome" or _man == "wink": + has_dome_or_wink_siren = True _id = siren.object_id() + siren.name() if _id not in hass.data[DOMAIN]['unique_ids']: sirens.append(WinkSirenDevice(siren, hass)) @@ -514,7 +516,7 @@ def setup(hass, config): descriptions.get(SERVICE_ENABLE_SIREN), schema=ENABLED_SIREN_SCHEMA) - if has_dome_siren: + if has_dome_or_wink_siren: hass.services.register(DOMAIN, SERVICE_SET_SIREN_TONE, service_handle, diff --git a/requirements_all.txt b/requirements_all.txt index 3385c1f662a..8b78f254bd8 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -883,7 +883,7 @@ python-velbus==2.0.11 python-vlc==1.1.2 # homeassistant.components.wink -python-wink==1.7.0 +python-wink==1.7.1 # homeassistant.components.sensor.swiss_public_transport python_opendata_transport==0.0.3 From 3f764f19815f8f3df406ec1b2f13b0fb9ff08e91 Mon Sep 17 00:00:00 2001 From: "Craig J. Ward" Date: Tue, 5 Dec 2017 03:47:48 -0600 Subject: [PATCH 239/246] Reload closest store on api menu request (#10962) * reload closest store on api request * revert change from debugging --- homeassistant/components/dominos.py | 1 + 1 file changed, 1 insertion(+) diff --git a/homeassistant/components/dominos.py b/homeassistant/components/dominos.py index 633ea1b0c5e..0d6645f37c1 100644 --- a/homeassistant/components/dominos.py +++ b/homeassistant/components/dominos.py @@ -136,6 +136,7 @@ class Dominos(): def get_menu(self): """Return the products from the closest stores menu.""" + self.update_closest_store() if self.closest_store is None: _LOGGER.warning('Cannot get menu. Store may be closed') return [] From 56c694b477936c0ad86b4e8e7a63d5e4f455e4a3 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Tue, 5 Dec 2017 22:08:09 -0800 Subject: [PATCH 240/246] Revert pychromecast update (#10989) * Revert pychromecast update * Update cast.py --- homeassistant/components/media_player/cast.py | 4 +++- requirements_all.txt | 2 +- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/media_player/cast.py b/homeassistant/components/media_player/cast.py index ca3da7ae165..6ae44495e3e 100644 --- a/homeassistant/components/media_player/cast.py +++ b/homeassistant/components/media_player/cast.py @@ -20,7 +20,9 @@ from homeassistant.const import ( import homeassistant.helpers.config_validation as cv import homeassistant.util.dt as dt_util -REQUIREMENTS = ['pychromecast==1.0.2'] +# Do not upgrade to 1.0.2, it breaks a bunch of stuff +# https://github.com/home-assistant/home-assistant/issues/10926 +REQUIREMENTS = ['pychromecast==0.8.2'] _LOGGER = logging.getLogger(__name__) diff --git a/requirements_all.txt b/requirements_all.txt index 8b78f254bd8..56c78e1c70d 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -623,7 +623,7 @@ pybbox==0.0.5-alpha # pybluez==0.22 # homeassistant.components.media_player.cast -pychromecast==1.0.2 +pychromecast==0.8.2 # homeassistant.components.media_player.cmus pycmus==0.1.0 From 5f4baa67dc2ef3be59eaf01c78a1e1007cc2713f Mon Sep 17 00:00:00 2001 From: Dan Nixon Date: Wed, 6 Dec 2017 07:38:27 +0000 Subject: [PATCH 241/246] Allow disabling the LEDs on TP-Link smart plugs (#10980) --- homeassistant/components/switch/tplink.py | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/homeassistant/components/switch/tplink.py b/homeassistant/components/switch/tplink.py index 6e8c1a6b9bb..0772cc9277c 100644 --- a/homeassistant/components/switch/tplink.py +++ b/homeassistant/components/switch/tplink.py @@ -22,9 +22,12 @@ ATTR_TOTAL_CONSUMPTION = 'total_consumption' ATTR_DAILY_CONSUMPTION = 'daily_consumption' ATTR_CURRENT = 'current' +CONF_LEDS = 'enable_leds' + PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ vol.Required(CONF_HOST): cv.string, vol.Optional(CONF_NAME): cv.string, + vol.Optional(CONF_LEDS, default=True): cv.boolean, }) @@ -34,17 +37,19 @@ def setup_platform(hass, config, add_devices, discovery_info=None): from pyHS100 import SmartPlug host = config.get(CONF_HOST) name = config.get(CONF_NAME) + leds_on = config.get(CONF_LEDS) - add_devices([SmartPlugSwitch(SmartPlug(host), name)], True) + add_devices([SmartPlugSwitch(SmartPlug(host), name, leds_on)], True) class SmartPlugSwitch(SwitchDevice): """Representation of a TPLink Smart Plug switch.""" - def __init__(self, smartplug, name): + def __init__(self, smartplug, name, leds_on): """Initialize the switch.""" self.smartplug = smartplug self._name = name + self._leds_on = leds_on self._state = None self._available = True # Set up emeter cache @@ -89,6 +94,8 @@ class SmartPlugSwitch(SwitchDevice): if self._name is None: self._name = self.smartplug.alias + self.smartplug.led = self._leds_on + if self.smartplug.has_emeter: emeter_readings = self.smartplug.get_emeter_realtime() From c13b510ba390ab4e833b496879f1c62f05a6e6af Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Tue, 5 Dec 2017 23:40:31 -0800 Subject: [PATCH 242/246] Update frontend to 20171206.0 --- homeassistant/components/frontend/__init__.py | 2 +- requirements_all.txt | 2 +- requirements_test_all.txt | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/homeassistant/components/frontend/__init__.py b/homeassistant/components/frontend/__init__.py index 83e42d7651e..3d669ddc4d1 100644 --- a/homeassistant/components/frontend/__init__.py +++ b/homeassistant/components/frontend/__init__.py @@ -23,7 +23,7 @@ from homeassistant.const import CONF_NAME, EVENT_THEMES_UPDATED from homeassistant.core import callback from homeassistant.loader import bind_hass -REQUIREMENTS = ['home-assistant-frontend==20171204.0', 'user-agents==1.1.0'] +REQUIREMENTS = ['home-assistant-frontend==20171206.0', 'user-agents==1.1.0'] DOMAIN = 'frontend' DEPENDENCIES = ['api', 'websocket_api', 'http', 'system_log'] diff --git a/requirements_all.txt b/requirements_all.txt index 7f2bab02545..840ed5a834a 100644 --- a/requirements_all.txt +++ b/requirements_all.txt @@ -337,7 +337,7 @@ hipnotify==1.0.8 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171204.0 +home-assistant-frontend==20171206.0 # homeassistant.components.camera.onvif http://github.com/tgaugry/suds-passworddigest-py3/archive/86fc50e39b4d2b8997481967d6a7fe1c57118999.zip#suds-passworddigest-py3==0.1.2a diff --git a/requirements_test_all.txt b/requirements_test_all.txt index b858c8a1c0e..72325d6305b 100644 --- a/requirements_test_all.txt +++ b/requirements_test_all.txt @@ -74,7 +74,7 @@ hbmqtt==0.9.1 holidays==0.8.1 # homeassistant.components.frontend -home-assistant-frontend==20171204.0 +home-assistant-frontend==20171206.0 # homeassistant.components.influxdb # homeassistant.components.sensor.influxdb From e66268dffe54358e98b5c8cfdf2a0b9dfa3ae9dc Mon Sep 17 00:00:00 2001 From: Mitko Masarliev Date: Wed, 6 Dec 2017 10:24:20 +0200 Subject: [PATCH 243/246] Meraki AP Device tracker (#10971) * Device tracker for meraki AP * styles fix * fix again * again * and again :) * fix hide if away * docs and optimization * tests and fixes * styles * styles * styles * styles * styles fix. Hope last * clear track new * changes * fix accuracy error and requested changes * remove meraki from .coveragerc * tests and minor changes * remove location --- .../components/device_tracker/meraki.py | 116 +++++++++++++++ .../components/device_tracker/test_meraki.py | 139 ++++++++++++++++++ 2 files changed, 255 insertions(+) create mode 100644 homeassistant/components/device_tracker/meraki.py create mode 100644 tests/components/device_tracker/test_meraki.py diff --git a/homeassistant/components/device_tracker/meraki.py b/homeassistant/components/device_tracker/meraki.py new file mode 100644 index 00000000000..319c19d7b73 --- /dev/null +++ b/homeassistant/components/device_tracker/meraki.py @@ -0,0 +1,116 @@ +""" +Support for the Meraki CMX location service. + +For more details about this platform, please refer to the documentation at +https://home-assistant.io/components/device_tracker.meraki/ + +""" +import asyncio +import logging +import json + +import voluptuous as vol +import homeassistant.helpers.config_validation as cv +from homeassistant.const import (HTTP_BAD_REQUEST, HTTP_UNPROCESSABLE_ENTITY) +from homeassistant.core import callback +from homeassistant.components.http import HomeAssistantView +from homeassistant.components.device_tracker import ( + PLATFORM_SCHEMA, SOURCE_TYPE_ROUTER) + +CONF_VALIDATOR = 'validator' +CONF_SECRET = 'secret' +DEPENDENCIES = ['http'] +URL = '/api/meraki' +VERSION = '2.0' + + +_LOGGER = logging.getLogger(__name__) + + +PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ + vol.Required(CONF_VALIDATOR): cv.string, + vol.Required(CONF_SECRET): cv.string +}) + + +@asyncio.coroutine +def async_setup_scanner(hass, config, async_see, discovery_info=None): + """Set up an endpoint for the Meraki tracker.""" + hass.http.register_view( + MerakiView(config, async_see)) + + return True + + +class MerakiView(HomeAssistantView): + """View to handle Meraki requests.""" + + url = URL + name = 'api:meraki' + + def __init__(self, config, async_see): + """Initialize Meraki URL endpoints.""" + self.async_see = async_see + self.validator = config[CONF_VALIDATOR] + self.secret = config[CONF_SECRET] + + @asyncio.coroutine + def get(self, request): + """Meraki message received as GET.""" + return self.validator + + @asyncio.coroutine + def post(self, request): + """Meraki CMX message received.""" + try: + data = yield from request.json() + except ValueError: + return self.json_message('Invalid JSON', HTTP_BAD_REQUEST) + _LOGGER.debug("Meraki Data from Post: %s", json.dumps(data)) + if not data.get('secret', False): + _LOGGER.error("secret invalid") + return self.json_message('No secret', HTTP_UNPROCESSABLE_ENTITY) + if data['secret'] != self.secret: + _LOGGER.error("Invalid Secret received from Meraki") + return self.json_message('Invalid secret', + HTTP_UNPROCESSABLE_ENTITY) + elif data['version'] != VERSION: + _LOGGER.error("Invalid API version: %s", data['version']) + return self.json_message('Invalid version', + HTTP_UNPROCESSABLE_ENTITY) + else: + _LOGGER.debug('Valid Secret') + if data['type'] not in ('DevicesSeen', 'BluetoothDevicesSeen'): + _LOGGER.error("Unknown Device %s", data['type']) + return self.json_message('Invalid device type', + HTTP_UNPROCESSABLE_ENTITY) + _LOGGER.debug("Processing %s", data['type']) + if len(data["data"]["observations"]) == 0: + _LOGGER.debug("No observations found") + return + self._handle(request.app['hass'], data) + + @callback + def _handle(self, hass, data): + for i in data["data"]["observations"]: + data["data"]["secret"] = "hidden" + mac = i["clientMac"] + _LOGGER.debug("clientMac: %s", mac) + attrs = {} + if i.get('os', False): + attrs['os'] = i['os'] + if i.get('manufacturer', False): + attrs['manufacturer'] = i['manufacturer'] + if i.get('ipv4', False): + attrs['ipv4'] = i['ipv4'] + if i.get('ipv6', False): + attrs['ipv6'] = i['ipv6'] + if i.get('seenTime', False): + attrs['seenTime'] = i['seenTime'] + if i.get('ssid', False): + attrs['ssid'] = i['ssid'] + hass.async_add_job(self.async_see( + mac=mac, + source_type=SOURCE_TYPE_ROUTER, + attributes=attrs + )) diff --git a/tests/components/device_tracker/test_meraki.py b/tests/components/device_tracker/test_meraki.py new file mode 100644 index 00000000000..a739df804fd --- /dev/null +++ b/tests/components/device_tracker/test_meraki.py @@ -0,0 +1,139 @@ +"""The tests the for Meraki device tracker.""" +import asyncio +import json +from unittest.mock import patch +import pytest +from homeassistant.components.device_tracker.meraki import ( + CONF_VALIDATOR, CONF_SECRET) +from homeassistant.setup import async_setup_component +import homeassistant.components.device_tracker as device_tracker +from homeassistant.const import CONF_PLATFORM +from homeassistant.components.device_tracker.meraki import URL + + +@pytest.fixture +def meraki_client(loop, hass, test_client): + """Meraki mock client.""" + assert loop.run_until_complete(async_setup_component( + hass, device_tracker.DOMAIN, { + device_tracker.DOMAIN: { + CONF_PLATFORM: 'meraki', + CONF_VALIDATOR: 'validator', + CONF_SECRET: 'secret' + + } + })) + + with patch('homeassistant.components.device_tracker.update_config'): + yield loop.run_until_complete(test_client(hass.http.app)) + + +@asyncio.coroutine +def test_invalid_or_missing_data(meraki_client): + """Test validator with invalid or missing data.""" + req = yield from meraki_client.get(URL) + text = yield from req.text() + assert req.status == 200 + assert text == 'validator' + + req = yield from meraki_client.post(URL, data=b"invalid") + text = yield from req.json() + assert req.status == 400 + assert text['message'] == 'Invalid JSON' + + req = yield from meraki_client.post(URL, data=b"{}") + text = yield from req.json() + assert req.status == 422 + assert text['message'] == 'No secret' + + data = { + "version": "1.0", + "secret": "secret" + } + req = yield from meraki_client.post(URL, data=json.dumps(data)) + text = yield from req.json() + assert req.status == 422 + assert text['message'] == 'Invalid version' + + data = { + "version": "2.0", + "secret": "invalid" + } + req = yield from meraki_client.post(URL, data=json.dumps(data)) + text = yield from req.json() + assert req.status == 422 + assert text['message'] == 'Invalid secret' + + data = { + "version": "2.0", + "secret": "secret", + "type": "InvalidType" + } + req = yield from meraki_client.post(URL, data=json.dumps(data)) + text = yield from req.json() + assert req.status == 422 + assert text['message'] == 'Invalid device type' + + data = { + "version": "2.0", + "secret": "secret", + "type": "BluetoothDevicesSeen", + "data": { + "observations": [] + } + } + req = yield from meraki_client.post(URL, data=json.dumps(data)) + assert req.status == 200 + + +@asyncio.coroutine +def test_data_will_be_saved(hass, meraki_client): + """Test with valid data.""" + data = { + "version": "2.0", + "secret": "secret", + "type": "DevicesSeen", + "data": { + "observations": [ + { + "location": { + "lat": "51.5355157", + "lng": "21.0699035", + "unc": "46.3610585", + }, + "seenTime": "2016-09-12T16:23:13Z", + "ssid": 'ssid', + "os": 'HA', + "ipv6": '2607:f0d0:1002:51::4/64', + "clientMac": "00:26:ab:b8:a9:a4", + "seenEpoch": "147369739", + "rssi": "20", + "manufacturer": "Seiko Epson" + }, + { + "location": { + "lat": "51.5355357", + "lng": "21.0699635", + "unc": "46.3610585", + }, + "seenTime": "2016-09-12T16:21:13Z", + "ssid": 'ssid', + "os": 'HA', + "ipv4": '192.168.0.1', + "clientMac": "00:26:ab:b8:a9:a5", + "seenEpoch": "147369750", + "rssi": "20", + "manufacturer": "Seiko Epson" + } + ] + } + } + req = yield from meraki_client.post(URL, data=json.dumps(data)) + assert req.status == 200 + state_name = hass.states.get('{}.{}'.format('device_tracker', + '0026abb8a9a4')).state + assert 'home' == state_name + + state_name = hass.states.get('{}.{}'.format('device_tracker', + '0026abb8a9a5')).state + assert 'home' == state_name From 9cff6c7e6abc14bc0ea5232ef4861832d727ca67 Mon Sep 17 00:00:00 2001 From: Pascal Vizeli Date: Wed, 6 Dec 2017 12:44:41 +0100 Subject: [PATCH 244/246] Update tradfri.py (#10991) --- homeassistant/components/light/tradfri.py | 34 +++++++++++------------ 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/homeassistant/components/light/tradfri.py b/homeassistant/components/light/tradfri.py index 3bba6da8dd3..dc8e7f4c996 100644 --- a/homeassistant/components/light/tradfri.py +++ b/homeassistant/components/light/tradfri.py @@ -99,7 +99,7 @@ class TradfriGroup(Light): @asyncio.coroutine def async_turn_off(self, **kwargs): """Instruct the group lights to turn off.""" - self.hass.async_add_job(self._api(self._group.set_state(0))) + yield from self._api(self._group.set_state(0)) @asyncio.coroutine def async_turn_on(self, **kwargs): @@ -112,10 +112,10 @@ class TradfriGroup(Light): if kwargs[ATTR_BRIGHTNESS] == 255: kwargs[ATTR_BRIGHTNESS] = 254 - self.hass.async_add_job(self._api( - self._group.set_dimmer(kwargs[ATTR_BRIGHTNESS], **keys))) + yield from self._api( + self._group.set_dimmer(kwargs[ATTR_BRIGHTNESS], **keys)) else: - self.hass.async_add_job(self._api(self._group.set_state(1))) + yield from self._api(self._group.set_state(1)) @callback def _async_start_observe(self, exc=None): @@ -140,11 +140,11 @@ class TradfriGroup(Light): self._group = group self._name = group.name + @callback def _observe_update(self, tradfri_device): """Receive new state data for this light.""" self._refresh(tradfri_device) - - self.hass.async_add_job(self.async_update_ha_state()) + self.async_schedule_update_ha_state() class TradfriLight(Light): @@ -238,8 +238,7 @@ class TradfriLight(Light): @asyncio.coroutine def async_turn_off(self, **kwargs): """Instruct the light to turn off.""" - self.hass.async_add_job(self._api( - self._light_control.set_state(False))) + yield from self._api(self._light_control.set_state(False)) @asyncio.coroutine def async_turn_on(self, **kwargs): @@ -250,17 +249,17 @@ class TradfriLight(Light): for ATTR_RGB_COLOR, this also supports Philips Hue bulbs. """ if ATTR_RGB_COLOR in kwargs and self._light_data.hex_color is not None: - self.hass.async_add_job(self._api( + yield from self._api( self._light.light_control.set_rgb_color( - *kwargs[ATTR_RGB_COLOR]))) + *kwargs[ATTR_RGB_COLOR])) elif ATTR_COLOR_TEMP in kwargs and \ self._light_data.hex_color is not None and \ self._temp_supported: kelvin = color_util.color_temperature_mired_to_kelvin( kwargs[ATTR_COLOR_TEMP]) - self.hass.async_add_job(self._api( - self._light_control.set_kelvin_color(kelvin))) + yield from self._api( + self._light_control.set_kelvin_color(kelvin)) keys = {} if ATTR_TRANSITION in kwargs: @@ -270,12 +269,12 @@ class TradfriLight(Light): if kwargs[ATTR_BRIGHTNESS] == 255: kwargs[ATTR_BRIGHTNESS] = 254 - self.hass.async_add_job(self._api( + yield from self._api( self._light_control.set_dimmer(kwargs[ATTR_BRIGHTNESS], - **keys))) + **keys)) else: - self.hass.async_add_job(self._api( - self._light_control.set_state(True))) + yield from self._api( + self._light_control.set_state(True)) @callback def _async_start_observe(self, exc=None): @@ -318,10 +317,11 @@ class TradfriLight(Light): self._temp_supported = self._light.device_info.manufacturer \ in ALLOWED_TEMPERATURES + @callback def _observe_update(self, tradfri_device): """Receive new state data for this light.""" self._refresh(tradfri_device) self._rgb_color = color_util.rgb_hex_to_rgb_list( self._light_data.hex_color_inferred ) - self.hass.async_add_job(self.async_update_ha_state()) + self.async_schedule_update_ha_state() From 0fc7f371856fb8161432ee17c5d39284656a433a Mon Sep 17 00:00:00 2001 From: Daniel Watkins Date: Wed, 6 Dec 2017 08:48:17 -0500 Subject: [PATCH 245/246] webostv: Ensure source exists before use (#10959) In a case where either (a) an incorrect source name is used, or (b) the TV isn't currently queryable (e.g. it's off), we get tracebacks because we assume the source that we are being asked to select exists in self._source_list. This makes the lookup code a little more rugged, and adds in a warning message (in place of the current exception). --- homeassistant/components/media_player/webostv.py | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/homeassistant/components/media_player/webostv.py b/homeassistant/components/media_player/webostv.py index 3215ad82a7c..0abdb90e67a 100644 --- a/homeassistant/components/media_player/webostv.py +++ b/homeassistant/components/media_player/webostv.py @@ -322,12 +322,15 @@ class LgWebOSDevice(MediaPlayerDevice): def select_source(self, source): """Select input source.""" - if self._source_list.get(source).get('title'): - self._current_source_id = self._source_list[source]['id'] + source = self._source_list.get(source) + if source is None: + _LOGGER.warning("Source %s not found for %s", source, self.name) + return + self._current_source_id = self._source_list[source]['id'] + if source.get('title'): self._current_source = self._source_list[source]['title'] self._client.launch_app(self._source_list[source]['id']) - elif self._source_list.get(source).get('label'): - self._current_source_id = self._source_list[source]['id'] + elif source.get('label'): self._current_source = self._source_list[source]['label'] self._client.set_input(self._source_list[source]['id']) From c952f2e18a0a76d9fe18f31485707fbde4d2c5f7 Mon Sep 17 00:00:00 2001 From: Richard Leurs Date: Wed, 6 Dec 2017 15:00:58 +0100 Subject: [PATCH 246/246] Ensure Docker script files uses LF line endings to support Docker for Windows. (#10067) --- .gitattributes | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 .gitattributes diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 00000000000..214efef6e4d --- /dev/null +++ b/.gitattributes @@ -0,0 +1,3 @@ +# Ensure Docker script files uses LF to support Docker for Windows. +setup_docker_prereqs eol=lf +/virtualization/Docker/scripts/* eol=lf \ No newline at end of file

UaxEt6y>nn-H^{!Z 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 delta 42908 zcmca|mTB7+rVXE&>klvpaxl(fieP3GWMC3xWEN!ne}rKT0|O%~BO@aN0x&YOu(C0+ zb1*V8FfpUbFoC4l1sE8anHgDF**RFbnVDG`89)jJSy&Yf9fjBe6AOje8z*j5GIA0L zDw?!O+1NyMVN!6hSpC5!=VX-<(j*BiS9~K?@=o+df-Ym$-z{JGJ!pOqR$iNJC z2_usrGmE035Ua4Gl95QDv8ZxlAzS0bp#QfRc$gU(m;{*x8SELpcum}x+AjC^sNa{6 zLIsNnG9G*?91RY8Jor=?izad_c5U7-e@ilWgC)nNRXJu(ck07#KB|aZko>Lj%EFx4 zx%c@dZ#eX}#X3o{?8T!QCNCUJGi5clczu^XS9vC%C$C`Vw)`*YPE4KgC)Xb>zNYkp zZTcUZb+@Izhz9J5T+rvXcj4KBV!uOoojUzu3pF^r8alWZxdw%RE%bGb(9vfTLZ~f^MCU zJO3Qh{m*c7nO^#vC8k`elXPx8s&P0TQ*gZQa<=A$-PvCHye7g2t(hN8++^@Z*ECSm zVu6ST#7el`L^0~YE*0Yt$>rjx`IjzBYd=IGd+dt@GeH`ppq4js zJBla>UTYFPr*saF0a_F|J-;JcB=4~-fEqJ7qhcb)vRPs+JMvLAT zy1HL1F+cgtj@^qc-Yd^9-|<(h>Yjw|x=GXG9^6VqW+3U@hNG@|vP{?D<=RJ= zG^O6xUoBr1@~8Mq{FDCG)3>f&Im=Gqe&+8zuM9J6vbFs@k3GIyJ89y@&Y24R*Q|aW z&lS@y(v3V+AGhf-Yp34%Cu@>+R4aCOUidJ#WolKiYTq3XkEd_?4e#7Z(e;^l;^uLga7m5L(U1SmK3gc6bhb?Wh_>WQ-ru}iu3mF|Bg%bb zYuI>HRfC!hfu>!5OjxOA*FwWHDPX^@j-6Q`btyJu0mUcA(IiEwCNu4E+hWLbs%XX0%8lAUAk ziF0MiWd0J}Rx))_vTW=p$G+ql*|Sud>cc+a4Y{z;UZZfj{NNd5^CB?Jknv z_3)57^HR>pm1hozrwgfX+#Q#DlKnJ8a!T!%zCN$Fip#TJWIT19C2g@;=t|vsSPTRedAb%(47Ctke*D%s+lr%g0T)(1 z2s>Thwxd6~(xUxDQKF@D%`^MWyE~4Rg>-Fo6BhG1e*fN$-FuGT+1ZeNFlx(B5g&c= zw(X*iB=dP9BPz-zXKoCgd`jxI%-q&5iQhJFawvVs9%3|or=O53gM)%FLvX{Ez=o~@ zmIJ~J0jw5G30w@zIXRmd4OlriSeR541Q{7RIanO(VYzNOLjViY97Y3{10swJjUmew zc^Y?y8XTS_dT)99oSXBN#7qzMiORBvid`0(^?qyJ3iAk?(&O8?9bZa`uHD=mZT7WV z+P&2Fy~;sVAAQjm1*@LF`FgHze)^vk`IgR#`9UX6H++9=e`3q}gIlabo?iRF?%Iy4|EOb6PP5kQ>*~du-r#Yu_ zc*{#B@JtADFj-p_y6mT#z}tdv+surkBew5)&$xK|m6g3SUv!wCj>tdx=IDO;N|i}7 z<<%oKHKz$ha91{~8cQD(uXt8AApGoJaoIQ=nqL;bXvwFB8i#|uYiGY$_>`geAJ6a2 zwIVhP z9DK_1&+gzC?=N0+BsHGDk^G+eOO;>oPc=w#DqBpw{6j0XUs}OWS>zNR*17C=S@@jq zxc!5ZOI3fV@@r^5e6l|{GxzQ`X8Th|GK{@p#GEm@d*3Zb)7Ch9b~>j-6mIkus-^Wm%2gV`3fQXrN2~p zrW9WTDG!vCKVBjKx~?&}*}%SUgZ;I?LNojl_8*Usn_1WCBiUg2ocYs|U#bQ@hxb2@ zkv~;`QM1{=|8b1`X(%g4wRZbop&7>PlIJYU>%AV{x>P^In8~l`ph5Uvy;r=N%?8;& zo-+)qz_@oHB7ahvtilV7Sl{f}$JPfva^<>2)AV>|S3 z*}s@_a7LNsaW>cLN7hlnZ0;YY>+^1RC~KNw^mfnf)5qE$OS*D)rXPA2y!m|2pRTo9 zOu=djvqKi_DyyF=>@nrqwPxd+Q88Tp!YS-aSXXcEj?8`i^p=R($K%Pp`^C=k<`kcb zxYxC_l0SL<@sz_?KWwYa?uwo$8|u>x`$jA7y@8J^jSp#}*lHbrrX4OWmW(n_TbpqW<;r?z!93r_8^z z?udYSfk%`7toKf;T~C)?+-`6GZ{?)0{;jR=R?mK&S8!ojKtybHUbe{5vv;oN1gIXL zJC#)8ciXe{Z^*$XPp@C<|1IgC9Lzp3dGFlcI!p5d zvm~|Otz-W?r~T)ON=xx_={m0XMT^-dFDx(od&=J^;gkN6^B~6LQ;xHq|DOG){zRo` z_3c@8g8xz_Y?jRZdi}em&526S<#93Fb6b{g&~!^ZapF$+2T(RzdjEKg;19{Vt{(MM z9=C6v|J$F7N!i&Ee0~_%%z440cpqyL9=Pn($1w>Be1Y{he2(-Ah2eGqz}d)6;k3 zM8K?DMb}K$-L{Te8v*m8FfxTx{9RJrHHTO?uZI==f zWb_ltdQ#gm-}GLq(2Qiu;+s2v{%80aaw^qadvd#U_D7>FJC`18;G49jM{>*g6qPzmaabW<#NrUh=+IEV;DrzC<%LXY zjH?nvd{`E-E(}OvbU8RZ)LF$@*{{XO#Yn?Sr1kPbCIKq}5zYoRM#l?_Ii*T8JuRGi z6bj52Uzov|VJnw%C}u{Ib;RXcObJD~3;s^l{Or`D8~5UI(VNSgCvN_vq4hJ2BT(IX z(~Tc@mzJ@d^1W)*c=TnUN=e%Ddi$q86+h+4{)*dEzoq}z>FZTD|1(TceWF^d!+m?9 z4fDAj-%5oJTqx5@Ec6xT(5bTByZF+wjaTNKl8eq~G4J_lUiA7_)?R()Uw7p4pX`Y4 z73kn9O1XRdj^}6pg<+`~$(0p>)8*~|t?Hb-^Tcg!U8RcE^48An6NA3JIKOJu&!1WK zXWtbsT9c>pCMtf*%epm*0*^nN`K=L>lrZC3^X19bvX4PZ&!ksm+}`1_?9w*vZK^AC zg}JSBzS$*cJdnK*7BM6F!;}v{mZWCM@ol-aoa=ORwzR*9%8`H5X0dXd@-hF(QBo}3map^RTkC_)?5y?WEpALK<(sPc7Yetw>%MN?_OJe$ zi`R*k08k4FxkW7UgmZ$L!%U_WBx(Vun=RPT38G+~CKflZ^C5~aVynuE%IaK~wXD|W zdz`Uc`tP*YaZ@~1Dyv_W<#9~6F=gv)O%ZF{QvcqwarW-zho0X4o9aGq^@(c#x6{{s zoqv^my}z7_^%9p_?q0oB<$?=ry~Nye)>~>SeP>BLP&%o}yLRC%TTR*1WkC;I`P>)W z-Pe7oz<%w)XaBN8cU2#nFDwe?DcAokE^iwoW;^}cn*B%koepo_oE%@*W>ALmaU$}llPL_v{LABo{3^z z_|z@sqFau>m3tZa`czhYSMAK#uXFVls+6>DjJ>GqUHDAQY|r6DQ>o`4EZ$k^T+EoJ zx#mzojW8F}P4=)=cSQ|#+e>6^*Q{#`yLyG)m$gjeUI7zER2$$|8=6!W{m|7O5mXk;<_XpEDX20ukRL4eWb=zak9F{f1!<@ zw7*02t)C&sBa6$z-zk1%melNjIOC;s{I*oAKZO#Xs zzhhk|&3>JfF@O5$sH8XdON-u#HB_*D3iFQAmJL08W?kju8R;|ZETg#@ZFHrNmc-=F zyQggtr_G*c`JZ8?N{h36*>NsLRkKz988))_=>4o#FP!xB%+$LVWItBVc$K5N`?~P- z{ZIDAt-f}={?Efo%XOm5mrk62N!%_rM!i3!j8#%_vHY`5@~@(Qaiw^rt&`nI6LN|L-}`;4c@2u}L(k6No3lO2l7ode=AT^rtXeKrgX5pRZ!G@&pW)SNPTT2n zd;5PhzKAe$cRRQ4dDD~gbdUVKUa6ht>x@ny~h1l?DBV4KXkTi zapNdq`6}wze_`sII9RMP?-I*_uEhl3KNg96WfogARfsYs*2gbprPK4WB9 z6t=wl{D;UtK1~J(k48oP~o=YrOhv&MQxf>|McqJcTOMJ?%ml{aQV&TrD6BgZ`}HE$RN9=GF<87 z%##!SrV0kBZhZ3X`jk%$x$otFh2C3y?LR||$>#cnTfVr;zfcUl?w`NOn(0_e#(##Z zD)LwQy*PcOx^mZlTDeL!vPS^nNSyzIBDS- zmM@n>1nk5gZu+)NQ$~4e|Kq-08B0#3K0SUo%F`fUyo{0OUe;<&LpINM8OAOzIz@ey zH3jZE>RQNgTC;tX(+nxjSi5z@9o1;5Wm(t3V|Ak$YK%|+G@Rr_h+=UhVPsr{*H<@pT6)<5}#Xtb6HZCIL_PXFLr`$yarH7B-wy9pcQf;-1*0O1JN;hV|=3VmMqh*rzi+dWM z4=Y^Q8kQ*Gv9?UAZ%T)BoU`q7{U;Ld)Atqp<=U+8|9U@1#`FIS&dQ6_{-*Nn3!YW$ z_Kn}EhhwAE(`BzZ_b*v7L%2Tjd-L|6Ay*@VAN1zTt6x9;wZ8j-f7`id|6CLH*q@Q1 zOo``ioftH86b z-m>(XgtaJs&aLjQzqjUA^@ewU!avq=&fjU*dVO_g>NDlPTGziP#(H|OI;z^8-p#+z zN!T)`enM24{c9!Fj4n}V40LiRJozkUas9yU~%$T*2BW&7rO03XjuiDE@|D03#Zw9MeL50VkO9%cl_|;!E%y4g+ z{JEwy^ZvHIt7;YsM{^Y2xVesXPdHD_Iniv!Yt2>jHEdE11r=2p9pLHARcLGVz5w-} zN&gulkG#H=wNffuXZjMKHM8oqI%2lo2|v%&bLX0F?wyFFZ7YgdPv3D_TljUW`qE;3 zAJg?Qx(T~e8n`arz9#J~Qa`6eFe^i=Y-*p+?u^9_9-&)5{P@o>@rnD_=NDF{ulRbu z#iaOkOMOW4YmL%Lxp$AmnDfaydHEcvKd0yJ;`3#Ns-1mKS-)5KF5R2HjeofJAMyP< zeer|(=;kwju6Y+OV-gZ%%lps3X@1tOWy)dM)ApsMpwf9I=aerptjHBT!CG-!A2t7nd;JbG8Q(58!_Oyd123>$TK;XDdx^Wyq$NAH zw4I-`VQuRkHIKQ+-2R4rXP=yXTj=7mkB=tKsN$5GclCDPIo&2NrWW|5hoH;)xc3uU z?wFRZyUsgHHFaawSM5zjyRS|Clb)!aD-sv7RaIZQQut%tC+G6q%a_7Cmcj+uU@Q?NW{@IYCjCtnIHPapk zXf}DYNbUI}v)|;Gh-aAfw7O@{zt8^~Qs25%U;S-l-5+qZ(;NHX*=JB$cDwIFs`s>&*(H~$%oj?TX}ZNF>r&bdo3K0F^$B%dr7FKzlHDI@B8!>y97 zML$A5m05}%dh}cI)MT&MWw$!ssiaFgNY!7^ca2l6Z`Zs1)bqo)Pri2@#jBOiN?hw& z^YO?sYr~prr%eCuX5D&4=T$hX?zyX|wB z3)ZsKhj7Sod|t1=X@ALHx0x^53?j8!c`JO;#luTpcTQ`&d#&5+ z+~?`fkL_HuyMb-@&5663HeGLD7g3+|QsQ0Aw!PIB-I4O*Ydjatd>F*>Br4@t_Vk>O za}Fl!ZfSfwjnk3g+N^c{);^(okL@{aIXSoTHs@9Dz1q?B*N@-V_$J?C?whW3xVVO=W!XcY(F7X55SIsc|Cz8Inrvb9L(`eW~GpU0^wXR?(d-Rs#=* zv(F!@fx19m-;*oT-|5v?{$~h{h`M{(sM$NbX6Ee|QNOLtOzX>4K5r86yz=_c-KRwx zuiou=aqhDkyZ*F8`&EvAFFYK{5_-LLcE}myOa0axw(dCd!`GSx&21zIDqab#}u~Ar_@;_sZUq=|8%p+uQ8li@%{) z7q{oV&SC#$y8PXLhN&q|2Q(Zt-_~4y5!CW7;y;7amN)g+13IIo@}xip@>yJ_dTOm% z|Jd;Us+aa2G4J9tODt+1GJRcNde62ev--?A-t4mLt;Iit`~NenTd&zsZ^?b}QH<|? zy=_gFyj#{tJDXjtvd(?+IC=FQOSkV+=e<-g_cJ}r8{5fyi{wDt`+VoVao z)jN;ARsQoY-E}Lw#W4^x$<#5S!Lk0#{bKdA=lnbda|6?jXV}(Ut&%mi7jbsZIX-31iRYWPPjJjH)O^@wbW`PL$c?9y zwjCCopj&J{Q2779lJnun%M{q)vL zJzP5F`t-ZM_y2PY-77RP{rl!J^H(c2@f~~rwz%fP3dbLRxBX{$UA47(T4-WD%d5J3 z`D^ydv;Vro7yoSDcBzG;91?r~$lN#hCE}IX_q2b<&cBaZCvEoU+1`0PIW@aKA;PRI zC-b#-UBsd8P4$14Ue3DYoqMCoDqLSSZnCd2_v;?no@v3iw-kK;xX;$S@NKZ}t?T@T zPw(>>{n>tI;}eDHeU}7YZEBfxcgscBgqer0?~I9Fu^aBR@E+q>kVr#|gVdb;}AqoUlx&5s{# zn(}6WwODP{N4<2liw1X(`!~zlUjNS^dSP{U#j9-x>lfduIcxJ;MQi?lhL8~1zMso4 zEbx7r{LeN0#(#!2T{p8{DNS%;ss|-R1py9iqjlM7n~Uc#@Ylvvi`!3^&)Fs8_u+i% z&uQmQJv#U7-rF^kBERBo@)E1rHlF&RtFSFGQ~G{v z#_nJ0Z`ze}{(dT+W!Yx2;pnxN>37<;Xku0!niV(;a}0BlVQ8OE$+Mh5{W1k zf1LJnVMxog;Ld%nS>JV59{k67e;=r6bnxGH=9xe1*N8n1P-0@!|Iff`f5r|pguFBP zot}Ng!qnEIlQ)@9yT)^6=fO{OQbHG zX5W_0xws`I;LF9RY3=r@YO2Le{~0{C{A|Cp=`hc!swo2Rf3EwYQ7>GX{Fm$Uv;D7? zbhg~_UHg`$y(<05x_Dz4a&X-&lXSXQwP>ZZ5XHdnCPc zom9xzwd?G)lB#yzxgQ%{AHGEK;Iz}Xy^UL%B%?gLOQTAPUc}e z@(+8S{Ep}0TpqW2YUa5Uc`pAM&V}7s`S1RgpUoHc^2={N_i6XqX-BpmYJqiw8+Y#K z*FRH#HFVyklYXz*`gFKwM-@ifFh9{g6a8uW(&dl&t=cC_>+Y6SJzCFv`$);lxMtV1 zOn%!Fx4Td8S+4DotJre?@7&d%$uVY=cg9_8RW1wNShT)USfys^x@B9q!+wW#o5nPE z{MoNtQGHlplGv50XP@1+D7CFC*0x#x`#JCLPP+}^Uq607ojm`?;o`kj9B)2)F6xZidtW0!yWYk4*5yeTG-e&L^Hk@!y?Jd=>7k4J&K;R9IPtLZERGddR-Ky> zWhrJ+RH@M&rzd;2*`0OmZa=H_GCNzFjkX_Le2p*jX26!Tu)p6IRb=Z-PAD?6Yxw@< z^2*iT`Q`p@_qCp`JI<%gk-cKs;!_*86)60Py*^Pj@%Z8Lf+`8o6c3@T_5EGT=HxM- zTkH2?({|1u>UIC}*X>nj|8=i^=Fc@^w*wRe4C{YL{!9F#l-T=pR=M!?Z&N>Ot<_Ce zJ9zB%p2_X^b{u8=>-IM0pX;u@>}xJx*44UFzM$2^t8wLxj+w2cul1kqXi7U6t@i5Y zardQZYtEQ_bIsK>yLj93PT}c$7CE_o_47)jb0+Pn@X*h^cxAm~#Gj>`y_`FHn9OaD zuHj|*cs*5gb*1YUmqke`yLW8KJ$objuDh98FJo?ris+;=?KJ)JSV{Q9iYkFL)Wx>7S z`qTC=%I2GbN4Jc(ibBR2muPaBt(ez2Go;uq@S4PSEBpO3z6X4{vL-se>*>}*mp|on zB)nOgd-d@foqyM!8Gl>yXYsW?-(Jo>7w_~SXjbW?sMY@bZ|~uFY1<@@gQ;gi7sv4JDp^xsyefLu&yBVh^kQunChpok$?QZ$)Fa!d zZ)=L(j#i3Jw&Z5Jci=_;YE@fLwwC;`wI44oJ^k?5sWWS&XN$+ItxYX_bwA2M(tp~; zy>WB%`R#YRyk2u;>z^gB9_ZR7e9?DbWM#8oeb>YEX*)#}l#;kQMO;&qm>8LqV(!d; zbGh#Ae}?*y74t5g4of-puqh?**L9%-k<#T?UhLWWD=Kc%#&3ts?)V$J=gZgK6Wh4J zVmcSYu3bMbM!8tr{$ZSbW`XT@-AQv#PWiJiNKAIli<$41)|M_by2bsw@taO!;dk!_ zyVRz#BWq=}oz8Qz`5o3&xqhMJ?UNn@3#p5zqiZ+4EcohUb+W#G?}jJUwr5)8HKOy_yej(atn4UEyHiiT}q| zKckjoM&d@H8HM4O!lu-7*yfpV%RU!4yJ}u=`?AEhtjm-xaRqeLAD(;bt=F^MZKr!BxhHGiuX%e{ z&rRrr^y1FUrGAacvy6|cYu>1rK0SMNc=@(xY)2}RR!VI@vC`nY_nL~+wTWA_mX}9u z7Tmn!namtsk>0;|56H3}4!!dDTV;NtzqGnI?_BNF(=5N%y|HU?Iy`OvMO{eWJbI## zU_gU|g2)n0_J2(sZgJ_4)Vx*I!YtOziqB7r6giW(#4emaLRa?s`CIP`OzVBq^uDf% zZ~L=V%%WWE8TZME>z<|=@2tX>Ca>!_T%WIZIp?pW&9tntqH|u+33+*MmYO9uXLpur zZPi~dmb&iF;rfoJd!h}^&P=-fR;6=UxPAD?9ZX?gGJ8yPPi(8+pnvGjoqNv>uZzpR zovrp@d#31vON&}Fa+f$SKXzZIyi~`(e$uT6LD}hICoj403b(s>_2rJ;N!hLD#u2gp zsVdX_-@R*gD14b=wdU4-jf~%VHfPf={;_qR8u9IcPNTx#*;($s;)^fJ%3D7<@-%DH z>G+*)%bK&4s@T|Xx&YhMptdvnhGqx*t7pDuDg>HBb(=7(uV zs@`6%|KfeDV)Ch-oGgWRzUP(AG2&9W7P_51xB9TR$cEDrHGcd(Z;DH~46e;MUY^mz z$|$I(C-K}-S@P{JbJMN&V(tpRI2rlsb2ZO)b^|q)z zyDLM#^cZdOn5`^RFLS)%nMIDm`&f&DwX(6IiqPQ_M3-yMy$b8omo4V;3GeE7_ixs+ z=Lb$pnskLTmGQNNRix$p5!<+!*Li9K?!5<)hf7YhAc z5r0l#%Y+NRG=smU&e?PH*~g#LqV68Ods=|6@^4W6mYueu|F z9=iS0>JI-QX&(Ov%G$hhMWTcMGrSRR+J9m5r4V-YKd#r`9bYQ&T!nk_@%qk=mFr7$ zeAFM@|EE;H4%`cq%Lnzs8ihbLr*z-Ew^u$ZT{!em_nqFN9K&O=d3le``K6g1?`_DP z*LzR5Uj3ZhW@oZRsV$(vgX3nt?la*i`b?w-E6+hC%;b$me3iPn5GjjO5QMo&Lg#$>-$dYCb-_2}V1=g_`u zZTHp&tvdGPw$7&rpUWQw&AS#x+x?#=pX)5_=Np6U}y?&FAh&bYKn z+`HdauKITP8u>}DBo3B(-!R*`Xo2o>@gt8@A8j|@+W#)YT{4q7N!WG2Uh_}W1-C3@ z*S*j5mR)Ec5&-TiyBe@6s!VW~UQ)hU+WY)xSEnWC#MTyl&as_(FI(%!qAACfm;6}y z{1!X+-hgoFv@`XwZ+84j{`&BxxXsNo7mu?UPIUXdvZVCH?Yq4e(~ji7xI9;Qa$(Y& zhnvg_yNuk+CwZ9din_Ks?02zc?)5Omq&xo^jE-}*&b|D?B6-T&1yZ`}Z?>)ZIN{CP zIyv=1`#tm0CDo_Aue`HmTh8g?u=Qf*bJzTnHe~%E()DrgmAf*zH@4QV=i4uw9?`1H zF7QZH`p{C{&Qdd%sLj0M%J(h%cOLV|QvU6seIdNMdG{$f_IrhP)^1X#D#L!CKkmkT zWL~{RguVW83z?SrRS*A4d!6*HEVGSYyz-LR^}VTH;rbWRp;rZd zg|Gk5@Vqo=;!|0lf|o19KbEaNP=7VzjemsHmJ7XIYCYDqd9(jY%ej9PR&L&vBJOYe z_~h4F@5}ab^M2i9zxzMK^O|In_T7=O&Xw7sSNI;cg|!>rHI2F)-gFa4VL|epg>BZ;d6&HKcokJ$DLSwBuS|5k z*VOCg7QfTX{(e3xQ?>JL-mJM^ALqO^-})@^&5mM`B`#|gPrLe&)6MnmqvhOBE(nzA z#e95jJNx4=1)5FO!-u@?roFF6J_2u zN1fcDpZKaWxU<_r=53(tyuztZ{gMxzdzO-;w!ONZZ;!9iywKb0Zk?W*Q5*lj-01wA z5C3l5*|YD_(PuZ`Syx2AxthA>>FL`sQE?rc5}TYLqp9%Xp;%wJ<4f2uFMDp+?QR4sJ&YTX*Y)GMFdbX1Mp?wPk`FLIqIt*GQL^s!)L-@IEH z^|L-PJj(alK8@pMWaLB3)10$+Pr7zwvQ5r=j)FTvx>LSPpY>zMfpbNC3=F?LzLl-3 zSBvp0DVch_b=IeM-s>Lx4Lx@Ir`Zqr>%4U;{ikm}jmUYabi00szUFVXssKyNf0xVS zZ}xl5QSzQ>(l7r{$<*{+cUfV}AL;)LNBqBDU-aOAJwtTknLn4WJq}QE6>vLgHO=_X zy0=Fvr+9sBJ+D%2$fKdU+nl{pVqyr`lN<78m@;T{3AZPo`DwjfMF#iV16P zoR;rYv8(Qna(`ccy+}zhn|@q@R*9lv*1yKWomTs*RM zw{e+Z{G*N6zV)bOJYtc`DmC?b*QPsfcS@;$yD9fyPp#{GQ|IaOa@S{WDQ|hPM2Ks1 z+|i80ZHdpNxG^f46N2%g{7&Ups3>{nRhF#S#`x@Z?tcyV!Zp?rYr6`H3ngmvFMfC&n_d4$icjyGqitjAi!YP6$?QB_H+Q8l*Pn?h z^{h)?I88YwE7qj3+F*8ecgghiKTOZ8n|H}a=AD{%+4l*|pUl_lZauQk`#-~ls{8$^ z-)fD%9Bt;;R&}wM`O%0|*8I-aB`5gz@I8$#^G#oU{=*Mz^NRlN6ER^jDu!M>dROP< z-|)P%bIR3t&GOQ?WQi(ytK`buZSjmOJoDatZCz8(Yx=PNsc3cK%eJd#x6*n1O^Ob$ zGx#x^!&x)Gl>NwQuQ0Kee2gYd==sEV#78$ne{=sW&3ZTKl3)Uz|x(*mmrx zYKq#n?|$!-6n-t3yZGFe@7ZT|%lLlmkv6$-HT%adL6y)5h4x8vKg=$=?C`yz{@)Sd z73NARr{5{2e2m`tz*j>r+x&u3;!TDwi_qmx0%6JL4?oMxnZ3sLMm5_5zo%M9);c#k zR^GVa`ANk|-&V{{CVJPiyWiKzr%Dzlyna;b8T~7Hap$Qyr=w@?&7Edd-Mo-@fo;0O z=G5kxw76=HYNfAdQ>GsCj47Kgx_Hyw*t7Lkj}&iv9iMi*N4j+F>et65u2A7|-+$}7&rn7Cj^0jLhFU+42cbm&!u>N&#*qQv!!f(G$hi_!_SJimb z#vi^m{z)6h!&`ptllQa~-aYE^+Uem=|C3zzJG0hCsswGYQ)f5%B06dFw56*JqC_=X zWbWwC7Ot-pu3hf(PF^A6o4ea}sT))C+b3`Rvz43i>%)m}CzM_-G_UiIJ~n@oc%(LS z*+FI5gN2-rIv?ksjhLyDT*SXK`_arj;uBsPSGjxjOw{ZO1w7sfyr1OPwY&6;)xZ5y>%|tGF*sY>*E+ut_!SgX8pyAGeK>bm}9o8PDUwyTW#6a$XYjkb@mYepWA#=8zu0N1E?bxN8eczNS7?0%n-`}GtcRQsvlCR=PO-RiC3G=k` zn@-(!Q*S-oZy@1uWns^=kDV(dv^CO*iqQTc6N1j_~y=cZ!^B#e0S-SyeW^p z(XAA-a$Vn)93H&#da%p&i#9Pmz3?qr`q9Dw;$bn?DA7R9i7=fvs+IyPAa}<+kTh* z=JJWf+LfJEdu1YyC_a9>aO*ScYgez9?n&cQ@?|@GICNUsnZvpkAH`1HOJ>Mtc~b8G zwZiXHXwqe#>(_-P%s;Fb{2ni;UUdJ(j$UiA`pCN$S^j*I>jl>&*RffqP2X`mV!EeI za(4HY?3&l2%hm1%3dDsxy?@5oqB5_0amlu&XFIAl81RRm4qaUnzB=yf$DX}a-rAXK zVpE&V9SS)X0NpXRGdH zOX$@0zxI2$;j6}JyH%;L!meG2zP*iOhNLj7)PexlsXIU9mOkUO)m{NV)u#~Z5metnG7mD>P7SB%|_LwU# zYr^khVX=C<&3!Ac`zC*<%{yHsQ1)i&XII{hM){Y$7WqBad6v9%&z!$|e(z#;(yCWF zxpecSd%}lp4;Z@CM;^}FtGrt5b&|B6!S`sR=JS$# zpQ>%L&FnUN-?*RZ`u5`V-k4KUf7M@Dt68@2w9}eXAELB;mMq|XDa6Hi&5A26*ifjq zvg~$6%8V`}!yu`(&vk^CEmtl-68&LnyH{z69DOG7e%Yo|NzpYYRHm`-?qm0G zThb)ub^GFOqbEgs%c>4tyFE*_hNr$L_K0@i-jXDl>_T1P_Pl4E+}^P%-|I zU(G69%ky00S)1~Vb!*nmO4zi!u*N2e!80b$Z)NAqDnA{cAjKEv>t{rsH(ep*b4}dA z-15rBESJ>nk7riezVG?|WA*mvl#Q{+oSOI9Ywqc*pUqkf%wKYhtb?uV1i9N(r*yW=*y{9@jR zACsQ_?!8>?CKq}pIK6WH+(pgu^0L3z^Vps(`(Pa)cJI1;|Ef%5{S}}8EbTq^>Gu2M zBEbi_eJ`w3yuw(Y_2%)H(`mE!y)l~hvvI<_bCyblsl7|4C)fno-g^)=bxG<*^Q@i9 z(^F0tz1FwvI=}P8oxNW~Z%Udb%DL{06*RcE?~T73`<%j=%O6`d-Fp=9+9!Fg?9T6J zQg<djTWqT6RV)9{web-80Zgtq6T?*s*zM?}6hgI>mnPQ_H^IHk{t|Ed7bK>fbpD<(o|#-d@SO8g+Nm^{z839?#uA z!SIcZyK&jGE&cDl-MYMC>hY)1rxI^{{Uxq)ZR?F%W`_-Xb&~~}>wCq6-K|v&V_Ynv z6@J>X#_?Emiz+|i-!td@fp==Xje_;ux*{&RQ)Kq3UDwXi)oYireH<6LpQy*`O4IFW}kf){X6vb z{d(D*CMmooEAEC?EMB>|eMUjSH@OGJv6p1BME>NSc;K=-&Fwz}*S#M$cO%Vj_a0lv zrPgbEN2e?+r%3Gjw==u8m5T)Bys~8tOFX}CkCy|N#0P-`E|8((S3K_K2}U{Dk9KCq z?o*#9H1#Hbu_=Mv-E6abcXJ_e3yyQySog^1Ecd&Jsu|%?bq@@UCH@r`gPvi z-3is6)~_#Y44P*=?bxoP5%X%F&9?rRo${@3?T&596@5($*6M|+Sy}8mye{fK@00gC z^FHM^e%@E#zCq7*@#^C1$NxNBa-@!@Y--otyDHK7-*un=D637?wmAJe{6E9PQ%c_D z!Kod~ekQ7)5M3=Bn0Iai-=mF_|G4~Th^?{{sXzPt=loeGbGNn>#Khh?o|?tIe9DE( zck?|1b+#;vTikRw`q7%md|`K4ZSC*V^FwCl2kmH`v|1r>f#o#%L+fA+jaSZhwZiP>jM)uV@_ zMVu66@@!qhuAR2)tuvZ)Q|ep0;n`}xt(mJ1>dlR1^_=Fkib1nw=hTO5S1Ry+H3`z( z99bcmsS?*(upMN zE^P@h={>biSSRZB%rs?5?Uz1hI-j|}o#+3A>&v64v!~vy6<+hRa8aP`o3>1;EXj9Q zOLqL>@k?EM;+y14?wP7NhP#SiZDN}~!7OlLsZG*Gz4Cwe!XK(m*!^5)na}QB({2Tq z_RslUFH>Z5MQF$Oo06`pzQ^<%$EJTWOjJ+KeUMW7_5k0C3H_yEzmpQ%z< zer@vwGfu_Q)hjflWEW@O*qUt{EwBim9s0rS z;>IJ*%Clr1JfHP@b=KFH+SfY;>Zc!7IpV~?yJbVoqS-x{EcE!!ZMyg9n&JZMs#!ZpQ@Q>DJA&-~P1NnxMyEvhXA>{%Jv*Vi z&P%s;>*?wH)|cez*w)KB(NRyD-Nl*W~N1QtnGtd+SrQ zbM3siSLn-6*?jy@%%rIOUD-3{WQX-OmM@Zc+%BlSPRZBrEqg+E{!xQ~`fit%#?#}o zZbX&jt>aRSPD+@wc=8XKGiCbf57)nv&|Vy8C1zP<8TD(gz{}-Mizhv0S_EkkmY-ep zNZh*rrt*_nRpLyy-wGYgOMO&jmAs&Q-vhTpp7$16nnmq9_V&11@zpkYp*Oj2t8a9c zZp`23_h?s4T}bl!^7!s^o$GSz?=mYtVk`Pp@MGzZu;T#|cVF$U+_3I`s^Crk!U?D1 zOpM-r{Intbs=9C3vU547o%1(s`4+lMLS@?It*vV>?ls|#K9{;U_uKaJ#Xs^7+>72N z*uVMxlZV`_zxT?opZ{~qj3ztbQ(@NSB@cyeT%M(Gf7tl7rcu7pBiY*Pc}|W-6QX$Q z`;2z?q(<$%n0M@F#ear`@*kc5c72J_2R9WDx$h|0WcKmQXOA0Zlftf?j@vkWK~cF* zU1VNfUTyZvua!R)elHA5-MuAJNl?tjhL1OGFud$5?> zWm)XaqsMME2u8Zx(~M$R%J$UGVEakSmFBs8az840Qo486q5FHb7e4I1 z)t&3^Ro^*Bw{_~8H}lxM4sjG*4YFE4`RXgJ0)gpym$w?E96h=^FCtQbZMH_hY14T* zWg9o~)TBi!&72hTesRc3?d!W`Cv4+iarMyJ8xI%FaoV)t#N&^TRdaIZJl`cQekOZ? ztaowmdfn=q_TAmrUdBd!OPnbZc8XQRr)}NLtQY5xnC`vst^Ur#4Ladhqvh56BLj-2 zu3hryY3AgOY}Rp_3%bm%m_9Mj+4r6E;D&^ zePeOvy0qw+{fWMU!p3(Sjysm7S62N<7B{f{`=noKdC&Z)*0PeU^;ZvF{LgSH=(d_& zuk79<;ezchCCt~;4qd)bANE%}qTKXTa!#7c3&xaq*^oUii(bctob)>6e8hFFa;dMF z?BXnzV^TMJ-s?(8mI^-Z{Cz$&BrUaG zqGe}7>eYo^Z>Q!oNJ?IKH&xKW<D~HQyOW>#8oBysC?%VA7_0;jq-0WuOpp~{W3%=U3r&VvPl<41Z z@>Z0U*3}mkV!sv7-jy%Du*3S87=Pswd5!4rZ*_tVdQX1Z`T5jwsgwEHGVV(lm8UbO zBu?&in_sm|R_NWTDJfk>4Z@oI$#TaH57n=&&{bZsBCKlRNfEct{QbQRhSz;~lHD3N zHq~nLy_<0LN%%48yrk1dI}XJ?QB{you1rwBRcpdMeSOURG?|@qN-OrOrYP?@CiMKe zvi5!5+p=2eWSp{xAbe;^^8MhHl3Ryxp!q8?@)Tf9J;qHGBVI}lI_7Y>IGL8 z>dZY|e`fREC)bv{MkdcJ&f6de+@7ndZ`S`@}gZ@qR?Y3tx7L*q%7W+CbDsA1Ty_;vx zS{HuyjbWKn(|wmLiT`)V-)P1acd2tM;d4TNRC3ySU0hplzczh&MbhzHj%>o+;xT8+&Pe#A(r`&$n5wslU1;*u_!E z;d^<*yLAh6XT3Nry6xfejVII6H?@UZx4zF8d~r4PZ>0OF!p~3VlulY@AMi8wVEN>h zD;FQv27mRR$S*r-$MN{MeV_C`aUW+sVye6{sNzyhXSw)|i6ZN^Wg6QET)2BRP^Qv- z=5B7|{G4lh?-cD2`u^q0)e@8JBZg5y^<}JExhyADBqdIA-`bP0dd`zMisFx-&$^ZQ z=55N%iRPWlrtsZe7@@mO;bgvL`m7>}7x$GVMPk(4kH$yd3NcOCt|le3>sGdf(}pK~ zr5iVH-P!ul-E?=)o7Ua4-tLRijeh&7^45oKN76#e%4JTc-=DoYGNtrkIq$>F#h%uo zTaPBzpZadNKQ+nfOV-D*ZyzF!B<`r(SN=YI?$*epIJevSp69Q!{koC-&d*7qdi#Xi zZN2lYy3Kam)-U*OY`$){S4DwtcH6=OmdlrjZkL_!)_ruhw&k>gH)UA=&bHmTNOA7s z(C(ZxHt~b+vh$cN3p-By?Gc}n-Tmd^gv_I>KAW#Ox^#2>^gTOv9P>#Lit_Q3YF^f* zB;L1Pa`#96SsyBYcj)iCyu0#oPp?JxQk(9iU5gTT`Wl*^zOpmho~@ocf6DgknKDPV zY&_H=wnl83)b@3%;`1ygoo7D%J@~9b&iT%Zhed0X9+_xOT4NV;rRjNYp`KlEXkY3^ zr-oH0zWTGjUDhvHTTuV)l67Ze$CnRXqAzxc{#HD9-@f>Q_F?BJwqNH8?=Zc%WpsT; zoAI=r+YX&R64Pf^KJDiHWA|Hj*qyJq9CT})yLNxZyq-C=8~FosV_(;-*Z92Fe)YmR zhnn~j3r;>!m}G9d!SkSS^vb1z5mUEL{S)4+*JDxe!nu_rV3(IV)0XRtqw1AvVjgy@ zJbN);RhrH2;wP`q8~Y1Iw1cM_x3wGHmH5vf^z)L<+w)Ji`K!xjy*lM~e0R~CU;3eD zx1(=a*?d5x(XA!LB0@+ufC-@Fno(97Z?M%$%P5pz)3EPs{qw}~Rf0xmwN6c%*|hyfU&=9~se+c5tv4=q z6}tSy-?J)fakKFiC5}}I3g#M9SKob9KO?fgrgFO2#j7urUG1BCdbgiiKQWxUM&uv+ zGqJn&3k_;SaWVd;1{3 zDwCuB?$(UlKQmWHtSO02+|TC!TBlex?6mxuKM&5uKU?0+IeXtWhTuZJNX^w6+uf@5 zAJtdgyrcWWXXA%UyH{YfE^Cvdbw{`1 zM_=U`vK!B-tzLh;U+Uq)ZS%rT-<@@B>%z4n85bBfKdq>5S^%2MWMozIUG(0ze~aB2 z#p`^ZG6c0(O>lU*@~?)?chiE`ed&8A-qv+!v-gbJoqFTp<%NB^bEC!9>@s*VId&Ce z@FmbbSdsp3^POh@r7{B<;(p|N8*FJr}`D4Fcf^-Hi z)0@n7ii@jDbJxzUKbXlAui7iWFz2bDy2#o|E8SwO)U0ob%Cd%Kv&C$>#b#l-hN0`< z)OZO$KjCL#ElN+`w@zLB{DG0(lrFKig<5JioSqAwocKg%X5sXerH7qo=Wj5OEsc4* zXNl>>TelA~Z0|DLB*t*zfXT&-+c~ES-j|x^EIMvB<;N~-{Q_j{a`Fb6*V;1Ll zpwzhKg3iPm!}!*9cOOpK`((#jzbguDr*(UYX=^`H*V=Ma*)3dF z;=<(DCc4}o(}X`gT>A9PdY$4smrt7+YJ^YP(J? zy2e_Pr6=)6Sy1nzkl9b8Z>7Z>7MrEdSid>gan8i^`&yswJ-AlGOsv)W`VU|GPyOj_ zr|RSF+pgVmZ{9F%!fL5p?Q=KUrgJ{r=9T?BV^fMVPjB&^i`#ndY&R)bmcCkar_k3q zWp=maQ$^>lwovE@Z2lQu?6zWQ!IjxQ=OX{*owKq^)}8AaW4~oj^&0JZxAmG?`S%~4 z-gfSso7+EzM+d(JRUg{@YIpGKl^JgyAJ@8QnYqE{dHuvA9}d=BE>6>s`p;0gcx`1| z`tq$-SMNNow%409Q{Euy%=U0Io%cpU-p4Na+6HfTzOZB4<&1gj=9-6{m617`s(U7< zzjY1Mc6}9w%dYW~X`h;>-?`kpxxdeQ+OB=4BeJ~qmfWfq-n8NL(>+dmCRo{o*f4*4 z|Kb(*!o^qb{k>(qx4t#&Ty*N^w~}nWRdJ`kn_jZW$hi3C`odDv{|uk6Zhy+Bt~}q| z=vv!vrRMsmuQGnBra?-|n`c)0OkKiTC6;}x%3H?g(B-N5XQzeSw77Kd^R;w`s)xl} zT+r>|o#c ztzoI>o<>FQ`=&qbzD3~0W7A`wsNbyie6b>6eb9u(>{FUI`v$XlUUZF&ntb(9>^GyW zzpd7pJ}UaM!A|Kwj?Q1M8B=zNi&$-5VM4yBNBSUVfsn&-jYp+fK7dH$|^USW#d|vjg z{-C=jEo=NyjHQX|Bu{oDs$+Mtp*$F4M8-6g~bkrnxbJs18Uv3vd5-sCiEVMMP zEx8>n-QA>>lvwO|&+Wi+j^JB&i*2rLJeSnk7B<~<$?L;AmI(^IyR0~+TjR9M5}%xM zAKSw>vSh02g}Ez_e3`;mwsGd#w)c{`(JNe2crQpC-x{}dqqoiZJzqoj&5l!km!_Mi zIA8bP5y#X!HX-actII_%U(VTi|IhnrYYQX)g_%SLe7mXK9mPH8o!FL;$(y=%Dt4WE z{%(`d&S`yyHyu7adbrI`ctylE7jK)wXNfOu_U7j0>@%MJFy&hPb_ctPXh-FgrLv)? z?yp`gR-@Y)=~dLzdw!Z(l+)SGJ`WeXiQ00}GVb>0o6lrk|FJKxIo#Vi>Au^)Pc_ZQ z`jm^Sru|!IQyaEaKX2uqoim$0_H8#blitz3<^ltstYZFU*F^72SKrP0Wo>o9ZQ||8 z{&T`AI(`{ipSXWKv47Sp=Oy*Ni`~6nzFOHabB@?HWqqSbp3jS2`qUo%d=}YxOENyS z++tQ?IP=uar%t}j;ALFYki)$)GV^5B)wLemOTr3oT-@HVzlTq}(NFC~Sl{{Bb!TT4 ztqn4|+bg4Z?%_SH(zj9n8J+~|?B83S+oX1>S1M=SzNwp6U&~%K{n@?5o7!c&Uf0K+ z_1B#DL|Sua{ArGZp<$hh!5TA9?rv62dY@!6O`KDr{MWLjSw*FlZqZWPD$dFECKsJv zZJ`&rI=#n6-s{u1_xjG>X(BU^e~kO^mM4R2^_kVTy)GtimXmyue_+o@Z>Kk0h+z_5pDj@ulsi~9n9iF(OA zoSMIR;tb8doyqfK`4&E(b6Ae?Z?1=Q}>=KIwM}*r#F93 zv3JKpU3RDKnb&0APU+b0>i=Py{5OT4VjP!+&f2W(ls{Baf1}@M`@xX9J5!3*Db%~z zocs_fzg@4rUMI=@i(~YImbyE;Wp;KkzjL4Ievtjm>6w-FLf0%02_9j0sxg@H#QXI8 zx+AKRf`^2-Qg;S@k5japEyMn*aCM3Ky^-J8} zveizL6}^}k86CIG3KTl`-o>1#JO$H!Cd9vyW3`0mbbsqYC5~g z^nloe2W5h*xMtRG{;Xmw{3`ZHvgl9WtE>mC_?`Hz&$@s3dHZ$2J-MIv1RqjuJFh-J$wf@O{>H&EtoIeyatfE?(Lo zyKZV@ZkWNbTRQ@#mOfB&Qcw_Z*_YkeRB-Nt(?4aoTQ4@e-SSZAdU9;`%%|;+9Q8c! zlS}e@GMul=eY6je-14+9aQ|%S!g7^q(=DET@Xd*HPEiOB-5lj6^=-?M<$u^zp02&$ z-QL7)@ayEt)pM7M$!=|3nQ57=duFHiw*6PPH<)hZpW=6E>&=JvvMyeaSUn>$=+Ujq zmCIILeK+$>+VyE4Z$`f<^SZC7A`tC<_wJ34m+LzZ1V^pi-zOEkDKCAhnQZMRoY09eORY{Vjx6*>%FW=U5t#VzAq)3kK<8uc%B9aQuZ`zpksM=<-Vqqq` zQS!RNj|Is`j5zPyPuY1}W|vL2g?Vr3T|uG!+06|FR|JnPcY2Zf!g_Pf>nR2||EQ$i z@xS)St=Vlu{hO=FvyEPNOiR0XzJzymh4ee~)oYVxR_RJDJ|?_oQ}{Rk$D4OdVxPN* zrJ<&4b3}Ij*N@pL+bex~@78I(i(I|)ok`$BuHb7fUYZLpO_6rsN|NQRQkvNAyQ6l? zp?Aif3lxv=zP+)Y*Dqd9&B{z{I?t|?(rp%EC)18I-wLa;5MNiXmKb_=!;?)xhZ7S8 zr%rpmcNcSRS>v*>UzD_Ai1+&%Hdmov7c$w(hlUv*&Z zGEPpT1kGla;3*G6m3%C#4@bq7nFp;ln#nVDy@DH0fBB|sTvt}zPtBH`sT^~A(|7rk zJ6|7b-@A5O@>ZGXjGeRhZmrk8xp(#TxYP0f8RqyntbHp}#nwH)zE(2#_{u5P=lMSy zZoPY?cZTKCEjLOdOMkD5+AMUmKC)uY(ogwEwlm9!`#hL+E&R~4d2Le{*G}D@?j2hw z;dpY7wW8tch^3PP(k2*b%72P@{7X!Ca))AY+A;2kPKHUGw#!3LK8aqf>o@J#wfc_} zEF4yT(yiF6CQ{bmDZEriK3jPnd(akd&g({EZy#nzy>>ZtGp1;olJ@TN{nHFTeCTox zd@H;)=jF9$MdgnTzShNNOC}{J@Mgy@U}_G%&~e1#a?VXb7wx=5*$D?A+CcDV~I_%ULUKd!I7-{%v`j+fF`$GhbC8e+5HcG!GcK4R`-kxu{av|c= zEIrn3tk2octGF&-_~zc_6^@=~!|bJV#r%%2pO(13b}u*Ijnn1b^^&hnazATavD_nS zzRa%q8v|Z)vK-(e8ChTM8KWM70{Oib$W#U6Zb!qQ9W&(Yxon zTOV#J*l=Nj+tF#eq^>SPC77q$V zO{}}r#Ap0x=ocu66G%@~u-tvzD>dOy>f$FxY+`$lt=BbKTP@~sTc>!H%A2rj+ct_F zVJUp8XKnR0boQAqzNJ4l?Yyb_tmAHK-|StRTEEN--uN!_TeZ+$>#aMtY^~q=cg=aD zhwt9zux`2d_w$hgZ@%V*c`tACi`KC#f78x#r*@9w>drB));iXqqyEO<~?W5q9^P8b4rw+J(=KGacR|j8|Ufy ziJ1Y9-oDkXY*$Uqxha{RERxtW{T8p))UCcVGk-q2Ic2rXWJ3$>KVOzj7oQ{+ZSvN} zZnZ=%Ra)5>^X#tdtf_l5vlYE_ zC+VqK)*r}soEGoEx& zn5WOk;rsm^IX`wXz56(4cev1k-8SJtyT5kbnvpcM&PBLBQ(G$IrKW_v#l^%uX(D?+ zvM+k-{mpRAk7*Yd@Xlq-$a(xM>i*7FyLizlT@P+@Pdu!n`X}V|qN}&pAKkoq;#1ZG zpYBW#j&Zd;$g{n3=^UonA+MK3?6m%8;h4vE^P}@U+fNqfq#pTQJi0M%d9I zecKRy;Dk~_O5uxZt$Wwi@0H2@K6A7C>F2*~_WE&av$%)&z7o!RD9XXYx%Gf%)P~P7 z{f24F_V379r*_S9&WYQC3m1o5*J~e(?bByJXSC>KL{k29aidKYs&=<;m8!4JIIpcY zr(lty#Dl_j*Q{SYejC>3rQY>+hg$Vc^Pf&zibVfb>OV2=jh^&~xiI**!20@w`sM!_ z`aWCk*<9aWGADoguHx5Me(CNt|CIf9ncSw$8$4V*T)=0nymmY@@wjqD+=Yi10z%Gq zOcMGYarW-9w<;~at(J*(I&Ro@_NGxq%tg~Z{k9k6UVHVZYgXKg-I^}4y>RO%;jk^e z3_gy}wKLx4E*44g&3LiENBLCf+IgSqUvB>p6Fp-=a?Fi8neKeTs}j!aemaw9hP1eF z{6>bKydn!T8eE)D{_*d;@h_?AofX^tqwf6IdefI|+j_J6M2ftPjpD-d+}1{u9z6^D z9#bg5vgUf(6(95W%f)8Dd=a!qPzcoBn$lqUS84@ks_i?wV%;e%?(c8!c=7nk7W0pL zcGqiad)EsV)&v==T#q`LfB3$K`^`RO-_`SLBVNqge6cqFj70Pdmu=rCo)q3@xkShC zVn%1X-?=2^ukw`wl^6IFqrND1POWpF{n4yOx%1L4|1h&Hx#dn<6T8cmOiQPw8_qbL zl2E<0{?JV~&K%ua@4D8`$~+!EHIx! z`nC8cm&K-rmA$z0?9t}THDx+RXRPG@Hs%(rw7p%O9kcknK1ty~&Zt}Y z?Z%EgOZ|uIG^9=RXFhpX__Z-c`u^%-?^8*YH92Lk^rr1UCfDrqcf;$VJw^=~Sxck8 zww*t$p*-oe%1!oq>13X2sWNuab5HLj#rWl|Ib+M$z}3K>^z7E>X=}3DXBCT_-~KEw zaYF8-TV_Yt_k7R%C7$fNF=E=1>+b?Ti{4J3bzEHX(Uzl5*G`pNrE^_B5uV<7^wUl8 ztfHS1Ypyc2XWrjh%~AQMMP>z8LlBE&dGm$(iDA`V$$M=14}TLpwXOci+mcBZWkUPP z-`HFJXSjW{pxXW4EOh}^zvjxAH@ggS?i`FNZ$7tr>MpCCHO1aH9ymJ|+KO;pl$>Vm z@21W?VY8W#&8chqBA-^W=Uu&ZQC8;m_mGpy^4h08N@L2()|@d)3;TFJlkwlA1pegG z&}r+{>aH!}zZ5DH?QMD{cUcs3{eOl&_m@#I>)tJA{%CocX}kH8nzrp?p>*Di8J6cQTtexMV<1>M;Y0L7?j1uJ= z^UlBsKSNgA8UD=G3ksCKdexZuyk92e z&tG}${^Xyl?mzZyJFoXJ@6lW7qgzDx9`6^ouU&L^zPG!wN^(l?!7~+n*=-A&w%^j5 zC?v7~azq%TLqhAMf~)_5ZdzR07uKAG8m7uGY4OmF4#02cm30e=oIRU_Nwp^CuUVZQ09|HhnvncsT0bgJlM8*Sv+Tf0u6vzIkP> zu1)8eJ;%3Pv{qiM^1P;|OziEqb*HNjm>cfSeir-l=6?o@n%DK$3U%vJSL?REy<)cU zv`KTDhGbN!=`PkYdnzNp*2(Sf_i^TJnf@sE>4`nH+nn4ze!b<*TpYDK#f~18zt*`J~QM7t*xKEo+tOt{WI%4zs5xzd~&tea_^mWF<;wWZc*LKvX(Q` z`-J6hrQGzLC*8E~oxHoDWZEpf`_l1qlccQIKfdbD9eXI|Z@lJvxvIOXzU|u`5*}jn zT|0g1x%wCDT1-_`S_3SDM7w<>%K-2CZ}{;AKRpVt>oykzbu?ag1|%eI>T zAjfvIDDUdo!l|-X%0AAJIq+jaF~1;7Sj+N*JYvrx6D<8j=N+wy(@VeUtsHac;+ytM zQxsPI*s!Ho)x}17noMlU&YbB52Gb1JE~quFH+>r&^|m#=F7?^$U1`W?hxZHr{i3nbVCg#~y6iX?xd? zJ@M4?x9@jHzX*Tyee#X6*3gcBH?!rGj@( z1T5V>RX~8Fp2cC6g5pfkS1v!j=ZVR#4YYbV$vjGCM((*Aw`#g3FXMP}OD^>B+yy(* z^v>Pkm}jvhdzOZC+o3Jr9!)yCeyY*j2jBnn?l`zhFZ$Vs$1EW!=F2mrS+h20Z}BnD z-fZwIUH;6EoZdC%W#&3NwoeJM?PF{Bvij7`DATjm&a<*EZ&(mg4?4&gdiLho+YMW1 zycgX6YKrKeRp;I_CR{Q#WS6@x6sVoz;Mn%DEp79Z9kwsk`&-IHt2PBb?!UFkY=H^a zg*R5B(^l(SCOQ3yXYOAseCK#sxNGXe98=khNh>|gm6E&yPI7JWoSZma-1v{`0=5Sm zc1+Ka6@43Ud~<%cY5m-1+C8StesMl(s6jS9YGRXZc{}llsM7 zBSmu3Q=i;BeZ24AI!s=i$`NyRqiK=;dST17ol57vUXF{4+hF2sG9j{bbGOrO!R;pP z{H?F{n4dfUYRb*~Pi9qpDAzs+s#Xc#+++@0)IBy_~UX@^tm4h;_5&H?tm| zA^pkS>3zn$Uj5)rmsh`gH?vlF9ZOk#?(fs>TNp1$WqED;og|y{%;(44s%vxN3}m;? z^PhFmVW&*RnbXUUwP{?KYc}=r>dhW6o~-s+FQ}TiY+t<5ns2%{U+$B?C1Jo*dAm?~ z{*ya9V|J${9(!^wwYt9OcC_R>&V{}0Ennw~EeSWeviYRtEwz(kN=IIOKk@R(n_GM9 zS6!V`Z*k{!Nw`JRqbQBbn>SYNEj=2eU8;1VNg;%5lI*5Ud-m=S`&KBqPIhCj=<=-N zn{&d9wT~8EKKwA>(&M1Qwv2U;GPdZxH9dYc!EttW z@1i@a9}0eVX=_lpu-&c6)z{R+$FBalPIcj*yOSE%F3GEyWw>jSZkJi+%~?+!>dofa z?&m-LpJC5c_1*qcZ`DVAX*a4i{&T^8Ys9<>A3%9oj{ULf)4*@rkAJ=WBKX+5dG#5g z$+kIDSG?FY;pf!spWbSq6SB>wYUk~pv-*2<(f9k_H$+a^tqWOn_mGwV2aAJ)(m|t! z^+xj=gEc<3&-k&M`qL-`C__axY&; zuU)fm*3s0BJEJ|`ef-X|qsf6=?hs$AkHd`41I~~mS=AW@1k&FXeSg2@7jdL zKW++-lY8)SQW5VIo(I+Ml8iha`Y9@2(OmBOv+mGGV}Z~5qJ?GYpVq8a=H0O?XF|-x z<-!Y1Si?RFz5ivGx;CQo*9OG~lLjr116mPweVXXMU9M*_~M3zFN3rfnDfqVZLeeOXWjL{s|Ymq`y(= zdOBZsN!DV$w)NSbeXnYkD;B3tG4lHDeAk5GdGn`Uk+`~R+4aRQ4e!33QElIR?AC2r zo8nBjgSPTgpyA4VjHs$o;L3ubQvD` zUc#`l+BMl|*0I#7Pxt?ntuH+-DLp;nvGR^SPm`(tt~0!di@sU3XYJ!JC0nx&zvkzu zaXV7{UeA5{hToRjhl}(4)>J({7x`?%^}ukW9?@tG^}KT}C(<9Rjrpj&FmXbbtYbi@ z(=&^Ee_ReO*m<^C*71UD2+N=2UE8;poSPxGb&p@hl{X%8if3>BuK8E>SUKxbz3!ZA z?xL=ox);`VnU!w7vw-t#+FW0WZw-?!KlLx$s(5B9yD|S;G5hmTG4tL{XaA_L_2Tt& z`DquQWz91$`Mld{HN&(0x|z-aFVzZcTUIQ8s{QWYid=KuUEhk9Rjt{;{yVtcJIH?p zC&%`pmGE2H)|xs#zh`*-Uu5qN>H4G{y0(4X&eQ$3=A=HCUbRE4&ALQo;wCrCNqlO% zGraC|tle-n&C*G8)=OP>p4k=Q-v0VO^Rn;FJb6#OqVYsIPwtZUwX@A`?_0Wh>H6H% z?YE%tgbXr{BEy#Ez9inY?amy7Z)66S^8~vCryBusRgUqK+SV^!=Lq*IBi%X+4~ zzQLj25z^LcBI>le6SKdW=vaR{8Z~EDs`pumoMU;1Ufq^V(RF=tR#<%gi&2^1{{S)7=>}+3n z`|$jH{nH8GB=WMZ#rfS`*CXr9pLA*Orccr4Y2gLu)1KG(9(=I9vA(zK+}+z14p*n( zr>t9_UVi#`AeP5Dxlv(i)19o-^}6L}^xyp4J#)=1>HG;(7v!leOqj@%JATzb0M7F*Msv*X*QJrR%;xzG1+@s9PHou@B{ zU2LEEWA&7#yqt~4@9g3Bj(hpwx}T=0_QnI3C0|{5^7iG$iO=6mQ~g=t#}>!;M(nQb z?s^%wqc^Ueo*Q)ew!hX&g=aon-1;6);eGD3%jDa|uNmiM4d*;~_i_EzT+p^Csn$NSu^-RS~`{fyLBkR*9_4h^oXAs;Rz!x$l>XgjOB{_Ky zUuXy4c)uoVj#1|I?=~^>dRHI6b#u-xgJ1gpB+~Vgp4I=mWhtC4|M$4- z#;~h0pQ3Lao-iw&?WE0u3$x^8Po*wA`CixjXms7xeWiRw{WIPrOnP>7O-1qETE?i^ zk5?~0{ATfn^Se$?pH}~7am>rPuVsB1Layd`>ubj)$rMdlWHWW~y?+w2_jU=r-BNb{ z(%SW(f+t>%F?afOZGP2#tK03`+&ZFf7w4N!-E9@(Ww-p$3|(2Tr2(L2KpZSg5?pTP zM}9<`DP2;}ne>3`C)d@db-cYMXC6NJ*lv2h^_P{AE7#}Ui&yh&%`-b(zqOr5QORR+ z@U4T^-l+)%w%VrVKKikfxqR9+B4e`UZ_Zn~(=Sh2j6`k76) zXG_H0nRu4}%{UT;3f&S5i`(!T8p7)7@JYy(hzS__v?Fed6+_ ze$neIT^6O96vyiehQ%HEm6zS9wO6pk`&`w*+Z%SSH?qjdkPg%Sq#5S*a?8e>epP3l zs6A+%&zoYq;O@G&+Ft+e`&OT}t+3X;B{JvXW5=g5#;Uq}rJ6Dhq34QDF20$4+hWyj zi~4QX<%_7fquyS?RElv5%j9=~B6rG)~ZQGXH(KhYuM4n^r)92R~iXJ`E`Xzte z^Q=czueSVWNH=cVk~6dFdF!0@#hu4ItC=fgOKhXMGQ{0`B};Z(&7C><ys)~kf6vsrPmkU?Uw!`y zuf~o$Yj-BkTm9+dO1l#)xr1_5j<~1F$;+nKrkY+olN26%>U-$zS(hEeqTbC&oLd=v z`&LwRA4gKQ1baOPL$Jf5+i8*7a<(ns4Q?NbS7cm!Gxo37)U!QjR?C|HeYc=o?0IVK zBC%)lbk3JPcoOkDVns#8-A{8@y~uiW#Ost^#TlzZhpaPfJ=dMgbw4Q`_HM1=wDs!g zt*X!0Bu8+&-MTVwQh3m;M~ct3=g#)?s{gfSqmDt#HR-_5|M7Kt!BcY z!79B&`-rw``0PYU#xsg;G2UJ& zs~UEBn$6Bh0jGpF%+h)wbne8LTlIcV1v8rk`VSWC-7;KWbW(avzl62y5}of^RiUp> z?*Fv@IM=+K?ZqD^nHesYlXD2$uXL@)Q>3HvFK0w}t?GXU?wxh7{8CRpkChbL_U#bI z6Kn2!Zyi1<{QBs`)WX7~qS!3{E8>pq-7E7$R<;~|TA}+c@8$h@(q*E93)ALsE-_|A5I(deMM}>BHd3kW_ zkIABan`cfJIw?_nW>eMijp3oj>gxF^IVOVpp50x#pkrZm`_wC5?sxKEuM>ZEO?HlA z?%|o5KeD|Gt85+Pgcb$LUSF)7P!{7>KSy+8&XXtg;bE8dH(5q~&&uGi7L>5+;9%hl z;cDRE67g6*k49PICsKls`>_7a}Ch{v`)lpD%uLNab8V98$CPI> zZ2N9r)jfU2IQz-*t1oW&3+ClMObP$^ed(e(>6tNl;d7ra*&S1ttGp}qednd%wrh;B zS7UBGh`K!6yYAlo*yP3Bv*tZEFUvFHd%S$3{4SgBwa1UGIAZg@-u}kf-xh7xIA*cr zWINn+be&i3JE!ut(S=XT^?YaU>+f6=>GJB-`>8j!{n(QoRdnZZ*34>_z)c!6MV#9# zZb=>MYuKx{w$9+)>t%{}y-uC*GMmk$Fh}rmSih0L^Bo;;6Fw^ySa;Z`321Z~Zd`n( z(OYth3G0=YJh_S{)MUe5SDcy2J~aM>p;p|5$nDR_pd-D>9PiaVouv z`u4(FJZod?BKD_~8sobs`)!@7V{X~LeMVC2r(JG`^JKIyecgP#U3z}qWUj?qOJwRb zCYx`PSgTTT+l&8s#zKQv9KUxY_vB>A6}9XRS`n;tetJRhQ~kNd-oATRGQO!hZk;PO z?e9Ll>HNLVug-t&bLFPa?zKyJQ|H-yaOXD3EVx+o?d{Am-E~?EwZqc2SR7|>H{Pjh zcX>;C7GG{|PcGl&Ytt*Or@Hj+4rF9Ea+TR=Rd3$4^-znFyTT9K-e>F5ElzII-Pro} zaewzcg;y6s`nT*9pZH()+mk+@o#Tyt~SR?UhSezus0>n)|@2Z>e{A(ax|VC(4r5cb@&M z_4M3qWqZZ?TC<=deh(sFH#+WVUB4|>PWIn*F-z-j&dQ1fjF&vUT64XMmYlQtt|)uh zC%N(B;kzgNz88l2xQD#CE4-dNWBq2KoB}!5>AISGbaL{FE}T()@9H*NB(-n1vA)ue z(+mF^|C<>0spOwV&L6d%J15U}j@Q0(zP-9T##5AYn(V9%-|82->Sik6JC^mF!Rpi$ ziOGto@>{LhrwX@t?raz3ycVZa=b>tpaCqmU8&_Oe)?4>#2&?hzwx2Zl-CAe6LT489 zpU3-iCzi4BPM$FNz1|6128H9FRS)bv5gp~OIsM_Bcc+GU>Vjmxh^^f=bsT6bL zd}jW{%3Z%_J`}w2X4RFe^_{D;=X%cewx4y(=-9_+?47!)S6lK{UAe!SkL{F?e`wX^ zWYCa?f`~f9$^(K-OTDbR)Wkkb3|JWXY5s~8%Z>_jM1FcFdvncZ9p+|Mi+lbKFQVtf z*-zQ_CHqsgoUwFv&z97+s~M8r*SvkQ-g|MsNPBtz@?$~`+KF2yEfA1elu)15slgvOjzM!MzCKF3@@;aG7a^H-VP+iE>`DW;IK z)7obhXX-sWeW1)pswFHF3UdWA*Rah zG}Fm=_PscU+8MKhtj--dF<~Ji!*T{6zK1)fT}!*;s=R2DedH!%cjgNdIXh0@{uw{# zkJIL-*X!d`^re-f4!nqX_?m6*)bJlqCqJIHqxiik2lFhYn!beUEc1y`nm?Y}^Q^T@ zpOara?aPnf8AgUx+r!o?Sgs41ku>YHXR= z*>tIY)QM|zclM~TZON!-714aIx{%RLY{}P(eP0dUZ>^J>J?*n@!UQ)T{%c(qj&I+5 z<#hhsw|A{iE}GV|!)#7{rS|<>A&WfD)Gn?)r*}6n!{&5_lx@TES!!v z+JoB7cD=a3sq%$)MUUanzKr4{%OtI5n@zg#pP}+^Vs_5mw(rvIGhZ!u`m+AVlRc^4 zi&qrKl}(pjJ$c`?IeXdVL$f>DE01q&yW{!V{YY8KnyR&iJhw})ziO;FzE9ng`(*FF z%X}9$-71!i@k^I7oZ*<<-0E~;OHvGHkN46L&}4O|q5_lOfevN4>n0YmToc3_uLWqB zGAs~LS$lhx(4Hr4r~YNOZrI&;$?aSH^$mL4+3rT)(R=UnXS?d}q`l%7@3%Y4PX717 zsb%t~KkL7@upfAO>~yPU>4(bN&n@f+Q@{HOoaCLCHos29%gDd^%)dK|lWN5Be;-nj z*7+zR?oieu`u&E@QI$QV4~>orAFi_SxS|!mY18$G%(FW-X7641bZd<53hxQm%>Nv( z5)-Wt-Lv5ykLYT*^D#f~1Vk-poxc73#`3`4nB>Czb4&|UuIFtqn(=2_mbXTV0DI^j zl`qpWcK>?5=%!uK%vISr8ta=>+s?+EEj$y+e&!q}dl|nssbl;V%dZm-*rKSQBbK!EEchnSj`=Y!rg?`2iiVuF;OKwgfI-V8WUf(YK!Cd06_| zoy-0+Xfmg7Z_8X=pI<01kbOW_G3(9r^zMVpuC{R>yH|3=XrlkUS;2k2zGC_s@#zcK ze4DcS{7=S5su!xG%ar&;WR#QA#ICML2x zBeN{+53DOZcjBaa!;L75U+<^iet6#@NU3gh-t!k1WevW(%lI(y&+5kd?X#I;RriF5 zH~e;(pZVG(^6~egJ@1WZiuJ9}y*HZYwyH0F0#jGQ%t>>D z0z|X~G;j25dG|4;y>`Qg1K~5~Wxlz+l_$F6)l4Ew7D*voa1#=m%XkG6YIKBT?)ZGc6eYbQy zom}sxadOqk=v`YbCO^qKp7P;maMk(A#taG;d5=uq#PrU+wP)24f9KWG;K4Hv*C_WO zj%jNro>_2l!GyI+!O6^dSDBYEwKQ%~*#F^2p3BtZ-m>7u?8i@Qx?;q4gsBr9t%{FNI9qXF12>ci^X_gumR4m1h>K ztC#ccIljnz{@+zIocMMAGc34yJu}m;T$JgogBSa+<;h#@VntWpNjF&Fo^87CcjbNg zIakXozMc9oC;IZ0Z9O)JXLQ?l8QoQUBUQ?}bMfNypEp0%@GZ`cdK0}b;OQAJy~wFs zv$u0b##=32YFhtdTJ56p&^Vn=r7fi)t8~)2--QUy(KmE?z`yD_vu|zdnWx9Y7k=G# zZf9lhh9x?(-cu`IomUqXRAn_tl)L_3{qNIyCkeZS5*!W76?{7X>^bl+@#vQKJJVl; zFE8^gy!zf$_4taZ+j(zYx%#Hf+EUJTdtmR|%0*t+=9tACXA>7aS^w?YcC(zFJ15C; zXUw_aU-9g1%-`RS=BBoXtEc9E+w^Dc!}Rt$M>~5jKc3C{b>DO!d5u-s_oK^7l<(%P zcFued-hS;oUv6`Z`zg`LD((F0ZBaGhs-LcD@HcO0Gcs@ET6x;LeADf^PrGt*@;5Qa za!DCi&U=)RG)w)cw)5i&1$*1;6FH|m{rtV7W@_0mDA9|fxt1`OI9Z&3KcJwdKyOUN_^_v(IKf-Gp1iVs>88%33D=G5mRipY6MQ*G;yccU^y? zf9v#+A76sDC%jy?y0Px%&6=snNn8aJ7H~8yVRxtxFwD@Dv{hNjzk;bDkkLiFrrXA# zI40->r{IzA8N23i{GKZ({^Tp;nQ2i~ld?DUs#aN+_qm_3cs@ZYHYnqQ+aL>jx?!9mDSHn6jT<$?ddM?|g64%uDGt(!`aXFLHuq)kNf_cdft@tgA zqITRoD3T-hTFT~N<;!`i4$l5w5D{y=Nc@+G!Z|iO9^DE5mdIOizFKIOeR0*S?~