Skip to content
/ pycket Public
forked from pycket/pycket

A rudimentary Racket implementation using RPython

License

Notifications You must be signed in to change notification settings

krono/pycket

 
 

Repository files navigation

Build Status codecov.io

A Racket/Scheme implementation using RPython. It adds a JIT.

Building

In order to do anything with Pycket, you need to check out PyPy:

$ hg clone https://bitbucket.org/pypy/pypy

The below instructions assume that you do this checkout in this directory.

Additionally, it helps to have the build dependencies of PyPy installed. On a Debian or Ubuntu system:

$ sudo apt-get build-dep pypy

You also need a reasonably recent version of Racket, at least version 6.1.1. Then you need to set up the pycket language in Racket:

$ raco pkg install -t dir pycket/pycket-lang/

Afterwards you can run the unit-tests as follows:

$ pypy/pytest.py pycket

or using make

$ make test

To produce an executable, run:

$ ./pypy/rpython/bin/rpython -Ojit targetpycket.py

This expects that a binary named pypy is in your path. (Note that a hand-compiled PyPy by running make produces pypy-c, not pypy).

If you don't have a compiled pypy, you can also translate with:

$ python ./pypy/rpython/bin/rpython -Ojit targetpycket.py

This will take upwards of 10 minutes. This requires a PYTHONPATH that includes both rpython (that should be the pypy directory cloned above) and pycket (that should be this directory).

You can also use make for any of the above,

  • make setup to setup the Racket language and update your pypy chekout
  • make pycket-c to translate with JIT
  • make pycket-c-nojit to translate without JIT (which is may be a lot faster to translate but runs a lot lot slower)

Running

Afterwards you can execute a program:

$ ./pycket-c program

You can also run pycket under plain python, like this:

$ ./pycket-slow.sh program

Or even this, when this directory is in your PYTHONPATH:

$ python -mpycket program

You can edit the shell script to make it use pypy, if desired.

Misc

You can generate a coverage report with pytest:

$ pypy/pytest.py --cov .

or via

$ make coverage

which also generates an HTML report in pycket/test/coverage_report.
You need these Python packages for that to work:

  • pytest-cov (provided with the pypy checkout)
  • cov-core and coverage

Also, the Makefile reacts to some variables:

  • PYPYPATH for when your pypy checkout is not in this directory.
    Defaults to pypy.
  • PYTEST for when you don’t want to use pypy’s version of pytest.
    Defaults to $(PYPYPATH)/pytest.py.
  • RPYTHON for when you want to use something other than the default rpython script, but you probablywould not want that.
    Defaults to $(PYPYPATH)/rpython/bin/rpython --batch.

Benchmarking

Pycket's benchmarks are available at this repository, along with instructions for running them.

About

A rudimentary Racket implementation using RPython

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 47.6%
  • Racket 27.2%
  • KiCad Layout 15.6%
  • Eagle 8.9%
  • Shell 0.6%
  • Makefile 0.1%