PyPy Python interpreter options
- Internal Options
General translation options
- Internal Options

PyPy Python interpreter options

The following options can be used after translate.py targetpypystandalone or as options to py.py.

--allworkingmodules: use as many working modules as possible
--nofaking: disallow faking in the object space
--objspace -o: Object Space name
--objspace-disable_call_speedhacks: make sure that all calls go through space.call_args
--objspace-honor__builtins__: Honor the __builtins__ key of a module dictionary
--objspace-lonepycfiles: Import pyc files with no matching py file
--objspace-opcodes-CALL_LIKELY_BUILTIN: emit a special bytecode for likely calls to builtin functions
--objspace-opcodes-CALL_METHOD: emit a special bytecode for expr.name()
--objspace-std-builtinshortcut: a shortcut for operations between built-in types
--objspace-std-getattributeshortcut: track types that override __getattribute__
--objspace-std-immutable_builtintypes: Forbid the changing of builtin types
--objspace-std-methodcachesizeexp: 2 ** methodcachesizeexp is the size of the of the method cache
--objspace-std-multimethods: the multimethod implementation to use
--objspace-std-newshortcut: cache and shortcut calling __new__ from builtin types
--objspace-std-optimized_comparison_op: special case the comparison of integers
--objspace-std-optimized_int_add: special case the addition of two integers in BINARY_ADD
--objspace-std-optimized_list_getitem: special case the 'list[integer]' expressions
--objspace-std-sharesmallstr: always reuse the prebuilt string objects (the empty string and potentially single-char strings)
--objspace-std-withcelldict: use dictionaries that are optimized for being used as module dicts
--objspace-std-withinlineddict: make instances more compact by revoming a level of indirection
--objspace-std-withmethodcache: try to cache method lookups
--objspace-std-withmethodcachecounter: try to cache methods and provide a counter in __pypy__. for testing purposes only.
--objspace-std-withprebuiltchar: use prebuilt single-character string objects
--objspace-std-withprebuiltint: prebuild commonly used int objects
--objspace-std-withrangelist: enable special range list implementation that does not actually create the full list until the resulting list is mutated
--objspace-std-withrope: use ropes as the string implementation
--objspace-std-withropeunicode: use ropes for the unicode implementation
--objspace-std-withshadowtracking: track whether an instance attribute shadows a type attribute
--objspace-std-withsharingdict: use dictionaries that share the keys part
--objspace-std-withsmallint: use tagged integers
--objspace-std-withstrjoin: use strings optimized for addition
--objspace-std-withstrslice: use strings optimized for slicing
--objspace-std-withtproxy: support transparent proxies
--objspace-timing: timing of various parts of the interpreter (simple profiling)
--objspace-usepycfiles: Write and read pyc files when importing
--prebuiltintfrom: lowest integer which is prebuilt
--prebuiltintto: highest integer which is prebuilt
--withmod-__builtin__: use module __builtin__
--withmod-__pypy__: use module __pypy__
--withmod-_ast: use module _ast
--withmod-_codecs: use module _codecs
--withmod-_collections: use module _collections
--withmod-_demo: use module _demo
--withmod-_locale: use module _locale
--withmod-_lsprof: use module _lsprof
--withmod-_minimal_curses: use module _minimal_curses
--withmod-_random: use module _random
--withmod-_rawffi: use module _rawffi
--withmod-_socket: use module _socket
--withmod-_sre: use module _sre
--withmod-_ssl: use module _ssl
--withmod-_stackless: use module _stackless
--withmod-_testing: use module _testing
--withmod-_weakref: use module _weakref
--withmod-_winreg: use module _winreg
--withmod-bz2: use module bz2
--withmod-cStringIO: use module cStringIO
--withmod-clr: use module clr
--withmod-crypt: use module crypt
--withmod-errno: use module errno
--withmod-exceptions: use module exceptions
--withmod-fcntl: use module fcntl
--withmod-gc: use module gc
--withmod-imp: use module imp
--withmod-itertools: use module itertools
--withmod-marshal: use module marshal
--withmod-math: use module math
--withmod-md5: use module md5
--withmod-micronumpy: use module micronumpy
--withmod-mmap: use module mmap
--withmod-operator: use module operator
--withmod-oracle: use module oracle
--withmod-parser: use module parser
--withmod-posix: use module posix
--withmod-pyexpat: use module pyexpat
--withmod-pypyjit: use module pypyjit
--withmod-rbench: use module rbench
--withmod-rctime: use module rctime
--withmod-readline: use module readline
--withmod-select: use module select
--withmod-sha: use module sha
--withmod-signal: use module signal
--withmod-struct: use module struct
--withmod-symbol: use module symbol
--withmod-sys: use module sys
--withmod-termios: use module termios
--withmod-thread: use module thread
--withmod-time: use module time
--withmod-token: use module token
--withmod-unicodedata: use module unicodedata
--withmod-zipimport: use module zipimport
--withmod-zlib: use module zlib

