cider.nrepl — cider/cider-nrepl 0.27.0-SNAPSHOT

Middleware descriptors and related utility functions.

While normally middleware descriptors live alongside middleware definitions, cider-nrepl separates those. The rationale behind this is to avoid loading each middleware definition until its first usage. For this purpose we're defining each middleware as a wrapper that defers the loading of the actual middleware.

cider-middleware clj

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)

Require and invoke the handler 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-clojuredocs clj

(wrap-clojuredocs h)

Middleware to find a documents from ClojureDocs.

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-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.

wrap-xref clj

(wrap-xref h)

Middleware that provides find references functionality.