Contributing about closh HOT 2 CLOSED

Hi, thanks, I'm glad you like it.

I actually use primarily clojure main and deps. Boot is only used for compiling and bundling into the final jar file. It is used mostly for historical reasons. If I find a good library that uses clojure main with deps and works well, I would replace Boot.

To start REPL you can run following from the project directory:

clojure -Sdeps "{:deps {nrepl/nrepl {:mvn/version \"RELEASE\"}}}" -m nrepl.cmdline

It will print out nREPL port to which you can connect from your favorite clojure-enabled editor. Then you can require and evaluate namespaces like usual.

I have a global alias for it so I just type clojure -Anrepl.

When you run the bundled jar it runs the rebel frontend. You can run it from sources with clojure -m closh.zero.frontend.rebel. Even simpler frontend is closh.zero.frontend.main which does not have the fancy interactive mode. So you could start there and follow functions top-to-bottom from there to get an idea how things are put together. Another helpful thing might be to look at the unit tests to see how the functions are called and what are their inputs.

The interactive editing is done using rebel-readline which does all the heavy lifting. It internally uses jline library which is written in Java, so it is not so nice to hack on.

For more advanced things like structural editing I keep my eyes on liquid which is a pure clojure text editor implementation. It is very customizable since everything is just function composition, so I think it should be possible to hook it into closh and implement all the editing features one could imagine. It sound like integrating liquid and closh might be an interesting project to you ;)

I am pretty busy preparing for a talk I will give at ClojureD conference at the end of February. But after that I suppose I could reuse some diagrams from it and write down more detailed documentation.

from closh.

Hey thanks for the reply and the links. I didn't even know there are those key bindings (with scroll-able documentation?! ). Okay, I'll take all these info in and tinker with the code and liquid - my gut tells me I can finish it or at least have some progress before for your talk ;)

from closh.