Eclipse update site
Commandline REPL Jar File
We currently only release alpha versions of Rascal, which are subject to frequent changes.
The Eclipse update site for Rascal is: https://update.rascal-mpl.org/stable/
You need Eclipse for RCP Developers (Neon.3 or Oxygen) version of Eclipse,
available at www.eclipse.org/downloads/ to run Rascal. Older versions of Eclipse should also work, at least down to Mars.2.
A continuously released update site for practical libraries for Rascal can be found here: https://update.rascal-mpl.org/libs/, featuring for example prototypes of:
Please note that:
- Rascal needs a JDK because it uses the Java compiler, so please download a JDK8, not just a JRE.
- Our update site has a Let’s Encrypt certificate, which has been supported by Java 8 from update 101 onwards.
Please update your Java 8 installation if you encounter a ValidatorException during the installation process.
- 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
- Start Eclipse.
- Select Help -> Install New Software.
- Make sure that the tick for “Contact all update sites during install to find required software” is enabled.
https://update.rascal-mpl.org/stable/ in the “Work with” edit box, and then press enter.
- Select the feature Rascal (only the Rascal Metaprogramming Language is needed).
- Select Next (several times) and accept the software license. The process may take a few minutes!
- Once these features have been installed, restart Eclipse.
- 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
1 + 1 after the
rascal> prompt to see
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 support analyzing Java code directly at the moment.
- A Java JDK 1.8 or higher installed is required. A Java run-time environment (JRE) will not be enough.
- The command line of Rascal starts by running
java -Xmx1G -Xss32m -jar rascal-<version>.jar.
Check out our Help page for links to documentation and our community.