(rontolisp) docs

nREPL

rontolisp --nrepl は Clojure の REPL を nREPL で 提供します。nREPL はエディタ(CIDER、Calva、Conjure)や clj -M -m nrepl.cmdline --connect が話すプロトコルです。サーバは localhost で待ち受け、--nrepl=PORT で指定しない限り 空いているポートを使います。起動すると nREPL 自身のサーバと同じ行を出力し(エディタは ここからポートを読みます)、作業ディレクトリの .nrepl-port にポートを書きます。この ファイルはサーバの終了時に消えます。deps.edn のエイリアスは REPL と同じく効きます (rontolisp -A:dev --nrepl)。

$ rontolisp --nrepl
nREPL server started on port 41831 on host localhost - nrepl://localhost:41831
$ clj -Sdeps '{:deps {nrepl/nrepl {:mvn/version "1.3.1"}}}' -M -m nrepl.cmdline --connect --port 41831
user=> (defn g [] 1)
#'user/g
user=> (defn f [] (g))
#'user/f
user=> (defn g [] 2)
#'user/g
user=> (f)
2

サーバは、nREPL 1.3 の既定のハンドラが持つ操作のうちエディタが使うものに、nREPL と同じ 形で答えます:

操作応答
clone、close、ls-sessionsセッション
evalフォームごとの値と、その時点の名前空間。*out* と *err* は out と err の応答になる。失敗したフォームは err に報告し、後続のフォームは実行される
load-fileファイルの内容を読み込む。ファイルの名前空間はその読み込みだけのもので、最後の値を返す
interrupt実行中の評価は次の関数呼び出しかループの 1 段で止まり、セッションは続く
completions接頭辞を補完する var、名前空間、特殊形式。- や . で区切った部分ごとに照合する
describe操作とバージョン

セッションは nREPL と同じく 1 つの実行環境を共有します。あるセッションが定義したものを 別のセッションから呼べます。*ns*、*1、*2、*3、*e と、set! で変えるフラグ (*print-length*、*warn-on-reflection*)はセッションごとに持ちます。

答えない操作は、stdin(*in* を読む評価は入力の終わりを読みます)、lookup、 ミドルウェアの操作、cider-nrepl の操作です。エディタはそれぞれの代替手段で動きます。報告の 位置には eval のクラス名が入りません(nREPL が at user/eval1234 (REPL:1) と書くところは at (REPL:1) です)。