debugger2 1.0.0.beta1

data/man/rdebug.1

@@ -0,0 +1,241 @@
+.\" $Id: rdebug.1 516 2007-12-31 05:55:24Z rockyb $
+.TH rdebug 1 
+.SH NAME
+rdebug \- Fast Ruby debugger
+.SH SYNOPSIS
+.B rdebug 
+[debugger-options] 
+rdebug
+[script-options...]
+.SH "DESCRIPTION"
+This manual page documents briefly the
+.BR rdebug
+command.
+.PP
+.B rdebug
+is a fast implementation of the standard Ruby debugger debug.rb.  It
+is implemented by utilizing a Ruby C API hook, allows for remote
+debugging and can be used as the Ruby debugger backend interface for a
+development environment.
+.PP
+The commands generally follow gdb's command set unless there's good
+reason not to.
+
+.PP
+rdebug can do four main kinds of things (plus other things in support of
+these) to help you catch bugs in the act:
+
+.TP
+\ \ \ \(bu
+Start or restart your Ruby script, specifying arguments that might
+affect its behavior.
+
+.TP
+\ \ \ \(bu
+Make your program stop at various points possibly determined by
+specified conditions.
+
+.TP
+\ \ \ \(bu
+Examine what has happened when your program has stopped.
+
+.TP
+\ \ \ \(bu
+Change things in your program, so you can experiment with correcting the
+effects of one bug and go on to learn about another.
+.PP
+
+Here are some of the most frequently-needed commands:
+.TP
+.B break \fR[\|\fIfile\fB:\fIline\fR\fR|\fIclass.method\fR] \fR[if \fIexpr\fR]
+\&
+Set a breakpoint at \c
+.I class.method\c
+\& or at the specified file and line.
+.TP
+.B continue \fR[\fIline\fR]
+Continue running your program (after stopping, e.g. at a
+breakpoint). If a line is given a one-time breakpoint is set there.
+.TP
+.B delete \fR[\fIbreakpoint-numbers\fR]
+\&
+Delete breakpoints by number. If no number is given delete all breakpoints.
+.TP
+.B down \fR[\|\fIcount\fR\|]
+Move down one block frame. If count is given move up that many frames. A negative number
+goes the other direction and is like the up command
+.TP
+.B finish
+Run until the completion of the current function or method.
+.TP
+.BI frame " frame-number"
+Set the stack frame to \fIframe-number\fR for purposes of examinine local variables. For positioning relative to the current frame, use 
+.B up
+or 
+.B down. A negative number starts counting from the other end.
+.TP
+.B help \fR[\|\fIname\fR\|]
+Show information about rdebug command \c
+.I name\c
+\&, or general information
+about using rdebug.
+.TP
+.B info \fR[\|\fIname\fR\|]
+Get the various information usually about the debugged program.
+.TP
+.B irb \fIcommand\fR
+Run an interactive ruby shell (irb) using the current environment.
+.TP
+.B list \fR[\|\fIfile\fB:\fIline\fR|\fIfunction]
+type the text of the program in the vicinity of where it is presently stopped
+or at the specified function or file and line.
+.TP
+.B next \fR[\|\fIcount\fR\|]
+Execute next program line(s) (after stopping); step \c
+.I over\c
+\& any
+function calls in the line.
+.TP
+.BI pp " expr"\c
+\&
+Pretty print the value of an expression.
+.TP
+.BI print " expr"\c
+\&
+Display the value of an expression.
+.TP
+.BI ps " expr"\c
+\&
+Print an array as a columized sorted list.
+.TP
+.B quit
+Exit from the debugger.
+.TP
+.B run \fR[\|\fIarglist\fR\|]
+(Re)start your program (with \c
+.I arglist\c
+\&, if specified). If you want the debugger to get reloaded, use
+.B restart
+instead.
+.TP
+.B set
+Modify parts of the debugger environment.
+.TP
+.B show
+See the debugger environment settings
+.TP
+.BI source " filename"\c
+\&
+Read and execute the lines in file \fIfilename\fR as a series of debugger 
+commands.
+.TP
+.B step \fR[\|\fIcount\fR\|]
+Execute next program line(s) (after stopping); step \c
+.I into\c
+\& any
+function calls in the line.
+.TP
+.B up \fR[\|\fIcount\fR\|]
+Move up one block frame. If count is given move up that many frames. A negative number
+goes the other direction and is like the down command
+.TP
+.B where \fR[\|\fIcount\fR\|]
+Display all or \fIcount\fR items of the program stack.
+.PP
+For full details on rdebug, see \c
+https://github.com/cldwalker/debugger
+.SH OPTIONS
+.PP
+.TP 10
+.TP
+.B \-A | \-\-annotate LEVEL
+Set gdb-style annotation to LEVEL, a number. Additional information is output
+automatically when program state is changed. This can be used by
+front-ends such as GNU Emacs to post this updated information without
+having to poll for it.
+.TP
+.B \-\-client
+Connect to a remote debugger. Used with another rdebug invocation using \-\-server.
+See also \-\-host and \-\-cport options
+.TP
+.B \-\-cport=PORT
+Port used for control commands.
+.TP
+.B \-d | \-\-debug
+Set $DEBUG true.
+.TP
+.B \-\-emacs
+Activates full GNU Emacs mode. Is the equivalent of setting the
+options \-\-emacs\-basic, \-\-annotate=3, \-\-no-stop, \-\-no\-control
+and \-\-post\-mortem.
+.TP
+.B \-\-emacs-basic
+Activates GNU Emacs mode. Debugger prompts are prefaced with two octal
+032 characters.
+.TP
+.B \-h | \-\-host=HOST
+Host name used for remote debugging.
+.TP
+.B \-I | \-\-include PATH
+Add PATH to $LOAD_PATH
+.TP
+.B \-m | \-\-post-mortem
+Activate post-mortem mode.
+.TP
+.B \-\-no-control
+Do not automatically start control thread.
+.TP
+.B \-\-no\-stop
+Do not stop when script is loaded.
+.TP
+.B \-p | \-\-port=PORT
+Host name used for remote debugging.
+.TP
+.B \-r | \-\-require SCRIPT
+Require the library, before executing your script.
+.TP
+.B \-\-script FILE
+Name of the script file to run.
+.TP
+.B \-x | \-\-trace
+Show lines before executing them.
+.TP
+.B \-\-no\-quit
+Do not quit when script terminates. Instead rerun the program.
+.TP
+.B \-\-version
+Show the version number and exit.
+.TP
+.B \-\-verbose
+Turn on verbose mode.
+.TP
+.B \-\-v
+Print the version number, then turn on verbose mode if a script name
+is given. If no script name is given just exit after printing the
+version number.
+.TP
+.B \-\-nx
+Don't execute commands found in any initialization files, e.g. .rdebugrc.
+.TP
+.B \-\-keep-frame-binding
+Keep frame bindings.
+.TP
+.B \-\-script=FILE
+Name of the script file to run
+.B \-s | \-\-server
+Listen for remote connections. Another rdebug session accesses using the \-\-client option.
+See also the \-\-host, \-\-port and
+\-\-cport options
+.TP
+.B \-w | \-\-wait
+Wait for a client connection, implies -s option.
+.TP
+.B \-\-help
+Show invocation help and exit.
+.PD
+.SH "SEE ALSO"
+.Sp
+https://github.com/cldwalker/debugger
+.SH AUTHOR
+rdebug was written by Kent Siblev. This manual page was written by
+Rocky Bernstein <rocky@gnu.org>

data/old_scripts/Makefile.am

@@ -0,0 +1,14 @@
+SUBDIRS = doc emacs
+PHONY = test ChangeLogs
+test: check
+ChangeLogs: ChangeLog doc/ChangeLog emacs/ChangeLog lib/ChangeLog 
+ChangeLog:
+	svn2cl --authors=svn2cl_usermap svn://rubyforge.org/var/svn/ruby-debug/trunk  \
+                 cli test bin AUTHORS CHANGES LICENSE README runner.sh -o ChangeLog
+lib/ChangeLog:
+	svn2cl --authors=svn2cl_usermap svn://rubyforge.org/var/svn/ruby-debug/trunk \
+                 lib ext -o lib/ChangeLog
+doc/ChangeLog:
+	svn2cl --authors=svn2cl_usermap svn://rubyforge.org/var/svn/ruby-debug/trunk/doc -o doc/ChangeLog
+emacs/ChangeLog:
+	svn2cl --authors=svn2cl_usermap svn://rubyforge.org/var/svn/ruby-debug/trunk/emacs -o emacs/ChangeLog

data/old_scripts/README.md

@@ -0,0 +1,2 @@
+## Description
+These are old scripts that came with ruby-debug19. Don't have a need for them now but maybe later...

data/old_scripts/autogen.sh

@@ -0,0 +1,4 @@
+#!/bin/sh
+# Things to do after doing a clean SVN update to add the proper files.
+ln -vfs CHANGES NEWS
+autoreconf -i -s

data/old_scripts/configure.ac

@@ -0,0 +1,12 @@
+AC_INIT(ruby-debug-extra, 0.10.4vc,)
+AC_CONFIG_SRCDIR(doc/ruby-debug.texi)
+AM_INIT_AUTOMAKE
+
+##
+## Find out where to install the debugger emacs lisp files
+##
+AM_PATH_LISPDIR
+AM_CONDITIONAL(INSTALL_EMACS_LISP, test "x$lispdir" != "x")
+
+AC_CONFIG_FILES([doc/Makefile emacs/Makefile Makefile])
+AC_OUTPUT

data/old_scripts/rdbg.rb

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+#!/usr/bin/env ruby
+# $Id: rdbg.rb 756 2008-03-13 02:15:04Z rockyb $
+
+# Use this to run rdebug without installing it.  We assume that the
+# library directories are stored at the same level the directory
+# this program. 
+module RDebugRunner
+  def runner(stdout=nil)
+
+    # Add libraries to load path.
+    dirname=File.dirname(__FILE__)
+    libs = %w(ext lib cli)
+    libs.each { |lib| $:.unshift File.join(dirname, lib) }
+
+    rdebug=ENV['RDEBUG'] || File.join(dirname, 'bin', 'rdebug')
+    if stdout
+      old_stdout = $stdout
+      $stdout.reopen(stdout)
+    else
+      old_stdout = nil
+    end
+    load(rdebug, true)
+    $stdout.reopen(old_stdout) if old_stdout
+    
+    # Remove those libraries we just added.
+    1.upto(libs.size) {$:.shift}
+  end
+  module_function :runner
+end
+if __FILE__ == $0 
+  RDebugRunner.runner
+end

data/old_scripts/runner.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+
+ruby=${RUBY:-ruby}
+dir=`dirname $0`
+rdebug=${RDEBUG:-${dir}/bin/rdebug}
+$ruby -I${dir}/ext:${dir}/lib:${dir}/cli -- $rdebug $*
+exit $?

data/old_scripts/svn2cl_usermap

@@ -0,0 +1,3 @@
+andersl:Anders Lindgren
+kent:Kent Sibilev
+rockyb:Rocky Bernstein

data/test/.cvsignore

@@ -0,0 +1 @@
+config.private.yaml

data/test/breakpoints_test.rb

@@ -0,0 +1,366 @@
+require_relative 'test_helper'
+
+describe "Breakpoints" do
+  include TestDsl
+
+  describe "setting breakpoint in the current file" do
+    before { enter 'break 10' }
+    subject { breakpoint }
+
+    def check_subject(field, value)
+      debug_file("breakpoint1") { subject.send(field).must_equal value }
+    end
+
+    it("must have correct pos") { check_subject(:pos, 10) }
+    it("must have correct source") { check_subject(:source, fullpath("breakpoint1")) }
+    it("must have correct expression") { check_subject(:expr, nil) }
+    it("must have correct hit count") { check_subject(:hit_count, 0) }
+    it("must have correct hit value") { check_subject(:hit_value, 0) }
+    it("must be enabled") { check_subject(:enabled?, true) }
+    it("must return right response") do
+      id = nil
+      debug_file('breakpoint1') { id = subject.id }
+      check_output_includes "Breakpoint #{id} file #{fullpath('breakpoint1')}, line 10"
+    end
+  end
+
+
+  describe "using shortcut for the command" do
+    before { enter 'b 10' }
+    it "must set a breakpoint" do
+      debug_file("breakpoint1") { Debugger.breakpoints.size.must_equal 1 }
+    end
+  end
+
+
+  describe "setting breakpoint to unexisted line" do
+    before { enter 'break 100' }
+
+    it "must not create a breakpoint" do
+      debug_file("breakpoint1") { Debugger.breakpoints.must_be_empty }
+    end
+
+    it "must show an error" do
+      debug_file("breakpoint1")
+      check_output_includes "There are only #{LineCache.size(fullpath('breakpoint1'))} lines in file \"breakpoint1.rb\".", interface.error_queue
+    end
+  end
+
+
+  describe "setting breakpoint to incorrect line" do
+    before { enter 'break 9' }
+
+    it "must not create a breakpoint" do
+      debug_file("breakpoint1") { Debugger.breakpoints.must_be_empty }
+    end
+
+    it "must show an error" do
+      debug_file("breakpoint1")
+      check_output_includes 'Line 8 is not a stopping point in file "breakpoint1.rb".', interface.error_queue
+    end
+  end
+
+
+  describe "stopping at breakpoint" do
+    it "must stop at the correct line" do
+      enter 'break 14', 'cont'
+      debug_file("breakpoint1") { state.line.must_equal 14 }
+    end
+
+    it "must stop at the correct file" do
+      enter 'break 14', 'cont'
+      debug_file("breakpoint1") { state.file.must_equal fullpath("breakpoint1") }
+    end
+
+    describe "show a message" do
+      temporary_change_hash_value(Debugger::Command.settings, :basename, false)
+
+      it "must show a message with full filename" do
+        enter 'break 14', 'cont'
+        debug_file("breakpoint1")
+        check_output_includes "Breakpoint 1 at #{fullpath('breakpoint1')}:14"
+      end
+
+      it "must show a message with basename" do
+        enter 'set basename', 'break 14', 'cont'
+        debug_file("breakpoint1")
+        check_output_includes "Breakpoint 1 at breakpoint1.rb:14"
+      end
+    end
+  end
+
+
+  describe "reloading source on change" do
+    temporary_change_hash_value(Debugger::Command.settings, :reload_source_on_change, false)
+
+    it "must not reload source if autoreload is not set" do
+      enter(
+        'set noautoreload',
+        ->{change_line_in_file(fullpath('breakpoint1'), 14, ''); 'break 14'},
+        ->{change_line_in_file(fullpath('breakpoint1'), 14, 'c = a + b'); 'cont'}
+      )
+      debug_file "breakpoint1"
+      check_output_includes "Breakpoint 1 at #{fullpath('breakpoint1')}:14"
+    end
+
+    it "must reload source if autoreload is set" do
+      enter(
+        'set autoreload',
+        ->{change_line_in_file(fullpath('breakpoint1'), 14, ''); 'break 14'},
+        # Setting second breakpoint just to reload the source code after rolling the file changes back
+        ->{change_line_in_file(fullpath('breakpoint1'), 14, 'c = a + b'); 'break 15'}, 'cont'
+      )
+      debug_file "breakpoint1"
+      check_output_includes "Line 14 is not a stopping point in file \"breakpoint1.rb\".", interface.error_queue
+    end
+  end
+
+
+  describe "set breakpoint in a file" do
+    describe "successfully" do
+      before do
+        enter "break #{fullpath('breakpoint2')}:3", 'cont'
+      end
+
+      it "must stop at the correct line" do
+        debug_file("breakpoint1") { state.line.must_equal 3 }
+      end
+
+      it "must stop at the correct file" do
+        debug_file("breakpoint1") { state.file.must_equal fullpath("breakpoint2") }
+      end
+    end
+
+    describe "when setting breakpoint to unexisted file" do
+      before do
+        enter "break asf:324"
+        debug_file("breakpoint1")
+      end
+      it "must show an error" do
+        check_output_includes "No source file named asf", interface.error_queue
+      end
+
+      it "must ask about setting breakpoint anyway" do
+        check_output_includes "Set breakpoint anyway? (y/n)", interface.confirm_queue
+      end
+    end
+  end
+
+
+  describe "set breakpoint to a method" do
+    describe "set breakpoint to an instance method" do
+      before do
+        enter 'break A#b', 'cont'
+      end
+
+      it "must stop at the correct line" do
+        debug_file("breakpoint1") { state.line.must_equal 5 }
+      end
+
+      it "must stop at the correct file" do
+        debug_file("breakpoint1") { state.file.must_equal fullpath("breakpoint1") }
+      end
+    end
+
+    describe "set breakpoint to a class method" do
+      before do
+        enter 'break A.a', 'cont'
+      end
+
+      it "must stop at the correct line" do
+        debug_file("breakpoint1") { state.line.must_equal 2 }
+      end
+
+      it "must stop at the correct file" do
+        debug_file("breakpoint1") { state.file.must_equal fullpath("breakpoint1") }
+      end
+    end
+
+    describe "set breakpoint to unexisted class" do
+      it "must show an error" do
+        enter "break B.a"
+        debug_file("breakpoint1")
+        check_output_includes "Unknown class B.", interface.error_queue
+      end
+    end
+  end
+
+
+  describe "set breakpoint to an invalid location" do
+    before { enter "break foo" }
+
+    it "must not create a breakpoint" do
+      debug_file("breakpoint1") { Debugger.breakpoints.must_be_empty }
+    end
+
+    it "must show an error" do
+      debug_file("breakpoint1")
+      check_output_includes 'Invalid breakpoint location: foo.', interface.error_queue
+    end
+  end
+
+
+  describe "disabling a breakpoint" do
+    describe "successfully" do
+      before { enter "break 14" }
+
+      describe "short syntax" do
+        before { enter ->{"disable #{breakpoint.id}"}, "break 15" }
+        it "must have a breakpoint with #enabled? returning false" do
+          debug_file("breakpoint1") { breakpoint.enabled?.must_equal false }
+        end
+
+        it "must not stop on the disabled breakpoint" do
+          enter "cont"
+          debug_file("breakpoint1") { state.line.must_equal 15 }
+        end
+      end
+
+      describe "full syntax" do
+        before { enter ->{"disable breakpoints #{breakpoint.id}"}, "break 15" }
+        it "must have a breakpoint with #enabled? returning false" do
+          debug_file("breakpoint1") { breakpoint.enabled?.must_equal false }
+        end
+      end
+    end
+
+    describe "errors" do
+      it "must show an error if syntax is incorrect" do
+        enter "disable"
+        debug_file("breakpoint1")
+        check_output_includes(
+          '"disable" must be followed "display", "breakpoints" or breakpoint numbers.',
+          interface.error_queue
+        )
+      end
+
+      it "must show an error if no breakpoints is set" do
+        enter "disable 1"
+        debug_file("breakpoint1")
+        check_output_includes 'No breakpoints have been set.', interface.error_queue
+      end
+
+      it "must show an error if not a number is provided as an argument to 'disable' command" do
+        enter "break 14", "disable foo"
+        debug_file("breakpoint1")
+        check_output_includes "Disable breakpoints argument 'foo' needs to be a number."
+      end
+    end
+  end
+
+
+  describe "enabling a breakpoint" do
+    describe "successfully" do
+      before { enter "break 14" }
+      describe "short syntax" do
+        before { enter ->{"enable #{breakpoint.id}"}, "break 15" }
+
+        it "must have a breakpoint with #enabled? returning true" do
+          debug_file("breakpoint1") { breakpoint.enabled?.must_equal true }
+        end
+
+        it "must stop on the enabled breakpoint" do
+          enter "cont"
+          debug_file("breakpoint1") { state.line.must_equal 14 }
+        end
+      end
+
+      describe "full syntax" do
+        before { enter ->{"enable breakpoints #{breakpoint.id}"}, "break 15" }
+
+        it "must have a breakpoint with #enabled? returning true" do
+          debug_file("breakpoint1") { breakpoint.enabled?.must_equal true }
+        end
+      end
+    end
+
+    describe "errors" do
+      it "must show an error if syntax is incorrect" do
+        enter "enable"
+        debug_file("breakpoint1")
+        check_output_includes(
+          '"enable" must be followed "display", "breakpoints" or breakpoint numbers.',
+          interface.error_queue
+        )
+      end
+    end
+  end
+
+
+  describe "deleting a breakpoint" do
+    before { enter "break 14", ->{"delete #{breakpoint.id}"}, "break 15" }
+
+    it "must have only one breakpoint" do
+      debug_file("breakpoint1") { Debugger.breakpoints.size.must_equal 1 }
+    end
+
+    it "must not stop on the disabled breakpoint" do
+      enter "cont"
+      debug_file("breakpoint1") { state.line.must_equal 15 }
+    end
+  end
+
+
+  describe "Conditional breakpoints" do
+    it "must stop if the condition is correct" do
+      enter "break 14 if b == 5", "break 15", "cont"
+      debug_file("breakpoint1") { state.line.must_equal 14 }
+    end
+
+    it "must skip if the condition is incorrect" do
+      enter "break 14 if b == 3", "break 15", "cont"
+      debug_file("breakpoint1") { state.line.must_equal 15 }
+    end
+
+    it "must show an error when conditional syntax is wrong" do
+      enter "break 14 ifa b == 3", "break 15", "cont"
+      debug_file("breakpoint1") { state.line.must_equal 15 }
+      check_output_includes "Expecting 'if' in breakpoint condition; got: ifa b == 3.", interface.error_queue
+    end
+
+    describe "enabling with wrong conditional syntax" do
+      before do
+        enter(
+          "break 14",
+          ->{"disable #{breakpoint.id}"},
+          ->{"cond #{breakpoint.id} b -=( 3"},
+          ->{"enable #{breakpoint.id}"}
+        )
+      end
+
+      it "must not enable a breakpoint" do
+        debug_file("breakpoint1") { breakpoint.enabled?.must_equal false }
+      end
+
+      it "must show an error" do
+        debug_file("breakpoint1")
+        check_output_includes(
+          'Expression "b -=( 3" syntactically incorrect; breakpoint remains disabled.',
+          interface.error_queue
+        )
+      end
+    end
+
+    it "must show an error if no file or line is specified" do
+      enter "break ifa b == 3", "break 15", "cont"
+      debug_file("breakpoint1") { state.line.must_equal 15 }
+      check_output_includes "Invalid breakpoint location: ifa b == 3.", interface.error_queue
+    end
+
+    it "must show an error if expression syntax is invalid" do
+      enter "break if b -=) 3", "break 15", "cont"
+      debug_file("breakpoint1") { state.line.must_equal 15 }
+      check_output_includes 'Expression "b -=) 3" syntactically incorrect; breakpoint disabled.', interface.error_queue
+    end
+  end
+
+
+  describe "Post Mortem" do
+    it "must be able to set breakpoints in post-mortem mode"
+    0.times do
+      enter 'cont', 'break 12', 'cont'
+      debug_file("post_mortem") { state.line.must_equal 12 }
+    end
+  end
+
+end