Node.js ClojureScript runtime (nbb)

nbb is a ClojureScript runtime that runs on Node.js for doing ad-hoc scripting.

You can import and use Node libraries and internals like this:

(ns example
  (:require ["csv-parse/sync" :as csv]
            ["fs" :as fs]
            ["path" :as path]
            ["shelljs$default" :as sh]
            ["term-size$default" :as term-size]
            ["zx" :refer [$]]
            ["zx$fs" :as zxfs]
            [nbb.core :refer [*file*]]))

(prn (path/resolve "."))

(prn (term-size))

(println (count (str (fs/readFileSync *file*))))

(prn (sh/ls "."))

(prn (csv/parse "foo,bar"))

(prn (zxfs/existsSync *file*))

($ #js ["ls"])

The Reagent library is available with [reagent.core :as r] and you can render hiccup to HTML using e.g. r/render-to-static-markup.

The promesa library is available with [promesa.core :as p].

The js-interop library is available with [applied-science.js-interop :as j].

The Clojure tools.cli library is also available if you need to write command line utilities and display usage etc.

You can use js/fetch to access JavaScript's native fetch function.

To access datastructures returned by native JS calls (like js/fetch) you will need to use aget or j/get rather than get.

A basic main file:

(ns example
  (:require
    [nbb.core :refer [*file* invoked-file]]))

(defn main [args]
  ; ... do something
  )

(when (= *file* (invoked-file))
  (main (j/get process :argv)))