Awesome

Fari

fari: To do, to make (eo) — Lighthouses (it)

Fari downloads and prepares fresh, ready-to-hack Pharo images for you, so you can forget about the usual setup dance: get image, run it, open workspace, juggle windows, copy-paste, do-it, save image under new name…

$ git clone git@github.com/$user/$repo.git
$ cd $repo
$ fari.sh build
$ fari.sh run

Install

Drop or link fari.sh in your $PATH.

Configuration

To have code automatically loaded in the fresh image, add a load.st file containing the needed code snippet in your project, typically something like:

"load.st"
Metacello new baseline: 'Foo';
  repository: 'gitlocal://./src';
  load.

This will generate a pharo.1c0ffee.image file. The hex suffix comes from the downloaded snapthot and identifies which sources file matches the image.

Named images: Instead of load.st, you can also use a named load script, e.g. foo.load.st, resulting in a matching foo.*.image. Several named images can be generated, each with specific settings, by having as many named load scripts. If present, load.st is loaded before the named load script of each image; this is useful for sharing configuration in all named images.

Personal settings: any existing local.st or foo.local.st files get loaded after the load scripts; those are intended for loading personal tools and settings, and should thus be left out of version control.

Environment variables: Fari takes a few environment variables into account. We recommend direnv to make any setting persistent and project-specific.

PHARO_PROJECT: image name used in the absence of a named load script; defaults to pharo.

PHARO: name of the Pharo VM command-line executable. Defaults to pharo, assuming that you have it in your $PATH. If you get your VMs from get.pharo.org, set it to ./pharo.

PHARO_VERSION: Pharo release, as used in the get.pharo.org URLs; defaults to 80.

PHARO_FILES: URL prefix for downloading the image; defaults to http://files.pharo.org/get-files/${PHARO_VERSION}.

PHARO_IMAGE_FILE: Name of the image distribution file to download; defaults to pharo64.zip but would be pharo.zip for 32-bit images.

License

The Fari source is available on Github, and is released under the MIT license. See the Docco generated docs for more information: https://cdlm.github.io/fari.sh