CLI and REPL for Liyad (Lisp yet another DSL interpreter).
- Node >= 10
$ npm install -g liyad-cli
$ liyad --version
Usage: liyad [options] [ -- ] [ -e script | script.lisp | - ] [ -- ] [arguments]
liyad [options]
Options:
- script read from stdin (default; interactive mode if a tty)
-- indicate the end of CLI options / script files
-p, --profile=... select interpreter profile
S S-expression parser
L, lisp (default) lisp interpreter (return single value)
LM lisp interpreter (return multiple values)
L_async, lisp_async lisp interpreter (return single value, enable async)
LM_async lisp interpreter (return multiple values, enable async)
LSX lisp interpreter (return single value, enable LSX)
LSX_async lisp interpreter (return single value, enable LSX, enable async)
--lsx-boot lsxboot.js LSX bootstrap JavaScript file; required if profile LSX or LSX_async is selected.
--safe run as safe mode (disable '$require' and '$node-require')
-e, --eval=... evaluate script
-i, --interactive always enter the REPL even if stdin does not appear to be a terminal
-h, --help print command line options
-v, --version print version informations
--cli-version print cli version informations
lsxboot.js
const React = require('react');
const ReactDOMServer = require('react-dom/server');
class Hello extends React.Component {
render() {
return (React.createElement("div", {}, "hello"));
}
}
exports.dom = React.createElement;
exports.flagment = React.Fragment;
exports.render = ReactDOMServer.renderToStaticMarkup;
exports.components = {
Hello,
};
Use pkg.
$ npm install -g pkg
$ git clone https://github.com/shellyln/liyad-cli.git
$ cd liyad-cli
$ npm ci
$ pkg . --output liyad
$ ./liyad --version
See liyad-lisp-pkg-example and liyad-webapp-example
$ npm install -g liyad-cli
$ mkdir myapp
$ cd myapp
$ npm install liyad-lisp-pkg-example
$ vi app.lisp
app.lisp
($let ex ($require "liyad-lisp-pkg-example"))
;; Benchmarks
($console-log (::ex:tarai 12 6 0))
($console-log (::ex:fib 10))
($console-log (::ex:fac 10))
;; Run the web server on port 3000.
($let url ($node-require "url"))
(::ex:#get "/" (-> (req res)
($let u (::url:parse ::req:url))
(::res@writeHead 200 (# (Content-Type "text/html")))
(::res@end ($concat "hit / ," ::req:method "," ::u:path)) ) )
(::ex:serve 3000) ($last "start server")
$ liyad app.lisp
12
55
3628800
start server
($exit [ code ])
- Exit the process.
- returns: never.
code
: exit code.
($shell command)
- Run command.
- returns: command output (stdout) string.
command
: command and arguments.- example:
($shell "ls -al")
- example:
($shell-async command)
- Run command asynchronously.
- returns: Promise object resolving command output (stdout) string.
command
: command and arguments.- example:
($shell-async "ls -al")
- example:
($require id [ profile ])
- Load lisp code from other file.
- returns: Exported functions and variables.
id
: Load from relative path ifid
starts with./
or../
. Otherwise load from local or globalnode_modules
.profile
: (optional) interpreter profile (S/L/lisp/LM/L_async/lisp_async/LM_async).- default value is selected by CLI option
-p
or--profile
.
- default value is selected by CLI option
($node-require id)
- Load JavaScript code from other file.
- returns: Exported functions and variables.
id
: Load from relative path ifid
starts with./
or../
. Otherwise load from local or globalnode_modules
.
($render jsxElement callback)
- Render jsxElement by
LSX-bootstrap.render()
and pass rendering result string or error tocallback
. - returns:
undefined
jsxElement
: object returned byLSX-bootstrap.dom()
.callback(error, html)
: callback function called on end of renderingjsxElement
.error
: not null if error is occured.html
: rendering result html; null if error is occured.
- Render jsxElement by
($pause [ cond ])
- Pause execution and start debugger
- returns:
undefined
cond
: if it present, pause if condition istrue
.
parseArgs(args)
- Parse CLI arguments.
- returns: config object.
args
: CLI arguments.
- example:
parseArgs(['-p', 'LSX_async', '--lsx-boot', 'lsxboot.js', 'app.lisp'])
cliCore(curDir, params)
- Evaluate codes.
- returns:
undefined
curDir
: current directory.params
: config object.
- example:
cliCore(fs.realpathSync(process.cwd()), parseArgs(process.argv.slice(2)))
cli()
- Run CLI.
- returns:
undefined
ISC
Copyright (c) 2018, Shellyl_N and Authors.