lisp/ob-table.el

   1 ;;; ob-table.el --- support for calling org-babel functions from tables
   2
   3 ;; Copyright (C) 2009, 2010  Free Software Foundation, Inc.
   4
   5 ;; Author: Eric Schulte
   6 ;; Keywords: literate programming, reproducible research
   7 ;; Homepage: http://orgmode.org
   8 ;; Version: 0.01
   9
  10 ;; This file is part of GNU Emacs.
  11
  12 ;; GNU Emacs is free software: you can redistribute it and/or modify
  13 ;; it under the terms of the GNU General Public License as published by
  14 ;; the Free Software Foundation, either version 3 of the License, or
  15 ;; (at your option) any later version.
  16
  17 ;; GNU Emacs is distributed in the hope that it will be useful,
  18 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  20 ;; GNU General Public License for more details.
  21
  22 ;; You should have received a copy of the GNU General Public License
  23 ;; along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
  24
  25 ;;; Commentary:
  26
  27 ;; Should allow calling functions from org-mode tables using the
  28 ;; function `sbe' as so...
  29
  30 ;; #+begin_src emacs-lisp :results silent
  31 ;;   (defun fibbd (n) (if (< n 2) 1 (+ (fibbd (- n 1)) (fibbd (- n 2)))))
  32 ;; #+end_src
  33
  34 ;; #+srcname: fibbd
  35 ;; #+begin_src emacs-lisp :var n=2 :results silent
  36 ;; (fibbd n)
  37 ;; #+end_src
  38
  39 ;; | original | fibbd  |
  40 ;; |----------+--------|
  41 ;; |        0 |        |
  42 ;; |        1 |        |
  43 ;; |        2 |        |
  44 ;; |        3 |        |
  45 ;; |        4 |        |
  46 ;; |        5 |        |
  47 ;; |        6 |        |
  48 ;; |        7 |        |
  49 ;; |        8 |        |
  50 ;; |        9 |        |
  51 ;; #+TBLFM: $2='(sbe 'fibbd (n $1))
  52
  53 ;;; Code:
  54 (require 'ob)
  55
  56 (defun org-babel-table-truncate-at-newline (string)
  57   "If STRING ends in a newline character, then remove the newline
  58 character and replace it with ellipses."
  59   (if (and (stringp string) (string-match "[\n\r]" string))
  60       (concat (substring string 0 (match-beginning 0)) "...")
  61     string))
  62
  63 (defmacro sbe (source-block &rest variables)
  64   "Return the results of calling SOURCE-BLOCK assigning every
  65 variable in VARIABLES.  Each element of VARIABLES should be a two
  66 element list, whose first element is the name of the variable and
  67 second element is a string of its value.  The following call to
  68 `sbe' would be equivalent to the following source code block.
  69
  70  (sbe 'source-block (n $2) (m 3))
  71
  72 #+begin_src emacs-lisp :var results=source-block(n=val_at_col_2, m=3) :results silent
  73 results
  74 #+end_src
  75
  76 NOTE: by default string variable names are interpreted as
  77 references to source-code blocks, to force interpretation of a
  78 cell's value as a string, prefix the identifier with two \"$\"s
  79 rather than a single \"$\" (i.e. \"$$2\" instead of \"$2\" in the
  80 example above."
  81   (let ((variables (mapcar
  82                     (lambda (var)
  83                       (if (and (= 3 (length var)) (eq (nth 1 var) '$))
  84                           (list (car var) (format "\"%s\"" (last var)))
  85                         var))
  86                     variables)))
  87     (unless (stringp source-block) (setq source-block (symbol-name source-block)))
  88     (org-babel-table-truncate-at-newline ;; org-table cells can't be multi-line
  89      (if (and source-block (> (length source-block) 0))
  90          (let ((params
  91                 (eval `(org-babel-parse-header-arguments
  92                         (concat ":var results="
  93                                 ,source-block
  94                                 "("
  95                                 (mapconcat (lambda (var-spec)
  96                                              (format "%S=%s" (nth 0 var-spec) (nth 1 var-spec)))
  97                                            ',variables ", ")
  98                                 ")")))))
  99            (org-babel-execute-src-block
 100             nil (list "emacs-lisp" "results"
 101                       (org-babel-merge-params '((:results . "silent")) params))))
 102        ""))))
 103
 104 (provide 'ob-table)
 105
 106 ;; arch-tag: 4234cc7c-4fc8-4e92-abb0-2892de1a493b
 107
 108 ;;; ob-table.el ends here