PyPy’s Python interpreter is a very compliant Python
interpreter implemented in RPython. When compiled, it passes most of
CPythons core language regression tests and comes with many of the extension
modules included in the standard library including
ctypes. It can run large
libraries such as Django and Twisted. There are some small behavioral
differences with CPython and some missing extensions, for details see CPython
To actually use PyPy’s Python interpreter, the first thing to do is to download a pre-built PyPy for your architecture.
(Note: for some hints on how to translate the Python interpreter under Windows, see the windows document)
You can translate the whole of PyPy’s Python interpreter to low level C code. If you intend to build using gcc, check to make sure that the version you have is not 4.2 or you will run into this bug.
First download a pre-built PyPy for your architecture which you will use to translate your Python interpreter. It is, of course, possible to translate with a CPython 2.6 or later, but this is not the preferred way, because it will take a lot longer to run – depending on your architecture, between two and three times as long.
Install build-time dependencies. On a Debian box these are:
[user@debian-box ~]$ sudo apt-get install \ gcc make python-dev libffi-dev libsqlite3-dev pkg-config \ libz-dev libbz2-dev libncurses-dev libexpat1-dev \ libssl-dev libgc-dev python-sphinx python-greenlet
For the optional lzma module on PyPy3 you will also need
On a Fedora-16 box these are:
[user@fedora-or-rh-box ~]$ sudo yum install \ gcc make python-devel libffi-devel lib-sqlite3-devel pkgconfig \ zlib-devel bzip2-devel ncurses-devel expat-devel \ openssl-devel gc-devel python-sphinx python-greenlet
For the optional lzma module on PyPy3 you will also need
$ sudo zypper install gcc make python-devel pkg-config zlib-devel libopenssl-devel libbz2-devel sqlite3-devel libexpat-devel libffi-devel python-curses
On Mac OS X, most of these build-time dependencies are installed alongside the Developer Tools. However, note that in order for the installation to find them you may need to run:
$ xcode-select –install
The above command lines are split with continuation characters, giving the necessary dependencies first, then the optional ones.
pkg-config(to help us locate libffi files)
libz-dev(for the optional
libbz2-dev(for the optional
liblzma(for the optional
lzmamodule, PyPy3 only)
libsqlite3-dev(for the optional
sqlite3module via cffi)
libncurses-dev(for the optional
libexpat1-dev(for the optional
libssl-dev(for the optional
libgc-dev(for the Boehm garbage collector: only needed when translating with –opt=0, 1 or size)
python-sphinx(for the optional documentation build. You need version 1.0.7 or later)
Translation is time-consuming – 45 minutes on a very fast machine – and RAM-hungry. As of March 2011, you will need at least 2 GB of memory on a 32-bit machine and 4GB on a 64-bit machine. If your memory resources are constrained, or your machine is slow you might want to pick the optimization level 1 in the next step. A level of 2 or 3 or jit gives much better results, though. But if all you want to do is to test that some new feature that you just wrote translates, level 1 is enough.
Let me stress this again: at
--opt=1you get the Boehm GC, which is here mostly for historical and for testing reasons. You really do not want to pick it for a program you intend to use. The resulting
cd pypy/goal python ../../rpython/bin/rpython --opt=jit targetpypystandalone.py
--opt=jitwith another optimization level of your choice. Typical example:
--opt=2gives a good (but of course slower) Python interpreter without the JIT.
Consider using PyPy instead of CPython in the above command line, as it is much faster. (Note that
rpythonis a Python 2 program, not Python 3; you need to run either PyPy 2 or CPython 2.)
If everything works correctly this will create an executable
pypy-c in the current directory. Type
to see the options it supports - mainly the same basic
options as CPython. In addition,
pypy-c --info prints the
translation options that where used to produce this particular
executable. The executable behaves mostly like a normal Python interpreter:
$ ./pypy-c Python 2.7.3 (480845e6b1dd, Jul 31 2013, 11:05:31) [PyPy 2.1.0 with GCC 4.7.1] on linux2 Type "help", "copyright", "credits" or "license" for more information. And now for something completely different: ``RPython magically makes you rich and famous (says so on the tin)'' >>>> 46 - 4 42 >>>> from test import pystone >>>> pystone.main() Pystone(1.1) time for 50000 passes = 0.220015 This machine benchmarks at 227257 pystones/second >>>> pystone.main() Pystone(1.1) time for 50000 passes = 0.060004 This machine benchmarks at 833278 pystones/second >>>>
Note that pystone gets faster as the JIT kicks in. This executable can be moved around or copied on other machines; see Installation below.
translate.py script takes a very large number of options controlling
what to translate and how. See
translate.py -h. The default options
should be suitable for mostly everybody by now.
Find a more detailed description of the various options in our configuration
It is possible to have non-standard features enabled for translation, but they are not really tested any more. Look, for example, at the objspace proxies document.
pypy-c can be installed in a standard location like
/usr/local/bin, although some details of this process are still in
flux. It can also be copied to other machines as long as their system
is “similar enough”: some details of the system on which the translation
occurred might be hard-coded in the executable.
PyPy dynamically finds the location of its libraries depending on the location of the executable. The directory hierarchy of a typical PyPy installation looks like this:
./bin/pypy ./include/ ./lib_pypy/ ./lib-python/2.7 ./site-packages/
The hierarchy shown above is relative to a PREFIX directory. PREFIX is
computed by starting from the directory where the executable resides, and
“walking up” the filesystem until we find a directory containing
The archives (.tar.bz2 or .zip) containing PyPy releases already contain the
correct hierarchy, so to run PyPy it’s enough to unpack the archive, and run
To install PyPy system wide on unix-like systems, it is recommended to put the
whole hierarchy alone (e.g. in
/opt/pypy2.1) and put a symlink to the
pypy executable into
If the executable fails to find suitable libraries, it will report
debug: WARNING: library path not found, using compiled-in sys.path
and then attempt to continue normally. If the default path is usable,
most code will be fine. However, the
sys.prefix will be unset
and some existing libraries assume that this is never the case.
To start interpreting Python with PyPy, install a C compiler that is supported by distutils and use Python 2.5 or greater to run PyPy:
cd pypy python bin/pyinteractive.py
After a few seconds (remember: this is running on top of CPython), you should be at the PyPy prompt, which is the same as the Python prompt, but with an extra “>”.
Now you are ready to start running Python code. Most Python modules should work if they don’t involve CPython extension modules. This is slow, and most C modules are not present by default even if they are standard! Here is an example of determining PyPy’s performance in pystones:
>>>> from test import pystone >>>> pystone.main(10)
The parameter is the number of loops to run through the test. The default is 50000, which is far too many to run in a non-translated PyPy version (i.e. when PyPy’s interpreter itself is being interpreted by CPython).
To list the PyPy interpreter command line options, type:
cd pypy python bin/pyinteractive.py --help
pyinteractive.py supports most of the options that CPython supports too (in addition to a large amount of options that can be used to customize pyinteractive.py). As an example of using PyPy from the command line, you could type:
python pyinteractive.py -c "from test import pystone; pystone.main(10)"
Alternatively, as with regular Python, you can simply give a script name on the command line:
python pyinteractive.py ../../lib-python/2.7/test/pystone.py 10
See our configuration sections for details about what all the commandline options do.