2015-10-25 20:56:00 -04:00
|
|
|
;;; ob-eval.el --- Babel Functions for External Code Evaluation -*- lexical-binding: t; -*-
|
2010-07-04 12:48:12 -04:00
|
|
|
|
2023-01-01 05:31:12 -05:00
|
|
|
;; Copyright (C) 2009-2023 Free Software Foundation, Inc.
|
2010-07-04 12:48:12 -04:00
|
|
|
|
|
|
|
;; Author: Eric Schulte
|
|
|
|
;; Keywords: literate programming, reproducible research, comint
|
2021-09-26 03:44:29 -04:00
|
|
|
;; URL: https://orgmode.org
|
2010-07-04 12:48:12 -04:00
|
|
|
|
|
|
|
;; This file is part of GNU Emacs.
|
|
|
|
|
|
|
|
;; GNU Emacs 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 3 of the License, or
|
|
|
|
;; (at your option) any later version.
|
|
|
|
|
|
|
|
;; GNU Emacs 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
|
2017-09-13 18:52:52 -04:00
|
|
|
;; along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>.
|
2010-07-04 12:48:12 -04:00
|
|
|
|
|
|
|
;;; Commentary:
|
|
|
|
|
|
|
|
;; These functions build existing Emacs support for executing external
|
|
|
|
;; shell commands.
|
|
|
|
|
|
|
|
;;; Code:
|
2022-08-04 09:53:05 -04:00
|
|
|
|
2013-06-01 05:21:48 -04:00
|
|
|
(require 'org-macs)
|
2022-08-04 09:53:05 -04:00
|
|
|
(org-assert-version)
|
2010-07-04 12:48:12 -04:00
|
|
|
|
2022-11-13 17:53:53 -05:00
|
|
|
(eval-when-compile (require 'subr-x)) ; For `string-empty-p', Emacs < 29
|
|
|
|
|
2010-11-18 08:09:46 -05:00
|
|
|
(defvar org-babel-error-buffer-name "*Org-Babel Error Output*")
|
2012-12-20 13:01:17 -05:00
|
|
|
(declare-function org-babel-temp-file "ob-core" (prefix &optional suffix))
|
2010-11-18 08:09:46 -05:00
|
|
|
|
2010-07-04 12:48:12 -04:00
|
|
|
(defun org-babel-eval-error-notify (exit-code stderr)
|
2010-07-13 19:04:47 -04:00
|
|
|
"Open a buffer to display STDERR and a message with the value of EXIT-CODE."
|
2010-11-18 08:09:46 -05:00
|
|
|
(let ((buf (get-buffer-create org-babel-error-buffer-name)))
|
2010-07-04 12:48:12 -04:00
|
|
|
(with-current-buffer buf
|
|
|
|
(goto-char (point-max))
|
2022-10-23 00:21:15 -04:00
|
|
|
(save-excursion
|
2022-10-26 23:49:05 -04:00
|
|
|
(unless (bolp) (insert "\n"))
|
2022-10-26 07:35:26 -04:00
|
|
|
(insert stderr)
|
|
|
|
(insert (format "[ Babel evaluation exited with code %S ]" exit-code))))
|
2010-07-04 12:48:12 -04:00
|
|
|
(display-buffer buf))
|
2010-07-14 00:11:12 -04:00
|
|
|
(message "Babel evaluation exited with code %S" exit-code))
|
2010-07-04 12:48:12 -04:00
|
|
|
|
2021-04-28 06:15:47 -04:00
|
|
|
(defun org-babel-eval (command query)
|
|
|
|
"Run COMMAND on QUERY.
|
2022-10-26 07:35:26 -04:00
|
|
|
Return standard output produced by COMMAND. If COMMAND exits
|
|
|
|
with a non-zero code or produces error output, show it with
|
|
|
|
`org-babel-eval-error-notify'.
|
|
|
|
|
2021-04-28 06:15:47 -04:00
|
|
|
Writes QUERY into a temp-buffer that is processed with
|
2022-10-26 07:35:26 -04:00
|
|
|
`org-babel--shell-command-on-region'."
|
2021-04-28 06:15:47 -04:00
|
|
|
(let ((error-buffer (get-buffer-create " *Org-Babel Error*")) exit-code)
|
|
|
|
(with-current-buffer error-buffer (erase-buffer))
|
2010-07-04 12:48:12 -04:00
|
|
|
(with-temp-buffer
|
2021-04-28 06:15:47 -04:00
|
|
|
(insert query)
|
2010-07-04 12:48:12 -04:00
|
|
|
(setq exit-code
|
2022-10-26 07:35:26 -04:00
|
|
|
(org-babel--shell-command-on-region
|
|
|
|
command error-buffer))
|
|
|
|
(let ((stderr (with-current-buffer error-buffer (buffer-string))))
|
|
|
|
(if (or (not (numberp exit-code))
|
|
|
|
(> exit-code 0)
|
|
|
|
(not (string-empty-p stderr)))
|
|
|
|
(progn
|
|
|
|
(org-babel-eval-error-notify exit-code stderr)
|
|
|
|
(save-excursion
|
|
|
|
(when (get-buffer org-babel-error-buffer-name)
|
|
|
|
(with-current-buffer org-babel-error-buffer-name
|
|
|
|
(unless (derived-mode-p 'compilation-mode)
|
|
|
|
(compilation-mode))
|
|
|
|
;; Compilation-mode enforces read-only, but
|
|
|
|
;; Babel expects the buffer modifiable.
|
|
|
|
(setq buffer-read-only nil))))
|
|
|
|
;; Return output, if any.
|
|
|
|
(buffer-string))
|
|
|
|
(buffer-string))))))
|
2010-07-04 12:48:12 -04:00
|
|
|
|
|
|
|
(defun org-babel-eval-read-file (file)
|
|
|
|
"Return the contents of FILE as a string."
|
2010-09-22 16:40:14 -04:00
|
|
|
(with-temp-buffer (insert-file-contents file)
|
2010-07-04 12:48:12 -04:00
|
|
|
(buffer-string)))
|
|
|
|
|
2021-04-28 06:15:47 -04:00
|
|
|
(defun org-babel--shell-command-on-region (command error-buffer)
|
2010-07-13 19:04:47 -04:00
|
|
|
"Execute COMMAND in an inferior shell with region as input.
|
2021-04-28 06:15:47 -04:00
|
|
|
Stripped down version of `shell-command-on-region' for internal use in
|
|
|
|
Babel only. This lets us work around errors in the original function
|
|
|
|
in various versions of Emacs. This expects the query to be run to be
|
|
|
|
in the current temp buffer. This is written into
|
|
|
|
input-file. ERROR-BUFFER is the name of the file which
|
|
|
|
`org-babel-eval' has created to use for any error messages that are
|
|
|
|
returned."
|
2010-07-04 12:48:12 -04:00
|
|
|
|
2013-02-24 11:15:36 -05:00
|
|
|
(let ((input-file (org-babel-temp-file "ob-input-"))
|
|
|
|
(error-file (if error-buffer (org-babel-temp-file "ob-error-") nil))
|
2021-04-28 06:15:47 -04:00
|
|
|
(shell-file-name (org-babel--get-shell-file-name))
|
2010-07-04 12:48:12 -04:00
|
|
|
exit-status)
|
2012-12-21 03:45:53 -05:00
|
|
|
;; There is an error in `process-file' when `error-file' exists.
|
|
|
|
;; This is fixed in Emacs trunk as of 2012-12-21; let's use this
|
|
|
|
;; workaround for now.
|
|
|
|
(unless (file-remote-p default-directory)
|
|
|
|
(delete-file error-file))
|
2013-02-24 11:15:36 -05:00
|
|
|
;; we always call this with 'replace, remove conditional
|
|
|
|
;; Replace specified region with output from command.
|
2021-04-28 06:15:47 -04:00
|
|
|
(org-babel--write-temp-buffer-input-file input-file)
|
|
|
|
(setq exit-status
|
|
|
|
(process-file shell-file-name input-file
|
|
|
|
(if error-file
|
|
|
|
(list t error-file)
|
|
|
|
t)
|
|
|
|
nil shell-command-switch command))
|
2013-02-24 11:15:36 -05:00
|
|
|
|
|
|
|
(when (and input-file (file-exists-p input-file)
|
|
|
|
;; bind org-babel--debug-input around the call to keep
|
|
|
|
;; the temporary input files available for inspection
|
|
|
|
(not (when (boundp 'org-babel--debug-input)
|
|
|
|
org-babel--debug-input)))
|
2012-12-21 03:45:53 -05:00
|
|
|
(delete-file input-file))
|
|
|
|
|
2010-07-04 12:48:12 -04:00
|
|
|
(when (and error-file (file-exists-p error-file))
|
2018-09-23 21:30:46 -04:00
|
|
|
(when (< 0 (file-attribute-size (file-attributes error-file)))
|
2016-09-02 21:45:27 -04:00
|
|
|
(with-current-buffer (get-buffer-create error-buffer)
|
|
|
|
(let ((pos-from-end (- (point-max) (point))))
|
|
|
|
(or (bobp)
|
|
|
|
(insert "\f\n"))
|
|
|
|
;; Do no formatting while reading error file,
|
|
|
|
;; because that can run a shell command, and we
|
|
|
|
;; don't want that to cause an infinite recursion.
|
|
|
|
(format-insert-file error-file nil)
|
|
|
|
;; Put point after the inserted errors.
|
|
|
|
(goto-char (- (point-max) pos-from-end)))
|
|
|
|
(current-buffer)))
|
2010-07-04 12:48:12 -04:00
|
|
|
(delete-file error-file))
|
|
|
|
exit-status))
|
|
|
|
|
2021-04-28 06:15:47 -04:00
|
|
|
(defun org-babel--write-temp-buffer-input-file (input-file)
|
|
|
|
"Write the contents of the current temp buffer into INPUT-FILE."
|
|
|
|
(let ((start (point-min))
|
|
|
|
(end (point-max)))
|
|
|
|
(goto-char start)
|
|
|
|
(push-mark (point) 'nomsg)
|
|
|
|
(write-region start end input-file)
|
|
|
|
(delete-region start end)
|
|
|
|
(exchange-point-and-mark)))
|
|
|
|
|
2010-11-18 08:09:46 -05:00
|
|
|
(defun org-babel-eval-wipe-error-buffer ()
|
2010-11-26 15:28:44 -05:00
|
|
|
"Delete the contents of the Org code block error buffer.
|
|
|
|
This buffer is named by `org-babel-error-buffer-name'."
|
2010-11-18 08:09:46 -05:00
|
|
|
(when (get-buffer org-babel-error-buffer-name)
|
2010-11-26 15:28:44 -05:00
|
|
|
(with-current-buffer org-babel-error-buffer-name
|
|
|
|
(delete-region (point-min) (point-max)))))
|
2010-11-18 08:09:46 -05:00
|
|
|
|
2021-04-28 06:15:47 -04:00
|
|
|
(defun org-babel--get-shell-file-name ()
|
|
|
|
"Return system `shell-file-name', defaulting to /bin/sh.
|
|
|
|
Unfortunately, `executable-find' does not support file name
|
|
|
|
handlers. Therefore, we could use it in the local case only."
|
2022-11-23 20:47:55 -05:00
|
|
|
;; FIXME: Since Emacs 27, `executable-find' accepts optional second
|
|
|
|
;; argument supporting remote hosts.
|
2021-04-28 06:15:47 -04:00
|
|
|
(cond ((and (not (file-remote-p default-directory))
|
|
|
|
(executable-find shell-file-name))
|
|
|
|
shell-file-name)
|
|
|
|
((file-executable-p
|
|
|
|
(concat (file-remote-p default-directory) shell-file-name))
|
|
|
|
shell-file-name)
|
|
|
|
("/bin/sh")))
|
|
|
|
|
2010-07-04 17:46:13 -04:00
|
|
|
(provide 'ob-eval)
|
2010-07-04 12:48:12 -04:00
|
|
|
|
2010-07-05 09:14:28 -04:00
|
|
|
;;; ob-eval.el ends here
|