EchoJS - an ahead of time compiler and runtime for EcmaScript
Things only build reliably on OSX. I have easy access to other platforms, I just haven't had the time/motivation to do it given OSX is what I have in front of me every hour of every day, and ios development is my biggest goal. Patches welcome!
You'll need a couple of external dependencies to get things running:
- llvm 3.6
The following commands should get you from 0 (well, Homebrew and Xcode) to echo-js built:
$ brew install node $ brew install llvm $ export PATH=/usr/local/opt/llvm/bin:$PATH $ npm install $ npm install -g node-gyp firstname.lastname@example.org $ export MIN_OSX_VERSION=10.8 # only if you're running 10.8, see below $ export IOS_SDK_VERSION=9.3 # or whatever is installed $ export LLVM_SUFFIX= # if installed llvm via homebrew, see below $ git submodule init $ git submodule update $ make
The environment variable
LLVM_SUFFIX can be set and its value will be appended to the names of all llvm executables (e.g.
llvm-config-3.6 instead of
llvm-config.) The default is
-3.6. Change this if you have a different build of
llvm you want to use. Homebrew installs llvm 3.6 executables without the suffix, thus
MIN_OSX_VERSION: homebrew's formula for llvm (3.4, at least. haven't verified with 3.6) doesn't specify a
-mmacosx-version-min= flag, so it builds to whatever you have on your machine. Node.js's gyp support in node-gyp, however, does put a
-mmacosx-version-min=10.5 flag. A mismatch here causes the node-llvm binding to allocate llvm types using incorrect size calculations, and causes all manner of memory corruption. If you're either running 10.5 or 10.9, you can leave the variable unset. Otherwise, set it to the version of OSX you're running. Hopefully some discussion with the homebrew folks will get this fixed upstream.
both of these variable assignments can be placed in
I was a PL geek in college, which is pretty much a lifetime ago.
I'd never written a compiler myself, nor played with LLVM, both of which I now can quite confidently say are a blast.
I want to play around with what is essentially profile guided optimization, but with runtime type information. So you get a partially specialized (at least as much as the static compilation can give you) implementation, which then records type information at runtime. You feed this back into the compiler and get a more heavily specialized version.
Echo wouldn't be as far along as it is now (and certainly wouldn't be as fun to work on) if not for the following: