Eclipse update site Commandline REPL Jar File


We release beta versions of Rascal, which are pretty stable. For 2022, expect about one release per month. Alpha releases are continuously deployed.

Eclipse plugin

The Eclipse update site for Rascal is:

You need the Eclipse IDE for RCP and RAP Developers version of Eclipse. Currently, due to compatability issues with Java 8, the latest Rascal plugins only works with Eclipse IDE versions up after 2020-06. Older versions of Eclipse do not work anymore.

Please note that:

  • You need a JDK version 11, not lower and not higher.
  • You may have to edit the Eclipse init file so that Eclipse can find your Java installation and Eclipse can allocate enough resources. If you are running MacOSX you have to start Eclipse once first, quit, and then edit the ini file.
  • 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: in the “Work with” edit box, and then press enter.
  5. Select the feature Rascal (only the Rascal Metaprogramming Language is needed).
  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 comes with “batteries included” for Java analysis (the jar packages even the Eclipse JDT compiler), but of course Rascal can be used to analyze any programming language in principle.
  • A Java JDK 11 installation is required. A Java run-time environment (JRE) will not be enough, Java 8 or 9 is not high enough, and Java 13 is currently too high.
  • 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.