README.rst


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

=====================================
PyPy: Python in Python Implementation
=====================================

Welcome to PyPy!

PyPy is both an implementation of the Python programming language, and
an extensive compiler framework for dynamic language implementations.
You can build self-contained Python implementations which execute
independently from CPython.

The home page is:

    http://pypy.org/

If you want to help developing PyPy, this document might help you:

    http://doc.pypy.org/

It will also point you to the rest of the documentation which is generated
from files in the pypy/doc directory within the source repositories. Enjoy
and send us feedback!

    the pypy-dev team <pypy-dev@python.org>


Building
========

First switch to or download the correct branch.  The basic choices are
``default`` for Python 2.7 and, for Python 3.X, the corresponding py3.X
branch (e.g. ``py3.5``).

Build with:

.. code-block:: console

    $ rpython/bin/rpython -Ojit pypy/goal/targetpypystandalone.py

This ends up with a ``pypy-c`` or ``pypy3-c`` binary in the main pypy
directory.  We suggest to use virtualenv with the resulting
pypy-c/pypy3-c as the interpreter; you can find more details about
various installation schemes here:

    http://doc.pypy.org/en/latest/install.html