Add Python 3.15 profiling stubs

Author: JelleZijlstra

stdlib/@tests/stubtest_allowlists/py315.txt

@@ -178,8 +178,6 @@ posixpath.splitroot
 pprint.PrettyPrinter.__init__
 pprint.pformat
 pprint.pprint
-profiling
-profiling.sampling
 profiling.sampling.binary_collector
 profiling.sampling.binary_reader
 profiling.sampling.cli
@@ -196,7 +194,6 @@ profiling.sampling.pstats_collector
 profiling.sampling.sample
 profiling.sampling.stack_collector
 profiling.sampling.string_table
-profiling.tracing
 pydoc.Doc.STDLIB_DIR
 pydoc.Doc.getdocloc
 site.addsitedir

stdlib/VERSIONS

@@ -242,6 +242,9 @@ posix: 3.0-
 posixpath: 3.0-
 pprint: 3.0-
 profile: 3.0-
+profiling: 3.15-
+profiling.sampling: 3.15-
+profiling.tracing: 3.15-
 pstats: 3.0-
 pty: 3.0-
 pwd: 3.0-

stdlib/profiling/__init__.pyi

@@ -0,0 +1,3 @@
+from . import sampling as sampling, tracing as tracing
+
+__all__ = ["sampling", "tracing"]

stdlib/profiling/sampling.pyi

@@ -0,0 +1,53 @@
+from _typeshed import StrOrBytesPath
+from abc import ABC
+
+__all__ = [
+    "Collector",
+    "PstatsCollector",
+    "CollapsedStackCollector",
+    "HeatmapCollector",
+    "GeckoCollector",
+    "JsonlCollector",
+    "StringTable",
+]
+
+class Collector(ABC):
+    def collect(self, stack_frames, timestamps_us=None) -> None: ...
+    def collect_failed_sample(self) -> None: ...
+    def export(self, filename: StrOrBytesPath) -> None: ...
+
+class PstatsCollector(Collector):
+    def __init__(self, sample_interval_usec: int, *, skip_idle: bool = False) -> None: ...
+    def create_stats(self) -> None: ...
+    def print_stats(self, sort=-1, limit: int | None = None, show_summary: bool = True, mode=None) -> None: ...
+
+class CollapsedStackCollector(Collector):
+    def __init__(self, *args, **kwargs) -> None: ...
+    def process_frames(self, frames, thread_id: int, weight: int = 1) -> None: ...
+
+class HeatmapCollector(Collector):
+    FILE_INDEX_FORMAT: str
+    def __init__(self, *args, **kwargs) -> None: ...
+    def process_frames(self, frames, thread_id: int, weight: int = 1) -> None: ...
+    def set_stats(
+        self,
+        sample_interval_usec: int,
+        duration_sec: float,
+        sample_rate: float,
+        error_rate: float | None = None,
+        missed_samples: int | None = None,
+        **kwargs,
+    ) -> None: ...
+
+class GeckoCollector(Collector):
+    def __init__(self, sample_interval_usec: int, *, skip_idle: bool = False, opcodes: bool = False) -> None: ...
+
+class JsonlCollector(Collector):
+    def __init__(self, sample_interval_usec: int, *, skip_idle: bool = False, mode=None) -> None: ...
+    def process_frames(self, frames, _thread_id: int, weight: int = 1) -> None: ...
+
+class StringTable:
+    def intern(self, string: object) -> int: ...
+    def get_string(self, index: int) -> str: ...
+    def get_strings(self) -> list[str]: ...
+    def __len__(self) -> int: ...

stdlib/profiling/tracing.pyi

@@ -0,0 +1,9 @@
+from cProfile import Profile as Profile, run as run, runctx as runctx
+from types import CodeType
+from typing import TypeAlias
+
+__all__ = ["run", "runctx", "Profile"]
+
+_Label: TypeAlias = tuple[str, int, str]
+
+def label(code: str | CodeType) -> _Label: ...  # undocumented