Mercurial > cpython-lru_cache-weakref

view Tools/scripts/README @ 73323:dad02a080bbc

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Improve byte-compilation in packaging to be independent of -O or -B. The code I fixed to comply with PEP 3147 still had one bug: When run under python -O, some paths for pyc files would be pyo, because I called imp.cache_from_source without explicit debug_override argument in some places, and under -O that would return .pyo (this is well explained in the imp docs). Now all code (util.byte_compile, build_py, install_lib) can create .pyo files according to options given by users, without interference from the calling Python’s own optimize mode. On a related topic, I also removed the code that prevented byte compilation under python -B. The rationale is that packaging gives control over the creation of pyc files to the user with its own explicit option, and the behavior should not be changed if the calling Python happens to run with -B for whatever reason. I will argue that this is a bug fix and ask to be allowed to backport this change to distutils. Finally, I moved one nugget of information about the --compile and --optimize options from the source into the doc. It clears up a misunderstanding that I (and maybe other people) had.
author Éric Araujo <merwok@netwok.org>
date Thu, 03 Nov 2011 05:08:28 +0100
parents 0b52b6f1bfab
children d02588a26057
line wrap: on
line source

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
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
find_recursionlimit.py  Find the maximum recursion limit on this machine
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
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
google.py               Open a webbrowser with Google
gprof2html.py           Transform gprof(1) output into useful HTML
h2py.py                 Translate #define's into Python assignments
idle3                   Main program to start IDLE
ifdef.py                Remove #if(n)def groups from C sources
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
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
redemo.py               Basic regular expression demonstration facility
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
svneol.py               Set svn:eol-style on all files in directory
texi2html.py            Convert GNU texinfo files into HTML
treesync.py             Synchronize source trees (very idiosyncratic)
untabify.py             Replace tabs with spaces in argument files
win_add2path.py         Add Python to the search path on Windows
which.py                Find a program in $PATH