jacking-nbb
Table of Contents
A cider jack in command for nbb.
Introduction
Nbb is a beatiful parasite. A node script that is an interpreter for Clojurescript. You get the upsides of Node.js + it is Clojure.
Want to try out some npm packages?
Sure, just make a package.json, works instant, is part of the design
principles of nbb.
You get Clojures immutable data structures, polymorphism constructs, a repl, etc.
On the tooling side, you might be surprised how far nbb gets with very little.
Scratching (in space) is very usefull and nbb is a natural fit for a quick cljs repl.
Update 2:
You can jack in Nbb nowadays with
cider-jack-in-cljs then select nbb.
Alternatively, if you have cider
d292d8d7eea5d3a12c138687133761a7256b1705
We can define jack in commands like so:
(defun cider-jack-in-nbb-2 ()
"Start a Cider nREPL server with the `nbb nrepl-server` command."
(interactive)
(cider-jack-in '(:jack-in-cmd "nbb nrepl-server")))
You can also set a project jack-in-cmd in .dir-locals by setting
cider-jack-in-cmd locally.
((nil
(cider-jack-in-cmd . "nbb nrepl-server")))
This is especially useful, if you have an nbb project. You can now
call cider-jack-in-clj without the need to select anything further anymore.
Note: Commands and elisp below are workarounds we do not need anymore because Cider supports Nbb much better since recently!
Update:
This is no longer needed with cider 1.6. There is a dedicated nbb cider build tool now. I still also think my proposal here would be useful.
;; the equivalent of the proposed change
(advice-add
'cider--update-jack-in-cmd
:before-until
(defun cider-dont-update-jack-in-cmd-when-given (params)
(when (plist-get params :jack-in-cmd) params)))
;; now a nbb jack in command becomes:
(cider-jack-in '(:jack-in-cmd "nbb nrepl-server"))
Jack-in command
cider repl workaround
We currently need this workaround for sci-based cljs repls for cider:
(cider-register-cljs-repl-type 'nbb-or-scittle-or-joyride "(+ 1 2 3)")
(defun mm/cider-connected-hook ()
(when (eq 'nbb-or-scittle-or-joyride cider-cljs-repl-type)
(setq-local cider-show-error-buffer nil)
(cider-set-repl-type 'cljs)))
(add-hook 'cider-connected-hook #'mm/cider-connected-hook)
Note: You do not need this workaround in recent versions of cider anymore.
the command
Unfortunately, cider does not have the concept of a nbb repl currently.
I think cider-jack-in-resolve-command and similar functions could be
thrown out and replaced with data.
So I went 1 level deeper to bypass ciders auto-detection of project type (+ jack in cmd):
(defun mm/cider-jack-in-nbb ()
"Start a nbb nrepl process and connect."
(interactive)
(let* ((cider-allow-jack-in-without-project t)
(orig-buffer (current-buffer))
(params '(:jack-in-cmd "nbb nrepl-server :port 0"
:cljs-repl-type nbb-or-scittle-or-joyride))
(params (cider--update-project-dir
params)))
(nrepl-start-server-process
(plist-get params :project-dir)
(plist-get params :jack-in-cmd)
(lambda (server-buffer)
(with-current-buffer
orig-buffer
(cider-connect-sibling-cljs
params
server-buffer))))))
This is what I wanted to say:
(defun mm/cider-jack-in-nbb ()
"Start an nbb nrepl process and connect."
(interactive)
(cider-jack-in-cljs
'(:jack-in-cmd "nbb nrepl-server :port 0"
:cljs-repl-type nbb-or-scittle-or-joyride)))
hack for the remaining issue
With this, you should get an error "ClojureScript is not available…".
Until there is a fix in cider, you can hack it by redefining cider-verify-clojurescript-is-present:
;;; FIXME: https://github.com/clojure-emacs/cider/issues/3255
(defun cider-verify-clojurescript-is-present ()
"Check whether ClojureScript is present."
(unless (nrepl-dict-get (cider-sync-tooling-eval "cljs.core/inc") "value")
(user-error "ClojureScript is not available. See https://docs.cider.mx/cider/basics/clojurescript for details")))
Results
Hehe, insta nbb repl. Works good.