BiwaScheme

BiwaScheme is a Scheme interpreter written in JavaScript.

Works with web browsers (including mobile devices) and Node.js.

Demos

Download

http://www.biwascheme.org/release/biwascheme-min.js (release version)

How to use

Just load biwascheme.js (or biwascheme-min.js) and write Scheme code.

<!DOCTYPE html>
<html>
<body>

<div id="bs-console"></div>

<script src="biwascheme.js">
(display "hello, world!")
</script>

</body>
</html>

How to use with node.js to run a biwa script

$ npm install biwascheme
create a file a.scm:

(display "Hello, world!") (newline)
$ biwas a.scm

How to use from inside node.js as a module

$ npm install biwascheme
create a file server.js:

var BiwaScheme = require("biwascheme"); BiwaScheme.run("(+ 1 2)"); // or // BiwaScheme.run_file("a.scm");
$ node server.js

Files

release/
- the following files are generated here with $ make
  - biwascheme.js
  - biwascheme-min.js
  - node_biwascheme.js
demo/
- Demos
src/
- deps/
  - Dependencies (jQuery, underscore)
- system/
  - Source code of the interpreter
- library/
  - Built-in library functions
- platform/
  - Platform dependent code (browser, node, etc.)
test/
- Unit tests
tuplespace/
- (experimental) TupleSpace implemented in Scheme
web/
- HTMLs and CSS of www.biwascheme.org
www.biwascheme.org.js
- web server

Building biwascheme.js

Prerequisites:

make
sed
node (Node.js)
uglifyjs ($ npm install uglify-js -g)

Make compiles src/*.js into release/biwascheme.js.

$ make

Development memos

How to add a new file

edit Makefile
edit src/development_loader.js

How to release

(moved to doc/dev/release.md)

How to upgrade dependencies

jQuery:

update src/deps/jquery.js

underscore:

update src/deps/underscore.js
update node_modules/biwascheme/package.json

underscore.string:

update src/deps/underscore.string.js
update node_modules/biwascheme/package.json

Website

repo: biwascheme/biwascheme.github.io.

Run local website

You can run the website locally with Node and express.

$ make
$ npm install
$ node local_website.js
$ open http://localhost:7001

License

MIT-LICENSE

BiwaScheme logo by @jcubic: Creative Commons Attribution 3.0

Acknowledgements

Kent Dyvbig, Three implementation models for scheme
- http://www.cs.indiana.edu/~dyb/pubs/3imp.pdf
jsScheme
- http://alex.ability.ru/scheme.html (inavailable)
ExplorerCanvas (demo/excanvas.js)
- http://excanvas.sourceforge.net/

Contact

https://github.com/biwascheme/biwascheme

Yutaka HARA (yhara) yutaka.hara.gmail.com http://twitter.com/yhara_en

digideskio / biwascheme Goto Github PK

biwascheme's Introduction