Remove unnecessary annotations from profiling stubs

Removed:

- tracing/__main__.pyi: deleted — __main__ stubs are executable entry
  points, not importable API surface
- tracing/_utils.pyi: deleted — _Utils is a private helper used only
  inside the tracing module itself
- sampling/__main__.pyi: deleted — PERMISSION_ERROR constants and
  handle_permission_error are CLI implementation details, not importable
  API
- sampling/binary_collector.pyi: removed COMPRESSION_NONE, COMPRESSION_ZSTD
  — internal constants not part of user-facing API
- sampling/cli.pyi: removed CustomFormatter, DiffFlamegraphAction,
  FORMAT_EXTENSIONS, COLLECTOR_MAP, and associated imports — internal CLI
  scaffolding and dispatch dicts used only inside cli.py; also removed
  re-exports of errors/collectors/sample that duplicate their own modules
- sampling/constants.pyi: removed MICROSECONDS_PER_SECOND (re-exported
  only internally), MILLISECONDS_PER_SECOND and _INTERNAL_FRAME_SUFFIXES
  (private implementation details)
- sampling/gecko_collector.pyi: removed GECKO_CATEGORIES, CATEGORY_*,
  DEFAULT_SUBCATEGORY, GECKO_FORMAT_VERSION, GECKO_PREPROCESSED_VERSION,
  RESOURCE_TYPE_LIBRARY, FRAME_ADDRESS_NONE, FRAME_INLINE_DEPTH_ROOT,
  PROCESS_TYPE_MAIN, STACKWALK_DISABLED — integer constants that encode
  the internal Gecko profile format; not part of user-facing API
- sampling/heatmap_collector.pyi: removed _TemplateLoader, _TreeBuilder,
  _HtmlRenderer — private classes (underscore-prefixed) used only
  internally for HTML rendering
- sampling/opcode_utils.pyi: removed base_opcode, variant_opcode — these
  are local variables inside get_opcode_info, not module-level attributes;
  the stubs were incorrect
- sampling/sample.pyi: removed MIN_SAMPLES_FOR_TUI — internal threshold
  constant for TUI display logic
- sampling/_sync_coordinator.pyi: removed CoordinatorError, ArgumentError,
  SyncError, TargetError — all exceptions live in a private module
  (_sync_coordinator) and are only raised and caught internally; never
  exposed through any public module

Kept despite `dead` flagging:

- tracing/__init__.pyi: dump_stats, snapshot_stats, runcall — public
  methods on the exported Profile class; standard profiling API
- sampling/binary_collector.pyi: get_stats, collect_failed_sample —
  public methods; collect_failed_sample is part of the Collector interface
  called in sample.py
- sampling/binary_reader.pyi: get_stats, convert_binary_to_format —
  public method and public utility function
- sampling/string_table.pyi: intern, get_string, get_strings — core API
  of StringTable
- sampling/live_collector/display.pyi: get_dimensions, refresh, redraw,
  get_input, set_nodelay, has_colors, init_color_pair, get_color_pair,
  get_attr, find_text — abstract methods on DisplayInterface define the
  ABC contract; concrete implementations on CursesDisplay and MockDisplay
  must also be stubbed
- sampling/live_collector/trend_tracker.pyi: set_enabled, get_trend —
  public methods on public class
- sampling/live_collector/widgets.pyi: format_rate_with_units,
  draw_thread_status, draw_finished_banner, draw_stats_rows,
  render_filter_input_prompt — public methods on public widget classes
- sampling/live_collector/collector.pyi: increment_status_flag,
  as_status_dict, collect_failed_sample — public methods on ThreadData
  dataclass and LiveStatsCollector

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: johnslavik

stdlib/profiling/sampling/__main__.pyi

@@ -1,8 +1,3 @@
 from typing import Never
 
-class CoordinatorError(Exception): ...
-class ArgumentError(CoordinatorError): ...
-class SyncError(CoordinatorError): ...
-class TargetError(CoordinatorError): ...
-
 def main() -> Never: ...

stdlib/profiling/sampling/_sync_coordinator.pyi

@@ -5,9 +5,6 @@ from typing_extensions import Self
 
 from .collector import Collector as Collector
 
-COMPRESSION_NONE: int
-COMPRESSION_ZSTD: int
-
 class BinaryCollector(Collector):
     filename: str
     sample_interval_usec: int

stdlib/profiling/sampling/binary_collector.pyi

