Created
September 13, 2023 04:02
-
-
Save ryjm/d4a1efa462feba5851ce880bc320999c to your computer and use it in GitHub Desktop.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| ;;; ob-hoon.el --- org-babel functions for hoon evaluation | |
| ;; Copyright (C) your name here | |
| ;; Author: your name here | |
| ;; Keywords: literate programming, reproducible research | |
| ;; Homepage: https://orgmode.org | |
| ;; Version: 0.01 | |
| ;; This program 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, or (at your option) | |
| ;; any later version. | |
| ;; | |
| ;; This program 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 | |
| ;; along with GNU Emacs; see the file COPYING. If not, write to the | |
| ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, | |
| ;; Boston, MA 02110-1301, USA. | |
| ;;; Commentary: | |
| ;; This file is not intended to ever be loaded by org-babel, rather it is a | |
| ;; hoon for use in adding new language support to Org-babel. Good first | |
| ;; steps are to copy this file to a file named by the language you are adding, | |
| ;; and then use `query-replace' to replace all strings of "hoon" in this | |
| ;; file with the name of your new language. | |
| ;; After the `query-replace' step, it is recommended to load the file and | |
| ;; register it to org-babel either via the customize menu, or by evaluating the | |
| ;; line: (add-to-list 'org-babel-load-languages '(hoon . t)) where | |
| ;; `hoon' should have been replaced by the name of the language you are | |
| ;; implementing (note that this applies to all occurrences of 'hoon' in this | |
| ;; file). | |
| ;; After that continue by creating a simple code block that looks like e.g. | |
| ;; | |
| ;; #+begin_src hoon | |
| ;; test | |
| ;; #+end_src | |
| ;; Finally you can use `edebug' to instrumentalize | |
| ;; `org-babel-expand-body:hoon' and continue to evaluate the code block. You | |
| ;; try to add header keywords and change the body of the code block and | |
| ;; reevaluate the code block to observe how things get handled. | |
| ;; | |
| ;; If you have questions as to any of the portions of the file defined | |
| ;; below please look to existing language support for guidance. | |
| ;; | |
| ;; If you are planning on adding a language to org-babel we would ask | |
| ;; that if possible you fill out the FSF copyright assignment form | |
| ;; available at https://orgmode.org/request-assign-future.txt as this | |
| ;; will make it possible to include your language support in the core | |
| ;; of Org-mode, otherwise unassigned language support files can still | |
| ;; be included in the contrib/ directory of the Org-mode repository. | |
| ;;; Requirements: | |
| ;; Use this section to list the requirements of this language. Most | |
| ;; languages will require that at least the language be installed on | |
| ;; the user's system, and the Emacs major mode relevant to the | |
| ;; language be installed as well. | |
| ;;; Code: | |
| (require 'ob) | |
| (require 'ob-ref) | |
| (require 'ob-comint) | |
| (require 'ob-eval) | |
| ;; possibly require modes required for your language | |
| ;; optionally define a file extension for this language | |
| (add-to-list 'org-babel-tangle-lang-exts '("hoon" . "tmp")) | |
| ;; optionally declare default header arguments for this language | |
| (defvar org-babel-default-header-args:hoon '()) | |
| ;; This function expands the body of a source code block by doing things like | |
| ;; prepending argument definitions to the body, it should be called by the | |
| ;; `org-babel-execute:hoon' function below. Variables get concatenated in | |
| ;; the `mapconcat' form, therefore to change the formatting you can edit the | |
| ;; `format' form. | |
| (defun org-babel-expand-body:hoon (body params &optional processed-params) | |
| "Expand BODY according to PARAMS, return the expanded body." | |
| ;; (require 'inf-hoon nil t)- | |
| (let ((vars (org-babel-variable-assignments:hoon (or processed-params (org-babel-process-params params))))) | |
| ;; (concat | |
| ;; (mapconcat ;; define any variables | |
| ;; (lambda (pair) | |
| ;; (format "%s=%S" | |
| ;; (car pair) (org-babel-hoon-var-to-hoon (cdr pair)))) | |
| ;; vars "\n") | |
| ;; "\n" body "\n") | |
| (org-babel-expand-body:generic body params vars))) | |
| ;; This is the main function which is called to evaluate a code | |
| ;; block. | |
| ;; | |
| ;; This function will evaluate the body of the source code and | |
| ;; return the results as emacs-lisp depending on the value of the | |
| ;; :results header argument | |
| ;; - output means that the output to STDOUT will be captured and | |
| ;; returned | |
| ;; - value means that the value of the last statement in the | |
| ;; source code block will be returned | |
| ;; | |
| ;; The most common first step in this function is the expansion of the | |
| ;; PARAMS argument using `org-babel-process-params'. | |
| ;; | |
| ;; Please feel free to not implement options which aren't appropriate | |
| ;; for your language (e.g. not all languages support interactive | |
| ;; "session" evaluation). Also you are free to define any new header | |
| ;; arguments which you feel may be useful -- all header arguments | |
| ;; specified by the user will be available in the PARAMS variable. | |
| (defun org-babel-execute:hoon (body params) | |
| "Execute a block of Hoon code with org-babel. | |
| This function is called by `org-babel-execute-src-block'" | |
| (message "executing Hoon source code block") | |
| (let* ((processed-params (org-babel-process-params params)) | |
| ;; set the session if the value of the session keyword is not the | |
| ;; string `none' | |
| (session (cdr (assq :session params))) | |
| ;; variables assigned for use in the block | |
| (vars (org-babel--get-vars processed-params)) | |
| (result-params (assq :result-params processed-params)) | |
| ;; either OUTPUT or VALUE which should behave as described above | |
| (result-type (assq :result-type processed-params)) | |
| ;; expand the body with `org-babel-expand-body:hoon' | |
| (full-body (org-babel-expand-body:hoon | |
| body params processed-params))) | |
| (print session) | |
| (print processed-params) | |
| (ob-hoon-send-to-tmux full-body session) | |
| )) | |
| (defun ob-hoon-send-to-tmux (command target) | |
| (interactive) | |
| (ob-hoon-run-tmux-command | |
| command | |
| target)) | |
| (defun ob-hoon-run-tmux-command (command target) | |
| "Send command to target-session of tmux" | |
| (emamux:check-tmux-running) | |
| (condition-case nil | |
| (progn | |
| (when (and (not target) (or current-prefix-arg (not (emamux:set-parameters-p)))) | |
| (emamux:set-parameters)) | |
| (let* ((target target) | |
| (prompt (format "Command [Send to (%s)]: " target)) | |
| (input (or command (emamux:read-command prompt t)))) | |
| (emamux:send-keys input target))) | |
| (quit (emamux:unset-parameters)))) | |
| (defun org-babel-variable-assignments:hoon (params) | |
| "Return list of hoon statements assigning the block's variables." | |
| (mapcar (lambda (pair) | |
| (format "=%s %s" | |
| (car pair) | |
| (org-babel-hoon-var-to-hoon (cdr pair)))) | |
| (org-babel--get-vars params))) | |
| ;; actually execute the source-code block either in a session or | |
| ;; possibly by dropping it to a temporary file and evaluating the | |
| ;; file. | |
| ;; | |
| ;; for session based evaluation the functions defined in | |
| ;; `org-babel-comint' will probably be helpful. | |
| ;; | |
| ;; for external evaluation the functions defined in | |
| ;; `org-babel-eval' will probably be helpful. | |
| ;; | |
| ;; when forming a shell command, or a fragment of code in some | |
| ;; other language, please preprocess any file names involved with | |
| ;; the function `org-babel-process-file-name'. (See the way that | |
| ;; function is used in the language files) | |
| (defun org-babel-load-session:hoon (session body params) | |
| "Load BODY into SESSION." | |
| (save-window-excursion | |
| (let* ((buffer (org-babel-prep-session:hoon session params))) | |
| (with-temp-buffer | |
| (insert body)) | |
| buffer))) | |
| ;; This function should be used to assign any variables in params in | |
| ;; the context of the session environment. | |
| (defun org-babel-prep-session:hoon (session params) | |
| "Prepare SESSION according to the header arguments specified in PARAMS." | |
| (save-window-excursion | |
| (let ((buffer (org-babel-hoon-initiate-session session))) | |
| (with-current-buffer buffer | |
| (goto-char (point-min)) | |
| (mapc (lambda (line) | |
| (let ( | |
| (bline (buffer-substring (bol) (eol)))) | |
| (if (s-equals? bline line) | |
| (forward-line 1) | |
| (ob-hoon-run-tmux-command line session) | |
| (newline) | |
| (insert line) | |
| (newline)))) | |
| (org-babel-variable-assignments:hoon params)) | |
| (current-buffer))))) | |
| (defun org-babel-hoon-var-to-hoon (var) | |
| "Convert an elisp var into a string of hoon source code | |
| specifying a var of the same value." | |
| (format "%s" var)) | |
| (defun org-babel-hoon-table-or-string (results) | |
| "If the results look like a table, then convert them into an | |
| Emacs-lisp table, otherwise return the results as a string.") | |
| (defun org-babel-hoon-initiate-session (&optional session info) | |
| "If there is not a current inferior-process-buffer in SESSION then create. | |
| Return the initialized session." | |
| (unless (string= session "none") | |
| (get-buffer-create "*hoon-session*") | |
| )) | |
| (provide 'ob-hoon) | |
| ;;; ob-hoon.el ends here |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment