1
0

Žiadny popis

Herbert Vojčík e9220bd6dc Release version 0.16.0 8 rokov pred
external 2b64213a98 devkit: Release 0.8.4. 8 rokov pred
internal 8994f8a6c2 Install amber-dev deps as well in release worker. 8 rokov pred
src 55e4b8f28c Release version 0.16.0 8 rokov pred
support 25fd3bb33a kernel: use relative module id to load runtime 8 rokov pred
.gitignore 6345132342 .xxxignore files: cosmetic change 9 rokov pred
.npmignore 6345132342 .xxxignore files: cosmetic change 9 rokov pred
.travis.yml 12196bbfe8 .travis.yml: fix node LTS to emcompass 4.3 8 rokov pred
API-CHANGES.txt c3eda6a42b 0.16.0 changes. 8 rokov pred
CHANGELOG c3eda6a42b 0.16.0 changes. 8 rokov pred
CONTRIBUTING.md fc4c4b59ef Remove some github urls. 8 rokov pred
CONTRIBUTORS a1482aa142 Contributor list in file not in gh link. 8 rokov pred
Gruntfile.js d60f767ce2 Gruntfile: remove Compiler-Exceptions, forgot in d8c0f3f. 8 rokov pred
LICENSE c07a9a354b Update license with current year. 8 rokov pred
README.md 24f76190e3 README.md: Instruction to install grunt-cli version 0. 8 rokov pred
bower.json 55e4b8f28c Release version 0.16.0 8 rokov pred
config-node.js 276f8d2f8a node-compatibility, polyfilling Promise is node context as well 9 rokov pred
favicon.ico 8b43eb58f1 Add a favicon 11 rokov pred
local.amd.json d8c0f3f3c8 Compiler-* cleanup 9 rokov pred
package.json 55e4b8f28c Release version 0.16.0 8 rokov pred

README.md

Amber

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

Travis CI Status devDependency status Bountysource

Copyright 2011-2015 Nicolas Petton

Copyright 2014-2016 Herbert Vojčík 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.

Try Amber online and learn more on project page.

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 is extendable with libraries, installable preferably via bower:
    • amber-contrib-web with a canvas to generate HTML, like Seaside, included in a new project by default,
    • silk with a stream-like wrapping of DOM elements, included in a new project by default,
    • helios IDE, included in a new project by default,
    • amber-contrib-legacy with smaller in-page "classic" IDE and some miscellany, included in a new project by default,
    • trysmalltalk, containing Prof Stef interactive crash course.
    • and others. You can easily write an Amber library yourself.
  • Amber can use Javascript libraries; the "classic" IDE as well as Helios are built on jQuery
  • You can inline Javascript code and there are many ways to interact between Amber and Javascript

Prerequisities

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

For the installation to work, you need to have installed node, npm and git. Default node installers may install npm as well. To have 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@0 grunt-init bower 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

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.