1
0

Nav apraksta

Herbert Vojčík a07a001cca Release version 0.14.18 9 gadi atpakaļ
external 4651402197 cli: Release 0.14.18 (bump amber & amber-dev). 9 gadi atpakaļ
internal aac7e6fa76 support/: formatting, remove explicit module names 9 gadi atpakaļ
src a07a001cca Release version 0.14.18 9 gadi atpakaļ
support aac7e6fa76 support/: formatting, remove explicit module names 9 gadi atpakaļ
.gitignore 6345132342 .xxxignore files: cosmetic change 9 gadi atpakaļ
.npmignore 6345132342 .xxxignore files: cosmetic change 9 gadi atpakaļ
.travis.yml c862e08ad4 travis: use "container mode" 9 gadi atpakaļ
API-CHANGES.txt fb6c9519da 0.14.18 changes 9 gadi atpakaļ
CHANGELOG fb6c9519da 0.14.18 changes 9 gadi atpakaļ
CONTRIBUTING.md 84048faec3 new cli with peerDependencies install other tools as siblings itself 9 gadi atpakaļ
Gruntfile.js 05e922edc8 Platform-Node is also recompiled by grunt 9 gadi atpakaļ
LICENSE 4a3475c8b8 Updates the license 11 gadi atpakaļ
README.md ca7c863eaf README: install grunt-cli and grunt-init with amber-cli 9 gadi atpakaļ
bower.json a07a001cca Release version 0.14.18 9 gadi atpakaļ
config-node.js 884f142861 use abstract "amber/Platform" 9 gadi atpakaļ
favicon.ico 8b43eb58f1 Add a favicon 11 gadi atpakaļ
local.amd.json d8c0f3f3c8 Compiler-* cleanup 9 gadi atpakaļ
package.json a07a001cca Release version 0.14.18 9 gadi atpakaļ

README.md

Amber

Gitter Average time to resolve an issue Percentage of issues still open

Travis CI Status devDependency status Bountysource

By Nicolas Petton petton.nicolas@gmail.com and Amber contributors

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.

\o/ Call for contributors! \o/

The core project of Amber has enough resources, but:

would need some of your care.

Thank you very much!

(see CONTRIBUTING.md for further details)

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

Prerequisites

Amber is shipped as a cli tool to create new projects and assist with development tasks in a npm package amber-cli and as a library to be used by projects in a bower package amber.

For the installation to work, you need to have installed node, npm and git (in Windows, use Git for Windows and select "Run Git from Windows Command Prompt" and "Checkout Windows-style, commit Unix-style" installation options).

For UNIX-based OS (Linux distibutions, FreeBSD, ...) do

npm config set prefix=~/npm
export PATH="$PATH:$HOME/npm/bin"

to have the installation in a local subdirectory in order to avoid the otherwise necessary sudo installation of Amber. The export line needs to be added to the ~/.profile file as well so that after a new login the path is set.

Getting Amber and setting up an initial project

Do this to install Amber

# Install the CLI tool `amber-cli` and supporting tools
npm install -g grunt-cli grunt-init amber-cli

Use amber init to create a project of your own

# Initialize your project (directory must be empty)
cd /path/to/myproject
amber init

# (optional) Install backward compatibility
bower install amber-compat-es5 --save   # be loadable in older browsers
bower install amber-compat-ie8 --save   # additional tweaks to load in IE8

Start developing in Amber Smalltalk

# Serve amber on localhost:4000
amber serve

Reporting issues

Please refer to CONTRIBUTING.md for further details.

Developing Amber

Please refer to CONTRIBUTING.md for further details. It explains the Amber development setup and how to contribute.

License

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

More infos

More on the project page