Pablo Galindo Salgado 4279785b31 gh-140727: Restructure profiling documentation for PEP 799 (#142373) ... * Add profiling module documentation structure PEP 799 introduces a new `profiling` package that reorganizes Python's profiling tools under a unified namespace. This commit adds the documentation structure to match: a main entry point (profiling.rst) that helps users choose between profilers, detailed docs for the tracing profiler (profiling-tracing.rst), and separated pstats documentation. The tracing profiler docs note that cProfile remains as a backward-compatible alias, so existing code continues to work. The pstats module gets its own page since it's used by both profiler types and deserves focused documentation. * Add profiling.sampling documentation The sampling profiler is new in Python 3.15 and works fundamentally differently from the tracing profiler. It observes programs from outside by periodically capturing stack snapshots, which means zero overhead on the profiled code. This makes it practical for production use where you can attach to live servers. The docs explain the key concepts (statistical vs deterministic profiling), provide quick examples upfront, document all output formats (pstats, flamegraph, gecko, heatmap), and cover the live TUI mode. The defaults table helps users understand what happens without any flags. * Wire profiling docs into the documentation tree Add the new profiling module pages to the Debugging and Profiling toctree. The order places the main profiling.rst entry point first, followed by the two profiler implementations, then pstats, and finally the deprecated profile module last. * Convert profile.rst to deprecation stub The pure Python profile module is deprecated in 3.15 and scheduled for removal in 3.17. Users should migrate to profiling.tracing (or use the cProfile alias which continues to work). The page now focuses on helping existing users migrate: it shows the old vs new import style, keeps the shared API reference since both modules have the same interface, and preserves the calibration docs for anyone still using the pure Python implementation during the transition period. * Update CLI module references for profiling restructure Point cProfile to profiling.tracing docs and add profiling.sampling to the list of modules with CLI interfaces. The old profile-cli label no longer exists after the documentation restructure. * Update whatsnew to link to profiling module docs Enable cross-references to the new profiling module documentation and update the CLI examples to use the current syntax with the attach subcommand. Also reference profiling.tracing instead of cProfile since that's the new canonical name.		2025-12-09 12:55:04 +00:00
..
__phello__
_pyrepl	Drop three unused imports (#141875)	2025-11-23 16:33:05 +00:00
asyncio	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
collections	gh-140911: Ensure that UserString.index() and UserString.rindex() accept UserString as argument (GH-140945)	2025-11-25 15:25:46 +02:00
compression
concurrent	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
ctypes	gh-140041: Fix import of ctypes on Android and Cygwin when ABI flags are present (#140178)	2025-10-16 05:40:39 +08:00
curses
dbm	gh-135386: Fix "unable to open database file" errors on readonly DB (GH-135566)	2025-08-22 14:11:59 +03:00
email	gh-68552: fix defects policy (#138579)	2025-12-06 16:54:29 -05:00
encodings	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
ensurepip	gh-140874: Upgrade bundled pip to 25.3 (GH-140876)	2025-11-01 10:25:19 +00:00
html	gh-140875: Fix handling of unclosed charrefs before EOF in HTMLParser (GH-140904)	2025-11-19 13:55:10 +02:00
http	gh-119451: Fix a potential denial of service in http.client (GH-119454)	2025-12-01 17:26:07 +02:00
idlelib	GH-139436: Remove PDF and CHM from IDLE HelpSource (#140418)	2025-12-09 12:32:53 +00:00
importlib	gh-141930: Use the regular IO stack to write .pyc files for a better error message on failure (GH-141931)	2025-11-27 19:17:59 +00:00
json	GH-141686: Break cycles created by JSONEncoder.iterencode (GH-141687)	2025-11-18 09:51:18 -08:00
logging	gh-138162: Fix logging.LoggerAdapter with merge_extra=True and without the extra argument (GH-140511)	2025-10-30 12:52:02 +02:00
multiprocessing	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
pathlib	GH-139174: Prepare pathlib.Path.info for new methods (part 2) (#140155)	2025-10-18 02:13:25 +01:00
profiling	gh-140727: Restructure profiling documentation for PEP 799 (#142373)	2025-12-09 12:55:04 +00:00
pydoc_data	Python 3.15.0a2	2025-11-18 16:51:17 +02:00
re	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
site-packages
sqlite3	gh-133390: sqlite3 CLI completion for tables, columns, indices, triggers, views, functions, schemata (GH-136101)	2025-10-24 08:26:36 +02:00
string
sysconfig	Replace obsolete platforms with more recent examples (#132455)	2025-10-10 05:38:13 +00:00
test	gh-142282 Fix winreg.QueryValueEx() under race condition (GH-142283)	2025-12-09 12:09:07 +00:00
tkinter	gh-130693: Support more options for search in tkinter.Text (GH-130848)	2025-11-17 14:42:26 +00:00
tomllib
turtledemo
unittest	gh-136442: Fix unittest to return exit code 5 when setUpClass raises an exception (#136487)	2025-11-14 16:59:51 -08:00
urllib	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
venv	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
wsgiref
xml	gh-142145: Remove quadratic behavior in node ID cache clearing (GH-142146)	2025-12-02 23:16:37 -08:00
xmlrpc
zipfile	gh-139700: Check consistency of the zip64 end of central directory record (GH-139702)	2025-10-07 20:15:26 +03:00
zoneinfo	gh-137976: Explicitly exclude localtime from available_timezones (#138012)	2025-09-18 17:32:14 +01:00
__future__.py
__hello__.py
_aix_support.py
_android_support.py	Make Android streams respect the unbuffered (-u) option (#138806)	2025-09-18 11:41:21 +01:00
_apple_support.py
_ast_unparse.py	gh-138774: use value to ast.unparse code when str is None in ast.Interpolation (#139415)	2025-10-23 13:56:05 +00:00
_collections_abc.py	gh-118803: Make ByteString deprecations louder; remove ByteString from typing.__all__ and collections.abc.__all__ (#139127)	2025-09-18 18:58:16 +00:00
_colorize.py	gh-141679: Add colour to defaults in argparse help (#141680)	2025-11-23 00:26:50 +00:00
_compat_pickle.py
_ios_support.py
_markupbase.py
_opcode_metadata.py	GH-139109: Support switch/case dispatch with the tracing interpreter. (GH-141703)	2025-11-18 13:31:48 +00:00
_osx_support.py
_py_abc.py
_py_warnings.py	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
_pydatetime.py	gh-97517: Add documentation links to datetime strftime/strptime docstrings (#138559)	2025-09-15 19:50:46 +01:00
_pydecimal.py	gh-76007: Deprecate __version__ attribute in decimal (#140302)	2025-10-26 12:01:04 +01:00
_pyio.py	gh-129005: Remove copies from _pyio using take_bytes (#141539)	2025-11-18 10:10:32 +01:00
_pylong.py
_sitebuiltins.py
_strptime.py	gh-81148: Eliminate unnecessary check in _strptime when determining AM/PM (#13428)	2025-09-19 10:23:12 +00:00
_threading_local.py	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
_weakrefset.py
abc.py
annotationlib.py	gh-141489: Simplify closure/freevar iteration in annotationlib._build_closure() (#141490)	2025-11-19 18:08:08 -10:00
antigravity.py
argparse.py	gh-139946: distinguish stdout or stderr when colorizing output in argparse (#140495)	2025-12-08 04:08:06 +00:00
ast.py	gh-135801: Add the module parameter to compile() etc (GH-139652)	2025-11-13 13:21:32 +02:00
base64.py	gh-141968: Use bytearray.take_bytes in base64 _b32encode and _b32decode (#141971)	2025-11-26 21:14:25 +05:30
bdb.py	gh-136057: Allow step and next to step over for loops (#136160)	2025-11-16 13:57:07 -08:00
bisect.py
bz2.py
calendar.py	gh-140212: Add html for year-month option in Calendar (#140230)	2025-10-31 17:28:53 +02:00
cmd.py
code.py
codecs.py
codeop.py	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
colorsys.py
compileall.py	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
configparser.py
contextlib.py
contextvars.py
copy.py	gh-132657: improve deepcopy and copy scaling on free-threading (#138429)	2025-09-04 13:20:23 +05:30
copyreg.py
cProfile.py	Remove unused imports (#142320)	2025-12-06 11:27:31 +00:00
csv.py	gh-137627: Make csv.Sniffer.sniff() delimiter detection 1.6x faster (#137628)	2025-10-23 15:28:29 +03:00
dataclasses.py	gh-142214: Fix two regressions in dataclasses (#142223)	2025-12-04 20:04:42 -08:00
datetime.py
decimal.py	gh-76007: Deprecate __version__ attribute in decimal (#140302)	2025-10-26 12:01:04 +01:00
difflib.py	gh-95953: Add a css class to changed lines of difflib.HtmlDiff make_table (#139226)	2025-09-22 13:19:37 +00:00
dis.py	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
doctest.py	gh-69113: Fix doctest to report line numbers for __test__ strings (#141624)	2025-12-06 15:47:08 -05:00
enum.py	gh-140766: [Enum] add show_flag_values and bin to enum.__all__ (GH-140765)	2025-10-30 10:32:55 -07:00
filecmp.py
fileinput.py
fnmatch.py
fractions.py
ftplib.py	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
functools.py	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
genericpath.py
getopt.py
getpass.py	gh-138514: getpass: restrict echo_char to a single ASCII character (#138591)	2025-09-16 16:21:55 +02:00
gettext.py
glob.py	docs: be clearer that glob results are unordered (#140184)	2025-10-19 16:16:35 -04:00
graphlib.py
gzip.py	Remove some dead code from gzip and tarfile (#138123)	2025-08-25 16:23:47 +03:00
hashlib.py	gh-136565: use SHA-256 for hashlib.__doc__ example instead of MD5 (#138157)	2025-08-26 10:38:53 +00:00
heapq.py	Remove unnecessary slice in heapq.py (gh-139087)	2025-09-18 00:52:46 -05:00
hmac.py
imaplib.py	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
inspect.py	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
io.py
ipaddress.py	gh-141497: Make ipaddress.IP{v4,v6}Network.hosts() always returning an iterator (GH-141547)	2025-11-17 19:29:06 +02:00
keyword.py
linecache.py	gh-122255: Synchronize warnings in C and Python implementations of the warnings module (GH-122824)	2025-11-14 16:49:28 +02:00
locale.py	gh-137729: Fix support for locales with @-modifiers (GH-137253)	2025-08-18 10:11:15 +03:00
lzma.py
mailbox.py	gh-140808: Remove __class_getitem__ from mailbox._ProxyFile (#140838)	2025-11-02 13:56:59 -08:00
mimetypes.py	gh-141018: Update .exe, .dll, .rtf and .jpg mime types in mimetypes (#141023)	2025-11-17 13:32:00 +02:00
modulefinder.py	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
netrc.py	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
ntpath.py	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
nturl2path.py
numbers.py
opcode.py
operator.py
optparse.py	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
os.py	gh-120057: add os.reload_environ to __all__ (#140763)	2025-10-29 21:21:26 +00:00
pdb.py	gh-141982: Fix pdb can't set breakpoints on async functions (#141983)	2025-12-01 23:40:02 -08:00
pickle.py	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
pickletools.py	gh-131178: Add tests for pickletools command-line interface (#131287)	2025-11-22 19:17:06 +02:00
pkgutil.py
platform.py	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
plistlib.py	gh-119342: Fix a potential denial of service in plistlib (GH-119343)	2025-12-01 17:28:15 +02:00
poplib.py
posixpath.py	gh-136065: Fix quadratic complexity in os.path.expandvars() (GH-134952)	2025-10-31 14:49:51 +01:00
pprint.py
profile.py	gh-138122: Implement PEP 799 (#138142)	2025-08-27 17:52:50 +01:00
pstats.py	gh-140137: Handle empty collections in profiling.sampling (#140154)	2025-10-15 14:59:12 +01:00
pty.py
py_compile.py
pyclbr.py	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
pydoc.py	gh-132686: Add parameters inherit_class_doc and fallback_to_class_doc for inspect.getdoc() (GH-132691)	2025-11-12 00:01:25 +02:00
queue.py
quopri.py
random.py
reprlib.py
rlcompleter.py
runpy.py	gh-135801: Add the module parameter to compile() etc (GH-139652)	2025-11-13 13:21:32 +02:00
sched.py
secrets.py
selectors.py
shelve.py	Drop three unused imports (#141875)	2025-11-23 16:33:05 +00:00
shlex.py	gh-138804: Check type in shlex.quote (GH-138809)	2025-09-12 14:26:21 -04:00
shutil.py
signal.py
site.py	gh-138993: Dedent credits text (#138994)	2025-10-14 11:15:17 +03:00
smtplib.py	gh-139434: Update selected RFC 2822 references to RFC 5322 (#139435)	2025-11-04 14:46:07 -05:00
socket.py
socketserver.py	gh-76007: Deprecate __version__ attribute (#138675)	2025-09-29 12:03:23 +03:00
ssl.py	Docs: fix RFC index reference for TLS 1.3 (#142262)	2025-12-06 14:05:20 +01:00
stat.py	gh-83714: Implement os.statx() function (#139178)	2025-10-15 13:44:08 +00:00
statistics.py	gh-140938: Raise ValueError for infinite inputs to stdev/pstdev (GH-141531)	2025-11-14 23:25:45 +00:00
stringprep.py
struct.py
subprocess.py	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
symtable.py	gh-135801: Add the module parameter to compile() etc (GH-139652)	2025-11-13 13:21:32 +02:00
tabnanny.py	gh-76007: Deprecate __version__ attribute (#138675)	2025-09-29 12:03:23 +03:00
tarfile.py	gh-57911: Sanitize symlink targets in tarfile on win32 (GH-138309)	2025-09-05 16:19:47 +02:00
tempfile.py	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
textwrap.py	gh-139065: Fix trailing space before long word in textwrap (GH-139070)	2025-10-10 16:29:18 +03:00
this.py
threading.py	gh-114827: clarify threading.Event.wait timeout behavior (#114834)	2025-10-14 11:34:53 +03:00
timeit.py	gh-139374: colorize traceback when using timeit command-line interface (#139375)	2025-09-28 11:49:18 +00:00
token.py
tokenize.py	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
trace.py
traceback.py	gh-142236: Fix incorrect keyword suggestions for syntax errors (#142328)	2025-12-06 21:09:35 +00:00
tracemalloc.py
tty.py
turtle.py	Fix pyflakes warnings: variable is assigned to but never used (#142294)	2025-12-08 14:00:31 +01:00
types.py
typing.py	gh-133601: Remove deprecated typing.no_type_check_decorator (#133602)	2025-10-20 21:10:44 +00:00
uuid.py	gh-76760: test that uuid.uuid1() sets the version field (#139033)	2025-09-17 13:31:51 +00:00
warnings.py
wave.py	gh-141968: use bytearray.take_bytes in wave._byteswap (#141973)	2025-11-26 21:15:12 +05:30
weakref.py
webbrowser.py
zipapp.py
zipimport.py	gh-135801: Add the module parameter to compile() etc (GH-139652)	2025-11-13 13:21:32 +02:00