To protect your data, the CISO officer has suggested users to enable GitLab 2FA as soon as possible.

Commit c82d71b6 authored by John Zhang's avatar John Zhang
Browse files

Merge branch 'mu-rewrite' of gitlab.anu.edu.au:mu/mu-client-pypy into mu-rewrite

parents 2942d83c 9d46007f
=====================================
PyPy: Python in Python Implementation
=====================================
==============================
PyPy-Mu: A Mu Backend for PyPy
==============================
Welcome to PyPy!
Welcome to PyPy-Mu!
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.
PyPy-Mu is a fork of `PyPy <http://pypy.org>`__ that aims to
add a `Mu Micro Virtual Machine <http://microvm.org>`__ backend for it.
The home page is:
This project is currently under active development,
right now we can compile PyPy interpreter with `--no-allworkingmodules` option.
http://pypy.org/
Building
========
If you want to help developing PyPy, this document might help you:
Obtaining a Mu implementation
-----------------------------
http://doc.pypy.org/
The reference implementation (Holstein) for Mu can be found `here <https://gitlab.anu.edu.au/mu/mu-impl-ref2>`__.
Build the Mu implementation, make sure to build the C binding as well.
The fast implementation (Zebu) for Mu can be found `here <https://gitlab.anu.edu.au/mu/mu-impl-fast>`__.
This implementation is still in progress.
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!
Reference implementation is targetted by default.
You can specify which implementation to target using the flag ``--mu-impl=<impl>`` to RPython.
the pypy-dev team <pypy-dev@python.org>
Setting up environment variable
-------------------------------
.. role:: bash(code)
:language: bash
Building
========
RPython Mu API binding requires ``$MU_HOLSTEIN`` and/or ``$MU_ZEBU`` environment variable to be set.
You need to set them to point to the cloned Mu implementation repository.
Compiling & Executing RPython Target
------------------------------------
Specify :bash:`-b mu` option to compile using the Mu backend:
::
$ rpython/bin/rpython -b mu <target>
This builds the program bundle and dumpts out a boot image as ``<target>-mu`` in the current directory.
The nature of the boot image is implementation defined.
Currently for Holstein, it is a zip file; for Zebu, it is a binary executable.
Note the default Mu code generation backend is API (building bundle through API calls).
This back-end can be slow for compiling larger RPython programs.
An alternative is caching the calls into C sources, and run from there (remove the overhead of RPython FFI).
To specify the code generation back-end, use the flag ``--mu-codegen=<backend>``, which takes ``c`` or ``api``.
To run the dumped boot image under Holstein, use the `runmu.sh` shell script.
::
$ $MU_HOLSTEIN/tools/runmu.sh <mu-flags> <bootimage> <program-args>
build with:
--------------------------
.. code-block:: console
Why not try compiling the PyPy interpreter (currently with some limitations)?
$ rpython/bin/rpython -Ojit pypy/goal/targetpypystandalone.py
::
This ends up with ``pypy-c`` binary in the main pypy directory. We suggest
to use virtualenv with the resulting pypy-c as the interpreter; you can
find more details about various installation schemes here:
$ PYTHONPATH=$PYPY_MU pypy rpython/bin/rpython -O3 -b mu --mu-vmargs='sosSize=780M\nlosSize=780M' --mu-codegen=c --no-shared $PYPY_MU/pypy/goal/targetpypystandalone.py --no-allworkingmodules
$ $MU/tools/runmu.sh --staticCheck=false --sourceInfo=false --vmLog=ERROR --sosSize=780M --losSize=780M $PYPY_MU/pypy/bin/pypy-mu
http://doc.pypy.org/en/latest/install.html
Note: when building the pypy interpreter, put the boot image under pypy/bin, so that PyPy can initialise the path correctly.
\ No newline at end of file
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment