A tool to generate HTML code from Elm source in the terminal using QuickJS.
Requirements
- depends only on elm compiler, quickjs cli and a posix shell
- do not alter elm compiler
- do not alter quickjs cli
- do not patch elm compiler output
- provide acceptable performances (500ms for a big script)
Design
QuickJS (Qjs) is a JavaScript runtime, similar to V8 or SpiderMonkey, but lighter and faster.
As any runtime, Qjs can interpret JavaScript code, but it is not a web browser. It has no concept of an HTML document.
To bridge this gap, we add a minimal DOM implementation.
Next, we concatenate this with the Elm JavaScript output and an app launcher snippet, then ask Qjs to interpret all of it.
Limitations
- No event loop
- Hence, no TEA; the
mainfunction must return a static view - Hence, no Time, no Random, no Json Encoder/Decoder (!), no Http
- Nodes can only have one parent (this should always be the case)
Usage
- Clone this repository and navigate into your local copy
- Run
elm init. - Create
src/Hello.elmwith the following content:
module Hello exposing(main)
import Html exposing (p, text)
main = p [] [text "Hello World!"]
- Run
./build.sh src/Hello.elm; this generates the corresponding HTML code:
<p>
Hello World!
</p>
Performances
Acceptable for small scripts : 250ms on a modest x86_64 CPU and 64MB RAM for a 500 records into a table ; but is does not scale well as everything is loaded before processing ; no streaming contrary to the usual Unix way.
Prior Work
There are more complete tools for generating static sites with Elm:
You should probably consider using one of them instead of this one. :)