A JavaScript development environment for Emacs https://indium.readthedocs.io
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

427 lines
16 KiB

;;; indium-repl.el --- JavaScript REPL connected to a browser tab -*- lexical-binding: t; -*-
;; Copyright (C) 2016-2017 Nicolas Petton
;; Author: Nicolas Petton <nicolas@petton.fr>
;; Keywords: convenience, tools, javascript
;; 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 of the License, 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
;; GNU General Public License for more details.
;; You should have received a copy of the GNU General Public License
;; along with this program. If not, see <http://www.gnu.org/licenses/>.
;;; Commentary:
;; REPL interactions with a browser connection.
;;; Code:
(require 'indium-render)
(require 'indium-faces)
(require 'indium-backend)
(require 'company)
(require 'easymenu)
(require 'map)
(require 'js)
(require 'subr-x)
(require 'ansi-color)
(declare-function indium-workspace-lookup-file-safe "indium-workspace.el")
(declare-function indium-inspector-inspect "indium-inspector.el")
(defgroup indium-repl nil
"Interaction with the REPL."
:prefix "indium-repl-"
:group 'indium)
(defvar indium-repl-evaluate-hook nil
"Hook run when input is evaluated in the repl.")
(defvar indium-repl-switch-from-buffer nil
"The buffer from which repl was activated last time.")
(defvar indium-repl-history nil "History of the REPL inputs.")
(make-variable-buffer-local 'indium-repl-history)
(defvar indium-repl-history-position -1 "Position in the REPL history.")
(make-variable-buffer-local 'indium-repl-history-position)
(defvar-local indium-repl-input-start-marker nil)
(defvar-local indium-repl-output-start-marker nil)
(defvar-local indium-repl-output-end-marker nil)
(defmacro indium-save-marker (marker &rest body)
"Save MARKER and execute BODY."
(declare (indent 1) (debug t))
(let ((pos (make-symbol "pos")))
`(let ((,pos (marker-position ,marker)))
(prog1 (progn . ,body)
(set-marker ,marker ,pos)))))
(defun indium-repl-buffer-create ()
"Return a new REPL buffer."
(let* ((buf (generate-new-buffer (indium-repl-buffer-name))))
(indium-repl-setup-buffer buf)
(defun indium-repl-get-buffer ()
"Return the REPL buffer, or nil."
(get-buffer (indium-repl-buffer-name)))
(defun indium-repl-buffer-name ()
"Return the name of the REPL buffer."
"*JS REPL*")
(defun indium-repl-setup-buffer (buffer)
"Setup the REPL BUFFER."
(with-current-buffer buffer
(indium-repl-emit-console-message `((text . ,(indium-repl--welcome-message))))))
(defun indium-repl--welcome-message ()
"Return the welcome message displayed in new REPL buffers."
"Welcome to Indium!
Connected to %s @ %s
Getting started:
- Press <\\[indium-repl-return]> on links to open an inspector
- Press <\\[indium-repl-previous-input]> and <\\[indium-repl-next-input]> to navigate in the history
- Use <\\[indium-scratch]> to open a scratch buffer for JS evaluation
- Press <\\[describe-mode]> to see a list of available keybindings
- Press <\\[indium-repl-clear-output]> to clear the output
To disconnect from the JavaScript process, press <\\[indium-quit]>.
Doing this will also close all inspectors and debugger buffers
connected to the process.
(defun indium-repl-setup-markers ()
"Setup the initial markers for the current REPL buffer."
(dolist (marker '(indium-repl-output-start-marker
(set marker (make-marker))
(set-marker (symbol-value marker) (point))))
(defun indium-repl-mark-output-start ()
"Mark the output start."
(set-marker indium-repl-output-start-marker (point))
(set-marker indium-repl-output-end-marker (point)))
(defun indium-repl-mark-input-start ()
"Mark the input start."
(set-marker indium-repl-input-start-marker (point)))
(defun indium-repl-insert-prompt ()
"Insert the prompt in the REPL buffer."
(goto-char indium-repl-input-start-marker)
(indium-save-marker indium-repl-output-start-marker
(indium-save-marker indium-repl-output-end-marker
(unless (bolp)
(insert-before-markers "\n"))
(insert-before-markers "js> ")
(let ((beg (save-excursion
(end (point)))
(set-text-properties beg end
'(font-lock-face indium-repl-prompt-face
read-only t
intangible t
field indium-repl-prompt
rear-nonsticky (read-only font-lock-face intangible field)))))))
(defun indium-repl-return ()
"Depending on the position of point, jump to a reference of evaluate the input."
((get-text-property (point) 'indium-reference) (indium-follow-link))
((get-text-property (point) 'indium-action) (indium-perform-action))
((indium-repl--in-input-area-p) (indium-repl-evaluate (indium-repl--input-content)))
(t (error "No input or action at point"))))
(defun indium-repl-inspect ()
"Inspect the result of the evaluation of the input at point."
(indium-backend-evaluate (indium-current-connection-backend)
(lambda (result _error)
(indium-inspector-inspect result))))
(defun indium-repl--input-content ()
"Return the content of the current input."
(buffer-substring-no-properties indium-repl-input-start-marker (point-max)))
(defun indium-repl--in-input-area-p ()
"Return t if in input area."
(<= indium-repl-input-start-marker (point)))
(declare-function #'indium-backend-evaluate "indium")
(defun indium-repl-evaluate (string)
"Evaluate STRING in the browser tab and emit the output."
(push string indium-repl-history)
(indium-backend-evaluate (indium-current-connection-backend) string #'indium-repl-emit-value)
;; move the output markers so that output is put after the current prompt
(goto-char (point-max))
(set-marker indium-repl-output-start-marker (point))
(set-marker indium-repl-output-end-marker (point))))
(defun indium-repl-emit-value (value error)
"Emit a string representation of VALUE.
When ERROR is non-nil, display VALUE as an error."
(with-current-buffer (indium-repl-get-buffer)
(goto-char (point-max))
(insert-before-markers "\n")
(set-marker indium-repl-output-start-marker (point))
(when error (indium-repl--emit-logging-error))
(indium-render-value value)
(insert "\n")
(set-marker indium-repl-output-end-marker (point)))
(run-hooks 'indium-repl-evaluate-hook)))
(defun indium-repl-emit-console-message (message &optional error)
"Emit a console MESSAGE.
When ERROR is non-nil, display MESSAGE as an error.
MESSAGE is a map (alist/hash-table) with the following keys:
text message text to be displayed
description optional additional description
level severity level (can be log, warning, error, debug)
type type of message
url url of the message origin
line line number in the resource that generated this message
values message values to be logged
MESSAGE must contain `text' or `values.'. Other fields are
(with-current-buffer (indium-repl-get-buffer)
(when (string= (map-elt message 'level) 'error)
(setq error t))
(goto-char indium-repl-output-end-marker)
(set-marker indium-repl-output-start-marker (point))
(insert "\n")
(when error
(indium-repl--emit-message-values message)
(set-marker indium-repl-output-end-marker (point))
(unless (eolp)
(insert "\n")))))
(defun indium-repl--emit-message-values (message)
"Emit all values of console MESSAGE."
(let ((text (map-elt message 'text))
(values (map-elt message 'values))
(url (map-elt message 'url))
(line (map-elt message 'line)))
(when (seq-empty-p values)
(setq values `(((type . "string")
(description . ,text)))))
(indium-render-values values "\n")
(indium-repl--emit-message-url-line url line)))
(defun indium-repl--emit-logging-error ()
"Emit a red \"Error\" label."
(propertize "Error:"
'font-lock-face 'indium-repl-error-face
'rear-nonsticky '(font-lock-face)))
" "))
(defun indium-repl--emit-message-url-line (url line)
"Emit the URL and LINE for a message."
(unless (seq-empty-p url)
(let ((path (indium-workspace-lookup-file-safe url)))
(insert "\nFrom "
(propertize (if line
(format "%s:%s" path line)
'font-lock-face 'indium-link-face
'indium-action (lambda ()
(if (file-regular-p path)
(find-file path)
(browse-url path)))
'rear-nonsticky '(font-lock-face indium-action))))))
(defun indium-repl-next-input ()
"Insert the content of the next input in the history."
(indium-repl--history-replace 'forward))
(defun indium-repl-previous-input ()
"Insert the content of the previous input in the history."
(indium-repl--history-replace 'backward))
(defun indium-repl--history-replace (direction)
"Replace the current input with one the next one in DIRECTION.
DIRECTION is `forward' or `backard' (in the history list)."
(let* ((history (seq-reverse indium-repl-history))
(search-in-progress (or (eq last-command 'indium-repl-previous-input)
(eq last-command 'indium-repl-next-input)))
(step (pcase direction
(`forward 1)
(`backward -1)))
(pos (or (and search-in-progress (+ indium-repl-history-position step))
(1- (seq-length history)))))
(unless (>= pos 0)
(user-error "Beginning of history"))
(unless (< pos (seq-length history))
(user-error "End of history"))
(setq indium-repl-history-position pos)
(indium-repl--replace-input (seq-elt history pos))))
(defun indium-repl--replace-input (input)
"Replace the current input with INPUT."
(goto-char (point-max))
(delete-region indium-repl-input-start-marker (point))
(insert input))
(defun indium-repl-clear-output ()
"Clear all output contents of the current buffer."
(let ((inhibit-read-only t))
(goto-char (point-min))
(delete-region (point) indium-repl-output-end-marker))))
(defun indium-repl-pop-buffer ()
"Switch to the buffer from which repl was opened buffer if any."
(when indium-repl-switch-from-buffer
(pop-to-buffer indium-repl-switch-from-buffer t)))
(defun indium-repl--handle-connection-closed ()
"Display a message when the connection is closed."
(when-let ((buf (indium-repl-get-buffer)))
(with-current-buffer buf
(goto-char (point-max))
(insert-before-markers "\n")
(set-marker indium-repl-output-start-marker (point))
(insert "Connection closed. ")
(insert "\n")
(set-marker indium-repl-input-start-marker (point))
(set-marker indium-repl-output-end-marker (point)))
(defun indium-repl--insert-connection-buttons ()
"Insert buttons when the connection is lost.
The user can either close all related buffers or try to reopen
the connection."
(indium-render-button "Reconnect" #'indium-reconnect)
(insert " or ")
(indium-render-button "close all buffers" #'indium-quit)
(insert "."))
(defun company-indium-repl (command &optional arg &rest _args)
"Indium REPL backend for company-mode.
See `company-backends' for more info about COMMAND and ARG."
(interactive (list 'interactive))
(cl-case command
(interactive (company-begin-backend 'company-indium-repl))
(prefix (indium-repl-company-prefix))
(ignore-case t)
(sorted t)
(candidates (cons :async
(lambda (callback)
(indium-repl-get-completions arg callback))))))
(defun indium-repl-get-completions (arg callback)
"Get the completion list matching the prefix ARG.
Evaluate CALLBACK with the completion candidates."
(let ((expression (buffer-substring-no-properties
(let ((bol (line-beginning-position))
(prev-delimiter (1+ (save-excursion
(re-search-backward "[([:space:]]" nil t)))))
(if prev-delimiter
(max bol prev-delimiter)
(indium-backend-get-completions (indium-current-connection-backend) expression arg callback)))
(defun indium-repl--complete-or-indent ()
"Complete or indent at point."
(if (company-manual-begin)
(defun indium-repl-company-prefix ()
"Prefix for company."
(and (or (eq major-mode 'indium-repl-mode)
(bound-and-true-p indium-interaction-mode))
(or (company-grab-symbol-cons "\\." 1)
(defvar indium-repl-mode-hook nil
"Hook executed when entering `indium-repl-mode'.")
(declare 'indium-quit)
(defvar indium-repl-mode-map
(let ((map (make-sparse-keymap)))
(define-key map [return] #'indium-repl-return)
(define-key map "\C-m" #'indium-repl-return)
(define-key map (kbd "TAB") #'indium-repl--complete-or-indent)
(define-key map [mouse-1] #'indium-follow-link)
(define-key map (kbd "C-<return>") #'newline)
(define-key map (kbd "C-c M-i") #'indium-repl-inspect)
(define-key map (kbd "C-c C-o") #'indium-repl-clear-output)
(define-key map (kbd "C-c C-z") #'indium-repl-pop-buffer)
(define-key map (kbd "C-c C-q") #'indium-quit)
(define-key map (kbd "M-p") #'indium-repl-previous-input)
(define-key map (kbd "M-n") #'indium-repl-next-input)
(easy-menu-define indium-repl-mode-menu map
"Menu for Indium REPL"
'("Indium REPL"
["Clear output" indium-repl-clear-output]
["Inspect" indium-repl-inspect]
["Switch to source buffer" indium-repl-pop-buffer]
["Quit" indium-quit]))
(define-derived-mode indium-repl-mode fundamental-mode "JS-REPL"
"Major mode for indium REPL interactions.
(setq-local font-lock-defaults (list js--font-lock-keywords))
(setq-local syntax-propertize-function #'js-syntax-propertize)
(setq-local company-backends '(company-indium-repl))
(company-mode 1)
(setq-local comment-start "// ")
(setq-local comment-end ""))
(provide 'indium-repl)
;;; indium-repl.el ends here