]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
gh-102110: Add all tools description missed (GH-102625)
authorMissoupro <80458944+Missoupro@users.noreply.github.com>
Thu, 30 Mar 2023 20:49:07 +0000 (21:49 +0100)
committerGitHub <noreply@github.com>
Thu, 30 Mar 2023 20:49:07 +0000 (13:49 -0700)
Added missing descriptions of some tools.

Automerge-Triggered-By: GH:hugovk
Tools/README
Tools/scripts/README

index 04612b8013db92cae8c65c464344c9d0fdce8e97..e51624f453c5bbf8b0608831702f44c823954ae3 100644 (file)
@@ -1,10 +1,21 @@
 This directory contains a number of Python programs that are useful
 while building or extending Python.
 
+build           Automatically generated directory by the build system
+                contain build artifacts and intermediate files.
+
 buildbot        Batchfiles for running on Windows buildbot workers.
 
+c-analyzer      Tools to check no new global variables have been added.
+
+cases_generator Tooling to generate interpreters.
+
 ccbench         A Python threads-based concurrency benchmark. (*)
 
+clinic          A preprocessor for CPython C files in order to automate
+                the boilerplate involved with writing argument parsing
+                code for "builtins".
+
 freeze          Create a stand-alone executable from a Python program.
 
 gdb             Python code to be run inside gdb, to make it easier to
@@ -15,11 +26,16 @@ i18n            Tools for internationalization. pygettext.py
                 and msgfmt.py generates a binary message catalog
                 from a catalog in text format.
 
+importbench     A set of micro-benchmarks for various import scenarios.
+
 iobench         Benchmark for the new Python I/O system. (*)
 
 msi             Support for packaging Python as an MSI package on Windows.
 
-parser          Un-parsing tool to generate code from an AST.
+nuget           Files for the NuGet package manager for .NET.
+
+patchcheck      Tools for checking and applying patches to the Python source code
+                and verifying the integrity of patch files.
 
 peg_generator   PEG-based parser generator (pegen) used for new parser.
 
@@ -28,9 +44,14 @@ scripts         A number of useful single-file programs, e.g. tabnanny.py
                 tabs and spaces, and 2to3, which converts Python 2 code
                 to Python 3 code.
 
+ssl             Scripts to generate ssl_data.h from OpenSSL sources, and run
+                tests against multiple installations of OpenSSL and LibreSSL.
+
 stringbench     A suite of micro-benchmarks for various operations on
                 strings (both 8-bit and unicode). (*)
 
+tz              A script to dump timezone from /usr/share/zoneinfo.
+
 unicode         Tools for generating unicodedata and codecs from unicode.org
                 and other mapping files (by Fredrik Lundh, Marc-Andre Lemburg
                 and Martin von Loewis).
@@ -38,6 +59,8 @@ unicode         Tools for generating unicodedata and codecs from unicode.org
 unittestgui     A Tkinter based GUI test runner for unittest, with test
                 discovery.
 
+wasm            Config and helpers to facilitate cross compilation of CPython
+                to WebAssembly (WASM).
 
 (*) A generic benchmark suite is maintained separately at https://github.com/python/performance
 
index b952268159590192e39cbb6b03b2cb1dc0bb1694..9dbb89a8dae63372082a907c1fc79b8faebb3021 100644 (file)
@@ -2,9 +2,15 @@ This directory contains a collection of executable Python scripts that are
 useful while building, extending or managing Python.
 
 2to3                      Main script for running the 2to3 conversion tool
+checkpip.py               Checks the version of the projects bundled in ensurepip
+                          are the latest available
 combinerefs.py            A helper for analyzing PYTHONDUMPREFS output
+divmod_threshold.py       Determine threshold for switching from longobject.c
+                          divmod to _pylong.int_divmod()
 idle3                     Main program to start IDLE
-parse_html5_entities.py   Utility for parsing HTML5 entity definitions
 pydoc3                    Python documentation browser
 run_tests.py              Run the test suite with more sensible default options
-stable_abi.py             Stable ABI checks and file generators.
+summarize_stats.py        Summarize specialization stats for all files in the
+                          default stats folders
+var_access_benchmark.py   Show relative speeds of local, nonlocal, global,
+                          and built-in access