From b0996ac4045ee93ad5bd3284e35ec90652ca4cdd Mon Sep 17 00:00:00 2001
From: "J. Nick Koston" <nick@koston.org>
Date: Wed, 16 Sep 2026 00:11:57 -0500
Subject: [PATCH] [template] Skip the switch optimistic and assumed state
 setters when they match the default (#19232)

---
 esphome/components/template/switch/__init__.py |  7 +++++--
 .../template/switch/template_switch.h          |  1 +
 .../template/config/switch_defaults.yaml       | 18 ++++++++++++++++++
 .../template/test_template_switch.py           | 17 +++++++++++++++++
 4 files changed, 41 insertions(+), 2 deletions(-)
 create mode 100644 tests/component_tests/template/config/switch_defaults.yaml
 create mode 100644 tests/component_tests/template/test_template_switch.py

diff --git a/esphome/components/template/switch/__init__.py b/esphome/components/template/switch/__init__.py
index 37303abb0d7..0b246869363 100644
--- a/esphome/components/template/switch/__init__.py
+++ b/esphome/components/template/switch/__init__.py
@@ -72,8 +72,11 @@ async def to_code(config):
         await automation.build_automation(
             var.get_turn_on_trigger(), [], config[CONF_TURN_ON_ACTION]
         )
-    cg.add(var.set_optimistic(config[CONF_OPTIMISTIC]))
-    cg.add(var.set_assumed_state(config[CONF_ASSUMED_STATE]))
+    # optimistic_ and assumed_state_ are false in C++; only emit setters to turn them on.
+    if config[CONF_OPTIMISTIC]:
+        cg.add(var.set_optimistic(True))
+    if config[CONF_ASSUMED_STATE]:
+        cg.add(var.set_assumed_state(True))
 
 
 @automation.register_action(
diff --git a/esphome/components/template/switch/template_switch.h b/esphome/components/template/switch/template_switch.h
index 1714b4f72b9..3b8b6cde424 100644
--- a/esphome/components/template/switch/template_switch.h
+++ b/esphome/components/template/switch/template_switch.h
@@ -29,6 +29,7 @@ class TemplateSwitch final : public switch_::Switch, public Component {
   void write_state(bool state) override;
 
   TemplateLambda<bool> f_;
+  // Codegen only emits these setters to turn them on
   bool optimistic_{false};
   bool assumed_state_{false};
   Trigger<> turn_on_trigger_;
diff --git a/tests/component_tests/template/config/switch_defaults.yaml b/tests/component_tests/template/config/switch_defaults.yaml
new file mode 100644
index 00000000000..4387fe07a5b
--- /dev/null
+++ b/tests/component_tests/template/config/switch_defaults.yaml
@@ -0,0 +1,18 @@
+---
+esphome:
+  name: test
+
+esp32:
+  board: esp32dev
+
+logger:
+
+switch:
+  - platform: template
+    id: plain_switch
+    turn_on_action:
+      - logger.log: "on"
+  - platform: template
+    id: enabled_switch
+    optimistic: true
+    assumed_state: true
diff --git a/tests/component_tests/template/test_template_switch.py b/tests/component_tests/template/test_template_switch.py
new file mode 100644
index 00000000000..11c6a9cab87
--- /dev/null
+++ b/tests/component_tests/template/test_template_switch.py
@@ -0,0 +1,17 @@
+"""Tests for the template switch codegen."""
+
+from collections.abc import Callable
+from pathlib import Path
+
+
+def test_default_flags_are_not_emitted(
+    generate_main: Callable[[str | Path], str],
+    component_config_path: Callable[[str], Path],
+) -> None:
+    """Only true optimistic and assumed_state are set; false is the C++ initializer."""
+    main_cpp = generate_main(component_config_path("switch_defaults.yaml"))
+
+    assert "plain_switch->set_optimistic(" not in main_cpp
+    assert "plain_switch->set_assumed_state(" not in main_cpp
+    assert "enabled_switch->set_optimistic(true);" in main_cpp
+    assert "enabled_switch->set_assumed_state(true);" in main_cpp