blob: d9cd3e08ff29af421fedda01ae1680202e6e320c (
plain)
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
|
=======================
The ``__pypy__`` module
=======================
The ``__pypy__`` module is the main entry point to special features provided
by PyPy's standard interpreter. Its content depends on `configuration options`_
which may add new functionality and functions whose existence or non-existence
indicates the presence of such features.
.. _`configuration options`: config/index.html
Generally available functionality
=================================
- ``internal_repr(obj)``: return the interpreter-level representation of an
object.
- ``bytebuffer(length)``: return a new read-write buffer of the given length.
It works like a simplified array of characters (actually, depending on the
configuration the ``array`` module internally uses this).
Transparent Proxy Functionality
===============================
If `transparent proxies`_ are enabled (with :config:`objspace.std.withtproxy`)
the following functions are put into ``__pypy__``:
- ``tproxy(typ, controller)``: Return something that looks like it is of type
typ. Its behaviour is completely controlled by the controller. See the docs
about `transparent proxies`_ for detail.
- ``get_tproxy_controller(obj)``: If obj is really a transparent proxy, return
its controller. Otherwise return None.
.. _`transparent proxies`: objspace-proxies.html#tproxy
Functionality available on py.py (not after translation)
========================================================
- ``isfake(obj)``: returns True if ``obj`` is faked.
- ``interp_pdb()``: start a pdb at interpreter-level.
|