Eclipse update site Commandline REPL Jar File

Disclaimer

We currently only release alpha versions of Rascal, which are subject to frequent changes

Eclipse plugin

The Eclipse update site for Rascal is: http://update.rascal-mpl.org/stable/

You need Eclipse for RCP and RAP Developers (Kepler) version of Eclipse available at www.eclipse.org/downloads/ to run Rascal. It has been reported recently that the latest release also works with normal (non RCP/RAP) versions of Eclipse. Not thoroughly tested though!

Please note that:

  • Rascal now needs a JDK because it uses the Java compiler, so please download a JDK, not just a JRE.
  • You may have to edit the Eclipse init file so that Eclipse can find your Java installation and Eclipse can allocate enough resources.
  • For generating parsers, Rascal uses quite a bit of memory. Please use -vmargs -Xmx1G -Xss32m

Follow these steps to install the plugin into Eclipse

  1. Start Eclipse.
  2. Select Help -> Install New Software.
  3. Make sure that the tick for "Contact all update sites during install to find required software" is enabled.
  4. Type: http://update.rascal-mpl.org/stable/ in the "Work with" edit box.
  5. Select the feature Rascal.
  6. Select Next (several times) and accept the software license. The process may take a few minutes!
  7. Once these features have been installed, restart Eclipse.
  8. In case of problems check our Troubleshooting page

How to use the Eclipse plugin for the first time

After you have downloaded Rascal, you might be interested in the first steps to executing some Rascal code.

  • Open the Rascal Perspective (use the "Open Perspective" button in the top-right of your screen)
  • Create a new Rascal project (use the "New..." button in the top-left of your screen, then select "Rascal Project" from the menu)
  • This should automatically open a new console with the new project on its search path
  • Type 1 + 1 after the rascal> prompt to see 2

Commandline REPL

An entirely different way of using Rascal is via the standalone commandline console. You can download the fully contained jar file here.

Please note that:

  • The commandline version does not feature pre-installed Java analysis libraries
  • A Java SDK 1.7 or higher installed and available. A Java run-time environment will not be enough.
  • The command line of Rascal starts by running java -Xmx1G -Xss32m -jar rascal-<version>.jar.

Further reading

Check out our Help page for links to documentation and our community.