File: index.rst

package info (click to toggle)
pypy3 7.3.11%2Bdfsg-2%2Bdeb12u3
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 201,024 kB
  • sloc: python: 1,950,308; ansic: 517,580; sh: 21,417; asm: 14,419; cpp: 4,263; makefile: 4,228; objc: 761; xml: 530; exp: 499; javascript: 314; pascal: 244; lisp: 45; csh: 11; awk: 4
file content (60 lines) | stat: -rw-r--r-- 2,072 bytes parent folder | download | duplicates (5)
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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
==============================
Configuration Options for PyPy
==============================

This directory contains documentation for the many `configuration`_
options that can be used to affect PyPy's behaviour.  There are two
main classes of option, `object space options`_ and `translation
options`_.

There are two main entry points that accept options: ``py.py``, which
implements Python on top of another Python interpreter and accepts all
the `object space options`_:

.. parsed-literal::

    ./py.py <`objspace options`_>

and the ``rpython/bin/rpython`` translation entry
point which takes arguments of this form:

.. parsed-literal::

    ./rpython/bin/rpython <`translation options`_> <target>

For the common case of ``<target>`` being ``targetpypystandalone.py``,
you can then pass the `object space options`_ after
``targetpypystandalone.py``, i.e. like this:

.. parsed-literal::

    ./rpython/bin/rpython <`translation options`_> targetpypystandalone.py <`objspace options`_>

There is an `overview`_ of all command line arguments that can be
passed in either position.

Many of the more interesting object space options enable optimizations,
which are described in `Standard Interpreter Optimizations`_, or allow
the creation of objects that can barely be imagined in CPython, which
are documented in `What PyPy can do for your objects`_.

The following diagram gives some hints about which PyPy features work together
with which other PyPy features:

.. image:: ../image/compat-matrix.png

.. _`configuration`: ../configuration.html
.. _`objspace options`: commandline.html#objspace
.. _`object space options`: commandline.html#objspace
.. _`translation options`: commandline.html#translation
.. _`overview`: commandline.html
.. _`Standard Interpreter Optimizations`: ../interpreter-optimizations.html
.. _`What PyPy can do for your objects`: ../objspace-proxies.html


.. note::

   Parts of this document are not included in the Debian package.
   See the missing sections `online`_.

.. _`online`: https://doc.pypy.org/en/latest/config/index.html