TornadoInsight is an open source IntelliJ plugins, for developers to enhance the developer experience when working with TornadoVM. TornadoInsight is designed exclusively for TornadoVM development. It goes beyond the conventional by providing a built-in on-the-fly static checker, empowering developers to identify unsupported Java features in TornadoVM and understand the reasons behind these limitations. Additionally, TornadoInsight introduces a dynamic testing framework, enabling developers to test individual TornadoVM tasks effortlessly. It automatically wraps TornadoVM tasks, invoking the native TornadoVM runtime on the developer's machine for seamless debugging and testing.
TornadoInsight comes equipped with an on-the-fly static checker. This tool scans TornadoVM code in real time, pinpointing any Java features that are not supported by TornadoVM. Through instant notifications, developers gain immediate insights into potential compatibility issues, allowing for proactive adjustments and adherence to TornadoVM guidelines. Currently, the static checker already has checks for datatype, Traps/Exceptions, recursion, native method calls, assert statements.
TornadoInsight provides a tool window to view the built-in static inspector for detailed information.
TornadoInsight simplifies the testing process for individual TornadoVM tasks. After creating a TornadoVM Task, there is no need to write the main method or initialize the method parameters. You only need to select the method in the tool window of TornadoInsight to test it.
With its dynamic testing framework, developers can seamlessly conduct tests on specific tasks within their codebase. TornadoInsight will dynamically generate a test file and guide the automatic generation of the Main method and the Taskgraph required by TornadoVM, And automatically create and initialize variables according to parameter types. Then TornadoInsight invokes the TornadoVM runtime on the developer's machine to run the generated Java file. This functionality streamlines the debugging process, making it convenient for developers to identify and resolve issues in their TornadoVM applications. If TornadoVM Task is compatible with TornadoVM, the test outputs the OpenCL kernel code for it, so that developers can debug it. If it is not compatible, it will output an exception. In addition, test run times are displayed in the lower right corner to allow developers to evaluate performance.
Getting started with TornadoInsight is a straightforward process:
- Open IntelliJ IDEA.
- Navigate to "Preferences" or "Settings" depending on your operating system.
- Select "Plugins" from the menu.
- Search for "TornadoInsight" and click "Install."
TornadoInsight invokes Java and TornadoVM on the developer's local machine as it works, and you need to make sure that you have them installed correctly before using the plugin.
- TornadoVM >= 0.17
- JDK >= 21
In order to enable TornadoInsight's dynamic inspection feature, it needs to be configured after installation.
- Navigate to "Preferences" or "Settings" depending on your operating system.
- Select "TornadoVM" from the menu.
Requires TornadoVM installation root directory and path to Java 21 and above. The “parameter size” represents the length of the assignment that TornadoInsight creates for the collection type when performing the dynamic test.