From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 7 Apr 2024 13:41:34 -0500 Subject: new repository --- devdocs/elisp/process_002dbased-jsonrpc-connections.html | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 devdocs/elisp/process_002dbased-jsonrpc-connections.html (limited to 'devdocs/elisp/process_002dbased-jsonrpc-connections.html') diff --git a/devdocs/elisp/process_002dbased-jsonrpc-connections.html b/devdocs/elisp/process_002dbased-jsonrpc-connections.html new file mode 100644 index 00000000..f8d88d40 --- /dev/null +++ b/devdocs/elisp/process_002dbased-jsonrpc-connections.html @@ -0,0 +1,7 @@ +

Process-based JSONRPC connections

For convenience, the jsonrpc library comes with a built-in jsonrpc-process-connection transport implementation that can talk to local subprocesses (using the standard input and standard output); or TCP hosts (using sockets); or any other remote endpoint that Emacs’s process object can represent (see Processes).

Using this transport, the JSONRPC messages are encoded on the wire as plain text and prefaced by some basic HTTP-style enveloping headers, such as “Content-Length”.

For an example of an application using this transport scheme on top of JSONRPC, see the Language Server Protocol.

Along with the mandatory :request-dispatcher and :notification-dispatcher initargs, users of the jsonrpc-process-connection class should pass the following initargs as keyword-value pairs to make-instance:

:process
+

Value must be a live process object or a function of no arguments producing one such object. If passed a process object, the object is expected to contain a pre-established connection; otherwise, the function is called immediately after the object is made.

:on-shutdown

Value must be a function of a single argument, the jsonrpc-process-connection object. The function is called after the underlying process object has been deleted (either deliberately by jsonrpc-shutdown, or unexpectedly, because of some external cause).

+

+ Copyright © 1990-1996, 1998-2022 Free Software Foundation, Inc.
Licensed under the GNU GPL license.
+ https://www.gnu.org/software/emacs/manual/html_node/elisp/Process_002dbased-JSONRPC-connections.html +

+
-- cgit v1.2.3