;; ess-tracebug.el --- Tracing and debugging facilities for ESS. ;; ;; Copyright (C) 2011--2012 A.J. Rossini, Richard M. Heiberger, Martin Maechler, ;; Kurt Hornik, Rodney Sparapani, Stephen Eglen and Vitalie Spinu. ;; ;; Filename: ess-tracebug.el ;; Author: Vitalie Spinu ;; Maintainer: Vitalie Spinu ;; Copyright (C) 2010-2012, Vitalie Spinu, all rights reserved. ;; Created: Oct 14 14:15:22 2010 ;; Version: 0.4ESS ;; URL: http://code.google.com/p/ess-tracebug/ ;; Keywords: debug, watch, traceback, ESS, R ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ;; ;; This file is *NOT* part of GNU Emacs. ;; This file is part of ESS ;; ;; 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, 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 ;; this program; see the file COPYING. If not, write to the Free Software ;; Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, ;; USA. ;; ;; Features that might be required by this library: ;; ;; ESS - required ;; ido, face-remap, cl - desirable and are part of default emacs ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ;; ;;; Commentary: ;; Ess-tracebug is a package for interactive debugging of R code from ;; ESS and provides such features as: ;; - visual debugging ;; - browser, recover and conditional breakpoints ;; - watch window and loggers ;; - on the fly debug/undebug of R functions and methods ;; - highlighting of error source references and easy error navigation ;; - interactive traceback. ;; For a complete description please see the ;; documentation at http://code.google.com/p/ess-tracebug/ ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ;; ;;; Code: (require 'ess) (eval-when-compile (require 'overlay) (require 'cl)) (autoload 'ess-helpobjs-at-point "ess-help" "[autoload]" nil) ;;todo: rename and put into a more neutral place (defgroup ess-tracebug nil "Error navigation and debugging for ESS. Currently only R is supported." :link '(emacs-library-link :tag "Source Lisp File" "ess-tracebug.el") :group 'ess ) (defvar ess-tracebug-indicator " TB" "String to be displayed in mode-line alongside the process name. Indicates that ess-traceback-mode is turned on. " ) ;; (defvar ess--tracebug-p nil ;; "Non nil if ess-tracebug is turned on for current process. ;; Function `ess-tracebug' toggles on/off this variable.") ;; (make-variable-buffer-local 'ess--tracebug-p) ;; (add-to-list 'minor-mode-alist '(ess--tracebug-p ess-tracebug-indicator)) (defcustom ess-tracebug-prefix nil "*Key to be used as prefix for all ess-tracebug commands. Set this to a key cominbation you don't use often, like: (setq ess-tracebug-prefix \"\\M-t\") The postfix keys are defined in `ess-tracebug-map': \\{ess-tracebug-map} " :type 'string :group 'ess-tracebug) (define-obsolete-variable-alias 'ess-tracebug-command-prefix 'ess-tracebug-prefix) (defcustom ess-tracebug-inject-source-p 'function "Control the source injection into evaluated code. If t, always inject source reference. If function inject only for functions (the default). If nil, never inject. During the source injection the value of `ess-eval-visibly-p' is ignored. Ess-tracebug injects the source reference by wrapping your source code in the statement 'eval(parse(text='%s'))'. The disadvantage is that you won't be able to execute blocks which don't form a valid R expression. The advantage - you won't need to source your files in order to get source references and most importantly errors generated by R will have a reference to the error position. Use \\[next-error] or M-g n to navigate quickly to the error. " :group 'ess-tracebug :type '(choice (const nil) (const function) (const t)) ) (defcustom ess-tracebug-enter-hook nil "List of functions to call on entry to ess-tracebug mode. Use `add-hook' to insert append your functions to this list. " :group 'ess-tracebug :type 'hook) (defcustom ess-tracebug-exit-hook nil "List of functions to call on exit of ess-tracebug mode. Use `add-hook' to insert append your functions to this list. " :group 'ess-tracebug :type 'hook) (defvar ess-tracebug-map (let ((map (make-sparse-keymap))) (define-prefix-command 'map) (define-key map "`" 'ess-show-R-traceback) (define-key map "w" 'ess-watch) (define-key map "i" 'ess-dbg-goto-input-event-marker) (define-key map "I" 'ess-dbg-goto-input-event-marker) (define-key map "d" 'ess-dbg-flag-for-debugging) (define-key map "D" 'ess-dbg-unflag-for-debugging) (define-key map "u" 'ess-dbg-unflag-for-debugging) (define-key map "b" 'ess-bp-set) (define-key map "B" 'ess-bp-set-conditional) (define-key map "l" 'ess-bp-set-logger) (define-key map "t" 'ess-bp-toggle-state) (define-key map "k" 'ess-bp-kill) (define-key map "K" 'ess-bp-kill-all) (define-key map "\C-n" 'ess-bp-next) (define-key map "\C-p" 'ess-bp-previous) (define-key map "e" 'ess-dbg-toggle-error-action) (define-key map "c" 'ess-dbg-singlekey-command) (define-key map "n" 'ess-dbg-singlekey-command) (define-key map "p" 'ess-dbg-singlekey-command) (define-key map "q" 'ess-dbg-singlekey-command) (define-key map "0" 'ess-dbg-singlekey-command) (define-key map "1" 'ess-dbg-singlekey-command) (define-key map "2" 'ess-dbg-singlekey-command) (define-key map "3" 'ess-dbg-singlekey-command) (define-key map "4" 'ess-dbg-singlekey-command) (define-key map "5" 'ess-dbg-singlekey-command) (define-key map "6" 'ess-dbg-singlekey-command) (define-key map "7" 'ess-dbg-singlekey-command) (define-key map "8" 'ess-dbg-singlekey-command) (define-key map "9" 'ess-dbg-singlekey-command) (define-key map "s" 'ess-tracebug-source-current-file) (define-key map "?" 'ess-tracebug-show-help) map) "Keymap used as a binding for `ess-tracebug-prefix' key in ESS and iESS mode. \\{ess-tracebug-map} " ) (defvar ess--tracebug-eval-index 0 "This is used by to track source references in evaluation with source. For example, each time ess-eval-function is called the evaluated region is marked. When debugger enteres the code it desplayes this reference number. Ess-debug finds this number in the referenced buffer. ") (defvar ess--tb-buffer-sym nil) (make-variable-buffer-local 'ess--tb-buffer-sym) (defun ess--tb-get-source-refd-string (beg end) "Encapsulate the region string into eval(parse ... ) block (used for source references insertion)" (let ((filename buffer-file-name)) (setq ess--tracebug-eval-index (1+ ess--tracebug-eval-index)) (unless ess--tb-buffer-sym (setq ess--tb-buffer-sym (format "TB%d" ess--tracebug-eval-index))) (unless filename ;; org, etc (setq filename (format "[%s]" ess--tb-buffer-sym)) (if org-src-mode ;; (setq filename (concat (buffer-file-name (marker-buffer org-edit-src-beg-marker)) filename)))) ;; next drops are not necesarry for function but will be for regions (goto-char beg) (when (looking-at "\\s +") ;drop trailing lines (re-search-forward "[^ \t\n]" nil t) (setq beg (point-at-bol))) (goto-char end) (when (looking-back "\\s +") ;drop the end empty lines (re-search-backward "[^ \t\n]" nil t) (setq end (point-at-eol))) (put-text-property beg end 'tb-index ess--tracebug-eval-index) (format "eval(parse(text=\"%s\",srcfile=srcfile(\"%s@%d\")))\n" (ess-quote-special-chars (buffer-substring-no-properties beg end)) filename ess--tracebug-eval-index))) (defun ess-tracebug-send-region (proc start end &optional visibly message func) "Send region to process. Source-ref region and wrap in eval(parse(...)) if needed. FUNC must be non-nil if the region contains a function definition. " (let* ((inject-p (or (and ess-tracebug-inject-source-p func) (eq ess-tracebug-inject-source-p t))) (ess--dbg-del-empty-p (if inject-p nil ess--dbg-del-empty-p)) (visibly (if inject-p nil visibly)) (string (if inject-p (ess--tb-get-source-refd-string start end) (buffer-substring start end)))) (ess-tb-set-last-input proc) (ess-send-string proc string visibly message)) ) (defvar ess-tracebug-help nil " Default ess-tracebug key bindings: * Breakpoints: b . Set BP (repeat to cycle BP type) . `ess-bp-set' B . Set conditional BP . `ess-bp-set-conditional' k . Kill BP . `ess-bp-kil' K . Kill all BPs . `ess-bp-kill-all' t . Toggle BP state . `ess-bp-toggle-state' l . Set logger BP . `ess-bp-set-logger' C-n . Goto next BP . `ess-bp-next' C-p . Goto previous BP . `ess-bp-previous' * General Debugging: ` . Show R Traceback . `ess-show-R-traceback' e . Toggle error action (repeat to cycle). `ess-dbg-toggle-error-action' d . Flag for debugging . `ess-dbg-flag-for-debugging' u . Unflag for debugging . `ess-dbg-unflag-for-debugging' w . Watch window . `ess-watch' * Navigation to errors (emacs general functionality): C-x `, M-g n . `next-error' M-g p . `previous-error' * Interactive Debugging: c . Continue . `ess-dbg-command-c' n . Next step . `ess-dbg-command-n' p . Previous step . `previous-error' q . Quit debugging . `ess-dbg-command-Q' 1..9. Enter recover frame . `ess-dbg-command-digit' 0 . Exit recover (also q,n,c) . `ess-dbg-command-digit' * Input Ring: i . Goto input event marker forwards . `ess-dbg-goto-input-event-marker' I . Goto input event marker backwards . `ess-dbg-goto-input-event-marker' * Misc: s . Source current file . `ess-tracebug-source-current-file' ? . Show this help . `ess-tracebug-show-help' ") (defun ess-tracebug-show-help (&optional ev) (interactive) (describe-variable 'ess-tracebug-help)) (defun ess-tracebug--propertize (dummy bitmap face &optional string ) "If window-system propertize DUMMY with fringe BITMAP and FACE, else propertize line-prefix and margin with STRING and FACE" (unless string (setq string dummy)) (if window-system (propertize dummy 'display (list 'left-fringe bitmap face)) (propertize dummy 'display (list '(margin left-margin) (propertize string 'font-lock-face face 'face face)) ) )) (defun ess-tracebug (&optional arg) "Toggle ess-tracebug mode. With ARG, turn ess-tracebug mode on if and only if ARG is positive. This mode adds to ESS the interactive debugging, breakpoint and error navigation functionality. Strictly speaking ess-tracebug is not a minor mode. It integrates globally into ESS and iESS. See `ess-tracebug-help' for the overview of ess-tracebug functionality. Note: The functionality in ess-tracebug is divided on conceptual grounds in tracing and debugging and could be activated/deactivate separately with `ess-traceback' and `ess-debug' respectively. " (interactive "P") (ess-force-buffer-current "R process to activate the tracebug mode: ") (with-current-buffer (process-buffer (get-process ess-local-process-name)) (when (equal ess-dialect "R") (setq arg (if arg (prefix-numeric-value arg) (if (ess-process-get 'tracebug) -1 1))) (if (> arg 0) (unless (ess-process-get 'tracebug) ;; only if already not active (ess-tb-start) (ess-dbg-start) (add-hook 'ess-mode-hook 'ess-bp-recreate-all) (dolist (bf (buffer-list)) (with-current-buffer bf (when (and (eq major-mode 'ess-mode) (equal ess-dialect "R")) (ess-bp-recreate-all)))) ;; Un/Debug at point functionality (ess-dbg-inject-un/debug-commands) (sleep-for 0.05) ;; not needed but let it be ;; watch functionality (ess-watch-inject-commands) (sleep-for 0.05) (if ess-tracebug-prefix (let ((comm (key-binding ess-tracebug-prefix))) (when (commandp comm) (define-key ess-tracebug-map ess-tracebug-prefix comm)) (define-key ess-mode-map ess-tracebug-prefix ess-tracebug-map) (define-key inferior-ess-mode-map ess-tracebug-prefix ess-tracebug-map) (define-key ess-watch-mode-map ess-tracebug-prefix ess-tracebug-map) ) (message "`ess-tracebug-prefix' is not defined, tracebug bindings are not active ...")) (run-hooks 'ess-tracebug-enter-hook) (ess-process-put 'tracebug t) (message "ess-tracebug mode enabled")) (when (ess-process-get 'tracebug) ;;only when active (ess-process-put 'tracebug nil) ;; unset the map (when ess-tracebug-prefix (define-key ess-mode-map ess-tracebug-prefix nil) (define-key inferior-ess-mode-map ess-tracebug-prefix nil)) (ess-tb-stop) (ess-dbg-stop) (remove-hook 'ess-mode-hook 'ess-bp-recreate-all) (run-hooks 'ess-tracebug-exit-hook) (message "ess-tracebug mode disabled") )) ))) ;;;_* TRACEBACK (require 'compile) (defgroup ess-traceback nil "Tracing for ESS." :link '(emacs-library-link :tag "Source Lisp File" "ess-tracebug.el") :group 'ess-tracebug :prefix "ess-tb-" ) ;; (defface ess-tb-last-input-face ;; '((((class grayscale) ;; (background light)) (:background "DimGray")) ;; (((class grayscale) ;; (background dark)) (:background "LightGray")) ;; (((class color) (background light) (min-colors 88)) ;; (:overline "medium blue" )) ;; (((class color) (background dark) (min-colors 88)) ;; (:overline "deep sky blue" )) ;; (((background light)) (:weight bold)) ;; (((background dark)) (:weight bold)) ;; ) ;; "Face to highlight currently debugged line." ;; :group 'ess-traceback ) (defface ess-tb-last-input-fringe-face '((((background light) (min-colors 88)) (:foreground "medium blue" :overline "medium blue")) (((background dark) (min-colors 88)) (:foreground "deep sky blue" :overline "deep sky blue")) (((background light) (min-colors 8)) (:foreground "blue")) (((background dark) (min-colors 8)) (:foreground "syan")) ) "Face for fringe bitmap for last-input position." :group 'ess-traceback) (if (fboundp 'define-fringe-bitmap) (define-fringe-bitmap 'last-input-arrow [#b00011111 #b00010000 #b00010000 #b00010000 #b00010000 #b00010000 #b00010000 #b00010000 #b00010000 #b00010000 #b11010111 #b01111100 #b00111000 #b00010000] nil nil 'top) ) (defvar ess-tb-last-input (make-marker) "Marker pointing to the last user input position in iESS buffer. This is the place where `ess-tb-last-input-overlay' is moved. Local in iESS buffers with `ess-traceback' mode enabled.") (defvar ess-tb-last-input-overlay nil "Overlay to highlight the position of last input in iESS buffer. Local in iESS buffers.") (defvar ess--busy-count 0 "Used to compute the busy indicator") (make-variable-buffer-local 'ess--busy-count) (unless (boundp 'ess--busy-slash) (defvar ess--busy-slash '(32 ?\u2014 92 47)) (setq ess--busy-slash (mapcar '(lambda (el) (format " %c " el)) ess--busy-slash )) ) (defvar ess--busy-B '(" " " B " " ")) (defvar ess--busy-stars '(" " " " " * " " ** " " *** " " **** ")) (defvar ess--busy-vbars '(" " " " " | " " || " " ||| " " |||| ")) (defcustom ess-busy-strings ess--busy-slash "List of strings to replace in turn for busy indication. The first element of the list is used as an indicator for process being ready (i.e. not busy) Implemented lists are `ess--busy-slash', `ess--busy-B',`ess--busy-stars', `ess--busy-vbars'" :group 'ess) (defvar ess--busy-timer nil "Timer used for busy process indication") (defcustom inferior-ess-split-long-prompt t "If non-nil, long prompt '> > > > > + + + + > ' is split." :group 'ess-traceback) (defcustom inferior-ess-replace-long+ t "If non-nil, '+ + + + ' containing more than 4 + is replaced by `ess-long+replacement'" :group 'ess-traceback) (defvar ess-long+replacement "+ . + " "Replacement used for long + prompt. Customization of this variable is not recommended. You can set it to '. '. If you set it to anything else you will have to change `inferior-ess-S-prompt' to assure the correct prompt navigation in inferior buffers. ") (defmacro ess-copy-key (from-map to-map fun) `(define-key ,to-map (car (where-is-internal ,fun ,from-map)) ,fun )) ;;;_ + traceback functions (defun ess-tb-make-last-input-overlay (beg end) "Create an overlay to indicate the last input position." (let ((ove (make-overlay beg end))) (overlay-put ove 'before-string (ess-tracebug--propertize "!" 'last-input-arrow 'ess-tb-last-input-fringe-face)) ;; (overlay-put ove 'face 'ess-tb-last-input-face) (overlay-put ove 'evaporate t) ove)) ;; (ess-tb-make-last-input-overlay (point-at-bol) (point-at-eol)) (defvar ess-tracebug-enhance-ess-command t) (defun ess-tb-start () "Start traceback session " (with-current-buffer (process-buffer (get-process ess-current-process-name)) (unless (equal ess-dialect "R") (error "Can not activate the debuger for %s dialect" ess-dialect)) (setq comint-process-echoes nil) ;; makes the display wiggly :( (setq inferior-R-2-input-help "^ *\\(\\?\\{1,2\\}\\) *['\"]?\\([^,=)'\"]*\\)['\"]?") ;; ?? bug (make-local-variable 'compilation-error-regexp-alist) (setq compilation-error-regexp-alist ess-R-tb-regexp-alist) (compilation-setup t) (setq next-error-function 'ess-tb-next-error-function) ;; new locals (make-local-variable 'ess-tb-last-input) (make-local-variable 'ess-tb-last-input-overlay) (make-local-variable 'compilation-search-path) (setq compilation-search-path ess-dbg-search-path) (ess-tracebug--set-left-margin) (save-excursion (goto-char comint-last-input-start) (setq ess-tb-last-input (point)) (setq ess-tb-last-input-overlay (ess-tb-make-last-input-overlay (point-at-bol) (point-at-eol))) ) ;; busy timer (make-local-variable 'ess--was-busy) (setq mode-line-buffer-identification (list (car (propertized-buffer-identification "%3b")) `(:eval (nth ess--busy-count ess-busy-strings)))) ;; 'face 'mode-line-buffer-id)))) (make-local-variable 'ess--busy-timer) (setq ess--busy-timer (run-with-timer 2 .5 (ess--make-busy-timer-function (get-buffer-process (current-buffer))))) (add-hook 'kill-buffer-hook '(lambda () (cancel-timer ess--busy-timer))) ;; redefine (unless (fboundp 'orig-inferior-R-input-sender) (defalias 'orig-inferior-R-input-sender (symbol-function 'inferior-R-input-sender)) (defalias 'inferior-R-input-sender (symbol-function 'inferior-R-input-sender2)) ) (unless (fboundp 'orig-ess-parse-errors) (defalias 'orig-ess-parse-errors (symbol-function 'ess-parse-errors)) (defalias 'ess-parse-errors (symbol-function 'next-error)) ) (unless (fboundp 'orig-ess-load-file) (defalias 'orig-ess-load-file (symbol-function 'ess-load-file)) (defalias 'ess-load-file (symbol-function 'ess-tracebug-source-current-file)) ) ;; hooks (add-hook 'ess-send-input-hook 'move-last-input-overlay-on-send-input t t) ) ) (defun ess-tb-stop () "Stop ess traceback session in the current ess process" (with-current-buffer (process-buffer (get-process ess-current-process-name)) ;; restore original definitions (when (fboundp 'orig-inferior-R-input-sender) (defalias 'inferior-R-input-sender (symbol-function 'orig-inferior-R-input-sender)) (fmakunbound 'orig-inferior-R-input-sender)) (when (fboundp 'orig-ess-eval-region) (defalias 'ess-eval-region (symbol-function 'orig-ess-eval-region)) (fmakunbound 'orig-ess-eval-region)) ;; (when (fboundp 'orig-ess-eval-function) ;; (defalias 'ess-eval-function (symbol-function 'orig-ess-eval-function)) ;; (fmakunbound 'orig-ess-eval-function)) (when (fboundp 'orig-ess-parse-errors) (defalias 'ess-parse-errors (symbol-function 'orig-ess-parse-errors)) (fmakunbound 'orig-ess-parse-errors)) (when (fboundp 'orig-ess-load-file) (defalias 'ess-load-file (symbol-function 'orig-ess-load-file)) (fmakunbound 'orig-ess-load-file)) (setq comint-process-echoes t) ;; back to kludge (setq inferior-R-2-input-help "^ *\\? *\\(['\"]?\\)\\([^,=)'\"]*\\)\\1") ;; original: ?? bug (remove-hook 'ess-send-input-hook 'move-last-input-overlay-on-send-input t) (if (local-variable-p 'ess-tb-last-input-overlay) (delete-overlay ess-tb-last-input-overlay)) (kill-local-variable 'ess-tb-last-input-overlay) (kill-local-variable 'ess-tb-last-input) (font-lock-remove-keywords nil (compilation-mode-font-lock-keywords)) (font-lock-fontify-buffer) (kill-local-variable 'compilation-error-regexp-alist) (kill-local-variable 'compilation-search-path) (cancel-timer ess--busy-timer) (setq mode-line-buffer-identification (propertized-buffer-identification "%12b")) )) (defvar ess-R-tb-regexp-alist '(R R3 R-recover) "List of symbols which are looked up in `compilation-error-regexp-alist-alist'.") (add-to-list 'compilation-error-regexp-alist-alist '(R "^.* \\(at \\(.+\\)#\\([0-9]+\\)\\)" 2 3 nil 2 1)) ;; (add-to-list 'compilation-error-regexp-alist-alist ;; '(R2 "\\(?:^ +\\(.*?\\):\\([0-9]+\\):\\([0-9]+\\):\\)" 1 2 nil 2 1)) (add-to-list 'compilation-error-regexp-alist-alist '(R3 "\\(?:Error .*: *\n? +\\)\\(.*\\):\\([0-9]+\\):\\([0-9]+\\):" 1 2 3 2 1)) (add-to-list 'compilation-error-regexp-alist-alist '(R-recover " *[0-9]+: +\\([^:\n\t]+?\\)#\\([0-9]+:\\)" 1 2 nil 2 1)) ;; (setq ess-R-tb-regexp-alist '(R R2 R3 R-recover)) ;;(pop compilation-error-regexp-alist-alist) (defun ess-show-R-traceback () "Display R traceback and last error message. Pop up a compilation/grep/occur like buffer. Usual global key bindings are available \(\\[next-error] and \\[previous-error]\) for `next-error' and `previous-error' respectively. You can bind 'no-select' versions of this commands: \(define-key compilation-minor-mode-map [(?n)] 'next-error-no-select\) \(define-key compilation-minor-mode-map [(?p)] 'previous-error-no-select\) " (interactive) (ring-insert ess-dbg-forward-ring (point-marker)) (ess-force-buffer-current "R process to use: ") (let ((trbuf (get-buffer-create "*ess-traceback*"))) (setq next-error-last-buffer trbuf) (with-current-buffer trbuf (setq buffer-read-only nil) ) (ess-command "try(traceback(), silent=TRUE);cat(\n\"---------------------------------- \n\", geterrmessage(), fill=TRUE)\n" trbuf) (set-buffer trbuf) ;; don't move this before ess-command! mess up multiple processes' (if (string= "No traceback available" (buffer-substring 1 23)) (message "No traceback available") (ess-dirs) (message nil) (goto-char (point-min)) ;(setq font-lock-defaults '(ess-R-mode-font-lock-keywords)) :todo: solve font-lock (make-local-variable 'compilation-error-regexp-alist) (setq compilation-error-regexp-alist ess-R-tb-regexp-alist) (make-local-variable 'compilation-search-path) (setq compilation-search-path ess-dbg-search-path) (compilation-minor-mode 1) (setq next-error-function 'ess-tb-next-error-function) ;(use-local-map ess-traceback-minor-mode-map) (pop-to-buffer trbuf) ;; tracebug keys (when ess-tracebug-prefix (local-set-key ess-tracebug-prefix ess-tracebug-map)) ;; ess keys (local-set-key "\C-c\C-s" 'ess-watch-switch-process) (local-set-key "\C-c\C-y" 'ess-switch-to-ESS) (local-set-key "\C-c\C-z" 'ess-switch-to-end-of-ESS) (setq buffer-read-only t) ))) (defun ess-tb-next-error-goto-process-marker () ;; assumes current buffer is the process buffer with compilation enabled ;; used in ess-tb-next-error-function ; (with-current-buffer (process-buffer (get-process ess-local-process-name)) ; already in comint buffer .. no need (comint-goto-process-mark) (set-window-point (get-buffer-window) (point)) ;moves the cursor ;; FIXME: Should jump to current-debug-position, but messes the things if in recover ;; (when (ess-dbg-is-active) ;; (ess-dbg-goto-current-debug-position) ;; ) ) (defun ess-tb-next-error-function (n &optional reset) "Advance to the next error message and visits the file. This is the value of `next-error-function' in iESS buffers." ;; Modified version of `compilation-next-error-function'. (interactive "p") (if reset (goto-char (point-max))) (let* ((columns compilation-error-screen-columns) ; buffer's local value ;; (proc (or (get-buffer-process (current-buffer)) ;; (error "Current buffer has no process"))) (pbuff-p (get-buffer-process (current-buffer))) (last 1) (n (or n 1)) timestamp (beg-pos ; from where the search for next error starts (if (and pbuff-p (>= n 0) (comint-after-pmark-p)) ess-tb-last-input (point))) (at-error t) (msg (condition-case err (compilation-next-error n nil beg-pos) (error (when pbuff-p (ess-tb-next-error-goto-process-marker)) (if (< n 0) (message "Before first reference") (message "Beyond last reference"));(error-message-string err)) (setq at-error nil) ))) (msg (if (or (not pbuff-p) (eq n 0) (> (point) ess-tb-last-input)) msg (ess-tb-next-error-goto-process-marker) (message "Beyond last-input marker") (setq at-error nil) )) (marker (point-marker)) loc end-loc ) (when at-error (setq compilation-current-error (point-marker) overlay-arrow-position (if (bolp) compilation-current-error (copy-marker (line-beginning-position))) loc (if (fboundp 'compilation--message->loc) (compilation--message->loc msg) (car msg)) end-loc (if (fboundp 'compilation--message->end-loc) ;; emacs 24 (compilation--message->end-loc msg) (nth 2 msg))) (let* ((file (caar (nth 2 loc))) (col (car loc)) (line (cadr loc)) (mkrs (ess-dbg-get-ref-rarker file line col)) ) (if mkrs (compilation-goto-locus marker (car mkrs) (cadr mkrs)) (message "Reference to '%s' not found" file) ))))) (defun inferior-ess-move-last-input-overlay () "Move the overlay to the point." (let ((pbol (point-at-bol)) (pt (point)) ) (move-overlay ess-tb-last-input-overlay pbol (max (- pt 2) (+ pbol 2))) )) (defun move-last-input-overlay-on-send-input () (setq ess-tb-last-input (point)) (inferior-ess-move-last-input-overlay) ) (ess-if-verbose-write "\n<- traceback done") ;;;_* DEBUGER (defgroup ess-debug nil "Debugging for ESS" :link '(emacs-library-link :tag "Source Lisp File" "ess-tracebug.el") :group 'ess-tracebug :prefix "ess-dbg-" ) (defvar ess-dbg-error-action "-" "Mode line indicator of the current \"on error\" action. Customize this variable to change the default behavior. See `ess-dbg-error-action-alist' for more." ;; :type 'string ;; :group 'ess-debug) ) (make-variable-buffer-local 'ess-dbg-error-action) (defcustom ess-dbg-error-action-alist '(( "-" "NONE" "NULL" ) ( "r" "RECOVER" "utils::recover") ( "t" "TRACEBACK" "base::traceback")) "Alist of 'on-error' actions. Toggled with `ess-dbg-toggle-error-action'. Each element must have the form (DISP SYMB ACTION) where DISP is the string to be displayed in the mode line when the action is in place. SYMB is the symbolic name of an action. ACTION is the string giving the actual expression to be assigned to 'error' user option. See R's help ?options for more details." :type '(alist :key-type string :value-type (string string)) :group 'ess-debug) (defvar ess-dbg-output-buf-prefix " *ess.dbg" "The prefix of the buffer name the R debug output is directed to." ) (defvar ess-dbg-current-ref (make-marker) "Current debug reference in *ess.dbg* buffers (a marker).") (make-variable-buffer-local 'ess-dbg-current-ref) (defvar ess-dbg-last-ref-marker (make-marker) "Last debug reference in *ess.dbg* buffer (a marker).") (defcustom ess-dbg-search-path '(nil) "List of directories to search for source files. Elements should be directory names, not file names of directories. " :type '(repeat (choice (const :tag "Default" nil) (string :tag "Directory"))) :group 'ess-debug) (defvar ess-dbg-buf-p nil "This is t in ess.dbg buffers.") (make-variable-buffer-local 'ess-dbg-buf-p) (defcustom ess-dbg-auto-single-key-p t "If t entering the debug state triggers single-key mode. Set it to nil if you want to trigger single-key mode manually with the `ess-tracebug-prefix' key. ") (defvar ess-dbg-current-debug-position (make-marker) "Marker to the current debugged line. It always point to the beginning of the currently debugged line and is used by overlay-arrow. In no-windowed emacs an `overlay-arrow' is displayed at this position.") (unless window-system (add-to-list 'overlay-arrow-variable-list 'ess-dbg-current-debug-position) ) (defface ess-dbg-current-debug-line-face '((((class grayscale) (background light)) (:background "DimGray")) (((class grayscale) (background dark)) (:background "LightGray")) (((class color) (background light) (min-colors 88)) (:background "tan")) (((class color) (background dark) (min-colors 88)) (:background "gray20")) (((background light) (min-colors 8)) (:weight bold)) (((background dark) (min-colors 8)) (:weight bold)) ) "Face used to highlight currently debugged line." :group 'ess-debug ) (defvar ess-dbg-current-debug-overlay (let ((overlay (make-overlay (point) (point)))) (overlay-put overlay 'face 'ess-dbg-current-debug-line-face) (overlay-put overlay 'evaporate t) overlay ) ;; should be global variable!! "The overlay for currently debugged line.") (defcustom ess-dbg-blink-interval .2 "Time in seconds to blink the background of the current debug line on exceptional events. Currently two exceptional events are defined 'ref-not-found' and 'same-ref'. Blinking colors for these events can be customized by corresponding faces." :group 'ess-debug :type 'float) (defface ess-dbg-blink-ref-not-found-face '((((class grayscale) (background light)) (:background "DimGray")) (((class grayscale) (background dark)) (:background "LightGray")) (((class color) (background light) (min-colors 88)) (:background "IndianRed4")) (((class color) (background dark) (min-colors 88)) (:background "dark red")) (((background light) (min-colors 8)) (:foreground "red")) (((background dark) (min-colors 8)) (:foreground "red")) ) "Face used to blink currently debugged line's background when the reference file is not found. See also `ess-dbg-ask-for-file'" :group 'ess-debug ) (defface ess-dbg-blink-same-ref-face '((((class grayscale) (background light)) (:background "DimGray")) (((class grayscale) (background dark)) (:background "LightGray")) (((class color) (background light) (min-colors 88)) (:background "steel blue")) (((class color) (background dark) (min-colors 88)) (:background "midnight blue")) (((background light) (min-colors 8)) (:foreground "blue")) (((background dark) (min-colors 8)) (:foreground "cyan")) ) "Face used to highlight currently debugged line when new debug reference is the same as the preceding one. It is highlighted for `ess-dbg-blink-interval' seconds." :group 'ess-debug ) (defcustom ess-dbg-indicator " db " "String to be displayed in mode-line alongside the process name. Indicates that ess-debug-mode is turned on. When the debuger is in active state this string is shown in upper case and highlighted." :group 'ess-debug :type 'string) (defcustom ess-dbg-ask-for-file nil "If non nil, ask for file if the current debug reference is not found. If nil, the currently debugged line is highlighted for `ess-dbg-blink-interval' seconds." :group 'ess-debug :type 'boolean) (defvar ess-debug-singlekey-map (let ((map (make-sparse-keymap))) (define-prefix-command 'map) (define-key map "c" 'ess-dbg-command-c) (define-key map "n" 'ess-dbg-command-n) (define-key map "p" 'ess-dbg-previous-error) (define-key map "q" 'ess-dbg-command-Q) (define-key map "0" 'ess-dbg-command-digit) (define-key map "1" 'ess-dbg-command-digit) (define-key map "2" 'ess-dbg-command-digit) (define-key map "3" 'ess-dbg-command-digit) (define-key map "4" 'ess-dbg-command-digit) (define-key map "5" 'ess-dbg-command-digit) (define-key map "6" 'ess-dbg-command-digit) (define-key map "7" 'ess-dbg-command-digit) (define-key map "8" 'ess-dbg-command-digit) (define-key map "9" 'ess-dbg-command-digit) (define-key map "?" 'ess-tracebug-show-help) map) "Keymap used to define commands for single key input mode. This commands are triggered by `ess-dbg-singlekey-command' . \\{ess-debug-singlekey-map} " ) (defvar ess-dbg-forward-ring (make-ring 10) "Ring of markers to the positions of the user inputs when the debugger or traceback events are initiated. It is used in `ess-dbg-goto-input-point'.") (defvar ess-dbg-backward-ring (make-ring 10) "Ring of markers to the positions from which `ess-dbg-goto-input-point' is called. See the also `ess-dbg-goto-debug-point'") (ess-if-verbose-write "\n<- debug-vars done") ;;;_ + debug functions (defun ess-dbg-set-error-action (spec) "Set the on-error action. The ACTION should be one of components of `ess-dbg-error-action-alist' (a cons!)." (let ((proc (get-process ess-current-process-name))) (if spec (with-current-buffer (process-buffer proc) (setq ess-dbg-error-action (car spec)) (ess-command (format "options(error= %s )\n" (nth 2 spec) )) ) (error "Unknown action.") ))) (defun ess-dbg-toggle-error-action () "Toggle the 'on-error' action. The action list is in `ess-dbg-error-action-alist'. " (interactive) (let* ( (alist ess-dbg-error-action-alist) (ev last-command-event) (com-char (event-basic-type ev)) actions act ) (setq actions (cdr (member (assoc ess-dbg-error-action ess-dbg-error-action-alist) ess-dbg-error-action-alist))) (unless actions (setq actions ess-dbg-error-action-alist)) (setq act (pop actions)) (ess-dbg-set-error-action act) (message "On-error action set to: %s" (propertize (cadr act) 'face 'font-lock-function-name-face)) (while (eq (setq ev (read-event)) com-char) (unless actions (setq actions ess-dbg-error-action-alist)) (setq act (pop actions)) (ess-dbg-set-error-action act) (message "On-error action set to: %s" (propertize (cadr act) 'face 'font-lock-function-name-face)) ) (push ev unread-command-events) )) (defun ess-dbg-activate-overlays () "Initialize active debug line overlays." (move-overlay ess-dbg-current-debug-overlay (point-at-bol) (1+ (point-at-eol)) (current-buffer)) (move-marker ess-dbg-current-debug-position (point-at-bol)) ;; used by overlay-arrow functionality on no-X, should be bol ) (defun ess-dbg-deactivate-overlays () "Deletes markers and overlays. Overlay arrow remains to indicate the last debug position." (delete-overlay ess-dbg-current-debug-overlay) (set-marker ess-dbg-current-debug-position nil) ) ;;;_ + Work Flow (defun ess-dbg-goto-input-event-marker () "Jump to the point where the last debugger/traceback etc event occurred. Mainly useful during/after debugging, to jump to the place from where the code was initialy executed. This is an singlekey-command, which means that after the command is triggered a single key event is enough to navigate through the input-event-S-ring. If the key-event which triggered the command is Shift modified the input-event-S-ring is traversed backwards. The input-event-S-ring is a virtual object which consists of two rings `ess-dbg-forward-ring' and `ess-dbg-backward-ring' which are joint at their tops. See the more info at http://code.google.com/p/ess-tracebug/#Work-Flow " (interactive) (let* ((ev last-command-event) (com-char (event-basic-type ev)) (ring-el 0) input-point) (if (memq 'shift (event-modifiers ev)) (setq input-point (ring-ref ess-dbg-backward-ring 0)) (ring-insert ess-dbg-backward-ring (point-marker)) ;; insert in backward ring ;;todo: check if the marker to this (close by?) position is already in the ring (setq input-point (ring-ref ess-dbg-forward-ring 0)) ) (when (marker-buffer input-point) ;; todo: give a message here if buff is not found (switch-to-buffer (marker-buffer input-point)) (when (marker-position input-point) (goto-char (marker-position input-point)) )) (while (eq (event-basic-type (setq ev (read-event))) com-char) (if (memq 'shift (event-modifiers ev)) (setq ring-el (1- ring-el)) (setq ring-el (1+ ring-el)) ) (if (< ring-el 0) (setq input-point (ring-ref ess-dbg-backward-ring (- ring-el))) ;; get it from backward-ring (setq input-point (ring-ref ess-dbg-forward-ring ring-el)) ;; get it from forward-ring ) (when (marker-buffer input-point) (switch-to-buffer (marker-buffer input-point)) (when (marker-position input-point) (goto-char (marker-position input-point)) ) ) ) (push ev unread-command-events) ) ) (defun ess-dbg-goto-debug-point () "Returns to the debugging position. Jump to markers stored in `ess-dbg-backward-ring'. If debug session is active, first jump to current debug line. This is an singlekey-command. Shift triggers the opposite traverse of the ring." (interactive) (let* ((debug-point (ring-ref ess-dbg-backward-ring 0)) (ev last-command-event) (com-char (event-basic-type ev)) (ring-el 0)) (if (ess-dbg-is-active) (progn (switch-to-buffer (marker-buffer ess-dbg-current-debug-position)) (goto-char (marker-position ess-dbg-current-debug-position )) (back-to-indentation) ) (switch-to-buffer (marker-buffer debug-point)) (goto-char (marker-position debug-point)) ) (while (eq (event-basic-type (setq ev (read-event))) com-char) (if (memq 'shift (event-modifiers ev)) (setq ring-el (1- ring-el)) (setq ring-el (1+ ring-el)) ) (setq debug-point (ring-ref ess-dbg-backward-ring ring-el)) (when (marker-buffer debug-point) (switch-to-buffer (marker-buffer debug-point)) (when (marker-position debug-point) (goto-char (marker-position debug-point)) ) ) ) (push ev unread-command-events) ) ) (defun ess-dbg-insert-in-forward-ring () (interactive) "Inserts point-marker into the forward-ring." (ring-insert ess-dbg-forward-ring (point-marker)) (message "Point inserted into the forward-ring")) (defvar ess-dbg-mode-line-indicator '(:eval (if (process-get (get-process ess-local-process-name) 'dbg-active) (let ((str (upcase ess-dbg-indicator))) (put-text-property 1 (1- (length str)) 'face '(:foreground "white" :background "red") str) str) ess-dbg-indicator) )) (make-variable-buffer-local 'ess-dbg-mode-line-indicator) (put 'ess-dbg-mode-line-indicator 'risky-local-variable t) (defun ess-dbg-start () "Start the debug session. Add to ESS the interactive debugging functionality, breakpoints, watch and loggers. Integrates into ESS and iESS modes by binding `ess-tracebug-map' to `ess-tracebug-prefix' in `ess-mode-map' and `inferior-ess-mode-map' respectively. " (interactive) (let ((dbuff (get-buffer-create (concat ess-dbg-output-buf-prefix "." ess-current-process-name "*"))) ;todo: make dbuff a string! (proc (get-ess-process ess-current-process-name))) (process-put proc 'dbg-buffer dbuff); buffer were the look up takes place (process-put proc 'dbg-active nil) ; t if the process is in active debug state. ; Active debug states are usually those, in which prompt start with Browser[d]> (set-process-filter proc 'inferior-ess-dbg-output-filter) (with-current-buffer (process-buffer proc) (unless (equal ess-dialect "R") (error "Can not activate the debuger for %s dialect" ess-dialect)) (add-to-list 'ess-mode-line-indicator 'ess-dbg-mode-line-indicator t) (add-to-list 'ess-mode-line-indicator 'ess-dbg-error-action t) ) (with-current-buffer dbuff (buffer-disable-undo) ;; (setq buffer-read-only nil) (make-local-variable 'overlay-arrow-position) ;; indicator for next-error functionality in the *ess.dbg*, useful?? (goto-char (point-max)) (setq ess-dbg-buf-p t ;; true if in *ess.dbg* buffer ess-dbg-current-ref (point-marker) ;; used by goto-error functionality ess-dbg-last-ref-marker (point-marker) ;; gives marker to reference of the last debugged line ) ;; (beginning-of-line) ;; (setq buffer-read-only t) ) )) (defun ess-dbg-stop () "End the debug session. Kill the *ess.dbg.[R_name]* buffer." ;;; process plist is not removed, todo?low priority (interactive) (let ((proc (get-process ess-current-process-name))) ;;local? (with-current-buffer (process-buffer proc) (if (member ess-dialect '("XLS" "SAS" "STA")) (error "Can not deactivate the debuger for %s dialect" ess-dialect)) (delq 'ess-dbg-mode-line-indicator ess-mode-line-indicator) (delq 'ess-dbg-error-action ess-mode-line-indicator) ) (set-process-filter proc 'inferior-ess-output-filter) (kill-buffer (process-get proc 'dbg-buffer)) (process-put proc 'dbg-buffer nil) (process-put proc 'dbg-active nil) ;; (when (buffer-live-p ess-dbg-buffer) ;; ;; (with-current-buffer ess-dbg-buffer ;; ;; (set-buffer-modified-p nil) ;; ;; ) ;; (kill-buffer ess-dbg-buffer) ;; ) )) (defun ess--make-busy-timer-function (process) "Display the spiner of prompt if ess-process is busy." `(lambda () (let ((pb ,process)) (when (eq (process-status pb) 'run) ;; only when the process is alive (with-current-buffer (process-buffer pb) (if (not (process-get pb 'busy)) ;; if ready (when (> ess--busy-count 0) (setq ess--busy-count 0) (force-mode-line-update)) (setq ess--busy-count (1+ (mod ess--busy-count (1- (length ess-busy-strings))))) (force-mode-line-update) )))))) ;; (ess--make-busy-prompt-function (get-process "R")) (defun ess-dbg-is-active () "Return t if the current R process is in active debugging state." (ess-process-get 'dbg-active) ) (defun ess-dbg-is-recover () "Return t if the current R process is in active debugging state." (ess-process-get 'is-recover) ) (defvar ess-dbg-regexp-reference "debug at +\\(.+\\)#\\([0-9]+\\):") (defvar ess-dbg-regexp-jump "debug at ") (defvar ess-dbg-regexp-skip ;; VS[21-03-2012|ESS 12.03]: sort of forgot why recover() was for:( "\\(\\(?:^Called from: \\)\\|\\(?:^debugging in: \\)\\|\\(?:#[0-9]*: +recover()\\)\\)") (defvar ess-dbg-regexp-input (concat "\\(\\(?:Browse[][0-9]+\\)\\|\\(?:debug: \\)\\)\\|" "\\(Selection: \\'\\)")) (defun inferior-ess-dbg-output-filter (proc string) "Standard output filter for the inferior ESS process when `ess-debug' is active. Call `inferior-ess-output-filter'. Check for activation expressions (defined in `ess-dbg-regexp-action), when found puts iESS in the debugging state. If in debugging state, mirrors the output into *ess.dbg* buffer." (let* ((is-iess (member major-mode (list 'inferior-ess-mode 'ess-watch-mode))) (pbuf (process-buffer proc)) (dbuff (process-get proc 'dbg-buffer)) (wbuff (get-buffer ess-watch-buffer)) (was-active (process-get proc 'dbg-active)) (was-in-recover (process-get proc 'is-recover)) (input-point (point-marker)) (match-jump (string-match ess-dbg-regexp-jump string)) (match-input (string-match ess-dbg-regexp-input string)) (match-skip (string-match ess-dbg-regexp-skip string)) (match-recover (and match-input (match-string 2 string))) ;; Selection: (match-active (or match-skip match-input)) ;;check for main prompt!! the process splits the output and match-end == nil might indicate this only (prompt-regexp "^>\\( [>+]\\)*\\( \\)$") ;; default prompt only (prompt-replace-regexp "^>\\( [>+]\\)*\\( \\)[^>+\n]") ;; works only with the default prompt (is-ready (not (inferior-ess-set-status proc string))) ) ; current-buffer is still the user's input buffer here (process-put proc 'is-recover match-recover) ;; insert \n after the prompt when necessary ;; todo: this should be in comint filters? no much difference (setq string (replace-regexp-in-string prompt-replace-regexp " \n" string nil nil 2)) (with-current-buffer pbuf (let ((pmark (process-mark proc))) (goto-char pmark) (beginning-of-line) ;;todo: do it with looking-back and primary-prompt (when (looking-at prompt-regexp) (goto-char pmark) (insert "\n") (set-marker pmark (point))) )) ;; replace long prompts (when inferior-ess-replace-long+ (setq string (replace-regexp-in-string "\\(\\+ \\)\\{4\\}\\(\\+ \\)+" ess-long+replacement string))) ;; COMINT (comint-output-filter proc string) ;; WATCH (when (and is-ready wbuff) ;; refresh only if the process is ready and wbuff exists, (not only in the debugger!!) (ess-watch-refresh-buffer-visibly wbuff)) ;; JUMP to line if debug expression was matched (when match-jump (with-current-buffer dbuff ;; insert string in *ess.dbg* buffer (goto-char (point-max)) (insert (concat "|-" string "-|"))) (if is-iess (save-selected-window ;; do not pop to the debugging line if in iESS (ess-dbg-goto-last-ref-and-mark dbuff t)) (ess-dbg-goto-last-ref-and-mark dbuff) )) ;; (with-current-buffer dbuff ;; uncomment to see the value of STRING just before debugger exists ;; (let ((inhibit-read-only t)) ;; (goto-char (point-max)) ;; (insert (concat " ---\n " string "\n ---")) ;; )) ;; SKIP if needed (when (and match-skip (not was-in-recover)) (process-send-string proc "n\n")) ;; EXIT the debuger (when (and was-active (not (or match-jump match-active)) is-ready) (ess-dbg-deactivate-overlays) (process-put proc 'dbg-active nil) ;; (message "|<-- exited debugging -->|") (when wbuff (ess-watch-refresh-buffer-visibly wbuff )) ) ;; ACTIVATE the debugger and trigger singlekey COMMAND if entered for the first time (when (and (not was-active) (or match-jump match-active)) (unless is-iess (ring-insert ess-dbg-forward-ring input-point)) (process-put proc 'dbg-active t) (when ess-dbg-auto-single-key-p (ess-dbg-singlekey-command t)) ) )) (defun ess-dbg-goto-last-ref-and-mark (dbuff &optional other-window) "Open the most recent debug reference, and set all the necessary marks and overlays. It's called from `inferior-ess-dbg-output-filter'. DBUFF must be the *ess.dbg* buffer associated with the process. If OTHER-WINDOW is non nil, attempt to open the location in a different window." (interactive) (let (t-debug-position ref) (with-current-buffer dbuff (setq ref (ess-dbg-get-next-ref -1 (point-max) ess-dbg-last-ref-marker ess-dbg-regexp-reference)) ; sets point at the end of found ref (when ref (move-marker ess-dbg-last-ref-marker (point-at-eol)) (move-marker ess-dbg-current-ref ess-dbg-last-ref-marker) ;; each new step repositions the current-ref! ) ) (when ref (if (apply 'ess-dbg-goto-ref other-window ref) (progn ;; if referenced buffer is found put overlays (setq t-debug-position (copy-marker (point-at-bol))) (if (equal t-debug-position ess-dbg-current-debug-position) (progn ;; highlights the overlay for ess-dbg-blink-interval seconds (overlay-put ess-dbg-current-debug-overlay 'face 'ess-dbg-blink-same-ref-face) (run-with-timer ess-dbg-blink-interval nil '(lambda () (overlay-put ess-dbg-current-debug-overlay 'face 'ess-dbg-current-debug-line-face) ) ) ) ;else (ess-dbg-activate-overlays) ) ) ;;else, buffer is not found: highlight and give the corresponding message (overlay-put ess-dbg-current-debug-overlay 'face 'ess-dbg-blink-ref-not-found-face) (run-with-timer ess-dbg-blink-interval nil '(lambda () (overlay-put ess-dbg-current-debug-overlay 'face 'ess-dbg-current-debug-line-face) ) ) (message "Referenced file %s is not found" (car ref)) )))) (defun ess-dbg-goto-ref (other-window file line &optional col tb-index) "Opens the reference given by FILE, LINE and COL, Try to open in a different window if OTHER-WINDOW is nil. Return the buffer if found, or nil otherwise be found. `ess-dbg-find-buffer' is used to find the FILE and open the associated buffer. If FILE is nil or TB-INDEX is not found returns nil. " (let ((mrk (car (ess-dbg-get-ref-rarker file line col tb-index)))) (when mrk (if (not other-window) (switch-to-buffer (marker-buffer mrk)) (pop-to-buffer (marker-buffer mrk))) (goto-char mrk)))) (defun ess-dbg-get-ref-rarker (file line &optional col tb-index) "Return the marker to the reference given by FILE, LINE and COL. Return list of two markers MK-start and MK-end. MK-start is the position of error. Mk-end is the begging of the line where error occurred (passed to `compilation-goto-locus' for highlighting). If buffer associated with FILE is not found, or line is nil, or TB-INDEX is not found return nil. " (if (stringp line) (setq line (string-to-number line))) (if (stringp col) (setq col (string-to-number col))) (when (and (string-match "\\(.*\\)@\\([0-9]+\\)\\'" file ) ;get tb-index (null tb-index)) (setq tb-index (string-to-number (match-string 2 file))) (setq file (match-string 1 file))) (let ((buffer (ess-dbg-find-buffer file)) pos ) (when (and buffer line) (with-current-buffer buffer (save-restriction (widen) ;; need this tothink: (goto-char 1) (setq pos (point)) (when tb-index (while (and (not (eq tb-index (get-text-property pos 'tb-index))) (setq pos (next-single-property-change pos 'tb-index))))) (when pos ;; if tb-index is not found return nil (goto-char pos) (forward-line (1- line)) (if col (goto-char (+ (point-at-bol) col)) (back-to-indentation)) (list (point-marker) (copy-marker (point-at-bol)))) ))))) (defun ess-dbg-find-buffer (filename ) "Find a buffer for file FILENAME. If FILENAME is not found at all, ask the user where to find it if `ess-dbg-ask-for-file' is non-nil. Search the directories in `ess-dbg-search-path'." (let ((dirs ess-dbg-search-path) (spec-dir default-directory) (is-org) ;; add current dir of ess here :TODO: buffsym buffer thisdir fmts name buffername ) (setq dirs (cons spec-dir dirs)) ;; current does not have priority!! todo:should be R working dir ;; 0. get the buffsym reference if discovered (message filename) (when (string-match "\\`\\(.*?\\)\\[\\(TB[0-9]+\\)\\]\\'" filename) ;;; org-mode etc (setq buffsym (match-string 2 filename) filename (match-string 1 filename)) ;; (message "buf:%s---file:%s" buffsym filename) (setq buffer (dolist (bf (buffer-list)) (when (equal (buffer-local-value 'ess--tb-buffer-sym bf) buffsym) (return bf))))) (unless buffer ;; 1. first search already open buffers for match (associate file might not even exist yet) (dolist (bf (buffer-list)) (with-current-buffer bf (when (and buffer-file-name (string-match (format "%s\\'" filename) buffer-file-name)) (setq buffer bf) (return)))) ;; 2. The file name is absolute. Use its explicit directory as ;; the first in the search path, and strip it from FILENAME. (when (and (null buffer) (file-name-absolute-p filename)) (setq filename (abbreviate-file-name (expand-file-name filename)) dirs (cons (file-name-directory filename) dirs) filename (file-name-nondirectory filename))) ;; 3. Now search the path. (while (and (null buffer) dirs ) (setq thisdir (car dirs)) (setq name (expand-file-name filename thisdir) buffer (and (file-exists-p name) (find-file-noselect name))) (setq dirs (cdr dirs))) ;; 4. Ask for file if not found (tothink: maybe remove this part?) (if (and (null buffer) ess-dbg-ask-for-file) (save-excursion ;This save-excursion is probably not right. (let* ((pop-up-windows t) (name (read-file-name (format "Find next line in (default %s): " filename) spec-dir filename t nil )) (origname name)) (cond ((not (file-exists-p name)) (message "Cannot find file `%s'" name) (ding) (sit-for 2)) ((and (file-directory-p name) (not (file-exists-p (setq name (expand-file-name filename name))))) (message "No `%s' in directory %s" filename origname) (ding) (sit-for 2)) (t (setq buffer (find-file-noselect name))))) ) )) buffer);; nil if not found ) (defun ess-dbg-get-next-ref (n &optional pt BOUND REG nF nL nC) "Move point to the next reference in the *ess.dbg* buffer. Must be called from *ess.dbg* buffer. It returns the reference in the form (file line col) /all strings/ , or NIL if not found . Prefix arg N says how many error messages to move forwards (or backwards, if negative). Optional arg PT, if non-nil, specifies the value of point to start looking for the next message, default to (point). BOUND is the limiting position of the search. REG is the regular expression to search with. nF - sub-expression of REG giving the 'file'; defaults to 1. nL - giving the 'line'; defaults to 2. nC - sub-expr giving the 'column'; defaults to 3. " (interactive "p") (unless ess-dbg-buf-p (error "Not in *ess.dbg* buffer.")) (setq nF (or nF 1) nL (or nL 2) nC (or nC 3)) (or pt (setq pt (point))) ;; (message "ess-dbg-last-ref-marker%s vs pt%s vs point-max%s" ess-dbg-last-ref-marker pt (point-max)) (goto-char pt) (if (search-forward-regexp REG BOUND t n) (list (match-string nF) (match-string-no-properties nL) (match-string-no-properties nC)) nil) ) (defun ess-dbg-next-ref-function (n &optional reset) "Advance to the next reference and visit the location given by the reference. This is the value of `next-error-function' in *ess.dbg* buffers." (interactive "p") (if reset (set-marker ess-dbg-current-ref ess-dbg-last-ref-marker)) (let ((loc (ess-dbg-get-next-ref n nil ess-dbg-current-ref)) ;; moves point to next/prev ref if any ; loc is (file . line_nr) dbuff ) (if loc (progn (set-marker ess-dbg-current-ref (line-end-position)) (set-marker overlay-arrow-position (line-beginning-position)) (setq dbuff (ess-dbg-find-buffer (car loc))) (switch-to-buffer dbuff) (save-restriction (widen) (goto-char 1) (forward-line (1- (cdr loc))) ) (move-marker ess-dbg-current-debug-position (line-beginning-position)) ; move the overlay-arrow (back-to-indentation) ) (if (>= 0 (or n 1)) (error "Moved past first debug line") (error "Moved past last debug line") ) ) ) ) (defun ess-dbg-singlekey-command (&optional wait) "Call commands defined in `ess-debug-singlekey-map'. Single-key input commands are those, which once executed do not requre the prefix command for subsequent invocation. For example, if the prefix command is 'M-c' and `ess-dbg-command-n' is bound to 'n' and `ess-dbg-command-c' is bound to 'c' then 'M-c n n c' executes `ess-dbg-command-n' twice and `ess-dbg-command-c' once. Any other input not defined in `ess-debug-singlekey-map' will cause the exit from single-key input mode. If WAIT is t, wait for next input and ignore the keystroke which triggered the command." (interactive) (let* ((ev last-command-event) (command (lookup-key ess-debug-singlekey-map (vector ev)))) (unless wait (call-interactively command)) (while (setq command (lookup-key ess-debug-singlekey-map (vector (setq ev (read-event))))) (funcall command ev) ) (push ev unread-command-events) ) ) (defun ess-dbg-command-digit (&optional ev) "Digit commands in recover mode. If suplied ev must be a proper key event or a string representing the digit." (interactive) (unless ev (setq ev last-command-event)) (let* ((ev-char (if (stringp ev) ev (char-to-string (event-basic-type ev)))) (proc (get-process ess-current-process-name)) (mark-pos (marker-position (process-mark proc))) (comint-prompt-read-only nil) prompt depth) (if (process-get proc 'is-recover) (with-current-buffer (process-buffer proc) (goto-char mark-pos) (save-excursion (when (re-search-backward "\\(?: \\|^\\)\\([0-9]+\\):[^\t]+Selection:" ess-tb-last-input t) (setq depth (string-to-number (match-string 1))) (when (> depth 9) (setq ev-char (ess-completing-read "Recover frame" (mapcar 'number-to-string (number-sequence depth 0 -1)) nil t ev-char nil))))) (setq prompt (delete-and-extract-region (point-at-bol) mark-pos)) (insert (concat prompt ev-char "\n")) (process-send-string proc (concat ev-char "\n")) (move-marker (process-mark proc) (max-char)) ) (message "Recover is not active") )) ) (defun ess-dbg-command-n (&optional ev) "Step next in debug mode. Equivalent to 'n' at the R prompt." (interactive) (if (not (ess-dbg-is-active)) (message "Debugging is not active") (if (ess-dbg-is-recover) (process-send-string (get-process ess-current-process-name) "0\n") (process-send-string (get-process ess-current-process-name) "\n") ))) (defun ess-dbg-previous-error (&optional ev) "Go to previous reference during the debug process. R doesn't support step backwards. This command just takes you through debug history." (interactive) (previous-error)) (defun ess-dbg-command-Q (&optional ev) "Quits the browser/debug in R process. Equivalent to 'Q' at the R prompt." (interactive) (let ((proc (get-process ess-current-process-name) )) (if (not (process-get proc 'dbg-active)) (message "Debugging is not active") (when (ess-dbg-is-recover) (process-send-string proc "0\n") (ess-wait-for-process proc nil 0.05)) (if (and (process-get proc 'dbg-active) (not (process-get proc 'is-recover))); still in debug mode (process-send-string proc "Q\n")) ))) (defun ess-dbg-command-c (&optional ev) "Continue the code execution. Equivalent of 'c' at the R prompt." (interactive) (let ((proc (get-process ess-current-process-name) )) (if (not (process-get proc 'dbg-active)) (message "Debugging is not active") (when (ess-dbg-is-recover) (process-send-string proc "0\n") (ess-wait-for-process proc nil 0.05)) ;; get out of recover mode (if (and (process-get proc 'dbg-active) ; still in debug mode (not (process-get proc 'is-recover))); still in debug mode (process-send-string proc "c\n")) ))) (defun ess-tb-set-last-input (&optional proc) "Move `ess-tb-last-input' marker to the process mark." (let* ((last-input-process (or proc (get-process ess-local-process-name))) (last-input-mark (copy-marker (process-mark last-input-process)))) (with-current-buffer (process-buffer last-input-process) (when (local-variable-p 'ess-tb-last-input) ;; TB might not be active in all processes (setq ess-tb-last-input last-input-mark) (goto-char last-input-mark) (inferior-ess-move-last-input-overlay) (comint-goto-process-mark) ) ) ) ) (defun ess-tracebug-source-current-file (&optional filename) "Save current file and source it in the .R_GlobalEnv environment." ;; make it more elaborate :todo: (interactive) (ess-force-buffer-current "R process to use: ") (let ((proc (get-process ess-local-process-name)) (file (or filename buffer-file-name))) (if (process-get proc 'developer) (ess-developer-source-current-file filename) (if (not file) ;; source the buffer content, org-mode scratch for ex. (let ((ess-tracebug-inject-source-p t)) (ess-tracebug-send-region proc (point-min) (point-max) nil (format "Sourced buffer '%s'" (propertize (buffer-name) 'face 'font-lock-function-name-face)))) (when (buffer-modified-p) (save-buffer)) (save-selected-window (ess-switch-to-ESS t)) (ess-tb-set-last-input) (process-send-string (get-process ess-current-process-name) (concat "\ninvisible(eval({source(file=\"" buffer-file-name "\")\n cat(\"Sourced file '" buffer-file-name "'\\n\")}, env=globalenv()))\n")) )))) ;;;_ + BREAKPOINTS (defface ess-bp-fringe-inactive-face '((((class color) (background light) (min-colors 88)) (:foreground "DimGray")) (((class color) (background dark) (min-colors 88)) (:foreground "LightGray")) (((background light) (min-colors 8)) (:foreground "blue")) (((background dark) (min-colors 8)) (:foreground "cyan")) ) "Face used to highlight inactive breakpoints." :group 'ess-debug) (defface ess-bp-fringe-logger-face '((((class color) (background light) (min-colors 88)) (:foreground "dark red")) (((class color) (background dark) (min-colors 88)) (:foreground "tomato1")) (((background light) (min-colors 8)) (:foreground "blue")) (((background dark) (min-colors 8)) (:foreground "cyan")) ) "Face used to highlight loggers." :group 'ess-debug) (defface ess-bp-fringe-browser-face '((((class color) (background light) (min-colors 88)) (:foreground "medium blue")) (((class color) (background dark) (min-colors 88)) (:foreground "deep sky blue")) (((background light) (min-colors 8)) (:foreground "blue")) (((background dark) (min-colors 8)) (:foreground "cyan")) ) "Face used to highlight 'browser' breakpoints." :group 'ess-debug) (defface ess-bp-fringe-recover-face '((((class color) (background light) (min-colors 88)) (:foreground "dark magenta")) (((class color) (background dark) (min-colors 88)) (:foreground "magenta")) (((background light) (min-colors 8)) (:foreground "magenta")) (((background dark) (min-colors 8)) (:foreground "magenta")) ) "Face used to highlight 'recover' breakpoints fringe." :group 'ess-debug) (defcustom ess-bp-type-spec-alist '((browser "browser()" "B>\n" filled-square ess-bp-fringe-browser-face) (recover "browser();recover()" "R>\n" filled-square ess-bp-fringe-recover-face) ) "List of lists of breakpoint types. Each sublist has five elements: 1- symbol giving the name of specification 2- R expression to be inserted 3- string to be displayed instead of the expression 4- fringe bitmap to use 5- face for fringe and displayed string." :group 'ess-debug :type '(alist :key-type symbol :value-type (group string string symbol face) ) ) (defcustom ess-bp-inactive-spec '(inactive "##" filled-square ess-bp-fringe-inactive-face) "List giving the inactive breakpoint specifications." ;; List format is identical to that of the elements of ;; `ess-bp-type-spec-alist' except that the second element giving ;; the R expression is meaningless here." ;;fixme: second element is missing make it nil for consistency with all other specs :group 'ess-debug) (defcustom ess-bp-conditional-spec '(conditional "browser(expr={%s})" "CB[ %s ]>\n" question-mark ess-bp-fringe-browser-face) "List giving the conditional breakpoint specifications. List format is identical to that of the elements of `ess-bp-type-spec-alist'. User is asked for the conditional expression to be replaced instead of %s in the second and third elements of the specifications." :group 'ess-debug) (defcustom ess-bp-logger-spec '(logger ".ess_log_eval('%s')" "L[ \"%s\" ]>\n" hollow-square ess-bp-fringe-logger-face) "List giving the loggers specifications. List format is identical to that of `ess-bp-type-spec-alist'." :group 'ess-debug) (defun ess-bp-get-bp-specs (type &optional condition no-error) "get specs for TYPE " (let ((spec-alist (cond ((eq type 'conditional) (let ((tl (copy-sequence ess-bp-conditional-spec))) (when (eq (length condition) 0) (setq condition "TRUE")) (setcar (cdr tl) (format (cadr tl) condition)) (setcar (cddr tl) (format (caddr tl) condition)) (list tl))) ((eq type 'logger) (let ((tl (copy-sequence ess-bp-logger-spec))) (when (eq (length condition) 0) (setq condition "watchLog")) (setcar (cdr tl) (format (cadr tl) condition)) (setcar (cddr tl) (format (caddr tl) condition)) (list tl))) (t ess-bp-type-spec-alist)))) (or (assoc type spec-alist) (if no-error nil (error "Undefined breakpoint type %s" type))))) (defun ess-bp-create (type &optional condition no-error) "Set breakpoint for the current line. Returns the begging position of the hidden text." (let* ((bp-specs (ess-bp-get-bp-specs type condition no-error)) (init-pos (point-marker)) (fringe-bitmap (nth 3 bp-specs)) (fringe-face (nth 4 bp-specs)) (displ-string (nth 2 bp-specs)) (bp-command (concat (nth 1 bp-specs) "##:ess-bp-end:##\n")) (bp-length (length bp-command)) (dummy-string (format "##:ess-bp-start::%s@%s:##\n" (car bp-specs) condition)) (dummy-length (length dummy-string)) insertion-pos ) (when bp-specs (set-marker init-pos (1+ init-pos)) (setq displ-string (propertize displ-string 'face fringe-face 'font-lock-face fringe-face)) (setq bp-command (propertize bp-command 'ess-bp t 'intangible 'ess-bp 'rear-nonsticky '(intangible ess-bp bp-type) 'bp-type type 'bp-substring 'command 'display displ-string )) (setq dummy-string (propertize (ess-tracebug--propertize dummy-string fringe-bitmap fringe-face "*") 'ess-bp t 'intangible 'ess-bp 'bp-type type 'bp-substring 'dummy )) (ess-tracebug--set-left-margin) (back-to-indentation) (setq insertion-pos (point) ) (insert (concat dummy-string bp-command)) (indent-for-tab-command) (goto-char (1- init-pos)) ;; sort of save-excursion insertion-pos ))) (defun ess-bp-recreate-all () "internal function to recreate all bp" (save-excursion (save-restriction (widen) (goto-char (point-min)) (while (re-search-forward "\\(##:ess-bp-start::\\(.*\\):##\n\\)\\([^#]*##:ess-bp-end:##\n\\)" nil t) (let ((dum-beg (match-beginning 1)) (dum-end (match-end 1)) (comm-beg (match-beginning 3)) (comm-end (match-end 3 )) (type (match-string 2)) dum-props condition) (when (string-match "^\\(\\w+\\)@\\(.*\\)\\'" type) (setq condition (match-string 2 type)) (setq type (match-string 1 type))) (setq type (intern type)) (let* ((bp-specs (ess-bp-get-bp-specs type condition t)) (displ-string (nth 2 bp-specs)) (fringe-face (nth 4 bp-specs)) (fringe-bitmap (nth 3 bp-specs))) (when bp-specs (setq displ-string (propertize displ-string 'face fringe-face 'font-lock-face fringe-face)) (add-text-properties comm-beg comm-end (list 'ess-bp t 'intangible 'ess-bp 'rear-nonsticky '(intangible ess-bp bp-type) 'bp-type type 'bp-substring 'command 'display displ-string )) (setq dum-props (if window-system (list 'display (list 'left-fringe fringe-bitmap fringe-face)) (list 'display (list '(margin left-margin) (propertize "dummy" 'font-lock-face fringe-face 'face fringe-face))))) (add-text-properties dum-beg dum-end (append dum-props (list 'ess-bp t 'intangible 'ess-bp 'bp-type type 'bp-substring 'dummy ))) ))))))) (defun ess-bp-get-bp-position-nearby () "Return the cons (beg . end) of breakpoint limit points closest to the current position. Only currently visible region of the buffer is searched. This command is intended for use in interactive commands like `ess-bp-toggle-state' and `ess-bp-kill'. Use `ess-bp-previous-position' in programs." (interactive) (let* ( (pos-end (if (get-char-property (1- (point)) 'ess-bp) (point) (previous-single-property-change (point) 'ess-bp nil (window-start)))) (pos-start (if (get-char-property (point) 'ess-bp) ;;check for bobp (point) (next-single-property-change (point) 'ess-bp nil (window-end)))) pos dist-up dist-down) (if (not (eq pos-end (window-start))) (setq dist-up (- (point) pos-end)) ) (if (not (eq pos-start (window-end))) (setq dist-down (- pos-start (point))) ) (if (and dist-up dist-down) (if (< dist-up dist-down) (cons (previous-single-property-change pos-end 'ess-bp nil (window-start)) pos-end) (cons pos-start (next-single-property-change pos-start 'ess-bp nil (window-end)))) (if dist-up (cons (previous-single-property-change pos-end 'ess-bp nil (window-start)) pos-end) (if dist-down (cons pos-start (next-single-property-change pos-start 'ess-bp nil (window-end))) ) ;(message "No breakpoints in the visible area")) )))) (defun ess-bp-previous-position () "Returns the cons (beg . end) of breakpoint limit points closest to the current position, nil if not found. " (let* ( (pos-end (if (get-char-property (1- (point)) 'ess-bp) (point) (previous-single-property-change (point) 'ess-bp )))) (if pos-end (cons (previous-single-property-change pos-end 'ess-bp) pos-end) ))) (defun ess-bp-set () (interactive) (let* ((pos (ess-bp-get-bp-position-nearby)) (same-line (if pos (and (<= (point-at-bol) (cdr pos)) (>= (point-at-eol) (car pos))))) (types ess-bp-type-spec-alist) (ev last-command-event) (com-char (event-basic-type ev)) bp-type ) (when same-line ;; set bp-type to next type in types (setq bp-type (get-text-property (car pos) 'bp-type)) (setq types (cdr (member (assq bp-type types) types))) ; nil if bp-type is last in the list (if (null types) (setq types ess-bp-type-spec-alist)) (ess-bp-kill) (indent-for-tab-command) ) (setq bp-type (pop types)) (ess-bp-create (car bp-type)) (while (eq (setq ev (read-event)) com-char) (if (null types) (setq types ess-bp-type-spec-alist)) (setq bp-type (pop types)) (ess-bp-kill) (ess-bp-create (car bp-type)) (indent-for-tab-command) ) (push ev unread-command-events) )) (defun ess-bp-set-conditional (condition) (interactive "sBreakpoint condition: ") (ess-bp-create 'conditional condition) (indent-for-tab-command) ) (defun ess-bp-set-logger (name) (interactive "sLogger name : ") (ess-bp-create 'logger name) (indent-for-tab-command) ) (defun ess-bp-kill () "Remove the breakpoint nearby" (interactive) (let ((pos (ess-bp-get-bp-position-nearby)) (init-pos (make-marker))) (if (null pos) (if (called-interactively-p) (message "No breakpoints nearby")) (if (eq (point) (point-at-eol)) (goto-char (1- (point)))) ;; work-arround for issue 3 (set-marker init-pos (point)) (goto-char (car pos)) (delete-region (car pos) (cdr pos)) (indent-for-tab-command) (goto-char init-pos) (if (eq (point) (point-at-eol)) (forward-char)) )) ) (defun ess-bp-kill-all nil "Delete all breakpoints in current buffer." (interactive) (let ((count 0) (init-pos (make-marker)) pos) (set-marker init-pos (1+ (point))) (save-excursion ;; needed if error (goto-char (point-max)) (while (setq pos (ess-bp-previous-position)) (goto-char (car pos)) (delete-region (car pos) (cdr pos)) (indent-for-tab-command) (setq count (1+ count)) ) (if (eq count 1) (message "Killed 1 breakpoint") (message "Killed %d breakpoint(s)" count)) ) (goto-char (1- init-pos)) )) (defun ess-bp-toggle-state () "Toggle the breakpoint between active and inactive states." (interactive) (save-excursion (let ((pos (ess-bp-get-bp-position-nearby)) (fringe-face (nth 3 ess-bp-inactive-spec)) (inhibit-point-motion-hooks t) ;; deactivates intangible property beg-pos-dummy end-pos-comment bp-specs beg-pos-command) (if (null pos) (message "No breakpoints in the visible region") (goto-char (car pos)) (setq beg-pos-command (previous-single-property-change (cdr pos) 'bp-substring nil (car pos))) (goto-char beg-pos-command) (if (equal (get-char-property (1- beg-pos-command) 'bp-substring) 'comment) (progn ;; not use beg-pos-command here ## is deleted (delete-region (previous-single-property-change beg-pos-command 'bp-substring nil (car pos)) beg-pos-command) (setq bp-specs (assoc (get-text-property (point) 'bp-type) ess-bp-type-spec-alist)) (put-text-property (car pos) (point) 'display (list 'left-fringe (nth 3 bp-specs) (nth 4 bp-specs))) ) (put-text-property (car pos) beg-pos-command ;; dummy display change 'display (list 'left-fringe (nth 2 ess-bp-inactive-spec) fringe-face)) (insert (propertize "##" 'ess-bp t 'intangible 'ess-bp 'display (propertize (nth 1 ess-bp-inactive-spec) 'face fringe-face) 'bp-type (get-char-property (point) 'bp-type) 'bp-substring 'comment ))))))) (defun ess-bp-make-visible () "Makes bp text visible." (interactive) (let ((pos (ess-bp-get-bp-position-nearby))) (set-text-properties (car pos) (cdr pos) (list 'display nil)) ) ) (defun ess-bp-next nil "Goto next breakpoint." (interactive) (let ((cur-pos (point)) (bp-pos (next-single-property-change (point) 'ess-bp))) (when bp-pos (save-excursion (goto-char bp-pos) (when (get-text-property (1- (point)) 'ess-bp) (setq bp-pos (next-single-property-change bp-pos 'ess-bp))))) (if bp-pos (goto-char bp-pos) (message "No breakpoints found") ))) (defun ess-bp-previous nil "Goto previous breakpoint." (interactive) (let ((cur-pos (point)) (bp-pos (previous-single-property-change (point) 'ess-bp))) (if bp-pos (goto-char (or (previous-single-property-change bp-pos 'ess-bp) bp-pos)) ;; (message "No breakpoints before the point found") ))) ;;;_ + WATCH (defun ess-watch-inject-commands () (ess-command " if(!exists('.ess_watch_expressions')){ assign('.ess_watch_expressions', list(), envir = .GlobalEnv) } assign('.ess_watch_eval', function(){ if(!exists('.ess_watch_expressions')){ assign('.ess_watch_expressions', list(), envir = .GlobalEnv) } if(length(.ess_watch_expressions) == 0L){ cat('\n# Watch list is empty!\n # a append new expression # i insert new expression # k kill # e edit the expression # r rename # n/p navigate # u/d,U move the expression up/down # q kill the buffer ') }else{ .parent_frame <- parent.frame() .essWEnames <- allNames(.ess_watch_expressions) len0p <- !nzchar(.essWEnames) .essWEnames[len0p] <- seq_along(len0p)[len0p] for(i in seq_along(.ess_watch_expressions)){ cat('\n@---- ', .essWEnames[[i]], ' ', rep.int('-', max(0, 35 - nchar(.essWEnames[[i]]))), '-@\n', sep = '') cat( paste('@---:', deparse(.ess_watch_expressions[[i]][[1L]])), ' \n', sep = '') tryCatch(print(eval(.ess_watch_expressions[[i]], envir = .parent_frame)), error = function(e) cat('Error:', e$message, '\n' ), warning = function(w) cat('warning: ', w$message, '\n' )) }} }, envir = .BaseNamespaceEnv); environment(.ess_watch_eval)<-.GlobalEnv; assign('.ess_log_eval', function(log_name){ if(!exists(log_name, envir = .GlobalEnv, inherits = FALSE)) assign(log_name, list(), envir = .GlobalEnv) log <- get(log_name, envir = .GlobalEnv, inherits = FALSE) .essWEnames <- allNames(.ess_watch_expressions) cur_log <- list() .parent_frame <- parent.frame() for(i in seq_along(.ess_watch_expressions)){ capture.output({ cur_log[[i]] <- tryCatch(eval(.ess_watch_expressions[[i]]), envir = .parent_frame, error = function(e) paste('Error:', e$message, '\n'), warning = function(w) paste('warning: ', w$message, '\n')) if(is.null(cur_log[i][[1]])) cur_log[i] <- list(NULL) }) } names(cur_log) <- .essWEnames assign(log_name, c(log, list(cur_log)), envir = .GlobalEnv) invisible(NULL) }, envir = .BaseNamespaceEnv) environment(.ess_log_eval) <- .GlobalEnv ")) (defvar ess-watch-command ;; assumes that every expression is a structure of length 1 as returned by parse. ".ess_watch_eval()\n") (if (fboundp 'define-fringe-bitmap) ;;not clear to me why is this not bound in SSH session? - :todo check (define-fringe-bitmap 'current-watch-bar [#b00001100] nil nil '(top t))) (defun ess-tracebug--set-left-margin () "Set the margin on non-X displays" (unless window-system (when (= left-margin-width 0) (setq left-margin-width 1) (set-window-buffer (selected-window) (current-buffer)) ))) (defun ess-watch-mode () "Major mode in ess-watch window. \\{ess-watch-mode-map}" (let ((cur-block (max 1 (ess-watch-block-at-point))) (dummy-string (ess-tracebug--propertize "|" 'current-watch-bar 'font-lock-keyword-face)) ) (kill-all-local-variables) (ess-tracebug--set-left-margin) (make-local-variable 'revert-buffer-function) (setq revert-buffer-function 'ess-watch-revert-buffer) (use-local-map ess-watch-mode-map) (setq major-mode 'ess-watch-mode) (setq mode-name (concat "watch " ess-current-process-name)) (setq font-lock-defaults '(inferior-ess-font-lock-keywords nil nil ((?' . ".")))) (turn-on-font-lock) (setq ess-watch-current-block-overlay (make-overlay (point-min) (point-max))) (overlay-put ess-watch-current-block-overlay 'line-prefix dummy-string) (overlay-put ess-watch-current-block-overlay 'face 'ess-watch-current-block-face) (ess-watch-set-current cur-block) ;; (when (require 'face-remap nil t) ;; scale the font (setq text-scale-mode-amount ess-watch-scale-amount) (text-scale-mode 1) ; (text-scale-mode -1) ;;restore to default ) )) (defun ess-watch () "Run ess-watch mode on R objects. This is the main function. See documentation for `ess-watch-mode' though for more information. \\{ess-watch-mode-map} " (interactive) (let ((wbuf (get-buffer-create ess-watch-buffer))) (set-buffer wbuf) (ess-watch-mode) (ess-watch-refresh-buffer-visibly wbuf) ;; evals the ess-command and displays the buffer if not visible (pop-to-buffer wbuf) (set-window-dedicated-p (selected-window) 1) ;; not strongly dedicated ) ) (defvar ess-watch-mode-map nil "Keymap for the *R watch* buffer. \\{ess-watch-mode-map} ") (if ess-watch-mode-map () (setq ess-watch-mode-map (make-sparse-keymap)) (define-key ess-watch-mode-map "?" 'ess-watch-help) (define-key ess-watch-mode-map "k" 'ess-watch-kill) ; (define-key ess-watch-mode-map "u" 'ess-watch-undelete) ;; editing requires a little more work. (define-key ess-watch-mode-map "a" 'ess-watch-add) (define-key ess-watch-mode-map "i" 'ess-watch-insert) (define-key ess-watch-mode-map "e" 'ess-watch-edit-expression) (define-key ess-watch-mode-map "r" 'ess-watch-rename) (define-key ess-watch-mode-map "q" 'ess-watch-quit) (define-key ess-watch-mode-map "u" 'ess-watch-move-up) (define-key ess-watch-mode-map "U" 'ess-watch-move-down) (define-key ess-watch-mode-map "d" 'ess-watch-move-down) (define-key ess-watch-mode-map "n" 'ess-watch-next-block) (define-key ess-watch-mode-map "p" 'ess-watch-previous-block) ;; R mode keybindings. (define-key ess-watch-mode-map "\C-c\C-s" 'ess-watch-switch-process) (define-key ess-watch-mode-map "\C-c\C-y" 'ess-switch-to-ESS) (define-key ess-watch-mode-map "\C-c\C-z" 'ess-switch-to-end-of-ESS) (define-key ess-watch-mode-map "g" 'revert-buffer) ;; Debug keys: ) (defface ess-watch-current-block-face '( ;; (((class grayscale) ;; (background light)) (:background "DimGray")) ;; (((class grayscale) ;; (background dark) (min-colors 88)) (:background "LightGray")) (((class color) (background light)) (min-colors 88) (:background "tan")) (((class color) (background dark) (min-colors 88)) (:background "gray10")) ) "Face used to highlight current watch block." :group 'ess-debug ) (defvar ess-watch-current-block-overlay nil "The overlay for currently selected block in the R watch buffer .") (make-variable-buffer-local 'ess-watch-current-block-overlay) (defvar ess-watch-buffer "*R watch*" "Name of the watch buffer.") (defvar ess-watch-start-block "@----" ;; fixme: make defcustom and modify the injected command correspondingly "String indicating the beginning of a block in watch buffer." ;; :group 'ess-debug ;; :type 'string ) (defvar ess-watch-start-expression "@---:" "String indicating the beginning of an R expression in watch buffer." ;; :group 'ess-debug ;; :type 'string ) (defcustom ess-watch-height-threshold 40 "Minimum height for splitting *R* windwow sensibly to make space for watch window. Has exactly the same meaning and initial value as `split-height-threshold'." :group 'ess-debug :type 'integer) (defcustom ess-watch-width-threshold 70 "Minimum width for splitting *R* windwow sensibly to make space for watch window. Has exactly the same meaning and initial value as `split-width-threshold'." :group 'ess-debug :type 'integer) (defcustom ess-watch-scale-amount -1 "The number of steps to scale the watch font down (up). Each step scales the height of the default face in the watch window by the variable `text-scale-mode-step' (a negative number of steps decreases the height by the same amount)") (defvar ess-watch-help nil "Keymap for the *R watch* buffer. \\{ess-watch-mode-map} ") (defun ess-watch-help () (interactive) (describe-variable 'ess-watch-help)) (defun ess-watch-block-limits-at-point () "Return start and end positions of the watch block." (interactive) (save-excursion (let ((curr (point)) start-pos end-pos) (end-of-line) (setq start-pos (if (re-search-backward ess-watch-start-block nil t ) (point) (point-min))) (goto-char curr) (beginning-of-line) (setq end-pos (if (re-search-forward ess-watch-start-block nil t) (match-beginning 0) (point-max))) (list start-pos end-pos) ))) (defun ess-watch-block-at-point () "return the current block's order count, 0 if no block was found." (save-excursion (let ((cur-point (point)) (count 0)) (goto-char (point-min)) (while (re-search-forward ess-watch-start-block cur-point t) (setq count (1+ count))) count ))) (defun ess-watch-set-current (nr) "Move the overlay over the block with count NR in current watch buffer" (goto-char (point-min)) (re-search-forward ess-watch-start-expression nil t nr) (goto-char (match-end 0)) (apply 'move-overlay ess-watch-current-block-overlay (ess-watch-block-limits-at-point)) ) (defun ess-watch-make-alist () "Create an association list of expression from current buffer (better be a watch buffer). Each element of assoc list is of the form (pos name expr) where pos is an unique integer identifying watch blocks by position, name is a string giving the name of expression block, expr is a string giving the actual R expression." (interactive) (save-excursion (let* ((reg-name (concat "^" ess-watch-start-block " *\\(\\S-*\\).*$")) (reg-expr (concat "^" ess-watch-start-expression "\\s-*\\(.*\\)$")) (reg-all (concat "\\(" reg-name "\\)\n\\(" reg-expr "\\)")) (pos 0) wal name expr) (goto-char (point-min)) (while (re-search-forward reg-all nil t) (setq pos (+ 1 pos)) (setq name (match-string-no-properties 2)) (setq expr (match-string-no-properties 4)) (if (not (eq (string-to-number name) 0)) ;;if number of any kind set the name to "" (setq name "")) (setq wal (append wal (list (list pos name expr))) ) ) wal ))) (defun ess-watch-parse-assoc (al) "Return a string of the form 'assign(\".ess_watch_expressions\", list(a = parse(expr_a), b= parse(expr_b)), envir = .GlobalEnv)' ready to be send to R process. AL is an association list as return by `ess-watch-make-alist'" (concat "assign(\".ess_watch_expressions\", list(" (mapconcat '(lambda (el) (if (> (length (cadr el) ) 0) (concat "`" (cadr el) "` = parse(text = '" (caddr el) "')") (concat "parse(text = '" (caddr el) "')"))) al ", ") "), envir = .GlobalEnv)\n")) (defun ess-watch-install-.ess_watch_expressions () ;; used whenever watches are added/deleted/modified from the watch ;; buffer. this is the only way to insert expressions into ;; .ess_watch_expressions object in R. Assumes R watch being the current ;; buffer, otherwise will most likely install empty list. (interactive) (process-send-string (get-ess-process ess-current-process-name) (ess-watch-parse-assoc (ess-watch-make-alist))) ;;todo: delete the prompt at the end of proc buffer todo: defun ess-send-string!! (sleep-for 0.05) ;; need here, if ess-command is used immediately after, for some weird reason the process buffer will not be changed ) (defun ess-watch-revert-buffer (ignore noconfirm) "Update the watch buffer Arguments IGNORE and NOCONFIRM currently not used." (ess-watch) (message "Watch reverted")) (defun ess-watch-refresh-buffer-visibly (wbuf &optional sleep no-prompt-check) "Eval `ess-watch-command' and direct the output into the WBUF. Call `ess-watch-buffer-show' to make the buffer visible, without selecting it. This function is used for refreshing the watch window after each step during the debugging." ;; assumes that the ess-watch-mode is on!! ;; particularly ess-watch-current-block-overlay is installed (interactive) (ess-watch-buffer-show wbuf) ;; if visible do nothing (with-current-buffer wbuf (let ((curr-block (max 1 (ess-watch-block-at-point)))) ;;can be 0 if (setq buffer-read-only nil) (ess-command ess-watch-command wbuf sleep no-prompt-check) ;; delete the ++++++> line ;; not very reliable but works fine so far. (goto-char (point-min)) (delete-region (point-at-bol) (+ 1 (point-at-eol))) (ess-watch-set-current curr-block) (set-window-point (get-buffer-window wbuf) (point)) (setq buffer-read-only t) ))) (defun ess-watch-buffer-show (buffer-or-name) "Make watch buffer BUFFER-OR-NAME visible, and position acordingly. If already visible, do nothing. Currently the only positioning rule implemented is to split the R process window in half. The behavior is controlled by `split-window-sensibly' with parameters `split-height-threshold' and `split-width-threshold' replaced by `ess-watch-height-threshold' and `ess-watch-width-threshold' respectively." (interactive) (unless (get-buffer-window ess-watch-buffer 'visible) (save-selected-window (ess-switch-to-ESS t) (let* ((split-width-threshold ess-watch-width-threshold) (split-height-threshold ess-watch-height-threshold) (win (split-window-sensibly (selected-window)))) (if win (set-window-buffer win buffer-or-name) (display-buffer buffer-or-name) ;; resort to usual mechanism if could not split )) ))) (defun ess-watch-quit () "Quit (kill) the watch buffer. If watch buffer exists, it is displayed during the debug process. The only way to avoid the display, is to kill the buffer." (interactive) (kill-buffer) ;; dedicated, window is deleted unless not the only one ) ;;;_ + MOTION (defun ess-watch-next-block (&optional n) "Move the overlay over the next block. Optional N if supplied gives the number of steps forward backward-char." (interactive "P") (setq n (prefix-numeric-value n)) (goto-char (overlay-end ess-watch-current-block-overlay)) (unless (re-search-forward ess-watch-start-expression nil t n) (goto-char (point-min)) ;;circular but always moves to start! (re-search-forward ess-watch-start-expression nil t 1) ) (apply 'move-overlay ess-watch-current-block-overlay (ess-watch-block-limits-at-point)) ) (defun ess-watch-previous-block (&optional n) "Move the overlay over the previous block. Optional N if supplied gives the number of backward steps." (interactive "P") (setq n (prefix-numeric-value n)) (goto-char (overlay-start ess-watch-current-block-overlay)) (unless (re-search-backward ess-watch-start-expression nil t n) (goto-char (point-max)) ;;circular but always moves to last! (re-search-backward ess-watch-start-expression nil t 1) ) (goto-char (match-end 0)) (apply 'move-overlay ess-watch-current-block-overlay (ess-watch-block-limits-at-point)) ) ;;;_ + BLOCK MANIPULATION and EDITING (defun ess-watch-rename () "Rename the currently selected watch block. " (interactive) (end-of-line) (unless (re-search-backward ess-watch-start-block nil 1) (error "Can not find a watch block")) (let ((reg-name (concat ess-watch-start-block " *\\(\\S-*\\).*$")) name start end) ;; (reg-expr (concat "^" ess-watch-start-expression "\\s-*\\(.*\\)$")) ;; (reg-all (concat "\\(" reg-name "\\)\n\\(" reg-expr "\\)")) ;; (pos 0) wal name expr) (unless (re-search-forward reg-name (point-at-eol) 1) (error "Can not find the name substring in the current watch block ")) (setq name (match-string-no-properties 1)) (setq start (match-beginning 1)) (setq end (match-end 1)) (goto-char start) ;; todo: highlight the name in R-watch here (setq name (read-string (concat "New name (" name "): ") nil nil name) ) (setq buffer-read-only nil) (delete-region start end) (insert name) (setq buffer-read-only t) (ess-watch-install-.ess_watch_expressions) (ess-watch-refresh-buffer-visibly (current-buffer)) )) (defun ess-watch-edit-expression () "Edit in the minibuffer the R expression from the current watch block. " (interactive) (end-of-line) (unless (re-search-backward ess-watch-start-block nil 1) (error "Can not find a watch block")) (let ((reg-expr (concat ess-watch-start-expression " *\\(.*\\)$")) expr start end) (unless (re-search-forward reg-expr nil 1) (error "Can not find an expression string in the watch block")) (setq expr (match-string-no-properties 1)) (setq start (match-beginning 1)) (setq end (match-end 1)) (goto-char start) ;; todo: highlight the name in R-watch here (setq expr (read-string "New expression: " expr nil expr) ) (setq buffer-read-only nil) (delete-region start end) (insert expr) (setq buffer-read-only t) (ess-watch-install-.ess_watch_expressions) (ess-watch-refresh-buffer-visibly (current-buffer)) )) (defun ess-watch-add () "Ask for new R expression and name and append it to the end of the list of watch expressions" (interactive) (let (nr expr name) (goto-char (point-max)) (setq nr (number-to-string (1+ (ess-watch-block-at-point)))) (setq name nr) ;; (setq name (read-string (concat "Name (" nr "):") nil nil nr )) ;;this one is quite annoying and not really needed than for logging (setq expr (read-string "New expression: " nil nil "\"Empty watch!\"")) (setq buffer-read-only nil) (insert (concat "\n" ess-watch-start-block " " name " -@\n" ess-watch-start-expression " " expr "\n")) (setq buffer-read-only t) (ess-watch-install-.ess_watch_expressions) )) (defun ess-watch-insert () "Ask for new R expression and name and insert it in front of current watch block" (interactive) (let (nr expr name) (setq nr (number-to-string (ess-watch-block-at-point))) (setq name nr) ;; (setq name (read-string (concat "Name (" nr "):") nil nil nr )) (setq expr (read-string "New expression: " nil nil "\"Empty watch!\"")) (re-search-backward ess-watch-start-block nil 1) ;;point-min if not found (setq buffer-read-only nil) (insert (concat "\n" ess-watch-start-block " " name " -@\n" ess-watch-start-expression " " expr "\n")) (setq buffer-read-only t) (ess-watch-install-.ess_watch_expressions) )) (defun ess-watch-move-up () "Move the current block up." (interactive) (let ((nr (ess-watch-block-at-point)) wbl) (when (> nr 1) (setq buffer-read-only nil) (setq wbl (apply 'delete-and-extract-region (ess-watch-block-limits-at-point))) (re-search-backward ess-watch-start-block nil t 1) ;; current block was deleted, point is at the end of previous block (insert wbl) (ess-watch-install-.ess_watch_expressions) (setq buffer-read-only t) ))) (defun ess-watch-move-down () "Move the current block down." (interactive) (let ((nr (ess-watch-block-at-point)) (nr-all (save-excursion (goto-char (point-max)) (ess-watch-block-at-point))) wbl) (when (< nr nr-all) (setq buffer-read-only nil) (setq wbl (apply 'delete-and-extract-region (ess-watch-block-limits-at-point))) (end-of-line) (when (re-search-forward ess-watch-start-block nil 1 1) ;; current block was deleted, point is at the end of previous block or point-max (goto-char (match-beginning 0))) (insert wbl) (ess-watch-install-.ess_watch_expressions) (setq buffer-read-only t) ))) (defun ess-watch-kill () "Kill the current block" (interactive) (setq buffer-read-only nil) (apply 'delete-region (ess-watch-block-limits-at-point)) (ess-watch-install-.ess_watch_expressions) ) ;;;_ + Debug/Undebug at point (defun ess-dbg-inject-un/debug-commands () ;; fixme: bug: if no starting new-line,ess-command hangs (ess-command " local({ .ess_dbg_getTracedAndDebugged <- function(){ tr_state <- tracingState(FALSE) on.exit(tracingState(tr_state)) generics <- methods::getGenerics() all_traced <- c() for(i in seq_along(generics)){ genf <- methods::getGeneric(generics[[i]], package=generics@package[[i]]) if(!is.null(genf)){ ## might happen !! v.2.13 menv <- methods::getMethodsForDispatch(genf) traced <- unlist(eapply(menv, is, 'traceable', all.names=TRUE)) if(length(traced) && any(traced)) all_traced <- c(paste(generics[[i]],':', names(traced)[traced],sep=''), all_traced) if(!is.null(tfn<-getFunction(generics[[i]], mustFind=FALSE, where = .GlobalEnv))&&is(tfn, 'traceable')) # if the default is traced, it does not appear in the menv :() all_traced <- c(generics[[i]], all_traced) } } debugged <- apropos('.', mode = 'function') ## traced function don't appear here. Not realy needed and would affect performance. debugged <- debugged[which(unlist(lapply(debugged, isdebugged) , recursive=FALSE, use.names=FALSE))] unique(c(debugged, all_traced)) } .ess_dbg_UntraceOrUndebug <- function(name){ tr_state <- tracingState(FALSE) on.exit(tracingState(tr_state)) ## name is a name of a function to be undebugged or has a form name:Class1#Class2#Class3 for traced methods name <- strsplit(name, ':', fixed = TRUE)[[1]] if(length(name)>1){ ## a method fun <- name[[1]] sig <- strsplit(paste(name[-1], collapse=''), '#', fixed=TRUE)[[1]] untrace(fun, signature = sig) }else{ ## function if(is(getFunction(name), 'traceable')) untrace(name) else undebug(name) } } .ess_dbg_UndebugALL <- function(funcs){ tr_state <- tracingState(FALSE) on.exit(tracingState(tr_state)) invisible(lapply(funcs, .ess_dbg_UntraceOrUndebug)) } inject_env <- .GlobalEnv ##.BaseNamespaceEnv environment(.ess_dbg_UndebugALL) <- environment(.ess_dbg_UntraceOrUndebug) <- environment(.ess_dbg_getTracedAndDebugged) <- .GlobalEnv ## to see all the funcs assign('.ess_dbg_getTracedAndDebugged', .ess_dbg_getTracedAndDebugged, envir= inject_env) assign('.ess_dbg_UntraceOrUndebug', .ess_dbg_UntraceOrUndebug, envir= inject_env) assign('.ess_dbg_UndebugALL', .ess_dbg_UndebugALL, envir= inject_env) }) ")) (defun ess-dbg-get-signatures (method) "Get signatures for the method METHOD" (let ((tbuffer (get-buffer-create " *ess-command-output*")); initial space: disable-undo signatures curr-point) (save-excursion (ess-if-verbose-write (format "ess-get-signatures*(%s).. " method)) (ess-command (concat "showMethods(\"" method "\")\n") tbuffer) (message ess-local-process-name) (message ess-current-process-name) (ess-if-verbose-write " [ok] ..\n") (set-buffer tbuffer) (goto-char (point-min)) (if (not (re-search-forward "Function:" nil t)) (progn (ess-if-verbose-write "not seeing \"Function:\".. \n") (error (buffer-string)) ;; (error "Cannot trace method '%s' (Is it a primitive method which you have already traced?)" method) ) ;; (setq curr-point (point)) ;; (while (re-search-forward ", " nil t) ;replace all ", " with ":" for better redability in completion buffers?? ;; (replace-match ":")) ;; (goto-char curr-point) (while (re-search-forward "^.+$" nil t) (setq signatures (cons (match-string-no-properties 0) signatures)))) ; (kill-buffer tbuffer) ) signatures )) (defun ess-dbg-flag-for-debugging () "Set the debugging flag on a function. Ask the user for a function and if it turns to be generic, ask for signature and trace it with browser tracer." (interactive) (let ((tbuffer (get-buffer-create " *ess-command-output*")) ;; output buffer name is hard-coded in ess-inf.el (all-functions (ess-get-words-from-vector "apropos(\".\", mode = \"function\")\n")) obj-at-point ufunc signature default-string out-message ) (setq obj-at-point (car (ess-helpobjs-at-point all-functions))) (setq ufunc (ess-completing-read "Debug" all-functions nil t nil nil obj-at-point)) ;; check if is generic (if (equal "TRUE" (car (ess-get-words-from-vector (concat "as.character(isGeneric(\"" ufunc "\"))\n")))) (save-excursion ;; if so, find the signature (setq signature (ess-completing-read (concat "Method for generic '" ufunc "'") (ess-dbg-get-signatures ufunc) ;;signal error if not found nil t nil nil "*default*")) (if (equal signature "*default*") (progn (ess-command (concat "trace(\"" ufunc "\", tracer = browser)\n") tbuffer) ;debug the default ufunc ) (ess-command (concat "trace(\"" ufunc "\", tracer = browser, signature = c(" signature "))\n") tbuffer) ) (set-buffer tbuffer) (setq out-message (buffer-substring-no-properties (point-min) (point-max))) ;; give appropriate message or error ) ;;else, not S4 generic (when (car (ess-get-words-from-vector (concat "as.character(.knownS3Generics[\"" ufunc "\"])\n"))) (setq all-functions (ess-get-words-from-vector (format "local({gens<-methods('%s');as.character(gens[attr(gens, 'info')$visible])})\n" ufunc))) (setq all-functions (delq nil (mapcar (lambda (el) (if (not (char-equal ?* (aref el (1- (length el))))) el)) all-functions))) ;; cannot debug nonvisible functions, ;; tothink: ess-developer? (setq ufunc (ess-completing-read (format "Method for S3 generic '%s'" ufunc) all-functions nil t))) (save-excursion (ess-command (concat "debug(\"" ufunc "\")\n") tbuffer) (set-buffer tbuffer) (if (= (point-max) 1) (setq out-message (format "Flagged function '%s' for debugging" ufunc)) (setq out-message (buffer-substring-no-properties (point-min) (point-max))) ;; error occurred ))) (message out-message) )) (defun ess-dbg-unflag-for-debugging () "Prompt for the debugged/traced function or method and undebug/untrace it." (interactive) (let ((tbuffer (get-buffer-create " *ess-command-output*")); initial space: disable-undo\ (debugged (ess-get-words-from-vector ".ess_dbg_getTracedAndDebugged()\n")) out-message fun def-val) (prin1 debugged) (if (eq (length debugged) 0) (setq out-message "No debugged or traced functions/methods found") (setq def-val (if (eq (length debugged) 1) (car debugged) "*ALL*")) (setq fun (ess-completing-read "Un-debug: " debugged nil t nil nil def-val)) (if (equal fun "*ALL*" ) (ess-command (concat ".ess_dbg_UndebugALL(c(\"" (mapconcat '(lambda (x) x) debugged "\", \"") "\"))\n") tbuffer) (ess-command (concat ".ess_dbg_UntraceOrUndebug(\"" fun "\")\n") tbuffer) ) (with-current-buffer tbuffer (if (= (point-max) 1) ;; not reliable todo: (setq out-message (format "Un-debugged '%s' " fun)) (setq out-message (buffer-substring-no-properties (point-min) (point-max))) ;; untrace info or warning, or error occurred ))) (message out-message) )) ;;;_ * Kludges and Fixes ;;; delete-char and delete-backward-car do not delete whole intangible text (defadvice delete-char (around delete-backward-char-intangible activate) "When about to delete a char that's intangible, delete the whole intangible region Only do this when #chars is 1" (if (and (= (ad-get-arg 0) 1) (get-text-property (point) 'intangible)) (progn (kill-region (point) (next-single-property-change (point) 'intangible)) (indent-for-tab-command) ) ad-do-it )) (defadvice delete-backward-char (around delete-backward-char-intangible activate) "When about to delete a char that's intangible, delete the whole intangible region Only do this when called interactively and #chars is 1" (if (and (= (ad-get-arg 0) 1) (> (point) (point-min)) (get-text-property (1- (point)) 'intangible)) (progn (kill-region (previous-single-property-change (point) 'intangible) (point)) (indent-for-tab-command) ) ad-do-it )) ;;; previous-line gets stuck if next char is intangible (defadvice previous-line (around solves-intangible-text-kludge activate) "When about to move to previous line when next char is intanbible, step char backward first" (if (and (or (null (ad-get-arg 0)) (= (ad-get-arg 0) 1)) (get-text-property (point) 'intangible)) (backward-char 1) ) ad-do-it ) (defun inferior-R-input-sender2 (proc string) (save-current-buffer (let ((help-string (or (string-match inferior-R-1-input-help string) (string-match inferior-R-2-input-help string))) (page-string (string-match inferior-R-page string))) (if (or help-string page-string) (let ((string1 (match-string 1 string)) (string2 (match-string 2 string))) ;;(ess-write-to-dribble-buffer (format " new string='%s'\n" string2)) (beginning-of-line) ;; (if (looking-at inferior-ess-primary-prompt) ;; (progn ;; (end-of-line) ;; (insert-before-markers string)) ;; emacs 21.0.105 and older ;; (delete-backward-char 1)) ;; emacs 21.0.106 and newer (if help-string ; more frequently (let ((inferior-ess-help-command (if (string= string1 "?") inferior-ess-help-command "help.search(\"%s\")\n"))) (progn (ess-display-help-on-object (if (string= string2 "") "help" string2)) (ess-eval-linewise "\n"))) ;; else page-string (let ((str2-buf (concat string2 ".rt"))) (ess-command (concat string2 "\n") (get-buffer-create str2-buf)) (ess-eval-linewise "\n") (switch-to-buffer-other-window str2-buf) (R-transcript-mode)))) ;; else: normal command ;; (inferior-ess-input-sender proc string t) (inferior-ess-mark-as-busy proc) (process-send-string proc (concat string "\n")) )))) (ess-if-verbose-write "\n<- debug done") (provide 'ess-tracebug) ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ;;; ess-tracebug.el ends here