ob-table.el 5.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152
  1. ;;; ob-table.el --- Support for Calling Babel Functions from Tables -*- lexical-binding: t; -*-
  2. ;; Copyright (C) 2009-2015 Free Software Foundation, Inc.
  3. ;; Author: Eric Schulte
  4. ;; Keywords: literate programming, reproducible research
  5. ;; Homepage: http://orgmode.org
  6. ;; This file is part of GNU Emacs.
  7. ;; GNU Emacs is free software: you can redistribute it and/or modify
  8. ;; it under the terms of the GNU General Public License as published by
  9. ;; the Free Software Foundation, either version 3 of the License, or
  10. ;; (at your option) any later version.
  11. ;; GNU Emacs is distributed in the hope that it will be useful,
  12. ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  13. ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  14. ;; GNU General Public License for more details.
  15. ;; You should have received a copy of the GNU General Public License
  16. ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
  17. ;;; Commentary:
  18. ;; Should allow calling functions from org-mode tables using the
  19. ;; function `org-sbe' as so...
  20. ;; #+begin_src emacs-lisp :results silent
  21. ;; (defun fibbd (n) (if (< n 2) 1 (+ (fibbd (- n 1)) (fibbd (- n 2)))))
  22. ;; #+end_src
  23. ;; #+name: fibbd
  24. ;; #+begin_src emacs-lisp :var n=2 :results silent
  25. ;; (fibbd n)
  26. ;; #+end_src
  27. ;; | original | fibbd |
  28. ;; |----------+--------|
  29. ;; | 0 | |
  30. ;; | 1 | |
  31. ;; | 2 | |
  32. ;; | 3 | |
  33. ;; | 4 | |
  34. ;; | 5 | |
  35. ;; | 6 | |
  36. ;; | 7 | |
  37. ;; | 8 | |
  38. ;; | 9 | |
  39. ;; #+TBLFM: $2='(org-sbe "fibbd" (n $1))
  40. ;; NOTE: The quotation marks around the function name, 'fibbd' here,
  41. ;; are optional.
  42. ;;; Code:
  43. (require 'ob-core)
  44. (defun org-babel-table-truncate-at-newline (string)
  45. "Replace newline character with ellipses.
  46. If STRING ends in a newline character, then remove the newline
  47. character and replace it with ellipses."
  48. (if (and (stringp string) (string-match "[\n\r]\\(.\\)?" string))
  49. (concat (substring string 0 (match-beginning 0))
  50. (if (match-string 1 string) "...")) string))
  51. (defmacro org-sbe (source-block &rest variables)
  52. "Return the results of calling SOURCE-BLOCK with VARIABLES.
  53. Each element of VARIABLES should be a list of two elements: the
  54. first element is the name of the variable and second element is a
  55. string of its value.
  56. So this `org-sbe' construct
  57. (org-sbe \"source-block\" (n $2) (m 3))
  58. is the equivalent of the following source code block:
  59. #+begin_src emacs-lisp :var results=source-block(n=val_at_col_2, m=3) :results silent
  60. results
  61. #+end_src
  62. NOTE: The quotation marks around the function name,
  63. 'source-block', are optional.
  64. NOTE: By default, string variable names are interpreted as
  65. references to source-code blocks, to force interpretation of a
  66. cell's value as a string, prefix the identifier a \"$\" (e.g.,
  67. \"$$2\" instead of \"$2\" or \"$@2$2\" instead of \"@2$2\").
  68. NOTE: It is also possible to pass header arguments to the code
  69. block. In this case a table cell should hold the string value of
  70. the header argument which can then be passed before all variables
  71. as shown in the example below.
  72. | 1 | 2 | :file nothing.png | nothing.png |
  73. #+TBLFM: @1$4=\\='(org-sbe test-sbe $3 (x $1) (y $2))"
  74. (declare (debug (form form)))
  75. (let* ((header-args (if (stringp (car variables)) (car variables) ""))
  76. (variables (if (stringp (car variables)) (cdr variables) variables)))
  77. (let* (quote
  78. (variables
  79. (mapcar
  80. (lambda (var)
  81. ;; ensure that all cells prefixed with $'s are strings
  82. (cons (car var)
  83. (delq nil (mapcar
  84. (lambda (el)
  85. (if (eq '$ el)
  86. (prog1 nil (setq quote t))
  87. (prog1
  88. (cond
  89. (quote (format "\"%s\"" el))
  90. ((stringp el) (org-no-properties el))
  91. (t el))
  92. (setq quote nil))))
  93. (cdr var)))))
  94. variables)))
  95. (unless (stringp source-block)
  96. (setq source-block (symbol-name source-block)))
  97. (let ((result
  98. (if (and source-block (> (length source-block) 0))
  99. (let ((params
  100. ;; FIXME: Why `eval'?!?!?
  101. (eval `(org-babel-parse-header-arguments
  102. (concat
  103. ":var results="
  104. ,source-block
  105. "[" ,header-args "]"
  106. "("
  107. (mapconcat
  108. (lambda (var-spec)
  109. (if (> (length (cdr var-spec)) 1)
  110. (format "%S='%S"
  111. (car var-spec)
  112. (mapcar #'read (cdr var-spec)))
  113. (format "%S=%s"
  114. (car var-spec) (cadr var-spec))))
  115. ',variables ", ")
  116. ")")))))
  117. (org-babel-execute-src-block
  118. nil (list "emacs-lisp" "results" params)
  119. '((:results . "silent"))))
  120. "")))
  121. (org-babel-trim (if (stringp result) result (format "%S" result)))))))
  122. (provide 'ob-table)
  123. ;;; ob-table.el ends here