How to use Pharo/Squeak from the Command-line

Along the way to measure the performance of a Smalltalk implementation for commodity multi-core systems, I tried to use Pharo as a more convenient development platform. Well, and I failed in the first attempt…

To remind myself and document some of the necessary steps in this environment, I wrote up the following tutorial.

Command-line Scripts with a Headless Pharo

For some tasks like benchmarking and automated testing, an integration with other tools comes in handy. For such use cases, Pharo can be used headless, i.e., without its graphical user interface.

This brief tutorial will demonstrate how to use the Debian Language Shootout benchmarks with a fresh Pharo image.

Step 1: Setup Pharo and a Fresh Image

  • download a Pharo image, the sources file, and a VM from the download page
  • extract all archives in the same folder
  • start Pharo, from the commandline, on a MacOSX it should look like this: "Squeak 4.2.1beta1U.app/Contents/MacOS/Squeak VM Opt" \ pharo1.0-10418-BETAdev09.08.3.image

Step 2: Load OSProcess

For output on the shell, we need an extra package from the SqueakSource repository.

It can be loaded by simply executing the following code in a workspace window:

ScriptLoader loadLatestPackage: 'OSProcess' from:
'http://www.squeaksource.com/OSProcess'

To execute this code snippet, select it and press cmd+d or use the “do it” item in the context menu.

Step 3: Load Common Benchmark Code

Now we can load the common parts of all shootout benchmarks into our image.

  • On way to do this is to grab the code shown here
  • and save it to a file called common.st.
  • Open the file browser from the Menu -> Tools -> File Browser.
  • Select common.st and press filein to load the code.

Now you can close all windows in your image and save and quit it.

Step 4: Run a Benchmark

  • Grab the code of a benchmark like Fannkuch
  • Save it to a file named like fannkuch.st
  • Add a run script to the end of the code in fannkuch.st, like this:
        Tests fannkuch.
        SmalltalkImage current snapshot: false andQuit: true.
    
  • Run it with a headless Pharo:
        "Squeak 4.2.1beta1U.app/Contents/MacOS/Squeak VM Opt" \
            -headless pharo1.0-10418-BETAdev09.08.3.image \
            $PWD/fannkuch.st 6
    

    important is here the absolute path to the script, clearly inconvenient and uncommon on the command-line.

Tags: , , , , , , ,

2 Responses to “How to use Pharo/Squeak from the Command-line”

  1. Andrew Pennebaker August 4, 2011 at 23:46 #

    Could you create an installer (MSI, DMG, DEB, etc.) that sets up Pharo and/or Squeak for the command line? I’d be happy to learn Smalltalk once it becomes easy to use it via CLI.

  2. Stefan August 5, 2011 at 00:03 #

    Please refer to the Squeak or Pharo homepage, they offer such installers.

    The RoarVM comes with the standard GNU ./configure && make && sudo make install tooling.