Ensure that concurrent.future.Future has the right module name (e.g. in exceptions)

Author: pelson

Lib/concurrent/futures/__init__.py

@@ -47,5 +47,13 @@
     __all__.append('InterpreterPoolExecutor')
 
 
+# Set __module__ to the public location rather than the private _base module.
+Future.__module__ = 'concurrent.futures'
+Executor.__module__ = 'concurrent.futures'
+CancelledError.__module__ = 'concurrent.futures'
+InvalidStateError.__module__ = 'concurrent.futures'
+BrokenExecutor.__module__ = 'concurrent.futures'
+
+
 def __dir__():
     return __all__ + ['__author__', '__doc__']

Lib/test/test_concurrent_futures/test_future.py

@@ -135,6 +135,20 @@ def test_repr(self):
                 repr(SUCCESSFUL_FUTURE),
                 '<Future at 0x[0-9a-f]+ state=finished returned int>')
 
+    def test_class_str(self):
+        self.assertEqual(str(futures.Future),
+                         "<class 'concurrent.futures.Future'>")
+        self.assertEqual(str(futures.CancelledError),
+                         "<class 'concurrent.futures.CancelledError'>")
+        self.assertEqual(str(futures.TimeoutError),
+                         "<class 'TimeoutError'>")
+        self.assertEqual(str(futures.Executor),
+                         "<class 'concurrent.futures.Executor'>")
+        self.assertEqual(str(futures.InvalidStateError),
+                         "<class 'concurrent.futures.InvalidStateError'>")
+        self.assertEqual(str(futures.BrokenExecutor),
+                         "<class 'concurrent.futures.BrokenExecutor'>")
+
     def test_cancel(self):
         f1 = create_future(state=PENDING)
         f2 = create_future(state=RUNNING)

Misc/NEWS.d/next/Library/2026-08-18-04-30-00.gh-issue-115386.aB3xYz.rst

@@ -0,0 +1,5 @@
+Set ``__module__`` to ``concurrent.futures`` on the public classes
+``Future``, ``Executor``, ``CancelledError``, ``InvalidStateError`` and
+``BrokenExecutor``, so their ``repr`` and exception tracebacks reference the
+documented public location rather than the private ``concurrent.futures._base``
+module.