Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/skinny85/graalvm-truffle-tutorial
The code for the series of tutorials on my blog about the GraalVM Truffle language implementation framework
https://github.com/skinny85/graalvm-truffle-tutorial
Last synced: about 2 months ago
JSON representation
The code for the series of tutorials on my blog about the GraalVM Truffle language implementation framework
- Host: GitHub
- URL: https://github.com/skinny85/graalvm-truffle-tutorial
- Owner: skinny85
- Created: 2020-09-19T05:28:08.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2024-04-13T06:04:42.000Z (5 months ago)
- Last Synced: 2024-04-13T20:51:05.955Z (5 months ago)
- Language: Java
- Homepage: http://endoflineblog.com/graal-truffle-tutorial-part-0-what-is-truffle
- Size: 1.84 MB
- Stars: 36
- Watchers: 6
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: ReadMe.md
Awesome Lists containing this project
README
# GraalVM Truffle tutorial
This repository contains the code for a tutorial on the
[Truffle language implementation framework](https://github.com/oracle/graal/blob/master/truffle/docs/README.md)
that I've [written for my blog](http://endoflineblog.com/graal-truffle-tutorial-part-0-what-is-truffle).
It focuses on implementing a language I call EasyScript,
which is a very simplified subset of JavaScript.
The repository is divided into multiple parts,
each corresponding to a part of the blog article.
Each part focuses on explaining a small set of Truffle capabilities,
and builds on top of the previous parts by adding more features to the EasyScript language implementation.
Each part is a separate [Gradle submodule](https://docs.gradle.org/current/userguide/multi_project_builds.html),
and so gets built when you build the top-level project.
## Setup
To build and execute this project, you need a GraalVM installation on your local machine.
The free Community Edition works fine if you don't have the paid Enterprise Edition.
You can download it from here: https://github.com/graalvm/graalvm-ce-builds/releases.
This repository uses Java 11 features,
so make sure to download a version for Java 11.
Once you've downloaded the correct archive for your operating system and extracted it somewhere on your machine,
you need to set the `JAVA_HOME`
environment variable to point to the directory containing the uncompressed contents:
```shell script
$ export JAVA_HOME=/path/to/extracted/archive
```
You can verify the installation works by executing the `java`
command using `JAVA_HOME`:
```shell script
$ $JAVA_HOME/bin/java -version
openjdk version "17.0.5" 2022-10-18
OpenJDK Runtime Environment GraalVM CE 22.3.0 (build 17.0.5+8-jvmci-22.3-b08)
OpenJDK 64-Bit Server VM GraalVM CE 22.3.0 (build 17.0.5+8-jvmci-22.3-b08, mixed mode, sharing)
```
## Building
Once you have GraalVM installed,
you can build the project -
it uses [Gradle](https://gradle.org)
as its build system:
```shell script
$ ./gradlew build
```
## Table of contents
* [Part 1 - `Node`, `RootNode`, `CallTarget`](part-01)
* [Part 2 - introduction to specializations](part-02)
* [Part 3 - specializations using Truffle DSL, `@TypeSystem`](part-03)
* [Part 4 - parsing, and the `TruffleLanguage` class](part-04)
* [Part 5 - global variables](part-05)
* [Part 6 - static function calls](part-06)
* [Part 7 - function definitions](part-07)
* [Part 8 - conditionals, loops, control flow](part-08)
* [Part 9 - performance benchmarking](part-09)
* [Part 10 - arrays, read-only properties](part-10)
* [Part 11 - strings, static method calls](part-11)
* [Part 12 - classes 1: methods, `new` operator](part-12)
* [Part 13 - classes 2: fields, `this`, constructors](part-13)
* [Part 14 - classes 3: inheritance, `super`](part-14)