Internal Options

--objspace-logbytecodes: keep track of bytecode usage
--objspace-std-logspaceoptypes: a instrumentation option: before exit, print the types seen by certain simpler bytecodes
--objspace-std-withdictmeasurement: create huge files with masses of information about dictionaries
--withmod-_file: use module _file
--withmod-_pickle_support: use module _pickle_support

General translation options

The following are options of translate.py. They must be given before the targetxxx on the command line.

--opt -O: set the optimization level [0, 1, size, mem, 2, 3]

-b --backend: Backend to use for code generation
--cc: Specify compiler to use for compiling generated C
--cflags: Specify flags for the C compiler
--clever-malloc-removal: Drives inlining to remove mallocs in a clever way
--clever-malloc-removal-threshold: Threshold when to inline functions in clever malloc removal
-d --debug: Record extra annotation information
--dump_static_data_info: Dump static data info
--fork-before: (UNIX) Create restartable checkpoint before step
--gc: Garbage Collection Strategy
--gcremovetypeptr: Remove the typeptr from every object
--gcrootfinder: Strategy for finding GC Roots (framework GCs only)
--if-block-merge: Merge if ... elif chains
--inline-threshold: Threshold when to inline functions
--insist: Try hard to go on RTyping
--jit-backend: choose the backend for the JIT
--jit-debug: the amount of debugging dumps made by the JIT
--ldflags: Specify flags for the linker (C backend only)
--listcompr: When true, look for and special-case the sequence of operations that results from a list comprehension and attempt to pre-allocate the list
--log: Include debug prints in the translation (PYPYLOG=...)
--no-profopt: Don't use profile based optimization
--no__thread: don't use __thread for implementing TLS
--output: Output file name
--platform: target platform
--prof-based-inline: Use call count profiling to drive inlining, specify arguments
--prof-based-inline-threshold: Threshold when to inline functions for profile based inlining
--profopt: Specify profile based optimization script
--sandbox: Produce a fully-sandboxed executable
--stackless: enable stackless features during compilation
--thread: enable use of threading primitives
--translation-backendopt-constfold: Constant propagation
--translation-backendopt-inline: Do basic inlining and malloc removal
--translation-backendopt-mallocs: Remove mallocs
--translation-backendopt-none: Do not run any backend optimizations
--translation-backendopt-print_statistics: Print statistics while optimizing
--translation-backendopt-really_remove_asserts: Really remove operations that look like 'raise AssertionError', without relying on the C compiler
--translation-backendopt-remove_asserts: Remove operations that look like 'raise AssertionError', which lets the C optimizer remove the asserts
--translation-backendopt-stack_optimization: Tranform graphs in SSI form into graphs tailored for stack based virtual machines (only for backends that support it)
--translation-backendopt-storesink: Perform store sinking
--translation-cli-exception_transformer: Use exception transformer
--translation-jit: generate a JIT
--translation-jit_profiler: integrate profiler support into the JIT
--translation-ootype-mangle: Mangle names of class members
--translation-rweakref: The backend supports RPython-level weakrefs
--translation-taggedpointers: When true, enable the use of tagged pointers. If false, use normal boxing
--translation-verbose: Print extra information
--translation-withsmallfuncsets: Represent groups of less funtions than this as indices into an array
--vanilla: Try to be as portable as possible, which is not much

Internal Options

--clever-malloc-removal-heuristic: Dotted name of an heuristic function for inlining in clever malloc removal
--cli-trace-calls: Trace function calls
--inline-heuristic: Dotted name of an heuristic function for inlining
--prof-based-inline-heuristic: Dotted name of an heuristic function for profile based inlining
--raisingop2direct_call: Transform operations that can implicitly raise an exception into calls to functions that explicitly raise exceptions
--translation-simplifying: Simplify flow graphs