# mquickjs-hs
This package provides a Haskell wrapper for the [Micro QuickJS](https://github.com/bellard/mquickjs) JavaScript Engine.
It has been inspired by the [quickjs-rs](https://github.com/theduke/quickjs-rs)
and [ocaml-quickjs](https://github.com/dhcmrlchtdj/ocaml-quickjs) libraries.
## Features
The functionality is quite basic and is currently limited to:
- Evaluating JS code
- Calling a JS function in the global scope
- Marshalling [Aeson Values](https://hackage.haskell.org/package/aeson-1.5.3.0/docs/Data-Aeson.html#t:Value)
to and from JSValues.
## Examples
Evaluate an expression:
```hs
import MQuickJS
one_plus_two = mquickjs $ do
res <- eval "1+2"
liftIO $ print res
```
Declare a function and call it on an argument:
```hs
call_f = mquickjs $ do
_ <- eval_ "function f(x) { return x + 1; }"
res <- eval "f(2)"
liftIO $ print res
```
Pass a Haskell value
(which has a [ToJSON](https://hackage.haskell.org/package/aeson-1.5.3.0/docs/Data-Aeson.html#t:ToJSON) instance)
to the JS runtime:
```hs
aeson_marshall = mquickjs $ do
_ <- eval_ "function f(x) { return x + 1; }"
res <- withJSValue (3::Int) $ \x -> call "f" [x]
liftIO $ print res
```
## Contributing
Please feel free to report bugs/submit feature requests via the
[github issue tracker](https://github.com/ad-si/mquickjs-hs/issues)
and submit any pull requests to the
[git repository](https://github.com/ad-si/mquickjs-hs/).