ruby-debug 0.1.2

data/CHANGES

@@ -0,0 +1,4 @@
+0.1 (2006-06-16)
+========================
+
+Initial release.

data/LICENSE

@@ -0,0 +1,23 @@
+Copyright (C) 2005  Kent Sibilev <ksibilev@yahoo.com>
+All rights reserved.
+ *
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+ *
+THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGE.

data/README

@@ -0,0 +1,63 @@
+= ruby-debug
+
+== Overview
+
+ruby-debug is a fast implementation of the standard debugger debug.rb.
+The faster execution speed is achieved by utilizing a new hook Ruby C API.
+
+== Requirements
+
+ruby-debug requires Ruby 1.8.4 or higher.
+
+If you are running Linux or Unix you'll need a C compiler so the extension
+can be compiled when it is installed.
+
+
+== Install
+
+ruby-debug is provided as a RubyGem.  To install:
+
+<tt>gem install ruby-debug</tt>
+
+== Usage
+
+There are two ways of running ruby-debug.
+
+=== rdebug executable:
+
+$ rdebug <your-script>
+
+When you start your script this way, the debugger will stop at
+the first line of code in the script file. So you will be able 
+to set up your breakpoints.
+
+=== ruby-debug API
+
+The second way is to use the ruby-debug API to interrupt your
+code execution at runtime.
+
+  require 'ruby-debug'
+  ...
+  def your_method
+    ...
+    debugger
+    ...
+  end
+
+When Kernel#debugger method is executed, the debugger is activated
+and you will be able to inspect and step through your code.
+
+== Performance
+
+The debug.rb script that comes with the standard library uses 
+Kernel#set_trace_func API. This way it is possible to implement
+the debugger in pure Ruby, but has a negative effect on the speed 
+of your program execution. For each trace call Ruby interpreter 
+creates a Binding object, even though it is not being used most
+of the time. ruby-debug library moves most of the functionality 
+of debug.rb to a native extension, this way significantly improving
+the execution of your program.
+
+== License
+
+See LICENSE for license information.

data/Rakefile

@@ -0,0 +1,70 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+
+SO_NAME = "ruby_debug.so"
+
+# ------- Default Package ----------
+RUBY_DEBUG_VERSION = "0.1.2"
+
+FILES = FileList[
+  'Rakefile',
+  'README',
+  'LICENSE',
+  'CHANGES',
+  'lib/**/*',
+  'ext/*',
+  'bin/*'
+]
+
+# Default GEM Specification
+default_spec = Gem::Specification.new do |spec|
+  spec.name = "ruby-debug"
+  
+  spec.homepage = "http://rubyforge.org/projects/ruby-debug/"
+  spec.summary = "Fast Ruby debugger"
+  spec.description = <<-EOF
+ruby-debug is a fast implementation of the standard Ruby debugger debug.rb.
+It's implemented by utilizing a new hook Ruby C API.
+EOF
+
+  spec.version = RUBY_DEBUG_VERSION
+
+  spec.author = "Kent Sibilev"
+  spec.email = "ksibilev@yahoo.com"
+  spec.platform = Gem::Platform::RUBY
+  spec.require_path = "lib" 
+  spec.bindir = "bin"
+  spec.executables = ["rdebug"]
+  spec.extensions = ["ext/extconf.rb"]
+  spec.autorequire = "ruby-debug"
+  spec.files = FILES.to_a  
+
+  spec.required_ruby_version = '>= 1.8.2'
+	spec.date = DateTime.now
+  spec.rubyforge_project = 'ruby-debug'
+  
+  # rdoc
+  spec.has_rdoc = false
+end
+
+
+# Rake task to build the default package
+Rake::GemPackageTask.new(default_spec) do |pkg|
+  pkg.need_tar = true
+  pkg.need_tar = true
+end
+
+task :default => :package
+
+# ---------  Publish to RubyForge  ----------------
+desc "Publish ruby-debug to RubyForge."
+task :publish do 
+	require 'rake/contrib/sshpublisher'
+	
+	# Get ruby-debug path
+	ruby_debug_path = File.expand_path(File.dirname(__FILE__))
+
+	publisher = Rake::SshDirPublisher.new("kent@rubyforge.org",
+				"/var/www/gforge-projects/ruby-debug", ruby_debug_path)
+end

data/bin/rdebug

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+
+if ARGV.empty?
+  puts "Usage: #{__FILE__} <script>"
+  exit(1)
+end
+
+require 'rubygems'
+require 'ruby-debug'
+trap('INT') { Debugger.interrupt_last }
+
+debugger 2
+load ARGV.shift

data/ext/extconf.rb

@@ -0,0 +1,18 @@
+require "mkmf"
+
+if RUBY_VERSION >= "1.9"
+  if RUBY_RELEASE_DATE < "2005-03-17"
+    STDERR.print("Ruby version is too old\n")
+    exit(1)
+  end
+elsif RUBY_VERSION >= "1.8"
+  if RUBY_RELEASE_DATE < "2005-03-22"
+    STDERR.print("Ruby version is too old\n")
+    exit(1)
+  end
+else
+  STDERR.print("Ruby version is too old\n")
+  exit(1)
+end
+
+create_makefile("ruby_debug")