pypy / pypy / doc / man / pypy.1.rst

pypy

SYNOPSIS

pypy [options] [-c cmd|-m mod|file.py|-] [arg...]

OPTIONS

-i Inspect interactively after running script.
-O Dummy optimization flag for compatibility with C Python.
-c cmd
Program passed in as CMD (terminates option list).
-S Do not import site on initialization.
-s Don't add the user site directory to sys.path.
-u Unbuffered binary stdout and stderr.
-h, --help Show a help message and exit.
-m mod
Library module to be run as a script (terminates option list).
-W arg
Warning control (arg is action:message:category:module:lineno).
-E Ignore environment variables (such as PYTHONPATH).
-B Disable writing bytecode (.pyc) files.
--version Print the PyPy version.
--info Print translation information about this PyPy executable.
--jit arg

Low level JIT parameters. Format is arg=value[,arg=value...]

off
Disable the JIT.
threshold=value
Number of times a loop has to run for it to become hot.
function_threshold=value
Number of times a function must run for it to become traced from start.
inlining=value
Inline python functions or not (1/0).
loop_longevity=value
A parameter controlling how long loops will be kept before being freed, an estimate.
max_retrace_guards=value
Number of extra guards a retrace can cause.
retrace_limit=value
How many times we can try retracing before giving up.
trace_eagerness=value
Number of times a guard has to fail before we start compiling a bridge.
trace_limit=value
Number of recorded operations before we abort tracing with ABORT_TRACE_TOO_LONG.
enable_opts=value
Optimizations to enabled or all. Warning, this option is dangerous, and should be avoided.

ENVIRONMENT

PYTHONPATH
Add directories to pypy's module search path. The format is the same as shell's PATH.
PYTHONSTARTUP
A script referenced by this variable will be executed before the first prompt is displayed, in interactive mode.
PYTHONDONTWRITEBYTECODE
If set to a non-empty value, equivalent to the -B option. Disable writing .pyc files.
PYTHONINSPECT
If set to a non-empty value, equivalent to the -i option. Inspect interactively after running the specified script.
PYTHONIOENCODING
If this is set, it overrides the encoding used for stdin/stdout/stderr. The syntax is encodingname:errorhandler The errorhandler part is optional and has the same meaning as in str.encode.
PYTHONNOUSERSITE
If set to a non-empty value, equivalent to the -s option. Don't add the user site directory to sys.path.
PYTHONWARNINGS
If set, equivalent to the -W option (warning control). The value should be a comma-separated list of -W parameters.
PYPYLOG

If set to a non-empty value, enable logging, the format is:

fname
logging for profiling: includes all debug_start/debug_stop but not any nested debug_print. fname can be - to log to stderr.
:fname
Full logging, including debug_print.
prefix:fname
Conditional logging. Multiple prefixes can be specified, comma-separated. Only sections whose name match the prefix will be logged.

PYPYLOG=jit-log-opt,jit-backend:logfile will generate a log suitable for jitviewer, a tool for debugging performance issues under PyPy.

SEE ALSO

python(1)

Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.