Amber is an implementation of the Smalltalk language that runs on top of the JavaScript runtime.

Laurent Laffont 7caa3af0a4 merge with master		%!s(int64=13) %!d(string=hai) anos
bin	0e7734d513 Added server.bat for Windows.	%!s(int64=13) %!d(string=hai) anos
css	5b55e07964 - Remove old methods with modules in Kernel	%!s(int64=13) %!d(string=hai) anos
examples	7caa3af0a4 merge with master	%!s(int64=13) %!d(string=hai) anos
ide	d3cf306cca Ripped out ide.html from homepage, feel free to clean it or delete it Nicolas.	%!s(int64=13) %!d(string=hai) anos
images	dc19536ff2 add twitter wall example + thumbnails for examples	%!s(int64=13) %!d(string=hai) anos
js	7caa3af0a4 merge with master	%!s(int64=13) %!d(string=hai) anos
server	7caa3af0a4 merge with master	%!s(int64=13) %!d(string=hai) anos
st	7caa3af0a4 merge with master	%!s(int64=13) %!d(string=hai) anos
.gitignore	7caa3af0a4 merge with master	%!s(int64=13) %!d(string=hai) anos
CHANGELOG	82a21206f7 changelog file	%!s(int64=13) %!d(string=hai) anos
LICENSE	3292b0d40a Spelling fix of Avi's name in LICENSE file.	%!s(int64=13) %!d(string=hai) anos
Makefile	abc0ae8c8e First shot at recursive Makefile in top dir and in examples dir.	%!s(int64=13) %!d(string=hai) anos
README.md	4880fd28ca More renaming	%!s(int64=13) %!d(string=hai) anos
favicon.ico	d6faf375ed Added a new favicon	%!s(int64=13) %!d(string=hai) anos
index.html	fbded175ad Fixed index.html examples list	%!s(int64=13) %!d(string=hai) anos

Amber

By Nicolas Petton petton.nicolas@gmail.com

Amber is an implementation of the Smalltalk language that runs on top of the JavaScript runtime. It is designed to make client-side development faster and easier.

Overview

Amber is written in itself, including the parser and compiler. Amber compiles into efficient JavaScript, mapping one-to-one with the equivalent JavaScript. There is no interpretation at runtime.

Some highlights:

Amber features an IDE with a Class browser, Workspace, Transcript, a ReferencesBrowser supporting senders/implementors and class references, basic Inspector and even a beginning of a Debugger and a unit TestRunner.
Pharo Smalltalk is considered as the reference implementation.
Amber includes a canvas to generate HTML, like Seaside
Amber can use Javascript libraries and the current IDE is built on jQuery
You can inline Javascript code and there are many ways to interact between Amber and Javascript

How to commit changes from the web-based IDE

The Amber class browser is able to commit changes to disk. The "commit category" button will send a PUT request with the JS code of all classes in the selected class category in a file named js/CATEGORY.js and also send the corresponding .st files to the st directory.

The easiest way to enable committing is probably to use the nodejs server or to setup a webdav with Apache.

To start the local server:

./bin/server

then go to http://localhost:4000

The following steps explain how to setup a webdav for Amber with Debian, but the setup on OSX and other Linux distros should be similar.

Install Apache and enable the dav module

apt-get install apache2
a2enmod dav
a2enmod dav_fs

Create a password for the webdav

htpasswd -c /etc/apache2/htpasswd-webdav USERNAME

Setup the webdav for Amber

Add the following lines to the default vhost (in /etc/apache2/sites-available/default):

Alias /amber/ "/path/to/amber/"
    <Directory "/path/to/amber/">
        Options Indexes MultiViews FollowSymLinks
    DirectoryIndex index.html
    AllowOverride None
        Order allow,deny
    allow from all

    Dav on

    AuthType Basic
        AuthName "amber"
        AuthUserFile /etc/apache2/htpasswd-webdav
    <LimitExcept GET OPTIONS>
            Require valid-user
    </LimitExcept>

    </Directory>

Make sure the group www-data has required rights to modify files in the webdav directory.

Restart Apache

/etc/init.d/apache2 restart

License

Amber is released under the MIT license. All contributions made for inclusion are considered to be under MIT.

README.md