.. method:: loop.set_default_executor(executor)
Set *executor* as the default executor used by :meth:`run_in_executor`.
- *executor* should be an instance of
+ *executor* must be an instance of
:class:`~concurrent.futures.ThreadPoolExecutor`.
- .. deprecated:: 3.8
- Using an executor that is not an instance of
- :class:`~concurrent.futures.ThreadPoolExecutor` is deprecated and
- will trigger an error in Python 3.9.
-
- *executor* must be an instance of
- :class:`concurrent.futures.ThreadPoolExecutor`.
+ .. versionchanged:: 3.11
+ *executor* must be an instance of
+ :class:`~concurrent.futures.ThreadPoolExecutor`.
Error Handling API
that may require changes to your code.
+Changes in the Python API
+-------------------------
+
+* Prohibited passing non-:class:`concurrent.futures.ThreadPoolExecutor`
+ executors to :meth:`loop.set_default_executor` following a deprecation in
+ Python 3.8.
+ (Contributed by Illia Volochii in :issue:`43234`.)
+
+
C API Changes
=============
def set_default_executor(self, executor):
if not isinstance(executor, concurrent.futures.ThreadPoolExecutor):
- warnings.warn(
- 'Using the default executor that is not an instance of '
- 'ThreadPoolExecutor is deprecated and will be prohibited '
- 'in Python 3.9',
- DeprecationWarning, 2)
+ raise TypeError('executor must be ThreadPoolExecutor instance')
self._default_executor = executor
def _getaddrinfo_debug(self, host, port, family, type, proto, flags):
self.loop.set_default_executor(executor)
self.assertIs(executor, self.loop._default_executor)
- def test_set_default_executor_deprecation_warnings(self):
+ def test_set_default_executor_error(self):
executor = mock.Mock()
- with self.assertWarns(DeprecationWarning):
+ msg = 'executor must be ThreadPoolExecutor instance'
+ with self.assertRaisesRegex(TypeError, msg):
self.loop.set_default_executor(executor)
- # Avoid cleaning up the executor mock
- self.loop._default_executor = None
+ self.assertIsNone(self.loop._default_executor)
def test_call_soon(self):
def cb():
--- /dev/null
+Prohibit passing non-:class:`concurrent.futures.ThreadPoolExecutor`
+executors to :meth:`loop.set_default_executor` following a deprecation in
+Python 3.8. Patch by Illia Volochii.