fixup! gh-138122: Refactor the CLI of profile.sampling into subcommands

Author: pablogsal

Lib/profiling/sampling/sample.py

@@ -13,6 +13,8 @@
 from .gecko_collector import GeckoCollector
 from .constants import (
     PROFILING_MODE_WALL,
+    PROFILING_MODE_CPU,
+    PROFILING_MODE_GIL,
     PROFILING_MODE_ALL,
 )
 try:

Lib/test/test_profiling/test_sampling_profiler/test_modes.py

@@ -444,10 +444,11 @@ def test_mode_constants_are_defined(self):
 
     def test_parse_mode_function(self):
         """Test the _parse_mode function with all valid modes."""
-        self.assertEqual(profiling.sampling.sample._parse_mode("wall"), 0)
-        self.assertEqual(profiling.sampling.sample._parse_mode("cpu"), 1)
-        self.assertEqual(profiling.sampling.sample._parse_mode("gil"), 2)
+        from profiling.sampling.cli import _parse_mode
+        self.assertEqual(_parse_mode("wall"), 0)
+        self.assertEqual(_parse_mode("cpu"), 1)
+        self.assertEqual(_parse_mode("gil"), 2)
 
         # Test invalid mode raises KeyError
         with self.assertRaises(KeyError):
-            profiling.sampling.sample._parse_mode("invalid")
+            _parse_mode("invalid")

Misc/NEWS.d/3.15.0a2.rst

@@ -388,7 +388,7 @@ Add :func:`os.reload_environ` to ``os.__all__``.
 .. nonce: L13UCV
 .. section: Library
 
-Fix :func:`profiling.sampling.sample` incorrectly handling a
+Fix ``profiling.sampling.sample()`` incorrectly handling a
 :exc:`FileNotFoundError` or :exc:`PermissionError`.
 
 ..

Misc/NEWS.d/next/Library/2025-11-17-00-53-51.gh-issue-141645.TC3TL3.rst

@@ -1,4 +1,4 @@
 Add a new ``--live`` mode to the tachyon profiler in
-:mod:`profiling.sampling` module. This mode consist of a live TUI that
+:mod:`!profiling.sampling` module. This mode consist of a live TUI that
 displays real-time profiling statistics as the target application runs,
 similar to ``top``. Patch by Pablo Galindo