2021-04-19 06:21:01 -04:00
|
|
|
;;; ob-mscgen.el --- Babel Functions for Mscgen -*- lexical-binding: t; -*-
|
2010-07-05 21:43:55 -04:00
|
|
|
|
2021-01-01 14:55:31 -05:00
|
|
|
;; Copyright (C) 2010-2021 Free Software Foundation, Inc.
|
2010-07-05 21:43:55 -04:00
|
|
|
|
|
|
|
;; Author: Juan Pechiar
|
2020-10-28 04:59:13 -04:00
|
|
|
;; Maintainer: Justin Abrahms
|
2010-07-05 21:43:55 -04:00
|
|
|
;; Keywords: literate programming, reproducible research
|
2018-01-16 11:22:00 -05:00
|
|
|
;; Homepage: https://orgmode.org
|
2010-07-05 21:43:55 -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-05 21:43:55 -04:00
|
|
|
|
|
|
|
;;; Commentary:
|
|
|
|
;;
|
|
|
|
;; This software provides EMACS org-babel export support for message
|
2012-08-11 13:10:44 -04:00
|
|
|
;; sequence charts. The mscgen utility is used for processing the
|
2010-07-05 21:43:55 -04:00
|
|
|
;; sequence definition, and must therefore be installed in the system.
|
|
|
|
;;
|
2010-07-05 22:03:25 -04:00
|
|
|
;; Mscgen is available and documented at
|
2021-03-21 14:55:14 -04:00
|
|
|
;; https://www.mcternan.me.uk/mscgen/index.html
|
2010-07-05 21:43:55 -04:00
|
|
|
;;
|
|
|
|
;; This code is directly inspired by Eric Schulte's ob-dot.el
|
|
|
|
;;
|
|
|
|
;; Example:
|
|
|
|
;;
|
|
|
|
;; #+begin_src mscgen :file example.png
|
|
|
|
;; msc {
|
|
|
|
;; A,B;
|
|
|
|
;; A -> B [ label = "send message" ];
|
|
|
|
;; A <- B [ label = "get answer" ];
|
|
|
|
;; }
|
|
|
|
;; #+end_src
|
|
|
|
;;
|
|
|
|
;; Header for alternative file type:
|
|
|
|
;;
|
|
|
|
;; #+begin_src mscgen :file ex2.svg :filetype svg
|
|
|
|
|
|
|
|
;; This differs from most standard languages in that
|
|
|
|
;;
|
|
|
|
;; 1) there is no such thing as a "session" in mscgen
|
|
|
|
;; 2) we are generally only going to return results of type "file"
|
|
|
|
;; 3) we are adding the "file" and "filetype" header arguments
|
|
|
|
;; 4) there are no variables
|
|
|
|
|
|
|
|
;;; Code:
|
|
|
|
(require 'ob)
|
|
|
|
|
|
|
|
(defvar org-babel-default-header-args:mscgen
|
|
|
|
'((:results . "file") (:exports . "results"))
|
|
|
|
"Default arguments to use when evaluating a mscgen source block.")
|
|
|
|
|
|
|
|
(defun org-babel-execute:mscgen (body params)
|
2010-07-13 19:20:08 -04:00
|
|
|
"Execute a block of Mscgen code with Babel.
|
|
|
|
This function is called by `org-babel-execute-src-block'.
|
2012-08-11 13:10:44 -04:00
|
|
|
Default filetype is png. Modify by setting :filetype parameter to
|
2010-07-13 19:20:08 -04:00
|
|
|
mscgen supported formats."
|
2016-09-22 13:45:15 -04:00
|
|
|
(let* ((out-file (or (cdr (assq :file params)) "output.png" ))
|
|
|
|
(filetype (or (cdr (assq :filetype params)) "png" )))
|
|
|
|
(unless (cdr (assq :file params))
|
2020-02-18 16:57:37 -05:00
|
|
|
(error "ERROR: no output file specified. Add \":file name.png\" to the src header"))
|
2010-07-05 22:03:25 -04:00
|
|
|
(org-babel-eval (concat "mscgen -T " filetype " -o " out-file) body)
|
2010-12-21 05:21:28 -05:00
|
|
|
nil)) ;; signal that output has already been written to file
|
2010-07-05 21:43:55 -04:00
|
|
|
|
2015-10-25 20:56:00 -04:00
|
|
|
(defun org-babel-prep-session:mscgen (_session _params)
|
2010-07-13 19:20:08 -04:00
|
|
|
"Raise an error because Mscgen doesn't support sessions."
|
2010-07-05 21:43:55 -04:00
|
|
|
(error "Mscgen does not support sessions"))
|
|
|
|
|
|
|
|
(provide 'ob-mscgen)
|
|
|
|
|
2021-04-19 06:21:01 -04:00
|
|
|
;;; ob-mscgen.el ends here
|