cpython/Tools/scripts/README

This directory contains a collection of executable Python scripts that are
useful while building, extending or managing Python.  Some (e.g., dutree or lll)
are also generally useful UNIX tools.

2to3                      Main script for running the 2to3 conversion tool
abitype.py                Converts a C file to use the PEP 384 type definition API
analyze_dxp.py            Analyzes the result of sys.getdxp()
byext.py                  Print lines/words/chars stats of files by extension
byteyears.py              Print product of a file's size and age
checkpyc.py               Check presence and validity of ".pyc" files
cleanfuture.py            Fix redundant Python __future__ statements
combinerefs.py            A helper for analyzing PYTHONDUMPREFS output
copytime.py               Copy one file's atime and mtime to another
crlf.py                   Change CRLF line endings to LF (Windows to Unix)
db2pickle.py              Dump a database file to a pickle
diff.py                   Print file diffs in context, unified, or ndiff formats
dutree.py                 Format du(1) output as a tree sorted by size
eptags.py                 Create Emacs TAGS file for Python modules
finddiv.py                A grep-like tool that looks for division operators
findlinksto.py            Recursively find symbolic links to a given path prefix
findnocoding.py           Find source files which need an encoding declaration
find_recursionlimit.py    Find the maximum recursion limit on this machine
find-uname.py             Look for the given arguments in the sets of all Unicode names
fixcid.py                 Massive identifier substitution on C source files
fixdiv.py                 Tool to fix division operators.
fixheader.py              Add some cpp magic to a C include file
fixnotice.py              Fix the copyright notice in source files
fixps.py                  Fix Python scripts' first line (if #!)
ftpmirror.py              FTP mirror script
get-remote-certificate.py Fetch the certificate that the server(s) are providing in PEM form
google.py                 Open a webbrowser with Google
gprof2html.py             Transform gprof(1) output into useful HTML
highlight.py              Python syntax highlighting with HTML output
idle3                     Main program to start IDLE
ifdef.py                  Remove #if(n)def groups from C sources
import_diagnostics.py     Miscellaneous diagnostics for the import system
lfcr.py                   Change LF line endings to CRLF (Unix to Windows)
linktree.py               Make a copy of a tree with links to original files
lll.py                    Find and list symbolic links in current directory
mailerdaemon.py           Parse error messages from mailer daemons (Sjoerd&Jack)
make_ctype.py             Generate ctype.h replacement in stringobject.c
md5sum.py                 Print MD5 checksums of argument files
mkreal.py                 Turn a symbolic link into a real file or directory
ndiff.py                  Intelligent diff between text files (Tim Peters)
nm2def.py                 Create a template for PC/python_nt.def (Marc Lemburg)
objgraph.py               Print object graph from nm output on a library
parseentities.py          Utility for parsing HTML entity definitions
parse_html5_entities.py   Utility for parsing HTML5 entity definitions
patchcheck.py             Perform common checks and cleanup before committing
pathfix.py                Change #!/usr/local/bin/python into something else
pdeps.py                  Print dependencies between Python modules
pickle2db.py              Load a pickle generated by db2pickle.py to a database
pindent.py                Indent Python code, giving block-closing comments
ptags.py                  Create vi tags file for Python modules
pydoc3                    Python documentation browser
pysource.py               Find Python source files
reindent.py               Change .py files to use 4-space indents
reindent-rst.py           Fix-up reStructuredText file whitespace
rgrep.py                  Reverse grep through a file (useful for big logfiles)
run_tests.py              Run the test suite with more sensible default options
serve.py                  Small wsgiref-based web server, used in make serve in Doc
suff.py                   Sort a list of files by suffix
texi2html.py              Convert GNU texinfo files into HTML
untabify.py               Replace tabs with spaces in argument files
which.py                  Find a program in $PATH
win_add2path.py           Add Python to the search path on Windows