fixup! feat(core.utils): derive __all__ from _LAZY_CACHE_ATTRS; document star-import caveat

Defines the ordered lazy-export tuple once and splices it into __all__ so
the two lists cannot drift. Notes that star-import still eagerly resolves
every lazy attribute (walking __all__ pulls _program_cache in), which is
expected given star-imports are already discouraged.

Author: cpcloud

cuda_core/cuda/core/utils/__init__.py

@@ -7,27 +7,26 @@
     args_viewable_as_strided_memory,
 )
 
-__all__ = [
+# Lazily expose the program-cache APIs so ``from cuda.core.utils import
+# StridedMemoryView`` stays lightweight -- the cache backends pull in driver,
+# NVRTC, and module-load machinery that memoryview-only consumers do not need.
+# The laziness guarantee is for explicit imports only: ``from cuda.core.utils
+# import *`` walks ``__all__`` and therefore resolves every lazy attribute,
+# which eagerly pulls ``_program_cache`` in. Star-imports are discouraged
+# anyway, so treat that as expected.
+_LAZY_CACHE_ATTRS = (
     "FileStreamProgramCache",
     "ProgramCacheResource",
     "SQLiteProgramCache",
+    "make_program_cache_key",
+)
+
+__all__ = [
     "StridedMemoryView",
     "args_viewable_as_strided_memory",
-    "make_program_cache_key",
+    *_LAZY_CACHE_ATTRS,
 ]
 
-# Lazily expose the program-cache APIs so ``from cuda.core.utils import
-# StridedMemoryView`` stays lightweight -- the cache backends pull in driver,
-# NVRTC, and module-load machinery that memoryview-only consumers do not need.
-_LAZY_CACHE_ATTRS = frozenset(
-    {
-        "FileStreamProgramCache",
-        "ProgramCacheResource",
-        "SQLiteProgramCache",
-        "make_program_cache_key",
-    }
-)
-
 
 def __getattr__(name):
     if name in _LAZY_CACHE_ATTRS: