Explang JLine REPL

This project provides REPL for Explang with command editing and history capabilities.

Warning: This project is pretty much work in progress. The completion/autosuggestion features still are not really usable.

Dependencies

This plugin depends on

• Explang Core
• Explang Alg Parser
• ANTLR
• JLine3

Installation

Download the Explang JLINE REPL executable JAR jars from Github releases

Or use maven CLI to fetch the artifacts from maven central:

mvn org.apache.maven.plugins:maven-dependency-plugin:2.8:get -Dartifact=io.opsit:opsit-explang-jline-repl:0.0.8:jar:runnable   -Dtransitive=false -Ddest=opsit-explang-jline-repl-0.0.8-runnable.jar

Using REPL

Run the executable jar in a terminal emulator or windows console..

On windows it seems to work better with mintty. than on windows console.

The default parser is alg-parser, Use the -r option to switch parsers.

$ java -jar opsit-explang-jline-repl-0.0.8-runnable.jar
Welcome to the EXPLANG JLine REPL!
Active parser is AlgParser
Loaded packages are: [base.math, base.text, io, base.bindings, ffi, base.funcs, loops, runtime, threads, base.version, base.coercion, base.logic, base.lang, base.arithmetics, base.seq, base.control, base.regex, dwim, base.docs, base.beans, base.types]
Writer is io.opsit.explang.jlinerepl.AlgJlineREPL$1@e720b71
Please type an EXPLANG expressions. 
  Press <Enter> on empty line to submit.
  Press <Ctrl-C> to cancel input.

[0]> println("Hello, world");
Hello, world
##=> Hello, world
[1]> data:= {
             "foo" : "bar",
             "number" : 1
           };
##=> {number=1, foo=bar}
[2]>

REPL Command Line Arguments

• -d -- Enable verbose diagnostics: will print debug messages, parsed AST of expressions and compilation results.
• -p list -- Specify comma separated list of enabled opackages. If not supplied the following packages are enabled:

• base.arithmetics
• base.beans
• base.bindings
• base.coercion
• base.control
• base.docs
• base.funcs
• base.lang
• base.logic
• base.math
• base.regex
• base.seq
• base.text
• base.types
• base.version
• dwim
• ffi
• io
• loops
• threads

• -r parser -- Specify parser. The default is alg, available parsers are:
  • alg -- alg-parser.
  • lisp -- Builtin lisp-like parser
  • sexp -- Builtin S-exps parser
• -f converter -- Specify function name converter. The default is alg , The available converters are: alg -- Case-insenitive converter for alg parser nop -- No Op converter, function lookup will be case-sensitive, the built-in functions are in UPPERCASE. uc -- uppercase converter. function lookup will be case insensitive.
• -h Print help message
• -v Print software version

Key bindings

Gnu readline compatible. See more in the JLine documentation. There are no custom keybindings currently defined.

Completion

Completion support for the alg parser only that is activated on . Very incomplete and not recommented for use.

Language Documentation

• Explang Documentation Site
• Using Explang REPL

Licenses

Explang is licensed under the GNU AFFERO GENERAL PUBLIC LICENSE.