An interactive console for the Lapis web framework.

-- app.moon
lapis = require "lapis"
console = require "lapis.console"

class extends lapis.Application
  "/console": console.make!

$ lapis server development

Hit http://localhost:8080/console

Tips

Each command executes on the server. The print function has been overwritten to print to the browser. It has also been enhanced, you can print tables and get an interactive version that you can open and close in the browser. Just click on the bold { ... } to open the table up.

Any values returned by the code are shown in the result. MoonScript returns the value of the last expression, so you can type an expression like User\find 1 without wrapping it in print. In Lua mode, use return.

Any SQL queries that take place when running the code you submit will also be captured and printed as part of the result, along with how long they took when measure_performance is enabled in your config.

If the code raises an error, anything printed before the error is still shown, along with the stack traceback.

The input field is a full multi-line text editor. You can write an entire program in it. Run it with Ctrl+Enter (Cmd+Enter on macOS).

Each result shows the code that produced it, click it to load that code back into the editor. Previous runs can also be browsed by pressing up on the first line of the editor, and down on the last line, like a browser's developer console. History is kept for the browser tab's session.

The code that runs is not restricted in any way. If you run while true it will run forever. If someone malicious gets access to it then they can do damage to you system.

Code can be written in MoonScript or Lua, selectable from the dropdown next to the buttons.

The console is only accessible in the "development" environment. It will return a 404 if accessed in any other environment. You can bypass this protection by passing {env = "all"} to console.make.

Building

The frontend lives in src/ and is bundled with esbuild. The bundled JavaScript and CSS are written out as Lua modules in lapis/console/assets/ so they can be embedded directly into the page. The generated .lua files are committed so the rock can be installed without Node.

$ npm install
$ make build   # bundle assets and compile MoonScript
$ make local   # install the rock locally with LuaRocks
$ make test    # run the specs with busted

Contact

Author: Leaf Corcoran (leafo) (@moonscript)
Email: leafot@gmail.com
Homepage: https://leafo.net
License: MIT

License

Lapis Console bundles CodeMirror (MIT), Copyright (C) by Marijn Haverbeke and others.