clojupyter

A Jupyter kernel for Clojure. This will let you run Clojure code from the Jupyter console and notebook.

installation

1. git clone https://github.com/roryk/clojupyter
2. cd clojupyter
3. make
4. make install

This will install a clojupyter executable and a configuration file to tell Jupyter how to use it in ~/.ipython/kernels/clojure.

run the REPL with:

jupyter-console --kernel=clojure

or the notebook with:

jupyter-notebook

and select the Clojure kernel.

Removing the stale OSX kernel cache

Recently clojupyter was renamed from ipython-clojure because clojupyter is more accurate and, more importantly, sounds cooler. OSX caches the kernels you choose in $USER/Library/jupyter/kernels, so it will look for ipython-clojure even if you've installed the new version. Remove the clojure directory in there and it will pick up the clojupyter executable instead if you're having some troubles after installing.

###To Do:

• Shut down cleanly.
• Do syntax checking. It currently returns nil on unbalanced form. Borrow cider-nrepl middleware for this.
• Allow controls from Jupyter, including timeout and what classes of stack frames to show.
• Test (implement?) interrupt handling. Default middleware for interruptible-eval is loaded.
• Implement file load. Use cider-nrepl middleware.

Collaboration

If you submit a pull request that ends up getting merged, we will give you commit access.