@@ -1,12 +1,7 @@
-import argparse
-from collections.abc import Sequence
-from typing import Any
-
 from ._child_monitor import ChildProcessMonitor as ChildProcessMonitor
 from .binary_collector import BinaryCollector as BinaryCollector
 from .binary_reader import BinaryReader as BinaryReader
 from .constants import (
-    MICROSECONDS_PER_SECOND as MICROSECONDS_PER_SECOND,
     PROFILING_MODE_ALL as PROFILING_MODE_ALL,
     PROFILING_MODE_CPU as PROFILING_MODE_CPU,
     PROFILING_MODE_EXCEPTION as PROFILING_MODE_EXCEPTION,
@@ -19,34 +14,5 @@ from .constants import (
     SORT_MODE_SAMPLE_PCT as SORT_MODE_SAMPLE_PCT,
     SORT_MODE_TOTTIME as SORT_MODE_TOTTIME,
 )
-from .errors import (
-    SamplingModuleNotFoundError as SamplingModuleNotFoundError,
-    SamplingScriptNotFoundError as SamplingScriptNotFoundError,
-    SamplingUnknownProcessError as SamplingUnknownProcessError,
-)
-from .gecko_collector import GeckoCollector as GeckoCollector
-from .heatmap_collector import HeatmapCollector as HeatmapCollector
-from .live_collector import LiveStatsCollector as LiveStatsCollector
-from .pstats_collector import PstatsCollector as PstatsCollector
-from .sample import sample as sample, sample_live as sample_live
-from .stack_collector import (
-    CollapsedStackCollector as CollapsedStackCollector,
-    DiffFlamegraphCollector as DiffFlamegraphCollector,
-    FlamegraphCollector as FlamegraphCollector,
-)
-
-class CustomFormatter(argparse.ArgumentDefaultsHelpFormatter, argparse.RawDescriptionHelpFormatter): ...
-
-class DiffFlamegraphAction(argparse.Action):
-    def __call__(
-        self,
-        parser: argparse.ArgumentParser,
-        namespace: argparse.Namespace,
-        values: str | Sequence[Any] | None,
-        option_string: str | None = None,
-    ) -> None: ...
-
-FORMAT_EXTENSIONS: dict[str, str]
-COLLECTOR_MAP: dict[str, type[Any]]
 
 def main() -> None: ...

stdlib/profiling/sampling/cli.pyi

@@ -1,5 +1,3 @@
-MICROSECONDS_PER_SECOND: int
-MILLISECONDS_PER_SECOND: int
 PROFILING_MODE_WALL: int
 PROFILING_MODE_CPU: int
 PROFILING_MODE_GIL: int
@@ -12,7 +10,6 @@ SORT_MODE_SAMPLE_PCT: int
 SORT_MODE_CUMUL_PCT: int
 SORT_MODE_NSAMPLES_CUMUL: int
 DEFAULT_LOCATION: tuple[int, int, int, int]
-_INTERNAL_FRAME_SUFFIXES: tuple[str, ...]
 THREAD_STATUS_HAS_GIL: int
 THREAD_STATUS_ON_CPU: int
 THREAD_STATUS_UNKNOWN: int

stdlib/profiling/sampling/constants.pyi

@@ -3,25 +3,6 @@ from typing import Any
 from .collector import Collector as Collector, filter_internal_frames as filter_internal_frames
 from .opcode_utils import format_opcode as format_opcode, get_opcode_info as get_opcode_info
 
-GECKO_CATEGORIES: list[dict[str, Any]]
-CATEGORY_OTHER: int
-CATEGORY_PYTHON: int
-CATEGORY_NATIVE: int
-CATEGORY_GC: int
-CATEGORY_GIL: int
-CATEGORY_CPU: int
-CATEGORY_CODE_TYPE: int
-CATEGORY_OPCODES: int
-CATEGORY_EXCEPTION: int
-DEFAULT_SUBCATEGORY: int
-GECKO_FORMAT_VERSION: int
-GECKO_PREPROCESSED_VERSION: int
-RESOURCE_TYPE_LIBRARY: int
-FRAME_ADDRESS_NONE: int
-FRAME_INLINE_DEPTH_ROOT: int
-PROCESS_TYPE_MAIN: int
-STACKWALK_DISABLED: int
-
 class GeckoCollector(Collector):
     sample_interval_usec: int
     skip_idle: bool

stdlib/profiling/sampling/gecko_collector.pyi

@@ -31,26 +31,6 @@ class TreeNode:
 def get_python_path_info() -> dict[str, Any]: ...
 def extract_module_name(filename: str, path_info: dict[str, Any]) -> str: ...
 
-class _TemplateLoader:
-    index_template: str | None
-    file_template: str | None
-    index_css: str | None
-    index_js: str | None
-    file_css: str | None
-    file_js: str | None
-    logo_html: str | None
-    def __init__(self) -> None: ...
-
-class _TreeBuilder:
-    @staticmethod
-    def build_file_tree(file_stats: list[FileStats]) -> dict[str, TreeNode]: ...
-
-class _HtmlRenderer:
-    file_index: dict[str, str]
-    heatmap_bar_height: int
-    def __init__(self, file_index: dict[str, str]) -> None: ...
-    def render_hierarchical_html(self, trees: dict[str, TreeNode]) -> str: ...
-
 class HeatmapCollector(StackTraceCollector):
     FILE_INDEX_FORMAT: str
     line_samples: Counter[Any]

stdlib/profiling/sampling/heatmap_collector.pyi

@@ -1,6 +1,3 @@
-base_opcode: int | None
-variant_opcode: int | None
-
 def get_opcode_info(opcode_num: int) -> dict[str, str | bool]: ...
 def format_opcode(opcode_num: int) -> str: ...
 def get_opcode_mapping() -> dict[str, dict[int, str] | dict[int, int]]: ...

stdlib/profiling/sampling/opcode_utils.pyi

@@ -17,8 +17,6 @@ from .live_collector import LiveStatsCollector as LiveStatsCollector
 from .pstats_collector import PstatsCollector as PstatsCollector
 from .stack_collector import CollapsedStackCollector as CollapsedStackCollector, FlamegraphCollector as FlamegraphCollector
 
-MIN_SAMPLES_FOR_TUI: int
-
 class SampleProfiler:
     pid: int
     sample_interval_usec: int