gh-144384: Lazily import _colorize

.github/workflows/mypy.yml

@@ -71,7 +71,8 @@ jobs:
  persist-credentials: false
  - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
  with:
- python-version: "3.13"
+ python-version: "3.15"
+ allow-prereleases: true
  cache: pip
  cache-dependency-path: Tools/requirements-dev.txt
  - run: pip install -r Tools/requirements-dev.txt

Lib/difflib.py

@@ -30,10 +30,10 @@
  'Differ','IS_CHARACTER_JUNK', 'IS_LINE_JUNK', 'context_diff',
  'unified_diff', 'diff_bytes', 'HtmlDiff', 'Match']
 
-from _colorize import can_colorize, get_theme
 from heapq import nlargest as _nlargest
 from collections import namedtuple as _namedtuple
 from types import GenericAlias
+lazy from _colorize import can_colorize, get_theme
 
 Match = _namedtuple('Match', 'a b size')
 

Lib/doctest.py

@@ -106,8 +106,8 @@ def _test():
 import unittest
 from io import StringIO, TextIOWrapper, BytesIO
 from collections import namedtuple
-import _colorize # Used in doctests
-from _colorize import ANSIColors, can_colorize
+lazy import _colorize # Used in doctests
+lazy from _colorize import ANSIColors, can_colorize
 
 
 class TestResults(namedtuple('TestResults', 'failed attempted')):

Lib/profiling/sampling/live_collector/collector.py

@@ -9,7 +9,7 @@
 import sys
 import sysconfig
 import time
-import _colorize
+lazy import _colorize
 
 from ..collector import Collector, extract_lineno
 from ..constants import (

Lib/profiling/sampling/pstats_collector.py

@@ -1,8 +1,8 @@
 import collections
 import marshal
 import pstats
+lazy from _colorize import ANSIColors
 
-from _colorize import ANSIColors
 from .collector import Collector, extract_lineno
 from .constants import MICROSECONDS_PER_SECOND, PROFILING_MODE_CPU
 

Lib/profiling/sampling/sample.py

@@ -6,7 +6,7 @@
 import sysconfig
 import time
 from collections import deque
-from _colorize import ANSIColors
+lazy from _colorize import ANSIColors
 
 from .pstats_collector import PstatsCollector
 from .stack_collector import CollapsedStackCollector, FlamegraphCollector

Lib/test/test_difflib.py

@@ -1,5 +1,7 @@
 import difflib
+from test import support
 from test.support import findfile, force_colorized
+from test.support.import_helper import ensure_lazy_imports
 import unittest
 import doctest
 import sys
@@ -644,6 +646,12 @@ def setUpModule():
  difflib.HtmlDiff._default_prefix = 0
 
 
+class LazyImportTest(unittest.TestCase):
+ @support.cpython_only
+ def test_lazy_import(self):
+ ensure_lazy_imports("difflib", {"_colorize"})
+
+
 def load_tests(loader, tests, pattern):
  tests.addTest(doctest.DocTestSuite(difflib))
  return tests

Lib/test/test_traceback.py

@@ -23,7 +23,7 @@
  requires_subprocess, os_helper)
 from test.support.os_helper import TESTFN, temp_dir, unlink
 from test.support.script_helper import assert_python_ok, assert_python_failure, make_script
-from test.support.import_helper import forget
+from test.support.import_helper import ensure_lazy_imports, forget
 from test.support import force_not_colorized, force_not_colorized_test_class
 
 import json
@@ -5632,5 +5632,11 @@ def test_suggestion_still_works_for_non_lazy_attributes(self):
  self.assertNotIn(b"BAR_MODULE_LOADED", stdout)
 
 
+class LazyImportTest(unittest.TestCase):
+ @support.cpython_only
+ def test_lazy_import(self):
+ ensure_lazy_imports("traceback", {"_colorize"})
+
+
 if __name__ == "__main__":
  unittest.main()

Lib/traceback.py

@@ -16,9 +16,9 @@
 import io
 import importlib.util
 import pathlib
-import _colorize
 
 from contextlib import suppress
+lazy import _colorize
 
 try:
  from _missing_stdlib_info import _MISSING_STDLIB_MODULE_MESSAGES
@@ -32,6 +32,36 @@
  'FrameSummary', 'StackSummary', 'TracebackException',
  'walk_stack', 'walk_tb', 'print_list']
 
