Rascal MPL is a programming language specifically designed to analyze and manipulate code in
any data format or programming language. This means code generation, code analysis, code visualization,
anything that you can do to code and with code, Rascal is designed to make it easy.
In particular the creation of IDEs for new Programming Languages and Domain Specific Languages (DSLs)
is easy with Rascal. The Rascal VScode extension is a so-called Language Workbench.
Have a look here for more information:
Features
- R-LSP: IDE features for the Rascal metaprogramming language (parsing, syntax highlighting, type-checking, REPL terminal)
- P-LSP: "language parameterized" LSP server for languages expressed in Rascal. From a syntax definition you can start running your own LSP in vscode in a few steps.
- Rascal terminal: highly integrated terminal REPL that allows you to:
- script and experiment with ad-hoc code analyses and visualizations
- register new DSLs with VSCode using the P-LSP
- experiment and test new DSL features
The Rascal VScode extension currently is bundled with the following libraries:
- Rascal standard library
- Rascal-LSP LanguageServer library
- Java analysis library based on Eclipse JDT
Requirements
- Installed JDK 11
- However, the extension will propose to download the right JDK for you if you do not have it yet.
Extension Settings
No settings so far.
Known Issues
This extension is slowly but surely stabilizing, some stuff is still buggy. Please consider it an beta preview version. Your constructive feedback is much appreciated at https://github.com/usethesource/rascal-language-servers/issues. The Rascal support does not include an interactive visual debugger yet, or debugger support for domain specific languages.
This extension works best with Java 11; but running it on Java 17 reportedly works as well
For other things we are working on have a look here:
Release Notes
0.7.0
- Fixes issues with IDEServices::registerDiagnostics where only the first error would be registered.
- Fixes issue with Rascal library loading where Rascal source files where loaded in a different order from the path than their accompanied .class files.
- util::Reflective::newRascalProject now guarantees syntax regex for project folders and project names.
- XML, HTML and JSON parsers now provide source origin location with every node.
- Improved support for Windows PATHs in dependency resolution code of Rascal
- Fixed UTF8 encoding issue in the Lucene library
- Documentation improvements
- Several minor issues.
- Added more validation features for RASCAL.MF files.
0.6.3
- bugfix for writes to VS Code virtual file systems initiated from rascal (only first 8KB of the write was correctly transferred)
0.6.2
- Bugfix for RASCAL.MF validator (#225)
0.6.1
- bumped rascal to 0.28.3 for performance fixes around maven and various bugfixes
- typechecking with latest 0.14.6 version of rascal-maven-plugin (and using linked rascal-library) to avoid outdated typepal files
- now allowing jdk 17 as runtime, we'll still install 11 as default, but jdk 17 seems to work.
- Bugfix for automatic jdk downloader on aarch64 osx (Apple M1 for example)
- RASCAL.MF files are now checked for common errors and incorrect configurations
0.6.0
- bumped rascal to 0.28.0 for the addition of vis::Graphs and fixes in util::Sampling and vis::Charts.
- fixed issues with the IDEServices::edit function, in the VScode terminal context and VScode parameterized DSL LSP server context, with logical locations and locations with line/column information (both previously unsupported), for use in interactive visualizations (for example).
- allow vscode extensions to use rascal-vscode independently of installed rascal; this means DSL implementations can run their own native extension when they are finished being developed.
- as a result, rascal-vscode is now also an independent npm package.
0.5.6
- fixes issue which was caused by an issue in the rascal project.
- bumped rascal to 0.27.3 for the above fix.
0.5.5
This release is about including a new version of the rascal project, 0.27.2:
- fixes issue with variable scope leakages for optimized visit statements
- adds util::Validator for validating complex untyped hierarchical structures (such as obtained from XML, JSON or YAML)
- added vis::Charts for eight basic chart types
- redesign of lang::json::IO with more natural mapping to JSON objects, but more precarious constraints for mapping back. See util::Validator for bridging the new gap if you have a complex ADT with lots of overloading and many constructors per type. The default mapping only supports simple enums and single constructors per ADT.
0.5.4
0.5.2
- fixed efficiency issue in use of the
project:/// scheme for browsing file hierarchies, like for example in getASTs function for Java.
- new logo
0.5.1
- upgraded to latest version of rascal (0.26.2) to fix an issue that become more present with the multiple evaluators feature
0.5.0
- Now using rascal 0.24.7
- Rascal DSLs can now use multiple evaluators if they want (see discussion in #181)
- Rascal DSLs do not get typepal on the PathConfig/evaluator search path by default. Only rascal & rascal-lsp.
unregisterLanguage was added to clear all or parts of a language- Rascal REPLs get a progressbar while starting. This provides more feedback that something is happening, especially until the performance regression on windows is fixed.
0.4.0
- Now using rascal 0.24.6
- Better support pom.xml dependency resolution
- Rascal LSP commands can return values that are available in typescript
- Bugfix for handling def/ref/hover request in the "start" region of a rascal parse tree
- Moved to LSP 3.17 using the native inlayHint implementation
- Updated java & node dependencies to latest releases
- Improved performance of DSL init (specifically the time spent on generating parsers)
0.3.0
- Rascal DSLs get more flexibility (and performance) in how they contribute the information back to VS Code. Summaries work as base, but developers can defined custom functions for specific requests from VS Code.
- Rascal DSLs can parse without waiting for other request to finish
- Now using Rascal 0.24.2
0.2.4
- reduced frequency of summary calls for DSLs
0.2.3
- updated typepal dependency to reduce debug prints
0.2.2
- Virtual file systems of VSCode are now available in rascal
- Bumped dependencies of java and nodejs
- rascal version bumped to 0.23.2
- Improved REPL integration for browsing and editing files from the command line
0.2.1
- Version bump of rascal dependency from 0.23.0 to 0.23.1, which makes browsing the standard libraries possible due to fixing an incompatible type file format.
- Version bump of rascal dependencies from 0.22.1 to 0.23.0; this includes bugfixes around prefix matching with concrete syntax trees and the use of the
private modifier (if one alternative is private, they are now all private).
- Version bumps for typepal and rascal-core with improved typechecking efficiency.
- Better error reporting for the Rascal LSP server and the parameterized LSP server.
- Fixes around status progress bars.
- Fix for packaging of rascal-lsp jar (which helped remove spurious type-checking errors in clients of the LanguageServer library modules)
0.2.0
- Moved to Java 11
- Upgrade to newer Rascal type-checker
- Early support for cross-project rascal dependencies for both REPL & type-checker
- Rascal features work even without a project open (opening a single rascal file for example)
- Improved status bar messages for DSLs and making sure to always clear finished tasked
- Increases performance of project source location operations
- Automatic java detection ignores JREs
- Fixed bug that prevented detection of new projects added to the workspace
0.1.7
- Security release, bumping log4j dependency
0.1.6
- Rascal is now properly reporting progress
- Parametric DSLs can defined inlayHints to annotate a source tree
0.1.5
- Rascal LSP server now starts lazily to reduce memory overhead.
- Parametric LSP server now starts lazily to reduce memory overhead.
- Fixed missing print of Rascal version in the REPL.
- Added print of Rascal-lsp version in the REPL.
- Added automatic JDK download if none is available.
- Added
registerLanguage to public extension API.
0.1.4
- Improved semantic tokenization and highlighting for Rascal and DSLs. Tokenization has been refined to allow differential coloring of nested nonterminals.
- Added folding regions for Rascal based on its grammar.
- Added folding regions for DSLs based on the grammar.
- Fixed REPL autoreloading for changed files.
0.1.3
- Bugfixes for the features below.
0.1.2
- Bugfixes for the features below
0.1.1
- Added feature to publish diagnostics while scripting code analyses in the terminal (uses util::IDEServices)
- Added feature of clickable logical URI's, like "|java+class://java/util/List|" in the terminal such that they resolve to the code location of the declared entity.
0.1.0
- Added features for progress reporting from both the R-LSP and the P-LSP
- Added applyEdits functionality from the terminal and the P-LSP
- Added code lenses for the P-LSP
- Fixed a number of synchronization issues
0.0.3
- Fixed bug that disabled the IDE generator functionality.
0.0.2
0.0.1
- Initial release of rudimentary support for the Rascal language
- A terminal REPL for Rascal
- A parametrized LSP that can be configured directly from the Rascal REPL using
registerLanguage
LICENSE
Rascal and this extension are licensed under the BSD2 open-source license. Some files
and libraries are licensed with the Eclipse Licence v2. See LICENSE
