Merge branch 'esp8266-native-library-converter' into esp8266-native-shared-helpers

esphome/espidf/framework.py

@@ -785,6 +785,7 @@ def _prefetch_idf_tool_archives(
         # The installer downloads anything missing itself; never let the
         # prefetch become a new way for the install to fail.
         _LOGGER.warning("ESP-IDF tool prefetch failed: %s", e)
+        _LOGGER.debug("Prefetch failure detail", exc_info=True)
 
 
 def _check_esphome_idf_framework_install(

esphome/platformio/extra_script.py

@@ -114,10 +114,19 @@ class _FakeSConsEnv:
         self.result = ExtraScriptResult()
         self._warned_methods: set[str] = set()
         self._warned_keys: set[str] = set()
+        self._warned_gets: set[str] = set()
 
     # ----- SCons env API the common scripts use -----
 
     def get(self, key: str, default: str | None = None) -> str | None:
+        if key not in self._vars and key not in self._warned_gets:
+            # A script branching on an unmodelled var silently takes the
+            # default branch; make that diagnosable from a normal build log
+            self._warned_gets.add(key)
+            _LOGGER.warning(
+                "PIO extra-script env.get(%r) is not modelled; returning the default",
+                key,
+            )
         return self._vars.get(key, default)
 
     def __getitem__(self, key: str) -> str:
@@ -140,6 +149,12 @@ class _FakeSConsEnv:
             bucket = getattr(self.result, key.lower())
             bucket.extend(items)
 
+    # Same keys, same flattened capture; ordering/dedup don't matter since
+    # the consumer re-orders anyway
+    Prepend = Append
+    AppendUnique = Append
+    PrependUnique = Append
+
     # ----- Everything else is a no-op so unsupported scripts don't crash -----
 
     def __getattr__(self, name: str):
@@ -267,7 +282,7 @@ def captured_as_build_flags(
     flags.extend(
         f"-L{shlex.quote(_anchored(path))}" for path in _strs(result.libpath, "LIBPATH")
     )
-    flags.extend(f"-l{lib}" for lib in _strs(result.libs, "LIBS"))
+    flags.extend(f"-l{shlex.quote(lib)}" for lib in _strs(result.libs, "LIBS"))
     for define in result.cppdefines:
         # SCons also accepts dict/list CPPDEFINES; formatting those blind
         # would hand the compiler garbage like -D{'FOO': '1'}
@@ -277,6 +292,8 @@ def captured_as_build_flags(
             flags.append(f"-D{define}")
         else:
             _LOGGER.warning("Ignoring unsupported CPPDEFINES entry %r", define)
-    flags.extend(_strs(result.linkflags, "LINKFLAGS"))
-    flags.extend(_strs(result.cppflags, "CPPFLAGS"))
+    # Each captured entry is one argv token in SCons; quote so the
+    # lex_build_flags round-trip cannot split a spaced value into two
+    flags.extend(shlex.quote(f) for f in _strs(result.linkflags, "LINKFLAGS"))
+    flags.extend(shlex.quote(f) for f in _strs(result.cppflags, "CPPFLAGS"))
     return flags

esphome/platformio/library.py

@@ -925,6 +925,12 @@ def _content_lengths(urls: list[str]) -> list[int | None]:
     """Content-Length per URL via HEAD requests; None when unknown."""
     import requests
 
+    from esphome.happy_eyeballs import ensure_happy_eyeballs
+
+    # Same convention as every other network call: without it a broken-IPv6
+    # network burns the full timeout per HEAD before falling back
+    ensure_happy_eyeballs()
+
     def head(url: str) -> int | None:
         try:
             resp = requests.head(url, timeout=10, allow_redirects=True)