Amber Smalltalk

History

Amber was originally created by Nicolas Petton in 2011. Amber was influenced by an earlier Smalltalk in browser project, named Clamato, created by Avi Bryant. Amber and Clamato both use parsing expression grammar (PEG) libraries to parse Smalltalk source code. Amber uses the JavaScript based PEG.js library written by David Majda. Clamato uses PetitParser, a Smalltalk-based library written by Lukas Renggli. Clamato and Amber were both influenced by earlier work by Dan Ingalls in developing the Lively Kernel implementation of Morphic to run in web browsers via JavaScript.

Starting with version 0.12.0, Amber modules compile to asynchronous module definition (AMD). Starting with version 0.12.6, the development helper command-line interface (CLI) tool is extracted to dedicated module, which can be installed from npm as @ambers/cli; and setting up the project and its JavaScript ecosystem (npm, grunt) is greatly simplified using this CLI tool by issuing amber init and answering a few questions. Since August 2018, project scaffolding of "amber init" is simplified, not using bower any more and only based on npm and whole project resides under npm organization @ambers. This makes setting Amber Smalltalk easier for people with little JavaScript experience.

Installing

Up-to-date instructions should be at https://lolg.it/amber/amber.

To install Amber, Git must be installed first, if it is not already. The following commands will install Amber:

<span id="mweA"></span><span class="c1" id="mweQ"># for macOS and Linux, needs the following two commands: </span> npm<span class="w" id="mweg"> </span>config<span class="w" id="mwew"> </span><span class="nb" id="mwfA">set</span><span class="w" id="mwfQ"> </span><span class="nv" id="mwfg">prefix</span><span class="o" id="mwfw">=</span>~/npm <span class="nb" id="mwgA">export</span><span class="w" id="mwgQ"> </span><span class="nv" id="mwgg">PATH</span><span class="o" id="mwgw">=</span><span class="s2" id="mwhA">"</span><span class="nv" id="mwhQ">$PATH</span><span class="s2" id="mwhg">:</span><span class="nv" id="mwhw">$HOME</span><span class="s2" id="mwiA">/npm/bin"</span><span class="w" id="mwiQ"> </span><span class="c1" id="mwig"># add to .bash_profile or .bashrc</span> npm<span class="w" id="mwiw"> </span>install<span class="w" id="mwjA"> </span>-g<span class="w" id="mwjQ"> </span>grunt-cli<span class="w" id="mwjg"> </span>grunt-init<span class="w" id="mwjw"> </span>@ambers/cli

To create a new project, write:

<span id="mwkw"></span><span class="c1" id="mwlA"># Create the empty project dir</span> mkdir<span class="w" id="mwlQ"> </span>example-project <span class="nb" id="mwlg">cd</span><span class="w" id="mwlw"> </span>example-project <span class="c1" id="mwmA"># Create and initialize a new Amber project</span> amber<span class="w" id="mwmQ"> </span>init

"amber init" step will lead to some questions about the project. For most of them, a default answer can be set. The next step is to start the server:

amber serve

After that, typing http://localhost:4000 in the browser will get to the application. Most browsers will block Helios IDE pop-ups by default, so browser settings may need changing to allow the Helios IDE popup to appear.

Integrating external JavaScript libraries

Npm software can be used to access a vast array of JavaScript libraries. A library can be integrated by following only four steps:

1. Install the library using npm.
2. If 'local.amd.json' files doesn't exist for the npm package, create a 'libname.amd.json' file in the project root.
3. Run 'grunt devel' (or 'grunt deploy' if ready to deploy an application).
4. Add 'libname' to the application package's #imports: .

Deployment

By running grunt deploy, the Amber project is packaged using RequireJS into just a few files, at the minimum just index.html and the.js, which can be hosted statically as any other static web page.