An enhanced interactive Shell for Common Lisp (based on the Jupyter protocol)
cl-jupyter: an enhanced interactive Common Lisp Shell (Version 0.7 - Ipython protocol v.5.0) --> (C) 2014-2015 Frederic Peschanski (cf. LICENSE) __________ / /. .-----------------. /_________/ | / / | | | | /+================+\ | | |====| | | ||cl-jupyter || | | | | || || | | |====| | | ||* (fact 5) || | | | | ||120 || | | ___ | | || || | | |166| | | || ||/@@@ | --- | | \+================+/ @ |_________|./. @ .. ....' ..................@ __.'. ' '' /oooooooooooooooo// /// /................// /_/ ------------------
Important : this is beta-quality software, expect (and please report) some bugs...
To try cl-jupyter you need :
a Common lisp implementation, for now
either SBCL 1.2.x or above (with native threads enabled)
or Clozure CL 1.10 or above (with native threads enabled) ...
ECL is planned, for other implementations please fill an issue.
Quicklisp (cf. http://www.quicklisp.org)
Python 3.x (cf. http://www.python.org)
Jupyter (a.k.a. IPython 4.x) or IPython 3.x (cf. http://www.jupyter.org)
Please run the installation script :
By default, cl-jupyter assumes SBCL as the default lisp implementation. Using CCL instead requires the following command line:
python3 ./install-cl-jupyter.py --lisp=ccl
Note: cl-jupyter seems to work better with CCL on MacOS but on Linux everything's fine with SBCL and it is the most tested configuration. Alas, it seems cl-jupyter does not work on Windows (I cannot try myself). If using a VM I would recommend the Linux/SBCL configuration.
As an optional step, you can pre-install the quicklisp dependencies to avoid a veeeerrrry long first startup.
sbcl --load ./cl-jupyter.lisp
ccl --load ./cl-jupyter.lisp
The console mode is a simple REPL that is useful to check that cl-jupyter is working.
jupyter console --kernel=lisp
for IPython 3.x
ipython3 console --kernel=lisp
The real interest of cl-jupyter is its use conjointly with the Jupyter notebook frontend. For a try, type:
for IPython 3.x
The file about-cl-jupyter.ipynb is an example of a Lisp-based notebook.
The file about-cl-jupyter.pdf is a printable PDF version of this notebook that can be generated by the Jupyter
... have fun !