+
+class _ShutdownTheme:
+ """Empty stand-in if `_colorize` cannot be imported during late shutdown."""
+ def __getattr__(self, _): return self
+ def __getitem__(self, _): return ""
+ def __format__(self, _): return ""
+ def __str__(self): return ""
+ def __add__(self, other): return other
+ __radd__ = __add__
+
+
+_shutdown_theme = _ShutdownTheme()
+
+
+def _safe_get_theme(*, force_color=False, force_no_color=False):
+ try:
+ return _colorize.get_theme(
+ force_color=force_color, force_no_color=force_no_color
+ )
+ except ImportError:
+ return _shutdown_theme
+
+
+def _safe_can_colorize(*, file=None):
+ try:
+ return _colorize.can_colorize(file=file)
+ except ImportError:
+ return False
+
+
 #
 # Formatting and printing lists of traceback lines.
 #
@@ -151,7 +181,7 @@ def print_exception(exc, /, value=_sentinel, tb=_sentinel, limit=None, \
 def _print_exception_bltin(exc, file=None, /):
  if file is None:
  file = sys.stderr if sys.stderr is not None else sys.__stderr__
- colorize = _colorize.can_colorize(file=file)
+ colorize = _safe_can_colorize(file=file)
  return print_exception(exc, limit=BUILTIN_EXCEPTION_LIMIT, file=file, colorize=colorize)
 
 
@@ -199,9 +229,9 @@ def _format_final_exc_line(etype, value, *, insert_final_newline=True, colorize=
  valuestr = _safe_string(value, 'exception')
  end_char = "\n" if insert_final_newline else ""
  if colorize:
- theme = _colorize.get_theme(force_color=True).traceback
+ theme = _safe_get_theme(force_color=True).traceback
  else:
- theme = _colorize.get_theme(force_no_color=True).traceback
+ theme = _safe_get_theme(force_no_color=True).traceback
  if value is None or not valuestr:
  line = f"{theme.type}{etype}{theme.reset}{end_char}"
  else:
@@ -555,9 +585,9 @@ def format_frame_summary(self, frame_summary, **kwargs):
  if frame_summary.filename.startswith("<stdin-") and frame_summary.filename.endswith('>'):
  filename = "<stdin>"
  if colorize:
- theme = _colorize.get_theme(force_color=True).traceback
+ theme = _safe_get_theme(force_color=True).traceback
  else:
- theme = _colorize.get_theme(force_no_color=True).traceback
+ theme = _safe_get_theme(force_no_color=True).traceback
  row.append(
  ' File {}"{}"{}, line {}{}{}, in {}{}{}\n'.format(
  theme.filename,
@@ -1344,9 +1374,9 @@ def format_exception_only(self, *, show_group=False, _depth=0, **kwargs):
  """
  colorize = kwargs.get("colorize", False)
  if colorize:
- theme = _colorize.get_theme(force_color=True).traceback
+ theme = _safe_get_theme(force_color=True).traceback
  else:
- theme = _colorize.get_theme(force_no_color=True).traceback
+ theme = _safe_get_theme(force_no_color=True).traceback
 
  indent = 3 * _depth * ' '
  if not self._have_exc_type:
@@ -1494,9 +1524,9 @@ def _format_syntax_error(self, stype, **kwargs):
  # Show exactly where the problem was found.
  colorize = kwargs.get("colorize", False)
  if colorize:
- theme = _colorize.get_theme(force_color=True).traceback
+ theme = _safe_get_theme(force_color=True).traceback
  else:
- theme = _colorize.get_theme(force_no_color=True).traceback
+ theme = _safe_get_theme(force_no_color=True).traceback
  filename_suffix = ''
  if self.lineno is not None:
  yield ' File {}"{}"{}, line {}{}{}\n'.format(

Lib/unittest/runner.py

@@ -4,11 +4,10 @@
 import time
 import warnings
 
-from _colorize import get_theme
-
 from . import result
 from .case import _SubTest
 from .signals import registerResult
+lazy from _colorize import get_theme
 
 __unittest = True
 

Misc/NEWS.d/next/Library/2026-05-03-17-32-24.gh-issue-144384.q-8jSr.rst

@@ -0,0 +1 @@
+Lazily import :mod:`!_colorize`. Patch by Hugo van Kemenade.