1
0
Fork 0
mirror of synced 2024-12-27 00:53:20 -05:00
ultimate-vim/sources_non_forked/slimv/slime/slime.el

7658 lines
285 KiB
EmacsLisp
Raw Normal View History

;;; slime.el --- Superior Lisp Interaction Mode for Emacs -*-lexical-binding:t-*-
;; URL: https://github.com/slime/slime
;; Package-Requires: ((cl-lib "0.5") (macrostep "0.9"))
;; Keywords: languages, lisp, slime
;; Version: 2.26
;;;; License and Commentary
;; Copyright (C) 2003 Eric Marsden, Luke Gorrie, Helmut Eller
;; Copyright (C) 2004,2005,2006 Luke Gorrie, Helmut Eller
;; Copyright (C) 2007,2008,2009 Helmut Eller, Tobias C. Rittweiler
;;
;; For a detailed list of contributors, see the manual.
;;
;; This program is free software; you can redistribute it and/or
;; modify it under the terms of the GNU General Public License as
;; published by the Free Software Foundation; either version 2 of
;; the License, or (at your option) any later version.
;;
;; This program is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
;; GNU General Public License for more details.
;;
;; You should have received a copy of the GNU General Public
;; License along with this program; if not, write to the Free
;; Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
;; MA 02111-1307, USA.
;;; Commentary:
;; SLIME is the ``Superior Lisp Interaction Mode for Emacs.''
;;
;; SLIME extends Emacs with support for interactive programming in
;; Common Lisp. The features are centered around slime-mode, an Emacs
;; minor-mode that complements the standard lisp-mode. While lisp-mode
;; supports editing Lisp source files, slime-mode adds support for
;; interacting with a running Common Lisp process for compilation,
;; debugging, documentation lookup, and so on.
;;
;; The slime-mode programming environment follows the example of
;; Emacs's native Emacs Lisp environment. We have also included good
;; ideas from similar systems (such as ILISP) and some new ideas of
;; our own.
;;
;; SLIME is constructed from two parts: a user-interface written in
;; Emacs Lisp, and a supporting server program written in Common
;; Lisp. The two sides are connected together with a socket and
;; communicate using an RPC-like protocol.
;;
;; The Lisp server is primarily written in portable Common Lisp. The
;; required implementation-specific functionality is specified by a
;; well-defined interface and implemented separately for each Lisp
;; implementation. This makes SLIME readily portable.
;;; Code:
;;;; Dependencies and setup
(eval-and-compile
(require 'cl-lib nil t)
;; For emacs 23, look for bundled version
(require 'cl-lib "lib/cl-lib"))
(eval-when-compile (require 'cl)) ; defsetf, lexical-let
(eval-and-compile
(if (< emacs-major-version 23)
(error "Slime requires an Emacs version of 23, or above")))
(require 'hyperspec "lib/hyperspec")
(require 'thingatpt)
(require 'comint)
(require 'pp)
(require 'easymenu)
(require 'outline)
(require 'arc-mode)
(require 'etags)
(require 'compile)
(eval-when-compile
(require 'apropos)
(require 'gud)
(require 'lisp-mnt))
(declare-function lm-version "lisp-mnt")
(defvar slime-path nil
"Directory containing the Slime package.
This is used to load the supporting Common Lisp library, Swank.
The default value is automatically computed from the location of
the Emacs Lisp package.")
(setq slime-path (file-name-directory load-file-name))
(defvar slime-version nil
"The version of SLIME that you're using.")
(setq slime-version
(eval-when-compile
(lm-version
(cl-find "slime.el"
(remove nil
(list load-file-name
(when (boundp 'byte-compile-current-file)
byte-compile-current-file)))
:key #'file-name-nondirectory
:test #'string-equal))))
(defvar slime-lisp-modes '(lisp-mode))
(defvar slime-contribs '(slime-fancy)
"A list of contrib packages to load with SLIME.")
(define-obsolete-variable-alias 'slime-setup-contribs
'slime-contribs "2.3.2")
(cl-defun slime-setup (&optional (contribs nil contribs-p))
"Setup Emacs so that lisp-mode buffers always use SLIME.
CONTRIBS is a list of contrib packages to load. If `nil', use
`slime-contribs'. "
(interactive)
(when (member 'lisp-mode slime-lisp-modes)
(add-hook 'lisp-mode-hook 'slime-lisp-mode-hook))
(when contribs-p
(setq slime-contribs contribs))
(slime--setup-contribs))
(defvar slime-required-modules '())
(defun slime--setup-contribs ()
"Load and initialize contribs."
(dolist (c slime-contribs)
(unless (featurep c)
(require c)
(let ((init (intern (format "%s-init" c))))
(when (fboundp init)
(funcall init))))))
(defun slime-lisp-mode-hook ()
(slime-mode 1)
(set (make-local-variable 'lisp-indent-function)
'common-lisp-indent-function))
(defvar slime-protocol-version nil)
(setq slime-protocol-version slime-version)
;;;; Customize groups
;;
;;;;; slime
(defgroup slime nil
"Interaction with the Superior Lisp Environment."
:prefix "slime-"
:group 'applications)
;;;;; slime-ui
(defgroup slime-ui nil
"Interaction with the Superior Lisp Environment."
:prefix "slime-"
:group 'slime)
(defcustom slime-truncate-lines t
"Set `truncate-lines' in popup buffers.
This applies to buffers that present lines as rows of data, such as
debugger backtraces and apropos listings."
:type 'boolean
:group 'slime-ui)
(defcustom slime-kill-without-query-p nil
"If non-nil, kill SLIME processes without query when quitting Emacs.
This applies to the *inferior-lisp* buffer and the network connections."
:type 'boolean
:group 'slime-ui)
;;;;; slime-lisp
(defgroup slime-lisp nil
"Lisp server configuration."
:prefix "slime-"
:group 'slime)
(defcustom slime-backend "swank-loader.lisp"
"The name of the Lisp file that loads the Swank server.
This name is interpreted relative to the directory containing
slime.el, but could also be set to an absolute filename."
:type 'string
:group 'slime-lisp)
(defcustom slime-connected-hook nil
"List of functions to call when SLIME connects to Lisp."
:type 'hook
:group 'slime-lisp)
(defcustom slime-enable-evaluate-in-emacs nil
"*If non-nil, the inferior Lisp can evaluate arbitrary forms in Emacs.
The default is nil, as this feature can be a security risk."
:type '(boolean)
:group 'slime-lisp)
(defcustom slime-lisp-host "localhost"
"The default hostname (or IP address) to connect to."
:type 'string
:group 'slime-lisp)
(defcustom slime-port 4005
"Port to use as the default for `slime-connect'."
:type 'integer
:group 'slime-lisp)
(defvar slime-connect-host-history (list slime-lisp-host))
(defvar slime-connect-port-history (list (prin1-to-string slime-port)))
(defvar slime-net-valid-coding-systems
'((iso-latin-1-unix nil "iso-latin-1-unix")
(iso-8859-1-unix nil "iso-latin-1-unix")
(binary nil "iso-latin-1-unix")
(utf-8-unix t "utf-8-unix")
(emacs-mule-unix t "emacs-mule-unix")
(euc-jp-unix t "euc-jp-unix"))
"A list of valid coding systems.
Each element is of the form: (NAME MULTIBYTEP CL-NAME)")
(defun slime-find-coding-system (name)
"Return the coding system for the symbol NAME.
The result is either an element in `slime-net-valid-coding-systems'
of nil."
(let ((probe (assq name slime-net-valid-coding-systems)))
(when (and probe (if (fboundp 'check-coding-system)
(ignore-errors (check-coding-system (car probe)))
(eq (car probe) 'binary)))
probe)))
(defcustom slime-net-coding-system
(car (cl-find-if 'slime-find-coding-system
slime-net-valid-coding-systems :key 'car))
"Coding system used for network connections.
See also `slime-net-valid-coding-systems'."
:type (cons 'choice
(mapcar (lambda (x)
(list 'const (car x)))
slime-net-valid-coding-systems))
:group 'slime-lisp)
;;;;; slime-mode
(defgroup slime-mode nil
"Settings for slime-mode Lisp source buffers."
:prefix "slime-"
:group 'slime)
(defcustom slime-find-definitions-function 'slime-find-definitions-rpc
"Function to find definitions for a name.
The function is called with the definition name, a string, as its
argument."
:type 'function
:group 'slime-mode
:options '(slime-find-definitions-rpc
slime-etags-definitions
(lambda (name)
(append (slime-find-definitions-rpc name)
(slime-etags-definitions name)))
(lambda (name)
(or (slime-find-definitions-rpc name)
(and tags-table-list
(slime-etags-definitions name))))))
;; FIXME: remove one day
(defcustom slime-complete-symbol-function 'nil
"Obsolete. Use `slime-completion-at-point-functions' instead."
:group 'slime-mode
:type '(choice (const :tag "Compound" slime-complete-symbol*)
(const :tag "Fuzzy" slime-fuzzy-complete-symbol)))
(make-obsolete-variable 'slime-complete-symbol-function
'slime-completion-at-point-functions
"2015-10-18")
(defcustom slime-completion-at-point-functions
'(slime-filename-completion
slime-simple-completion-at-point)
"List of functions to perform completion.
Works like `completion-at-point-functions'.
`slime--completion-at-point' uses this variable."
:group 'slime-mode)
;;;;; slime-mode-faces
(defgroup slime-mode-faces nil
"Faces in slime-mode source code buffers."
:prefix "slime-"
:group 'slime-mode)
(defface slime-error-face
`((((class color) (background light))
(:underline "red"))
(((class color) (background dark))
(:underline "red"))
(t (:underline t)))
"Face for errors from the compiler."
:group 'slime-mode-faces)
(defface slime-warning-face
`((((class color) (background light))
(:underline "orange"))
(((class color) (background dark))
(:underline "coral"))
(t (:underline t)))
"Face for warnings from the compiler."
:group 'slime-mode-faces)
(defface slime-style-warning-face
`((((class color) (background light))
(:underline "brown"))
(((class color) (background dark))
(:underline "gold"))
(t (:underline t)))
"Face for style-warnings from the compiler."
:group 'slime-mode-faces)
(defface slime-note-face
`((((class color) (background light))
(:underline "brown4"))
(((class color) (background dark))
(:underline "light goldenrod"))
(t (:underline t)))
"Face for notes from the compiler."
:group 'slime-mode-faces)
(defface slime-early-deprecation-warning-face
`((((type graphic) (class color) (background light))
(:strike-through "brown"))
(((type graphic) (class color) (background dark))
(:strike-through "gold"))
(((type graphic))
(:strike-through t))
(((class color) (background light))
(:underline "brown"))
(((class color) (background dark))
(:underline "gold"))
(t
(:underline t)))
"Face for early deprecation warnings from the compiler."
:group 'slime-mode-faces)
(defface slime-late-deprecation-warning-face
`((((type graphic) (class color) (background light))
(:strike-through "orange"))
(((type graphic) (class color) (background dark))
(:strike-through "coral"))
(((type graphic))
(:strike-through t))
(((class color) (background light))
(:underline "orange"))
(((class color) (background dark))
(:underline "coral"))
(t
(:underline t)))
"Face for late deprecation warnings from the compiler."
:group 'slime-mode-faces)
(defface slime-final-deprecation-warning-face
`((((type graphic) (class color) (background light))
(:strike-through "red"))
(((type graphic) (class color) (background dark))
(:strike-through "red"))
(((type graphic))
(:strike-through t))
(((class color) (background light))
(:underline "red"))
(((class color) (background dark))
(:underline "red"))
(t
(:strike-through t)))
"Face for final deprecation warnings from the compiler."
:group 'slime-mode-faces)
(defface slime-highlight-face
'((t (:inherit highlight :underline nil)))
"Face for compiler notes while selected."
:group 'slime-mode-faces)
;;;;; sldb
(defgroup slime-debugger nil
"Backtrace options and fontification."
:prefix "sldb-"
:group 'slime)
(defmacro define-sldb-faces (&rest faces)
"Define the set of SLDB faces.
Each face specifiation is (NAME DESCRIPTION &optional PROPERTIES).
NAME is a symbol; the face will be called sldb-NAME-face.
DESCRIPTION is a one-liner for the customization buffer.
PROPERTIES specifies any default face properties."
`(progn ,@(cl-loop for face in faces
collect `(define-sldb-face ,@face))))
(defmacro define-sldb-face (name description &optional default)
(let ((facename (intern (format "sldb-%s-face" (symbol-name name)))))
`(defface ,facename
(list (list t ,default))
,(format "Face for %s." description)
:group 'slime-debugger)))
(define-sldb-faces
(topline "the top line describing the error")
(condition "the condition class"
'(:inherit font-lock-warning-face))
(section "the labels of major sections in the debugger buffer"
'(:inherit header-line))
(frame-label "backtrace frame numbers"
'(:inherit shadow))
(restart-type "restart names."
'(:inherit font-lock-keyword-face))
(restart "restart descriptions")
(restart-number "restart numbers (correspond to keystrokes to invoke)"
'(:bold t))
(frame-line "function names and arguments in the backtrace")
(restartable-frame-line
"frames which are surely restartable"
'(:foreground "lime green"))
(non-restartable-frame-line
"frames which are surely not restartable")
(detailed-frame-line
"function names and arguments in a detailed (expanded) frame")
(local-name "local variable names"
'(:inherit font-lock-variable-name-face))
(local-value "local variable values")
(catch-tag "catch tags"
'(:inherit highlight)))
;;;; Minor modes
;;;;; slime-mode
(defvar slime-mode-indirect-map (make-sparse-keymap)
"Empty keymap which has `slime-mode-map' as it's parent.
This is a hack so that we can reinitilize the real slime-mode-map
more easily. See `slime-init-keymaps'.")
(defvar slime-buffer-connection)
(defvar slime-current-thread)
(defun slime--on ()
(slime-setup-completion))
(defun slime--off ()
(remove-hook 'completion-at-point-functions #'slime--completion-at-point t))
(define-minor-mode slime-mode
"\\<slime-mode-map>\
SLIME: The Superior Lisp Interaction Mode for Emacs (minor-mode).
Commands to compile the current buffer's source file and visually
highlight any resulting compiler notes and warnings:
\\[slime-compile-and-load-file] - Compile and load the current buffer's file.
\\[slime-compile-file] - Compile (but not load) the current buffer's file.
\\[slime-compile-defun] - Compile the top-level form at point.
Commands for visiting compiler notes:
\\[slime-next-note] - Goto the next form with a compiler note.
\\[slime-previous-note] - Goto the previous form with a compiler note.
\\[slime-remove-notes] - Remove compiler-note annotations in buffer.
Finding definitions:
\\[slime-edit-definition]
- Edit the definition of the function called at point.
\\[slime-pop-find-definition-stack]
- Pop the definition stack to go back from a definition.
Documentation commands:
\\[slime-describe-symbol] - Describe symbol.
\\[slime-apropos] - Apropos search.
\\[slime-disassemble-symbol] - Disassemble a function.
Evaluation commands:
\\[slime-eval-defun] - Evaluate top-level from containing point.
\\[slime-eval-last-expression] - Evaluate sexp before point.
\\[slime-pprint-eval-last-expression] \
- Evaluate sexp before point, pretty-print result.
Full set of commands:
\\{slime-mode-map}"
:keymap slime-mode-indirect-map
:lighter (:eval (slime-modeline-string))
(cond (slime-mode (slime--on))
(t (slime--off))))
;;;;;; Modeline
(defun slime-modeline-string ()
"Return the string to display in the modeline.
\"Slime\" only appears if we aren't connected. If connected,
include package-name, connection-name, and possibly some state
information."
(let ((conn (slime-current-connection)))
;; Bail out early in case there's no connection, so we won't
;; implicitly invoke `slime-connection' which may query the user.
(if (not conn)
(and slime-mode " Slime")
(let ((local (eq conn slime-buffer-connection))
(pkg (slime-current-package)))
(concat " "
(if local "{" "[")
(if pkg (slime-pretty-package-name pkg) "?")
" "
;; ignore errors for closed connections
(ignore-errors (slime-connection-name conn))
(slime-modeline-state-string conn)
(if local "}" "]"))))))
(defun slime-pretty-package-name (name)
"Return a pretty version of a package name NAME."
(cond ((string-match "^#?:\\(.*\\)$" name)
(match-string 1 name))
((string-match "^\"\\(.*\\)\"$" name)
(match-string 1 name))
(t name)))
(defun slime-modeline-state-string (conn)
"Return a string possibly describing CONN's state."
(cond ((not (eq (process-status conn) 'open))
(format " %s" (process-status conn)))
((let ((pending (length (slime-rex-continuations conn)))
(sldbs (length (sldb-buffers conn))))
(cond ((and (zerop sldbs) (zerop pending)) nil)
((zerop sldbs) (format " %s" pending))
(t (format " %s/%s" pending sldbs)))))))
(defun slime--recompute-modelines ()
(force-mode-line-update t))
;;;;; Key bindings
(defvar slime-parent-map nil
"Parent keymap for shared between all Slime related modes.")
(defvar slime-parent-bindings
'(("\M-." slime-edit-definition)
("\M-," slime-pop-find-definition-stack)
("\M-_" slime-edit-uses) ; for German layout
("\M-?" slime-edit-uses) ; for USian layout
("\C-x4." slime-edit-definition-other-window)
("\C-x5." slime-edit-definition-other-frame)
("\C-x\C-e" slime-eval-last-expression)
("\C-\M-x" slime-eval-defun)
;; Include PREFIX keys...
("\C-c" slime-prefix-map)))
(defvar slime-prefix-map nil
"Keymap for commands prefixed with `slime-prefix-key'.")
(defvar slime-prefix-bindings
'(("\C-r" slime-eval-region)
(":" slime-interactive-eval)
("\C-e" slime-interactive-eval)
("E" slime-edit-value)
("\C-l" slime-load-file)
("\C-b" slime-interrupt)
("\M-d" slime-disassemble-symbol)
("\C-t" slime-toggle-trace-fdefinition)
("I" slime-inspect)
("\C-xt" slime-list-threads)
("\C-xn" slime-next-connection)
("\C-xp" slime-prev-connection)
("\C-xc" slime-list-connections)
("<" slime-list-callers)
(">" slime-list-callees)
;; Include DOC keys...
("\C-d" slime-doc-map)
;; Include XREF WHO-FOO keys...
("\C-w" slime-who-map)
))
(defvar slime-editing-map nil
"These keys are useful for buffers where the user can insert and
edit s-exprs, e.g. for source buffers and the REPL.")
(defvar slime-editing-keys
`(;; Arglist display & completion
(" " slime-space)
;; Evaluating
;;("\C-x\M-e" slime-eval-last-expression-display-output :inferior t)
("\C-c\C-p" slime-pprint-eval-last-expression)
;; Macroexpand
("\C-c\C-m" slime-expand-1)
("\C-c\M-m" slime-macroexpand-all)
;; Misc
("\C-c\C-u" slime-undefine-function)
(,(kbd "C-M-.") slime-next-location)
(,(kbd "C-M-,") slime-previous-location)
;; Obsolete, redundant bindings
("\C-c\C-i" completion-at-point)
;;("\M-*" pop-tag-mark) ; almost to clever
))
(defvar slime-mode-map nil
"Keymap for slime-mode.")
(defvar slime-keys
'( ;; Compiler notes
("\M-p" slime-previous-note)
("\M-n" slime-next-note)
("\C-c\M-c" slime-remove-notes)
("\C-c\C-k" slime-compile-and-load-file)
("\C-c\M-k" slime-compile-file)
("\C-c\C-c" slime-compile-defun)))
(defun slime-nop ()
"The null command. Used to shadow currently-unused keybindings."
(interactive)
(call-interactively 'undefined))
(defvar slime-doc-map nil
"Keymap for documentation commands. Bound to a prefix key.")
(defvar slime-doc-bindings
'((?a slime-apropos)
(?z slime-apropos-all)
(?p slime-apropos-package)
(?d slime-describe-symbol)
(?f slime-describe-function)
(?h slime-documentation-lookup)
(?~ common-lisp-hyperspec-format)
(?g common-lisp-hyperspec-glossary-term)
(?# common-lisp-hyperspec-lookup-reader-macro)))
(defvar slime-who-map nil
"Keymap for who-xref commands. Bound to a prefix key.")
(defvar slime-who-bindings
'((?c slime-who-calls)
(?w slime-calls-who)
(?r slime-who-references)
(?b slime-who-binds)
(?s slime-who-sets)
(?m slime-who-macroexpands)
(?a slime-who-specializes)))
(defun slime-init-keymaps ()
"(Re)initialize the keymaps for `slime-mode'."
(interactive)
(slime-init-keymap 'slime-doc-map t t slime-doc-bindings)
(slime-init-keymap 'slime-who-map t t slime-who-bindings)
(slime-init-keymap 'slime-prefix-map t nil slime-prefix-bindings)
(slime-init-keymap 'slime-parent-map nil nil slime-parent-bindings)
(slime-init-keymap 'slime-editing-map nil nil slime-editing-keys)
(set-keymap-parent slime-editing-map slime-parent-map)
(slime-init-keymap 'slime-mode-map nil nil slime-keys)
(set-keymap-parent slime-mode-map slime-editing-map)
(set-keymap-parent slime-mode-indirect-map slime-mode-map))
(defun slime-init-keymap (keymap-name prefixp bothp bindings)
(set keymap-name (make-sparse-keymap))
(when prefixp (define-prefix-command keymap-name))
(slime-bind-keys (eval keymap-name) bothp bindings))
(defun slime-bind-keys (keymap bothp bindings)
"Add BINDINGS to KEYMAP.
If BOTHP is true also add bindings with control modifier."
(cl-loop for (key command) in bindings do
(cond (bothp
(define-key keymap `[,key] command)
(unless (equal key ?h) ; But don't bind C-h
(define-key keymap `[(control ,key)] command)))
(t (define-key keymap key command)))))
(slime-init-keymaps)
(define-minor-mode slime-editing-mode
"Minor mode which makes slime-editing-map available.
\\{slime-editing-map}"
nil
nil
slime-editing-map)
;;;; Framework'ey bits
;;;
;;; This section contains some standard SLIME idioms: basic macros,
;;; ways of showing messages to the user, etc. All the code in this
;;; file should use these functions when applicable.
;;;
;;;;; Syntactic sugar
(defmacro slime-dcase (value &rest patterns)
(declare (indent 1))
"Dispatch VALUE to one of PATTERNS.
A cross between `case' and `destructuring-bind'.
The pattern syntax is:
((HEAD . ARGS) . BODY)
The list of patterns is searched for a HEAD `eq' to the car of
VALUE. If one is found, the BODY is executed with ARGS bound to the
corresponding values in the CDR of VALUE."
(let ((operator (cl-gensym "op-"))
(operands (cl-gensym "rand-"))
(tmp (cl-gensym "tmp-")))
`(let* ((,tmp ,value)
(,operator (car ,tmp))
(,operands (cdr ,tmp)))
(cl-case ,operator
,@(mapcar (lambda (clause)
(if (eq (car clause) t)
`(t ,@(cdr clause))
(cl-destructuring-bind ((op &rest rands) &rest body)
clause
`(,op (cl-destructuring-bind ,rands ,operands
. ,(or body
'((ignore)) ; suppress some warnings
))))))
patterns)
,@(if (eq (caar (last patterns)) t)
'()
`((t (error "slime-dcase failed: %S" ,tmp))))))))
(defmacro slime-define-keys (keymap &rest key-command)
"Define keys in KEYMAP. Each KEY-COMMAND is a list of (KEY COMMAND)."
(declare (indent 1))
`(progn . ,(mapcar (lambda (k-c) `(define-key ,keymap . ,k-c))
key-command)))
(cl-defmacro with-struct ((conc-name &rest slots) struct &body body)
"Like with-slots but works only for structs.
\(fn (CONC-NAME &rest SLOTS) STRUCT &body BODY)"
(declare (indent 2))
(let ((struct-var (cl-gensym "struct"))
(reader (lambda (slot)
(intern (concat (symbol-name conc-name)
(symbol-name slot))))))
`(let ((,struct-var ,struct))
(cl-symbol-macrolet
,(mapcar (lambda (slot)
(cl-etypecase slot
(symbol `(,slot (,(funcall reader slot) ,struct-var)))
(cons `(,(cl-first slot)
(,(funcall reader (cl-second slot))
,struct-var)))))
slots)
. ,body))))
;;;;; Very-commonly-used functions
(defvar slime-message-function 'message)
;; Interface
(defun slime-buffer-name (type &optional hidden)
(cl-assert (keywordp type))
(concat (if hidden " " "")
(format "*slime-%s*" (substring (symbol-name type) 1))))
;; Interface
(defun slime-message (format &rest args)
"Like `message' but with special support for multi-line messages.
Single-line messages use the echo area."
(apply slime-message-function format args))
(defun slime-display-warning (message &rest args)
(display-warning '(slime warning) (apply #'format message args)))
(defvar slime-background-message-function 'slime-display-oneliner)
;; Interface
(defun slime-background-message (format-string &rest format-args)
"Display a message in passing.
This is like `slime-message', but less distracting because it
will never pop up a buffer or display multi-line messages.
It should be used for \"background\" messages such as argument lists."
(apply slime-background-message-function format-string format-args))
(defun slime-display-oneliner (format-string &rest format-args)
(let* ((msg (apply #'format format-string format-args)))
(unless (minibuffer-window-active-p (minibuffer-window))
(message "%s" (slime-oneliner msg)))))
(defun slime-oneliner (string)
"Return STRING truncated to fit in a single echo-area line."
(substring string 0 (min (length string)
(or (cl-position ?\n string) most-positive-fixnum)
(1- (window-width (minibuffer-window))))))
;; Interface
(defun slime-set-truncate-lines ()
"Apply `slime-truncate-lines' to the current buffer."
(when slime-truncate-lines
(set (make-local-variable 'truncate-lines) t)))
;; Interface
(defun slime-read-package-name (prompt &optional initial-value)
"Read a package name from the minibuffer, prompting with PROMPT."
(let ((completion-ignore-case t))
(completing-read prompt (slime-bogus-completion-alist
(slime-eval
`(swank:list-all-package-names t)))
nil t initial-value)))
;; Interface
(defun slime-read-symbol-name (prompt &optional query)
"Either read a symbol name or choose the one at point.
The user is prompted if a prefix argument is in effect, if there is no
symbol at point, or if QUERY is non-nil."
(cond ((or current-prefix-arg query (not (slime-symbol-at-point)))
(slime-read-from-minibuffer prompt (slime-symbol-at-point)))
(t (slime-symbol-at-point))))
;; Interface
(defmacro slime-propertize-region (props &rest body)
"Execute BODY and add PROPS to all the text it inserts.
More precisely, PROPS are added to the region between the point's
positions before and after executing BODY."
(declare (indent 1) (debug (sexp &rest form)))
(let ((start (cl-gensym)))
`(let ((,start (point)))
(prog1 (progn ,@body)
(add-text-properties ,start (point) ,props)))))
(defun slime-add-face (face string)
(declare (indent 1))
(add-text-properties 0 (length string) (list 'face face) string)
string)
;; Interface
(defsubst slime-insert-propertized (props &rest args)
"Insert all ARGS and then add text-PROPS to the inserted text."
(slime-propertize-region props (apply #'insert args)))
(defmacro slime-with-rigid-indentation (level &rest body)
"Execute BODY and then rigidly indent its text insertions.
Assumes all insertions are made at point."
(declare (indent 1))
(let ((start (cl-gensym)) (l (cl-gensym)))
`(let ((,start (point)) (,l ,(or level '(current-column))))
(prog1 (progn ,@body)
(slime-indent-rigidly ,start (point) ,l)))))
(defun slime-indent-rigidly (start end column)
;; Similar to `indent-rigidly' but doesn't inherit text props.
(let ((indent (make-string column ?\ )))
(save-excursion
(goto-char end)
(beginning-of-line)
(while (and (<= start (point))
(progn
(insert-before-markers indent)
(zerop (forward-line -1))))))))
(defun slime-insert-indented (&rest strings)
"Insert all arguments rigidly indented."
(slime-with-rigid-indentation nil
(apply #'insert strings)))
(defun slime-property-bounds (prop)
"Return two the positions of the previous and next changes to PROP.
PROP is the name of a text property."
(cl-assert (get-text-property (point) prop))
(let ((end (next-single-char-property-change (point) prop)))
(list (previous-single-char-property-change end prop) end)))
(defun slime-curry (fun &rest args)
"Partially apply FUN to ARGS. The result is a new function.
This idiom is preferred over `lexical-let'."
`(lambda (&rest more) (apply ',fun (append ',args more))))
(defun slime-rcurry (fun &rest args)
"Like `slime-curry' but ARGS on the right are applied."
`(lambda (&rest more) (apply ',fun (append more ',args))))
;;;;; Temporary popup buffers
;; keep compiler quiet
(defvar slime-buffer-package)
(defvar slime-buffer-connection)
;; Interface
(cl-defmacro slime-with-popup-buffer ((name &key package connection select
mode)
&body body)
"Similar to `with-output-to-temp-buffer'.
Bind standard-output and initialize some buffer-local variables.
Restore window configuration when closed.
NAME is the name of the buffer to be created.
PACKAGE is the value `slime-buffer-package'.
CONNECTION is the value for `slime-buffer-connection',
if nil, no explicit connection is associated with
the buffer. If t, the current connection is taken.
MODE is the name of a major mode which will be enabled.
"
(declare (indent 1))
(let ((package-sym (cl-gensym "package-"))
(connection-sym (cl-gensym "connection-")))
`(let ((,package-sym ,(if (eq package t)
`(slime-current-package)
package))
(,connection-sym ,(if (eq connection t)
`(slime-current-connection)
connection)))
(with-current-buffer (get-buffer-create ,name)
(let ((inhibit-read-only t)
(standard-output (current-buffer)))
(erase-buffer)
(funcall (or ,mode 'fundamental-mode))
(setq slime-buffer-package ,package-sym
slime-buffer-connection ,connection-sym)
(set-syntax-table lisp-mode-syntax-table)
,@body
(slime-popup-buffer-mode 1)
(funcall (if ,select 'pop-to-buffer 'display-buffer)
(current-buffer))
(current-buffer))))))
(defvar slime-popup-buffer-mode-map
(let ((map (make-sparse-keymap)))
(define-key map (kbd "q") 'quit-window)
;;("\C-c\C-z" . slime-switch-to-output-buffer)
(define-key map (kbd "M-.") 'slime-edit-definition)
map))
(define-minor-mode slime-popup-buffer-mode
"Mode for displaying read only stuff"
nil nil nil
(setq buffer-read-only t))
(add-to-list 'minor-mode-alist
`(slime-popup-buffer-mode
(:eval (unless slime-mode
(slime-modeline-string)))))
(set-keymap-parent slime-popup-buffer-mode-map slime-parent-map)
;;;;; Filename translation
;;;
;;; Filenames passed between Emacs and Lisp should be translated using
;;; these functions. This way users who run Emacs and Lisp on separate
;;; machines have a chance to integrate file operations somehow.
(defvar slime-to-lisp-filename-function #'convert-standard-filename
"Function to translate Emacs filenames to CL namestrings.")
(defvar slime-from-lisp-filename-function #'identity
"Function to translate CL namestrings to Emacs filenames.")
(defun slime-to-lisp-filename (filename)
"Translate the string FILENAME to a Lisp filename."
(funcall slime-to-lisp-filename-function filename))
(defun slime-from-lisp-filename (filename)
"Translate the Lisp filename FILENAME to an Emacs filename."
(funcall slime-from-lisp-filename-function filename))
;;;; Starting SLIME
;;;
;;; This section covers starting an inferior-lisp, compiling and
;;; starting the server, initiating a network connection.
;;;;; Entry points
;; We no longer load inf-lisp, but we use this variable for backward
;; compatibility.
(defvar inferior-lisp-program "lisp"
"*Program name for invoking an inferior Lisp with for Inferior Lisp mode.")
(defvar slime-lisp-implementations nil
"*A list of known Lisp implementations.
The list should have the form:
((NAME (PROGRAM PROGRAM-ARGS...) &key KEYWORD-ARGS) ...)
NAME is a symbol for the implementation.
PROGRAM and PROGRAM-ARGS are strings used to start the Lisp process.
For KEYWORD-ARGS see `slime-start'.
Here's an example:
((cmucl (\"/opt/cmucl/bin/lisp\" \"-quiet\") :init slime-init-command)
(acl (\"acl7\") :coding-system emacs-mule))")
(defvar slime-default-lisp nil
"*The name of the default Lisp implementation.
See `slime-lisp-implementations'")
;; dummy definitions for the compiler
(defvar slime-net-processes)
(defvar slime-default-connection)
(defun slime (&optional command coding-system)
"Start an inferior^_superior Lisp and connect to its Swank server."
(interactive)
(slime-setup)
(let ((inferior-lisp-program (or command inferior-lisp-program))
(slime-net-coding-system (or coding-system slime-net-coding-system)))
(slime-start* (cond ((and command (symbolp command))
(slime-lisp-options command))
(t (slime-read-interactive-args))))))
(defvar slime-inferior-lisp-program-history '()
"History list of command strings. Used by `slime'.")
(defun slime-read-interactive-args ()
"Return the list of args which should be passed to `slime-start'.
The rules for selecting the arguments are rather complicated:
- In the most common case, i.e. if there's no prefix-arg in
effect and if `slime-lisp-implementations' is nil, use
`inferior-lisp-program' as fallback.
- If the table `slime-lisp-implementations' is non-nil use the
implementation with name `slime-default-lisp' or if that's nil
the first entry in the table.
- If the prefix-arg is `-', prompt for one of the registered
lisps.
- If the prefix-arg is positive, read the command to start the
process."
(let ((table slime-lisp-implementations))
(cond ((not current-prefix-arg) (slime-lisp-options))
((eq current-prefix-arg '-)
(let ((key (completing-read
"Lisp name: " (mapcar (lambda (x)
(list (symbol-name (car x))))
table)
nil t)))
(slime-lookup-lisp-implementation table (intern key))))
(t
(cl-destructuring-bind (program &rest program-args)
(split-string-and-unquote
(read-shell-command "Run lisp: " inferior-lisp-program
'slime-inferior-lisp-program-history))
(let ((coding-system
(if (eq 16 (prefix-numeric-value current-prefix-arg))
(read-coding-system "set slime-coding-system: "
slime-net-coding-system)
slime-net-coding-system)))
(list :program program :program-args program-args
:coding-system coding-system)))))))
(defun slime-lisp-options (&optional name)
(let ((table slime-lisp-implementations))
(cl-assert (or (not name) table))
(cond (table (slime-lookup-lisp-implementation slime-lisp-implementations
(or name slime-default-lisp
(car (car table)))))
(t (cl-destructuring-bind (program &rest args)
(split-string inferior-lisp-program)
(list :program program :program-args args))))))
(defun slime-lookup-lisp-implementation (table name)
(let ((arguments (cl-rest (assoc name table))))
(unless arguments
(error "Could not find lisp implementation with the name '%S'" name))
(when (and (= (length arguments) 1)
(functionp (cl-first arguments)))
(setf arguments (funcall (cl-first arguments))))
(cl-destructuring-bind ((prog &rest args) &rest keys) arguments
(cl-list* :name name :program prog :program-args args keys))))
(cl-defun slime-start (&key (program inferior-lisp-program) program-args
directory
(coding-system slime-net-coding-system)
(init 'slime-init-command)
name
(buffer "*inferior-lisp*")
init-function
env)
"Start a Lisp process and connect to it.
This function is intended for programmatic use if `slime' is not
flexible enough.
PROGRAM and PROGRAM-ARGS are the filename and argument strings
for the subprocess.
INIT is a function that should return a string to load and start
Swank. The function will be called with the PORT-FILENAME and ENCODING as
arguments. INIT defaults to `slime-init-command'.
CODING-SYSTEM a symbol for the coding system. The default is
slime-net-coding-system
ENV environment variables for the subprocess (see `process-environment').
INIT-FUNCTION function to call right after the connection is established.
BUFFER the name of the buffer to use for the subprocess.
NAME a symbol to describe the Lisp implementation
DIRECTORY change to this directory before starting the process.
"
(let ((args (list :program program :program-args program-args :buffer buffer
:coding-system coding-system :init init :name name
:init-function init-function :env env)))
(slime-check-coding-system coding-system)
(when (slime-bytecode-stale-p)
(slime-urge-bytecode-recompile))
(let ((proc (slime-maybe-start-lisp program program-args env
directory buffer)))
(slime-inferior-connect proc args)
(pop-to-buffer (process-buffer proc)))))
(defun slime-start* (options)
(apply #'slime-start options))
(defun slime-connect (host port &optional _coding-system interactive-p &rest parameters)
"Connect to a running Swank server. Return the connection."
(interactive (list (read-from-minibuffer
"Host: " (cl-first slime-connect-host-history)
nil nil '(slime-connect-host-history . 1))
(string-to-number
(read-from-minibuffer
"Port: " (cl-first slime-connect-port-history)
nil nil '(slime-connect-port-history . 1)))
nil t))
(slime-setup)
(when (and interactive-p
slime-net-processes
(y-or-n-p "Close old connections first? "))
(slime-disconnect-all))
(message "Connecting to Swank on port %S.." port)
(slime-setup-connection (apply 'slime-net-connect host port parameters)))
;; FIXME: seems redundant
(defun slime-start-and-init (options fun)
(let* ((rest (plist-get options :init-function))
(init (cond (rest `(lambda () (funcall ',rest) (funcall ',fun)))
(t fun))))
(slime-start* (plist-put (cl-copy-list options) :init-function init))))
;;;;; Start inferior lisp
;;;
;;; Here is the protocol for starting SLIME:
;;;
;;; 0. Emacs recompiles/reloads slime.elc if it exists and is stale.
;;; 1. Emacs starts an inferior Lisp process.
;;; 2. Emacs tells Lisp (via stdio) to load and start Swank.
;;; 3. Lisp recompiles the Swank if needed.
;;; 4. Lisp starts the Swank server and writes its TCP port to a temp file.
;;; 5. Emacs reads the temp file to get the port and then connects.
;;; 6. Emacs prints a message of warm encouragement for the hacking ahead.
;;;
;;; Between steps 2-5 Emacs polls for the creation of the temp file so
;;; that it can make the connection. This polling may continue for a
;;; fair while if Swank needs recompilation.
(defvar slime-connect-retry-timer nil
"Timer object while waiting for an inferior-lisp to start.")
;;; Recompiling bytecode:
(defun slime-bytecode-stale-p ()
"Return true if slime.elc is older than slime.el."
(let ((libfile (locate-library "slime")))
(when libfile
(let* ((basename (file-name-sans-extension libfile))
(sourcefile (concat basename ".el"))
(bytefile (concat basename ".elc")))
(and (file-exists-p bytefile)
(file-newer-than-file-p sourcefile bytefile))))))
(defun slime-recompile-bytecode ()
"Recompile and reload slime."
(interactive)
(let ((sourcefile (concat (file-name-sans-extension (locate-library "slime"))
".el")))
(byte-compile-file sourcefile t)))
(defun slime-urge-bytecode-recompile ()
"Urge the user to recompile slime.elc.
Return true if we have been given permission to continue."
(when (y-or-n-p "slime.elc is older than source. Recompile first? ")
(slime-recompile-bytecode)))
(defun slime-abort-connection ()
"Abort connection the current connection attempt."
(interactive)
(cond (slime-connect-retry-timer
(slime-cancel-connect-retry-timer)
(message "Cancelled connection attempt."))
(t (error "Not connecting"))))
;;; Starting the inferior Lisp and loading Swank:
(defun slime-maybe-start-lisp (program program-args env directory buffer)
"Return a new or existing inferior lisp process."
(cond ((not (comint-check-proc buffer))
(slime-start-lisp program program-args env directory buffer))
((slime-reinitialize-inferior-lisp-p program program-args env buffer)
(let ((conn (cl-find (get-buffer-process buffer)
slime-net-processes
:key #'slime-inferior-process)))
(when conn
(slime-net-close conn)))
(get-buffer-process buffer))
(t (slime-start-lisp program program-args env directory
(generate-new-buffer-name buffer)))))
(defun slime-reinitialize-inferior-lisp-p (program program-args env buffer)
(let ((args (slime-inferior-lisp-args (get-buffer-process buffer))))
(and (equal (plist-get args :program) program)
(equal (plist-get args :program-args) program-args)
(equal (plist-get args :env) env)
(not (y-or-n-p "Create an additional *inferior-lisp*? ")))))
(defvar slime-inferior-process-start-hook nil
"Hook called whenever a new process gets started.")
(defun slime-start-lisp (program program-args env directory buffer)
"Does the same as `inferior-lisp' but less ugly.
Return the created process."
(with-current-buffer (get-buffer-create buffer)
(when directory
(cd (expand-file-name directory)))
(comint-mode)
(let ((process-environment (append env process-environment))
(process-connection-type nil))
(comint-exec (current-buffer) "inferior-lisp" program nil program-args))
(lisp-mode-variables t)
(let ((proc (get-buffer-process (current-buffer))))
(slime-set-query-on-exit-flag proc)
(run-hooks 'slime-inferior-process-start-hook)
proc)))
(defun slime-inferior-connect (process args)
"Start a Swank server in the inferior Lisp and connect."
(slime-delete-swank-port-file 'quiet)
(slime-start-swank-server process args)
(slime-read-port-and-connect process))
(defvar slime-inferior-lisp-args nil
"A buffer local variable in the inferior proccess.
See `slime-start'.")
(defun slime-start-swank-server (process args)
"Start a Swank server on the inferior lisp."
(cl-destructuring-bind (&key coding-system init &allow-other-keys) args
(with-current-buffer (process-buffer process)
(make-local-variable 'slime-inferior-lisp-args)
(setq slime-inferior-lisp-args args)
(let ((str (funcall init (slime-swank-port-file) coding-system)))
(goto-char (process-mark process))
(insert-before-markers str)
(process-send-string process str)))))
(defun slime-inferior-lisp-args (process)
"Return the initial process arguments.
See `slime-start'."
(with-current-buffer (process-buffer process)
slime-inferior-lisp-args))
;; XXX load-server & start-server used to be separated. maybe that was better.
(defun slime-init-command (port-filename _coding-system)
"Return a string to initialize Lisp."
(let ((loader (if (file-name-absolute-p slime-backend)
slime-backend
(concat slime-path slime-backend))))
;; Return a single form to avoid problems with buffered input.
(format "%S\n\n"
`(progn
(load ,(slime-to-lisp-filename (expand-file-name loader))
:verbose t)
(funcall (read-from-string "swank-loader:init")
:from-emacs t)
(funcall (read-from-string "swank:start-server")
,(slime-to-lisp-filename port-filename))))))
(defun slime-swank-port-file ()
"Filename where the SWANK server writes its TCP port number."
(expand-file-name (format "slime.%S" (emacs-pid)) (slime-temp-directory)))
(defun slime-temp-directory ()
(cond ((fboundp 'temp-directory) (temp-directory))
((boundp 'temporary-file-directory) temporary-file-directory)
(t "/tmp/")))
(defun slime-delete-swank-port-file (&optional quiet)
(condition-case data
(delete-file (slime-swank-port-file))
(error
(cl-ecase quiet
((nil) (signal (car data) (cdr data)))
(quiet)
(message (message "Unable to delete swank port file %S"
(slime-swank-port-file)))))))
(defun slime-read-port-and-connect (inferior-process)
(slime-attempt-connection inferior-process nil 1))
(defun slime-attempt-connection (process retries attempt)
;; A small one-state machine to attempt a connection with
;; timer-based retries.
(slime-cancel-connect-retry-timer)
(let ((file (slime-swank-port-file)))
(unless (active-minibuffer-window)
(message "Polling %S .. %d (Abort with `M-x slime-abort-connection'.)"
file attempt))
(cond ((and (file-exists-p file)
(> (nth 7 (file-attributes file)) 0)) ; file size
(let ((port (slime-read-swank-port))
(args (slime-inferior-lisp-args process)))
(slime-delete-swank-port-file 'message)
(let ((c (slime-connect slime-lisp-host port
(plist-get args :coding-system))))
(slime-set-inferior-process c process))))
((and retries (zerop retries))
(message "Gave up connecting to Swank after %d attempts." attempt))
((eq (process-status process) 'exit)
(message "Failed to connect to Swank: inferior process exited."))
(t
(when (and (file-exists-p file)
(zerop (nth 7 (file-attributes file))))
(message "(Zero length port file)")
;; the file may be in the filesystem but not yet written
(unless retries (setq retries 3)))
(cl-assert (not slime-connect-retry-timer))
(setq slime-connect-retry-timer
(run-with-timer
0.3 nil
#'slime-timer-call #'slime-attempt-connection
process (and retries (1- retries))
(1+ attempt)))))))
(defun slime-timer-call (fun &rest args)
"Call function FUN with ARGS, reporting all errors.
The default condition handler for timer functions (see
`timer-event-handler') ignores errors."
(condition-case data
(apply fun args)
((debug error)
(debug nil (list "Error in timer" fun args data)))))
(defun slime-cancel-connect-retry-timer ()
(when slime-connect-retry-timer
(cancel-timer slime-connect-retry-timer)
(setq slime-connect-retry-timer nil)))
(defun slime-read-swank-port ()
"Read the Swank server port number from the `slime-swank-port-file'."
(save-excursion
(with-temp-buffer
(insert-file-contents (slime-swank-port-file))
(goto-char (point-min))
(let ((port (read (current-buffer))))
(cl-assert (integerp port))
port))))
(defun slime-toggle-debug-on-swank-error ()
(interactive)
(if (slime-eval `(swank:toggle-debug-on-swank-error))
(message "Debug on SWANK error enabled.")
(message "Debug on SWANK error disabled.")))
;;; Words of encouragement
(defun slime-user-first-name ()
(let ((name (if (string= (user-full-name) "")
(user-login-name)
(user-full-name))))
(string-match "^[^ ]*" name)
(capitalize (match-string 0 name))))
(defvar slime-words-of-encouragement
`("Let the hacking commence!"
"Hacks and glory await!"
"Hack and be merry!"
"Your hacking starts... NOW!"
"May the source be with you!"
"Take this REPL, brother, and may it serve you well."
"Lemonodor-fame is but a hack away!"
"Are we consing yet?"
,(format "%s, this could be the start of a beautiful program."
(slime-user-first-name)))
"Scientifically-proven optimal words of hackerish encouragement.")
(defun slime-random-words-of-encouragement ()
"Return a string of hackerish encouragement."
(eval (nth (random (length slime-words-of-encouragement))
slime-words-of-encouragement)))
;;;; Networking
;;;
;;; This section covers the low-level networking: establishing
;;; connections and encoding/decoding protocol messages.
;;;
;;; Each SLIME protocol message beings with a 6-byte header followed
;;; by an S-expression as text. The sexp must be readable both by
;;; Emacs and by Common Lisp, so if it contains any embedded code
;;; fragments they should be sent as strings:
;;;
;;; The set of meaningful protocol messages are not specified
;;; here. They are defined elsewhere by the event-dispatching
;;; functions in this file and in swank.lisp.
(defvar slime-net-processes nil
"List of processes (sockets) connected to Lisps.")
(defvar slime-net-process-close-hooks '()
"List of functions called when a slime network connection closes.
The functions are called with the process as their argument.")
(defun slime-secret ()
"Find the magic secret from the user's home directory.
Return nil if the file doesn't exist or is empty; otherwise the
first line of the file."
(condition-case _err
(with-temp-buffer
(insert-file-contents "~/.slime-secret")
(goto-char (point-min))
(buffer-substring (point-min) (line-end-position)))
(file-error nil)))
;;; Interface
(defun slime-send-secret (proc)
(let ((secret (slime-secret)))
(when secret
(let* ((payload (encode-coding-string secret 'utf-8-unix))
(string (concat (slime-net-encode-length (length payload))
payload)))
(process-send-string proc string)))))
(defun slime-net-connect (host port &rest parameters)
"Establish a connection with a CL."
(let* ((inhibit-quit nil)
(proc (apply 'open-network-stream "SLIME Lisp" nil host port parameters))
(buffer (slime-make-net-buffer " *cl-connection*")))
(push proc slime-net-processes)
(set-process-buffer proc buffer)
(set-process-filter proc 'slime-net-filter)
(set-process-sentinel proc 'slime-net-sentinel)
(slime-set-query-on-exit-flag proc)
(when (fboundp 'set-process-coding-system)
(set-process-coding-system proc 'binary 'binary))
(slime-send-secret proc)
proc))
(defun slime-make-net-buffer (name)
"Make a buffer suitable for a network process."
(let ((buffer (generate-new-buffer name)))
(with-current-buffer buffer
(buffer-disable-undo)
(set (make-local-variable 'kill-buffer-query-functions) nil))
buffer))
(defun slime-set-query-on-exit-flag (process)
"Set PROCESS's query-on-exit-flag to `slime-kill-without-query-p'."
(when slime-kill-without-query-p
;; avoid byte-compiler warnings
(let ((fun (if (fboundp 'set-process-query-on-exit-flag)
'set-process-query-on-exit-flag
'process-kill-without-query)))
(funcall fun process nil))))
;;;;; Coding system madness
(defun slime-check-coding-system (coding-system)
"Signal an error if CODING-SYSTEM isn't a valid coding system."
(interactive)
(let ((props (slime-find-coding-system coding-system)))
(unless props
(error "Invalid slime-net-coding-system: %s. %s"
coding-system (mapcar #'car slime-net-valid-coding-systems)))
(when (and (cl-second props) (boundp 'default-enable-multibyte-characters))
(cl-assert default-enable-multibyte-characters))
t))
(defun slime-coding-system-mulibyte-p (coding-system)
(cl-second (slime-find-coding-system coding-system)))
(defun slime-coding-system-cl-name (coding-system)
(cl-third (slime-find-coding-system coding-system)))
;;; Interface
(defun slime-net-send (sexp proc)
"Send a SEXP to Lisp over the socket PROC.
This is the lowest level of communication. The sexp will be READ and
EVAL'd by Lisp."
(let* ((payload (encode-coding-string
(concat (slime-prin1-to-string sexp) "\n")
'utf-8-unix))
(string (concat (slime-net-encode-length (length payload))
payload)))
(slime-log-event sexp)
(process-send-string proc string)))
(defun slime-safe-encoding-p (coding-system string)
"Return true iff CODING-SYSTEM can safely encode STRING."
(or (let ((candidates (find-coding-systems-string string))
(base (coding-system-base coding-system)))
(or (equal candidates '(undecided))
(memq base candidates)))
(and (not (multibyte-string-p string))
(not (slime-coding-system-mulibyte-p coding-system)))))
(defun slime-net-close (process &optional debug)
(setq slime-net-processes (remove process slime-net-processes))
(when (eq process slime-default-connection)
(setq slime-default-connection nil))
(cond (debug
(set-process-sentinel process 'ignore)
(set-process-filter process 'ignore)
(delete-process process))
(t
(run-hook-with-args 'slime-net-process-close-hooks process)
;; killing the buffer also closes the socket
(kill-buffer (process-buffer process)))))
(defun slime-net-sentinel (process message)
(message "Lisp connection closed unexpectedly: %s" message)
(slime-net-close process))
;;; Socket input is handled by `slime-net-filter', which decodes any
;;; complete messages and hands them off to the event dispatcher.
(defun slime-net-filter (process string)
"Accept output from the socket and process all complete messages."
(with-current-buffer (process-buffer process)
(goto-char (point-max))
(insert string))
(slime-process-available-input process))
(defun slime-process-available-input (process)
"Process all complete messages that have arrived from Lisp."
(with-current-buffer (process-buffer process)
(while (slime-net-have-input-p)
(let ((event (slime-net-read-or-lose process))
(ok nil))
(slime-log-event event)
(unwind-protect
(save-current-buffer
(slime-dispatch-event event process)
(setq ok t))
(unless ok
(slime-run-when-idle 'slime-process-available-input process)))))))
(defun slime-net-have-input-p ()
"Return true if a complete message is available."
(goto-char (point-min))
(and (>= (buffer-size) 6)
(>= (- (buffer-size) 6) (slime-net-decode-length))))
(defun slime-run-when-idle (function &rest args)
"Call FUNCTION as soon as Emacs is idle."
(apply #'run-at-time 0 nil function args))
(defun slime-handle-net-read-error (error)
(let ((packet (buffer-string)))
(slime-with-popup-buffer ((slime-buffer-name :error))
(princ (format "%s\nin packet:\n%s" (error-message-string error) packet))
(goto-char (point-min)))
(cond ((y-or-n-p "Skip this packet? ")
`(:emacs-skipped-packet ,packet))
(t
(when (y-or-n-p "Enter debugger instead? ")
(debug 'error error))
(signal (car error) (cdr error))))))
(defun slime-net-read-or-lose (process)
(condition-case error
(slime-net-read)
(error
(slime-net-close process t)
(error "net-read error: %S" error))))
(defun slime-net-read ()
"Read a message from the network buffer."
(goto-char (point-min))
(let* ((length (slime-net-decode-length))
(start (+ (point) 6))
(end (+ start length)))
(cl-assert (cl-plusp length))
(prog1 (save-restriction
(narrow-to-region start end)
(condition-case error
(progn
(decode-coding-region start end 'utf-8-unix)
(setq end (point-max))
(read (current-buffer)))
(error
(slime-handle-net-read-error error))))
(delete-region (point-min) end))))
(defun slime-net-decode-length ()
(string-to-number (buffer-substring-no-properties (point) (+ (point) 6))
16))
(defun slime-net-encode-length (n)
(format "%06x" n))
(defun slime-prin1-to-string (sexp)
"Like `prin1-to-string' but don't octal-escape non-ascii characters.
This is more compatible with the CL reader."
(let (print-escape-nonascii
print-escape-newlines
print-length
print-level)
(prin1-to-string sexp)))
;;;; Connections
;;;
;;; "Connections" are the high-level Emacs<->Lisp networking concept.
;;;
;;; Emacs has a connection to each Lisp process that it's interacting
;;; with. Typically there would only be one, but a user can choose to
;;; connect to many Lisps simultaneously.
;;;
;;; A connection consists of a control socket, optionally an extra
;;; socket dedicated to receiving Lisp output (an optimization), and a
;;; set of connection-local state variables.
;;;
;;; The state variables are stored as buffer-local variables in the
;;; control socket's process-buffer and are used via accessor
;;; functions. These variables include things like the *FEATURES* list
;;; and Unix Pid of the Lisp process.
;;;
;;; One connection is "current" at any given time. This is:
;;; `slime-dispatching-connection' if dynamically bound, or
;;; `slime-buffer-connection' if this is set buffer-local, or
;;; `slime-default-connection' otherwise.
;;;
;;; When you're invoking commands in your source files you'll be using
;;; `slime-default-connection'. This connection can be interactively
;;; reassigned via the connection-list buffer.
;;;
;;; When a command creates a new buffer it will set
;;; `slime-buffer-connection' so that commands in the new buffer will
;;; use the connection that the buffer originated from. For example,
;;; the apropos command creates the *Apropos* buffer and any command
;;; in that buffer (e.g. `M-.') will go to the same Lisp that did the
;;; apropos search. REPL buffers are similarly tied to their
;;; respective connections.
;;;
;;; When Emacs is dispatching some network message that arrived from a
;;; connection it will dynamically bind `slime-dispatching-connection'
;;; so that the event will be processed in the context of that
;;; connection.
;;;
;;; This is mostly transparent. The user should be aware that he can
;;; set the default connection to pick which Lisp handles commands in
;;; Lisp-mode source buffers, and slime hackers should be aware that
;;; they can tie a buffer to a specific connection. The rest takes
;;; care of itself.
(defvar slime-dispatching-connection nil
"Network process currently executing.
This is dynamically bound while handling messages from Lisp; it
overrides `slime-buffer-connection' and `slime-default-connection'.")
(make-variable-buffer-local
(defvar slime-buffer-connection nil
"Network connection to use in the current buffer.
This overrides `slime-default-connection'."))
(defvar slime-default-connection nil
"Network connection to use by default.
Used for all Lisp communication, except when overridden by
`slime-dispatching-connection' or `slime-buffer-connection'.")
(defun slime-current-connection ()
"Return the connection to use for Lisp interaction.
Return nil if there's no connection."
(or slime-dispatching-connection
slime-buffer-connection
slime-default-connection))
(defun slime-connection ()
"Return the connection to use for Lisp interaction.
Signal an error if there's no connection."
(let ((conn (slime-current-connection)))
(cond ((and (not conn) slime-net-processes)
(or (slime-auto-select-connection)
(error "No default connection selected.")))
((not conn)
(or (slime-auto-start)
(error "Not connected.")))
((not (eq (process-status conn) 'open))
(error "Connection closed."))
(t conn))))
(define-obsolete-variable-alias 'slime-auto-connect
'slime-auto-start "2.5")
(defcustom slime-auto-start 'never
"Controls auto connection when information from lisp process is needed.
This doesn't mean it will connect right after Slime is loaded."
:group 'slime-mode
:type '(choice (const never)
(const always)
(const ask)))
(defun slime-auto-start ()
(cond ((or (eq slime-auto-start 'always)
(and (eq slime-auto-start 'ask)
(y-or-n-p "No connection. Start Slime? ")))
(save-window-excursion
(slime)
(while (not (slime-current-connection))
(sleep-for 1))
(slime-connection)))
(t nil)))
(defcustom slime-auto-select-connection 'ask
"Controls auto selection after the default connection was closed."
:group 'slime-mode
:type '(choice (const never)
(const always)
(const ask)))
(defun slime-auto-select-connection ()
(let* ((c0 (car slime-net-processes))
(c (cond ((eq slime-auto-select-connection 'always) c0)
((and (eq slime-auto-select-connection 'ask)
(y-or-n-p
(format "No default connection selected. %s %s? "
"Switch to" (slime-connection-name c0))))
c0))))
(when c
(slime-select-connection c)
(message "Switching to connection: %s" (slime-connection-name c))
c)))
(defun slime-select-connection (process)
"Make PROCESS the default connection."
(setq slime-default-connection process))
(defvar slime-cycle-connections-hook nil)
(defun slime-cycle-connections-within (connections)
(let* ((tail (or (cdr (member (slime-current-connection) connections))
connections)) ; loop around to the beginning
(next (car tail)))
(slime-select-connection next)
(run-hooks 'slime-cycle-connections-hook)
(message "Lisp: %s %s"
(slime-connection-name next)
(process-contact next))))
(defun slime-next-connection ()
"Change current slime connection, cycling through all connections."
(interactive)
(slime-cycle-connections-within (reverse slime-net-processes)))
(define-obsolete-function-alias 'slime-cycle-connections
'slime-next-connection "2.13")
(defun slime-prev-connection ()
"Change current slime connection, cycling through all connections.
Goes in reverse order, relative to `slime-next-connection'."
(interactive)
(slime-cycle-connections-within slime-net-processes))
(cl-defmacro slime-with-connection-buffer ((&optional process) &rest body)
"Execute BODY in the process-buffer of PROCESS.
If PROCESS is not specified, `slime-connection' is used.
\(fn (&optional PROCESS) &body BODY))"
(declare (indent 1))
`(with-current-buffer
(process-buffer (or ,process (slime-connection)
(error "No connection")))
,@body))
;;; Connection-local variables:
(defmacro slime-def-connection-var (varname &rest initial-value-and-doc)
"Define a connection-local variable.
The value of the variable can be read by calling the function of the
same name (it must not be accessed directly). The accessor function is
setf-able.
The actual variable bindings are stored buffer-local in the
process-buffers of connections. The accessor function refers to
the binding for `slime-connection'."
(declare (indent 2))
(let ((real-var (intern (format "%s:connlocal" varname))))
`(progn
;; Variable
(make-variable-buffer-local
(defvar ,real-var ,@initial-value-and-doc))
;; Accessor
(defun ,varname (&optional process)
(slime-with-connection-buffer (process) ,real-var))
;; Setf
(defsetf ,varname (&optional process) (store)
`(slime-with-connection-buffer (,process)
(setq (\, (quote (\, real-var))) (\, store))))
'(\, varname))))
(slime-def-connection-var slime-connection-number nil
"Serial number of a connection.
Bound in the connection's process-buffer.")
(slime-def-connection-var slime-lisp-features '()
"The symbol-names of Lisp's *FEATURES*.
This is automatically synchronized from Lisp.")
(slime-def-connection-var slime-lisp-modules '()
"The strings of Lisp's *MODULES*.")
(slime-def-connection-var slime-pid nil
"The process id of the Lisp process.")
(slime-def-connection-var slime-lisp-implementation-type nil
"The implementation type of the Lisp process.")
(slime-def-connection-var slime-lisp-implementation-version nil
"The implementation type of the Lisp process.")
(slime-def-connection-var slime-lisp-implementation-name nil
"The short name for the Lisp implementation.")
(slime-def-connection-var slime-lisp-implementation-program nil
"The argv[0] of the process running the Lisp implementation.")
(slime-def-connection-var slime-connection-name nil
"The short name for connection.")
(slime-def-connection-var slime-inferior-process nil
"The inferior process for the connection if any.")
(slime-def-connection-var slime-communication-style nil
"The communication style.")
(slime-def-connection-var slime-machine-instance nil
"The name of the (remote) machine running the Lisp process.")
(slime-def-connection-var slime-connection-coding-systems nil
"Coding systems supported by the Lisp process.")
;;;;; Connection setup
(defvar slime-connection-counter 0
"The number of SLIME connections made. For generating serial numbers.")
;;; Interface
(defun slime-setup-connection (process)
"Make a connection out of PROCESS."
(let ((slime-dispatching-connection process))
(slime-init-connection-state process)
(slime-select-connection process)
process))
(defun slime-init-connection-state (proc)
"Initialize connection state in the process-buffer of PROC."
;; To make life simpler for the user: if this is the only open
;; connection then reset the connection counter.
(when (equal slime-net-processes (list proc))
(setq slime-connection-counter 0))
(slime-with-connection-buffer ()
(setq slime-buffer-connection proc))
(setf (slime-connection-number proc) (cl-incf slime-connection-counter))
;; We do the rest of our initialization asynchronously. The current
;; function may be called from a timer, and if we setup the REPL
;; from a timer then it mysteriously uses the wrong keymap for the
;; first command.
(let ((slime-current-thread t))
(slime-eval-async '(swank:connection-info)
(slime-curry #'slime-set-connection-info proc))))
(defun slime-set-connection-info (connection info)
"Initialize CONNECTION with INFO received from Lisp."
(let ((slime-dispatching-connection connection)
(slime-current-thread t))
(cl-destructuring-bind (&key pid style lisp-implementation machine
features version modules encoding
&allow-other-keys) info
(slime-check-version version connection)
(setf (slime-pid) pid
(slime-communication-style) style
(slime-lisp-features) features
(slime-lisp-modules) modules)
(cl-destructuring-bind (&key type name version program)
lisp-implementation
(setf (slime-lisp-implementation-type) type
(slime-lisp-implementation-version) version
(slime-lisp-implementation-name) name
(slime-lisp-implementation-program) program
(slime-connection-name) (slime-generate-connection-name name)))
(cl-destructuring-bind (&key instance ((:type _)) ((:version _))) machine
(setf (slime-machine-instance) instance))
(cl-destructuring-bind (&key coding-systems) encoding
(setf (slime-connection-coding-systems) coding-systems)))
(let ((args (let ((p (slime-inferior-process)))
(if p (slime-inferior-lisp-args p)))))
(let ((name (plist-get args ':name)))
(when name
(unless (string= (slime-lisp-implementation-name) name)
(setf (slime-connection-name)
(slime-generate-connection-name (symbol-name name))))))
(slime-load-contribs)
(run-hooks 'slime-connected-hook)
(let ((fun (plist-get args ':init-function)))
(when fun (funcall fun))))
(message "Connected. %s" (slime-random-words-of-encouragement))))
(defun slime-check-version (version conn)
(or (equal version slime-protocol-version)
(equal slime-protocol-version 'ignore)
(y-or-n-p
(format "Versions differ: %s (slime) vs. %s (swank). Continue? "
slime-protocol-version version))
(slime-net-close conn)
(top-level)))
(defun slime-generate-connection-name (lisp-name)
(cl-loop for i from 1
for name = lisp-name then (format "%s<%d>" lisp-name i)
while (cl-find name slime-net-processes
:key #'slime-connection-name :test #'equal)
finally (cl-return name)))
(defun slime-connection-close-hook (process)
(when (eq process slime-default-connection)
(when slime-net-processes
(slime-select-connection (car slime-net-processes))
(message "Default connection closed; switched to #%S (%S)"
(slime-connection-number)
(slime-connection-name)))))
(add-hook 'slime-net-process-close-hooks 'slime-connection-close-hook)
;;;;; Commands on connections
(defun slime-disconnect ()
"Close the current connection."
(interactive)
(slime-net-close (slime-connection)))
(defun slime-disconnect-all ()
"Disconnect all connections."
(interactive)
(mapc #'slime-net-close slime-net-processes))
(defun slime-connection-port (connection)
"Return the remote port number of CONNECTION."
(cadr (process-contact connection)))
(defun slime-process (&optional connection)
"Return the Lisp process for CONNECTION (default `slime-connection').
Return nil if there's no process object for the connection."
(let ((proc (slime-inferior-process connection)))
(if (and proc
(memq (process-status proc) '(run stop)))
proc)))
;; Non-macro version to keep the file byte-compilable.
(defun slime-set-inferior-process (connection process)
(setf (slime-inferior-process connection) process))
(defun slime-use-sigint-for-interrupt (&optional connection)
(let ((c (or connection (slime-connection))))
(cl-ecase (slime-communication-style c)
((:fd-handler nil) t)
((:spawn :sigio) nil))))
(defvar slime-inhibit-pipelining t
"*If true, don't send background requests if Lisp is already busy.")
(defun slime-background-activities-enabled-p ()
(and (let ((con (slime-current-connection)))
(and con
(eq (process-status con) 'open)))
(or (not (slime-busy-p))
(not slime-inhibit-pipelining))))
;;;; Communication protocol
;;;;; Emacs Lisp programming interface
;;;
;;; The programming interface for writing Emacs commands is based on
;;; remote procedure calls (RPCs). The basic operation is to ask Lisp
;;; to apply a named Lisp function to some arguments, then to do
;;; something with the result.
;;;
;;; Requests can be either synchronous (blocking) or asynchronous
;;; (with the result passed to a callback/continuation function). If
;;; an error occurs during the request then the debugger is entered
;;; before the result arrives -- for synchronous evaluations this
;;; requires a recursive edit.
;;;
;;; You should use asynchronous evaluations (`slime-eval-async') for
;;; most things. Reserve synchronous evaluations (`slime-eval') for
;;; the cases where blocking Emacs is really appropriate (like
;;; completion) and that shouldn't trigger errors (e.g. not evaluate
;;; user-entered code).
;;;
;;; We have the concept of the "current Lisp package". RPC requests
;;; always say what package the user is making them from and the Lisp
;;; side binds that package to *BUFFER-PACKAGE* to use as it sees
;;; fit. The current package is defined as the buffer-local value of
;;; `slime-buffer-package' if set, and otherwise the package named by
;;; the nearest IN-PACKAGE as found by text search (cl-first backwards,
;;; then forwards).
;;;
;;; Similarly we have the concept of the current thread, i.e. which
;;; thread in the Lisp process should handle the request. The current
;;; thread is determined solely by the buffer-local value of
;;; `slime-current-thread'. This is usually bound to t meaning "no
;;; particular thread", but can also be used to nominate a specific
;;; thread. The REPL and the debugger both use this feature to deal
;;; with specific threads.
(make-variable-buffer-local
(defvar slime-current-thread t
"The id of the current thread on the Lisp side.
t means the \"current\" thread;
:repl-thread the thread that executes REPL requests;
fixnum a specific thread."))
(make-variable-buffer-local
(defvar slime-buffer-package nil
"The Lisp package associated with the current buffer.
This is set only in buffers bound to specific packages."))
;;; `slime-rex' is the RPC primitive which is used to implement both
;;; `slime-eval' and `slime-eval-async'. You can use it directly if
;;; you need to, but the others are usually more convenient.
(cl-defmacro slime-rex ((&rest saved-vars)
(sexp &optional
(package '(slime-current-package))
(thread 'slime-current-thread))
&rest continuations)
"(slime-rex (VAR ...) (SEXP &optional PACKAGE THREAD) CLAUSES ...)
Remote EXecute SEXP.
VARs are a list of saved variables visible in the other forms. Each
VAR is either a symbol or a list (VAR INIT-VALUE).
SEXP is evaluated and the princed version is sent to Lisp.
PACKAGE is evaluated and Lisp binds *BUFFER-PACKAGE* to this package.
The default value is (slime-current-package).
CLAUSES is a list of patterns with same syntax as
`slime-dcase'. The result of the evaluation of SEXP is
dispatched on CLAUSES. The result is either a sexp of the
form (:ok VALUE) or (:abort CONDITION). CLAUSES is executed
asynchronously.
Note: don't use backquote syntax for SEXP, because various Emacs
versions cannot deal with that."
(declare (indent 2))
(let ((result (cl-gensym)))
`(lexical-let ,(cl-loop for var in saved-vars
collect (cl-etypecase var
(symbol (list var var))
(cons var)))
(slime-dispatch-event
(list :emacs-rex ,sexp ,package ,thread
(lambda (,result)
(slime-dcase ,result
,@continuations)))))))
;;; Interface
(defun slime-current-package ()
"Return the Common Lisp package in the current context.
If `slime-buffer-package' has a value then return that, otherwise
search for and read an `in-package' form."
(or slime-buffer-package
(save-restriction
(widen)
(slime-find-buffer-package))))
(defvar slime-find-buffer-package-function 'slime-search-buffer-package
"*Function to use for `slime-find-buffer-package'.
The result should be the package-name (a string)
or nil if nothing suitable can be found.")
(defun slime-find-buffer-package ()
"Figure out which Lisp package the current buffer is associated with."
(funcall slime-find-buffer-package-function))
(make-variable-buffer-local
(defvar slime-package-cache nil
"Cons of the form (buffer-modified-tick . package)"))
;; When modifing this code consider cases like:
;; (in-package #.*foo*)
;; (in-package #:cl)
;; (in-package :cl)
;; (in-package "CL")
;; (in-package |CL|)
;; (in-package #+ansi-cl :cl #-ansi-cl 'lisp)
(defun slime-search-buffer-package ()
(let ((case-fold-search t)
(regexp (concat "^[ \t]*(\\(cl:\\|common-lisp:\\)?in-package\\>[ \t']*"
"\\([^)]+\\)[ \t]*)")))
(save-excursion
(when (or (re-search-backward regexp nil t)
(re-search-forward regexp nil t))
(match-string-no-properties 2)))))
;;; Synchronous requests are implemented in terms of asynchronous
;;; ones. We make an asynchronous request with a continuation function
;;; that `throw's its result up to a `catch' and then enter a loop of
;;; handling I/O until that happens.
(defvar slime-stack-eval-tags nil
"List of stack-tags of continuations waiting on the stack.")
(defun slime-eval (sexp &optional package)
"Evaluate EXPR on the superior Lisp and return the result."
(when (null package) (setq package (slime-current-package)))
(let* ((tag (cl-gensym (format "slime-result-%d-"
(1+ (slime-continuation-counter)))))
(slime-stack-eval-tags (cons tag slime-stack-eval-tags)))
(apply
#'funcall
(catch tag
(slime-rex (tag sexp)
(sexp package)
((:ok value)
(unless (member tag slime-stack-eval-tags)
(error "Reply to canceled synchronous eval request tag=%S sexp=%S"
tag sexp))
(throw tag (list #'identity value)))
((:abort _condition)
(throw tag (list #'error "Synchronous Lisp Evaluation aborted"))))
(let ((debug-on-quit t)
(inhibit-quit nil)
(conn (slime-connection)))
(while t
(unless (eq (process-status conn) 'open)
(error "Lisp connection closed unexpectedly"))
(accept-process-output nil 0.01)))))))
(defun slime-eval-async (sexp &optional cont package)
"Evaluate EXPR on the superior Lisp and call CONT with the result."
(declare (indent 1))
(slime-rex (cont (buffer (current-buffer)))
(sexp (or package (slime-current-package)))
((:ok result)
(when cont
(set-buffer buffer)
(funcall cont result)))
((:abort condition)
(message "Evaluation aborted on %s." condition)))
;; Guard against arbitrary return values which once upon a time
;; showed up in the minibuffer spuriously (due to a bug in
;; slime-autodoc.) If this ever happens again, returning the
;; following will make debugging much easier:
:slime-eval-async)
;;; These functions can be handy too:
(defun slime-connected-p ()
"Return true if the Swank connection is open."
(not (null slime-net-processes)))
(defun slime-check-connected ()
"Signal an error if we are not connected to Lisp."
(unless (slime-connected-p)
(error "Not connected. Use `%s' to start a Lisp."
(substitute-command-keys "\\[slime]"))))
;; UNUSED
(defun slime-debugged-connection-p (conn)
;; This previously was (AND (SLDB-DEBUGGED-CONTINUATIONS CONN) T),
;; but an SLDB buffer may exist without having continuations
;; attached to it, e.g. the one resulting from `slime-interrupt'.
(cl-loop for b in (sldb-buffers)
thereis (with-current-buffer b
(eq slime-buffer-connection conn))))
(defun slime-busy-p (&optional conn)
"True if Lisp has outstanding requests.
Debugged requests are ignored."
(let ((debugged (sldb-debugged-continuations (or conn (slime-connection)))))
(cl-remove-if (lambda (id)
(memq id debugged))
(slime-rex-continuations)
:key #'car)))
(defun slime-sync ()
"Block until the most recent request has finished."
(when (slime-rex-continuations)
(let ((tag (caar (slime-rex-continuations))))
(while (cl-find tag (slime-rex-continuations) :key #'car)
(accept-process-output nil 0.1)))))
(defun slime-ping ()
"Check that communication works."
(interactive)
(message "%s" (slime-eval "PONG")))
;;;;; Protocol event handler (cl-the guts)
;;;
;;; This is the protocol in all its glory. The input to this function
;;; is a protocol event that either originates within Emacs or arrived
;;; over the network from Lisp.
;;;
;;; Each event is a list beginning with a keyword and followed by
;;; arguments. The keyword identifies the type of event. Events
;;; originating from Emacs have names starting with :emacs- and events
;;; from Lisp don't.
(slime-def-connection-var slime-rex-continuations '()
"List of (ID . FUNCTION) continuations waiting for RPC results.")
(slime-def-connection-var slime-continuation-counter 0
"Continuation serial number counter.")
(defvar slime-event-hooks)
(defun slime-dispatch-event (event &optional process)
(let ((slime-dispatching-connection (or process (slime-connection))))
(or (run-hook-with-args-until-success 'slime-event-hooks event)
(slime-dcase event
((:emacs-rex form package thread continuation)
(when (and (slime-use-sigint-for-interrupt) (slime-busy-p))
(slime-display-oneliner "; pipelined request... %S" form))
(let ((id (cl-incf (slime-continuation-counter))))
(slime-send `(:emacs-rex ,form ,package ,thread ,id))
(push (cons id continuation) (slime-rex-continuations))
(slime--recompute-modelines)))
((:return value id)
(let ((rec (assq id (slime-rex-continuations))))
(cond (rec (setf (slime-rex-continuations)
(remove rec (slime-rex-continuations)))
(slime--recompute-modelines)
(funcall (cdr rec) value))
(t
(error "Unexpected reply: %S %S" id value)))))
((:debug-activate thread level &optional select)
(cl-assert thread)
(sldb-activate thread level select))
((:debug thread level condition restarts frames conts)
(cl-assert thread)
(sldb-setup thread level condition restarts frames conts))
((:debug-return thread level stepping)
(cl-assert thread)
(sldb-exit thread level stepping))
((:emacs-interrupt thread)
(slime-send `(:emacs-interrupt ,thread)))
((:channel-send id msg)
(slime-channel-send (or (slime-find-channel id)
(error "Invalid channel id: %S %S" id msg))
msg))
((:emacs-channel-send id msg)
(slime-send `(:emacs-channel-send ,id ,msg)))
((:read-from-minibuffer thread tag prompt initial-value)
(slime-read-from-minibuffer-for-swank thread tag prompt
initial-value))
((:y-or-n-p thread tag question)
(slime-y-or-n-p thread tag question))
((:emacs-return-string thread tag string)
(slime-send `(:emacs-return-string ,thread ,tag ,string)))
((:new-features features)
(setf (slime-lisp-features) features))
((:indentation-update info)
(slime-handle-indentation-update info))
((:eval-no-wait form)
(slime-check-eval-in-emacs-enabled)
(eval (read form)))
((:eval thread tag form-string)
(slime-check-eval-in-emacs-enabled)
(slime-eval-for-lisp thread tag form-string))
((:ed-rpc-no-wait fn-name &rest args)
(let ((fn (intern-soft fn-name)))
(slime-check-rpc-allowed fn)
(apply fn args)))
((:ed-rpc thread tag fn-name &rest args)
(slime-rpc-from-lisp thread tag (intern-soft fn-name) args))
((:emacs-return thread tag value)
(slime-send `(:emacs-return ,thread ,tag ,value)))
((:ed what)
(slime-ed what))
((:inspect what thread tag)
(let ((hook (when (and thread tag)
(slime-curry #'slime-send
`(:emacs-return ,thread ,tag nil)))))
(slime-open-inspector what nil hook)))
((:background-message message)
(slime-background-message "%s" message))
((:debug-condition thread message)
(cl-assert thread)
(message "%s" message))
((:ping thread tag)
(slime-send `(:emacs-pong ,thread ,tag)))
((:reader-error packet condition)
(slime-with-popup-buffer ((slime-buffer-name :error))
(princ (format "Invalid protocol message:\n%s\n\n%s"
condition packet))
(goto-char (point-min)))
(error "Invalid protocol message"))
((:invalid-rpc id message)
(setf (slime-rex-continuations)
(cl-remove id (slime-rex-continuations) :key #'car))
(error "Invalid rpc: %s" message))
((:emacs-skipped-packet _pkg))
((:test-delay seconds) ; for testing only
(sit-for seconds))))))
(defun slime-send (sexp)
"Send SEXP directly over the wire on the current connection."
(slime-net-send sexp (slime-connection)))
(defun slime-reset ()
"Clear all pending continuations and erase connection buffer."
(interactive)
(setf (slime-rex-continuations) '())
(mapc #'kill-buffer (sldb-buffers))
(slime-with-connection-buffer ()
(erase-buffer)))
(defun slime-send-sigint ()
(interactive)
(signal-process (slime-pid) 'SIGINT))
;;;;; Channels
;;; A channel implements a set of operations. Those operations can be
;;; invoked by sending messages to the channel. Channels are used for
;;; protocols which can't be expressed naturally with RPCs, e.g. for
;;; streaming data over the wire.
;;;
;;; A channel can be "remote" or "local". Remote channels are
;;; represented by integers. Local channels are structures. Messages
;;; sent to a closed (remote) channel are ignored.
(slime-def-connection-var slime-channels '()
"Alist of the form (ID . CHANNEL).")
(slime-def-connection-var slime-channels-counter 0
"Channel serial number counter.")
(cl-defstruct (slime-channel (:conc-name slime-channel.)
(:constructor
slime-make-channel% (operations name id plist)))
operations name id plist)
(defun slime-make-channel (operations &optional name)
(let* ((id (cl-incf (slime-channels-counter)))
(ch (slime-make-channel% operations name id nil)))
(push (cons id ch) (slime-channels))
ch))
(defun slime-close-channel (channel)
(setf (slime-channel.operations channel) 'closed-channel)
(let ((probe (assq (slime-channel.id channel) (slime-channels))))
(cond (probe (setf (slime-channels) (delete probe (slime-channels))))
(t (error "Invalid channel: %s" channel)))))
(defun slime-find-channel (id)
(cdr (assq id (slime-channels))))
(defun slime-channel-send (channel message)
(apply (or (gethash (car message) (slime-channel.operations channel))
(error "Unsupported operation: %S %S" message channel))
channel (cdr message)))
(defun slime-channel-put (channel prop value)
(setf (slime-channel.plist channel)
(plist-put (slime-channel.plist channel) prop value)))
(defun slime-channel-get (channel prop)
(plist-get (slime-channel.plist channel) prop))
(eval-and-compile
(defun slime-channel-method-table-name (type)
(intern (format "slime-%s-channel-methods" type))))
(defmacro slime-define-channel-type (name)
(declare (indent defun))
(let ((tab (slime-channel-method-table-name name)))
`(progn
(defvar ,tab)
(setq ,tab (make-hash-table :size 10)))))
(defmacro slime-define-channel-method (type method args &rest body)
(declare (indent 3) (debug (&define name sexp lambda-list
def-body)))
`(puthash ',method
(lambda (self . ,args) . ,body)
,(slime-channel-method-table-name type)))
(defun slime-send-to-remote-channel (channel-id msg)
(slime-dispatch-event `(:emacs-channel-send ,channel-id ,msg)))
;;;;; Event logging to *slime-events*
;;;
;;; The *slime-events* buffer logs all protocol messages for debugging
;;; purposes. Optionally you can enable outline-mode in that buffer,
;;; which is convenient but slows things down significantly.
(defvar slime-log-events t
"*Log protocol events to the *slime-events* buffer.")
(defvar slime-outline-mode-in-events-buffer nil
"*Non-nil means use outline-mode in *slime-events*.")
(defvar slime-event-buffer-name (slime-buffer-name :events)
"The name of the slime event buffer.")
(defun slime-log-event (event)
"Record the fact that EVENT occurred."
(when slime-log-events
(with-current-buffer (slime-events-buffer)
;; trim?
(when (> (buffer-size) 100000)
(goto-char (/ (buffer-size) 2))
(re-search-forward "^(" nil t)
(delete-region (point-min) (point)))
(goto-char (point-max))
(save-excursion
(slime-pprint-event event (current-buffer)))
(when (and (boundp 'outline-minor-mode)
outline-minor-mode)
(hide-entry))
(goto-char (point-max)))))
(defun slime-pprint-event (event buffer)
"Pretty print EVENT in BUFFER with limited depth and width."
(let ((print-length 20)
(print-level 6)
(pp-escape-newlines t))
(pp event buffer)))
(defun slime-events-buffer ()
"Return or create the event log buffer."
(or (get-buffer slime-event-buffer-name)
(let ((buffer (get-buffer-create slime-event-buffer-name)))
(with-current-buffer buffer
(buffer-disable-undo)
(set (make-local-variable 'outline-regexp) "^(")
(set (make-local-variable 'comment-start) ";")
(set (make-local-variable 'comment-end) "")
(when slime-outline-mode-in-events-buffer
(outline-minor-mode)))
buffer)))
;;;;; Cleanup after a quit
(defun slime-restart-inferior-lisp ()
"Kill and restart the Lisp subprocess."
(interactive)
(cl-assert (slime-inferior-process) () "No inferior lisp process")
(slime-quit-lisp-internal (slime-connection) 'slime-restart-sentinel t))
(defun slime-restart-sentinel (process _message)
"Restart the inferior lisp process.
Also rearrange windows."
(cl-assert (process-status process) 'closed)
(let* ((proc (slime-inferior-process process))
(args (slime-inferior-lisp-args proc))
(buffer (buffer-name (process-buffer proc)))
;;(buffer-window (get-buffer-window buffer))
(new-proc (slime-start-lisp (plist-get args :program)
(plist-get args :program-args)
(plist-get args :env)
nil
buffer)))
(slime-net-close process)
(slime-inferior-connect new-proc args)
(switch-to-buffer buffer)
(goto-char (point-max))))
;;;; Compilation and the creation of compiler-note annotations
(defvar slime-highlight-compiler-notes t
"*When non-nil annotate buffers with compilation notes etc.")
(defvar slime-before-compile-functions nil
"A list of function called before compiling a buffer or region.
The function receive two arguments: the beginning and the end of the
region that will be compiled.")
;; FIXME: remove some of the options
(defcustom slime-compilation-finished-hook 'slime-maybe-show-compilation-log
"Hook called with a list of compiler notes after a compilation."
:group 'slime-mode
:type 'hook
:options '(slime-maybe-show-compilation-log
slime-create-compilation-log
slime-show-compilation-log
slime-maybe-list-compiler-notes
slime-list-compiler-notes
slime-maybe-show-xrefs-for-notes
slime-goto-first-note))
;; FIXME: I doubt that anybody uses this directly and it seems to be
;; only an ugly way to pass arguments.
(defvar slime-compilation-policy nil
"When non-nil compile with these optimization settings.")
(defun slime-compute-policy (arg)
"Return the policy for the prefix argument ARG."
(let ((between (lambda (min n max)
(cond ((< n min) min)
((> n max) max)
(t n)))))
(let ((n (prefix-numeric-value arg)))
(cond ((not arg) slime-compilation-policy)
((cl-plusp n) `((cl:debug . ,(funcall between 0 n 3))))
((eq arg '-) `((cl:speed . 3)))
(t `((cl:speed . ,(funcall between 0 (abs n) 3))))))))
(cl-defstruct (slime-compilation-result
(:type list)
(:conc-name slime-compilation-result.)
(:constructor nil)
(:copier nil))
tag notes successp duration loadp faslfile)
(defvar slime-last-compilation-result nil
"The result of the most recently issued compilation.")
(defun slime-compiler-notes ()
"Return all compiler notes, warnings, and errors."
(slime-compilation-result.notes slime-last-compilation-result))
(defun slime-compile-and-load-file (&optional policy)
"Compile and load the buffer's file and highlight compiler notes.
With (positive) prefix argument the file is compiled with maximal
debug settings (`C-u'). With negative prefix argument it is compiled for
speed (`M--'). If a numeric argument is passed set debug or speed settings
to it depending on its sign.
Each source location that is the subject of a compiler note is
underlined and annotated with the relevant information. The commands
`slime-next-note' and `slime-previous-note' can be used to navigate
between compiler notes and to display their full details."
(interactive "P")
(slime-compile-file t (slime-compute-policy policy)))
(defcustom slime-compile-file-options '()
"Plist of additional options that C-c C-k should pass to Lisp.
Currently only :fasl-directory is supported."
:group 'slime-lisp
:type '(plist :key-type symbol :value-type (file :must-match t)))
(defun slime-compile-file (&optional load policy)
"Compile current buffer's file and highlight resulting compiler notes.
See `slime-compile-and-load-file' for further details."
(interactive)
(unless buffer-file-name
(error "Buffer %s is not associated with a file." (buffer-name)))
(check-parens)
(slime--maybe-save-buffer)
(run-hook-with-args 'slime-before-compile-functions (point-min) (point-max))
(let ((file (slime-to-lisp-filename (buffer-file-name)))
(options (slime-simplify-plist `(,@slime-compile-file-options
:policy ,policy))))
(slime-eval-async
`(swank:compile-file-for-emacs ,file ,(if load t nil)
. ,(slime-hack-quotes options))
#'slime-compilation-finished)
(message "Compiling %s..." file)))
;; FIXME: compilation-save-buffers-predicate was introduced in 24.1
(defun slime--maybe-save-buffer ()
(let ((slime--this-buffer (current-buffer)))
(save-some-buffers (not compilation-ask-about-save)
(lambda () (eq (current-buffer) slime--this-buffer)))))
(defun slime-hack-quotes (arglist)
;; eval is the wrong primitive, we really want funcall
(cl-loop for arg in arglist collect `(quote ,arg)))
(defun slime-simplify-plist (plist)
(cl-loop for (key val) on plist by #'cddr
append (cond ((null val) '())
(t (list key val)))))
(defun slime-compile-defun (&optional raw-prefix-arg)
"Compile the current toplevel form.
With (positive) prefix argument the form is compiled with maximal
debug settings (`C-u'). With negative prefix argument it is compiled for
speed (`M--'). If a numeric argument is passed set debug or speed settings
to it depending on its sign."
(interactive "P")
(let ((slime-compilation-policy (slime-compute-policy raw-prefix-arg)))
(if (use-region-p)
(slime-compile-region (region-beginning) (region-end))
(apply #'slime-compile-region (slime-region-for-defun-at-point)))))
(defun slime-compile-region (start end)
"Compile the region."
(interactive "r")
;; Check connection before running hooks things like
;; slime-flash-region don't make much sense if there's no connection
(slime-connection)
(slime-flash-region start end)
(run-hook-with-args 'slime-before-compile-functions start end)
(slime-compile-string (buffer-substring-no-properties start end) start))
(defun slime-flash-region (start end &optional timeout)
"Temporarily highlight region from START to END."
(let ((overlay (make-overlay start end)))
(overlay-put overlay 'face 'secondary-selection)
(run-with-timer (or timeout 0.2) nil 'delete-overlay overlay)))
(defun slime-compile-string (string start-offset)
(let* ((line (save-excursion
(goto-char start-offset)
(list (line-number-at-pos) (1+ (current-column)))))
(position `((:position ,start-offset) (:line ,@line))))
(slime-eval-async
`(swank:compile-string-for-emacs
,string
,(buffer-name)
',position
,(if (buffer-file-name) (slime-to-lisp-filename (buffer-file-name)))
',slime-compilation-policy)
#'slime-compilation-finished)))
(defcustom slime-load-failed-fasl 'ask
"Which action to take when COMPILE-FILE set FAILURE-P to T.
NEVER doesn't load the fasl
ALWAYS loads the fasl
ASK asks the user."
:type '(choice (const never)
(const always)
(const ask)))
(defun slime-load-failed-fasl-p ()
(cl-ecase slime-load-failed-fasl
(never nil)
(always t)
(ask (y-or-n-p "Compilation failed. Load fasl file anyway? "))))
(defun slime-compilation-finished (result)
(with-struct (slime-compilation-result. notes duration successp
loadp faslfile) result
(setf slime-last-compilation-result result)
(slime-show-note-counts notes duration (cond ((not loadp) successp)
(t (and faslfile successp))))
(when slime-highlight-compiler-notes
(slime-highlight-notes notes))
(run-hook-with-args 'slime-compilation-finished-hook notes)
(when (and loadp faslfile
(or successp
(slime-load-failed-fasl-p)))
(slime-eval-async `(swank:load-file ,faslfile)))))
(defun slime-show-note-counts (notes secs successp)
(message (concat
(cond (successp "Compilation finished")
(t (slime-add-face 'font-lock-warning-face
"Compilation failed")))
(if (null notes) ". (No warnings)" ": ")
(mapconcat
(lambda (messages)
(cl-destructuring-bind (sev . notes) messages
(let ((len (length notes)))
(format "%d %s%s" len (slime-severity-label sev)
(if (= len 1) "" "s")))))
(sort (slime-alistify notes #'slime-note.severity #'eq)
(lambda (x y) (slime-severity< (car y) (car x))))
" ")
(if secs (format " [%.2f secs]" secs)))))
(defun slime-highlight-notes (notes)
"Highlight compiler notes, warnings, and errors in the buffer."
(interactive (list (slime-compiler-notes)))
(with-temp-message "Highlighting notes..."
(save-excursion
(save-restriction
(widen) ; highlight notes on the whole buffer
(slime-remove-old-overlays)
(mapc #'slime-overlay-note (slime-merge-notes-for-display notes))))))
(defvar slime-note-overlays '()
"List of overlays created by `slime-make-note-overlay'")
(defun slime-remove-old-overlays ()
"Delete the existing note overlays."
(mapc #'delete-overlay slime-note-overlays)
(setq slime-note-overlays '()))
(defun slime-filter-buffers (predicate)
"Return a list of where PREDICATE returns true.
PREDICATE is executed in the buffer to test."
(cl-remove-if-not (lambda (%buffer)
(with-current-buffer %buffer
(funcall predicate)))
(buffer-list)))
;;;;; Recompilation.
;; FIXME: This whole idea is questionable since it depends so
;; crucially on precise source-locs.
(defun slime-recompile-location (location)
(save-excursion
(slime-goto-source-location location)
(slime-compile-defun)))
(defun slime-recompile-locations (locations cont)
(slime-eval-async
`(swank:compile-multiple-strings-for-emacs
',(cl-loop for loc in locations collect
(save-excursion
(slime-goto-source-location loc)
(cl-destructuring-bind (start end)
(slime-region-for-defun-at-point)
(list (buffer-substring-no-properties start end)
(buffer-name)
(slime-current-package)
start
(if (buffer-file-name)
(slime-to-lisp-filename (buffer-file-name))
nil)))))
',slime-compilation-policy)
cont))
;;;;; Merging together compiler notes in the same location.
(defun slime-merge-notes-for-display (notes)
"Merge together notes that refer to the same location.
This operation is \"lossy\" in the broad sense but not for display purposes."
(mapcar #'slime-merge-notes
(slime-group-similar 'slime-notes-in-same-location-p notes)))
(defun slime-merge-notes (notes)
"Merge NOTES together. Keep the highest severity, concatenate the messages."
(let* ((new-severity (cl-reduce #'slime-most-severe notes
:key #'slime-note.severity))
(new-message (mapconcat #'slime-note.message notes "\n")))
(let ((new-note (cl-copy-list (car notes))))
(setf (cl-getf new-note :message) new-message)
(setf (cl-getf new-note :severity) new-severity)
new-note)))
(defun slime-notes-in-same-location-p (a b)
(equal (slime-note.location a) (slime-note.location b)))
;;;;; Compiler notes list
(defun slime-one-line-ify (string)
"Return a single-line version of STRING.
Each newlines and following indentation is replaced by a single space."
(with-temp-buffer
(insert string)
(goto-char (point-min))
(while (re-search-forward "\n[\n \t]*" nil t)
(replace-match " "))
(buffer-string)))
(defun slime-xrefs-for-notes (notes)
(let ((xrefs))
(dolist (note notes)
(let* ((location (cl-getf note :location))
(fn (cadr (assq :file (cdr location))))
(file (assoc fn xrefs))
(node
(list (format "%s: %s"
(cl-getf note :severity)
(slime-one-line-ify (cl-getf note :message)))
location)))
(when fn
(if file
(push node (cdr file))
(setf xrefs (cl-acons fn (list node) xrefs))))))
xrefs))
(defun slime-maybe-show-xrefs-for-notes (notes)
"Show the compiler notes NOTES if they come from more than one file."
(let ((xrefs (slime-xrefs-for-notes notes)))
(when (slime-length> xrefs 1) ; >1 file
(slime-show-xrefs
xrefs 'definition "Compiler notes" (slime-current-package)))))
(defun slime-note-has-location-p (note)
(not (eq ':error (car (slime-note.location note)))))
(defun slime-redefinition-note-p (note)
(eq (slime-note.severity note) :redefinition))
(defun slime-create-compilation-log (notes)
"Create a buffer for `next-error' to use."
(with-current-buffer (get-buffer-create (slime-buffer-name :compilation))
(let ((inhibit-read-only t))
(erase-buffer))
(slime-insert-compilation-log notes)
(compilation-mode)))
(defun slime-maybe-show-compilation-log (notes)
"Display the log on failed compilations or if NOTES is non-nil."
(slime-create-compilation-log notes)
(with-struct (slime-compilation-result. notes duration successp)
slime-last-compilation-result
(unless successp
(with-current-buffer (slime-buffer-name :compilation)
(let ((inhibit-read-only t))
(goto-char (point-max))
(insert "Compilation " (if successp "succeeded." "failed."))
(goto-char (point-min))
(display-buffer (current-buffer)))))))
(defun slime-show-compilation-log (notes)
"Create and display the compilation log buffer."
(interactive (list (slime-compiler-notes)))
(slime-with-popup-buffer ((slime-buffer-name :compilation)
:mode 'compilation-mode)
(slime-insert-compilation-log notes)))
(defun slime-insert-compilation-log (notes)
"Insert NOTES in format suitable for `compilation-mode'."
(cl-destructuring-bind (grouped-notes canonicalized-locs-table)
(slime-group-and-sort-notes notes)
(with-temp-message "Preparing compilation log..."
(let ((inhibit-read-only t)
(inhibit-modification-hooks t)) ; inefficient font-lock-hook
(insert (format "cd %s\n%d compiler notes:\n\n"
default-directory (length notes)))
(dolist (notes grouped-notes)
(let ((loc (gethash (cl-first notes) canonicalized-locs-table))
(start (point)))
(insert (slime-canonicalized-location-to-string loc) ":")
(slime-insert-note-group notes)
(insert "\n")
(slime-make-note-overlay (cl-first notes) start (1- (point))))))
(set (make-local-variable 'compilation-skip-threshold) 0)
(setq next-error-last-buffer (current-buffer)))))
(defun slime-insert-note-group (notes)
"Insert a group of compiler messages."
(insert "\n")
(dolist (note notes)
(insert " " (slime-severity-label (slime-note.severity note)) ": ")
(let ((start (point)))
(insert (slime-note.message note))
(let ((ctx (slime-note.source-context note)))
(if ctx (insert "\n" ctx)))
(slime-indent-block start 4))
(insert "\n")))
(defun slime-indent-block (start column)
"If the region back to START isn't a one-liner indent it."
(when (< start (line-beginning-position))
(save-excursion
(goto-char start)
(insert "\n"))
(slime-indent-rigidly start (point) column)))
(defun slime-canonicalized-location (location)
"Return a list (FILE LINE COLUMN) for slime-location LOCATION.
This is quite an expensive operation so use carefully."
(save-excursion
(slime-goto-location-buffer (slime-location.buffer location))
(save-excursion
(slime-goto-source-location location)
(list (or (buffer-file-name) (buffer-name))
(save-restriction
(widen)
(line-number-at-pos))
(1+ (current-column))))))
(defun slime-canonicalized-location-to-string (loc)
(if loc
(cl-destructuring-bind (filename line col) loc
(format "%s:%d:%d"
(cond ((not filename) "")
((let ((rel (file-relative-name filename)))
(if (< (length rel) (length filename))
rel)))
(t filename))
line col))
(format "Unknown location")))
(defun slime-goto-note-in-compilation-log (note)
"Find `note' in the compilation log and display it."
(with-current-buffer (get-buffer (slime-buffer-name :compilation))
(let ((pos
(save-excursion
(goto-char (point-min))
(cl-loop for overlay = (slime-find-next-note)
while overlay
for other-note = (overlay-get overlay 'slime-note)
when (slime-notes-in-same-location-p note other-note)
return (overlay-start overlay)))))
(when pos
(slime--display-position pos nil 0)))))
(defun slime-group-and-sort-notes (notes)
"First sort, then group NOTES according to their canonicalized locs."
(let ((locs (make-hash-table :test #'eq)))
(mapc (lambda (note)
(let ((loc (slime-note.location note)))
(when (slime-location-p loc)
(puthash note (slime-canonicalized-location loc) locs))))
notes)
(list (slime-group-similar
(lambda (n1 n2)
(equal (gethash n1 locs nil) (gethash n2 locs t)))
(let* ((bottom most-negative-fixnum)
(+default+ (list "" bottom bottom)))
(sort notes
(lambda (n1 n2)
(cl-destructuring-bind ((filename1 line1 col1)
(filename2 line2 col2))
(list (gethash n1 locs +default+)
(gethash n2 locs +default+))
(cond ((string-lessp filename1 filename2) t)
((string-lessp filename2 filename1) nil)
((< line1 line2) t)
((> line1 line2) nil)
(t (< col1 col2))))))))
locs)))
(defun slime-note.severity (note)
(plist-get note :severity))
(defun slime-note.message (note)
(plist-get note :message))
(defun slime-note.source-context (note)
(plist-get note :source-context))
(defun slime-note.location (note)
(plist-get note :location))
(defun slime-severity-label (severity)
(cl-subseq (symbol-name severity) 1))
;;;;; Adding a single compiler note
(defun slime-overlay-note (note)
"Add a compiler note to the buffer as an overlay.
If an appropriate overlay for a compiler note in the same location
already exists then the new information is merged into it. Otherwise a
new overlay is created."
(cl-multiple-value-bind (start end) (slime-choose-overlay-region note)
(when start
(goto-char start)
(let ((severity (plist-get note :severity))
(message (plist-get note :message))
(overlay (slime-note-at-point)))
(if overlay
(slime-merge-note-into-overlay overlay severity message)
(slime-create-note-overlay note start end severity message))))))
(defun slime-make-note-overlay (note start end)
(let ((overlay (make-overlay start end)))
(overlay-put overlay 'slime-note note)
(push overlay slime-note-overlays)
overlay))
(defun slime-create-note-overlay (note start end severity message)
"Create an overlay representing a compiler note.
The overlay has several properties:
FACE - to underline the relevant text.
SEVERITY - for future reference :NOTE, :STYLE-WARNING, :WARNING, or :ERROR.
MOUSE-FACE - highlight the note when the mouse passes over.
HELP-ECHO - a string describing the note, both for future reference
and for display as a tooltip (due to the special
property name)."
(let ((overlay (slime-make-note-overlay note start end)))
(cl-macrolet ((putp (name value) `(overlay-put overlay ,name ,value)))
(putp 'face (slime-severity-face severity))
(putp 'severity severity)
(putp 'mouse-face 'highlight)
(putp 'help-echo message)
overlay)))
;; XXX Obsolete due to `slime-merge-notes-for-display' doing the
;; work already -- unless we decide to put several sets of notes on a
;; buffer without clearing in between, which only this handles.
(defun slime-merge-note-into-overlay (overlay severity message)
"Merge another compiler note into an existing overlay.
The help text describes both notes, and the highest of the severities
is kept."
(cl-macrolet ((putp (name value) `(overlay-put overlay ,name ,value))
(getp (name) `(overlay-get overlay ,name)))
(putp 'severity (slime-most-severe severity (getp 'severity)))
(putp 'face (slime-severity-face (getp 'severity)))
(putp 'help-echo (concat (getp 'help-echo) "\n" message))))
(defun slime-choose-overlay-region (note)
"Choose the start and end points for an overlay over NOTE.
If the location's sexp is a list spanning multiple lines, then the
region around the first element is used.
Return nil if there's no useful source location."
(let ((location (slime-note.location note)))
(when location
(slime-dcase location
((:error _)) ; do nothing
((:location file pos _hints)
(cond ((eq (car file) ':source-form) nil)
((eq (slime-note.severity note) :read-error)
(slime-choose-overlay-for-read-error location))
((equal pos '(:eof))
(cl-values (1- (point-max)) (point-max)))
(t
(slime-choose-overlay-for-sexp location))))))))
(defun slime-choose-overlay-for-read-error (location)
(let ((pos (slime-location-offset location)))
(save-excursion
(goto-char pos)
(cond ((slime-symbol-at-point)
;; package not found, &c.
(cl-values (slime-symbol-start-pos) (slime-symbol-end-pos)))
(t
(cl-values pos (1+ pos)))))))
(defun slime-choose-overlay-for-sexp (location)
(slime-goto-source-location location)
(skip-chars-forward "'#`")
(let ((start (point)))
(ignore-errors (slime-forward-sexp))
(if (slime-same-line-p start (point))
(cl-values start (point))
(cl-values (1+ start)
(progn (goto-char (1+ start))
(ignore-errors (forward-sexp 1))
(point))))))
(defun slime-same-line-p (pos1 pos2)
"Return t if buffer positions POS1 and POS2 are on the same line."
(save-excursion (goto-char (min pos1 pos2))
(<= (max pos1 pos2) (line-end-position))))
(defvar slime-severity-face-plist
'(:error slime-error-face
:read-error slime-error-face
:warning slime-warning-face
:redefinition slime-style-warning-face
:style-warning slime-style-warning-face
:early-deprecation-warning slime-early-deprecation-warning-face
:late-deprecation-warning slime-late-deprecation-warning-face
:final-deprecation-warning slime-final-deprecation-warning-face
:note slime-note-face))
(defun slime-severity-face (severity)
"Return the name of the font-lock face representing SEVERITY."
(or (plist-get slime-severity-face-plist severity)
(error "No face for: %S" severity)))
(defvar slime-severity-order
'(:note
:early-deprecation-warning :style-warning :redefinition
:late-deprecation-warning :final-deprecation-warning
:warning :error :read-error))
(defun slime-severity< (sev1 sev2)
"Return true if SEV1 is less severe than SEV2."
(< (cl-position sev1 slime-severity-order)
(cl-position sev2 slime-severity-order)))
(defun slime-most-severe (sev1 sev2)
"Return the most servere of two conditions."
(if (slime-severity< sev1 sev2) sev2 sev1))
;; XXX: unused function
(defun slime-visit-source-path (source-path)
"Visit a full source path including the top-level form."
(goto-char (point-min))
(slime-forward-source-path source-path))
(defun slime-forward-positioned-source-path (source-path)
"Move forward through a sourcepath from a fixed position.
The point is assumed to already be at the outermost sexp, making the
first element of the source-path redundant."
(ignore-errors
(slime-forward-sexp)
(beginning-of-defun))
(let ((source-path (cdr source-path)))
(when source-path
(down-list 1)
(slime-forward-source-path source-path))))
(defun slime-forward-source-path (source-path)
(let ((origin (point)))
(condition-case nil
(progn
(cl-loop for (count . more) on source-path
do (progn
(slime-forward-sexp count)
(when more (down-list 1))))
;; Align at beginning
(slime-forward-sexp)
(beginning-of-sexp))
(error (goto-char origin)))))
;; FIXME: really fix this mess
;; FIXME: the check shouln't be done here anyway but by M-. itself.
(defun slime-filesystem-toplevel-directory ()
;; Windows doesn't have a true toplevel root directory, and all
;; filenames look like "c:/foo/bar/quux.baz" from an Emacs
;; perspective anyway.
(if (memq system-type '(ms-dos windows-nt))
""
(file-name-as-directory "/")))
(defun slime-file-name-merge-source-root (target-filename buffer-filename)
"Returns a filename where the source root directory of TARGET-FILENAME
is replaced with the source root directory of BUFFER-FILENAME.
If no common source root could be determined, return NIL.
E.g. (slime-file-name-merge-source-root
\"/usr/local/src/joe/upstream/sbcl/code/late-extensions.lisp\"
\"/usr/local/src/joe/hacked/sbcl/compiler/deftype.lisp\")
==> \"/usr/local/src/joe/hacked/sbcl/code/late-extensions.lisp\"
"
(let ((target-dirs (split-string (file-name-directory target-filename)
"/" t))
(buffer-dirs (split-string (file-name-directory buffer-filename)
"/" t)))
;; Starting from the end, we look if one of the TARGET-DIRS exists
;; in BUFFER-FILENAME---if so, it and everything left from that dirname
;; is considered to be the source root directory of BUFFER-FILENAME.
(cl-loop with target-suffix-dirs = nil
with buffer-dirs* = (reverse buffer-dirs)
with target-dirs* = (reverse target-dirs)
for target-dir in target-dirs*
do (let ((concat-dirs (lambda (dirs)
(apply #'concat
(mapcar #'file-name-as-directory
dirs))))
(pos (cl-position target-dir buffer-dirs*
:test #'equal)))
(if (not pos) ; TARGET-DIR not in BUFFER-FILENAME?
(push target-dir target-suffix-dirs)
(let* ((target-suffix
; PUSH reversed for us!
(funcall concat-dirs target-suffix-dirs))
(buffer-root
(funcall concat-dirs
(reverse (nthcdr pos buffer-dirs*)))))
(cl-return (concat (slime-filesystem-toplevel-directory)
buffer-root
target-suffix
(file-name-nondirectory
target-filename)))))))))
(defun slime-highlight-differences-in-dirname (base-dirname contrast-dirname)
"Returns a copy of BASE-DIRNAME where all differences between
BASE-DIRNAME and CONTRAST-DIRNAME are propertized with a
highlighting face."
(setq base-dirname (file-name-as-directory base-dirname))
(setq contrast-dirname (file-name-as-directory contrast-dirname))
(let ((base-dirs (split-string base-dirname "/" t))
(contrast-dirs (split-string contrast-dirname "/" t)))
(with-temp-buffer
(cl-loop initially (insert (slime-filesystem-toplevel-directory))
for base-dir in base-dirs do
(let ((pos (cl-position base-dir contrast-dirs :test #'equal)))
(cond ((not pos)
(slime-insert-propertized '(face highlight) base-dir)
(insert "/"))
(t
(insert (file-name-as-directory base-dir))
(setq contrast-dirs
(nthcdr (1+ pos) contrast-dirs))))))
(buffer-substring (point-min) (point-max)))))
(defvar slime-warn-when-possibly-tricked-by-M-. t
"When working on multiple source trees simultaneously, the way
`slime-edit-definition' (M-.) works can sometimes be confusing:
`M-.' visits locations that are present in the current Lisp image,
which works perfectly well as long as the image reflects the source
tree that one is currently looking at.
In the other case, however, one can easily end up visiting a file
in a different source root directory (cl-the one corresponding to
the Lisp image), and is thus easily tricked to modify the wrong
source files---which can lead to quite some stressfull cursing.
If this variable is T, a warning message is issued to raise the
user's attention whenever `M-.' is about opening a file in a
different source root that also exists in the source root
directory of the user's current buffer.
There's no guarantee that all possible cases are covered, but
if you encounter such a warning, it's a strong indication that
you should check twice before modifying.")
(defun slime-maybe-warn-for-different-source-root (target-filename
buffer-filename)
(let ((guessed-target (slime-file-name-merge-source-root target-filename
buffer-filename)))
(when (and guessed-target
(not (equal guessed-target target-filename))
(file-exists-p guessed-target))
(slime-message "Attention: This is `%s'."
(concat (slime-highlight-differences-in-dirname
(file-name-directory target-filename)
(file-name-directory guessed-target))
(file-name-nondirectory target-filename))))))
(defun slime-check-location-filename-sanity (filename)
(when slime-warn-when-possibly-tricked-by-M-.
(cl-macrolet ((truename-safe (file) `(and ,file (file-truename ,file))))
(let ((target-filename (truename-safe filename))
(buffer-filename (truename-safe (buffer-file-name))))
(when (and target-filename
buffer-filename)
(slime-maybe-warn-for-different-source-root
target-filename buffer-filename))))))
(defun slime-check-location-buffer-name-sanity (buffer-name)
(slime-check-location-filename-sanity
(buffer-file-name (get-buffer buffer-name))))
(defun slime-goto-location-buffer (buffer)
(slime-dcase buffer
((:file filename)
(let ((filename (slime-from-lisp-filename filename)))
(slime-check-location-filename-sanity filename)
(set-buffer (or (get-file-buffer filename)
(let ((find-file-suppress-same-file-warnings t))
(find-file-noselect filename))))))
((:buffer buffer-name)
(slime-check-location-buffer-name-sanity buffer-name)
(set-buffer buffer-name))
((:buffer-and-file buffer filename)
(slime-goto-location-buffer
(if (get-buffer buffer)
(list :buffer buffer)
(list :file filename))))
((:source-form string)
(set-buffer (get-buffer-create (slime-buffer-name :source)))
(erase-buffer)
(lisp-mode)
(insert string)
(goto-char (point-min)))
((:zip file entry)
(require 'arc-mode)
(set-buffer (find-file-noselect file t))
(goto-char (point-min))
(re-search-forward (concat " " entry "$"))
(let ((buffer (save-window-excursion
(archive-extract)
(current-buffer))))
(set-buffer buffer)
(goto-char (point-min))))))
(defun slime-goto-location-position (position)
(slime-dcase position
((:position pos)
(goto-char 1)
(forward-char (- (1- pos) (slime-eol-conversion-fixup (1- pos)))))
((:offset start offset)
(goto-char start)
(forward-char offset))
((:line start &optional column)
(goto-char (point-min))
(beginning-of-line start)
(cond (column (move-to-column column))
(t (skip-chars-forward " \t"))))
((:function-name name)
(let ((case-fold-search t)
(name (regexp-quote name)))
(goto-char (point-min))
(when (or
(re-search-forward
(format "\\s *(def\\(\\s_\\|\\sw\\)*\\s +(*%s\\S_"
(regexp-quote name)) nil t)
(re-search-forward
(format "[( \t]%s\\>\\(\\s \\|$\\)" name) nil t))
(goto-char (match-beginning 0)))))
((:method name specializers &rest qualifiers)
(slime-search-method-location name specializers qualifiers))
((:source-path source-path start-position)
(cond (start-position
(goto-char start-position)
(slime-forward-positioned-source-path source-path))
(t
(slime-forward-source-path source-path))))
((:eof)
(goto-char (point-max)))))
(defun slime-eol-conversion-fixup (n)
;; Return the number of \r\n eol markers that we need to cross when
;; moving N chars forward. N is the number of chars but \r\n are
;; counted as 2 separate chars.
(cl-case (coding-system-eol-type buffer-file-coding-system)
((1)
(save-excursion
(cl-do ((pos (+ (point) n))
(count 0 (1+ count)))
((>= (point) pos) (1- count))
(forward-line)
(cl-decf pos))))
(t 0)))
(defun slime-search-method-location (name specializers qualifiers)
;; Look for a sequence of words (def<something> method name
;; qualifers specializers don't look for "T" since it isn't requires
;; (arg without t) as class is taken as such.
(let* ((case-fold-search t)
(name (regexp-quote name))
(qualifiers (mapconcat (lambda (el) (concat ".+?\\<" el "\\>"))
qualifiers ""))
(specializers (mapconcat
(lambda (el)
(if (eql (aref el 0) ?\()
(let ((spec (read el)))
(if (eq (car spec) 'EQL)
(concat
".*?\\n\\{0,1\\}.*?(EQL.*?'\\{0,1\\}"
(format "%s" (cl-second spec)) ")")
(error "don't understand specializer: %s,%s"
el (car spec))))
(concat ".+?\n\\{0,1\\}.+?\\<" el "\\>")))
(remove "T" specializers) ""))
(regexp (format "\\s *(def\\(\\s_\\|\\sw\\)*\\s +%s\\s +%s%s" name
qualifiers specializers)))
(or (and (re-search-forward regexp nil t)
(goto-char (match-beginning 0)))
;; (slime-goto-location-position `(:function-name ,name))
)))
(defun slime-search-call-site (fname)
"Move to the place where FNAME called.
Don't move if there are multiple or no calls in the current defun."
(save-restriction
(narrow-to-defun)
(let ((start (point))
(regexp (concat "(" fname "[)\n \t]"))
(case-fold-search t))
(cond ((and (re-search-forward regexp nil t)
(not (re-search-forward regexp nil t)))
(goto-char (match-beginning 0)))
(t (goto-char start))))))
(defun slime-search-edit-path (edit-path)
"Move to EDIT-PATH starting at the current toplevel form."
(when edit-path
(unless (and (= (current-column) 0)
(looking-at "("))
(beginning-of-defun))
(slime-forward-source-path edit-path)))
(defun slime-goto-source-location (location &optional noerror)
"Move to the source location LOCATION. Several kinds of locations
are supported:
<location> ::= (:location <buffer> <position> <hints>)
| (:error <message>)
<buffer> ::= (:file <filename>)
| (:buffer <buffername>)
| (:buffer-and-file <buffername> <filename>)
| (:source-form <string>)
| (:zip <file> <entry>)
<position> ::= (:position <fixnum>) ; 1 based (for files)
| (:offset <start> <offset>) ; start+offset (for C-c C-c)
| (:line <line> [<column>])
| (:function-name <string>)
| (:source-path <list> <start-position>)
| (:method <name string> <specializers> . <qualifiers>)"
(slime-dcase location
((:location buffer _position _hints)
(slime-goto-location-buffer buffer)
(let ((pos (slime-location-offset location)))
(cond ((and (<= (point-min) pos) (<= pos (point-max))))
(widen-automatically (widen))
(t
(error "Location is outside accessible part of buffer")))
(goto-char pos)))
((:error message)
(if noerror
(slime-message "%s" message)
(error "%s" message)))))
(defun slime-location-offset (location)
"Return the position, as character number, of LOCATION."
(save-restriction
(widen)
(condition-case nil
(slime-goto-location-position
(slime-location.position location))
(error (goto-char 0)))
(cl-destructuring-bind (&key snippet edit-path call-site align)
(slime-location.hints location)
(when snippet (slime-isearch snippet))
(when edit-path (slime-search-edit-path edit-path))
(when call-site (slime-search-call-site call-site))
(when align
(slime-forward-sexp)
(beginning-of-sexp)))
(point)))
;;;;; Incremental search
;;
;; Search for the longest match of a string in either direction.
;;
;; This is for locating text that is expected to be near the point and
;; may have been modified (but hopefully not near the beginning!)
(defun slime-isearch (string)
"Find the longest occurence of STRING either backwards of forwards.
If multiple matches exist the choose the one nearest to point."
(goto-char
(let* ((start (point))
(len1 (slime-isearch-with-function 'search-forward string))
(pos1 (point)))
(goto-char start)
(let* ((len2 (slime-isearch-with-function 'search-backward string))
(pos2 (point)))
(cond ((and len1 len2)
;; Have a match in both directions
(cond ((= len1 len2)
;; Both are full matches -- choose the nearest.
(if (< (abs (- start pos1))
(abs (- start pos2)))
pos1 pos2))
((> len1 len2) pos1)
((> len2 len1) pos2)))
(len1 pos1)
(len2 pos2)
(t start))))))
(defun slime-isearch-with-function (search-fn string)
"Search for the longest substring of STRING using SEARCH-FN.
SEARCH-FN is either the symbol `search-forward' or `search-backward'."
(unless (string= string "")
(cl-loop for i from 1 to (length string)
while (funcall search-fn (substring string 0 i) nil t)
for match-data = (match-data)
do (cl-case search-fn
(search-forward (goto-char (match-beginning 0)))
(search-backward (goto-char (1+ (match-end 0)))))
finally (cl-return (if (null match-data)
nil
;; Finish based on the last successful match
(store-match-data match-data)
(goto-char (match-beginning 0))
(- (match-end 0) (match-beginning 0)))))))
;;;;; Visiting and navigating the overlays of compiler notes
(defun slime-next-note ()
"Go to and describe the next compiler note in the buffer."
(interactive)
(let ((here (point))
(note (slime-find-next-note)))
(if note
(slime-show-note note)
(goto-char here)
(message "No next note."))))
(defun slime-previous-note ()
"Go to and describe the previous compiler note in the buffer."
(interactive)
(let ((here (point))
(note (slime-find-previous-note)))
(if note
(slime-show-note note)
(goto-char here)
(message "No previous note."))))
(defun slime-goto-first-note (&rest _)
"Go to the first note in the buffer."
(let ((point (point)))
(goto-char (point-min))
(cond ((slime-find-next-note)
(slime-show-note (slime-note-at-point)))
(t (goto-char point)))))
(defun slime-remove-notes ()
"Remove compiler-note annotations from the current buffer."
(interactive)
(slime-remove-old-overlays))
(defun slime-show-note (overlay)
"Present the details of a compiler note to the user."
(slime-temporarily-highlight-note overlay)
(if (get-buffer-window (slime-buffer-name :compilation) t)
(slime-goto-note-in-compilation-log (overlay-get overlay 'slime-note))
(let ((message (get-char-property (point) 'help-echo)))
(slime-message "%s" (if (zerop (length message)) "\"\"" message)))))
;; FIXME: could probably use flash region
(defun slime-temporarily-highlight-note (overlay)
"Temporarily highlight a compiler note's overlay.
The highlighting is designed to both make the relevant source more
visible, and to highlight any further notes that are nested inside the
current one.
The highlighting is automatically undone with a timer."
(run-with-timer 0.2 nil
#'overlay-put overlay 'face (overlay-get overlay 'face))
(overlay-put overlay 'face 'slime-highlight-face))
;;;;; Overlay lookup operations
(defun slime-note-at-point ()
"Return the overlay for a note starting at point, otherwise NIL."
(cl-find (point) (slime-note-overlays-at-point)
:key 'overlay-start))
(defun slime-note-overlay-p (overlay)
"Return true if OVERLAY represents a compiler note."
(overlay-get overlay 'slime-note))
(defun slime-note-overlays-at-point ()
"Return a list of all note overlays that are under the point."
(cl-remove-if-not 'slime-note-overlay-p (overlays-at (point))))
(defun slime-find-next-note ()
"Go to the next position with the `slime-note' text property.
Retuns the note overlay if such a position is found, otherwise nil."
(slime-search-property 'slime-note nil #'slime-note-at-point))
(defun slime-find-previous-note ()
"Go to the next position with the `slime-note' text property.
Retuns the note overlay if such a position is found, otherwise nil."
(slime-search-property 'slime-note t #'slime-note-at-point))
;;;; Arglist Display
(defun slime-space (n)
"Insert a space and print some relevant information (function arglist).
Designed to be bound to the SPC key. Prefix argument can be used to insert
more than one space."
(interactive "p")
(self-insert-command n)
(slime-echo-arglist))
(put 'slime-space 'delete-selection t) ; for delete-section-mode & CUA
(defun slime-echo-arglist ()
(when (slime-background-activities-enabled-p)
(let ((op (slime-operator-before-point)))
(when op
(slime-eval-async `(swank:operator-arglist ,op
,(slime-current-package))
(lambda (arglist)
(when arglist
(slime-message "%s" arglist))))))))
(defvar slime-operator-before-point-function 'slime-lisp-operator-before-point)
(defun slime-operator-before-point ()
(funcall slime-operator-before-point-function))
(defun slime-lisp-operator-before-point ()
(ignore-errors
(save-excursion
(backward-up-list 1)
(down-list 1)
(slime-symbol-at-point))))
;;;; Completion
;; FIXME: use this in Emacs 24
;;(define-obsolete-function-alias slime-complete-symbol completion-at-point)
(defalias 'slime-complete-symbol #'completion-at-point)
(make-obsolete 'slime-complete-symbol #'completion-at-point "2015-10-17")
;; This is the function that we add to
;; `completion-at-point-functions'. For backward-compatibilty we look
;; at `slime-complete-symbol-function' first. The indirection through
;; `slime-completion-at-point-functions' is used so that users don't
;; have to set `completion-at-point-functions' in every slime-like
;; buffer.
(defun slime--completion-at-point ()
(cond (slime-complete-symbol-function
slime-complete-symbol-function)
(t
(run-hook-with-args-until-success
'slime-completion-at-point-functions))))
(defun slime-setup-completion ()
(add-hook 'completion-at-point-functions #'slime--completion-at-point nil t))
(defun slime-simple-completion-at-point ()
"Complete the symbol at point.
Perform completion similar to `elisp-completion-at-point'."
(let* ((end (point))
(beg (slime-symbol-start-pos)))
(list beg end (completion-table-dynamic #'slime-simple-completions))))
(defun slime-filename-completion ()
"If point is at a string starting with \", complete it as filename.
Return nil if point is not at filename."
(when (save-excursion (re-search-backward "\"[^ \t\n]+\\="
(max (point-min) (- (point) 1000))
t))
(let ((comint-completion-addsuffix '("/" . "\"")))
(comint-filename-completion))))
;; FIXME: for backward compatibility. Remove it one day
;; together with slime-complete-symbol-function.
(defun slime-simple-complete-symbol ()
(let ((completion-at-point-functions '(slime-maybe-complete-as-filename
slime-simple-completion-at-point)))
(completion-at-point)))
;; NOTE: the original idea was to bind this to TAB but that no longer
;; works as `completion-at-point' sets a transient keymap that
;; overrides TAB. So this is rather useless now.
(defun slime-indent-and-complete-symbol ()
"Indent the current line and perform symbol completion.
First indent the line. If indenting doesn't move point, complete
the symbol. If there's no symbol at the point, show the arglist
for the most recently enclosed macro or function."
(interactive)
(let ((pos (point)))
(unless (get-text-property (line-beginning-position) 'slime-repl-prompt)
(lisp-indent-line))
(when (= pos (point))
(cond ((save-excursion (re-search-backward "[^() \n\t\r]+\\=" nil t))
(completion-at-point))
((memq (char-before) '(?\t ?\ ))
(slime-echo-arglist))))))
(make-obsolete 'slime-indent-and-complete-symbol
"Set tab-always-indent to 'complete."
"2015-10-18")
(defvar slime-minibuffer-map
(let ((map (make-sparse-keymap)))
(set-keymap-parent map minibuffer-local-map)
(define-key map "\t" #'completion-at-point)
(define-key map "\M-\t" #'completion-at-point)
map)
"Minibuffer keymap used for reading CL expressions.")
(defvar slime-minibuffer-history '()
"History list of expressions read from the minibuffer.")
(defun slime-minibuffer-setup-hook ()
(cons (lexical-let ((package (slime-current-package))
(connection (slime-connection)))
(lambda ()
(setq slime-buffer-package package)
(setq slime-buffer-connection connection)
(set-syntax-table lisp-mode-syntax-table)
(slime-setup-completion)))
minibuffer-setup-hook))
(defun slime-read-from-minibuffer (prompt &optional initial-value history)
"Read a string from the minibuffer, prompting with PROMPT.
If INITIAL-VALUE is non-nil, it is inserted into the minibuffer before
reading input. The result is a string (\"\" if no input was given)."
(let ((minibuffer-setup-hook (slime-minibuffer-setup-hook)))
(read-from-minibuffer prompt initial-value slime-minibuffer-map
nil (or history 'slime-minibuffer-history))))
(defun slime-bogus-completion-alist (list)
"Make an alist out of list.
The same elements go in the CAR, and nil in the CDR. To support the
apparently very stupid `try-completions' interface, that wants an
alist but ignores CDRs."
(mapcar (lambda (x) (cons x nil)) list))
(defun slime-simple-completions (prefix)
(cl-destructuring-bind (completions _partial)
(let ((slime-current-thread t))
(slime-eval
`(swank:simple-completions ,(substring-no-properties prefix)
',(slime-current-package))))
completions))
;;;; Edit definition
(defun slime-push-definition-stack ()
"Add point to find-tag-marker-ring."
(require 'etags)
(ring-insert find-tag-marker-ring (point-marker)))
(defun slime-pop-find-definition-stack ()
"Pop the edit-definition stack and goto the location."
(interactive)
(pop-tag-mark))
(cl-defstruct (slime-xref (:conc-name slime-xref.) (:type list))
dspec location)
(cl-defstruct (slime-location (:conc-name slime-location.) (:type list)
(:constructor nil)
(:copier nil))
tag buffer position hints)
(defun slime-location-p (o) (and (consp o) (eq (car o) :location)))
(defun slime-xref-has-location-p (xref)
(slime-location-p (slime-xref.location xref)))
(defun make-slime-buffer-location (buffer-name position &optional hints)
`(:location (:buffer ,buffer-name) (:position ,position)
,(when hints `(:hints ,hints))))
(defun make-slime-file-location (file-name position &optional hints)
`(:location (:file ,file-name) (:position ,position)
,(when hints `(:hints ,hints))))
;;; The hooks are tried in order until one succeeds, otherwise the
;;; default implementation involving `slime-find-definitions-function'
;;; is used. The hooks are called with the same arguments as
;;; `slime-edit-definition'.
(defvar slime-edit-definition-hooks)
(defun slime-edit-definition (&optional name where)
"Lookup the definition of the name at point.
If there's no name at point, or a prefix argument is given, then the
function name is prompted."
(interactive (list (or (and (not current-prefix-arg)
(slime-symbol-at-point))
(slime-read-symbol-name "Edit Definition of: "))))
;; The hooks might search for a name in a different manner, so don't
;; ask the user if it's missing before the hooks are run
(or (run-hook-with-args-until-success 'slime-edit-definition-hooks
name where)
(slime-edit-definition-cont (slime-find-definitions name)
name where)))
(defun slime-edit-definition-cont (xrefs name where)
(cl-destructuring-bind (1loc file-alist) (slime-analyze-xrefs xrefs)
(cond ((null xrefs)
(error "No known definition for: %s (in %s)"
name (slime-current-package)))
(1loc
(slime-push-definition-stack)
(slime-pop-to-location (slime-xref.location (car xrefs)) where))
((slime-length= xrefs 1) ; ((:error "..."))
(error "%s" (cadr (slime-xref.location (car xrefs)))))
(t
(slime-push-definition-stack)
(slime-show-xrefs file-alist 'definition name
(slime-current-package))))))
(defvar slime-edit-uses-xrefs
'(:calls :macroexpands :binds :references :sets :specializes))
;;; FIXME. TODO: Would be nice to group the symbols (in each
;;; type-group) by their home-package.
(defun slime-edit-uses (symbol)
"Lookup all the uses of SYMBOL."
(interactive (list (slime-read-symbol-name "Edit Uses of: ")))
(slime-xrefs slime-edit-uses-xrefs
symbol
(lambda (xrefs type symbol package)
(cond
((null xrefs)
(message "No xref information found for %s." symbol))
((and (slime-length= xrefs 1) ; one group
(slime-length= (cdar xrefs) 1)) ; one ref in group
(cl-destructuring-bind (_ (_ loc)) (cl-first xrefs)
(slime-push-definition-stack)
(slime-pop-to-location loc)))
(t
(slime-push-definition-stack)
(slime-show-xref-buffer xrefs type symbol package))))))
(defun slime-analyze-xrefs (xrefs)
"Find common filenames in XREFS.
Return a list (SINGLE-LOCATION FILE-ALIST).
SINGLE-LOCATION is true if all xrefs point to the same location.
FILE-ALIST is an alist of the form ((FILENAME . (XREF ...)) ...)."
(list (and xrefs
(let ((loc (slime-xref.location (car xrefs))))
(and (slime-location-p loc)
(cl-every (lambda (x) (equal (slime-xref.location x) loc))
(cdr xrefs)))))
(slime-alistify xrefs #'slime-xref-group #'equal)))
(defun slime-xref-group (xref)
(cond ((slime-xref-has-location-p xref)
(slime-dcase (slime-location.buffer (slime-xref.location xref))
((:file filename) filename)
((:buffer bufname)
(let ((buffer (get-buffer bufname)))
(if buffer
(format "%S" buffer) ; "#<buffer foo.lisp>"
(format "%s (previously existing buffer)" bufname))))
((:buffer-and-file _buffer filename) filename)
((:source-form _) "(S-Exp)")
((:zip _zip entry) entry)))
(t
"(No location)")))
(defun slime-pop-to-location (location &optional where)
(slime-goto-source-location location)
(let ((point (point)))
(cl-ecase where
((nil) (switch-to-buffer (current-buffer)))
(window (pop-to-buffer (current-buffer) t))
(frame (let ((pop-up-frames t)) (pop-to-buffer (current-buffer) t))))
(goto-char point)))
(defun slime-postprocess-xref (original-xref)
"Process (for normalization purposes) an Xref comming directly
from SWANK before the rest of Slime sees it. In particular,
convert ETAGS based xrefs to actual file+position based
locations."
(if (not (slime-xref-has-location-p original-xref))
(list original-xref)
(let ((loc (slime-xref.location original-xref)))
(slime-dcase (slime-location.buffer loc)
((:etags-file tags-file)
(slime-dcase (slime-location.position loc)
((:tag &rest tags)
(visit-tags-table tags-file)
(mapcar (lambda (xref)
(let ((old-dspec (slime-xref.dspec original-xref))
(new-dspec (slime-xref.dspec xref)))
(setf (slime-xref.dspec xref)
(format "%s: %s" old-dspec new-dspec))
xref))
(cl-mapcan #'slime-etags-definitions tags)))))
(t
(list original-xref))))))
(defun slime-postprocess-xrefs (xrefs)
(cl-mapcan #'slime-postprocess-xref xrefs))
(defun slime-find-definitions (name)
"Find definitions for NAME."
(slime-postprocess-xrefs (funcall slime-find-definitions-function name)))
(defun slime-find-definitions-rpc (name)
(slime-eval `(swank:find-definitions-for-emacs ,name)))
(defun slime-edit-definition-other-window (name)
"Like `slime-edit-definition' but switch to the other window."
(interactive (list (slime-read-symbol-name "Symbol: ")))
(slime-edit-definition name 'window))
(defun slime-edit-definition-other-frame (name)
"Like `slime-edit-definition' but switch to the other window."
(interactive (list (slime-read-symbol-name "Symbol: ")))
(slime-edit-definition name 'frame))
(defun slime-edit-definition-with-etags (name)
(interactive (list (slime-read-symbol-name "Symbol: ")))
(let ((xrefs (slime-etags-definitions name)))
(cond (xrefs
(message "Using tag file...")
(slime-edit-definition-cont xrefs name nil))
(t
(error "No known definition for: %s" name)))))
(defun slime-etags-to-locations (name)
"Search for definitions matching `name' in the currently active
tags table. Return a possibly empty list of slime-locations."
(let ((locs '()))
(save-excursion
(let ((first-time t))
(while (visit-tags-table-buffer (not first-time))
(setq first-time nil)
(goto-char (point-min))
(while (search-forward name nil t)
(beginning-of-line)
(cl-destructuring-bind (hint line &rest pos) (etags-snarf-tag)
(unless (eq hint t) ; hint==t if we are in a filename line
(push `(:location (:file ,(expand-file-name (file-of-tag)))
(:line ,line)
(:snippet ,hint))
locs))))))
(nreverse locs))))
(defun slime-etags-definitions (name)
"Search definitions matching NAME in the tags file.
The result is a (possibly empty) list of definitions."
(mapcar (lambda (loc)
(make-slime-xref :dspec (cl-second (slime-location.hints loc))
:location loc))
(slime-etags-to-locations name)))
;;;;; first-change-hook
(defun slime-first-change-hook ()
"Notify Lisp that a source file's buffer has been modified."
;; Be careful not to disturb anything!
;; In particular if we muck up the match-data then query-replace
;; breaks. -luke (26/Jul/2004)
(save-excursion
(save-match-data
(when (and (buffer-file-name)
(file-exists-p (buffer-file-name))
(slime-background-activities-enabled-p))
(let ((filename (slime-to-lisp-filename (buffer-file-name))))
(slime-eval-async `(swank:buffer-first-change ,filename)))))))
(defun slime-setup-first-change-hook ()
(add-hook (make-local-variable 'first-change-hook)
'slime-first-change-hook))
(add-hook 'slime-mode-hook 'slime-setup-first-change-hook)
;;;; Eval for Lisp
(defun slime-lisp-readable-p (x)
(or (stringp x)
(memq x '(nil t))
(integerp x)
(keywordp x)
(and (consp x)
(let ((l x))
(while (consp l)
(slime-lisp-readable-p (car x))
(setq l (cdr l)))
(slime-lisp-readable-p l)))))
(defun slime--funcall-and-dispatch-result (thread tag fn &rest args)
(let ((ok nil)
(value nil)
(error nil))
(unwind-protect
(condition-case err
(progn
(setq value (apply fn args))
(setq ok t))
((debug error)
(setq error err)))
(let ((result (cond ((and ok
(not (slime-lisp-readable-p value)))
`(:unreadable ,(slime-prin1-to-string value)))
(ok `(:ok ,value))
(error `(:error ,(symbol-name (car error))
. ,(mapcar #'slime-prin1-to-string
(cdr error))))
(t `(:abort)))))
(slime-dispatch-event `(:emacs-return ,thread ,tag ,result))))))
(defun slime-eval-for-lisp (thread tag form-string)
(slime--funcall-and-dispatch-result thread tag
(lambda (s) (eval (read s)))
form-string))
(defun slime-check-eval-in-emacs-enabled ()
"Raise an error if `slime-enable-evaluate-in-emacs' isn't true."
(unless slime-enable-evaluate-in-emacs
(error (concat "slime-eval-in-emacs disabled for security. "
"Set `slime-enable-evaluate-in-emacs' true to enable it."))))
;;;; RPC from Lisp
(defmacro defslimefun (name arglist &rest body)
"Define a function via `cl-defun' that can be invoked from SWANK."
`(progn
(put ',name 'slime-rpc t)
(cl-defun ,name ,arglist ,@body)))
(defun slime-rpc-allowed-p (fn)
(get fn 'slime-rpc))
(defun slime-check-rpc-allowed (fn)
"Raise an error if FN does not denote a function defined via
`defslimefun'."
(unless (slime-rpc-allowed-p fn)
(error "Lisp tried to RPC `%s', but it wasn't defined via `defslimefun'."
fn)))
(defun slime-rpc-from-lisp (thread tag fn args)
(if (not (slime-rpc-allowed-p fn))
(slime-dispatch-event '(:ed-rpc-forbidden ,thread ,tag ,fn))
(apply #'slime--funcall-and-dispatch-result thread tag fn args)))
;;;; `ED'
(defvar slime-ed-frame nil
"The frame used by `slime-ed'.")
(defcustom slime-ed-use-dedicated-frame t
"*When non-nil, `slime-ed' will create and reuse a dedicated frame."
:type 'boolean
:group 'slime-mode)
(defun slime-ed (what)
"Edit WHAT.
WHAT can be:
A filename (string),
A list (:filename FILENAME &key LINE COLUMN POSITION),
A function name (:function-name STRING)
nil.
This is for use in the implementation of COMMON-LISP:ED."
(when slime-ed-use-dedicated-frame
(unless (and slime-ed-frame (frame-live-p slime-ed-frame))
(setq slime-ed-frame (make-frame)))
(select-frame slime-ed-frame))
(when what
(slime-dcase what
((:filename file &key line column position bytep)
(find-file (slime-from-lisp-filename file))
(when line (slime-goto-line line))
(when column (move-to-column column))
(when position
(goto-char (if bytep
(byte-to-position position)
position))))
((:function-name name)
(slime-edit-definition name)))))
(defun slime-goto-line (line-number)
"Move to line LINE-NUMBER (1-based).
This is similar to `goto-line' but without pushing the mark and
the display stuff that we neither need nor want."
(cl-assert (= (buffer-size) (- (point-max) (point-min))) ()
"slime-goto-line in narrowed buffer")
(goto-char (point-min))
(forward-line (1- line-number)))
(defun slime-y-or-n-p (thread tag question)
(slime-dispatch-event `(:emacs-return ,thread ,tag ,(y-or-n-p question))))
(defun slime-read-from-minibuffer-for-swank (thread tag prompt initial-value)
(let ((answer (condition-case nil
(slime-read-from-minibuffer prompt initial-value)
(quit nil))))
(slime-dispatch-event `(:emacs-return ,thread ,tag ,answer))))
;;;; Interactive evaluation.
(defun slime-interactive-eval (string)
"Read and evaluate STRING and print value in minibuffer.
Note: If a prefix argument is in effect then the result will be
inserted in the current buffer."
(interactive (list (slime-read-from-minibuffer "Slime Eval: ")))
(cl-case current-prefix-arg
((nil)
(slime-eval-with-transcript `(swank:interactive-eval ,string)))
((-)
(slime-eval-save string))
(t
(slime-eval-print string))))
(defvar slime-transcript-start-hook nil
"Hook run before start an evalution.")
(defvar slime-transcript-stop-hook nil
"Hook run after finishing a evalution.")
(defun slime-display-eval-result (value)
(slime-message "%s" value))
(defun slime-eval-with-transcript (form)
"Eval FORM in Lisp. Display output, if any."
(run-hooks 'slime-transcript-start-hook)
(slime-rex () (form)
((:ok value)
(run-hooks 'slime-transcript-stop-hook)
(slime-display-eval-result value))
((:abort condition)
(run-hooks 'slime-transcript-stop-hook)
(message "Evaluation aborted on %s." condition))))
(defun slime-eval-print (string)
"Eval STRING in Lisp; insert any output and the result at point."
(slime-eval-async `(swank:eval-and-grab-output ,string)
(lambda (result)
(cl-destructuring-bind (output value) result
(push-mark)
(insert output value)))))
(defun slime-eval-save (string)
"Evaluate STRING in Lisp and save the result in the kill ring."
(slime-eval-async `(swank:eval-and-grab-output ,string)
(lambda (result)
(cl-destructuring-bind (output value) result
(let ((string (concat output value)))
(kill-new string)
(message "Evaluation finished; pushed result to kill ring."))))))
(defun slime-eval-describe (form)
"Evaluate FORM in Lisp and display the result in a new buffer."
(slime-eval-async form (slime-rcurry #'slime-show-description
(slime-current-package))))
(defvar slime-description-autofocus nil
"If non-nil select description windows on display.")
(defun slime-show-description (string package)
;; So we can have one description buffer open per connection. Useful
;; for comparing the output of DISASSEMBLE across implementations.
;; FIXME: could easily be achieved with M-x rename-buffer
(let ((bufname (slime-buffer-name :description)))
(slime-with-popup-buffer (bufname :package package
:connection t
:select slime-description-autofocus)
(princ string)
(goto-char (point-min)))))
(defun slime-last-expression ()
(buffer-substring-no-properties
(save-excursion (backward-sexp) (point))
(point)))
(defun slime-eval-last-expression ()
"Evaluate the expression preceding point."
(interactive)
(slime-interactive-eval (slime-last-expression)))
(defun slime-eval-defun ()
"Evaluate the current toplevel form.
Use `slime-re-evaluate-defvar' if the from starts with '(defvar'"
(interactive)
(let ((form (slime-defun-at-point)))
(cond ((string-match "^(defvar " form)
(slime-re-evaluate-defvar form))
(t
(slime-interactive-eval form)))))
(defun slime-eval-region (start end)
"Evaluate region."
(interactive "r")
(slime-eval-with-transcript
`(swank:interactive-eval-region
,(buffer-substring-no-properties start end))))
(defun slime-pprint-eval-region (start end)
"Evaluate region; pprint the value in a buffer."
(interactive "r")
(slime-eval-describe
`(swank:pprint-eval
,(buffer-substring-no-properties start end))))
(defun slime-eval-buffer ()
"Evaluate the current buffer.
The value is printed in the echo area."
(interactive)
(slime-eval-region (point-min) (point-max)))
(defun slime-re-evaluate-defvar (form)
"Force the re-evaluaton of the defvar form before point.
First make the variable unbound, then evaluate the entire form."
(interactive (list (slime-last-expression)))
(slime-eval-with-transcript `(swank:re-evaluate-defvar ,form)))
(defun slime-pprint-eval-last-expression ()
"Evaluate the form before point; pprint the value in a buffer."
(interactive)
(slime-eval-describe `(swank:pprint-eval ,(slime-last-expression))))
(defun slime-eval-print-last-expression (string)
"Evaluate sexp before point; print value into the current buffer"
(interactive (list (slime-last-expression)))
(insert "\n")
(slime-eval-print string))
;;;; Edit Lisp value
;;;
(defun slime-edit-value (form-string)
"\\<slime-edit-value-mode-map>\
Edit the value of a setf'able form in a new buffer.
The value is inserted into a temporary buffer for editing and then set
in Lisp when committed with \\[slime-edit-value-commit]."
(interactive
(list (slime-read-from-minibuffer "Edit value (evaluated): "
(slime-sexp-at-point))))
(slime-eval-async `(swank:value-for-editing ,form-string)
(lexical-let ((form-string form-string)
(package (slime-current-package)))
(lambda (result)
(slime-edit-value-callback form-string result
package)))))
(make-variable-buffer-local
(defvar slime-edit-form-string nil
"The form being edited by `slime-edit-value'."))
(define-minor-mode slime-edit-value-mode
"Mode for editing a Lisp value."
nil
" Edit-Value"
'(("\C-c\C-c" . slime-edit-value-commit)))
(defun slime-edit-value-callback (form-string current-value package)
(let* ((name (generate-new-buffer-name (format "*Edit %s*" form-string)))
(buffer (slime-with-popup-buffer (name :package package
:connection t
:select t
:mode 'lisp-mode)
(slime-popup-buffer-mode -1) ; don't want binding of 'q'
(slime-mode 1)
(slime-edit-value-mode 1)
(setq slime-edit-form-string form-string)
(insert current-value)
(current-buffer))))
(with-current-buffer buffer
(setq buffer-read-only nil)
(message "Type C-c C-c when done"))))
(defun slime-edit-value-commit ()
"Commit the edited value to the Lisp image.
\\(See `slime-edit-value'.)"
(interactive)
(if (null slime-edit-form-string)
(error "Not editing a value.")
(let ((value (buffer-substring-no-properties (point-min) (point-max))))
(lexical-let ((buffer (current-buffer)))
(slime-eval-async `(swank:commit-edited-value ,slime-edit-form-string
,value)
(lambda (_)
(with-current-buffer buffer
(quit-window t))))))))
;;;; Tracing
(defun slime-untrace-all ()
"Untrace all functions."
(interactive)
(slime-eval `(swank:untrace-all)))
(defun slime-toggle-trace-fdefinition (spec)
"Toggle trace."
(interactive (list (slime-read-from-minibuffer
"(Un)trace: " (slime-symbol-at-point))))
(message "%s" (slime-eval `(swank:swank-toggle-trace ,spec))))
(defun slime-disassemble-symbol (symbol-name)
"Display the disassembly for SYMBOL-NAME."
(interactive (list (slime-read-symbol-name "Disassemble: ")))
(slime-eval-describe `(swank:disassemble-form ,(concat "'" symbol-name))))
(defun slime-undefine-function (symbol-name)
"Unbind the function slot of SYMBOL-NAME."
(interactive (list (slime-read-symbol-name "fmakunbound: " t)))
(slime-eval-async `(swank:undefine-function ,symbol-name)
(lambda (result) (message "%s" result))))
(defun slime-unintern-symbol (symbol-name package)
"Unintern the symbol given with SYMBOL-NAME PACKAGE."
(interactive (list (slime-read-symbol-name "Unintern symbol: " t)
(slime-read-package-name "from package: "
(slime-current-package))))
(slime-eval-async `(swank:unintern-symbol ,symbol-name ,package)
(lambda (result) (message "%s" result))))
(defun slime-delete-package (package-name)
"Delete the package with name PACKAGE-NAME."
(interactive (list (slime-read-package-name "Delete package: "
(slime-current-package))))
(slime-eval-async `(cl:delete-package
(swank::guess-package ,package-name))))
(defun slime-load-file (filename)
"Load the Lisp file FILENAME."
(interactive (list
(read-file-name "Load file: " nil nil
nil (if (buffer-file-name)
(file-name-nondirectory
(buffer-file-name))))))
(let ((lisp-filename (slime-to-lisp-filename (expand-file-name filename))))
(slime-eval-with-transcript `(swank:load-file ,lisp-filename))))
(defvar slime-change-directory-hooks nil
"Hook run by `slime-change-directory'.
The functions are called with the new (absolute) directory.")
(defun slime-change-directory (directory)
"Make DIRECTORY become Lisp's current directory.
Return whatever swank:set-default-directory returns."
(let ((dir (expand-file-name directory)))
(prog1 (slime-eval `(swank:set-default-directory
,(slime-to-lisp-filename dir)))
(slime-with-connection-buffer nil (cd-absolute dir))
(run-hook-with-args 'slime-change-directory-hooks dir))))
(defun slime-cd (directory)
"Make DIRECTORY become Lisp's current directory.
Return whatever swank:set-default-directory returns."
(interactive (list (read-directory-name "Directory: " nil nil t)))
(message "default-directory: %s" (slime-change-directory directory)))
(defun slime-pwd ()
"Show Lisp's default directory."
(interactive)
(message "Directory %s" (slime-eval `(swank:default-directory))))
;;;; Profiling
(defun slime-toggle-profile-fdefinition (fname-string)
"Toggle profiling for FNAME-STRING."
(interactive (list (slime-read-from-minibuffer
"(Un)Profile: "
(slime-symbol-at-point))))
(slime-eval-async `(swank:toggle-profile-fdefinition ,fname-string)
(lambda (r) (message "%s" r))))
(defun slime-unprofile-all ()
"Unprofile all functions."
(interactive)
(slime-eval-async '(swank:unprofile-all)
(lambda (r) (message "%s" r))))
(defun slime-profile-report ()
"Print profile report."
(interactive)
(slime-eval-with-transcript '(swank:profile-report)))
(defun slime-profile-reset ()
"Reset profile counters."
(interactive)
(slime-eval-async (slime-eval `(swank:profile-reset))
(lambda (r) (message "%s" r))))
(defun slime-profiled-functions ()
"Return list of names of currently profiled functions."
(interactive)
(slime-eval-async `(swank:profiled-functions)
(lambda (r) (message "%s" r))))
(defun slime-profile-package (package callers methods)
"Profile all functions in PACKAGE.
If CALLER is non-nil names have counts of the most common calling
functions recorded.
If METHODS is non-nil, profile all methods of all generic function
having names in the given package."
(interactive (list (slime-read-package-name "Package: ")
(y-or-n-p "Record the most common callers? ")
(y-or-n-p "Profile methods? ")))
(slime-eval-async `(swank:swank-profile-package ,package ,callers ,methods)
(lambda (r) (message "%s" r))))
(defun slime-profile-by-substring (substring &optional package)
"Profile all functions which names contain SUBSTRING.
If PACKAGE is NIL, then search in all packages."
(interactive (list
(slime-read-from-minibuffer
"Profile by matching substring: "
(slime-symbol-at-point))
(slime-read-package-name "Package (RET for all packages): ")))
(let ((package (unless (equal package "") package)))
(slime-eval-async `(swank:profile-by-substring ,substring ,package)
(lambda (r) (message "%s" r)) )))
;;;; Documentation
(defvar slime-documentation-lookup-function
'slime-hyperspec-lookup)
(defun slime-documentation-lookup ()
"Generalized documentation lookup. Defaults to hyperspec lookup."
(interactive)
(call-interactively slime-documentation-lookup-function))
(defun slime-hyperspec-lookup (symbol-name)
"A wrapper for `hyperspec-lookup'"
(interactive (list (common-lisp-hyperspec-read-symbol-name
(slime-symbol-at-point))))
(hyperspec-lookup symbol-name))
(defun slime-describe-symbol (symbol-name)
"Describe the symbol at point."
(interactive (list (slime-read-symbol-name "Describe symbol: ")))
(when (not symbol-name)
(error "No symbol given"))
(slime-eval-describe `(swank:describe-symbol ,symbol-name)))
(defun slime-documentation (symbol-name)
"Display function- or symbol-documentation for SYMBOL-NAME."
(interactive (list (slime-read-symbol-name "Documentation for symbol: ")))
(when (not symbol-name)
(error "No symbol given"))
(slime-eval-describe
`(swank:documentation-symbol ,symbol-name)))
(defun slime-describe-function (symbol-name)
(interactive (list (slime-read-symbol-name "Describe symbol's function: ")))
(when (not symbol-name)
(error "No symbol given"))
(slime-eval-describe `(swank:describe-function ,symbol-name)))
(defface slime-apropos-symbol
'((t (:inherit bold)))
"Face for the symbol name in Apropos output."
:group 'slime)
(defface slime-apropos-label
'((t (:inherit italic)))
"Face for label (`Function', `Variable' ...) in Apropos output."
:group 'slime)
(defun slime-apropos-summary (string case-sensitive-p package only-external-p)
"Return a short description for the performed apropos search."
(concat (if case-sensitive-p "Case-sensitive " "")
"Apropos for "
(format "%S" string)
(if package (format " in package %S" package) "")
(if only-external-p " (external symbols only)" "")))
(defun slime-apropos (string &optional only-external-p package
case-sensitive-p)
"Show all bound symbols whose names match STRING. With prefix
arg, you're interactively asked for parameters of the search."
(interactive
(if current-prefix-arg
(list (read-string "SLIME Apropos: ")
(y-or-n-p "External symbols only? ")
(let ((pkg (slime-read-package-name "Package: ")))
(if (string= pkg "") nil pkg))
(y-or-n-p "Case-sensitive? "))
(list (read-string "SLIME Apropos: ") t nil nil)))
(let ((buffer-package (or package (slime-current-package))))
(slime-eval-async
`(swank:apropos-list-for-emacs ,string ,only-external-p
,case-sensitive-p ',package)
(slime-rcurry #'slime-show-apropos string buffer-package
(slime-apropos-summary string case-sensitive-p
package only-external-p)))))
(defun slime-apropos-all ()
"Shortcut for (slime-apropos <string> nil nil)"
(interactive)
(slime-apropos (read-string "SLIME Apropos: ") nil nil))
(defun slime-apropos-package (package &optional internal)
"Show apropos listing for symbols in PACKAGE.
With prefix argument include internal symbols."
(interactive (list (let ((pkg (slime-read-package-name "Package: ")))
(if (string= pkg "") (slime-current-package) pkg))
current-prefix-arg))
(slime-apropos "" (not internal) package))
(autoload 'apropos-mode "apropos")
(defun slime-show-apropos (plists string package summary)
(if (null plists)
(message "No apropos matches for %S" string)
(slime-with-popup-buffer ((slime-buffer-name :apropos)
:package package :connection t
:mode 'apropos-mode)
(if (boundp 'header-line-format)
(setq header-line-format summary)
(insert summary "\n\n"))
(slime-set-truncate-lines)
(slime-print-apropos plists)
(set-syntax-table lisp-mode-syntax-table)
(goto-char (point-min)))))
(defvar slime-apropos-namespaces
'((:variable "Variable")
(:function "Function")
(:generic-function "Generic Function")
(:macro "Macro")
(:special-operator "Special Operator")
(:setf "Setf")
(:type "Type")
(:class "Class")
(:alien-type "Alien type")
(:alien-struct "Alien struct")
(:alien-union "Alien type")
(:alien-enum "Alien enum")))
(defun slime-print-apropos (plists)
(dolist (plist plists)
(let ((designator (plist-get plist :designator)))
(cl-assert designator)
(slime-insert-propertized `(face slime-apropos-symbol) designator))
(terpri)
(cl-loop for (prop value) on plist by #'cddr
unless (eq prop :designator) do
(let ((namespace (cadr (or (assq prop slime-apropos-namespaces)
(error "Unknown property: %S" prop))))
(start (point)))
(princ " ")
(slime-insert-propertized `(face slime-apropos-label) namespace)
(princ ": ")
(princ (cl-etypecase value
(string value)
((member nil :not-documented) "(not documented)")))
(add-text-properties
start (point)
(list 'type prop 'action 'slime-call-describer
'button t 'apropos-label namespace
'item (plist-get plist :designator)))
(terpri)))))
(defun slime-call-describer (arg)
(let* ((pos (if (markerp arg) arg (point)))
(type (get-text-property pos 'type))
(item (get-text-property pos 'item)))
(slime-eval-describe `(swank:describe-definition-for-emacs ,item ,type))))
(defun slime-info ()
"Open Slime manual"
(interactive)
(let ((file (expand-file-name "doc/slime.info" slime-path)))
(if (file-exists-p file)
(info file)
(message "No slime.info, run `make slime.info' in %s"
(expand-file-name "doc/" slime-path)))))
;;;; XREF: cross-referencing
(defvar slime-xref-mode-map)
(define-derived-mode slime-xref-mode lisp-mode "Xref"
"slime-xref-mode: Major mode for cross-referencing.
\\<slime-xref-mode-map>\
The most important commands:
\\[slime-xref-quit] - Dismiss buffer.
\\[slime-show-xref] - Display referenced source and keep xref window.
\\[slime-goto-xref] - Jump to referenced source and dismiss xref window.
\\{slime-xref-mode-map}
\\{slime-popup-buffer-mode-map}
"
(slime-popup-buffer-mode)
(setq font-lock-defaults nil)
(setq delayed-mode-hooks nil)
(slime-mode -1))
(slime-define-keys slime-xref-mode-map
((kbd "RET") 'slime-goto-xref)
((kbd "SPC") 'slime-goto-xref)
("v" 'slime-show-xref)
("n" 'slime-xref-next-line)
("p" 'slime-xref-prev-line)
("." 'slime-xref-next-line)
("," 'slime-xref-prev-line)
("\C-c\C-c" 'slime-recompile-xref)
("\C-c\C-k" 'slime-recompile-all-xrefs)
("\M-," 'slime-xref-retract)
([remap next-line] 'slime-xref-next-line)
([remap previous-line] 'slime-xref-prev-line)
)
;;;;; XREF results buffer and window management
(cl-defmacro slime-with-xref-buffer ((_xref-type _symbol &optional package)
&body body)
"Execute BODY in a xref buffer, then show that buffer."
(declare (indent 1))
`(slime-with-popup-buffer ((slime-buffer-name :xref)
:package ,package
:connection t
:select t
:mode 'slime-xref-mode)
(slime-set-truncate-lines)
,@body))
(defun slime-insert-xrefs (xref-alist)
"Insert XREF-ALIST in the current-buffer.
XREF-ALIST is of the form ((GROUP . ((LABEL LOCATION) ...)) ...).
GROUP and LABEL are for decoration purposes. LOCATION is a
source-location."
(cl-loop for (group . refs) in xref-alist do
(slime-insert-propertized '(face bold) group "\n")
(cl-loop for (label location) in refs do
(slime-insert-propertized
(list 'slime-location location
'face 'font-lock-keyword-face)
" " (slime-one-line-ify label) "\n")))
;; Remove the final newline to prevent accidental window-scrolling
(backward-delete-char 1))
(defun slime-xref-next-line ()
(interactive)
(slime-xref-show-location (slime-search-property 'slime-location)))
(defun slime-xref-prev-line ()
(interactive)
(slime-xref-show-location (slime-search-property 'slime-location t)))
(defun slime-xref-show-location (loc)
(cl-ecase (car loc)
(:location (slime-show-source-location loc nil 1))
(:error (message "%s" (cadr loc)))
((nil))))
(defvar slime-next-location-function nil
"Function to call for going to the next location.")
(defvar slime-previous-location-function nil
"Function to call for going to the previous location.")
(defvar slime-xref-last-buffer nil
"The most recent XREF results buffer.
This is used by `slime-goto-next-xref'")
(defun slime-show-xref-buffer (xrefs _type _symbol package)
(slime-with-xref-buffer (_type _symbol package)
(slime-insert-xrefs xrefs)
(setq slime-next-location-function 'slime-goto-next-xref)
(setq slime-previous-location-function 'slime-goto-previous-xref)
(setq slime-xref-last-buffer (current-buffer))
(goto-char (point-min))))
(defun slime-show-xrefs (xrefs type symbol package)
"Show the results of an XREF query."
(if (null xrefs)
(message "No references found for %s." symbol)
(slime-show-xref-buffer xrefs type symbol package)))
;;;;; XREF commands
(defun slime-who-calls (symbol)
"Show all known callers of the function SYMBOL."
(interactive (list (slime-read-symbol-name "Who calls: " t)))
(slime-xref :calls symbol))
(defun slime-calls-who (symbol)
"Show all known functions called by the function SYMBOL."
(interactive (list (slime-read-symbol-name "Who calls: " t)))
(slime-xref :calls-who symbol))
(defun slime-who-references (symbol)
"Show all known referrers of the global variable SYMBOL."
(interactive (list (slime-read-symbol-name "Who references: " t)))
(slime-xref :references symbol))
(defun slime-who-binds (symbol)
"Show all known binders of the global variable SYMBOL."
(interactive (list (slime-read-symbol-name "Who binds: " t)))
(slime-xref :binds symbol))
(defun slime-who-sets (symbol)
"Show all known setters of the global variable SYMBOL."
(interactive (list (slime-read-symbol-name "Who sets: " t)))
(slime-xref :sets symbol))
(defun slime-who-macroexpands (symbol)
"Show all known expanders of the macro SYMBOL."
(interactive (list (slime-read-symbol-name "Who macroexpands: " t)))
(slime-xref :macroexpands symbol))
(defun slime-who-specializes (symbol)
"Show all known methods specialized on class SYMBOL."
(interactive (list (slime-read-symbol-name "Who specializes: " t)))
(slime-xref :specializes symbol))
(defun slime-list-callers (symbol-name)
"List the callers of SYMBOL-NAME in a xref window."
(interactive (list (slime-read-symbol-name "List callers: ")))
(slime-xref :callers symbol-name))
(defun slime-list-callees (symbol-name)
"List the callees of SYMBOL-NAME in a xref window."
(interactive (list (slime-read-symbol-name "List callees: ")))
(slime-xref :callees symbol-name))
;; FIXME: whats the call (slime-postprocess-xrefs result) good for?
(defun slime-xref (type symbol &optional continuation)
"Make an XREF request to Lisp."
(slime-eval-async
`(swank:xref ',type ',symbol)
(slime-rcurry (lambda (result type symbol package cont)
(slime-check-xref-implemented type result)
(let* ((_xrefs (slime-postprocess-xrefs result))
(file-alist (cadr (slime-analyze-xrefs result))))
(funcall (or cont 'slime-show-xrefs)
file-alist type symbol package)))
type
symbol
(slime-current-package)
continuation)))
(defun slime-check-xref-implemented (type xrefs)
(when (eq xrefs :not-implemented)
(error "%s is not implemented yet on %s."
(slime-xref-type type)
(slime-lisp-implementation-name))))
(defun slime-xref-type (type)
(format "who-%s" (slime-cl-symbol-name type)))
(defun slime-xrefs (types symbol &optional continuation)
"Make multiple XREF requests at once."
(slime-eval-async
`(swank:xrefs ',types ',symbol)
#'(lambda (result)
(funcall (or continuation
#'slime-show-xrefs)
(cl-loop for (key . val) in result
collect (cons (slime-xref-type key) val))
types symbol (slime-current-package)))))
;;;;; XREF navigation
(defun slime-xref-location-at-point ()
(save-excursion
;; When the end of the last line is at (point-max) we can't find
;; the text property there. Going to bol avoids this problem.
(beginning-of-line 1)
(or (get-text-property (point) 'slime-location)
(error "No reference at point."))))
(defun slime-xref-dspec-at-point ()
(save-excursion
(beginning-of-line 1)
(with-syntax-table lisp-mode-syntax-table
(forward-sexp) ; skip initial whitespaces
(backward-sexp)
(slime-sexp-at-point))))
(defun slime-all-xrefs ()
(let ((xrefs nil))
(save-excursion
(goto-char (point-min))
(while (zerop (forward-line 1))
(let ((loc (get-text-property (point) 'slime-location)))
(when loc
(let* ((dspec (slime-xref-dspec-at-point))
(xref (make-slime-xref :dspec dspec :location loc)))
(push xref xrefs))))))
(nreverse xrefs)))
(defun slime-goto-xref ()
"Goto the cross-referenced location at point."
(interactive)
(slime-show-xref)
(quit-window))
(defun slime-show-xref ()
"Display the xref at point in the other window."
(interactive)
(let ((location (slime-xref-location-at-point)))
(slime-show-source-location location t 1)))
(defun slime-goto-next-xref (&optional backward)
"Goto the next cross-reference location."
(if (not (buffer-live-p slime-xref-last-buffer))
(error "No XREF buffer alive.")
(cl-destructuring-bind (location pos)
(with-current-buffer slime-xref-last-buffer
(list (slime-search-property 'slime-location backward)
(point)))
(cond ((slime-location-p location)
(slime-pop-to-location location)
;; We do this here because changing the location can take
;; a while when Emacs needs to read a file from disk.
(with-current-buffer slime-xref-last-buffer
(goto-char pos)
(slime-highlight-line 0.35)))
((null location)
(message (if backward "No previous xref" "No next xref.")))
(t ; error location
(slime-goto-next-xref backward))))))
(defun slime-goto-previous-xref ()
"Goto the previous cross-reference location."
(slime-goto-next-xref t))
(defun slime-search-property (prop &optional backward prop-value-fn)
"Search the next text range where PROP is non-nil.
Return the value of PROP.
If BACKWARD is non-nil, search backward.
If PROP-VALUE-FN is non-nil use it to extract PROP's value."
(let ((next-candidate (if backward
#'previous-single-char-property-change
#'next-single-char-property-change))
(prop-value-fn (or prop-value-fn
(lambda ()
(get-text-property (point) prop))))
(start (point))
(prop-value))
(while (progn
(goto-char (funcall next-candidate (point) prop))
(not (or (setq prop-value (funcall prop-value-fn))
(eobp)
(bobp)))))
(cond (prop-value)
(t (goto-char start) nil))))
(defun slime-next-location ()
"Go to the next location, depending on context.
When displaying XREF information, this goes to the next reference."
(interactive)
(when (null slime-next-location-function)
(error "No context for finding locations."))
(funcall slime-next-location-function))
(defun slime-previous-location ()
"Go to the previous location, depending on context.
When displaying XREF information, this goes to the previous reference."
(interactive)
(when (null slime-previous-location-function)
(error "No context for finding locations."))
(funcall slime-previous-location-function))
(defun slime-recompile-xref (&optional raw-prefix-arg)
(interactive "P")
(let ((slime-compilation-policy (slime-compute-policy raw-prefix-arg)))
(let ((location (slime-xref-location-at-point))
(dspec (slime-xref-dspec-at-point)))
(slime-recompile-locations
(list location)
(slime-rcurry #'slime-xref-recompilation-cont
(list dspec) (current-buffer))))))
(defun slime-recompile-all-xrefs (&optional raw-prefix-arg)
(interactive "P")
(let ((slime-compilation-policy (slime-compute-policy raw-prefix-arg)))
(let ((dspecs) (locations))
(dolist (xref (slime-all-xrefs))
(when (slime-xref-has-location-p xref)
(push (slime-xref.dspec xref) dspecs)
(push (slime-xref.location xref) locations)))
(slime-recompile-locations
locations
(slime-rcurry #'slime-xref-recompilation-cont
dspecs (current-buffer))))))
(defun slime-xref-recompilation-cont (results dspecs buffer)
;; Extreme long-windedness to insert status of recompilation;
;; sometimes Elisp resembles more of an Ewwlisp.
;; FIXME: Should probably throw out the whole recompilation cruft
;; anyway. -- helmut
;; TODO: next iteration of fixme cleanup this is going in a contrib -- jt
(with-current-buffer buffer
(slime-compilation-finished (slime-aggregate-compilation-results results))
(save-excursion
(slime-xref-insert-recompilation-flags
dspecs (cl-loop for r in results collect
(or (slime-compilation-result.successp r)
(and (slime-compilation-result.notes r)
:complained)))))))
(defun slime-aggregate-compilation-results (results)
`(:compilation-result
,(cl-reduce #'append (mapcar #'slime-compilation-result.notes results))
,(cl-every #'slime-compilation-result.successp results)
,(cl-reduce #'+ (mapcar #'slime-compilation-result.duration results))))
(defun slime-xref-insert-recompilation-flags (dspecs compilation-results)
(let* ((buffer-read-only nil)
(max-column (slime-column-max)))
(goto-char (point-min))
(cl-loop for dspec in dspecs
for result in compilation-results
do (save-excursion
(cl-loop for dspec2 = (progn (search-forward dspec)
(slime-xref-dspec-at-point))
until (equal dspec2 dspec))
(end-of-line) ; skip old status information.
(insert-char ?\ (1+ (- max-column (current-column))))
(insert (format "[%s]"
(cl-case result
((t) :success)
((nil) :failure)
(t result))))))))
;;;; Macroexpansion
(define-minor-mode slime-macroexpansion-minor-mode
"SLIME mode for macroexpansion"
nil
" Macroexpand"
'(("g" . slime-macroexpand-again)))
(cl-macrolet ((remap (from to)
`(dolist (mapping
(where-is-internal ,from slime-mode-map))
(define-key slime-macroexpansion-minor-mode-map
mapping ,to))))
(remap 'slime-macroexpand-1 'slime-macroexpand-1-inplace)
(remap 'slime-macroexpand-all 'slime-macroexpand-all-inplace)
(remap 'slime-compiler-macroexpand-1 'slime-compiler-macroexpand-1-inplace)
(remap 'slime-expand-1
'slime-expand-1-inplace)
(remap 'advertised-undo 'slime-macroexpand-undo)
(remap 'undo 'slime-macroexpand-undo))
(defun slime-macroexpand-undo (&optional arg)
(interactive)
;; Emacs 22.x introduced `undo-only' which
;; works by binding `undo-no-redo' to t. We do
;; it this way so we don't break prior Emacs
;; versions.
(cl-macrolet ((undo-only (arg) `(let ((undo-no-redo t)) (undo ,arg))))
(let ((inhibit-read-only t))
(when (fboundp 'slime-remove-edits)
(slime-remove-edits (point-min) (point-max)))
(undo-only arg))))
(defvar slime-eval-macroexpand-expression nil
"Specifies the last macroexpansion preformed.
This variable specifies both what was expanded and how.")
(defun slime-eval-macroexpand (expander &optional string)
(let ((string (or string (slime-sexp-at-point-or-error))))
(setq slime-eval-macroexpand-expression `(,expander ,string))
(slime-eval-async slime-eval-macroexpand-expression
#'slime-initialize-macroexpansion-buffer)))
(defun slime-macroexpand-again ()
"Reperform the last macroexpansion."
(interactive)
(slime-eval-async slime-eval-macroexpand-expression
(slime-rcurry #'slime-initialize-macroexpansion-buffer
(current-buffer))))
(defun slime-initialize-macroexpansion-buffer (expansion &optional buffer)
(pop-to-buffer (or buffer (slime-create-macroexpansion-buffer)))
(setq buffer-undo-list nil) ; Get rid of undo information from
; previous expansions.
(let ((inhibit-read-only t)
(buffer-undo-list t)) ; Make the initial insertion not be undoable.
(erase-buffer)
(insert expansion)
(goto-char (point-min))
(font-lock-fontify-buffer)))
(defun slime-create-macroexpansion-buffer ()
(let ((name (slime-buffer-name :macroexpansion)))
(slime-with-popup-buffer (name :package t :connection t
:mode 'lisp-mode)
(slime-mode 1)
(slime-macroexpansion-minor-mode 1)
(setq font-lock-keywords-case-fold-search t)
(current-buffer))))
(defun slime-eval-macroexpand-inplace (expander)
"Substitute the sexp at point with its macroexpansion.
NB: Does not affect slime-eval-macroexpand-expression"
(interactive)
(let* ((bounds (or (slime-bounds-of-sexp-at-point)
(user-error "No sexp at point"))))
(lexical-let* ((start (copy-marker (car bounds)))
(end (copy-marker (cdr bounds)))
(point (point))
(package (slime-current-package))
(buffer (current-buffer)))
(slime-eval-async
`(,expander ,(buffer-substring-no-properties start end))
(lambda (expansion)
(with-current-buffer buffer
(let ((buffer-read-only nil))
(when (fboundp 'slime-remove-edits)
(slime-remove-edits (point-min) (point-max)))
(goto-char start)
(delete-region start end)
(slime-insert-indented expansion)
(goto-char point))))))))
(defun slime-macroexpand-1 (&optional repeatedly)
"Display the macro expansion of the form starting at point.
The form is expanded with CL:MACROEXPAND-1 or, if a prefix
argument is given, with CL:MACROEXPAND."
(interactive "P")
(slime-eval-macroexpand
(if repeatedly 'swank:swank-macroexpand 'swank:swank-macroexpand-1)))
(defun slime-macroexpand-1-inplace (&optional repeatedly)
(interactive "P")
(slime-eval-macroexpand-inplace
(if repeatedly 'swank:swank-macroexpand 'swank:swank-macroexpand-1)))
(defun slime-macroexpand-all ()
"Display the recursively macro expanded sexp starting at
point."
(interactive)
(slime-eval-macroexpand 'swank:swank-macroexpand-all))
(defun slime-macroexpand-all-inplace ()
"Display the recursively macro expanded sexp starting at point."
(interactive)
(slime-eval-macroexpand-inplace 'swank:swank-macroexpand-all))
(defun slime-compiler-macroexpand-1 (&optional repeatedly)
"Display the compiler-macro expansion of sexp starting at point."
(interactive "P")
(slime-eval-macroexpand
(if repeatedly
'swank:swank-compiler-macroexpand
'swank:swank-compiler-macroexpand-1)))
(defun slime-compiler-macroexpand-1-inplace (&optional repeatedly)
"Display the compiler-macro expansion of sexp starting at point."
(interactive "P")
(slime-eval-macroexpand-inplace
(if repeatedly
'swank:swank-compiler-macroexpand
'swank:swank-compiler-macroexpand-1)))
(defun slime-expand-1 (&optional repeatedly)
"Display the macro expansion of the form starting at point.
The form is expanded with CL:MACROEXPAND-1 or, if a prefix
argument is given, with CL:MACROEXPAND. If the form denotes a
compiler macro, SWANK/BACKEND:COMPILER-MACROEXPAND or
SWANK/BACKEND:COMPILER-MACROEXPAND-1 are used instead."
(interactive "P")
(slime-eval-macroexpand
(if repeatedly
'swank:swank-expand
'swank:swank-expand-1)))
(defun slime-expand-1-inplace (&optional repeatedly)
"Display the macro expansion of the form at point.
The form is expanded with CL:MACROEXPAND-1 or, if a prefix
argument is given, with CL:MACROEXPAND."
(interactive "P")
(slime-eval-macroexpand-inplace
(if repeatedly
'swank:swank-expand
'swank:swank-expand-1)))
(defun slime-format-string-expand (&optional string)
"Expand the format-string at point and display it."
(interactive (list (or (and (not current-prefix-arg)
(slime-string-at-point))
(slime-read-from-minibuffer "Expand format: "
(slime-string-at-point)))))
(slime-eval-macroexpand 'swank:swank-format-string-expand string))
;;;; Subprocess control
(defun slime-interrupt ()
"Interrupt Lisp."
(interactive)
(cond ((slime-use-sigint-for-interrupt) (slime-send-sigint))
(t (slime-dispatch-event `(:emacs-interrupt ,slime-current-thread)))))
(defun slime-quit ()
(error "Not implemented properly. Use `slime-interrupt' instead."))
(defun slime-quit-lisp (&optional kill)
"Quit lisp, kill the inferior process and associated buffers."
(interactive "P")
(slime-quit-lisp-internal (slime-connection) 'slime-quit-sentinel kill))
(defun slime-quit-lisp-internal (connection sentinel kill)
(let ((slime-dispatching-connection connection))
(slime-eval-async '(swank:quit-lisp))
(let* ((process (slime-inferior-process connection)))
(set-process-filter connection nil)
(set-process-sentinel connection sentinel)
(when (and kill process)
(sleep-for 0.2)
(unless (memq (process-status process) '(exit signal))
(kill-process process))))))
(defun slime-quit-sentinel (process _message)
(cl-assert (process-status process) 'closed)
(let* ((inferior (slime-inferior-process process))
(inferior-buffer (if inferior (process-buffer inferior))))
(when inferior (delete-process inferior))
(when inferior-buffer (kill-buffer inferior-buffer))
(slime-net-close process)
(message "Connection closed.")))
;;;; Debugger (SLDB)
(defvar sldb-hook nil
"Hook run on entry to the debugger.")
(defcustom sldb-initial-restart-limit 6
"Maximum number of restarts to display initially."
:group 'slime-debugger
:type 'integer)
;;;;; Local variables in the debugger buffer
;; Small helper.
(defun slime-make-variables-buffer-local (&rest variables)
(mapcar #'make-variable-buffer-local variables))
(slime-make-variables-buffer-local
(defvar sldb-condition nil
"A list (DESCRIPTION TYPE) describing the condition being debugged.")
(defvar sldb-restarts nil
"List of (NAME DESCRIPTION) for each available restart.")
(defvar sldb-level nil
"Current debug level (recursion depth) displayed in buffer.")
(defvar sldb-backtrace-start-marker nil
"Marker placed at the first frame of the backtrace.")
(defvar sldb-restart-list-start-marker nil
"Marker placed at the first restart in the restart list.")
(defvar sldb-continuations nil
"List of ids for pending continuation."))
;;;;; SLDB macros
;; some macros that we need to define before the first use
(defmacro sldb-in-face (name string)
"Return STRING propertised with face sldb-NAME-face."
(declare (indent 1))
(let ((facename (intern (format "sldb-%s-face" (symbol-name name))))
(var (cl-gensym "string")))
`(let ((,var ,string))
(slime-add-face ',facename ,var)
,var)))
;;;;; sldb-mode
(defvar sldb-mode-syntax-table
(let ((table (copy-syntax-table lisp-mode-syntax-table)))
;; We give < and > parenthesis syntax, so that #< ... > is treated
;; as a balanced expression. This enables autodoc-mode to match
;; #<unreadable> actual arguments in the backtraces with formal
;; arguments of the function. (For Lisp mode, this is not
;; desirable, since we do not wish to get a mismatched paren
;; highlighted everytime we type < or >.)
(modify-syntax-entry ?< "(" table)
(modify-syntax-entry ?> ")" table)
table)
"Syntax table for SLDB mode.")
(define-derived-mode sldb-mode fundamental-mode "sldb"
"Superior lisp debugger mode.
In addition to ordinary SLIME commands, the following are
available:\\<sldb-mode-map>
Commands to examine the selected frame:
\\[sldb-toggle-details] - toggle details (local bindings, CATCH tags)
\\[sldb-show-source] - view source for the frame
\\[sldb-eval-in-frame] - eval in frame
\\[sldb-pprint-eval-in-frame] - eval in frame, pretty-print result
\\[sldb-disassemble] - disassemble
\\[sldb-inspect-in-frame] - inspect
Commands to invoke restarts:
\\[sldb-quit] - quit
\\[sldb-abort] - abort
\\[sldb-continue] - continue
\\[sldb-invoke-restart-0]-\\[sldb-invoke-restart-9] - restart shortcuts
\\[sldb-invoke-restart-by-name] - invoke restart by name
Commands to navigate frames:
\\[sldb-down] - down
\\[sldb-up] - up
\\[sldb-details-down] - down, with details
\\[sldb-details-up] - up, with details
\\[sldb-cycle] - cycle between restarts & backtrace
\\[sldb-beginning-of-backtrace] - beginning of backtrace
\\[sldb-end-of-backtrace] - end of backtrace
Miscellaneous commands:
\\[sldb-restart-frame] - restart frame
\\[sldb-return-from-frame] - return from frame
\\[sldb-step] - step
\\[sldb-break-with-default-debugger] - switch to native debugger
\\[sldb-break-with-system-debugger] - switch to system debugger (gdb)
\\[slime-interactive-eval] - eval
\\[sldb-inspect-condition] - inspect signalled condition
Full list of commands:
\\{sldb-mode-map}"
(erase-buffer)
(set-syntax-table sldb-mode-syntax-table)
(slime-set-truncate-lines)
;; Make original slime-connection "sticky" for SLDB commands in this buffer
(setq slime-buffer-connection (slime-connection)))
(set-keymap-parent sldb-mode-map slime-parent-map)
(slime-define-keys sldb-mode-map
((kbd "RET") 'sldb-default-action)
("\C-m" 'sldb-default-action)
([return] 'sldb-default-action)
([mouse-2] 'sldb-default-action/mouse)
([follow-link] 'mouse-face)
("\C-i" 'sldb-cycle)
("h" 'describe-mode)
("v" 'sldb-show-source)
("e" 'sldb-eval-in-frame)
("d" 'sldb-pprint-eval-in-frame)
("D" 'sldb-disassemble)
("i" 'sldb-inspect-in-frame)
("n" 'sldb-down)
("p" 'sldb-up)
("\M-n" 'sldb-details-down)
("\M-p" 'sldb-details-up)
("<" 'sldb-beginning-of-backtrace)
(">" 'sldb-end-of-backtrace)
("t" 'sldb-toggle-details)
("r" 'sldb-restart-frame)
("I" 'sldb-invoke-restart-by-name)
("R" 'sldb-return-from-frame)
("c" 'sldb-continue)
("s" 'sldb-step)
("x" 'sldb-next)
("o" 'sldb-out)
("b" 'sldb-break-on-return)
("a" 'sldb-abort)
("q" 'sldb-quit)
("A" 'sldb-break-with-system-debugger)
("B" 'sldb-break-with-default-debugger)
("P" 'sldb-print-condition)
("C" 'sldb-inspect-condition)
(":" 'slime-interactive-eval)
("\C-c\C-c" 'sldb-recompile-frame-source))
;; Keys 0-9 are shortcuts to invoke particular restarts.
(dotimes (number 10)
(let ((fname (intern (format "sldb-invoke-restart-%S" number)))
(docstring (format "Invoke restart numbered %S." number)))
(eval `(defun ,fname ()
,docstring
(interactive)
(sldb-invoke-restart ,number)))
(define-key sldb-mode-map (number-to-string number) fname)))
;;;;; SLDB buffer creation & update
(defun sldb-buffers (&optional connection)
"Return a list of all sldb buffers (belonging to CONNECTION.)"
(if connection
(slime-filter-buffers (lambda ()
(and (eq slime-buffer-connection connection)
(eq major-mode 'sldb-mode))))
(slime-filter-buffers (lambda () (eq major-mode 'sldb-mode)))))
(defun sldb-find-buffer (thread &optional connection)
(let ((connection (or connection (slime-connection))))
(cl-find-if (lambda (buffer)
(with-current-buffer buffer
(and (eq slime-buffer-connection connection)
(eq slime-current-thread thread))))
(sldb-buffers))))
(defun sldb-get-default-buffer ()
"Get a sldb buffer.
The chosen buffer the default connection's it if exists."
(car (sldb-buffers slime-default-connection)))
(defun sldb-get-buffer (thread &optional connection)
"Find or create a sldb-buffer for THREAD."
(let ((connection (or connection (slime-connection))))
(or (sldb-find-buffer thread connection)
(let ((name (format "*sldb %s/%s*" (slime-connection-name) thread)))
(with-current-buffer (generate-new-buffer name)
(setq slime-buffer-connection connection
slime-current-thread thread)
(current-buffer))))))
(defun sldb-debugged-continuations (connection)
"Return the all debugged continuations for CONNECTION across SLDB buffers."
(cl-loop for b in (sldb-buffers)
append (with-current-buffer b
(and (eq slime-buffer-connection connection)
sldb-continuations))))
(defun sldb--display-buffer-reuse-last-window (buffer _alist)
(let ((window
(get-window-with-predicate (lambda (w)
(window-parameter w 'sldb-last-window)))))
(when (and window
(not (with-current-buffer (window-buffer window)
(derived-mode-p 'sldb-mode))))
(display-buffer-record-window 'reuse window buffer)
(set-window-buffer window buffer)
window)))
(defun sldb-display-buffer (buffer)
"Pop to BUFFER reusing the last SLDB window, if any."
(pop-to-buffer buffer '(sldb--display-buffer-reuse-last-window)))
(defun sldb-setup (thread level condition restarts frames conts)
"Setup a new SLDB buffer.
CONDITION is a string describing the condition to debug.
RESTARTS is a list of strings (NAME DESCRIPTION) for each available restart.
FRAMES is a list (NUMBER DESCRIPTION &optional PLIST) describing the initial
portion of the backtrace. Frames are numbered from 0.
CONTS is a list of pending Emacs continuations."
(with-current-buffer (sldb-get-buffer thread)
(cl-assert (if (equal sldb-level level)
(equal sldb-condition condition)
t)
() "Bug: sldb-level is equal but condition differs\n%s\n%s"
sldb-condition condition)
(unless (equal sldb-level level)
(setq buffer-read-only nil)
(sldb-mode)
(setq slime-current-thread thread)
(setq sldb-level level)
(setq mode-name (format "sldb[%d]" sldb-level))
(setq sldb-condition condition)
(setq sldb-restarts restarts)
(setq sldb-continuations conts)
(sldb-insert-condition condition)
(insert "\n\n" (sldb-in-face section "Restarts:") "\n")
(setq sldb-restart-list-start-marker (point-marker))
(sldb-insert-restarts restarts 0 sldb-initial-restart-limit)
(insert "\n" (sldb-in-face section "Backtrace:") "\n")
(setq sldb-backtrace-start-marker (point-marker))
(save-excursion
(if frames
(sldb-insert-frames (sldb-prune-initial-frames frames) t)
(insert "[No backtrace]")))
(run-hooks 'sldb-hook)
(set-syntax-table lisp-mode-syntax-table))
;; FIXME: remove when dropping Emacs23 support
(let ((saved (selected-window)))
(sldb-display-buffer (current-buffer))
(set-window-parameter (selected-window) 'sldb-restore saved))
(unless noninteractive ; needed for tests in batch-mode
(slime--display-region (point-min) (point)))
(setq buffer-read-only t)
(when (and slime-stack-eval-tags
;; (y-or-n-p "Enter recursive edit? ")
)
(message "Entering recursive edit..")
(recursive-edit))))
(defun sldb-activate (thread level select)
"Display the debugger buffer for THREAD.
If LEVEL isn't the same as in the buffer reinitialize the buffer."
(or (let ((buffer (sldb-find-buffer thread)))
(when buffer
(with-current-buffer buffer
(when (equal sldb-level level)
(when select (pop-to-buffer (current-buffer)))
t))))
(sldb-reinitialize thread level)))
(defun sldb-reinitialize (thread level)
(slime-rex (thread level)
('(swank:debugger-info-for-emacs 0 10)
nil thread)
((:ok result)
(apply #'sldb-setup thread level result))))
(defun sldb--mark-last-window (window)
(dolist (window (window-list))
(when (window-parameter window 'sldb-last-window)
(set-window-parameter window 'sldb-last-window nil)))
(set-window-parameter (selected-window) 'sldb-last-window t))
(defun sldb-exit (thread _level &optional stepping)
"Exit from the debug level LEVEL."
(let ((sldb (sldb-find-buffer thread)))
(when sldb
(with-current-buffer sldb
(cond (stepping
(setq sldb-level nil)
(run-with-timer 0.4 nil 'sldb-close-step-buffer sldb))
((not (eq sldb (window-buffer (selected-window))))
;; A different window selection means an indirect,
;; non-interactive exit, we just kill the sldb buffer.
(kill-buffer))
(t
(sldb--mark-last-window (selected-window))
;; An interactive exit should restore configuration per
;; `quit-window's protocol. FIXME: remove
;; `previous-window' hack when dropping Emacs23 support
(let ((previous-window (window-parameter (selected-window)
'sldb-restore)))
(quit-window t)
(if (and (not (>= emacs-major-version 24))
(window-live-p previous-window))
(select-window previous-window)))))))))
(defun sldb-close-step-buffer (buffer)
(when (buffer-live-p buffer)
(with-current-buffer buffer
(when (not sldb-level)
(quit-window t)))))
;;;;;; SLDB buffer insertion
(defun sldb-insert-condition (condition)
"Insert the text for CONDITION.
CONDITION should be a list (MESSAGE TYPE EXTRAS).
EXTRAS is currently used for the stepper."
(cl-destructuring-bind (message type extras) condition
(slime-insert-propertized '(sldb-default-action sldb-inspect-condition)
(sldb-in-face topline message)
"\n"
(sldb-in-face condition type))
(sldb-dispatch-extras extras)))
(defvar sldb-extras-hooks)
(defun sldb-dispatch-extras (extras)
;; this is (mis-)used for the stepper
(dolist (extra extras)
(slime-dcase extra
((:show-frame-source n)
(sldb-show-frame-source n))
(t
(or (run-hook-with-args-until-success 'sldb-extras-hooks extra)
;;(error "Unhandled extra element:" extra)
)))))
(defun sldb-insert-restarts (restarts start count)
"Insert RESTARTS and add the needed text props
RESTARTS should be a list ((NAME DESCRIPTION) ...)."
(let* ((len (length restarts))
(end (if count (min (+ start count) len) len)))
(cl-loop for (name string) in (cl-subseq restarts start end)
for number from start
do (slime-insert-propertized
`(,@nil restart ,number
sldb-default-action sldb-invoke-restart
mouse-face highlight)
" " (sldb-in-face restart-number (number-to-string number))
": [" (sldb-in-face restart-type name) "] "
(sldb-in-face restart string))
(insert "\n"))
(when (< end len)
(let ((pos (point)))
(slime-insert-propertized
(list 'sldb-default-action
(slime-rcurry #'sldb-insert-more-restarts restarts pos end))
" --more--\n")))))
(defun sldb-insert-more-restarts (restarts position start)
(goto-char position)
(let ((inhibit-read-only t))
(delete-region position (1+ (line-end-position)))
(sldb-insert-restarts restarts start nil)))
(defun sldb-frame.string (frame)
(cl-destructuring-bind (_ str &optional _) frame str))
(defun sldb-frame.number (frame)
(cl-destructuring-bind (n _ &optional _) frame n))
(defun sldb-frame.plist (frame)
(cl-destructuring-bind (_ _ &optional plist) frame plist))
(defun sldb-frame-restartable-p (frame)
(and (plist-get (sldb-frame.plist frame) :restartable) t))
(defun sldb-prune-initial-frames (frames)
"Return the prefix of FRAMES to initially present to the user.
Regexp heuristics are used to avoid showing SWANK-internal frames."
(let* ((case-fold-search t)
(rx "^\\([() ]\\|lambda\\)*swank\\>"))
(or (cl-loop for frame in frames
until (string-match rx (sldb-frame.string frame))
collect frame)
frames)))
(defun sldb-insert-frames (frames more)
"Insert FRAMES into buffer.
If MORE is non-nil, more frames are on the Lisp stack."
(mapc #'sldb-insert-frame frames)
(when more
(slime-insert-propertized
`(,@nil sldb-default-action sldb-fetch-more-frames
sldb-previous-frame-number
,(sldb-frame.number (cl-first (last frames)))
point-entered sldb-fetch-more-frames
start-open t
face sldb-section-face
mouse-face highlight)
" --more--")
(insert "\n")))
(defun sldb-compute-frame-face (frame)
(if (sldb-frame-restartable-p frame)
'sldb-restartable-frame-line-face
'sldb-frame-line-face))
(defun sldb-insert-frame (frame &optional face)
"Insert FRAME with FACE at point.
If FACE is nil, `sldb-compute-frame-face' is used to determine the face."
(setq face (or face (sldb-compute-frame-face frame)))
(let ((number (sldb-frame.number frame))
(string (sldb-frame.string frame))
(props `(frame ,frame sldb-default-action sldb-toggle-details)))
(slime-propertize-region props
(slime-propertize-region '(mouse-face highlight)
(insert " " (sldb-in-face frame-label (format "%2d:" number)) " ")
(slime-insert-indented
(slime-add-face face string)))
(insert "\n"))))
(defun sldb-fetch-more-frames (&rest _)
"Fetch more backtrace frames.
Called on the `point-entered' text-property hook."
(let ((inhibit-point-motion-hooks t)
(inhibit-read-only t)
(prev (get-text-property (point) 'sldb-previous-frame-number)))
;; we may be called twice, PREV is nil the second time
(when prev
(let* ((count 40)
(from (1+ prev))
(to (+ from count))
(frames (slime-eval `(swank:backtrace ,from ,to)))
(more (slime-length= frames count))
(pos (point)))
(delete-region (line-beginning-position) (point-max))
(sldb-insert-frames frames more)
(goto-char pos)))))
;;;;;; SLDB examining text props
(defun sldb-restart-at-point ()
(or (get-text-property (point) 'restart)
(error "No restart at point")))
(defun sldb-frame-number-at-point ()
(let ((frame (get-text-property (point) 'frame)))
(cond (frame (car frame))
(t (error "No frame at point")))))
(defun sldb-var-number-at-point ()
(let ((var (get-text-property (point) 'var)))
(cond (var var)
(t (error "No variable at point")))))
(defun sldb-previous-frame-number ()
(save-excursion
(sldb-backward-frame)
(sldb-frame-number-at-point)))
(defun sldb-frame-details-visible-p ()
(and (get-text-property (point) 'frame)
(get-text-property (point) 'details-visible-p)))
(defun sldb-frame-region ()
(slime-property-bounds 'frame))
(defun sldb-forward-frame ()
(goto-char (next-single-char-property-change (point) 'frame)))
(defun sldb-backward-frame ()
(when (> (point) sldb-backtrace-start-marker)
(goto-char (previous-single-char-property-change
(if (get-text-property (point) 'frame)
(car (sldb-frame-region))
(point))
'frame
nil sldb-backtrace-start-marker))))
(defun sldb-goto-last-frame ()
(goto-char (point-max))
(while (not (get-text-property (point) 'frame))
(goto-char (previous-single-property-change (point) 'frame))
;; Recenter to bottom of the window; -2 to account for the
;; empty last line displayed in sldb buffers.
(recenter -2)))
(defun sldb-beginning-of-backtrace ()
"Goto the first frame."
(interactive)
(goto-char sldb-backtrace-start-marker))
;;;;;; SLDB recenter & redisplay
;; not sure yet, whether this is a good idea.
;;
;; jt: seconded. Only `sldb-show-frame-details' and
;; `sldb-hide-frame-details' use this. They could avoid it by not
;; removing and reinserting the frame's name line.
(defmacro slime-save-coordinates (origin &rest body)
"Restore line and column relative to ORIGIN, after executing BODY.
This is useful if BODY deletes and inserts some text but we want to
preserve the current row and column as closely as possible."
(let ((base (make-symbol "base"))
(goal (make-symbol "goal"))
(mark (make-symbol "mark")))
`(let* ((,base ,origin)
(,goal (slime-coordinates ,base))
(,mark (point-marker)))
(set-marker-insertion-type ,mark t)
(prog1 (save-excursion ,@body)
(slime-restore-coordinate ,base ,goal ,mark)))))
(put 'slime-save-coordinates 'lisp-indent-function 1)
(defun slime-coordinates (origin)
;; Return a pair (X . Y) for the column and line distance to ORIGIN.
(let ((y (slime-count-lines origin (point)))
(x (save-excursion
(- (current-column)
(progn (goto-char origin) (current-column))))))
(cons x y)))
(defun slime-restore-coordinate (base goal limit)
;; Move point to GOAL. Coordinates are relative to BASE.
;; Don't move beyond LIMIT.
(save-restriction
(narrow-to-region base limit)
(goto-char (point-min))
(let ((col (current-column)))
(forward-line (cdr goal))
(when (and (eobp) (bolp) (not (bobp)))
(backward-char))
(move-to-column (+ col (car goal))))))
(defun slime-count-lines (start end)
"Return the number of lines between START and END.
This is 0 if START and END at the same line."
(- (count-lines start end)
(if (save-excursion (goto-char end) (bolp)) 0 1)))
;;;;; SLDB commands
(defun sldb-default-action ()
"Invoke the action at point."
(interactive)
(let ((fn (get-text-property (point) 'sldb-default-action)))
(if fn (funcall fn))))
(defun sldb-default-action/mouse (event)
"Invoke the action pointed at by the mouse."
(interactive "e")
(cl-destructuring-bind (_mouse-1 (_w pos &rest ignore)) event
(save-excursion
(goto-char pos)
(let ((fn (get-text-property (point) 'sldb-default-action)))
(if fn (funcall fn))))))
(defun sldb-cycle ()
"Cycle between restart list and backtrace."
(interactive)
(let ((pt (point)))
(cond ((< pt sldb-restart-list-start-marker)
(goto-char sldb-restart-list-start-marker))
((< pt sldb-backtrace-start-marker)
(goto-char sldb-backtrace-start-marker))
(t
(goto-char sldb-restart-list-start-marker)))))
(defun sldb-end-of-backtrace ()
"Fetch the entire backtrace and go to the last frame."
(interactive)
(sldb-fetch-all-frames)
(sldb-goto-last-frame))
(defun sldb-fetch-all-frames ()
(let ((inhibit-read-only t)
(inhibit-point-motion-hooks t))
(sldb-goto-last-frame)
(let ((last (sldb-frame-number-at-point)))
(goto-char (next-single-char-property-change (point) 'frame))
(delete-region (point) (point-max))
(save-excursion
(sldb-insert-frames (slime-eval `(swank:backtrace ,(1+ last) nil))
nil)))))
;;;;;; SLDB show source
(defun sldb-show-source ()
"Highlight the frame at point's expression in a source code buffer."
(interactive)
(sldb-show-frame-source (sldb-frame-number-at-point)))
(defun sldb-show-frame-source (frame-number)
(slime-eval-async
`(swank:frame-source-location ,frame-number)
(lambda (source-location)
(slime-dcase source-location
((:error message)
(message "%s" message)
(ding))
(t
(slime-show-source-location source-location t nil))))))
(defun slime-show-source-location (source-location
&optional highlight recenter-arg)
"Go to SOURCE-LOCATION and display the buffer in the other window."
(slime-goto-source-location source-location)
;; show the location, but don't hijack focus.
(slime--display-position (point) t recenter-arg)
(when highlight (slime-highlight-sexp)))
(defun slime--display-position (pos other-window recenter-arg)
(with-selected-window (display-buffer (current-buffer) other-window)
(goto-char pos)
(recenter recenter-arg)))
;; Set window-start so that the region from START to END becomes visible.
;; START is inclusive; END is exclusive.
(defun slime--adjust-window-start (start end)
(let* ((last (max start (1- end)))
(window-height (window-text-height))
(region-height (count-screen-lines start last t)))
;; if needed, make the region visible
(when (or (not (pos-visible-in-window-p start))
(not (pos-visible-in-window-p last)))
(let* ((nlines (cond ((or (< start (window-start))
(>= region-height window-height))
0)
(t
(- region-height)))))
(goto-char start)
(recenter nlines)))
(cl-assert (pos-visible-in-window-p start))
(cl-assert (or (pos-visible-in-window-p last)
(> region-height window-height)))
(cl-assert (pos-visible-in-window-p (1- (window-end nil t)) nil t))))
;; move POS to visible region
(defun slime--adjust-window-point (pos)
(cond ((pos-visible-in-window-p pos)
(goto-char pos))
((< pos (window-start))
(goto-char (window-start)))
(t
(goto-char (1- (window-end nil t)))
(move-to-column 0)))
(cl-assert (pos-visible-in-window-p (point) nil t)))
(defun slime--display-region (start end)
"Make the region from START to END visible.
Minimize point motion."
(cl-assert (<= start end))
(cl-assert (eq (window-buffer (selected-window))
(current-buffer)))
(let ((pos (point)))
(slime--adjust-window-start start end)
(slime--adjust-window-point pos)))
(defun slime-highlight-sexp (&optional start end)
"Highlight the first sexp after point."
(let ((start (or start (point)))
(end (or end (save-excursion (ignore-errors (forward-sexp)) (point)))))
(slime-flash-region start end)))
(defun slime-highlight-line (&optional timeout)
(slime-flash-region (+ (line-beginning-position) (current-indentation))
(line-end-position)
timeout))
;;;;;; SLDB toggle details
(defun sldb-toggle-details (&optional on)
"Toggle display of details for the current frame.
The details include local variable bindings and CATCH-tags."
(interactive)
(cl-assert (sldb-frame-number-at-point))
(let ((inhibit-read-only t)
(inhibit-point-motion-hooks t))
(if (or on (not (sldb-frame-details-visible-p)))
(sldb-show-frame-details)
(sldb-hide-frame-details))))
(defun sldb-show-frame-details ()
;; fetch and display info about local variables and catch tags
(cl-destructuring-bind (start end frame locals catches) (sldb-frame-details)
(slime-save-coordinates start
(delete-region start end)
(slime-propertize-region `(frame ,frame details-visible-p t)
(sldb-insert-frame frame (if (sldb-frame-restartable-p frame)
'sldb-restartable-frame-line-face
;; FIXME: can we somehow merge the two?
'sldb-detailed-frame-line-face))
(let ((indent1 " ")
(indent2 " "))
(insert indent1 (sldb-in-face section
(if locals "Locals:" "[No Locals]")) "\n")
(sldb-insert-locals locals indent2 frame)
(when catches
(insert indent1 (sldb-in-face section "Catch-tags:") "\n")
(dolist (tag catches)
(slime-propertize-region `(catch-tag ,tag)
(insert indent2 (sldb-in-face catch-tag (format "%s" tag))
"\n"))))
(setq end (point)))))
(slime--display-region (point) end)))
(defun sldb-frame-details ()
;; Return a list (START END FRAME LOCALS CATCHES) for frame at point.
(let* ((frame (get-text-property (point) 'frame))
(num (car frame)))
(cl-destructuring-bind (start end) (sldb-frame-region)
(cl-list* start end frame
(slime-eval `(swank:frame-locals-and-catch-tags ,num))))))
(defvar sldb-insert-frame-variable-value-function
'sldb-insert-frame-variable-value)
(defun sldb-insert-locals (vars prefix frame)
"Insert VARS and add PREFIX at the beginning of each inserted line.
VAR should be a plist with the keys :name, :id, and :value."
(cl-loop for i from 0
for var in vars do
(cl-destructuring-bind (&key name id value) var
(slime-propertize-region
(list 'sldb-default-action 'sldb-inspect-var 'var i)
(insert prefix
(sldb-in-face local-name
(concat name (if (zerop id) "" (format "#%d" id))))
" = ")
(funcall sldb-insert-frame-variable-value-function
value frame i)
(insert "\n")))))
(defun sldb-insert-frame-variable-value (value _frame _index)
(insert (sldb-in-face local-value value)))
(defun sldb-hide-frame-details ()
;; delete locals and catch tags, but keep the function name and args.
(cl-destructuring-bind (start end) (sldb-frame-region)
(let ((frame (get-text-property (point) 'frame)))
(slime-save-coordinates start
(delete-region start end)
(slime-propertize-region '(details-visible-p nil)
(sldb-insert-frame frame))))))
(defun sldb-disassemble ()
"Disassemble the code for the current frame."
(interactive)
(let ((frame (sldb-frame-number-at-point)))
(slime-eval-async `(swank:sldb-disassemble ,frame)
(lambda (result)
(slime-show-description result nil)))))
;;;;;; SLDB eval and inspect
(defun sldb-eval-in-frame (frame string package)
"Prompt for an expression and evaluate it in the selected frame."
(interactive (sldb-read-form-for-frame "Eval in frame (%s)> "))
(slime-eval-async `(swank:eval-string-in-frame ,string ,frame ,package)
(if current-prefix-arg
'slime-write-string
'slime-display-eval-result)))
(defun sldb-pprint-eval-in-frame (frame string package)
"Prompt for an expression, evaluate in selected frame, pretty-print result."
(interactive (sldb-read-form-for-frame "Eval in frame (%s)> "))
(slime-eval-async
`(swank:pprint-eval-string-in-frame ,string ,frame ,package)
(lambda (result)
(slime-show-description result nil))))
(defun sldb-read-form-for-frame (fstring)
(let* ((frame (sldb-frame-number-at-point))
(pkg (slime-eval `(swank:frame-package-name ,frame))))
(list frame
(let ((slime-buffer-package pkg))
(slime-read-from-minibuffer (format fstring pkg)))
pkg)))
(defun sldb-inspect-in-frame (string)
"Prompt for an expression and inspect it in the selected frame."
(interactive (list (slime-read-from-minibuffer
"Inspect in frame (evaluated): "
(slime-sexp-at-point))))
(let ((number (sldb-frame-number-at-point)))
(slime-eval-async `(swank:inspect-in-frame ,string ,number)
'slime-open-inspector)))
(defun sldb-inspect-var ()
(let ((frame (sldb-frame-number-at-point))
(var (sldb-var-number-at-point)))
(slime-eval-async `(swank:inspect-frame-var ,frame ,var)
'slime-open-inspector)))
(defun sldb-inspect-condition ()
"Inspect the current debugger condition."
(interactive)
(slime-eval-async '(swank:inspect-current-condition)
'slime-open-inspector))
(defun sldb-print-condition ()
(interactive)
(slime-eval-describe `(swank:sdlb-print-condition)))
;;;;;; SLDB movement
(defun sldb-down ()
"Select next frame."
(interactive)
(sldb-forward-frame))
(defun sldb-up ()
"Select previous frame."
(interactive)
(sldb-backward-frame)
(when (= (point) sldb-backtrace-start-marker)
(recenter (1+ (count-lines (point-min) (point))))))
(defun sldb-sugar-move (move-fn)
(let ((inhibit-read-only t))
(when (sldb-frame-details-visible-p) (sldb-hide-frame-details))
(funcall move-fn)
(sldb-show-source)
(sldb-toggle-details t)))
(defun sldb-details-up ()
"Select previous frame and show details."
(interactive)
(sldb-sugar-move 'sldb-up))
(defun sldb-details-down ()
"Select next frame and show details."
(interactive)
(sldb-sugar-move 'sldb-down))
;;;;;; SLDB restarts
(defun sldb-quit ()
"Quit to toplevel."
(interactive)
(cl-assert sldb-restarts () "sldb-quit called outside of sldb buffer")
(slime-rex () ('(swank:throw-to-toplevel))
((:ok x) (error "sldb-quit returned [%s]" x))
((:abort _))))
(defun sldb-continue ()
"Invoke the \"continue\" restart."
(interactive)
(cl-assert sldb-restarts () "sldb-continue called outside of sldb buffer")
(slime-rex ()
('(swank:sldb-continue))
((:ok _)
(message "No restart named continue")
(ding))
((:abort _))))
(defun sldb-abort ()
"Invoke the \"abort\" restart."
(interactive)
(slime-eval-async '(swank:sldb-abort)
(lambda (v) (message "Restart returned: %S" v))))
(defun sldb-invoke-restart (&optional number)
"Invoke a restart.
Optional NUMBER (index into `sldb-restarts') specifies the
restart to invoke, otherwise use the restart at point."
(interactive)
(let ((restart (or number (sldb-restart-at-point))))
(slime-rex ()
((list 'swank:invoke-nth-restart-for-emacs sldb-level restart))
((:ok value) (message "Restart returned: %s" value))
((:abort _)))))
(defun sldb-invoke-restart-by-name (restart-name)
(interactive (list (let ((completion-ignore-case t))
(completing-read "Restart: " sldb-restarts nil t
""
'sldb-invoke-restart-by-name))))
(sldb-invoke-restart (cl-position restart-name sldb-restarts
:test 'string= :key 'first)))
(defun sldb-break-with-default-debugger (&optional dont-unwind)
"Enter default debugger."
(interactive "P")
(slime-rex ()
((list 'swank:sldb-break-with-default-debugger
(not (not dont-unwind)))
nil slime-current-thread)
((:abort _))))
(defun sldb-break-with-system-debugger (&optional lightweight)
"Enter system debugger (gdb)."
(interactive "P")
(slime-attach-gdb slime-buffer-connection lightweight))
(defun slime-attach-gdb (connection &optional lightweight)
"Run `gud-gdb'on the connection with PID `pid'.
If `lightweight' is given, do not send any request to the
inferior Lisp (e.g. to obtain default gdb config) but only
operate from the Emacs side; intended for cases where the Lisp is
truly screwed up."
(interactive
(list (slime-read-connection "Attach gdb to: " (slime-connection)) "P"))
(let ((pid (slime-pid connection))
(file (slime-lisp-implementation-program connection))
(commands (unless lightweight
(let ((slime-dispatching-connection connection))
(slime-eval `(swank:gdb-initial-commands))))))
(gud-gdb (format "gdb -p %d %s" pid (or file "")))
(with-current-buffer gud-comint-buffer
(dolist (cmd commands)
;; First wait until gdb was initialized, then wait until current
;; command was processed.
(while (not (looking-back comint-prompt-regexp nil))
(sit-for 0.01))
;; We do not use `gud-call' because we want the initial commands
;; to be displayed by the user so he knows what he's got.
(insert cmd)
(comint-send-input)))))
(defun slime-read-connection (prompt &optional initial-value)
"Read a connection from the minibuffer.
Return the net process, or nil."
(cl-assert (memq initial-value slime-net-processes))
(let* ((to-string (lambda (p)
(format "%s (pid %d)"
(slime-connection-name p) (slime-pid p))))
(candidates (mapcar (lambda (p) (cons (funcall to-string p) p))
slime-net-processes)))
(cdr (assoc (completing-read prompt candidates
nil t (funcall to-string initial-value))
candidates))))
(defun sldb-step ()
"Step to next basic-block boundary."
(interactive)
(let ((frame (sldb-frame-number-at-point)))
(slime-eval-async `(swank:sldb-step ,frame))))
(defun sldb-next ()
"Step over call."
(interactive)
(let ((frame (sldb-frame-number-at-point)))
(slime-eval-async `(swank:sldb-next ,frame))))
(defun sldb-out ()
"Resume stepping after returning from this function."
(interactive)
(let ((frame (sldb-frame-number-at-point)))
(slime-eval-async `(swank:sldb-out ,frame))))
(defun sldb-break-on-return ()
"Set a breakpoint at the current frame.
The debugger is entered when the frame exits."
(interactive)
(let ((frame (sldb-frame-number-at-point)))
(slime-eval-async `(swank:sldb-break-on-return ,frame)
(lambda (msg) (message "%s" msg)))))
(defun sldb-break (name)
"Set a breakpoint at the start of the function NAME."
(interactive (list (slime-read-symbol-name "Function: " t)))
(slime-eval-async `(swank:sldb-break ,name)
(lambda (msg) (message "%s" msg))))
(defun sldb-return-from-frame (string)
"Reads an expression in the minibuffer and causes the function to
return that value, evaluated in the context of the frame."
(interactive (list (slime-read-from-minibuffer "Return from frame: ")))
(let* ((number (sldb-frame-number-at-point)))
(slime-rex ()
((list 'swank:sldb-return-from-frame number string))
((:ok value) (message "%s" value))
((:abort _)))))
(defun sldb-restart-frame ()
"Causes the frame to restart execution with the same arguments as it
was called originally."
(interactive)
(let* ((number (sldb-frame-number-at-point)))
(slime-rex ()
((list 'swank:restart-frame number))
((:ok value) (message "%s" value))
((:abort _)))))
(defun slime-toggle-break-on-signals ()
"Toggle the value of *break-on-signals*."
(interactive)
(slime-eval-async `(swank:toggle-break-on-signals)
(lambda (msg) (message "%s" msg))))
;;;;;; SLDB recompilation commands
(defun sldb-recompile-frame-source (&optional raw-prefix-arg)
(interactive "P")
(slime-eval-async
`(swank:frame-source-location ,(sldb-frame-number-at-point))
(lexical-let ((policy (slime-compute-policy raw-prefix-arg)))
(lambda (source-location)
(slime-dcase source-location
((:error message)
(message "%s" message)
(ding))
(t
(let ((slime-compilation-policy policy))
(slime-recompile-location source-location))))))))
;;;; Thread control panel
(defvar slime-threads-buffer-name (slime-buffer-name :threads))
(defvar slime-threads-buffer-timer nil)
(defcustom slime-threads-update-interval nil
"Interval at which the list of threads will be updated."
:type '(choice
(number :value 0.5)
(const nil))
:group 'slime-ui)
(defun slime-list-threads ()
"Display a list of threads."
(interactive)
(let ((name slime-threads-buffer-name))
(slime-with-popup-buffer (name :connection t
:mode 'slime-thread-control-mode)
(slime-update-threads-buffer)
(goto-char (point-min))
(when slime-threads-update-interval
(when slime-threads-buffer-timer
(cancel-timer slime-threads-buffer-timer))
(setq slime-threads-buffer-timer
(run-with-timer
slime-threads-update-interval
slime-threads-update-interval
'slime-update-threads-buffer))))))
(defun slime-quit-threads-buffer ()
(when slime-threads-buffer-timer
(cancel-timer slime-threads-buffer-timer))
(quit-window t)
(slime-eval-async `(swank:quit-thread-browser)))
(defun slime-update-threads-buffer ()
(interactive)
(with-current-buffer slime-threads-buffer-name
(slime-eval-async '(swank:list-threads)
'slime-display-threads)))
(defun slime-move-point (position)
"Move point in the current buffer and in the window the buffer is displayed."
(let ((window (get-buffer-window (current-buffer) t)))
(goto-char position)
(when window
(set-window-point window position))))
(defun slime-display-threads (threads)
(with-current-buffer slime-threads-buffer-name
(let* ((inhibit-read-only t)
(old-thread-id (get-text-property (point) 'thread-id))
(old-line (line-number-at-pos))
(old-column (current-column)))
(erase-buffer)
(slime-insert-threads threads)
(let ((new-position (cl-position old-thread-id (cdr threads)
:key #'car :test #'equal)))
(goto-char (point-min))
(forward-line (or new-position (1- old-line)))
(move-to-column old-column)
(slime-move-point (point))))))
(defun slime-transpose-lists (list-of-lists)
(let ((ncols (length (car list-of-lists))))
(cl-loop for col-index below ncols
collect (cl-loop for row in list-of-lists
collect (elt row col-index)))))
(defun slime-insert-table-row (line line-props col-props col-widths)
(slime-propertize-region line-props
(cl-loop for string in line
for col-prop in col-props
for width in col-widths do
(slime-insert-propertized col-prop string)
(insert-char ?\ (- width (length string))))))
(defun slime-insert-table (rows header row-properties column-properties)
"Insert a \"table\" so that the columns are nicely aligned."
(let* ((ncols (length header))
(lines (cons header rows))
(widths (cl-loop for columns in (slime-transpose-lists lines)
collect (1+ (cl-loop for cell in columns
maximize (length cell)))))
(header-line (with-temp-buffer
(slime-insert-table-row
header nil (make-list ncols nil) widths)
(buffer-string))))
(cond ((boundp 'header-line-format)
(setq header-line-format header-line))
(t (insert header-line "\n")))
(cl-loop for line in rows for line-props in row-properties do
(slime-insert-table-row line line-props column-properties widths)
(insert "\n"))))
(defvar slime-threads-table-properties
'(nil (face bold)))
(defun slime-insert-threads (threads)
(let* ((labels (car threads))
(threads (cdr threads))
(header (cl-loop for label in labels collect
(capitalize (substring (symbol-name label) 1))))
(rows (cl-loop for thread in threads collect
(cl-loop for prop in thread collect
(format "%s" prop))))
(line-props (cl-loop for (id) in threads for i from 0
collect `(thread-index ,i thread-id ,id)))
(col-props (cl-loop for nil in labels for i from 0 collect
(nth i slime-threads-table-properties))))
(slime-insert-table rows header line-props col-props)))
;;;;; Major mode
(define-derived-mode slime-thread-control-mode fundamental-mode
"Threads"
"SLIME Thread Control Panel Mode.
\\{slime-thread-control-mode-map}
\\{slime-popup-buffer-mode-map}"
(when slime-truncate-lines
(set (make-local-variable 'truncate-lines) t))
(setq buffer-undo-list t))
(slime-define-keys slime-thread-control-mode-map
("a" 'slime-thread-attach)
("d" 'slime-thread-debug)
("g" 'slime-update-threads-buffer)
("k" 'slime-thread-kill)
("q" 'slime-quit-threads-buffer))
(defun slime-thread-kill ()
(interactive)
(slime-eval `(cl:mapc 'swank:kill-nth-thread
',(slime-get-properties 'thread-index)))
(call-interactively 'slime-update-threads-buffer))
(defun slime-get-region-properties (prop start end)
(cl-loop for position = (if (get-text-property start prop)
start
(next-single-property-change start prop))
then (next-single-property-change position prop)
while (<= position end)
collect (get-text-property position prop)))
(defun slime-get-properties (prop)
(if (use-region-p)
(slime-get-region-properties prop
(region-beginning)
(region-end))
(let ((value (get-text-property (point) prop)))
(when value
(list value)))))
(defun slime-thread-attach ()
(interactive)
(let ((id (get-text-property (point) 'thread-index))
(file (slime-swank-port-file)))
(slime-eval-async `(swank:start-swank-server-in-thread ,id ,file)))
(slime-read-port-and-connect nil))
(defun slime-thread-debug ()
(interactive)
(let ((id (get-text-property (point) 'thread-index)))
(slime-eval-async `(swank:debug-nth-thread ,id))))
;;;;; Connection listing
(define-derived-mode slime-connection-list-mode fundamental-mode
"Slime-Connections"
"SLIME Connection List Mode.
\\{slime-connection-list-mode-map}
\\{slime-popup-buffer-mode-map}"
(when slime-truncate-lines
(set (make-local-variable 'truncate-lines) t)))
(slime-define-keys slime-connection-list-mode-map
("d" 'slime-connection-list-make-default)
("g" 'slime-update-connection-list)
((kbd "C-k") 'slime-quit-connection-at-point)
("R" 'slime-restart-connection-at-point))
(defun slime-connection-at-point ()
(or (get-text-property (point) 'slime-connection)
(error "No connection at point")))
(defun slime-quit-connection-at-point (connection)
(interactive (list (slime-connection-at-point)))
(let ((slime-dispatching-connection connection)
(end (time-add (current-time) (seconds-to-time 3))))
(slime-quit-lisp t)
(while (memq connection slime-net-processes)
(when (time-less-p end (current-time))
(message "Quit timeout expired. Disconnecting.")
(delete-process connection))
(sit-for 0 100)))
(slime-update-connection-list))
(defun slime-restart-connection-at-point (connection)
(interactive (list (slime-connection-at-point)))
(let ((slime-dispatching-connection connection))
(slime-restart-inferior-lisp)))
(defun slime-connection-list-make-default ()
"Make the connection at point the default connection."
(interactive)
(slime-select-connection (slime-connection-at-point))
(slime-update-connection-list))
(defvar slime-connections-buffer-name (slime-buffer-name :connections))
(defun slime-list-connections ()
"Display a list of all connections."
(interactive)
(slime-with-popup-buffer (slime-connections-buffer-name
:mode 'slime-connection-list-mode)
(slime-draw-connection-list)))
(defun slime-update-connection-list ()
"Display a list of all connections."
(interactive)
(let ((pos (point))
(inhibit-read-only t))
(erase-buffer)
(slime-draw-connection-list)
(goto-char pos)))
(defun slime-draw-connection-list ()
(let ((default-pos nil)
(default slime-default-connection)
(fstring "%s%2s %-10s %-17s %-7s %-s\n"))
(insert (format fstring " " "Nr" "Name" "Port" "Pid" "Type")
(format fstring " " "--" "----" "----" "---" "----"))
(dolist (p (reverse slime-net-processes))
(when (eq default p) (setf default-pos (point)))
(slime-insert-propertized
(list 'slime-connection p)
(format fstring
(if (eq default p) "*" " ")
(slime-connection-number p)
(slime-connection-name p)
(or (process-id p) (process-contact p))
(slime-pid p)
(slime-lisp-implementation-type p))))
(when default-pos
(goto-char default-pos))))
;;;; Inspector
(defgroup slime-inspector nil
"Inspector faces."
:prefix "slime-inspector-"
:group 'slime)
(defface slime-inspector-topline-face
'((t ()))
"Face for top line describing object."
:group 'slime-inspector)
(defface slime-inspector-label-face
'((t (:inherit font-lock-constant-face)))
"Face for labels in the inspector."
:group 'slime-inspector)
(defface slime-inspector-value-face
'((t (:inherit font-lock-builtin-face)))
"Face for things which can themselves be inspected."
:group 'slime-inspector)
(defface slime-inspector-action-face
'((t (:inherit font-lock-warning-face)))
"Face for labels of inspector actions."
:group 'slime-inspector)
(defface slime-inspector-type-face
'((t (:inherit font-lock-type-face)))
"Face for type description in inspector."
:group 'slime-inspector)
(defvar slime-inspector-mark-stack '())
(defun slime-inspect (string)
"Eval an expression and inspect the result."
(interactive
(list (slime-read-from-minibuffer "Inspect value (evaluated): "
(slime-sexp-at-point))))
(slime-eval-async `(swank:init-inspector ,string) 'slime-open-inspector))
(define-derived-mode slime-inspector-mode fundamental-mode
"Slime-Inspector"
"
\\{slime-inspector-mode-map}
\\{slime-popup-buffer-mode-map}"
(set-syntax-table lisp-mode-syntax-table)
(slime-set-truncate-lines)
(setq buffer-read-only t))
(defun slime-inspector-buffer ()
(or (get-buffer (slime-buffer-name :inspector))
(slime-with-popup-buffer ((slime-buffer-name :inspector)
:mode 'slime-inspector-mode)
(setq slime-inspector-mark-stack '())
(buffer-disable-undo)
(current-buffer))))
(defmacro slime-inspector-fontify (face string)
`(slime-add-face ',(intern (format "slime-inspector-%s-face" face)) ,string))
(defvar slime-inspector-insert-ispec-function 'slime-inspector-insert-ispec)
(defun slime-open-inspector (inspected-parts &optional point hook)
"Display INSPECTED-PARTS in a new inspector window.
Optionally set point to POINT. If HOOK is provided, it is added to local
KILL-BUFFER hooks for the inspector buffer."
(with-current-buffer (slime-inspector-buffer)
(when hook
(add-hook 'kill-buffer-hook hook t t))
(setq slime-buffer-connection (slime-current-connection))
(let ((inhibit-read-only t))
(erase-buffer)
(pop-to-buffer (current-buffer))
(cl-destructuring-bind (&key id title content) inspected-parts
(cl-macrolet ((fontify (face string)
`(slime-inspector-fontify ,face ,string)))
(slime-propertize-region
(list 'slime-part-number id
'mouse-face 'highlight
'face 'slime-inspector-value-face)
(insert title))
(while (eq (char-before) ?\n)
(backward-delete-char 1))
(insert "\n" (fontify label "--------------------") "\n")
(save-excursion
(slime-inspector-insert-content content))
(when point
(cl-check-type point cons)
(ignore-errors
(goto-char (point-min))
(forward-line (1- (car point)))
(move-to-column (cdr point)))))))))
(defvar slime-inspector-limit 500)
(defun slime-inspector-insert-content (content)
(slime-inspector-fetch-chunk
content nil
(lambda (chunk)
(let ((inhibit-read-only t))
(slime-inspector-insert-chunk chunk t t)))))
(defun slime-inspector-insert-chunk (chunk prev next)
"Insert CHUNK at point.
If PREV resp. NEXT are true insert more-buttons as needed."
(cl-destructuring-bind (ispecs len start end) chunk
(when (and prev (> start 0))
(slime-inspector-insert-more-button start t))
(mapc slime-inspector-insert-ispec-function ispecs)
(when (and next (< end len))
(slime-inspector-insert-more-button end nil))))
(defun slime-inspector-insert-ispec (ispec)
(if (stringp ispec)
(insert ispec)
(slime-dcase ispec
((:value string id)
(slime-propertize-region
(list 'slime-part-number id
'mouse-face 'highlight
'face 'slime-inspector-value-face)
(insert string)))
((:label string)
(insert (slime-inspector-fontify label string)))
((:action string id)
(slime-insert-propertized (list 'slime-action-number id
'mouse-face 'highlight
'face 'slime-inspector-action-face)
string)))))
(defun slime-inspector-position ()
"Return a pair (Y-POSITION X-POSITION) representing the
position of point in the current buffer."
;; We make sure we return absolute coordinates even if the user has
;; narrowed the buffer.
;; FIXME: why would somebody narrow the buffer?
(save-restriction
(widen)
(cons (line-number-at-pos)
(current-column))))
(defun slime-inspector-property-at-point ()
(let* ((properties '(slime-part-number slime-range-button
slime-action-number))
(find-property
(lambda (point)
(cl-loop for property in properties
for value = (get-text-property point property)
when value
return (list property value)))))
(or (funcall find-property (point))
(funcall find-property (1- (point))))))
(defun slime-inspector-operate-on-point ()
"Invoke the command for the text at point.
1. If point is on a value then recursivly call the inspector on
that value.
2. If point is on an action then call that action.
3. If point is on a range-button fetch and insert the range."
(interactive)
(let ((opener (lexical-let ((point (slime-inspector-position)))
(lambda (parts)
(when parts
(slime-open-inspector parts point)))))
(new-opener (lambda (parts)
(when parts
(slime-open-inspector parts)))))
(cl-destructuring-bind (&optional property value)
(slime-inspector-property-at-point)
(cl-case property
(slime-part-number
(slime-eval-async `(swank:inspect-nth-part ,value)
new-opener)
(push (slime-inspector-position) slime-inspector-mark-stack))
(slime-range-button
(slime-inspector-fetch-more value))
(slime-action-number
(slime-eval-async `(swank:inspector-call-nth-action ,value)
opener))
(t (error "No object at point"))))))
(defun slime-inspector-operate-on-click (event)
"Move to events' position and operate the part."
(interactive "@e")
(let ((point (posn-point (event-end event))))
(cond ((and point
(or (get-text-property point 'slime-part-number)
(get-text-property point 'slime-range-button)
(get-text-property point 'slime-action-number)))
(goto-char point)
(slime-inspector-operate-on-point))
(t
(error "No clickable part here")))))
(defun slime-inspector-pop ()
"Reinspect the previous object."
(interactive)
(slime-eval-async
`(swank:inspector-pop)
(lambda (result)
(cond (result
(slime-open-inspector result (pop slime-inspector-mark-stack)))
(t
(message "No previous object")
(ding))))))
(defun slime-inspector-next ()
"Inspect the next object in the history."
(interactive)
(let ((result (slime-eval `(swank:inspector-next))))
(cond (result
(push (slime-inspector-position) slime-inspector-mark-stack)
(slime-open-inspector result))
(t (message "No next object")
(ding)))))
(defun slime-inspector-quit ()
"Quit the inspector and kill the buffer."
(interactive)
(slime-eval-async `(swank:quit-inspector))
(quit-window t))
;; FIXME: first return value is just point.
;; FIXME: could probably use slime-search-property.
(defun slime-find-inspectable-object (direction limit)
"Find the next/previous inspectable object.
DIRECTION can be either 'next or 'prev.
LIMIT is the maximum or minimum position in the current buffer.
Return a list of two values: If an object could be found, the
starting position of the found object and T is returned;
otherwise LIMIT and NIL is returned."
(let ((finder (cl-ecase direction
(next 'next-single-property-change)
(prev 'previous-single-property-change))))
(let ((prop nil) (curpos (point)))
(while (and (not prop) (not (= curpos limit)))
(let ((newpos (funcall finder curpos 'slime-part-number nil limit)))
(setq prop (get-text-property newpos 'slime-part-number))
(setq curpos newpos)))
(list curpos (and prop t)))))
(defun slime-inspector-next-inspectable-object (arg)
"Move point to the next inspectable object.
With optional ARG, move across that many objects.
If ARG is negative, move backwards."
(interactive "p")
(let ((maxpos (point-max)) (minpos (point-min))
(previously-wrapped-p nil))
;; Forward.
(while (> arg 0)
(cl-destructuring-bind (pos foundp)
(slime-find-inspectable-object 'next maxpos)
(if foundp
(progn (goto-char pos) (setq arg (1- arg))
(setq previously-wrapped-p nil))
(if (not previously-wrapped-p) ; cycle detection
(progn (goto-char minpos) (setq previously-wrapped-p t))
(error "No inspectable objects")))))
;; Backward.
(while (< arg 0)
(cl-destructuring-bind (pos foundp)
(slime-find-inspectable-object 'prev minpos)
;; SLIME-OPEN-INSPECTOR inserts the title of an inspector page
;; as a presentation at the beginning of the buffer; skip
;; that. (Notice how this problem can not arise in ``Forward.'')
(if (and foundp (/= pos minpos))
(progn (goto-char pos) (setq arg (1+ arg))
(setq previously-wrapped-p nil))
(if (not previously-wrapped-p) ; cycle detection
(progn (goto-char maxpos) (setq previously-wrapped-p t))
(error "No inspectable objects")))))))
(defun slime-inspector-previous-inspectable-object (arg)
"Move point to the previous inspectable object.
With optional ARG, move across that many objects.
If ARG is negative, move forwards."
(interactive "p")
(slime-inspector-next-inspectable-object (- arg)))
(defun slime-inspector-describe ()
(interactive)
(slime-eval-describe `(swank:describe-inspectee)))
(defun slime-inspector-pprint (part)
(interactive (list (or (get-text-property (point) 'slime-part-number)
(error "No part at point"))))
(slime-eval-describe `(swank:pprint-inspector-part ,part)))
(defun slime-inspector-eval (string)
"Eval an expression in the context of the inspected object.
The `*' variable will be bound to the inspected object."
(interactive (list (slime-read-from-minibuffer "Inspector eval: ")))
(slime-eval-with-transcript `(swank:inspector-eval ,string)))
(defun slime-inspector-history ()
"Show the previously inspected objects."
(interactive)
(slime-eval-describe `(swank:inspector-history)))
(defun slime-inspector-show-source (part)
(interactive (list (or (get-text-property (point) 'slime-part-number)
(error "No part at point"))))
(slime-eval-async
`(swank:find-source-location-for-emacs '(:inspector ,part))
#'slime-show-source-location))
(defun slime-inspector-reinspect ()
(interactive)
(slime-eval-async `(swank:inspector-reinspect)
(lexical-let ((point (slime-inspector-position)))
(lambda (parts)
(slime-open-inspector parts point)))))
(defun slime-inspector-toggle-verbose ()
(interactive)
(slime-eval-async `(swank:inspector-toggle-verbose)
(lexical-let ((point (slime-inspector-position)))
(lambda (parts)
(slime-open-inspector parts point)))))
(defun slime-inspector-insert-more-button (index previous)
(slime-insert-propertized
(list 'slime-range-button (list index previous)
'mouse-face 'highlight
'face 'slime-inspector-action-face)
(if previous " [--more--]\n" " [--more--]")))
(defun slime-inspector-fetch-all ()
"Fetch all inspector contents and go to the end."
(interactive)
(goto-char (1- (point-max)))
(let ((button (get-text-property (point) 'slime-range-button)))
(when button
(let (slime-inspector-limit)
(slime-inspector-fetch-more button)))))
(defun slime-inspector-fetch-more (button)
(cl-destructuring-bind (index prev) button
(slime-inspector-fetch-chunk
(list '() (1+ index) index index) prev
(slime-rcurry
(lambda (chunk prev)
(let ((inhibit-read-only t))
(apply #'delete-region (slime-property-bounds 'slime-range-button))
(slime-inspector-insert-chunk chunk prev (not prev))))
prev))))
(defun slime-inspector-fetch-chunk (chunk prev cont)
(slime-inspector-fetch chunk slime-inspector-limit prev cont))
(defun slime-inspector-fetch (chunk limit prev cont)
(cl-destructuring-bind (from to)
(slime-inspector-next-range chunk limit prev)
(cond ((and from to)
(slime-eval-async
`(swank:inspector-range ,from ,to)
(slime-rcurry (lambda (chunk2 chunk1 limit prev cont)
(slime-inspector-fetch
(slime-inspector-join-chunks chunk1 chunk2)
limit prev cont))
chunk limit prev cont)))
(t (funcall cont chunk)))))
(defun slime-inspector-next-range (chunk limit prev)
(cl-destructuring-bind (_ len start end) chunk
(let ((count (- end start)))
(cond ((and prev (< 0 start) (or (not limit) (< count limit)))
(list (if limit (max (- end limit) 0) 0) start))
((and (not prev) (< end len) (or (not limit) (< count limit)))
(list end (if limit (+ start limit) most-positive-fixnum)))
(t '(nil nil))))))
(defun slime-inspector-join-chunks (chunk1 chunk2)
(cl-destructuring-bind (i1 _l1 s1 e1) chunk1
(cl-destructuring-bind (i2 l2 s2 e2) chunk2
(cond ((= e1 s2)
(list (append i1 i2) l2 s1 e2))
((= e2 s1)
(list (append i2 i1) l2 s2 e1))
(t (error "Invalid chunks"))))))
(set-keymap-parent slime-inspector-mode-map slime-parent-map)
(slime-define-keys slime-inspector-mode-map
([return] 'slime-inspector-operate-on-point)
("\C-m" 'slime-inspector-operate-on-point)
([mouse-1] 'slime-inspector-operate-on-click)
([mouse-2] 'slime-inspector-operate-on-click)
([mouse-6] 'slime-inspector-pop)
([mouse-7] 'slime-inspector-next)
("l" 'slime-inspector-pop)
("n" 'slime-inspector-next)
(" " 'slime-inspector-next)
("d" 'slime-inspector-describe)
("p" 'slime-inspector-pprint)
("e" 'slime-inspector-eval)
("h" 'slime-inspector-history)
("g" 'slime-inspector-reinspect)
("v" 'slime-inspector-toggle-verbose)
("\C-i" 'slime-inspector-next-inspectable-object)
([(shift tab)]
'slime-inspector-previous-inspectable-object) ; Emacs translates S-TAB
([backtab] 'slime-inspector-previous-inspectable-object) ; to BACKTAB on X.
("." 'slime-inspector-show-source)
(">" 'slime-inspector-fetch-all)
("q" 'slime-inspector-quit))
;;;; Buffer selector
(defvar slime-selector-methods nil
"List of buffer-selection methods for the `slime-select' command.
Each element is a list (KEY DESCRIPTION FUNCTION).
DESCRIPTION is a one-line description of what the key selects.")
(defvar slime-selector-other-window nil
"If non-nil use switch-to-buffer-other-window.")
(defun slime-selector (&optional other-window)
"Select a new buffer by type, indicated by a single character.
The user is prompted for a single character indicating the method by
which to choose a new buffer. The `?' character describes the
available methods.
See `def-slime-selector-method' for defining new methods."
(interactive "P")
(message "Select [%s]: "
(apply #'string (mapcar #'car slime-selector-methods)))
(let* ((slime-selector-other-window other-window)
(sequence (save-window-excursion
(select-window (minibuffer-window))
(key-description (read-key-sequence nil))))
(ch (cond ((equal sequence "C-g")
(keyboard-quit))
((equal sequence "TAB")
?i)
((= (length sequence) 1)
(elt sequence 0))
((= (length sequence) 3)
(elt sequence 2))))
(method (cl-find ch slime-selector-methods :key #'car)))
(cond (method
(funcall (cl-third method)))
(t
(message "No method for character: ?\\%c" ch)
(ding)
(sleep-for 1)
(discard-input)
(slime-selector)))))
(defmacro def-slime-selector-method (key description &rest body)
"Define a new `slime-select' buffer selection method.
KEY is the key the user will enter to choose this method.
DESCRIPTION is a one-line sentence describing how the method
selects a buffer.
BODY is a series of forms which are evaluated when the selector
is chosen. The returned buffer is selected with
switch-to-buffer."
(let ((method `(lambda ()
(let ((buffer (progn ,@body)))
(cond ((not (get-buffer buffer))
(message "No such buffer: %S" buffer)
(ding))
((get-buffer-window buffer)
(select-window (get-buffer-window buffer)))
(slime-selector-other-window
(switch-to-buffer-other-window buffer))
(t
(switch-to-buffer buffer)))))))
`(setq slime-selector-methods
(cl-sort (cons (list ,key ,description ,method)
(cl-remove ,key slime-selector-methods :key #'car))
#'< :key #'car))))
(def-slime-selector-method ?? "Selector help buffer."
(ignore-errors (kill-buffer "*Select Help*"))
(with-current-buffer (get-buffer-create "*Select Help*")
(insert "Select Methods:\n\n")
(cl-loop for (key line nil) in slime-selector-methods
do (insert (format "%c:\t%s\n" key line)))
(goto-char (point-min))
(help-mode)
(display-buffer (current-buffer) t))
(slime-selector)
(current-buffer))
(cl-pushnew (list ?4 "Select in other window" (lambda () (slime-selector t)))
slime-selector-methods :key #'car)
(def-slime-selector-method ?q "Abort."
(top-level))
(def-slime-selector-method ?i
"*inferior-lisp* buffer."
(cond ((and (slime-connected-p) (slime-process))
(process-buffer (slime-process)))
(t
"*inferior-lisp*")))
(def-slime-selector-method ?v
"*slime-events* buffer."
slime-event-buffer-name)
(def-slime-selector-method ?l
"most recently visited lisp-mode buffer."
(slime-recently-visited-buffer 'lisp-mode))
(def-slime-selector-method ?d
"*sldb* buffer for the current connection."
(or (sldb-get-default-buffer)
(error "No debugger buffer")))
(def-slime-selector-method ?e
"most recently visited emacs-lisp-mode buffer."
(slime-recently-visited-buffer 'emacs-lisp-mode))
(def-slime-selector-method ?c
"SLIME connections buffer."
(slime-list-connections)
slime-connections-buffer-name)
(def-slime-selector-method ?n
"Cycle to the next Lisp connection."
(slime-next-connection)
(concat "*slime-repl "
(slime-connection-name (slime-current-connection))
"*"))
(def-slime-selector-method ?p
"Cycle to the previous Lisp connection."
(slime-prev-connection)
(concat "*slime-repl "
(slime-connection-name (slime-current-connection))
"*"))
(def-slime-selector-method ?t
"SLIME threads buffer."
(slime-list-threads)
slime-threads-buffer-name)
(defun slime-recently-visited-buffer (mode)
"Return the most recently visited buffer whose major-mode is MODE.
Only considers buffers that are not already visible."
(cl-loop for buffer in (buffer-list)
when (and (with-current-buffer buffer (eq major-mode mode))
(not (string-match "^ " (buffer-name buffer)))
(null (get-buffer-window buffer 'visible)))
return buffer
finally (error "Can't find unshown buffer in %S" mode)))
;;;; Indentation
(defun slime-update-indentation ()
"Update indentation for all macros defined in the Lisp system."
(interactive)
(slime-eval-async '(swank:update-indentation-information)))
(defvar slime-indentation-update-hooks)
(defun slime-intern-indentation-spec (spec)
(cond ((consp spec)
(cons (slime-intern-indentation-spec (car spec))
(slime-intern-indentation-spec (cdr spec))))
((stringp spec)
(intern spec))
(t
spec)))
;; FIXME: restore the old version without per-package
;; stuff. slime-indentation.el should be able tho disable the simple
;; version if needed.
(defun slime-handle-indentation-update (alist)
"Update Lisp indent information.
ALIST is a list of (SYMBOL-NAME . INDENT-SPEC) of proposed indentation
settings for `common-lisp-indent-function'. The appropriate property
is setup, unless the user already set one explicitly."
(dolist (info alist)
(let ((symbol (intern (car info)))
(indent (slime-intern-indentation-spec (cl-second info)))
(packages (cl-third info)))
(if (and (boundp 'common-lisp-system-indentation)
(fboundp 'slime-update-system-indentation))
;; A table provided by slime-cl-indent.el.
(funcall #'slime-update-system-indentation symbol indent packages)
;; Does the symbol have an indentation value that we set?
(when (equal (get symbol 'common-lisp-indent-function)
(get symbol 'slime-indent))
(put symbol 'common-lisp-indent-function indent)
(put symbol 'slime-indent indent)))
(run-hook-with-args 'slime-indentation-update-hooks
symbol indent packages))))
;;;; Contrib modules
(defun slime-require (module)
(cl-pushnew module slime-required-modules)
(when (slime-connected-p)
(slime-load-contribs)))
(defun slime-load-contribs ()
(let ((needed (cl-remove-if (lambda (s)
(member (cl-subseq (symbol-name s) 1)
(mapcar #'downcase
(slime-lisp-modules))))
slime-required-modules)))
(when needed
;; No asynchronous request because with :SPAWN that could result
;; in the attempt to load modules concurrently which may not be
;; supported by the host Lisp.
(setf (slime-lisp-modules)
(slime-eval `(swank:swank-require ',needed))))))
(cl-defstruct slime-contrib
name
slime-dependencies
swank-dependencies
enable
disable
authors
license)
(defun slime-contrib--enable-fun (name)
(intern (concat (symbol-name name) "-init")))
(defun slime-contrib--disable-fun (name)
(intern (concat (symbol-name name) "-unload")))
(defmacro define-slime-contrib (name _docstring &rest clauses)
(declare (indent 1))
(cl-destructuring-bind (&key slime-dependencies
swank-dependencies
on-load
on-unload
authors
license)
(cl-loop for (key . value) in clauses append `(,key ,value))
`(progn
,@(mapcar (lambda (d) `(require ',d)) slime-dependencies)
(defun ,(slime-contrib--enable-fun name) ()
(mapc #'funcall ',(mapcar
#'slime-contrib--enable-fun
slime-dependencies))
(mapc #'slime-require ',swank-dependencies)
,@on-load)
(defun ,(slime-contrib--disable-fun name) ()
,@on-unload
(mapc #'funcall ',(mapcar
#'slime-contrib--disable-fun
slime-dependencies)))
(put 'slime-contribs ',name
(make-slime-contrib
:name ',name :authors ',authors :license ',license
:slime-dependencies ',slime-dependencies
:swank-dependencies ',swank-dependencies
:enable ',(slime-contrib--enable-fun name)
:disable ',(slime-contrib--disable-fun name))))))
(defun slime-all-contribs ()
(cl-loop for (nil val) on (symbol-plist 'slime-contribs) by #'cddr
when (slime-contrib-p val)
collect val))
(defun slime-contrib-all-dependencies (contrib)
"List all contribs recursively needed by CONTRIB, including self."
(cons contrib
(cl-mapcan #'slime-contrib-all-dependencies
(slime-contrib-slime-dependencies
(slime-find-contrib contrib)))))
(defun slime-find-contrib (name)
(get 'slime-contribs name))
(defun slime-read-contrib-name ()
(let ((names (cl-loop for c in (slime-all-contribs) collect
(symbol-name (slime-contrib-name c)))))
(intern (completing-read "Contrib: " names nil t))))
(defun slime-enable-contrib (name)
(interactive (list (slime-read-contrib-name)))
(let ((c (or (slime-find-contrib name)
(error "Unknown contrib: %S" name))))
(funcall (slime-contrib-enable c))))
(defun slime-disable-contrib (name)
(interactive (list (slime-read-contrib-name)))
(let ((c (or (slime-find-contrib name)
(error "Unknown contrib: %S" name))))
(funcall (slime-contrib-disable c))))
;;;;; Pull-down menu
(defvar slime-easy-menu
(let ((C '(slime-connected-p)))
`("SLIME"
[ "Edit Definition..." slime-edit-definition ,C ]
[ "Return From Definition" slime-pop-find-definition-stack ,C ]
[ "Complete Symbol" completion-at-point ,C ]
"--"
("Evaluation"
[ "Eval Defun" slime-eval-defun ,C ]
[ "Eval Last Expression" slime-eval-last-expression ,C ]
[ "Eval And Pretty-Print" slime-pprint-eval-last-expression ,C ]
[ "Eval Region" slime-eval-region ,C ]
[ "Eval Region And Pretty-Print" slime-pprint-eval-region ,C ]
[ "Interactive Eval..." slime-interactive-eval ,C ]
[ "Edit Lisp Value..." slime-edit-value ,C ]
[ "Call Defun" slime-call-defun ,C ])
("Debugging"
[ "Macroexpand Once..." slime-macroexpand-1 ,C ]
[ "Macroexpand All..." slime-macroexpand-all ,C ]
[ "Create Trace Buffer" slime-redirect-trace-output ,C ]
[ "Toggle Trace..." slime-toggle-trace-fdefinition ,C ]
[ "Untrace All" slime-untrace-all ,C]
[ "Disassemble..." slime-disassemble-symbol ,C ]
[ "Inspect..." slime-inspect ,C ])
("Compilation"
[ "Compile Defun" slime-compile-defun ,C ]
[ "Compile/Load File" slime-compile-and-load-file ,C ]
[ "Compile File" slime-compile-file ,C ]
[ "Compile Region" slime-compile-region ,C ]
"--"
[ "Next Note" slime-next-note t ]
[ "Previous Note" slime-previous-note t ]
[ "Remove Notes" slime-remove-notes t ]
[ "List Notes" slime-list-compiler-notes ,C ])
("Cross Reference"
[ "Who Calls..." slime-who-calls ,C ]
[ "Who References... " slime-who-references ,C ]
[ "Who Sets..." slime-who-sets ,C ]
[ "Who Binds..." slime-who-binds ,C ]
[ "Who Macroexpands..." slime-who-macroexpands ,C ]
[ "Who Specializes..." slime-who-specializes ,C ]
[ "List Callers..." slime-list-callers ,C ]
[ "List Callees..." slime-list-callees ,C ]
[ "Next Location" slime-next-location t ])
("Editing"
[ "Check Parens" check-parens t]
[ "Update Indentation" slime-update-indentation ,C]
[ "Select Buffer" slime-selector t])
("Profiling"
[ "Toggle Profiling..." slime-toggle-profile-fdefinition ,C ]
[ "Profile Package" slime-profile-package ,C]
[ "Profile by Substring" slime-profile-by-substring ,C ]
[ "Unprofile All" slime-unprofile-all ,C ]
[ "Show Profiled" slime-profiled-functions ,C ]
"--"
[ "Report" slime-profile-report ,C ]
[ "Reset Counters" slime-profile-reset ,C ])
("Documentation"
[ "Describe Symbol..." slime-describe-symbol ,C ]
[ "Lookup Documentation..." slime-documentation-lookup t ]
[ "Apropos..." slime-apropos ,C ]
[ "Apropos all..." slime-apropos-all ,C ]
[ "Apropos Package..." slime-apropos-package ,C ]
[ "Hyperspec..." slime-hyperspec-lookup t ])
"--"
[ "Interrupt Command" slime-interrupt ,C ]
[ "Abort Async. Command" slime-quit ,C ]
[ "Sync Package & Directory" slime-sync-package-and-default-directory ,C]
)))
(defvar slime-sldb-easy-menu
(let ((C '(slime-connected-p)))
`("SLDB"
[ "Next Frame" sldb-down t ]
[ "Previous Frame" sldb-up t ]
[ "Toggle Frame Details" sldb-toggle-details t ]
[ "Next Frame (Details)" sldb-details-down t ]
[ "Previous Frame (Details)" sldb-details-up t ]
"--"
[ "Eval Expression..." slime-interactive-eval ,C ]
[ "Eval in Frame..." sldb-eval-in-frame ,C ]
[ "Eval in Frame (pretty print)..." sldb-pprint-eval-in-frame ,C ]
[ "Inspect In Frame..." sldb-inspect-in-frame ,C ]
[ "Inspect Condition Object" sldb-inspect-condition ,C ]
"--"
[ "Restart Frame" sldb-restart-frame ,C ]
[ "Return from Frame..." sldb-return-from-frame ,C ]
("Invoke Restart"
[ "Continue" sldb-continue ,C ]
[ "Abort" sldb-abort ,C ]
[ "Step" sldb-step ,C ]
[ "Step next" sldb-next ,C ]
[ "Step out" sldb-out ,C ]
)
"--"
[ "Quit (throw)" sldb-quit ,C ]
[ "Break With Default Debugger" sldb-break-with-default-debugger ,C ])))
(easy-menu-define menubar-slime slime-mode-map "SLIME" slime-easy-menu)
(defun slime-add-easy-menu ()
(easy-menu-add slime-easy-menu 'slime-mode-map))
(add-hook 'slime-mode-hook 'slime-add-easy-menu)
(defun slime-sldb-add-easy-menu ()
(easy-menu-define menubar-slime-sldb
sldb-mode-map "SLDB" slime-sldb-easy-menu)
(easy-menu-add slime-sldb-easy-menu 'sldb-mode-map))
(add-hook 'sldb-mode-hook 'slime-sldb-add-easy-menu)
;;;; Cheat Sheet
(defvar
slime-cheat-sheet-table
'((:title
"Editing lisp code"
:map slime-mode-map
:bindings ((slime-eval-defun "Evaluate current top level form")
(slime-compile-defun "Compile current top level form")
(slime-interactive-eval "Prompt for form and eval it")
(slime-compile-and-load-file "Compile and load current file")
(slime-sync-package-and-default-directory
"Synch default package and directory with current buffer")
(slime-next-note "Next compiler note")
(slime-previous-note "Previous compiler note")
(slime-remove-notes "Remove notes")
slime-documentation-lookup))
(:title "Completion"
:map slime-mode-map
:bindings (slime-indent-and-complete-symbol
slime-fuzzy-complete-symbol))
(:title
"Within SLDB buffers"
:map sldb-mode-map
:bindings ((sldb-default-action "Do 'whatever' with thing at point")
(sldb-toggle-details "Toggle frame details visualization")
(sldb-quit "Quit to REPL")
(sldb-abort "Invoke ABORT restart")
(sldb-continue "Invoke CONTINUE restart (if available)")
(sldb-show-source "Jump to frame's source code")
(sldb-eval-in-frame "Evaluate in frame at point")
(sldb-inspect-in-frame
"Evaluate in frame at point and inspect result")))
(:title
"Within the Inspector"
:map slime-inspector-mode-map
:bindings ((slime-inspector-next-inspectable-object
"Jump to next inspectable object")
(slime-inspector-operate-on-point
"Inspect object or execute action at point")
(slime-inspector-reinspect "Reinspect current object")
(slime-inspector-pop "Return to previous object")
;;(slime-inspector-copy-down "Send object at point to REPL")
(slime-inspector-toggle-verbose "Toggle verbose mode")
(slime-inspector-quit "Quit")))
(:title
"Finding Definitions"
:map slime-mode-map
:bindings (slime-edit-definition
slime-pop-find-definition-stack))))
(defun slime-cheat-sheet ()
(interactive)
(switch-to-buffer-other-frame
(get-buffer-create (slime-buffer-name :cheat-sheet)))
(setq buffer-read-only nil)
(delete-region (point-min) (point-max))
(goto-char (point-min))
(insert
"SLIME: The Superior Lisp Interaction Mode for Emacs (minor-mode).\n\n")
(dolist (mode slime-cheat-sheet-table)
(let ((title (cl-getf mode :title))
(mode-map (cl-getf mode :map))
(mode-keys (cl-getf mode :bindings)))
(insert title)
(insert ":\n")
(insert (make-string (1+ (length title)) ?-))
(insert "\n")
(let ((keys '())
(descriptions '()))
(dolist (func mode-keys)
;; func is eithor the function name or a list (NAME DESCRIPTION)
(push (if (symbolp func)
(prin1-to-string func)
(cl-second func))
descriptions)
(let ((all-bindings (where-is-internal (if (symbolp func)
func
(cl-first func))
(symbol-value mode-map)))
(key-bindings '()))
(dolist (binding all-bindings)
(when (and (vectorp binding)
(integerp (aref binding 0)))
(push binding key-bindings)))
(push (mapconcat 'key-description key-bindings " or ") keys)))
(cl-loop with desc-length = (apply 'max (mapcar 'length descriptions))
for key in (nreverse keys)
for desc in (nreverse descriptions)
do (insert desc)
do (insert (make-string (- desc-length (length desc)) ? ))
do (insert " => ")
do (insert (if (string= "" key)
"<not on any key>"
key))
do (insert "\n")
finally do (insert "\n")))))
(setq buffer-read-only t)
(goto-char (point-min)))
;;;; Utilities (no not Paul Graham style)
;; XXX: unused function
(defun slime-intersperse (element list)
"Intersperse ELEMENT between each element of LIST."
(if (null list)
'()
(cons (car list)
(cl-mapcan (lambda (x) (list element x)) (cdr list)))))
;;; FIXME: this looks almost slime `slime-alistify', perhaps the two
;;; functions can be merged.
(defun slime-group-similar (similar-p list)
"Return the list of lists of 'similar' adjacent elements of LIST.
The function SIMILAR-P is used to test for similarity.
The order of the input list is preserved."
(if (null list)
nil
(let ((accumulator (list (list (car list)))))
(dolist (x (cdr list))
(if (funcall similar-p x (caar accumulator))
(push x (car accumulator))
(push (list x) accumulator)))
(reverse (mapcar #'reverse accumulator)))))
(defun slime-alistify (list key test)
"Partition the elements of LIST into an alist.
KEY extracts the key from an element and TEST is used to compare
keys."
(let ((alist '()))
(dolist (e list)
(let* ((k (funcall key e))
(probe (cl-assoc k alist :test test)))
(if probe
(push e (cdr probe))
(push (cons k (list e)) alist))))
;; Put them back in order.
(cl-loop for (key . value) in (reverse alist)
collect (cons key (reverse value)))))
;;;;; Misc.
(defun slime-length= (seq n)
"Return (= (length SEQ) N)."
(cl-etypecase seq
(list
(cond ((zerop n) (null seq))
((let ((tail (nthcdr (1- n) seq)))
(and tail (null (cdr tail)))))))
(sequence
(= (length seq) n))))
(defun slime-length> (seq n)
"Return (> (length SEQ) N)."
(cl-etypecase seq
(list (nthcdr n seq))
(sequence (> (length seq) n))))
(defun slime-trim-whitespace (str)
(let ((start (cl-position-if-not (lambda (x)
(memq x '(?\t ?\n ?\s ?\r)))
str))
(end (cl-position-if-not (lambda (x)
(memq x '(?\t ?\n ?\s ?\r)))
str
:from-end t)))
(if start
(substring str start (1+ end))
"")))
;;;;; Buffer related
(defun slime-buffer-narrowed-p (&optional buffer)
"Returns T if BUFFER (or the current buffer respectively) is narrowed."
(with-current-buffer (or buffer (current-buffer))
(let ((beg (point-min))
(end (point-max))
(total (buffer-size)))
(or (/= beg 1) (/= end (1+ total))))))
(defun slime-column-max ()
(save-excursion
(goto-char (point-min))
(cl-loop for column = (prog2 (end-of-line) (current-column) (forward-line))
until (= (point) (point-max))
maximizing column)))
;;;;; CL symbols vs. Elisp symbols.
(defun slime-cl-symbol-name (symbol)
(let ((n (if (stringp symbol) symbol (symbol-name symbol))))
(if (string-match ":\\([^:]*\\)$" n)
(let ((symbol-part (match-string 1 n)))
(if (string-match "^|\\(.*\\)|$" symbol-part)
(match-string 1 symbol-part)
symbol-part))
n)))
(defun slime-cl-symbol-package (symbol &optional default)
(let ((n (if (stringp symbol) symbol (symbol-name symbol))))
(if (string-match "^\\([^:]*\\):" n)
(match-string 1 n)
default)))
(defun slime-qualify-cl-symbol-name (symbol-or-name)
"Return a package-qualified string for SYMBOL-OR-NAME.
If SYMBOL-OR-NAME doesn't already have a package prefix the
current package is used."
(let ((s (if (stringp symbol-or-name)
symbol-or-name
(symbol-name symbol-or-name))))
(if (slime-cl-symbol-package s)
s
(format "%s::%s"
(let* ((package (slime-current-package)))
;; package is a string like ":cl-user"
;; or "CL-USER", or "\"CL-USER\"".
(if package
(slime-pretty-package-name package)
"CL-USER"))
(slime-cl-symbol-name s)))))
;;;;; Moving, CL idiosyncracies aware (reader conditionals &c.)
(defmacro slime-point-moves-p (&rest body)
"Execute BODY and return true if the current buffer's point moved."
(declare (indent 0))
(let ((pointvar (cl-gensym "point-")))
`(let ((,pointvar (point)))
(save-current-buffer ,@body)
(/= ,pointvar (point)))))
(defun slime-forward-sexp (&optional count)
"Like `forward-sexp', but understands reader-conditionals (#- and #+),
and skips comments."
(dotimes (_i (or count 1))
(slime-forward-cruft)
(forward-sexp)))
(defconst slime-reader-conditionals-regexp
;; #!+, #!- are SBCL specific reader-conditional syntax.
;; We need this for the source files of SBCL itself.
(regexp-opt '("#+" "#-" "#!+" "#!-")))
(defun slime-forward-reader-conditional ()
"Move past any reader conditional (#+ or #-) at point."
(when (looking-at slime-reader-conditionals-regexp)
(goto-char (match-end 0))
(let* ((plus-conditional-p (eq (char-before) ?+))
(result (slime-eval-feature-expression
(condition-case e
(read (current-buffer))
(invalid-read-syntax
(signal 'slime-unknown-feature-expression (cdr e)))))))
(unless (if plus-conditional-p result (not result))
;; skip this sexp
(slime-forward-sexp)))))
(defun slime-forward-cruft ()
"Move forward over whitespace, comments, reader conditionals."
(while (slime-point-moves-p (skip-chars-forward " \t\n")
(forward-comment (buffer-size))
(inline (slime-forward-reader-conditional)))))
(defun slime-keywordify (symbol)
"Make a keyword out of the symbol SYMBOL."
(let ((name (downcase (symbol-name symbol))))
(intern (if (eq ?: (aref name 0))
name
(concat ":" name)))))
(put 'slime-incorrect-feature-expression
'error-conditions '(slime-incorrect-feature-expression error))
(put 'slime-unknown-feature-expression
'error-conditions '(slime-unknown-feature-expression
slime-incorrect-feature-expression
error))
;; FIXME: let it crash
;; FIXME: the length=1 constraint is bogus
(defun slime-eval-feature-expression (e)
"Interpret a reader conditional expression."
(cond ((symbolp e)
(memq (slime-keywordify e) (slime-lisp-features)))
((and (consp e) (symbolp (car e)))
(funcall (let ((head (slime-keywordify (car e))))
(cl-case head
(:and #'cl-every)
(:or #'cl-some)
(:not
(lexical-let ((feature-expression e))
(lambda (f l)
(cond
((slime-length= l 0) t)
((slime-length= l 1) (not (apply f l)))
(t (signal 'slime-incorrect-feature-expression
feature-expression))))))
(t (signal 'slime-unknown-feature-expression head))))
#'slime-eval-feature-expression
(cdr e)))
(t (signal 'slime-incorrect-feature-expression e))))
;;;;; Extracting Lisp forms from the buffer or user
(defun slime-defun-at-point ()
"Return the text of the defun at point."
(apply #'buffer-substring-no-properties
(slime-region-for-defun-at-point)))
(defun slime-region-for-defun-at-point ()
"Return the start and end position of defun at point."
(save-excursion
(save-match-data
(end-of-defun)
(let ((end (point)))
(beginning-of-defun)
(list (point) end)))))
(defun slime-beginning-of-symbol ()
"Move to the beginning of the CL-style symbol at point."
(while (re-search-backward "\\(\\sw\\|\\s_\\|\\s\\.\\|\\s\\\\|[#@|]\\)\\="
(when (> (point) 2000) (- (point) 2000))
t))
(re-search-forward "\\=#[-+.<|]" nil t)
(when (and (looking-at "@") (eq (char-before) ?\,))
(forward-char)))
(defun slime-end-of-symbol ()
"Move to the end of the CL-style symbol at point."
(re-search-forward "\\=\\(\\sw\\|\\s_\\|\\s\\.\\|#:\\|[@|]\\)*"))
(put 'slime-symbol 'end-op 'slime-end-of-symbol)
(put 'slime-symbol 'beginning-op 'slime-beginning-of-symbol)
(defun slime-symbol-start-pos ()
"Return the starting position of the symbol under point.
The result is unspecified if there isn't a symbol under the point."
(save-excursion (slime-beginning-of-symbol) (point)))
(defun slime-symbol-end-pos ()
(save-excursion (slime-end-of-symbol) (point)))
(defun slime-bounds-of-symbol-at-point ()
"Return the bounds of the symbol around point.
The returned bounds are either nil or non-empty."
(let ((bounds (bounds-of-thing-at-point 'slime-symbol)))
(if (and bounds
(< (car bounds)
(cdr bounds)))
bounds)))
(defun slime-symbol-at-point ()
"Return the name of the symbol at point, otherwise nil."
;; (thing-at-point 'symbol) returns "" in empty buffers
(let ((bounds (slime-bounds-of-symbol-at-point)))
(if bounds
(buffer-substring-no-properties (car bounds)
(cdr bounds)))))
(defun slime-bounds-of-sexp-at-point ()
"Return the bounds sexp at point as a pair (or nil)."
(or (slime-bounds-of-symbol-at-point)
(and (equal (char-after) ?\()
(member (char-before) '(?\' ?\, ?\@))
;; hide stuff before ( to avoid quirks with '( etc.
(save-restriction
(narrow-to-region (point) (point-max))
(bounds-of-thing-at-point 'sexp)))
(bounds-of-thing-at-point 'sexp)))
(defun slime-sexp-at-point ()
"Return the sexp at point as a string, otherwise nil."
(let ((bounds (slime-bounds-of-sexp-at-point)))
(if bounds
(buffer-substring-no-properties (car bounds)
(cdr bounds)))))
(defun slime-sexp-at-point-or-error ()
"Return the sexp at point as a string, othwise signal an error."
(or (slime-sexp-at-point) (user-error "No expression at point")))
(defun slime-string-at-point ()
"Returns the string at point as a string, otherwise nil."
(let ((sexp (slime-sexp-at-point)))
(if (and sexp
(eql (char-syntax (aref sexp 0)) ?\"))
sexp
nil)))
(defun slime-string-at-point-or-error ()
"Return the sexp at point as a string, othwise signal an error."
(or (slime-string-at-point) (error "No string at point.")))
(defun slime-input-complete-p (start end)
"Return t if the region from START to END contains a complete sexp."
(save-excursion
(goto-char start)
(cond ((looking-at "\\s *['`#]?[(\"]")
(ignore-errors
(save-restriction
(narrow-to-region start end)
;; Keep stepping over blanks and sexps until the end of
;; buffer is reached or an error occurs. Tolerate extra
;; close parens.
(cl-loop do (skip-chars-forward " \t\r\n)")
until (eobp)
do (forward-sexp))
t)))
(t t))))
;;;; slime.el in pretty colors
(cl-loop for sym in (list 'slime-def-connection-var
'slime-define-channel-type
'slime-define-channel-method
'define-slime-contrib
'slime-defun-if-undefined
'slime-defmacro-if-undefined)
for regexp = (format "(\\(%S\\)\\s +\\(\\(\\w\\|\\s_\\)+\\)"
sym)
do (font-lock-add-keywords
'emacs-lisp-mode
`((,regexp (1 font-lock-keyword-face)
(2 font-lock-variable-name-face)))))
;;;; target manipulation (used by slime-presentations, slime-media,
;;;; slime-repl and slime-buffer-streams, at
;;;; least)
(defvar slime-output-target-to-marker
(make-hash-table)
"Map from TARGET ids to Emacs markers.
The markers indicate where output should be inserted.")
(defun slime-output-target-marker (target)
"Return the marker where output for TARGET should be inserted."
(gethash target slime-output-target-to-marker))
(defun slime-emit-to-target (string target)
"Insert STRING at target TARGET.
See `slime-output-target-to-marker'."
(let* ((marker (slime-output-target-marker target))
(buffer (and marker (marker-buffer marker))))
(when buffer
(with-current-buffer buffer
(save-excursion
;; Insert STRING at MARKER, then move MARKER behind
;; the insertion.
(goto-char marker)
(insert-before-markers string)
(set-marker marker (point)))))))
;;;; Finishing up
(eval-when-compile
(require 'bytecomp))
(defun slime--byte-compile (symbol)
(require 'bytecomp) ;; tricky interaction between autoload and let.
(let ((byte-compile-warnings '()))
(byte-compile symbol)))
(defun slime--compile-hotspots ()
(mapc (lambda (sym)
(cond ((fboundp sym)
(unless (byte-code-function-p (symbol-function sym))
(slime--byte-compile sym)))
(t (error "%S is not fbound" sym))))
'(slime-alistify
slime-log-event
slime-events-buffer
slime-process-available-input
slime-dispatch-event
slime-net-filter
slime-net-have-input-p
slime-net-decode-length
slime-net-read
slime-print-apropos
slime-insert-propertized
slime-beginning-of-symbol
slime-end-of-symbol
slime-eval-feature-expression
slime-forward-sexp
slime-forward-cruft
slime-forward-reader-conditional)))
(slime--compile-hotspots)
(add-to-list 'load-path (expand-file-name "contrib" slime-path))
(run-hooks 'slime-load-hook)
(provide 'slime)
(when (member 'lisp-mode slime-lisp-modes)
(add-hook 'lisp-mode-hook 'slime-lisp-mode-hook))
;; Local Variables:
;; outline-regexp: ";;;;+"
;; indent-tabs-mode: nil
;; coding: latin-1-unix
;; End:
;;; slime.el ends here