GraalSqueak

A Squeak/Smalltalk implementation for the GraalVM.

Getting Started

1. Find the latest GraalSqueak release and identify the supported version of GraalVM.
2. Download the corresponding GraalVM for your platform (if you are on Windows, please follow these instructions instead).
3. Install the pre-compiled GraalSqueak component attached to the release with the GraalVM Updater:

$GRAALVM_HOME/bin/gu install \
  -u https://github.com/hpi-swa/graalsqueak/releases/download/X.Y.Z/graalsqueak-component-X.Y.Z.jar

4. You should now be able to open the GraalSqueak image attached to the release:

$GRAALVM_HOME/bin/graalsqueak path/to/a/GraalSqueak-X.Y.Z.image

Development

Active development is done on the dev branch, which is merged to master for new releases. Therefore, please open pull requests against dev if you like to contribute a bugfix or a new feature.

Building from Source

The mx tool is required to build GraalSqueak. Running mx build in GraalSqueak's root directory checks out all dependencies and builds all JAR files for running and testing GraalSqueak. It can also be used to run GraalSqueak via the mx squeak command. As an example, mx --dy /compiler squeak path/to/a/squeaksmalltalk.image opens the image and enables the Graal compiler. Run mx squeak --help and mx --help to list all command-line flags you can run GraalSqueak with.

Setting Up A New Development Environment

It is recommended to use Eclipse with the Eclipse Checkstyle Plugin for development.

1. Run mx eclipseinit in GraalSqueak's root directory to create all project files for Eclipse.
2. Import all projects from the graal repository which mx should have already cloned into the parent directory of your GraalSqueak checkout during the build process.
3. Import all projects from GraalSqueak's root directory.
4. Run GraalSqueakLauncher to start GraalSqueak.

Contributing

Please report any issues here on GitHub and open pull requests if you'd like to contribute code or documentation.

Publications

2019

• Fabio Niephaus, Tim Felgentreff, and Robert Hirschfeld. GraalSqueak: Toward a Smalltalk-based Tooling Platform for Polyglot Programming. In Proceedings of the International Conference on Managed Programming Languages and Runtimes (MPLR) 2019, co-located with the Conference on Object-oriented Programming, Systems, Languages, and Applications (OOPSLA), 12 pages, Athens, Greece, October 21, 2019, ACM DL.
  
• Daniel Stolpe, Tim Felgentreff, Christian Humer, Fabio Niephaus, and Robert Hirschfeld. Language-independent Development Environment Support for Dynamic Runtimes. In Proceedings of the Dynamic Languages Symposium (DLS) 2019, co-located with the Conference on Object-oriented Programming, Systems, Languages, and Applications (OOPSLA), 11 pages, Athens, Greece, October 20, 2019, ACM DL.
  
• Fabio Niephaus. HPI Polyglot Programming Seminar. In the GraalVM Blog, October 11, 2019.
• Fabio Niephaus, Tim Felgentreff, Tobias Pape, and Robert Hirschfeld. Efficient Implementation of Smalltalk Activation Records in Language Implementation Frameworks. In Proceedings of the Workshop on Modern Language Runtimes, Ecosystems, and VMs (MoreVMs) 2019, companion volume to International Conference on the Art, Science, and Engineering of Programming (‹Programming›), co-located with the International Conference on the Art, Science, and Engineering of Programming (‹Programming›), 3 pages, Genova, Italy, April 1, 2019, ACM DL.
  
• Tobias Pape, Tim Felgentreff, Fabio Niephaus, and Robert Hirschfeld. Let them fail: towards VM built-in behavior that falls back to the program. In Proceedings of the Salon des Refusés (SDR) 2019 Workshop, companion volume to International Conference on the Art, Science, and Engineering of Programming (‹Programming›), co-located with the International Conference on the Art, Science, and Engineering of Programming (‹Programming›), 7 pages, Genova, Italy, April 1, 2019, ACM DL.
  
• Fabio Niephaus, Eva Krebs, Christian Flach, Jens Lincke, and Robert Hirschfeld. PolyJuS: A Squeak/Smalltalk-based Polyglot Notebook System for the GraalVM. In Proceedings of the Programming Experience 2019 (PX/19) Workshop, companion volume to International Conference on the Art, Science, and Engineering of Programming (‹Programming›), co-located with the International Conference on the Art, Science, and Engineering of Programming (‹Programming›), 6 pages, Genova, Italy, April 1, 2019, ACM DL.
  

2018

• Fabio Niephaus, Tim Felgentreff, and Robert Hirschfeld. GraalSqueak: A Fast Smalltalk Bytecode Interpreter Written in an AST Interpreter Framework. In Proceedings of the Workshop on Implementation, Compilation, Optimization of Object-Oriented Languages, Programs, and Systems (ICOOOLPS) 2018, co-located with the European Conference on Object-oriented Programming (ECOOP), Amsterdam, Netherlands, July 17, 2018, ACM DL.
  

License

GraalSqueak is released under the MIT license.