cider.nrepl — cider/cider-nrepl 0.20.0

cider-middleware clj

A vector of all CIDER middleware.

cider-nrepl-handler clj

CIDER's nREPL handler.

def-wrapper clj macro

(def-wrapper name handler-fn & [trigger-it descriptor])

Define delayed middleware (e.g. wrap-xyz). handler-fn is an unquoted name of a function that takes two arguments - handler and message. It is called only when certain conditions are met as expressed by the optional trigger-it argument. trigger-it can be either a function or a set of ops (strings). When a function, it must take a msg and return truthy value when handler-fn should run. When trigger-it is missing, handle-fn is called when :op of msg is one of keys of the :handles slot of the descriptor. When trigger-it is a set it should contain extra ops, besides those in :handles slot, on which handle-fn is triggered. descriptor is passed directly to the nREPLs set-descriptor!.

delayed-handlers clj

Map of delays holding deferred middleware handlers.

ops-that-can-eval clj

Set of nREPL ops that can lead to code being evaluated.

require-lock clj

Lock used to inhibit concurrent require of the middleware namespaces. Clojure seem to have issues with concurrent loading of transitive dependencies. The issue is extremely hard to reproduce. For the context see https://github.com/clojure-emacs/cider/issues/2092 and https://github.com/clojure-emacs/cider/pull/2078.

run-deferred-handler clj macro

(run-deferred-handler fn-name handler msg)

Make a delay out of fn-name and place it in delayed-handlers atom at compile time. Require and invoke the delay at run-time with arguments handler and msg. fn-name must be a namespaced symbol (unquoted).

wrap-apropos clj

(wrap-apropos h)

Middleware that handles apropos requests

wrap-classpath clj

(wrap-classpath h)

Middleware that provides the java classpath.

wrap-complete clj

(wrap-complete h)

Middleware providing completion support.

wrap-content-type clj

(wrap-content-type h)

Middleware that adds content-type annotations to the result of the the eval op.

wrap-debug clj

(wrap-debug h)

Provide instrumentation and debugging functionality.

wrap-enlighten clj

(wrap-enlighten h)

wrap-format clj

(wrap-format h)

Middleware providing support for formatting Clojure code and EDN data.

wrap-info clj

(wrap-info h)

wrap-inspect clj

(wrap-inspect h)

Add a value inspector option to the eval op. Passing a non-nil value in the :inspect slot will cause the last value returned by eval to be inspected. Returns a string representation of the resulting inspector's state in the :value slot.

wrap-macroexpand clj

(wrap-macroexpand h)

Macroexpansion middleware.

wrap-ns clj

(wrap-ns h)

Provide ns listing and browsing functionality.

wrap-out clj

(wrap-out h)

wrap-pprint-fn clj

(wrap-pprint-fn h)

Middleware that provides a common interface for other middlewares that need to perform customisable pretty-printing.

A namespace-qualified name of the function to be used for printing can be optionally passed in the :pprint-fn slot, the default value being cider.nrepl.pprint/pprint. The function name can be passed as a string or symbol. Note that function should take 1 or two params - the object to print and the an optional map of print params. The params should be passed as :print-options - a map of key/value params.

The :pprint-fn slot will be replaced with the var that maps to the name that was initially passed.

Middlewares further down the stack can then look up the :pprint-fn slot, call it where necessary, and pass it the value of the :print-options slot.

wrap-pprint-fn-optional-arguments clj

Common pprint arguments for CIDER's middleware.

wrap-profile clj

(wrap-profile h)

Middleware that provides supports Profiling based on https://github.com/thunknyc/profile

wrap-refresh clj

(wrap-refresh h)

Refresh middleware.

wrap-resource clj

(wrap-resource h)

Middleware that provides the path to resource.

wrap-slurp clj

(wrap-slurp h)

Middleware that handles slurp requests.

wrap-spec clj

(wrap-spec h)

Middleware that provides clojure.spec browsing functionality.

wrap-stacktrace clj

(wrap-stacktrace h)

Middleware that handles stacktrace requests, sending cause and stack frame info for the most recent exception.

wrap-test clj

(wrap-test h)

Middleware that handles testing requests.

wrap-trace clj

(wrap-trace h)

Toggle tracing of a given var.

wrap-tracker clj

(wrap-tracker h)

Enhances the eval op by notifying the client of the current REPL state. Currently, only the REPL type (Clojure or ClojureScript) is informed.

wrap-undef clj

(wrap-undef h)

Middleware to undefine a symbol in a namespace.

wrap-version clj

(wrap-version h)

Provides CIDER-nREPL version information.