Merge pull request #3488 from plotly/fix-pkgutil

Fix pkgutil.loader removal

Author: T4rk1n

.github/workflows/testing.yml

@@ -135,8 +135,7 @@ jobs:
 
       - name: Run typing tests
         run: |
-          cd tests
-          pytest compliance/test_typing.py
+          pytest tests/compliance/test_typing.py
 
   background-callbacks:
     name: Run Background & Async Callback Tests (Python ${{ matrix.python-version }})

CHANGELOG.md

@@ -19,6 +19,7 @@ This project adheres to [Semantic Versioning](https://semver.org/).
 - [#3395](https://github.com/plotly/dash/pull/3395) Fix Components added through set_props() cannot trigger related callback functions. Fix [#3316](https://github.com/plotly/dash/issues/3316)
 - [#3415](https://github.com/plotly/dash/pull/3415) Fix the error triggered when only a single no_update is returned for client-side callback functions with multiple Outputs. Fix [#3366](https://github.com/plotly/dash/issues/3366)
 - [#3416](https://github.com/plotly/dash/issues/3416) Fix DeprecationWarning in dash/_jupyter.py by migrating from deprecated ipykernel.comm.Comm to comm module
+- [#3488](https://github.com/plotly/dash/pull/3488) Fix pkgutil.find_loader removal in Python 3.14
 
 ## [3.2.0] - 2025-07-31
 

dash/_callback.py

@@ -2,7 +2,7 @@
 import hashlib
 from functools import wraps
 
-from typing import Callable, Optional, Any, List, Tuple, Union
+from typing import Callable, Optional, Any, List, Tuple, Union, Dict
 
 
 import asyncio
@@ -59,10 +59,10 @@ def _invoke_callback(func, *args, **kwargs):  # used to mark the frame for the d
     return func(*args, **kwargs)  # %% callback invoked %%
 
 
-GLOBAL_CALLBACK_LIST = []
-GLOBAL_CALLBACK_MAP = {}
-GLOBAL_INLINE_SCRIPTS = []
-GLOBAL_API_PATHS = {}
+GLOBAL_CALLBACK_LIST: List[Any] = []
+GLOBAL_CALLBACK_MAP: Dict[str, Any] = {}
+GLOBAL_INLINE_SCRIPTS: List[Any] = []
+GLOBAL_API_PATHS: Dict[str, Any] = {}
 
 
 # pylint: disable=too-many-locals,too-many-arguments
@@ -177,7 +177,7 @@ def callback(
             callbacks in the Dash devtools.
     """
 
-    background_spec = None
+    background_spec: Any = None
 
     config_prevent_initial_callbacks = _kwargs.pop(
         "config_prevent_initial_callbacks", False
@@ -186,7 +186,7 @@ def callback(
     callback_list = _kwargs.pop("callback_list", GLOBAL_CALLBACK_LIST)
 
     if background:
-        background_spec: Any = {
+        background_spec = {
             "interval": interval,
         }
 
@@ -687,7 +687,7 @@ def add_context(*args, **kwargs):
                 args, kwargs, inputs_state_indices, has_output, insert_output
             )
 
-            response: dict = {"multi": True}
+            response: dict = {"multi": True}  # type: ignore
 
             jsonResponse = None
             try:
@@ -759,7 +759,7 @@ async def async_add_context(*args, **kwargs):
                 args, kwargs, inputs_state_indices, has_output, insert_output
             )
 
-            response: dict = {"multi": True}
+            response = {"multi": True}
 
             try:
                 if background is not None:

dash/_callback_context.py

@@ -10,7 +10,9 @@
 from ._utils import AttributeDict, stringify_id
 
 
-context_value = contextvars.ContextVar("callback_context")
+context_value: contextvars.ContextVar[
+    typing.Dict[str, typing.Any]
+] = contextvars.ContextVar("callback_context")
 context_value.set({})
 
 

dash/_dash_renderer.py

@@ -1,10 +1,11 @@
 import os
+from typing import Any, List, Dict
 
 __version__ = "2.2.0"
 
 _available_react_versions = {"18.3.1", "18.2.0", "16.14.0"}
 _available_reactdom_versions = {"18.3.1", "18.2.0", "16.14.0"}
-_js_dist_dependencies = []  # to be set by _set_react_version
+_js_dist_dependencies: List[Dict[str, Any]] = []  # to be set by _set_react_version
 
 
 def _set_react_version(v_react, v_reactdom=None):

dash/_get_app.py

@@ -2,10 +2,11 @@
 
 from contextvars import ContextVar, copy_context
 from textwrap import dedent
+from typing import Any, Optional
 
-APP = None
+APP: Optional[Any] = None
 
-app_context = ContextVar("dash_app_context")
+app_context: ContextVar[Any] = ContextVar("dash_app_context")
 
 
 def with_app_context(func):

dash/_hooks.py

@@ -27,7 +27,9 @@
 
 # pylint: disable=too-few-public-methods
 class _Hook(_tx.Generic[HookDataType]):
-    def __init__(self, func, priority=0, final=False, data: HookDataType = None):
+    def __init__(
+        self, func, priority=0, final=False, data: _t.Optional[HookDataType] = None
+    ):
         self.func = func
         self.final = final
         self.data = data
@@ -39,7 +41,7 @@ def __call__(self, *args, **kwargs):
 
 class _Hooks:
     def __init__(self) -> None:
-        self._ns = {
+        self._ns: _t.Dict[str, _t.List[_t.Any]] = {
             "setup": [],
             "layout": [],
             "routes": [],
@@ -49,14 +51,14 @@ def __init__(self) -> None:
             "custom_data": [],
             "dev_tools": [],
         }
-        self._js_dist = []
-        self._css_dist = []
+        self._js_dist: _t.List[_t.Any] = []
+        self._css_dist: _t.List[_t.Any] = []
         self._clientside_callbacks: _t.List[
             _t.Tuple[ClientsideFuncType, _t.Any, _t.Any]
         ] = []
 
         # final hooks are a single hook added to the end of regular hooks.
-        self._finals = {}
+        self._finals: _t.Dict[str, _t.Any] = {}
 
     def add_hook(
         self,

dash/_jupyter.py

@@ -1,4 +1,3 @@
-# type: ignore
 import asyncio
 import io
 import inspect
@@ -10,29 +9,83 @@
 import threading
 import time
 
-from typing import Optional
+from typing import Optional, Any
 from typing_extensions import Literal
 
 from werkzeug.serving import make_server
 
-
 try:
-    from IPython import get_ipython
-    from IPython.display import IFrame, display, Javascript
-    from IPython.core.display import HTML
-    from IPython.core.ultratb import FormattedTB
-    from retrying import retry
-    from comm import create_comm
-    import nest_asyncio
+    from IPython import get_ipython  # type: ignore[attr-defined]
+    from IPython.display import IFrame, display, Javascript  # type: ignore[import-not-found]
+    from IPython.core.display import HTML  # type: ignore[import-not-found]
+    from IPython.core.ultratb import FormattedTB  # type: ignore[import-not-found]
+    from retrying import retry  # type: ignore[import-untyped]
+    from comm import create_comm  # type: ignore[import-not-found]
+    import nest_asyncio  # type: ignore[import-untyped]
 
-    import requests
+    import requests  # type: ignore[import-untyped]
 
-    _dash_comm = create_comm(target_name="dash")
+    _dash_comm = create_comm(target_name="dash")  # type: ignore[misc]
     _dep_installed = True
 except ImportError:
     _dep_installed = False
-    _dash_comm = None
-    get_ipython = lambda: None
+    _dash_comm = None  # type: ignore[assignment]
+
+    # Stub implementations for when dependencies are not installed
+    def get_ipython():  # type: ignore[misc]
+        return None
+
+    # pylint: disable=unused-argument
+    def retry(*args: Any, **kwargs: Any):  # type: ignore[misc]
+        def decorator(func: Any) -> Any:
+            return func
+
+        return decorator
+
+    # pylint: disable=unused-argument,too-few-public-methods
+    class IFrame:  # type: ignore[no-redef]
+        def __init__(self, *args: Any, **kwargs: Any) -> None:
+            pass
+
+    # pylint: disable=unused-argument,too-few-public-methods
+    def display(*args: Any, **kwargs: Any) -> None:  # type: ignore[misc]
+        pass
+
+    # pylint: disable=unused-argument,too-few-public-methods
+    class Javascript:  # type: ignore[no-redef]
+        def __init__(self, *args: Any, **kwargs: Any) -> None:
+            pass
+
+    # pylint: disable=unused-argument,too-few-public-methods
+    class HTML:  # type: ignore[no-redef]
+        def __init__(self, *args: Any, **kwargs: Any) -> None:
+            pass
+
+    # pylint: disable=unused-argument,too-few-public-methods
+    class FormattedTB:  # type: ignore[no-redef]
+        def __init__(self, *args: Any, **kwargs: Any) -> None:
+            pass
+
+        def __call__(self, *args: Any, **kwargs: Any) -> None:
+            pass
+
+    # pylint: disable=unused-argument,too-few-public-methods
+    class _RequestsModule:  # type: ignore[misc]
+        class ConnectionError(Exception):
+            pass
+
+        def get(self, *args: Any, **kwargs: Any) -> Any:
+            return None
+
+    requests = _RequestsModule()  # type: ignore[assignment]
+
+    # pylint: disable=unused-argument,too-few-public-methods
+    class _NestAsyncioModule:  # type: ignore[misc]
+        @staticmethod
+        def apply(*args: Any, **kwargs: Any) -> None:
+            pass
+
+    nest_asyncio = _NestAsyncioModule()  # type: ignore[assignment]
 
 JupyterDisplayMode = Literal["inline", "external", "jupyterlab", "tab", "_none"]
 
@@ -44,7 +97,7 @@ def _get_skip(error: Exception):
 
     tb = error.__traceback__
     skip = 1
-    while tb.tb_next is not None:
+    while tb is not None and tb.tb_next is not None:
         skip += 1
         tb = tb.tb_next
         if tb.tb_frame.f_code is _invoke_callback.__code__:
@@ -89,9 +142,9 @@ def convert(name, locals=locals, formatarg=formatarg, formatvalue=formatvalue):
     return "(\n    " + ",\n    ".join(specs) + "\n)"
 
 
-_jupyter_config = {}
+_jupyter_config: Any = {}
 
-_caller = {}
+_caller: Any = {}
 
 
 def _send_jupyter_config_comm_request():
@@ -102,9 +155,10 @@ def _send_jupyter_config_comm_request():
         ipython is not None
         and hasattr(ipython, "kernel")
         and ipython.kernel is not None
+        and _dash_comm is not None
     ):
         _caller["parent"] = ipython.kernel.get_parent()
-        _dash_comm.send({"type": "base_url_request"})
+        _dash_comm.send({"type": "base_url_request"})  # type: ignore[attr-defined]
 
 
 def _jupyter_comm_response_received():
@@ -121,19 +175,19 @@ def _request_jupyter_config(timeout=2):
     _send_jupyter_config_comm_request()
 
     # Get shell and kernel
-    shell = get_ipython()
-    kernel = shell.kernel
+    shell = ipython
+    kernel = shell.kernel  # type: ignore[attr-defined]
 
     # Start capturing shell events to replay later
     captured_events = []
 
     def capture_event(stream, ident, parent):
         captured_events.append((stream, ident, parent))
 
-    kernel.shell_handlers["execute_request"] = capture_event
+    kernel.shell_handlers["execute_request"] = capture_event  # type: ignore[attr-defined]
 
     # increment execution count to avoid collision error
-    shell.execution_count += 1
+    shell.execution_count += 1  # type: ignore[attr-defined]
 
     # Allow kernel to execute comms until we receive the jupyter configuration comm
     # response
@@ -181,7 +235,7 @@ class JupyterDash:
     alive_token = str(uuid.uuid4())
     inline_exceptions: bool = True
 
-    _servers = {}
+    _servers: Any = {}
 
     def infer_jupyter_proxy_config(self):
         """
@@ -343,7 +397,7 @@ def run_app(
         except ImportError:
             pass
 
-        err_q = queue.Queue()
+        err_q: Any = queue.Queue()
 
         server = make_server(host, port, app.server, threaded=True, processes=0)
         logging.getLogger("werkzeug").setLevel(logging.ERROR)
@@ -422,7 +476,7 @@ def wait_for_app():
     @staticmethod
     def _display_in_colab(dashboard_url, port, mode, width, height):
         # noinspection PyUnresolvedReferences
-        from google.colab import output  # pylint: disable=E0401,E0611,C0415
+        from google.colab import output  # type: ignore[import-not-found]  # pylint: disable=E0401,E0611,C0415
 
         if mode == "inline":
             output.serve_kernel_port_as_iframe(port, width=width, height=height)
@@ -444,13 +498,14 @@ def _display_in_jupyter(dashboard_url, port, mode, width, height):
         elif mode == "jupyterlab":
             # Update front-end extension
             # FIXME valid only in jupyterlab but accepted in regular notebooks show nothing.
-            _dash_comm.send(
-                {
-                    "type": "show",
-                    "port": port,
-                    "url": dashboard_url,
-                }
-            )
+            if _dash_comm is not None:
+                _dash_comm.send(  # type: ignore[attr-defined]
+                    {
+                        "type": "show",
+                        "port": port,
+                        "url": dashboard_url,
+                    }
+                )
 
     @staticmethod
     def serve_alive():