Skip to content

Latest commit

 

History

History
46 lines (34 loc) · 1.51 KB

README.md

File metadata and controls

46 lines (34 loc) · 1.51 KB

clojupyter

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

clojupyter

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.