dirac.runtime.repl — binaryage/dirac 1.2.36

*bootstrapped?* cljs

*installed?* cljs

api-version cljs

available? cljs

(available?)

bootstrapped? cljs

(bootstrapped?)

call-dirac cljs

(call-dirac name & args)

capture-output cljs

(capture-output job-id f)

This printing wrapper is responsible for capturing printed output and presenting it via present-output.

console-tunnel cljs

(console-tunnel method & args)

detect-and-strip cljs

(detect-and-strip prefix text)

dirac-log-args cljs

(dirac-log-args request-id kind args)

dirac-msg-args cljs

(dirac-msg-args name args)

emit-error! cljs

(emit-error! request-id message)

emit-warning! cljs

(emit-warning! request-id message)

error cljs

(error request-id kind & args)

eval cljs

(eval job-id eval-mode wrap-mode job-fn)

This is the main entrypoint for evaluation of a snippet of code in the context of REPL. Please note that this code runs in the context of the app and uses ClojureScript runtime built together with the app.

job-id - a numeric id of the REPL job eval-mode - 'captured' or 'special' wrap-mode - 'short-circuit-presentation' or nil job-fn - code to be executed in the form of a function

Note that normally we want to support capturing REPL specials *1 *2 *3 and *e. Only when we are executing their retrieval we don't want to capture them and we want to use the 'special' path.

Also normally we want to wrap our code in a supporting wrapper which will present results directly via cljs-devtools, or present exceptions in a friendly way. Also we want to capture any printing which might occur during evaluation. In some special cases we might not want to do that.

Finally we want to postprocess evaluation result and prepare Weasel's nREPL response.

See https://github.com/binaryage/dirac/blob/master/docs/about-repls.md for conceptual overview.

eval-captured cljs

(eval-captured job-id wrap-mode job-fn)

Evaluates a REPL job in the captured mode. Compare it to eval-special. Captured mode keeps track of *1 *2 *3 and *e REPL specials.

eval-special cljs

(eval-special job-id wrap-mode job-fn)

Evaluates a REPL job in the special mode. Compare it to eval-captured.

execute-job cljs

(execute-job job-id wrap-mode job-fn)

Execute a REPL job by optionally wrapping it in a requested wrapper.

formatted-log cljs

(formatted-log request-id kind format text)

get-api-version cljs

(get-api-version)

get-effective-config cljs

(get-effective-config)

get-serialized-config cljs

(get-serialized-config)

get-whitespace-prefix-length cljs

(get-whitespace-prefix-length line)

group cljs

(group & args)

group* cljs

(group* collapsed? request-id kind & args)

group-collapsed cljs

(group-collapsed & args)

group-end cljs

(group-end)

install! cljs

(install!)

installed? cljs

(installed?)

log cljs

(log request-id kind & args)

postprocess-successful-eval cljs

(postprocess-successful-eval value)

This is a postprocessing function wrapping Weasel's Javascript evaluation attempt. This structure is needed for building response to nREPL server (see dirac.implant.weasel in Dirac project) In our case weasel is running in the context of Dirac DevTools and could potentially have different version of cljs runtime. To be correct we have to do this post-processing in app's context to use the same cljs runtime as app evaluating the code.

Also we have to be careful to not enter into infinite printing with cyclic data structures. We limit printing level and length via with-safe-printing.

postprocess-unsuccessful-eval cljs

(postprocess-unsuccessful-eval ex)

present cljs

(present job-id job-fn)

A presentation wrapper which takes care of presenting REPL evaluation to Dirac user. We short-circuit nREPL feedback mechanism and display REPL results immediately to the user as native data. This is especially important for cljs-devtools.

Please note that for traditional nREPL clients we still serialize the result, send it over the wire to nREPL server and in turn that result is sent back to clients and presented. The Dirac client has just some special logic and ignores this echoed output because it was already presented directly.

See https://github.com/binaryage/dirac/blob/master/docs/about-repls.md for conceptual overview.

present-java-trace cljs

(present-java-trace request-id text)

present-output cljs

(present-output request-id kind format text)

present-repl-exception cljs

(present-repl-exception request-id exception)

Called by our nREPL boilerplate when we capture a REPL evaluation exception.

present-repl-result cljs

(present-repl-result request-id value)

Called by our nREPL boilerplate when we capture a REPL evaluation result.

remove-common-whitespace-prefix cljs

(remove-common-whitespace-prefix text)

request-eval-cljs cljs

(request-eval-cljs code)

Automates Dirac REPL from the app. This way you can request evaluation of ClojureScript code as it would be entered directly by the user.

request-eval-js cljs

(request-eval-js code)

Automates Dirac REPL from the app. This way you can request evaluation of Javascript code as it would be entered directly by the user.

safe-pr-str cljs

(safe-pr-str v)

should-silence-error? cljs

(should-silence-error? _message)

should-silence-warning? cljs

(should-silence-warning? message)

uninstall! cljs

(uninstall!)

warn cljs

(warn request-id kind & args)

with-safe-printing cljs

(with-safe-printing f)