;; This file adds support for ruby-debug (rdebug) in Emacs. ;; Copyright (C) 2007 Martin Nordholts ;; ;; This file is based on 'rubydb3x.el' that comes with Ruby which is ;; Copyright (C) Yukihiro Matsumoto aka Matz ;; ;; Installation: ;; ------------- ;; ;; 1. Make sure you have ruby-debug on your system (test by running ;; the commmand 'rdebug -v' in a shell). ;; ;; 2. Copy this file into e.g. ~/.elisp and make sure this is in ;; your ~/.emacs: ;; ;; (add-to-list 'load-path "~/.elisp") ;; (load-library "rdebug") ;; ;; you can then start the debugger with M-x rdebug ;; ;; 3. Setup convenient keybindings etc. This is what I have: ;; ;; (global-set-key [f9] 'gud-step) ;; (global-set-key [f10] 'gud-next) ;; (global-set-key [f11] 'gud-cont) ;; ;; (global-set-key "\C-c\C-d" 'rdebug) ;; ;; 4. Debug like crazy! ;; ;; Bugs: ;; ----- ;; ;; Basic functionality works fine, though there might be a bug hiding somewhere. (require 'gud) (provide 'rdebug) ;; ====================================================================== ;; rdebug functions ;;; History of argument lists passed to rdebug. (defvar gud-rdebug-history nil) (if (fboundp 'gud-overload-functions) (defun gud-rdebug-massage-args (file args) (cons file args)) (defun gud-rdebug-massage-args (file args) args)) ;; There's no guarantee that Emacs will hand the filter the entire ;; marker at once; it could be broken up across several strings. We ;; might even receive a big chunk with several markers in it. If we ;; receive a chunk of text which looks like it might contain the ;; beginning of a marker, we save it here between calls to the ;; filter. (defvar gud-rdebug-marker-acc "") (make-variable-buffer-local 'gud-rdebug-marker-acc) (defun gud-rdebug-marker-filter (string) (setq gud-rdebug-marker-acc (concat gud-rdebug-marker-acc string)) (let ((output "")) ;; Process all the complete markers in this chunk. (while (string-match "\\([^:\n]*\\):\\([0-9]+\\):.*\n" gud-rdebug-marker-acc) (setq ;; Extract the frame position from the marker. gud-last-frame (cons (substring gud-rdebug-marker-acc (match-beginning 1) (match-end 1)) (string-to-int (substring gud-rdebug-marker-acc (match-beginning 2) (match-end 2)))) ;; Append any text before the marker to the output we're going ;; to return - we don't include the marker in this text. output (concat output (substring gud-rdebug-marker-acc 0 (match-beginning 0))) ;; Set the accumulator to the remaining text. gud-rdebug-marker-acc (substring gud-rdebug-marker-acc (match-end 0)))) (setq output (concat output gud-rdebug-marker-acc) gud-rdebug-marker-acc "") output)) (defun gud-rdebug-find-file (f) (save-excursion (let ((buf (find-file-noselect f))) (set-buffer buf) ;; (gud-make-debug-menu) buf))) (defvar rdebug-command-name "rdebug" "File name for executing rdebug.") ;;;###autoload (defun rdebug (command-line) "Run rdebug on program FILE in buffer *gud-FILE*. The directory containing FILE becomes the initial working directory and source-file directory for your debugger." (interactive (list (read-from-minibuffer "Run rdebug (like this): " (if (consp gud-rdebug-history) (car gud-rdebug-history) (concat rdebug-command-name " ")) nil nil '(gud-rdebug-history . 1)))) (if (not (fboundp 'gud-overload-functions)) (gud-common-init command-line 'gud-rdebug-massage-args 'gud-rdebug-marker-filter 'gud-rdebug-find-file) (gud-overload-functions '((gud-massage-args . gud-rdebug-massage-args) (gud-marker-filter . gud-rdebug-marker-filter) (gud-find-file . gud-rdebug-find-file))) (gud-common-init command-line rdebug-command-name)) (gud-def gud-break "break %d%f:%l" "\C-b" "Set breakpoint at current line in current file.") ; (gud-def gud-remove "delete %d%f:%l" "\C-d" "Remove breakpoint at current line in current file.") (gud-def gud-step "step" "\C-s" "Step one source line with display.") (gud-def gud-next "next" "\C-n" "Step one line (skip functions).") (gud-def gud-cont "cont" "\C-r" "Continue with display.") (gud-def gud-finish "finish" "\C-f" "Finish executing current function.") (gud-def gud-up "up %p" "<" "Up N stack frames (numeric arg).") (gud-def gud-down "down %p" ">" "Down N stack frames (numeric arg).") (gud-def gud-print "p %e" "\C-p" "Evaluate ruby expression at point.") (setq comint-prompt-regexp "^(rdb:-) ") (if (boundp 'comint-last-output-start) (set-marker comint-last-output-start (point))) (set (make-local-variable 'paragraph-start) comint-prompt-regexp) (run-hooks 'rdebug-mode-hook) )