New flag to automatically start REPLs when geiser-mode is activated
[geiser.git] / elisp / geiser-repl.el
blob1d1b3173ea95375a3731b1e7a26625e10a5cc328
1 ;;; geiser-repl.el --- Geiser's REPL
3 ;; Copyright (C) 2009, 2010, 2011, 2012, 2013 Jose Antonio Ortega Ruiz
5 ;; This program is free software; you can redistribute it and/or
6 ;; modify it under the terms of the Modified BSD License. You should
7 ;; have received a copy of the license along with this program. If
8 ;; not, see <http://www.xfree86.org/3.3.6/COPYRIGHT2.html#5>.
12 (require 'geiser-company)
13 (require 'geiser-compile)
14 (require 'geiser-doc)
15 (require 'geiser-autodoc)
16 (require 'geiser-edit)
17 (require 'geiser-completion)
18 (require 'geiser-syntax)
19 (require 'geiser-impl)
20 (require 'geiser-eval)
21 (require 'geiser-connection)
22 (require 'geiser-menu)
23 (require 'geiser-image)
24 (require 'geiser-custom)
25 (require 'geiser-base)
27 (require 'comint)
28 (require 'compile)
29 (require 'scheme)
32 ;;; Customization:
34 (defgroup geiser-repl nil
35 "Interacting with the Geiser REPL."
36 :group 'geiser)
38 (geiser-custom--defcustom geiser-repl-use-other-window t
39 "Whether to Use a window other than the current buffer's when
40 switching to the Geiser REPL buffer."
41 :type 'boolean
42 :group 'geiser-repl)
44 (geiser-custom--defcustom geiser-repl-window-allow-split t
45 "Whether to allow window splitting when switching to the Geiser
46 REPL buffer."
47 :type 'boolean
48 :group 'geiser-repl)
50 (geiser-custom--defcustom geiser-repl-history-filename
51 (expand-file-name "~/.geiser_history")
52 "File where REPL input history is saved, so that it persists between sessions.
54 This is actually the base name: the concrete Scheme
55 implementation name gets appended to it."
56 :type 'filename
57 :group 'geiser-repl)
59 (geiser-custom--defcustom geiser-repl-history-size comint-input-ring-size
60 "Maximum size of the saved REPL input history."
61 :type 'integer
62 :group 'geiser-repl)
64 (geiser-custom--defcustom geiser-repl-history-no-dups-p t
65 "Whether to skip duplicates when recording history."
66 :type 'boolean
67 :group 'geiser-repl)
69 (geiser-custom--defcustom geiser-repl-save-debugging-history-p nil
70 "Whether to skip debugging input in REPL history.
72 By default, REPL interactions while scheme is in the debugger are
73 not added to the REPL command history. Set this variable to t to
74 change that."
75 :type 'boolean
76 :group 'geiser-repl)
78 (geiser-custom--defcustom geiser-repl-autodoc-p t
79 "Whether to enable `geiser-autodoc-mode' in the REPL by default."
80 :type 'boolean
81 :group 'geiser-repl)
83 (geiser-custom--defcustom geiser-repl-company-p t
84 "Whether to use company-mode for completion, if available."
85 :group 'geiser-mode
86 :type 'boolean)
88 (geiser-custom--defcustom geiser-repl-read-only-prompt-p t
89 "Whether the REPL's prompt should be read-only."
90 :type 'boolean
91 :group 'geiser-repl)
93 (geiser-custom--defcustom geiser-repl-auto-indent-p t
94 "Whether newlines for incomplete sexps are autoindented."
95 :type 'boolean
96 :group 'geiser-repl)
98 (geiser-custom--defcustom geiser-repl-forget-old-errors-p t
99 "Whether to forget old errors upon entering a new expression.
101 When on (the default), every time a new expression is entered in
102 the REPL old error messages are flushed, and using \\[next-error]
103 afterwards will jump only to error locations produced by the new
104 expression, if any."
105 :type 'boolean
106 :group 'geiser-repl)
108 (geiser-custom--defcustom geiser-repl-query-on-exit-p nil
109 "Whether to prompt for confirmation on \\[geiser-repl-exit]."
110 :type 'boolean
111 :group 'geiser-repl)
113 (geiser-custom--defcustom geiser-repl-query-on-kill-p t
114 "Whether to prompt for confirmation when killing a REPL buffer with
115 a life process."
116 :type 'boolean
117 :group 'geiser-repl)
119 (geiser-custom--defcustom geiser-repl-default-host "localhost"
120 "Default host when connecting to remote REPLs."
121 :type 'string
122 :group 'geiser-repl)
124 (geiser-custom--defcustom geiser-repl-default-port 37146
125 "Default port for connecting to remote REPLs."
126 :type 'integer
127 :group 'geiser-repl)
129 (geiser-custom--defcustom geiser-repl-startup-time 10000
130 "Time, in milliseconds, to wait for Racket to startup.
131 If you have a slow system, try to increase this time."
132 :type 'integer
133 :group 'geiser-repl)
135 (geiser-custom--defcustom geiser-repl-inline-images-p t
136 "Whether to display inline images in the REPL."
137 :type 'boolean
138 :group 'geiser-repl)
140 (geiser-custom--defcustom geiser-repl-auto-display-images-p t
141 "Whether to automatically invoke the external viewer to display
142 images popping up in the REPL.
144 See also `geiser-debug-auto-display-images-p'."
145 :type 'boolean
146 :group 'geiser-repl)
148 (geiser-custom--defface repl-input
149 'comint-highlight-input geiser-repl "evaluated input highlighting")
151 (geiser-custom--defface repl-prompt
152 'comint-highlight-prompt geiser-repl "REPL prompt")
156 ;;; Implementation-dependent parameters
158 (geiser-impl--define-caller geiser-repl--binary binary ()
159 "A variable or function returning the path to the scheme binary
160 for this implementation.")
162 (geiser-impl--define-caller geiser-repl--arglist arglist ()
163 "A function taking no arguments and returning a list of
164 arguments to be used when invoking the scheme binary.")
166 (geiser-impl--define-caller geiser-repl--prompt-regexp prompt-regexp ()
167 "A variable (or thunk returning a value) giving the regular
168 expression for this implementation's geiser scheme prompt.")
170 (geiser-impl--define-caller
171 geiser-repl--debugger-prompt-regexp debugger-prompt-regexp ()
172 "A variable (or thunk returning a value) giving the regular
173 expression for this implementation's debugging prompt.")
175 (geiser-impl--define-caller geiser-repl--startup repl-startup (remote)
176 "Function taking no parameters that is called after the REPL
177 has been initialised. All Geiser functionality is available to
178 you at that point.")
180 (geiser-impl--define-caller geiser-repl--enter-cmd enter-command (module)
181 "Function taking a module designator and returning a REPL enter
182 module command as a string")
184 (geiser-impl--define-caller geiser-repl--import-cmd import-command (module)
185 "Function taking a module designator and returning a REPL import
186 module command as a string")
188 (geiser-impl--define-caller geiser-repl--exit-cmd exit-command ()
189 "Function returning the REPL exit command as a string")
192 ;;; Geiser REPL buffers and processes:
194 (defvar geiser-repl--repls nil)
195 (defvar geiser-repl--closed-repls nil)
197 (make-variable-buffer-local
198 (defvar geiser-repl--repl nil))
200 (defsubst geiser-repl--set-this-buffer-repl (r)
201 (setq geiser-repl--repl r))
203 (defun geiser-repl--live-p ()
204 (and geiser-repl--repl
205 (get-buffer-process geiser-repl--repl)))
207 (defun geiser-repl--repl/impl (impl &optional repls)
208 (catch 'repl
209 (dolist (repl (or repls geiser-repl--repls))
210 (when (buffer-live-p repl)
211 (with-current-buffer repl
212 (when (eq geiser-impl--implementation impl)
213 (throw 'repl repl)))))))
215 (defun geiser-repl--set-up-repl (impl)
216 (or (and (not impl) geiser-repl--repl)
217 (setq geiser-repl--repl
218 (let ((impl (or impl
219 geiser-impl--implementation
220 (geiser-impl--guess))))
221 (when impl (geiser-repl--repl/impl impl))))))
223 (defun geiser-repl--active-impls ()
224 (let ((act))
225 (dolist (repl geiser-repl--repls act)
226 (with-current-buffer repl
227 (add-to-list 'act geiser-impl--implementation)))))
229 (defsubst geiser-repl--repl-name (impl)
230 (format "%s REPL" (geiser-impl--impl-str impl)))
232 (defsubst geiser-repl--buffer-name (impl)
233 (format "* %s *" (geiser-repl--repl-name impl)))
235 (defun geiser-repl--switch-to-buffer (buffer)
236 (unless (eq buffer (current-buffer))
237 (let ((pop-up-windows geiser-repl-window-allow-split))
238 (if geiser-repl-use-other-window
239 (switch-to-buffer-other-window buffer)
240 (switch-to-buffer buffer)))))
242 (defun geiser-repl--to-repl-buffer (impl)
243 (unless (and (eq major-mode 'geiser-repl-mode)
244 (eq geiser-impl--implementation impl)
245 (not (get-buffer-process (current-buffer))))
246 (let* ((old (geiser-repl--repl/impl impl geiser-repl--closed-repls))
247 (old (and (buffer-live-p old)
248 (not (get-buffer-process old))
249 old)))
250 (geiser-repl--switch-to-buffer
251 (or old (generate-new-buffer (geiser-repl--buffer-name impl))))
252 (unless old
253 (geiser-repl-mode)
254 (geiser-impl--set-buffer-implementation impl)))))
256 (defun geiser-repl--read-impl (prompt &optional active)
257 (geiser-impl--read-impl prompt (and active (geiser-repl--active-impls))))
259 (defsubst geiser-repl--only-impl-p ()
260 (and (null (cdr geiser-active-implementations))
261 (car geiser-active-implementations)))
263 (defun geiser-repl--get-impl (prompt)
264 (or (geiser-repl--only-impl-p)
265 (and (eq major-mode 'geiser-repl-mode) geiser-impl--implementation)
266 (geiser-repl--read-impl prompt)))
269 ;;; REPL connections
271 (make-variable-buffer-local
272 (defvar geiser-repl--address nil))
274 (make-variable-buffer-local
275 (defvar geiser-repl--connection nil))
277 (defun geiser-repl--remote-p () geiser-repl--address)
279 (defsubst geiser-repl--host () (car geiser-repl--address))
280 (defsubst geiser-repl--port () (cdr geiser-repl--address))
282 (defun geiser-repl--read-address (&optional host port)
283 (let ((defhost (or (geiser-repl--host) geiser-repl-default-host))
284 (defport (or (geiser-repl--port) geiser-repl-default-port)))
285 (cons (or host
286 (read-string (format "Host (default %s): " defhost)
287 nil nil defhost))
288 (or port (read-number "Port: " defport)))))
290 (defun geiser-repl--autodoc-mode (n)
291 (when (or geiser-repl-autodoc-p (< n 0))
292 (geiser--save-msg (geiser-autodoc-mode n))))
294 (defun geiser-repl--save-remote-data (address)
295 (setq geiser-repl--address address)
296 (setq header-line-format (and address
297 (format "Host: %s Port: %s"
298 (geiser-repl--host)
299 (geiser-repl--port)))))
301 (defun geiser-repl--output-filter (txt)
302 (geiser-con--connection-update-debugging geiser-repl--connection txt)
303 (geiser-image--replace-images geiser-repl-inline-images-p
304 geiser-repl-auto-display-images-p)
305 (when (string-match-p (geiser-con--connection-prompt geiser-repl--connection)
306 txt)
307 (geiser-autodoc--disinhibit-autodoc)))
309 (defun geiser-repl--start-repl (impl address)
310 (message "Starting Geiser REPL for %s ..." impl)
311 (geiser-repl--to-repl-buffer impl)
312 (sit-for 0)
313 (goto-char (point-max))
314 (geiser-repl--autodoc-mode -1)
315 (let* ((prompt-rx (geiser-repl--prompt-regexp impl))
316 (deb-prompt-rx (geiser-repl--debugger-prompt-regexp impl))
317 (prompt (geiser-con--combined-prompt prompt-rx deb-prompt-rx)))
318 (unless prompt-rx
319 (error "Sorry, I don't know how to start a REPL for %s" impl))
320 (geiser-repl--save-remote-data address)
321 (geiser-repl--start-scheme impl address prompt)
322 (geiser-repl--quit-setup)
323 (geiser-repl--history-setup)
324 (add-to-list 'geiser-repl--repls (current-buffer))
325 (geiser-repl--set-this-buffer-repl (current-buffer))
326 (setq geiser-repl--connection
327 (geiser-con--make-connection (get-buffer-process (current-buffer))
328 prompt-rx
329 deb-prompt-rx))
330 (geiser-repl--startup impl address)
331 (geiser-repl--autodoc-mode 1)
332 (geiser-company--setup geiser-repl-company-p)
333 (add-hook 'comint-output-filter-functions
334 'geiser-repl--output-filter
337 (set-process-query-on-exit-flag (get-buffer-process (current-buffer))
338 geiser-repl-query-on-kill-p)
339 (message "%s up and running!" (geiser-repl--repl-name impl))))
341 (defun geiser-repl--start-scheme (impl address prompt)
342 (setq comint-prompt-regexp prompt)
343 (let* ((name (geiser-repl--repl-name impl))
344 (buff (current-buffer))
345 (args (if address (list address)
346 `(,(geiser-repl--binary impl)
348 ,@(geiser-repl--arglist impl)))))
349 (condition-case err
350 (apply 'make-comint-in-buffer `(,name ,buff ,@args))
351 (error (insert "Unable to start REPL:\n"
352 (error-message-string err)
353 "\n")
354 (error "Couldn't start Geiser")))
355 (geiser-repl--wait-for-prompt geiser-repl-startup-time)))
357 (defun geiser-repl--wait-for-prompt (timeout)
358 (let ((p (point)) (seen) (buffer (current-buffer)))
359 (while (and (not seen)
360 (> timeout 0)
361 (get-buffer-process buffer))
362 (sleep-for 0.1)
363 (setq timeout (- timeout 100))
364 (goto-char p)
365 (setq seen (re-search-forward comint-prompt-regexp nil t)))
366 (goto-char (point-max))
367 (unless seen (error "%s" "No prompt found!"))))
369 (defun geiser-repl--is-debugging ()
370 (let ((dp (geiser-con--connection-debug-prompt geiser-repl--connection)))
371 (and dp
372 comint-last-prompt-overlay
373 (save-excursion
374 (goto-char (overlay-start comint-last-prompt-overlay))
375 (re-search-forward dp
376 (overlay-end comint-last-prompt-overlay)
377 t)))))
379 (defun geiser-repl--connection* ()
380 (let ((buffer (geiser-repl--set-up-repl geiser-impl--implementation)))
381 (and (buffer-live-p buffer)
382 (get-buffer-process buffer)
383 (with-current-buffer buffer geiser-repl--connection))))
385 (defun geiser-repl--connection ()
386 (or (geiser-repl--connection*)
387 (error "No Geiser REPL for this buffer (try M-x run-geiser)")))
389 (setq geiser-eval--default-connection-function 'geiser-repl--connection)
391 (defun geiser-repl--prepare-send ()
392 (geiser-autodoc--inhibit-autodoc)
393 (geiser-con--connection-deactivate geiser-repl--connection))
395 (defun geiser-repl--send (cmd)
396 (when (and cmd (eq major-mode 'geiser-repl-mode))
397 (geiser-repl--prepare-send)
398 (goto-char (point-max))
399 (comint-kill-input)
400 (insert cmd)
401 (let ((comint-input-filter (lambda (x) nil)))
402 (comint-send-input nil t))))
405 ;;; REPL history
407 (defconst geiser-repl--history-separator "\n\0\n")
409 (defsubst geiser-repl--history-file ()
410 (format "%s.%s" geiser-repl-history-filename geiser-impl--implementation))
412 (defun geiser-repl--read-input-ring ()
413 (let ((comint-input-ring-file-name (geiser-repl--history-file))
414 (comint-input-ring-separator geiser-repl--history-separator))
415 (comint-read-input-ring t)))
417 (defun geiser-repl--write-input-ring ()
418 (let ((comint-input-ring-file-name (geiser-repl--history-file))
419 (comint-input-ring-separator geiser-repl--history-separator))
420 (comint-write-input-ring)))
422 (defun geiser-repl--history-setup ()
423 (set (make-local-variable 'comint-input-ring-size) geiser-repl-history-size)
424 (set (make-local-variable 'comint-input-filter) 'geiser-repl--input-filter)
425 (geiser-repl--read-input-ring))
428 ;;; Cleaning up
430 (defun geiser-repl--on-quit ()
431 (geiser-repl--write-input-ring)
432 (let ((cb (current-buffer))
433 (impl geiser-impl--implementation)
434 (comint-prompt-read-only nil))
435 (geiser-con--connection-deactivate geiser-repl--connection t)
436 (geiser-con--connection-close geiser-repl--connection)
437 (setq geiser-repl--repls (remove cb geiser-repl--repls))
438 (dolist (buffer (buffer-list))
439 (when (buffer-live-p buffer)
440 (with-current-buffer buffer
441 (when (and (eq geiser-impl--implementation impl)
442 (equal cb geiser-repl--repl))
443 (geiser-repl--set-up-repl geiser-impl--implementation)))))))
445 (defun geiser-repl--sentinel (proc event)
446 (let ((pb (process-buffer proc)))
447 (when (buffer-live-p pb)
448 (with-current-buffer pb
449 (let ((comint-prompt-read-only nil)
450 (comint-input-ring-file-name (geiser-repl--history-file))
451 (comint-input-ring-separator geiser-repl--history-separator))
452 (geiser-repl--on-quit)
453 (push pb geiser-repl--closed-repls)
454 (goto-char (point-max))
455 (comint-kill-region comint-last-input-start (point))
456 (insert "\nIt's been nice interacting with you!\n")
457 (insert "Press C-c C-z to bring me back.\n" ))))))
459 (defun geiser-repl--on-kill ()
460 (geiser-repl--on-quit)
461 (setq geiser-repl--closed-repls
462 (remove (current-buffer) geiser-repl--closed-repls)))
464 (defun geiser-repl--input-filter (str)
465 (not (or (and (not geiser-repl-save-debugging-history-p)
466 (geiser-repl--is-debugging))
467 (string-match "^\\s *$" str)
468 (string-match "^,quit *$" str))))
470 (defun geiser-repl--old-input ()
471 (save-excursion
472 (let ((end (point)))
473 (backward-sexp)
474 (buffer-substring (point) end))))
476 (defun geiser-repl--quit-setup ()
477 (add-hook 'kill-buffer-hook 'geiser-repl--on-kill nil t)
478 (set-process-sentinel (get-buffer-process (current-buffer))
479 'geiser-repl--sentinel))
482 ;;; geiser-repl mode:
484 (defun geiser-repl--bol ()
485 (interactive)
486 (when (= (point) (comint-bol)) (beginning-of-line)))
488 (defun geiser-repl--beginning-of-defun ()
489 (save-restriction
490 (when comint-last-prompt-overlay
491 (narrow-to-region (overlay-end comint-last-prompt-overlay) (point)))
492 (let ((beginning-of-defun-function nil))
493 (beginning-of-defun))))
495 (defun geiser-repl--module-function (&optional module)
496 (if (and module geiser-eval--get-impl-module)
497 (funcall geiser-eval--get-impl-module module)
498 :f))
500 (defun geiser-repl--doc-module ()
501 (interactive)
502 (let ((geiser-eval--get-module-function
503 (geiser-impl--method 'find-module geiser-impl--implementation)))
504 (geiser-doc-module)))
506 (defun geiser-repl--newline-and-indent ()
507 (interactive)
508 (save-restriction
509 (narrow-to-region comint-last-input-start (point-max))
510 (insert "\n")
511 (lisp-indent-line)))
513 (defun geiser-repl--last-prompt-end ()
514 (if comint-last-prompt-overlay
515 (overlay-end comint-last-prompt-overlay)
516 (save-excursion (geiser-repl--bol) (point))))
518 (defun geiser-repl--last-prompt-start ()
519 (if comint-last-prompt-overlay
520 (overlay-start comint-last-prompt-overlay)
521 (save-excursion (geiser-repl--bol) (point))))
523 (defun geiser-repl--nesting-level ()
524 (save-restriction
525 (narrow-to-region (geiser-repl--last-prompt-end) (point-max))
526 (geiser-syntax--nesting-level)))
528 (defun geiser-repl--send-input ()
529 (let* ((proc (get-buffer-process (current-buffer)))
530 (pmark (and proc (process-mark proc)))
531 (intxt (and pmark (buffer-substring pmark (point)))))
532 (when intxt
533 (and geiser-repl-forget-old-errors-p
534 (not (geiser-repl--is-debugging))
535 (compilation-forget-errors))
536 (geiser-repl--prepare-send)
537 (comint-send-input)
538 (when (string-match "^\\s-*$" intxt)
539 (comint-send-string proc (geiser-eval--scheme-str '(:ge no-values)))
540 (comint-send-string proc "\n")))))
542 (defun geiser-repl--maybe-send ()
543 (interactive)
544 (let ((p (point)))
545 (cond ((< p (geiser-repl--last-prompt-start))
546 (ignore-errors (compile-goto-error)))
547 ((progn (end-of-line) (<= (geiser-repl--nesting-level) 0))
548 (geiser-repl--send-input))
549 (t (goto-char p)
550 (if geiser-repl-auto-indent-p
551 (geiser-repl--newline-and-indent)
552 (insert "\n"))))))
554 (defun geiser-repl-tab-dwim (n)
555 "If we're after the last prompt, complete symbol or indent (if
556 there's no symbol at point). Otherwise, go to next error in the REPL
557 buffer."
558 (interactive "p")
559 (if (>= (point) (geiser-repl--last-prompt-end))
560 (or (completion-at-point)
561 (lisp-indent-line))
562 (compilation-next-error n)))
564 (defun geiser-repl--previous-error (n)
565 "Go to previous error in the REPL buffer."
566 (interactive "p")
567 (compilation-next-error (- n)))
569 (defun geiser-repl-clear-buffer ()
570 "Delete the output generated by the scheme process."
571 (interactive)
572 (let ((inhibit-read-only t))
573 (delete-region (point-min) (geiser-repl--last-prompt-start))
574 (when (< (point) (geiser-repl--last-prompt-end))
575 (goto-char (geiser-repl--last-prompt-end)))
576 (recenter t)))
578 (define-derived-mode geiser-repl-mode comint-mode "REPL"
579 "Major mode for interacting with an inferior scheme repl process.
580 \\{geiser-repl-mode-map}"
581 (scheme-mode-variables)
582 (set (make-local-variable 'face-remapping-alist)
583 '((comint-highlight-prompt geiser-font-lock-repl-prompt)
584 (comint-highlight-input geiser-font-lock-repl-input)))
585 (set (make-local-variable 'mode-line-process) nil)
586 (set (make-local-variable 'comint-use-prompt-regexp) t)
587 (set (make-local-variable 'comint-prompt-read-only)
588 geiser-repl-read-only-prompt-p)
589 (set (make-local-variable 'beginning-of-defun-function)
590 'geiser-repl--beginning-of-defun)
591 (set (make-local-variable 'comint-input-ignoredups)
592 geiser-repl-history-no-dups-p)
593 (setq geiser-eval--get-module-function 'geiser-repl--module-function)
594 (geiser-completion--setup t)
595 (setq geiser-smart-tab-mode-string "")
596 (geiser-smart-tab-mode t)
597 (geiser-syntax--add-kws)
598 ;; enabling compilation-shell-minor-mode without the annoying highlighter
599 (compilation-setup t))
601 (define-key geiser-repl-mode-map "\C-d" 'delete-char)
602 (define-key geiser-repl-mode-map "\C-m" 'geiser-repl--maybe-send)
603 (define-key geiser-repl-mode-map [return] 'geiser-repl--maybe-send)
604 (define-key geiser-repl-mode-map "\C-j" 'geiser-repl--newline-and-indent)
605 (define-key geiser-repl-mode-map (kbd "TAB") 'geiser-repl-tab-dwim)
606 (define-key geiser-repl-mode-map [backtab] 'geiser-repl--previous-error)
608 (define-key geiser-repl-mode-map "\C-a" 'geiser-repl--bol)
609 (define-key geiser-repl-mode-map (kbd "<home>") 'geiser-repl--bol)
611 (geiser-menu--defmenu repl geiser-repl-mode-map
612 ("Complete symbol" ((kbd "M-TAB"))
613 completion-at-point :enable (geiser--symbol-at-point))
614 ("Complete module name" ((kbd "C-.") (kbd "M-`"))
615 geiser-completion--complete-module :enable (geiser--symbol-at-point))
616 ("Edit symbol" "\M-." geiser-edit-symbol-at-point
617 :enable (geiser--symbol-at-point))
619 ("Switch to module..." "\C-c\C-m" switch-to-geiser-module)
620 ("Import module..." "\C-c\C-i" geiser-repl-import-module)
621 ("Add to load path..." "\C-c\C-r" geiser-add-to-load-path)
623 ("Previous matching input" "\M-p" comint-previous-matching-input-from-input
624 "Previous input matching current")
625 ("Next matching input" "\M-n" comint-next-matching-input-from-input
626 "Next input matching current")
627 ("Previous input" "\C-c\M-p" comint-previous-input)
628 ("Next input" "\C-c\M-n" comint-next-input)
630 (mode "Autodoc mode" ("\C-c\C-da" "\C-c\C-d\C-a") geiser-autodoc-mode)
631 ("Symbol documentation" ("\C-c\C-dd" "\C-c\C-d\C-d")
632 geiser-doc-symbol-at-point
633 "Documentation for symbol at point" :enable (geiser--symbol-at-point))
634 ("Lookup symbol in manul" ("\C-c\C-di" "\C-c\C-d\C-i")
635 geiser-doc-look-up-manual
636 "Documentation for symbol at point" :enable (geiser--symbol-at-point))
637 ("Module documentation" ("\C-c\C-dm" "\C-c\C-d\C-m") geiser-repl--doc-module
638 "Documentation for module at point" :enable (geiser--symbol-at-point))
640 ("Clear buffer" "\C-c\M-o" geiser-repl-clear-buffer
641 "Clean up REPL buffer, leaving just a lonely prompt")
642 ("Kill Scheme interpreter" "\C-c\C-q" geiser-repl-exit
643 :enable (geiser-repl--live-p))
644 ("Restart" "\C-c\C-z" switch-to-geiser :enable (not (geiser-repl--live-p)))
646 (custom "REPL options" geiser-repl))
648 (define-key geiser-repl-mode-map [menu-bar completion] 'undefined)
651 ;;; User commands
653 (defun run-geiser (impl)
654 "Start a new Geiser REPL."
655 (interactive
656 (list (geiser-repl--get-impl "Start Geiser for scheme implementation: ")))
657 (let ((buffer (current-buffer)))
658 (geiser-repl--start-repl impl nil)
659 (geiser-repl--maybe-remember-scm-buffer buffer)))
661 (defalias 'geiser 'run-geiser)
663 (defun geiser-connect (impl &optional host port)
664 "Start a new Geiser REPL connected to a remote Scheme process."
665 (interactive
666 (list (geiser-repl--get-impl "Connect to Scheme implementation: ")))
667 (let ((buffer (current-buffer)))
668 (geiser-repl--start-repl impl
669 (geiser-repl--read-address host port))
670 (geiser-repl--maybe-remember-scm-buffer buffer)))
672 (make-variable-buffer-local
673 (defvar geiser-repl--last-scm-buffer nil))
675 (defun geiser-repl--maybe-remember-scm-buffer (buffer)
676 (when (and buffer
677 (eq 'scheme-mode (with-current-buffer buffer major-mode))
678 (eq major-mode 'geiser-repl-mode))
679 (setq geiser-repl--last-scm-buffer buffer)))
681 (defun switch-to-geiser (&optional ask impl buffer)
682 "Switch to running Geiser REPL.
684 With prefix argument, ask for which one if more than one is running.
685 If no REPL is running, execute `run-geiser' to start a fresh one."
686 (interactive "P")
687 (let* ((impl (or impl geiser-impl--implementation))
688 (in-repl (eq major-mode 'geiser-repl-mode))
689 (in-live-repl (and in-repl (get-buffer-process (current-buffer))))
690 (repl (cond ((and (not ask)
691 (not impl)
692 (not in-repl)
693 (or geiser-repl--repl (car geiser-repl--repls))))
694 ((and (not ask)
695 (not in-repl)
696 impl
697 (geiser-repl--repl/impl impl))))))
698 (cond ((or in-live-repl
699 (and (eq (current-buffer) repl) (not (eq repl buffer))))
700 (when (buffer-live-p geiser-repl--last-scm-buffer)
701 (geiser-repl--switch-to-buffer geiser-repl--last-scm-buffer)))
702 (repl (geiser-repl--switch-to-buffer repl))
703 ((geiser-repl--remote-p) (geiser-connect impl))
704 (t (run-geiser impl)))
705 (geiser-repl--maybe-remember-scm-buffer buffer)))
707 (defun switch-to-geiser-module (&optional module buffer)
708 "Switch to running Geiser REPL and try to enter a given module."
709 (interactive)
710 (let* ((module (or module
711 (geiser-completion--read-module
712 "Switch to module (default top-level): ")))
713 (cmd (and module
714 (geiser-repl--enter-cmd geiser-impl--implementation
715 module))))
716 (unless (eq major-mode 'geiser-repl-mode)
717 (switch-to-geiser nil nil (or buffer (current-buffer))))
718 (geiser-repl--send cmd)))
720 (defun geiser-repl-import-module (&optional module)
721 "Import a given module in the current namespace of the REPL."
722 (interactive)
723 (let* ((module (or module
724 (geiser-completion--read-module "Import module: ")))
725 (cmd (and module
726 (geiser-repl--import-cmd geiser-impl--implementation
727 module))))
728 (switch-to-geiser nil nil (current-buffer))
729 (geiser-repl--send cmd)))
731 (defun geiser-repl-exit (&optional arg)
732 "Exit the current REPL.
733 With a prefix argument, force exit by killing the scheme process."
734 (interactive "P")
735 (when (or (not geiser-repl-query-on-exit-p)
736 (y-or-n-p "Really quit this REPL? "))
737 (geiser-con--connection-deactivate geiser-repl--connection t)
738 (let ((cmd (and (not arg)
739 (geiser-repl--exit-cmd geiser-impl--implementation))))
740 (if cmd
741 (when (stringp cmd) (geiser-repl--send cmd))
742 (comint-kill-subjob)))))
745 ;;; Unload:
747 (defun geiser-repl--repl-list ()
748 (let (lst)
749 (dolist (repl geiser-repl--repls lst)
750 (when (buffer-live-p repl)
751 (with-current-buffer repl
752 (push (cons geiser-impl--implementation
753 geiser-repl--address)
754 lst))))))
756 (defun geiser-repl--restore (impls)
757 (dolist (impl impls)
758 (when impl
759 (condition-case err
760 (geiser-repl--start-repl (car impl) (cdr impl))
761 (error (message (error-message-string err)))))))
763 (defun geiser-repl-unload-function ()
764 (dolist (repl geiser-repl--repls)
765 (when (buffer-live-p repl)
766 (with-current-buffer repl
767 (let ((geiser-repl-query-on-exit-p nil)) (geiser-repl-exit))
768 (sit-for 0.05)
769 (kill-buffer)))))
772 (provide 'geiser-repl)