emacs-ipython-notebook/lisp/ein-cell.el
Takafumi Arakaki b12b91da7a Add ein:slice-image
This is a workaround for issue #94.
2013-06-05 01:43:49 +02:00

1079 lines
40 KiB
EmacsLisp
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

;;; ein-cell.el --- Cell module
;; Copyright (C) 2012- Takafumi Arakaki
;; Author: Takafumi Arakaki <aka.tkf at gmail.com>
;; This file is NOT part of GNU Emacs.
;; ein-cell.el 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.
;; ein-cell.el 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 ein-cell.el. If not, see <http://www.gnu.org/licenses/>.
;;; Commentary:
;; Implementation note. Current implementation of cell has redundant
;; and not-guaranteed-to-be consistent information: `element' and
;; `ein:$node'. This part must be moved to ein-node.el module to
;; make it well capsuled.
;; IPython has cell.js, codecell.js and textcell.js.
;; But let's start with one file.
;;; Code:
(eval-when-compile (require 'cl))
(require 'eieio)
(require 'ansi-color)
(require 'comint)
(require 'ein-core)
(require 'ein-log)
(require 'ein-node)
(require 'ein-kernel)
(require 'ein-output-area)
;;; Faces
(defface ein:cell-input-prompt
'((t :inherit header-line))
"Face for cell input prompt"
:group 'ein)
(defface ein:cell-input-area
'((((class color) (background light))
:background "honeydew1")
(((class color) (background dark))
:background "#383838"))
"Face for cell input area"
:group 'ein)
(defface ein:cell-heading-1
'((t :height 1.1 :inherit ein:cell-heading-2))
"Face for level 1 heading."
:group 'ein)
(defface ein:cell-heading-2
'((t :height 1.1 :inherit ein:cell-heading-3))
"Face for level 2 heading."
:group 'ein)
(defface ein:cell-heading-3
'((t :height 1.1 :inherit ein:cell-heading-4))
"Face for level 3 heading."
:group 'ein)
(defface ein:cell-heading-4
'((t :height 1.1 :inherit ein:cell-heading-5))
"Face for level 4 heading."
:group 'ein)
(defface ein:cell-heading-5
'((t :height 1.1 :inherit ein:cell-heading-6))
"Face for level 5 heading."
:group 'ein)
(defface ein:cell-heading-6
'((t :weight bold :inherit (variable-pitch ein:cell-input-area)))
"Face for level 6 heading."
:group 'ein)
(defface ein:cell-output-prompt
'((t :inherit header-line))
"Face for cell output prompt"
:group 'ein)
(defface ein:cell-output-stderr
'((((class color) (background light))
:background "PeachPuff")
(((class color) (background dark))
:background "#8c5353"))
"Face for stderr cell output"
:group 'ein)
(defface ein:pos-tip-face
'((t (:inherit 'popup-tip-face)))
"Face for tooltip when using pos-tip backend."
:group 'ein)
;;; Customization
(defcustom ein:cell-traceback-level 1
"Number of traceback stack to show.
Hidden tracebacks are not discarded. You can always view them
using the command `ein:notebook-view-traceback'."
:type '(choice (integer :tag "Number of stack to show" 1)
(const :tag "Show all traceback" nil))
:group 'ein)
(defcustom ein:cell-max-num-outputs nil
"Number of maximum outputs to be shown by default.
To view full output, use `ein:notebook-show-in-shared-output'."
:type '(choice (integer :tag "Number of outputs to show" 5)
(const :tag "Show all traceback" nil))
:group 'ein)
(defcustom ein:cell-autoexec-prompt ""
"String shown in the cell prompt when the auto-execution flag
is on. See also `ein:connect-aotoexec-lighter'."
:type 'string
:group 'ein)
(defcustom ein:slice-image nil
"[EXPERIMENTAL] When non-`nil', use `insert-sliced-image' when
drawing images. If it is of the form of ``(ROWS COLS)``, it is
passed to the corresponding arguments of `insert-sliced-image'.
.. FIXME: ROWS and COLS must be determined dynamically by measuring
the size of iamge and Emacs window.
See also: https://github.com/tkf/emacs-ipython-notebook/issues/94"
:type 'boolean
:group 'ein)
;;; EIEIO related utils
(defmacro ein:oset-if-empty (obj slot value)
`(unless (and (slot-boundp ,obj ,slot) (oref ,obj ,slot))
(oset ,obj ,slot ,value)))
(defmacro ein:oref-safe (obj slot)
`(when (slot-boundp ,obj ,slot)
(oref ,obj ,slot)))
;;; Utils
(defun ein:insert-image (&rest args)
(let ((img (apply #'create-image args)))
(if ein:slice-image
(destructuring-bind (&optional rows cols)
(when (listp ein:slice-image) ein:slice-image)
(insert-sliced-image img nil nil (or rows 20) cols))
(insert-image img))))
;;; Cell classes
(defclass ein:basecell ()
((cell-type :initarg :cell-type :type string)
(read-only :initarg :read-only :initform nil :type boolean)
(ewoc :initarg :ewoc :type ewoc)
(element :initarg :element :initform nil :type list
:documentation "ewoc nodes")
(element-names :initarg :element-names)
(input :initarg :input :type string
:documentation "Place to hold data until it is rendered via `ewoc'.")
(outputs :initarg :outputs :initform nil :type list)
(events :initarg :events :type ein:events)
(cell-id :initarg :cell-id :initform (ein:utils-uuid) :type string))
"Notebook cell base class")
(defclass ein:codecell (ein:basecell)
((cell-type :initarg :cell-type :initform "code")
(kernel :initarg :kernel :type ein:$kernel)
(element-names :initform (:prompt :input :output :footer))
(input-prompt-number :initarg :input-prompt-number
:documentation "\
Integer or \"*\" (running state).
Implementation note:
Typed `:input-prompt-number' becomes a problem when reading a
notebook that saved "*". So don't add `:type'!")
(collapsed :initarg :collapsed :initform nil :type boolean)
(running :initarg :running :initform nil :type boolean)
(dynamic :initarg :dynamic :initform nil :type boolean
:documentation "\
Whether cell output is evaluated dynamically or not.
Only Emacs lisp type output data will be affected by this
slot (Javascript will not be evaluated). This value must be set
to `t' when executing cell. See `ein:notebook-execute-cell'.
In the implantation of IPython web client it is passed around via
argument, but since it is difficult to pass argument to EWOC
pretty printer, `ein:codecell' instance holds this setting in a
slot.")
(autoexec :initarg :autoexec :initform nil :type boolean
:documentation "Auto-execution flag.
This cell is executed when the connected buffer is saved,
provided that (1) this flag is `t' and (2) corresponding
auto-execution mode flag in the connected buffer is `t'.")))
(defclass ein:textcell (ein:basecell)
((cell-type :initarg :cell-type :initform "text")
(element-names :initform (:prompt :input :footer))))
(defclass ein:htmlcell (ein:textcell)
((cell-type :initarg :cell-type :initform "html")))
(defclass ein:markdowncell (ein:textcell)
((cell-type :initarg :cell-type :initform "markdown")))
(defclass ein:rawcell (ein:textcell)
((cell-type :initarg :cell-type :initform "raw")))
(defclass ein:headingcell (ein:textcell)
((cell-type :initarg :cell-type :initform "heading")
(level :initarg :level :initform 1)))
;;; Cell factory
(defun ein:cell-class-from-type (type)
(ein:case-equal type
(("code") 'ein:codecell)
(("text") 'ein:textcell)
(("html") 'ein:htmlcell)
(("markdown") 'ein:markdowncell)
(("raw") 'ein:rawcell)
(("heading") 'ein:headingcell)
;; Defined in ein-shared-output.el:
(("shared-output") 'ein:shared-output-cell)
(t (error "No cell type called %S" type))))
(defun ein:cell-from-type (type &rest args)
(apply (ein:cell-class-from-type type) "Cell" args))
(defun ein:cell-from-json (data &rest args)
(ein:cell-init (apply #'ein:cell-from-type
(plist-get data :cell_type) args) data))
(defmethod ein:cell-init ((cell ein:codecell) data)
(ein:oset-if-empty cell :outputs (plist-get data :outputs))
(ein:oset-if-empty cell :input (plist-get data :input))
(ein:aif (plist-get data :prompt_number)
(ein:oset-if-empty cell :input-prompt-number it))
(ein:oset-if-empty cell :collapsed
(let ((v (plist-get data :collapsed)))
(if (eql v json-false) nil v)))
cell)
(defmethod ein:cell-init ((cell ein:textcell) data)
(ein:aif (plist-get data :source)
(oset cell :input it))
cell)
(defmethod ein:cell-init ((cell ein:headingcell) data)
(call-next-method)
(ein:aif (plist-get data :level)
(oset cell :level it))
cell)
(defmethod ein:cell-convert ((cell ein:basecell) type)
(let ((new (ein:cell-from-type type)))
;; copy attributes
(loop for k in '(:read-only :ewoc)
do (set-slot-value new k (slot-value cell k)))
;; copy input
(oset new :input (if (ein:cell-active-p cell)
(ein:cell-get-text cell)
(oref cell :input)))
;; copy output when the new cell has it
(when (memq :output (oref new :element-names))
(oset new :outputs (mapcar 'identity (oref cell :outputs))))
new))
(defmethod ein:cell-convert ((cell ein:codecell) type)
(let ((new (call-next-method)))
(when (and (ein:codecell-child-p new)
(slot-boundp cell :kernel))
(oset new :kernel (oref cell :kernel)))
new))
(defmethod ein:cell-convert ((cell ein:headingcell) type)
(let ((new (call-next-method)))
(when (ein:headingcell-p new)
(oset new :level (oref cell :level)))
new))
(defmethod ein:cell-copy ((cell ein:basecell))
(ein:cell-convert cell (oref cell :cell-type)))
(defmethod ein:cell-convert-inplace ((cell ein:basecell) type)
"Convert CELL to TYPE and redraw corresponding ewoc nodes."
(let ((new (ein:cell-convert cell type)))
;; copy element attribute
(loop for k in (oref new :element-names)
with old-element = (oref cell :element)
do (oset new :element
(plist-put (oref new :element) k
(plist-get old-element k))))
;; setting ewoc nodes
(loop for en in (ein:cell-all-element cell)
for node = (ewoc-data en)
do (setf (ein:$node-data node) new))
(let ((inhibit-read-only t)
(buffer-undo-list t)) ; disable undo recording
;; delete ewoc nodes that is not copied
(apply
#'ewoc-delete (oref new :ewoc)
(apply
#'append
(loop for name in (oref cell :element-names)
unless (memq name (oref new :element-names))
collect (let ((ens (ein:cell-element-get cell name)))
(if (listp ens) ens (list ens))))))
;; draw ewoc node
(loop with ewoc = (oref new :ewoc)
for en in (ein:cell-all-element new)
do (ewoc-invalidate ewoc en)))
new))
(defmethod ein:cell-change-level ((cell ein:headingcell) level)
(assert (integerp level))
(let ((inhibit-read-only t)
(buffer-undo-list t)) ; disable undo recording
(oset cell :level level)
;; draw ewoc node
(loop with ewoc = (oref cell :ewoc)
for en in (ein:cell-all-element cell)
do (ewoc-invalidate ewoc en))))
;;; Getter/setter
(defmethod ein:cell-num-outputs ((cell ein:codecell))
(length (oref cell :outputs)))
(defmethod ein:cell-num-outputs ((cell ein:textcell))
0)
(defmethod ein:cell-element-get ((cell ein:basecell) prop &rest args)
"Return ewoc node named PROP in CELL.
If PROP is `:output' a list of ewoc nodes is returned.
A specific node can be specified using optional ARGS."
(if (memq prop (oref cell :element-names))
(plist-get (oref cell :element) prop)
(error "PROP %s is not supported." prop)))
(defmethod ein:cell-element-get ((cell ein:codecell) prop &optional index)
(let ((element (oref cell :element)))
(if index
(progn
(assert (eql prop :output))
(nth index (plist-get element prop)))
(case prop
(:after-input
(ein:aif (nth 0 (plist-get element :output))
it
(plist-get element :footer)))
(:after-output (plist-get element :footer))
(:before-input (plist-get element :prompt))
(:before-output (plist-get element :input))
(:last-output
(ein:aif (plist-get element :output)
(car (last it))
(plist-get element :input)))
(t (call-next-method))))))
(defmethod ein:cell-element-get ((cell ein:textcell) prop)
(let ((element (oref cell :element)))
(case prop
(:after-input (plist-get element :footer))
(:before-input (plist-get element :prompt))
(t (call-next-method)))))
(defmethod ein:cell-all-element ((cell ein:basecell))
(list (ein:cell-element-get cell :prompt)
(ein:cell-element-get cell :input)
(ein:cell-element-get cell :footer)))
(defmethod ein:cell-all-element ((cell ein:codecell))
(append (call-next-method)
(ein:cell-element-get cell :output)))
(defmethod ein:cell-language ((cell ein:basecell))
"Programming language used for CELL.
Return language name as a string or `nil' when not defined.
\(fn cell)")
(defmethod ein:cell-language ((cell ein:codecell)) nil "python")
(defmethod ein:cell-language ((cell ein:markdowncell)) nil "markdown")
(defmethod ein:cell-language ((cell ein:htmlcell)) nil "html")
(defmethod ein:cell-language ((cell ein:rawcell)) nil "rst")
;; EWOC
(defun ein:cell-make-element (make-node num-outputs)
(let ((buffer-undo-list t)) ; disable undo recording
(list
:prompt (funcall make-node 'prompt)
:input (funcall make-node 'input)
:output (loop for i from 0 below num-outputs
collect (funcall make-node 'output i))
:footer (funcall make-node 'footer))))
(defmethod ein:cell-enter-last ((cell ein:basecell))
(let* ((ewoc (oref cell :ewoc))
;; Use `cell' as data for ewoc. Use the whole cell data even
;; if it is not used, to access it from the notebook buffer.
;; It is equivalent to `this.element.data("cell", this)' in
;; IPython.Cell (see cell.js).
(make-node
(lambda (&rest path)
(ewoc-enter-last ewoc (ein:node-new `(cell ,@path) cell))))
(element (ein:cell-make-element make-node
(ein:cell-num-outputs cell))))
(oset cell :element element)
cell))
(defmethod ein:cell-enter-first ((cell ein:basecell))
(let* ((ewoc (oref cell :ewoc))
(node nil)
(make-node
(lambda (&rest path)
(let ((ewoc-data (ein:node-new `(cell ,@path) cell)))
(setq node
(if node
(ewoc-enter-after ewoc node ewoc-data)
(ewoc-enter-first ewoc ewoc-data))))))
(element (ein:cell-make-element make-node
(ein:cell-num-outputs cell))))
(oset cell :element element)
cell))
(defmethod ein:cell-insert-below ((base-cell ein:basecell) other-cell)
(let* ((ewoc (oref base-cell :ewoc))
(node (ein:cell-element-get base-cell :footer))
(make-node
(lambda (&rest path)
(setq node (ewoc-enter-after
ewoc node (ein:node-new `(cell ,@path) other-cell)))))
(element (ein:cell-make-element make-node
(ein:cell-num-outputs other-cell))))
(oset other-cell :element element)
other-cell))
(defun ein:cell-pp (path data)
(case (car path)
(prompt (ein:cell-insert-prompt data))
(input (ein:cell-insert-input data))
(output (ein:cell-insert-output (cadr path) data))
(footer (ein:cell-insert-footer data))))
(defmethod ein:cell-insert-prompt ((cell ein:codecell))
"Insert prompt of the CELL in the buffer.
Called from ewoc pretty printer via `ein:cell-pp'."
;; Newline is inserted in `ein:cell-insert-input'.
(ein:insert-read-only
(concat
(format "In [%s]:" (or (ein:oref-safe cell :input-prompt-number) " "))
(when (oref cell :autoexec) " %s" ein:cell-autoexec-prompt))
'font-lock-face 'ein:cell-input-prompt))
(defmethod ein:cell-insert-prompt ((cell ein:textcell))
(ein:insert-read-only
(format "%s:" (oref cell :cell-type))
'font-lock-face 'ein:cell-input-prompt))
(defmethod ein:cell-insert-prompt ((cell ein:headingcell))
(ein:insert-read-only
(format "h%s:" (oref cell :level))
'font-lock-face 'ein:cell-input-prompt))
(defmethod ein:cell-insert-input ((cell ein:basecell))
"Insert input of the CELL in the buffer.
Called from ewoc pretty printer via `ein:cell-pp'."
(let ((start (1+ (point))))
;; Newlines must allow insertion before/after its position.
(insert (propertize "\n" 'read-only t 'rear-nonsticky t)
(or (ein:oref-safe cell :input) "")
(propertize "\n" 'read-only t))
;; Highlight background using overlay.
(let ((ol (make-overlay start (point))))
(overlay-put ol 'face (ein:cell-get-input-area-face cell))
;; `evaporate' = `t': Overlay is deleted when the region become empty.
(overlay-put ol 'evaporate t))))
(defmethod ein:cell-get-input-area-face ((cell ein:basecell))
"Return the face (symbol) for input area."
'ein:cell-input-area)
(defmethod ein:cell-get-input-area-face ((cell ein:headingcell))
(intern (format "ein:cell-heading-%d" (oref cell :level))))
(defun ein:cell-insert-output (index cell)
"Insert INDEX-th output of the CELL in the buffer.
Called from ewoc pretty printer via `ein:cell-pp'."
(if (or (oref cell :collapsed)
(and ein:cell-max-num-outputs
(>= index ein:cell-max-num-outputs)))
(progn
(when (and (not (oref cell :collapsed))
(= index ein:cell-max-num-outputs)
(> (point) (point-at-bol)))
;; The first output which exceeds `ein:cell-max-num-outputs'.
(ein:insert-read-only "\n"))
(ein:insert-read-only "."))
(let ((out (nth index (oref cell :outputs))))
;; Handle newline for previous stream output.
;; In IPython JS, it is handled in `append_stream' because JS
;; does not need to care about newline (DOM does it for JS).
;; FIXME: Maybe I should abstract ewoc in some way and get rid
;; of this.
(let ((last-out (and (> index 0)
(nth (1- index) (oref cell :outputs)))))
;; If previous output is stream type, consider adding newline
(when (and last-out
(equal (plist-get last-out :output_type) "stream"))
;; Check if the last output is from the same stream.
;; If so, do *NOT* insert newline, otherwise insert newline.
(unless (and (equal (plist-get out :output_type) "stream")
(equal (plist-get out :stream)
(plist-get last-out :stream)))
(ein:cell-append-stream-text-fontified "\n" last-out))))
;; Finally insert real data
(ein:case-equal (plist-get out :output_type)
(("pyout") (ein:cell-append-pyout cell out))
(("pyerr") (ein:cell-append-pyerr cell out))
(("display_data") (ein:cell-append-display-data cell out))
(("stream") (ein:cell-append-stream cell out))))))
(defmethod ein:cell-insert-footer ((cell ein:basecell))
"Insert footer (just a new line) of the CELL in the buffer.
Called from ewoc pretty printer via `ein:cell-pp'."
(ein:insert-read-only "\n"))
(defmethod ein:cell-insert-footer ((cell ein:codecell))
(if (or (oref cell :collapsed)
(and ein:cell-max-num-outputs
(> (ein:cell-num-outputs cell) ein:cell-max-num-outputs)))
;; Add a newline after the last ".".
(ein:insert-read-only "\n")
(let ((last-out (car (last (oref cell :outputs)))))
(when (equal (plist-get last-out :output_type) "stream")
(ein:cell-append-stream-text-fontified "\n" last-out))))
(call-next-method))
(defun ein:cell-node-p (node &optional element-name)
(let* ((path (ein:$node-path node))
(p0 (car path))
(p1 (cadr path))
(cell (ein:$node-path node)))
(and cell (eql p0 'cell) (or (not element-name) (eql p1 element-name)))))
(defun ein:cell-ewoc-node-p (ewoc-node &optional element-name)
(ein:cell-node-p (ewoc-data ewoc-node) element-name))
(defun ein:cell-from-ewoc-node (ewoc-node)
(ein:aand ewoc-node (ewoc-data it) (ein:$node-data it)))
(defmethod ein:cell-input-pos-min ((cell ein:basecell))
"Return editable minimum point in the input area of the CELL.
If the input area of the CELL does not exist, return `nil'"
(let* ((input-node (ein:cell-element-get cell :input)))
;; 1+ for skipping newline
(when input-node (1+ (ewoc-location input-node)))))
(defmethod ein:cell-input-pos-max ((cell ein:basecell))
"Return editable maximum point in the input area of the CELL.
If the input area of the CELL does not exist, return `nil'"
(let* ((ewoc (oref cell :ewoc))
(input-node (ein:cell-element-get cell :input)))
;; 1- for skipping newline
(when input-node (1- (ewoc-location (ewoc-next ewoc input-node))))))
(defmethod ein:cell-get-text ((cell ein:basecell))
"Grab text in the input area of the cell at point."
(if (ein:cell-active-p cell)
(let* ((beg (ein:cell-input-pos-min cell))
(end (ein:cell-input-pos-max cell)))
(buffer-substring beg end))
(oref cell :input)))
(defmethod ein:cell-set-text ((cell ein:basecell) text)
(let* ((input-node (ein:cell-element-get cell :input))
(ewoc (oref cell :ewoc))
;; 1+/1- is for skipping newline
(beg (1+ (ewoc-location input-node)))
(end (1- (ewoc-location (ewoc-next ewoc input-node)))))
(save-excursion
;; probably it is better to set :input and update via ewoc?
(goto-char beg)
(delete-region beg end)
(insert text))))
(defmethod ein:cell-save-text ((cell ein:basecell))
(oset cell :input (ein:cell-get-text cell)))
(defmethod ein:cell-deactivate ((cell ein:basecell))
(oset cell :element nil)
cell)
(defmethod ein:cell-active-p ((cell ein:basecell))
(oref cell :element))
(defmethod ein:cell-running-set ((cell ein:codecell) running)
;; FIXME: change the appearance of the cell
(oset cell :running running))
(defmethod ein:cell-set-collapsed ((cell ein:codecell) collapsed)
"Set `:collapsed' slot of CELL and invalidate output ewoc nodes."
(unless (eq (oref cell :collapsed) collapsed)
(oset cell :collapsed collapsed)
(apply #'ewoc-invalidate
(oref cell :ewoc)
(ein:cell-element-get cell :output))))
(defmethod ein:cell-collapse ((cell ein:codecell))
(ein:cell-set-collapsed cell t))
(defmethod ein:cell-expand ((cell ein:codecell))
(ein:cell-set-collapsed cell nil))
(defmethod ein:cell-toggle-output ((cell ein:codecell))
"Toggle `:collapsed' slot of CELL and invalidate output ewoc nodes."
(ein:cell-set-collapsed cell (not (oref cell :collapsed))))
(defmethod ein:cell-invalidate-prompt ((cell ein:codecell))
(let ((inhibit-read-only t)
(buffer-undo-list t)) ; disable undo recording
(ewoc-invalidate (oref cell :ewoc)
(ein:cell-element-get cell :prompt))))
(defmethod ein:cell-set-input-prompt ((cell ein:codecell) &optional number)
(oset cell :input-prompt-number number)
(ein:cell-invalidate-prompt cell))
(defmethod ein:cell-set-autoexec ((cell ein:codecell) bool)
"Set auto-execution flag of CELL to BOOL and invalidate the
prompt EWOC node."
(oset cell :autoexec bool)
(ein:cell-invalidate-prompt cell))
(defmethod ein:cell-autoexec-p ((cell ein:basecell))
"Auto-execution flag set to CELL.
Return `nil' always for non-code cells."
nil)
(defmethod ein:cell-autoexec-p ((cell ein:codecell))
(oref cell :autoexec))
(defmethod ein:cell-toggle-autoexec ((cell ein:codecell))
"Toggle auto-execution flag of CELL to BOOL and invalidate the
prompt EWOC node."
(ein:cell-set-autoexec cell (not (ein:cell-autoexec-p cell))))
(defmethod ein:cell-goto ((cell ein:basecell) &optional relpos prop)
"Go to the input area of the given CELL.
RELPOS is the position relative to the input area. Default is 0.
PROP is a name of cell element. Default is `:input'.
\(fn cell relpos prop)"
(unless relpos (setq relpos 0))
(unless prop (setq prop :input))
(ewoc-goto-node (oref cell :ewoc) (ein:cell-element-get cell prop))
(let ((offset (case prop
((:input :before-output) 1)
(:after-input -1)
(t 0))))
(forward-char (+ relpos offset))))
(defmethod ein:cell-relative-point ((cell ein:basecell) &optional pos)
"Return the point relative to the input area of CELL.
If the position POS is not given, current point is considered."
(unless pos (setq pos (point)))
(- pos (1+ (ewoc-location (ein:cell-element-get cell :input)))))
(defmethod ein:cell-location ((cell ein:basecell) &optional elm end)
"Return the starting location of CELL.
ELM is a name (keyword) of element that `ein:cell-element-get'
understands. Note that you can't use `:output' since it returns
a list. Use `:after-input' instead.
If END is non-`nil', return the location of next element."
(unless elm (setq elm :prompt))
(let ((element (oref cell :element)))
(when end
(setq elm (case elm
(:prompt :input)
(:input :after-input)
(:output :after-output)))
(unless elm
(setq cell (ein:cell-next cell))
(setq elm :prompt)))
(if cell
(ewoc-location (ein:cell-element-get cell elm))
(assert end)
(point-max))))
(defmethod ein:cell-buffer ((cell ein:basecell))
"Return a buffer associated by CELL (if any)."
(ein:aand (ein:oref-safe cell :ewoc) (ewoc-buffer it)))
;; Data manipulation
(defmethod ein:cell-clear-output ((cell ein:codecell) stdout stderr other)
;; codecell.js in IPytohn implements it using timeout and callback.
;; As it is unclear why timeout is needed, just clear output
;; instantaneously for now.
(ein:log 'debug "cell-clear-output stdout=%s stderr=%s other=%s"
stdout stderr other)
(let ((ewoc (oref cell :ewoc))
(output-nodes (ein:cell-element-get cell :output)))
(if (and stdout stderr other)
(progn
;; clear all
(let ((inhibit-read-only t)
(buffer-undo-list t)) ; disable undo recording
(apply #'ewoc-delete ewoc output-nodes))
(plist-put (oref cell :element) :output nil)
(oset cell :outputs nil))
(let* ((ewoc-node-list
(append
(when stdout (ein:node-filter output-nodes :is 'output-stdout))
(when stderr (ein:node-filter output-nodes :is 'output-stderr))
(when stdout (ein:node-filter output-nodes
:is 'output-subarea
:not 'output-stderr
:not 'output-stdout))))
(indices
(mapcar (lambda (n) (last (ein:$node-path (ewoc-data n))))
ewoc-node-list)))
;; remove from buffer
(let ((inhibit-read-only t)
(buffer-undo-list t)) ; disable undo recording
(apply #'ewoc-delete ewoc ewoc-node-list))
;; remove from `:element'
(let* ((element (oref cell :element))
(old-output (plist-get element :output))
(new-ouptut (ein:remove-by-index old-output indices)))
(plist-put element :output new-ouptut))
;; remove cleared outputs from internal data
(oset cell :outputs
(ein:remove-by-index (oref cell :outputs) indices))))
;; Footer may have extra (possibly colored) newline due to the
;; last output type. So invalidate it here.
;; See `ein:cell-insert-footer' (for codecell).
(ewoc-invalidate ewoc (ein:cell-element-get cell :footer))))
(defun ein:cell-output-json-to-class (json)
(ein:case-equal (plist-get json :output_type)
(("pyout")
'(output-subarea))
(("pyerr")
'(output-subarea))
(("display_data")
'(output-subarea))
(("stream")
(list 'output-stream 'output-subarea
(intern (format "output-%s" (plist-get json :stream)))))))
(defmethod ein:cell-append-output ((cell ein:codecell) json dynamic)
(ein:cell-expand cell)
;; (ein:flush-clear-timeout)
(oset cell :outputs
(append (oref cell :outputs) (list json)))
;; enter last output element
(let* ((inhibit-read-only t)
(buffer-undo-list t) ; disable undo recording
(ewoc (oref cell :ewoc))
(index (1- (ein:cell-num-outputs cell)))
(path `(cell output ,index))
(class (ein:cell-output-json-to-class json))
(data (ein:node-new path cell class))
(last-node (ein:cell-element-get cell :last-output))
(ewoc-node (ewoc-enter-after ewoc last-node data))
(element (oref cell :element)))
(plist-put element :output
(append (plist-get element :output) (list ewoc-node)))
(ewoc-invalidate ewoc (ein:cell-element-get cell :footer))))
(defmethod ein:cell-append-pyout ((cell ein:codecell) json)
"Insert pyout type output in the buffer.
Called from ewoc pretty printer via `ein:cell-insert-output'."
(ein:insert-read-only (format "Out [%s]:"
(or (plist-get json :prompt_number) " "))
'font-lock-face 'ein:cell-output-prompt)
(ein:insert-read-only "\n")
(ein:cell-append-mime-type json (oref cell :dynamic))
(ein:insert-read-only "\n"))
(defmethod ein:cell-append-pyerr ((cell ein:codecell) json)
"Insert pyerr type output in the buffer.
Called from ewoc pretty printer via `ein:cell-insert-output'."
(mapc (lambda (tb)
(ein:cell-append-text tb)
(ein:cell-append-text "\n"))
(let ((tb (plist-get json :traceback))
(level ein:cell-traceback-level))
(if (and level (> (- (length tb) 2) level))
(cons "\nTruncated Traceback (Use C-c C-x to view full TB):"
(last tb (1+ level)))
tb)))
(ein:insert-read-only "\n"))
(ein:deflocal ein:%cell-append-stream-last-cell% nil
"The last cell in which `ein:cell-append-stream' is used.")
(defmethod ein:cell-append-stream ((cell ein:codecell) json)
"Insert stream type output in the buffer.
Called from ewoc pretty printer via `ein:cell-insert-output'."
(unless (plist-get json :stream)
(plist-put json :stream "stdout"))
(unless (eq cell ein:%cell-append-stream-last-cell%)
;; Avoid applying unclosed ANSI escape code in the cell. Note
;; that I don't need to distinguish stdout/stderr because it looks
;; like normal terminal does not.
(setq ansi-color-context nil))
(let ((start (point)))
(ein:cell-append-stream-text-fontified (plist-get json :text) json)
(comint-carriage-motion start (point)))
;; NOTE: newlines for stream is handled in `ein:cell-insert-output'.
;; So do not insert newline here.
(setq ein:%cell-append-stream-last-cell% cell))
(defun ein:cell-append-stream-text-fontified (text json)
"Insert TEXT with font properties defined by JSON data."
(if (equal (plist-get json :stream) "stderr")
(ein:cell-append-text text 'font-lock-face 'ein:cell-output-stderr)
(ein:cell-append-text text)))
(defmethod ein:cell-append-display-data ((cell ein:codecell) json)
"Insert display-data type output in the buffer.
Called from ewoc pretty printer via `ein:cell-insert-output'."
(ein:cell-append-mime-type json (oref cell :dynamic))
(ein:insert-read-only "\n"))
(defcustom ein:output-type-preference
(if (and (fboundp 'shr-insert-document)
(fboundp 'libxml-parse-xml-region))
#'ein:output-type-prefer-pretty-text-over-html
'(emacs-lisp svg png jpeg text html latex javascript))
"Output types to be used in notebook.
First output-type found in this list will be used.
This variable can be a list or a function returning a list given
DATA plist.
See also `ein:output-type-prefer-pretty-text-over-html'.
**Example**:
If you prefer HTML type over text type, you can set it as::
(setq ein:output-type-preference
'(emacs-lisp svg png jpeg html text latex javascript))
Note that ``html`` comes before ``text``."
:group 'ein)
(defun ein:output-type-prefer-pretty-text-over-html (data)
"Use text type if it is a \"prettified\" text instead of HTML.
This is mostly for *not* using HTML table for pandas but using
HTML for other object.
If the text type output contains a newline, it is assumed be a
prettified text thus be used instead of HTML type."
(if (ein:aand (plist-get data :text) (string-match-p "\n" it))
'(emacs-lisp svg png jpeg text html latex javascript)
'(emacs-lisp svg png jpeg html text latex javascript)))
(defun ein:cell-append-mime-type (json dynamic)
(loop
for key in (cond
((functionp ein:output-type-preference)
(funcall ein:output-type-preference json))
(t ein:output-type-preference))
for type = (intern (format ":%s" key)) ; something like `:text'
for value = (plist-get json type) ; FIXME: optimize
when (plist-member json type)
return
(case key
;; NOTE: Normally `javascript' and `html' will not be inserted as
;; they come out after `text'. Maybe it is better to inform user
;; when one of them is inserted.
(javascript
(when dynamic
(ein:log 'info (concat "ein:cell-append-mime-type does not support "
"dynamic javascript. got: %s") value))
(ein:insert-read-only (plist-get json type)))
(emacs-lisp
(when dynamic
(ein:cell-safe-read-eval-insert (plist-get json type))))
(html
(funcall (ein:output-area-get-html-renderer) (plist-get json type)))
((latex text)
(ein:insert-read-only (plist-get json type)))
(svg
(ein:insert-image value key t))
((png jpeg)
(ein:insert-image (base64-decode-string value) key t)))))
(defun ein:cell-append-text (data &rest properties)
;; escape ANSI in plaintext:
(apply #'ein:insert-read-only (ansi-color-apply data) properties))
(defun ein:cell-safe-read-eval-insert (text)
(ein:insert-read-only
(condition-case err
(save-excursion
;; given code can be `pop-to-buffer' or something.
(format "%S" (eval (read text))))
(error
(ein:log 'warn "Got an error while executing: '%s'"
text)
(format "Error: %S" err)))))
(defmethod ein:cell-to-json ((cell ein:codecell) &optional discard-output)
"Return json-ready alist."
`((input . ,(ein:cell-get-text cell))
(cell_type . "code")
,@(ein:aif (ein:oref-safe cell :input-prompt-number)
`((prompt_number . ,it)))
(outputs . ,(if discard-output [] (apply #'vector (oref cell :outputs))))
(language . "python")
(collapsed . ,(if (oref cell :collapsed) t json-false))))
(defmethod ein:cell-to-json ((cell ein:textcell) &optional discard-output)
`((cell_type . ,(oref cell :cell-type))
(source . ,(ein:cell-get-text cell))))
(defmethod ein:cell-to-json ((cell ein:headingcell) &optional discard-output)
(let ((json (call-next-method)))
(append json `((level . ,(oref cell :level))))))
(defmethod ein:cell-next ((cell ein:basecell))
"Return next cell of the given CELL or nil if CELL is the last one."
(ein:aif (ewoc-next (oref cell :ewoc)
(ein:cell-element-get cell :footer))
(let ((cell (ein:$node-data (ewoc-data it))))
(when (ein:basecell-child-p cell)
cell))))
(defmethod ein:cell-prev ((cell ein:basecell))
"Return previous cell of the given CELL or nil if CELL is the first one."
(ein:aif (ewoc-prev (oref cell :ewoc)
(ein:cell-element-get cell :prompt))
(let ((cell (ein:$node-data (ewoc-data it))))
(when (ein:basecell-child-p cell)
cell))))
;;; Kernel related calls.
(defmethod ein:cell-set-kernel ((cell ein:codecell) kernel)
(oset cell :kernel kernel))
(defmethod ein:cell-execute ((cell ein:codecell))
(ein:cell-execute-internal cell
(oref cell :kernel)
(ein:cell-get-text cell)
:silent nil))
(defmethod ein:cell-execute-internal ((cell ein:codecell)
kernel code &rest args)
(ein:cell-clear-output cell t t t)
(ein:cell-set-input-prompt cell "*")
(ein:cell-running-set cell t)
(oset cell :dynamic t)
(apply #'ein:kernel-execute kernel code (ein:cell-make-callbacks cell) args))
(defmethod ein:cell-make-callbacks ((cell ein:codecell))
(list
:execute_reply (cons #'ein:cell--handle-execute-reply cell)
:output (cons #'ein:cell--handle-output cell)
:clear_output (cons #'ein:cell--handle-clear-output cell)
:set_next_input (cons #'ein:cell--handle-set-next-input cell)))
(defmethod ein:cell--handle-execute-reply ((cell ein:codecell) content
-metadata-not-used-)
(ein:cell-set-input-prompt cell (plist-get content :execution_count))
(ein:cell-running-set cell nil)
(let ((events (oref cell :events)))
(ein:events-trigger events 'set_dirty.Worksheet (list :value t :cell cell))
(ein:events-trigger events 'maybe_reset_undo.Worksheet cell)))
(defmethod ein:cell--handle-set-next-input ((cell ein:codecell) text)
(let ((events (oref cell :events)))
(ein:events-trigger events 'set_next_input.Worksheet
(list :cell cell :text text))
(ein:events-trigger events 'maybe_reset_undo.Worksheet cell)))
;;; Output area
;; These function should go to ein-output-area.el. But as cell and
;; EWOC is connected in complicated way, I will leave them in
;; ein-cell.el.
(defmethod ein:cell--handle-output ((cell ein:codecell) msg-type content
-metadata-not-used-)
(let* ((json (list :output_type msg-type)))
(ein:case-equal msg-type
(("stream")
(plist-put json :text (plist-get content :data))
(plist-put json :stream (plist-get content :name)))
(("display_data" "pyout")
(when (equal msg-type "pyout")
(plist-put json :prompt_number (plist-get content :execution_count)))
(setq json (ein:output-area-convert-mime-types
json (plist-get content :data))))
(("pyerr")
(plist-put json :ename (plist-get content :ename))
(plist-put json :evalue (plist-get content :evalue))
(plist-put json :traceback (plist-get content :traceback))))
(ein:cell-append-output cell json t)
;; (oset cell :dirty t)
(ein:events-trigger (oref cell :events) 'maybe_reset_undo.Worksheet cell)))
(defun ein:output-area-convert-mime-types (json data)
(loop for (prop . mime) in '((:text . :text/plain)
(:html . :text/html)
(:svg . :image/svg+xml)
(:png . :image/png)
(:jpeg . :image/jpeg)
(:latex . :text/latex)
(:json . :application/json)
(:javascript . :application/javascript)
(:emacs-lisp . :application/emacs-lisp))
when (plist-member data mime)
do (plist-put json prop (plist-get data mime)))
json)
(defmethod ein:cell--handle-clear-output ((cell ein:codecell) content
-metadata-not-used-)
(ein:cell-clear-output cell
(plist-get content :stdout)
(plist-get content :stderr)
(plist-get content :other))
(ein:events-trigger (oref cell :events) 'maybe_reset_undo.Worksheet cell))
;;; Misc.
(defmethod ein:cell-has-image-ouput-p ((cell ein:codecell))
"Return `t' if given cell has image output, `nil' otherwise."
(loop for out in (oref cell :outputs)
when (or (plist-member out :svg)
(plist-member out :png)
(plist-member out :jpeg))
return t))
(defmethod ein:cell-has-image-ouput-p ((cell ein:textcell))
nil)
(defmethod ein:cell-get-tb-data ((cell ein:codecell))
(loop for out in (oref cell :outputs)
when (equal (plist-get out :output_type) "pyerr")
return (plist-get out :traceback)))
(provide 'ein-cell)
;;; ein-cell.el ends here