Lace is a clojure environment forked from https://github.com/candid82/joker and embued with enhanced powers, such as:

• A Bytecode VM to speed up interpretation
• Extensive interact with Go types
• Detailed stacktraces that can alternate between clojure code and Go code

For now, build it via go install.

lace - launch REPL

lace <filename> - execute a script. Lace uses .clj filename extension. For example: lace foo.clj. Normally exits after executing the script, unless --exit-to-repl is specified before --file <filename> in which case drops into the REPL after the script is (successfully) executed. (Note use of --file in this case, to ensure <filename> is not treated as a <socket> specification for the repl.)

lace - - execute a script on standard input (os.Stdin).

Lace is designed to be a dynamic glue language for Go packages. It leans fully into Greenspun's 10th rule:

Any sufficiently complicated C or Fortran program contains an ad hoc, informally-specified, bug-ridden, slow implementation of half of Common Lisp.

In this case, we're picking Clojure rather than Common Lisp because it's the most commonly used lisp today.

The project began by forking Joker and beginning to add extensive reflection capabilities to allow clojure code to interact with Go types and code.

1. Primitive types are different due to a different host language and desire to simplify things. Scripting doesn't normally require all the integer and float types, for example. Here is a list of Lace's primitive types:

Note that Nil is a type that has one value nil.

1. The set of persistent data structures is much smaller:

1. The following features are not implemented: protocols, records, structmaps, chunked seqs, transients, tagged literals, unchecked arithmetics, primitive arrays, custom data readers, transducers, validators and watch functions for vars and atoms, hierarchies, sorted maps and sets.
2. Unrelated to the features listed above, the following function from clojure.core namespace are not currently implemented but will probably be implemented in some form in the future: subseq, iterator-seq, reduced?, reduced, mix-collection-hash, definline, re-groups, hash-ordered-coll, enumeration-seq, compare-and-set!, rationalize, load-reader, find-keyword, comparator, resultset-seq, file-seq, sorted?, ensure-reduced, rsubseq, pr-on, seque, alter-var-root, hash-unordered-coll, re-matcher, unreduced.
3. Built-in namespaces have lace prefix. The core namespace is called lace.core. Other built-in namespaces include lace.string, lace.json, lace.os, lace.base64 etc. See standard library reference for details.
4. Miscellaneous:

• case is just a syntactic sugar on top of condp and doesn't require options to be constants. It scans all the options sequentially.
• slurp only takes one argument - a filename (string). No options are supported.
• ifn? is called callable?
• Map entry is represented as a two-element vector.
• resolving unbound var returns nil, not the value Unbound. You can still check if the var is bound with bound? function.

• Dashes (-) in namespaces are not converted to underscores (_) by Lace, so (unlike with Clojure) there's no need to name .clj files accordingly.
• Avoid :refer :all and the use function, as that reduces the effectiveness of linting.

Copyright (c) Evan PHoenix. All rights reserved.
Copyright (c) Roman Bataev (from Joker). All rights reserved.
The use and distribution terms for this software are covered by the
Eclipse Public License 1.0 (https://opensource.org/licenses/eclipse-1.0.php)
which can be found in the LICENSE file.

Lace contains parts of Clojure source code (from clojure.core namespace). Clojure is licensed as follows:

Copyright (c) Rich Hickey. All rights reserved.
The use and distribution terms for this software are covered by the
Eclipse Public License 1.0 (https://opensource.org/licenses/eclipse-1.0.php)
which can be found in the file epl-v10.html at the root of this distribution.
By using this software in any fashion, you are agreeing to be bound by
the terms of this license.
You must not remove this notice, or any other, from this software.