"""The test for the sql sensor platform.""" from __future__ import annotations from datetime import timedelta from unittest.mock import patch import pytest from sqlalchemy import text as sql_text from sqlalchemy.exc import SQLAlchemyError from homeassistant.components.recorder import Recorder from homeassistant.components.sensor import SensorDeviceClass, SensorStateClass from homeassistant.components.sql.const import DOMAIN from homeassistant.config_entries import SOURCE_USER from homeassistant.const import STATE_UNKNOWN from homeassistant.core import HomeAssistant from homeassistant.setup import async_setup_component from homeassistant.util import dt from . import YAML_CONFIG, init_integration from tests.common import MockConfigEntry, async_fire_time_changed async def test_query(recorder_mock: Recorder, hass: HomeAssistant) -> None: """Test the SQL sensor.""" config = { "db_url": "sqlite://", "query": "SELECT 5 as value", "column": "value", "name": "Select value SQL query", } await init_integration(hass, config) state = hass.states.get("sensor.select_value_sql_query") assert state.state == "5" assert state.attributes["value"] == 5 async def test_query_value_template( recorder_mock: Recorder, hass: HomeAssistant ) -> None: """Test the SQL sensor.""" config = { "db_url": "sqlite://", "query": "SELECT 5.01 as value", "column": "value", "name": "count_tables", "value_template": "{{ value | int }}", } await init_integration(hass, config) state = hass.states.get("sensor.count_tables") assert state.state == "5" async def test_query_value_template_invalid( recorder_mock: Recorder, hass: HomeAssistant ) -> None: """Test the SQL sensor.""" config = { "db_url": "sqlite://", "query": "SELECT 5.01 as value", "column": "value", "name": "count_tables", "value_template": "{{ value | dontwork }}", } await init_integration(hass, config) state = hass.states.get("sensor.count_tables") assert state.state == "5.01" async def test_query_limit(recorder_mock: Recorder, hass: HomeAssistant) -> None: """Test the SQL sensor with a query containing 'LIMIT' in lowercase.""" config = { "db_url": "sqlite://", "query": "SELECT 5 as value limit 1", "column": "value", "name": "Select value SQL query", } await init_integration(hass, config) state = hass.states.get("sensor.select_value_sql_query") assert state.state == "5" assert state.attributes["value"] == 5 async def test_query_no_value( recorder_mock: Recorder, hass: HomeAssistant, caplog: pytest.LogCaptureFixture ) -> None: """Test the SQL sensor with a query that returns no value.""" config = { "db_url": "sqlite://", "query": "SELECT 5 as value where 1=2", "column": "value", "name": "count_tables", } await init_integration(hass, config) state = hass.states.get("sensor.count_tables") assert state.state == STATE_UNKNOWN text = "SELECT 5 as value where 1=2 LIMIT 1; returned no results" assert text in caplog.text async def test_query_mssql_no_result( recorder_mock: Recorder, hass: HomeAssistant, caplog: pytest.LogCaptureFixture ) -> None: """Test the SQL sensor with a query that returns no value.""" config = { "db_url": "mssql://", "query": "SELECT 5 as value where 1=2", "column": "value", "name": "count_tables", } with patch("homeassistant.components.sql.sensor.sqlalchemy"), patch( "homeassistant.components.sql.sensor.sqlalchemy.text", return_value=sql_text("SELECT TOP 1 5 as value where 1=2"), ): await init_integration(hass, config) state = hass.states.get("sensor.count_tables") assert state.state == STATE_UNKNOWN text = "SELECT TOP 1 5 AS VALUE WHERE 1=2 returned no results" assert text in caplog.text @pytest.mark.parametrize( ("url", "expected_patterns", "not_expected_patterns"), [ ( "sqlite://homeassistant:hunter2@homeassistant.local", ["sqlite://****:****@homeassistant.local"], ["sqlite://homeassistant:hunter2@homeassistant.local"], ), ( "sqlite://homeassistant.local", ["sqlite://homeassistant.local"], [], ), ], ) async def test_invalid_url_setup( recorder_mock: Recorder, hass: HomeAssistant, caplog: pytest.LogCaptureFixture, url: str, expected_patterns: str, not_expected_patterns: str, ) -> None: """Test invalid db url with redacted credentials.""" config = { "db_url": url, "query": "SELECT 5 as value", "column": "value", "name": "count_tables", } entry = MockConfigEntry( domain=DOMAIN, source=SOURCE_USER, data={}, options=config, entry_id="1", ) entry.add_to_hass(hass) with patch( "homeassistant.components.sql.sensor.sqlalchemy.create_engine", side_effect=SQLAlchemyError(url), ): await hass.config_entries.async_setup(entry.entry_id) await hass.async_block_till_done() for pattern in not_expected_patterns: assert pattern not in caplog.text for pattern in expected_patterns: assert pattern in caplog.text async def test_invalid_url_on_update( hass: HomeAssistant, caplog: pytest.LogCaptureFixture, ) -> None: """Test invalid db url with redacted credentials on retry.""" config = { "db_url": "sqlite://", "query": "SELECT 5 as value", "column": "value", "name": "count_tables", } entry = MockConfigEntry( domain=DOMAIN, source=SOURCE_USER, data={}, options=config, entry_id="1", ) entry.add_to_hass(hass) await hass.config_entries.async_setup(entry.entry_id) await hass.async_block_till_done() with patch( "homeassistant.components.recorder", ), patch( "homeassistant.components.sql.sensor.sqlalchemy.engine.cursor.CursorResult", side_effect=SQLAlchemyError( "sqlite://homeassistant:hunter2@homeassistant.local" ), ): async_fire_time_changed( hass, dt.utcnow() + timedelta(minutes=1), ) await hass.async_block_till_done() assert "sqlite://homeassistant:hunter2@homeassistant.local" not in caplog.text assert "sqlite://****:****@homeassistant.local" in caplog.text async def test_query_from_yaml(recorder_mock: Recorder, hass: HomeAssistant) -> None: """Test the SQL sensor from yaml config.""" assert await async_setup_component(hass, DOMAIN, YAML_CONFIG) await hass.async_block_till_done() state = hass.states.get("sensor.get_value") assert state.state == "5" async def test_config_from_old_yaml( recorder_mock: Recorder, hass: HomeAssistant ) -> None: """Test the SQL sensor from old yaml config does not create any entity.""" config = { "sensor": { "platform": "sql", "db_url": "sqlite://", "queries": [ { "name": "count_tables", "query": "SELECT 5 as value", "column": "value", } ], } } assert await async_setup_component(hass, "sensor", config) await hass.async_block_till_done() state = hass.states.get("sensor.count_tables") assert not state @pytest.mark.parametrize( ("url", "expected_patterns", "not_expected_patterns"), [ ( "sqlite://homeassistant:hunter2@homeassistant.local", ["sqlite://****:****@homeassistant.local"], ["sqlite://homeassistant:hunter2@homeassistant.local"], ), ( "sqlite://homeassistant.local", ["sqlite://homeassistant.local"], [], ), ], ) async def test_invalid_url_setup_from_yaml( recorder_mock: Recorder, hass: HomeAssistant, caplog: pytest.LogCaptureFixture, url: str, expected_patterns: str, not_expected_patterns: str, ) -> None: """Test invalid db url with redacted credentials from yaml setup.""" config = { "sql": { "db_url": url, "query": "SELECT 5 as value", "column": "value", "name": "count_tables", } } with patch( "homeassistant.components.sql.sensor.sqlalchemy.create_engine", side_effect=SQLAlchemyError(url), ): assert await async_setup_component(hass, DOMAIN, config) await hass.async_block_till_done() for pattern in not_expected_patterns: assert pattern not in caplog.text for pattern in expected_patterns: assert pattern in caplog.text async def test_attributes_from_yaml_setup( recorder_mock: Recorder, hass: HomeAssistant ) -> None: """Test attributes from yaml config.""" assert await async_setup_component(hass, DOMAIN, YAML_CONFIG) await hass.async_block_till_done() state = hass.states.get("sensor.get_value") assert state.state == "5" assert state.attributes["device_class"] == SensorDeviceClass.DATA_RATE assert state.attributes["state_class"] == SensorStateClass.MEASUREMENT assert state.attributes["unit_of_measurement"] == "MiB"