littlesmallscript

A simple Smalltalk to js translator.

Usage no npm install needed!

<script type="module">
  import littlesmallscript from 'https://cdn.skypack.dev/littlesmallscript';
</script>

README

Little Smallscript

Little Smalltalk to Javascript translator.

Author:

Minori Yamashita ympbyc@gmail.com

LICENCE:

MIT

INSTALLATION:

$ git clone https://github.com/ympbyc/LittleSmallscript.git
$ cd LittleSmallscript
$ npm install -g

USAGE:

$ littlesmallscript --help

Direction:

  • The goal is to write Javascript in Smalltalk's syntax.
  • No class browser and stuff.
  • Some expressions are converted to javascripts syntax, for efficiency and readability.
    • "(1 === 1) ifTrue: ['yay']" -> "(1 === 1).ifTrue(function () {return 'yay';})" -> "(1 === 1) ? (function { 'yay'; })() : void 0;"
    • (1 2 3) at: 0 -> [1,2,3].at(0) -> [1,2,3][0]

  • Other message expressions are translated into method calling expression.
    • "obj unary" becomes "obj.unary()". "array inject:1 into:[]" becomes "array.injectinto(1, function () {})".
    • binary messages take js operators as selectors: x % 2 === 0

ToDo:

  • Error messages enhancement
  • Bundle standard methods into compiled js (issue#3)
  • !!!DOCUMENTS!!!
  • ^ syntax

Example:

https://github.com/ympbyc/LittleSmallscript/tree/master/examples

The language is changing every second so do example codes. Here's what works at least for now.

Object subclass:#Animal variables:#(#name)
.
!Animal
setName: aName
  name := aName.
!.
!Animal
move: metre
  window alert: name + ' moved ' + metre + 'm.'
!.
Animal subclass:#Snake variables:#()
.
!Snake
crawl
  window alert: 'Slithering...'.
  self move: 5
!.
Snake new
; setName: 'Sammy the Python'
; crawl

Versions:

16::42 13 Oct 2012

v1.0.1 The last statement in a block can end with a tailing period.

23:00 30 Sep 2012

v1.0.0
The first major version!
Every parser is now written in LittleSmallscript itself.
v1 is not backward compatible with v0.
Syntax for accessing instance variables has changed.
Class definition syntax has been added.

23:00 20 Sep 2012

v0.0.4
Fixed many bugs.
Binary messages now take bare operators instead of primitives.
method:at: and method:dot: fixes the scope of 'self'.

1am 20 Sep 2012

v0.0.3
Ready to ship! Known bugs are to be fixed.
Added optimization.

12pm 12 Sep 2012

v0.0.2
Statement parser is coplete.
Consequently, temporary variable declaration is now supported. | foo bar | compiles to var foo, bar;.
Inline javascript as primary values. obj method: <function () {}>
Binary messages with javascript operators. 1 <+> 1;
Much of Little Smalltalk's built-in methods are provided via the library: prelude.js.
Prettyprint using beautify.js.

5am 10 Sep 2012

v0.0.1
Implemented a PEG parser in javascript.
Can now parse and generate expressions and literals.
Messages are compiled to method calling, blocks are compiled to function literal.
Temporary variable declaration is yet to be supported.