2015-10-25 20:56:00 -04:00
|
|
|
;;; ob-scheme.el --- Babel Functions for Scheme -*- lexical-binding: t; -*-
|
2010-08-27 20:01:24 -04:00
|
|
|
|
2022-01-01 15:10:55 -05:00
|
|
|
;; Copyright (C) 2010-2022 Free Software Foundation, Inc.
|
2010-08-27 20:01:24 -04:00
|
|
|
|
2014-01-18 03:17:14 -05:00
|
|
|
;; Authors: Eric Schulte
|
|
|
|
;; Michael Gauland
|
2010-08-27 20:01:24 -04:00
|
|
|
;; Keywords: literate programming, reproducible research, scheme
|
2018-01-16 11:22:00 -05:00
|
|
|
;; Homepage: https://orgmode.org
|
2010-08-27 20:01:24 -04:00
|
|
|
|
2011-08-24 14:55:11 -04:00
|
|
|
;; This file is part of GNU Emacs.
|
2010-08-27 20:01:24 -04:00
|
|
|
|
2011-08-24 14:55:11 -04:00
|
|
|
;; GNU Emacs is free software: you can redistribute it and/or modify
|
2010-08-27 20:01:24 -04:00
|
|
|
;; it under the terms of the GNU General Public License as published by
|
2011-08-24 14:55:11 -04:00
|
|
|
;; the Free Software Foundation, either version 3 of the License, or
|
|
|
|
;; (at your option) any later version.
|
|
|
|
|
|
|
|
;; GNU Emacs is distributed in the hope that it will be useful,
|
2010-08-27 20:01:24 -04:00
|
|
|
;; 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.
|
2011-08-24 14:55:11 -04:00
|
|
|
|
2010-08-27 20:01:24 -04:00
|
|
|
;; You should have received a copy of the GNU General Public License
|
2017-09-13 18:52:52 -04:00
|
|
|
;; along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>.
|
2010-08-27 20:01:24 -04:00
|
|
|
|
|
|
|
;;; Commentary:
|
|
|
|
|
|
|
|
;; Now working with SBCL for both session and external evaluation.
|
|
|
|
;;
|
|
|
|
;; This certainly isn't optimally robust, but it seems to be working
|
|
|
|
;; for the basic use cases.
|
|
|
|
|
|
|
|
;;; Requirements:
|
|
|
|
|
|
|
|
;; - a working scheme implementation
|
2017-09-13 18:52:52 -04:00
|
|
|
;; (e.g. guile https://www.gnu.org/software/guile/guile.html)
|
2011-08-24 14:55:11 -04:00
|
|
|
;;
|
2013-01-08 18:41:13 -05:00
|
|
|
;; - for session based evaluation geiser is required, which is available from
|
|
|
|
;; ELPA.
|
2010-08-27 20:01:24 -04:00
|
|
|
|
|
|
|
;;; Code:
|
|
|
|
(require 'ob)
|
2013-07-01 17:08:08 -04:00
|
|
|
(require 'geiser nil t)
|
2017-12-19 13:15:00 -05:00
|
|
|
(require 'geiser-impl nil t)
|
2013-07-01 17:08:08 -04:00
|
|
|
(defvar geiser-repl--repl) ; Defined in geiser-repl.el
|
|
|
|
(defvar geiser-impl--implementation) ; Defined in geiser-impl.el
|
2020-05-31 00:34:53 -04:00
|
|
|
(defvar geiser-scheme-implementation) ; Defined in geiser-impl.el
|
2013-07-01 17:08:08 -04:00
|
|
|
(defvar geiser-default-implementation) ; Defined in geiser-impl.el
|
|
|
|
(defvar geiser-active-implementations) ; Defined in geiser-impl.el
|
2017-08-20 12:25:58 -04:00
|
|
|
(defvar geiser-debug-show-debug-p) ; Defined in geiser-debug.el
|
|
|
|
(defvar geiser-debug-jump-to-debug-p) ; Defined in geiser-debug.el
|
|
|
|
(defvar geiser-repl-use-other-window) ; Defined in geiser-repl.el
|
|
|
|
(defvar geiser-repl-window-allow-split) ; Defined in geiser-repl.el
|
2013-07-01 17:08:08 -04:00
|
|
|
|
2016-05-14 22:56:53 -04:00
|
|
|
(declare-function run-geiser "ext:geiser-repl" (impl))
|
|
|
|
(declare-function geiser-mode "ext:geiser-mode" ())
|
|
|
|
(declare-function geiser-eval-region "ext:geiser-mode"
|
|
|
|
(start end &optional and-go raw nomsg))
|
2022-04-23 08:57:27 -04:00
|
|
|
(declare-function geiser-eval-region/wait "ext:geiser-mode"
|
|
|
|
(start end &optional timeout))
|
2016-05-14 22:56:53 -04:00
|
|
|
(declare-function geiser-repl-exit "ext:geiser-repl" (&optional arg))
|
2017-08-20 12:25:58 -04:00
|
|
|
(declare-function geiser-eval--retort-output "ext:geiser-eval" (ret))
|
|
|
|
(declare-function geiser-eval--retort-result-str "ext:geiser-eval" (ret prefix))
|
2010-08-27 20:01:24 -04:00
|
|
|
|
2017-07-24 05:56:52 -04:00
|
|
|
(defcustom org-babel-scheme-null-to 'hline
|
|
|
|
"Replace `null' and empty lists in scheme tables with this before returning."
|
|
|
|
:group 'org-babel
|
|
|
|
:version "26.1"
|
|
|
|
:package-version '(Org . "9.1")
|
|
|
|
:type 'symbol)
|
|
|
|
|
2010-08-27 20:01:24 -04:00
|
|
|
(defvar org-babel-default-header-args:scheme '()
|
|
|
|
"Default header arguments for scheme code blocks.")
|
|
|
|
|
2010-10-15 23:35:45 -04:00
|
|
|
(defun org-babel-expand-body:scheme (body params)
|
2010-08-27 20:01:24 -04:00
|
|
|
"Expand BODY according to PARAMS, return the expanded body."
|
2017-07-24 05:56:52 -04:00
|
|
|
(let ((vars (org-babel--get-vars params))
|
2019-12-18 04:08:25 -05:00
|
|
|
(prepends (cdr (assq :prologue params)))
|
|
|
|
(postpends (cdr (assq :epilogue params))))
|
2017-07-24 07:53:16 -04:00
|
|
|
(concat (and prepends (concat prepends "\n"))
|
|
|
|
(if (null vars) body
|
|
|
|
(format "(let (%s)\n%s\n)"
|
|
|
|
(mapconcat
|
|
|
|
(lambda (var)
|
|
|
|
(format "%S" (print `(,(car var) ',(cdr var)))))
|
|
|
|
vars
|
|
|
|
"\n ")
|
2019-12-18 04:08:25 -05:00
|
|
|
body))
|
|
|
|
(and postpends (concat "\n" postpends)))))
|
2010-08-27 20:01:24 -04:00
|
|
|
|
2013-01-08 18:41:13 -05:00
|
|
|
|
2017-07-24 07:57:12 -04:00
|
|
|
(defvar org-babel-scheme-repl-map (make-hash-table :test #'equal)
|
2013-01-08 18:41:13 -05:00
|
|
|
"Map of scheme sessions to session names.")
|
|
|
|
|
|
|
|
(defun org-babel-scheme-cleanse-repl-map ()
|
|
|
|
"Remove dead buffers from the REPL map."
|
|
|
|
(maphash
|
2017-07-24 07:57:12 -04:00
|
|
|
(lambda (x y) (unless (buffer-name y) (remhash x org-babel-scheme-repl-map)))
|
2013-01-08 18:41:13 -05:00
|
|
|
org-babel-scheme-repl-map))
|
|
|
|
|
|
|
|
(defun org-babel-scheme-get-session-buffer (session-name)
|
|
|
|
"Look up the scheme buffer for a session; return nil if it doesn't exist."
|
|
|
|
(org-babel-scheme-cleanse-repl-map) ; Prune dead sessions
|
|
|
|
(gethash session-name org-babel-scheme-repl-map))
|
|
|
|
|
|
|
|
(defun org-babel-scheme-set-session-buffer (session-name buffer)
|
|
|
|
"Record the scheme buffer used for a given session."
|
|
|
|
(puthash session-name buffer org-babel-scheme-repl-map))
|
|
|
|
|
|
|
|
(defun org-babel-scheme-get-buffer-impl (buffer)
|
2019-10-20 06:12:27 -04:00
|
|
|
"Return the scheme implementation geiser associates with the buffer."
|
2013-01-08 18:41:13 -05:00
|
|
|
(with-current-buffer (set-buffer buffer)
|
|
|
|
geiser-impl--implementation))
|
|
|
|
|
|
|
|
(defun org-babel-scheme-get-repl (impl name)
|
2021-09-16 06:32:43 -04:00
|
|
|
"Switch to a scheme REPL, creating it if it doesn't exist."
|
2013-01-08 18:41:13 -05:00
|
|
|
(let ((buffer (org-babel-scheme-get-session-buffer name)))
|
2013-06-30 20:08:02 -04:00
|
|
|
(or buffer
|
|
|
|
(progn
|
|
|
|
(run-geiser impl)
|
2018-05-09 20:14:24 -04:00
|
|
|
(when name
|
|
|
|
(rename-buffer name t)
|
|
|
|
(org-babel-scheme-set-session-buffer name (current-buffer)))
|
2013-06-30 20:08:02 -04:00
|
|
|
(current-buffer)))))
|
2013-01-08 18:41:13 -05:00
|
|
|
|
|
|
|
(defun org-babel-scheme-make-session-name (buffer name impl)
|
|
|
|
"Generate a name for the session buffer.
|
|
|
|
|
|
|
|
For a named session, the buffer name will be the session name.
|
|
|
|
|
|
|
|
If the session is unnamed (nil), generate a name.
|
|
|
|
|
2015-09-21 00:23:36 -04:00
|
|
|
If the session is `none', use nil for the session name, and
|
2013-01-08 18:41:13 -05:00
|
|
|
org-babel-scheme-execute-with-geiser will use a temporary session."
|
2017-07-24 07:57:12 -04:00
|
|
|
(cond ((not name) (concat buffer " " (symbol-name impl) " REPL"))
|
|
|
|
((string= name "none") nil)
|
|
|
|
(name)))
|
2013-01-08 18:41:13 -05:00
|
|
|
|
2014-05-21 01:47:44 -04:00
|
|
|
(defmacro org-babel-scheme-capture-current-message (&rest body)
|
2019-09-20 18:27:53 -04:00
|
|
|
"Capture current message in both interactive and noninteractive mode."
|
2014-05-21 01:47:44 -04:00
|
|
|
`(if noninteractive
|
|
|
|
(let ((original-message (symbol-function 'message))
|
|
|
|
(current-message nil))
|
|
|
|
(unwind-protect
|
|
|
|
(progn
|
|
|
|
(defun message (&rest args)
|
|
|
|
(setq current-message (apply original-message args)))
|
|
|
|
,@body
|
|
|
|
current-message)
|
|
|
|
(fset 'message original-message)))
|
|
|
|
(progn
|
|
|
|
,@body
|
|
|
|
(current-message))))
|
|
|
|
|
2013-01-08 18:41:13 -05:00
|
|
|
(defun org-babel-scheme-execute-with-geiser (code output impl repl)
|
2019-09-20 18:27:53 -04:00
|
|
|
"Execute code in specified REPL.
|
|
|
|
If the REPL doesn't exist, create it using the given scheme
|
|
|
|
implementation.
|
2013-01-08 18:41:13 -05:00
|
|
|
|
2019-09-20 18:27:53 -04:00
|
|
|
Returns the output of executing the code if the OUTPUT parameter
|
2013-01-08 18:41:13 -05:00
|
|
|
is true; otherwise returns the last value."
|
|
|
|
(let ((result nil))
|
|
|
|
(with-temp-buffer
|
|
|
|
(insert (format ";; -*- geiser-scheme-implementation: %s -*-" impl))
|
|
|
|
(newline)
|
2017-08-20 12:25:58 -04:00
|
|
|
(insert code)
|
2013-01-08 18:41:13 -05:00
|
|
|
(geiser-mode)
|
2017-08-20 12:25:58 -04:00
|
|
|
(let ((geiser-repl-window-allow-split nil)
|
|
|
|
(geiser-repl-use-other-window nil))
|
|
|
|
(let ((repl-buffer (save-current-buffer
|
|
|
|
(org-babel-scheme-get-repl impl repl))))
|
|
|
|
(when (not (eq impl (org-babel-scheme-get-buffer-impl
|
|
|
|
(current-buffer))))
|
|
|
|
(message "Implementation mismatch: %s (%s) %s (%s)" impl (symbolp impl)
|
|
|
|
(org-babel-scheme-get-buffer-impl (current-buffer))
|
|
|
|
(symbolp (org-babel-scheme-get-buffer-impl
|
|
|
|
(current-buffer)))))
|
|
|
|
(setq geiser-repl--repl repl-buffer)
|
|
|
|
(setq geiser-impl--implementation nil)
|
|
|
|
(let ((geiser-debug-jump-to-debug-p nil)
|
|
|
|
(geiser-debug-show-debug-p nil))
|
2022-04-23 08:57:27 -04:00
|
|
|
;; `geiser-eval-region/wait' was introduced to await the
|
|
|
|
;; result of async evaluation in geiser version 0.22.
|
|
|
|
(let ((ret (funcall (if (fboundp 'geiser-eval-region/wait)
|
|
|
|
#'geiser-eval-region/wait
|
|
|
|
#'geiser-eval-region)
|
|
|
|
(point-min)
|
|
|
|
(point-max))))
|
2017-08-20 12:25:58 -04:00
|
|
|
(setq result (if output
|
2020-02-11 06:19:34 -05:00
|
|
|
(or (geiser-eval--retort-output ret)
|
|
|
|
"Geiser Interpreter produced no output")
|
2017-08-20 12:25:58 -04:00
|
|
|
(geiser-eval--retort-result-str ret "")))))
|
|
|
|
(when (not repl)
|
|
|
|
(save-current-buffer (set-buffer repl-buffer)
|
|
|
|
(geiser-repl-exit))
|
|
|
|
(set-process-query-on-exit-flag (get-buffer-process repl-buffer) nil)
|
2017-09-14 09:19:14 -04:00
|
|
|
(kill-buffer repl-buffer)))))
|
2013-01-08 18:41:13 -05:00
|
|
|
result))
|
|
|
|
|
2017-07-24 05:56:52 -04:00
|
|
|
(defun org-babel-scheme--table-or-string (results)
|
|
|
|
"Convert RESULTS into an appropriate elisp value.
|
|
|
|
If the results look like a list or tuple, then convert them into an
|
|
|
|
Emacs-lisp table, otherwise return the results as a string."
|
|
|
|
(let ((res (org-babel-script-escape results)))
|
|
|
|
(cond ((listp res)
|
|
|
|
(mapcar (lambda (el)
|
|
|
|
(if (or (null el) (eq el 'null))
|
|
|
|
org-babel-scheme-null-to
|
|
|
|
el))
|
|
|
|
res))
|
|
|
|
(t res))))
|
|
|
|
|
2010-08-27 20:01:24 -04:00
|
|
|
(defun org-babel-execute:scheme (body params)
|
|
|
|
"Execute a block of Scheme code with org-babel.
|
2019-09-20 18:27:53 -04:00
|
|
|
This function is called by `org-babel-execute-src-block'."
|
2013-01-08 18:41:13 -05:00
|
|
|
(let* ((source-buffer (current-buffer))
|
|
|
|
(source-buffer-name (replace-regexp-in-string ;; zap surrounding *
|
2013-06-30 20:08:02 -04:00
|
|
|
"^ ?\\*\\([^*]+\\)\\*" "\\1"
|
|
|
|
(buffer-name source-buffer))))
|
2013-01-08 18:41:13 -05:00
|
|
|
(save-excursion
|
2017-07-24 05:56:52 -04:00
|
|
|
(let* ((result-type (cdr (assq :result-type params)))
|
|
|
|
(impl (or (when (cdr (assq :scheme params))
|
|
|
|
(intern (cdr (assq :scheme params))))
|
2020-05-31 00:34:53 -04:00
|
|
|
geiser-scheme-implementation
|
2017-07-24 05:56:52 -04:00
|
|
|
geiser-default-implementation
|
|
|
|
(car geiser-active-implementations)))
|
|
|
|
(session (org-babel-scheme-make-session-name
|
|
|
|
source-buffer-name (cdr (assq :session params)) impl))
|
|
|
|
(full-body (org-babel-expand-body:scheme body params))
|
2018-06-20 14:38:47 -04:00
|
|
|
(result-params (cdr (assq :result-params params)))
|
2017-07-24 05:56:52 -04:00
|
|
|
(result
|
|
|
|
(org-babel-scheme-execute-with-geiser
|
|
|
|
full-body ; code
|
|
|
|
(string= result-type "output") ; output?
|
|
|
|
impl ; implementation
|
|
|
|
(and (not (string= session "none")) session)))) ; session
|
|
|
|
(let ((table
|
|
|
|
(org-babel-reassemble-table
|
|
|
|
result
|
|
|
|
(org-babel-pick-name (cdr (assq :colname-names params))
|
|
|
|
(cdr (assq :colnames params)))
|
|
|
|
(org-babel-pick-name (cdr (assq :rowname-names params))
|
|
|
|
(cdr (assq :rownames params))))))
|
2018-06-20 14:38:47 -04:00
|
|
|
(org-babel-result-cond result-params
|
|
|
|
result
|
|
|
|
(org-babel-scheme--table-or-string table)))))))
|
2010-08-27 20:01:24 -04:00
|
|
|
|
|
|
|
(provide 'ob-scheme)
|
|
|
|
|
|
|
|
;;; ob-scheme.el ends here
|