NAME

       pypy - fast, compliant alternative implementation of the Python language

SYNOPSIS

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

OPTIONS

       -i     Inspect interactively after running script.

       -O     Skip assert statements.

       -OO    Remove docstrings when importing modules in addition to -O.

       -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.

       PyPy's  default  minimark  garbage  collector  is configurable through several environment
       variables:

       PYPY_GC_NURSERY
              The nursery size.  Defaults to 1/2 of your cache or 4M.  Small values  (like  1  or
              1KB) are useful for debugging.

       PYPY_GC_MAJOR_COLLECT
              Major  collection  memory  factor.   Default  is  1.82, which means trigger a major
              collection when the memory consumed equals 1.82 times the memory really used at the
              end of the previous major collection.

       PYPY_GC_GROWTH
              Major  collection  threshold's max growth rate.  Default is 1.4.  Useful to collect
              more often than normally on sudden memory growth, e.g. when there  is  a  temporary
              peak in memory usage.

       PYPY_GC_MAX
              The  max  heap  size.  If coming near this limit, it will first collect more often,
              then raise an RPython MemoryError, and if that is not  enough,  crash  the  program
              with a fatal error.  Try values like 1.6GB.

       PYPY_GC_MAX_DELTA
              The major collection threshold will never be set to more than PYPY_GC_MAX_DELTA the
              amount really used after a collection.  Defaults to 1/8th of  the  total  RAM  size
              (which  is  constrained  to be at most 2/3/4GB on 32-bit systems).  Try values like
              200MB.

       PYPY_GC_MIN
              Don't collect while the memory size is below this limit.  Useful to avoid  spending
              all the time in the GC in very small programs.  Defaults to 8 times the nursery.

       PYPY_GC_DEBUG
              Enable  extra  checks  around collections that are too slow for normal use.  Values
              are 0 (off), 1 (on major collections) or 2 (also on minor collections).

SEE ALSO

       python(1)

AUTHOR

       The PyPy Project

COPYRIGHT

       2013, The PyPy Project