From 5fac039a06b5adb356f808e0b92ee5839ddf7a91 Mon Sep 17 00:00:00 2001
From: "J. Nick Koston" <nick@koston.org>
Date: Thu, 31 Jul 2025 19:39:08 -1000
Subject: [PATCH] preen

---
 esphome/__main__.py | 68 +++++++++++++++++++++------------------------
 1 file changed, 32 insertions(+), 36 deletions(-)

diff --git a/esphome/__main__.py b/esphome/__main__.py
index 3f17cd57cf..d133b152f5 100644
--- a/esphome/__main__.py
+++ b/esphome/__main__.py
@@ -44,6 +44,7 @@ from esphome.const import (
 from esphome.core import CORE, EsphomeError, coroutine
 from esphome.helpers import get_bool_env, indent, is_ip_address
 from esphome.log import AnsiFore, color, setup_log
+from esphome.types import ConfigType
 from esphome.util import (
     get_serial_ports,
     list_yaml_files,
@@ -123,7 +124,7 @@ def mqtt_logging_enabled(mqtt_config):
     return log_topic.get(CONF_LEVEL, None) != "NONE"
 
 
-def get_port_type(port):
+def get_port_type(port: str) -> str:
     if port.startswith("/") or port.startswith("COM"):
         return "SERIAL"
     if port == "MQTT":
@@ -131,7 +132,7 @@ def get_port_type(port):
     return "NETWORK"
 
 
-def run_miniterm(config, port, args):
+def run_miniterm(config: ConfigType, port: str, args) -> int:
     from aioesphomeapi import LogParser
     import serial
 
@@ -249,7 +250,7 @@ def compile_program(args, config):
     return 0 if idedata is not None else 1
 
 
-def upload_using_esptool(config, port, file, speed):
+def upload_using_esptool(config: ConfigType, port: str, file: str, speed: int):
     from esphome import platformio_api
 
     first_baudrate = speed or config[CONF_ESPHOME][CONF_PLATFORMIO_OPTIONS].get(
@@ -314,7 +315,7 @@ def upload_using_esptool(config, port, file, speed):
     return run_esptool(115200)
 
 
-def upload_using_platformio(config, port):
+def upload_using_platformio(config: ConfigType, port: str):
     from esphome import platformio_api
 
     upload_args = ["-t", "upload", "-t", "nobuild"]
@@ -323,7 +324,7 @@ def upload_using_platformio(config, port):
     return platformio_api.run_platformio_cli_run(config, CORE.verbose, *upload_args)
 
 
-def check_permissions(port):
+def check_permissions(port: str):
     if os.name == "posix" and get_port_type(port) == "SERIAL":
         # Check if we can open selected serial port
         if not os.access(port, os.F_OK):
@@ -341,7 +342,7 @@ def check_permissions(port):
             )
 
 
-def upload_program(config, args, host: str):
+def upload_program(config: ConfigType, args, host: str):
     try:
         module = importlib.import_module("esphome.components." + CORE.target_platform)
         if getattr(module, "upload_program")(config, args, host):
@@ -402,7 +403,7 @@ def upload_program(config, args, host: str):
     return espota2.run_ota(host, remote_port, password, CORE.firmware_bin)
 
 
-def show_logs(config, args, devices: list[str]):
+def show_logs(config: ConfigType, args, devices: list[str]) -> int | None:
     if "logger" not in config:
         raise EsphomeError("Logger is not configured!")
 
@@ -522,21 +523,18 @@ def command_discover(args, config):
     raise EsphomeError("No discover method configured (mqtt)")
 
 
-def command_logs(args, config) -> int:
-    devices = args.device or []
-    if not devices:
-        # No devices specified, use the interactive chooser
-        devices = [
-            choose_upload_log_host(
-                default=None,
-                check_default=None,
-                show_ota=False,
-                show_mqtt=True,
-                show_api=True,
-                purpose="logging",
-            )
-        ]
-
+def command_logs(args, config) -> int | None:
+    # No devices specified, use the interactive chooser
+    devices = args.device or [
+        choose_upload_log_host(
+            default=None,
+            check_default=None,
+            show_ota=False,
+            show_mqtt=True,
+            show_api=True,
+            purpose="logging",
+        )
+    ]
     return show_logs(config, args, devices)
 
 
@@ -557,22 +555,20 @@ def command_run(args, config):
         program_path = idedata.raw["prog_path"]
         return run_external_process(program_path)
 
-    devices = args.device or []
-    if not devices:
-        # No devices specified, use the interactive chooser
-        devices = [
-            choose_upload_log_host(
-                default=None,
-                check_default=None,
-                show_ota=True,
-                show_mqtt=False,
-                show_api=True,
-                purpose="uploading",
-            )
-        ]
+    # No devices specified, use the interactive chooser
+    devices = args.device or [
+        choose_upload_log_host(
+            default=None,
+            check_default=None,
+            show_ota=True,
+            show_mqtt=False,
+            show_api=True,
+            purpose="uploading",
+        )
+    ]
 
     # Try each device for upload until one succeeds
-    successful_device = None
+    successful_device: str | None = None
     for device in devices:
         _LOGGER.info("Uploading to %s", device)
         exit_code = upload_program(config, args, device)