irt 1.1.1

data/Rakefile

@@ -0,0 +1,60 @@
+name = 'irt'
+
+def ensure_clean(action, force=false)
+  if !force && ! `git status -s`.empty?
+    puts <<-EOS.gsub(/^ {6}/, '')
+      Rake task aborted: the working tree is dirty!
+      If you know what you are doing you can use \`rake #{action}[force]\`"
+    EOS
+    exit(1)
+  end
+end
+
+desc "Install the gem"
+task :install, :force do |t, args|
+  ensure_clean(:install, args.force)
+  orig_version = version = File.read('VERSION').strip
+  begin
+    commit_id = `git log -1 --format="%h" HEAD`.strip
+    version = "#{orig_version}.#{commit_id}"
+    File.open('VERSION', 'w') {|f| f.puts version }
+    gem_name = "#{name}-#{version}.gem"
+    sh %(gem build #{name}.gemspec)
+    sh %(gem install #{gem_name} --local)
+    puts <<-EOS.gsub(/^ {6}/, '')
+
+      *******************************************************************************
+      *                                   NOTICE                                    *
+      *******************************************************************************
+      * The version id of locally installed gems is comparable to a --pre version:  *
+      * i.e. it is alphabetically ordered (not numerically ordered), besides it     *
+      * includes the sah1 commit id which is not aphabetically ordered, so be sure  *
+      * your application picks the version you really intend to use                 *
+      *******************************************************************************
+
+    EOS
+  ensure
+    remove_entry_secure gem_name, true
+    File.open('VERSION', 'w') {|f| f.puts orig_version }
+  end
+end
+
+desc %(Remove all the "#{name}" installed gems and executables and install this version)
+task :clean_install, :force do |t, args|
+  ensure_clean(:install, args.force)
+  sh %(gem uninstall #{name} --all --ignore-dependencies --executables)
+  Rake::Task['install'].invoke(args.force)
+end
+
+desc "Push the gem to rubygems.org"
+task :push, :force do |t, args|
+  begin
+    ensure_clean(:push, args.force)
+    version = File.read('VERSION').strip
+    gem_name = "#{name}-#{version}.gem"
+    sh %(gem build #{name}.gemspec)
+    sh %(gem push #{gem_name})
+  ensure
+    remove_entry_secure gem_name, true
+  end
+end

data/VERSION

@@ -0,0 +1 @@
+1.1.1

data/bin/irt

@@ -0,0 +1,101 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'irt'
+require 'fileutils'
+require 'tempfile'
+require 'optparse'
+
+
+copy = "irt #{IRT::VERSION} (c) 2010-2011 Domizio Demichelis".log_color.bold
+
+options = {}
+
+optparse = OptionParser.new do |opts|
+
+  opts.banner = <<EOB
+Interactive Ruby Tools:
+    Improved irb and rails console with lots of easy and powerful tools.
+Usage:
+    irt [PATH] [options]
+Options:
+EOB
+
+  options[:interactive_eof]
+  opts.on( '-i', '--interactive-eof', 'Opens an interactive session at EOF') do
+    options[:interactive_eof] = true
+  end
+
+  options[:irb_options] = nil
+  opts.on( '-b', '--irb-options [OPTIONS]', 'Sets the irb Options' ) do |opt|
+    options[:irb_options] = opt
+  end
+
+  options[:rails_env] = 'development'
+  opts.on( '-r', '--rails-env [ENVIRONMENT]', 'Sets the Rails Environment' ) do |env|
+     options[:rails_env] = env
+   end
+
+  opts.on( '-v', '--version', 'Shows the version and exits' ) do
+    puts IRT::VERSION
+    exit
+  end
+
+  opts.on( '-h', '--help', 'Display this screen' ) do
+    puts copy
+    puts opts
+    exit
+  end
+
+end
+
+optparse.parse!
+
+puts copy
+
+paths = if ARGV.empty?
+          options[:interactive_eof] = true
+          [ Tempfile.new(%w[tmp- .irt]).path ]
+        else
+          ARGV.map {|p| File.expand_path(p) }
+        end
+
+files = paths.map do |path|
+          unless File.exists?(path)
+            next if IRT.prompter.no? %(Do you want to create the file "#{path}"?), :hint => '[<enter=y|n]', :default => 'y'
+            options[:interactive_eof] = true
+            dirname = File.dirname(path)
+            FileUtils.mkdir_p(dirname) unless File.directory?(dirname)
+            FileUtils.touch(path)
+          end
+          File.directory?(path) ? Dir.glob(File.join(path, '**/*.irt')) : path
+        end.flatten
+
+if files.empty?
+  puts 'No *.irt files to run'
+  exit
+end
+
+cmd_format = if File.exists?('./config/environment.rb')
+               if File.exists?('./script/rails')
+                 'rails c %s %s %s'
+               elsif File.exists?('./script/console')
+                 'ruby script/console --irb="irt_rails2"'
+               end
+             else
+               'irt_irb %s %s'
+             end
+
+if cmd_format.match(/^ruby script\/console/)
+  ENV['RAILS_ENV'] ||= options[:rails_env]
+end
+
+ENV['IRT_INTERACTIVE_EOF'] = options[:interactive_eof].inspect if options[:interactive_eof]
+
+files.each do |file|
+  ENV['IRT_COMMAND'] = sprintf cmd_format, file, options[:irb_options], options[:rails_env]
+  unless system(ENV['IRT_COMMAND'])
+    puts "\e[0m" if Colorer.color
+    exit(1)
+  end
+end

data/bin/irt_irb

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+
+require 'irt'
+IRB.start

data/bin/irt_rails2

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+argv = ARGV.dup
+argv.pop
+argv << ENV['IRT_FILE']
+exec "irt_irb #{argv.join(' ')}"

data/goodies/nano/README

@@ -0,0 +1,6 @@
+In order to syntax-highlight *.irt files as ruby files in nano, you must add the following lines to your .nanorc file:
+
+include "/path/to/irt.nanorc"
+
+(change the "/path/to/irt.nanorc" to the real path where you store the irt.nanorc file included in this dir)
+

data/goodies/nano/irt.nanorc

@@ -0,0 +1,86 @@
+# Ruby syntax file with additional irt keywords - Distributed with the irt gem
+# The regular expressions in this file have been copied
+# and adapted from many sources
+
+# Automatically use for '.rb' and '.irt' files
+syntax "ruby" ".*\.*(rb|irt)$"
+
+# Shebang
+color brightcyan   "^#!.*"
+
+# Operators
+color brightmagenta "\<not\>|\<and\>|\<or\>"
+color brightmagenta "\*\*|!|~|\*|/|%|\+|-|&|<<|>>|\|\^|>|>=|<|<="
+color brightmagenta "<=>|\|\||!=|=~|!~|&&|\+=|-=|=|\.\.|\.\.\."
+
+# Keywords
+color brightmagenta "\<(BEGIN|END|alias|and|begin|break|case)\>"
+color brightmagenta "\<(class|def|defined|do|else|elsif|end)\>"
+color brightmagenta "\<(ensure|for|if|in|module|next|not|or|redo)\>"
+color brightmagenta "\<(rescue|retry|return|self|super|then|undef)\>"
+color brightmagenta "\<(unless|until|when|while|yield)\>"
+
+# Load
+color brightgreen "\<(load|require)\>"
+
+# FILE LINE END and similar markers
+color brightyellow "\<__[A-Z_]+__\>"
+
+# irt Keywords
+color brightmagenta "\<(_eql|_yaml_eql|last_value_eql|last_yaml_eql)\?"
+color brightmagenta "\<(desc|irt|capture|irt_at_exit|eval_file|insert_file)\>"
+
+# Constants
+color brightblue "(\$)?\<[A-Z]+[0-9A-Z_a-z]*\>"
+color brightblue "::[A-Z]"
+
+# Predefined Constants
+color brightred "\<(TRUE|FALSE|NIL|STDIN|STDOUT|STDERR|ENV|ARGF|ARGV|DATA|RUBY_VERSION|RUBY_RELEASE_DATE|RUBY_PLATFORM)\>"
+
+# Predefined Variables
+color brightred "\$[^A-Za-z]" "\$-.\>" "\$std(err|in|out)\>"
+
+# Object Variables
+color green "(@|@@)\<[^:][a-z]+[0-9A-Z_a-z]*\>"
+
+# Symbols
+icolor red "[^:]:\<[0-9A-Z_]+\>"
+
+# false, nil, true
+color yellow "\<(false|nil|true)\>"
+
+# Above must not match 'nil?'
+color red "\<nil\?"
+
+# Iterators
+color brightgreen "\|\w*\|"
+
+# Regular expressions
+# color green "/(\\.|[^\\/])*/[imox]*"
+
+## Regular expressions
+color brightmagenta "/([^/]|(\\/))*/[iomx]*" "%r\{([^}]|(\\}))*\}[iomx]*"
+
+# Shell command expansion is in `backticks` or like %x{this}.
+color cyan "`[^`]*`" "%x\{[^}]*\}"
+
+## Strings, double-quoted
+color brightcyan ""([^"]|(\\"))*"" "%[QW]?\{[^}]*\}" "%[QW]?\([^)]*\)" "%[QW]?<[^>]*>" "%[QW]?\[[^]]*\]" "%[QW]?\$[^$]*\$" "%[QW]?\^[^^]*\^" "%[QW]?![^!]*!"
+
+## Strings, single-quoted
+color cyan "'([^']|(\\'))*'" "%[qw]\{[^}]*\}" "%[qw]\([^)]*\)" "%[qw]<[^>]*>" "%[qw]\[[^]]*\]" "%[qw]\$[^$]*\$" "%[qw]\^[^^]*\^" "%[qw]![^!]*!"
+
+# Escapes
+color red "\\[0-7][0-7][0-7]|\\x[0-9a-fA-F][0-9a-fA-F]"
+color red "\\[abefnrs]"
+color red "(\\c|\\C-|\\M-|\\M-\\C-)."
+
+# Expression substitution
+color green "#\{[^}]*\}"
+
+# Comments
+color cyan "#[^{].*$" "#$"
+color brightcyan "##[^{].*$" "##$"
+
+# Multiline comments
+color cyan start="^=begin" end="^=end"

data/goodies/vi/README

@@ -0,0 +1,5 @@
+In order to syntax-highlight *.irt files as ruby files in vi, you must add the following lines to your .vimrc file:
+
+syntax on
+filetype on
+au BufRead,BufNewFile *.irt set filetype=ruby

data/irt.gemspec

@@ -0,0 +1,29 @@
+name = File.basename( __FILE__, '.gemspec' )
+version = File.read(File.expand_path('../VERSION', __FILE__)).strip
+require 'date'
+
+Gem::Specification.new do |s|
+
+  s.authors = ["Domizio Demichelis"]
+  s.email = 'dd.nexus@gmail.com'
+  s.homepage = 'http://github.com/ddnexus/irt'
+  s.summary = 'Interactive Ruby Tools - Improved irb and rails console with a lot of easy and powerful tools.'
+  s.description = 'If you use IRT in place of irb or rails console, you will have more tools that will make your life a lot easier.'
+
+  s.add_runtime_dependency('differ', [">= 0.1.1"])
+  s.add_runtime_dependency('colorer', [">= 0.7.0"])
+  s.add_runtime_dependency('prompter', [">= 0.1.1"])
+  s.add_runtime_dependency('fastri', [">= 0.3.1.1"])
+
+  s.executables = ['irt', 'irt_irb', 'irt_rails2']
+  s.files = `git ls-files -z`.split("\0") - %w[irt-tutorial.pdf]
+
+  s.name = name
+  s.version = version
+  s.date = Date.today.to_s
+
+  s.required_rubygems_version = ">= 1.3.6"
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+
+end

data/irtrc

@@ -0,0 +1,48 @@
+# IRT RC file
+# ITR conf options
+
+# set this to true if your prompt get messed up when you use the history
+# IRT.fix_readline_prompt = false
+
+# will open an interactie session if a test has diffs
+# IRT.irt_on_diffs = true
+
+# will print the log tail when an interactive session is opened
+# IRT.tail_on_irt = false
+
+# the lines you want to be printed as the tail
+# IRT.log.tail_size = 10
+
+# loads irt_helper.rb files automatically
+# IRT.autoload_helper_files = true
+
+# force true/false regardless the terminal ANSI support
+# IRT.force_color = true
+
+# the command that should set the clipboard to the last lines from STDIN
+# default to 'pbcopy' on mac, 'xclip -selection c' on linux/unix and 'clip' on windoze
+# IRT.copy_to_clipboard_command = 'your command'
+
+# the format to build the command to launch nano
+# IRT.nano_command_format = 'nano +%2$d %1$s'
+
+# the format to build the command to launch vi
+# IRT.vi_command_format ="vi -c 'startinsert' %1$s +%2$d"
+
+# the format to build the command to launch the ri tool
+# IRT.ri_command_format = "qri -f #{Colorer.color? ? 'ansi' : 'plain'} %s"
+
+# add your command format if you want to use another editor than nano or vi
+# default 'open -t %1$s' on MacOX; 'kde-open %1$s' or 'gnome-open %1$s' un unix/linux; '%1$s' on windoze
+# IRT.edit_command_format ="your_preferred_GUI_editor %1$s +%2$d"
+
+# any log-ignored-echo command you want to add
+# IRT.log.ignored_echo_commands << %w[commandA commandB ...]
+
+# any log-ignored command you want to add (includes all the log-ignored-echo commands)
+# IRT.log.ignored_commands << %w[commandC commandD ...]
+
+# any command that will not set the last value (includes all the log-ignored commands)
+# IRT.log.non_setting_commands << %w[commandE commandF ...]
+
+# add your stuff here

data/lib/irt.rb

@@ -0,0 +1,143 @@
+require 'rubygems'
+begin
+  require 'ap'
+rescue LoadError
+end
+
+require 'pp'
+require 'yaml'
+require 'rbconfig'
+require 'pathname'
+require 'irt/extensions/kernel'
+require 'irt/extensions/object'
+require 'irt/extensions/method'
+require 'irt/extensions/irb'
+require 'irb/completion'
+require 'colorer'
+require 'irt/log'
+require 'irt/hunks'
+require 'irt/differ'
+require 'irt/directives'
+require 'irt/session'
+
+module IRT
+
+  VERSION = File.read(File.expand_path('../../VERSION', __FILE__)).strip
+
+  class IndexError < RuntimeError ; end
+  class SessionModeError < RuntimeError ; end
+  class ArgumentTypeError < RuntimeError ; end
+  class NotImplementedError < RuntimeError ; end
+
+  extend self
+
+  attr_accessor :irt_on_diffs, :tail_on_irt, :fix_readline_prompt, :debug,
+                :full_exit, :exception_raised, :session_no, :autoload_helper_files,
+                :copy_to_clipboard_command, :nano_command_format, :vi_command_format, :edit_command_format, :ri_command_format
+  attr_reader :log, :irt_file, :differ, :os
+
+  Colorer.def_custom_styles :bold              => :bold,
+                            :reversed          => :reversed,
+                            :null              => :clear,
+
+                            :log_color         => :blue,
+                            :file_color        => :cyan,
+                            :interactive_color => :magenta,
+                            :inspect_color     => :clear,
+                            :binding_color     => :yellow,
+                            :actual_color      => :green,
+                            :ignored_color     => :yellow,
+
+                            :error_color       => :red,
+                            :ok_color          => :green,
+                            :diff_color        => :yellow,
+                            :diff_a_color      => :cyan,
+                            :diff_b_color      => :green
+
+  def force_color=(bool)
+    Colorer.color = bool
+  end
+
+  def init
+    @session_no = 0
+    @differ = IRT::Differ
+    @irt_on_diffs = true
+    @tail_on_irt = false
+    @fix_readline_prompt = false
+    @autoload_helper_files = true
+    @os = get_os
+    @copy_to_clipboard_command = case @os
+                                 when :windows
+                                   'clip'
+                                 when :macosx
+                                   'pbcopy'
+                                 when :linux, :unix
+                                   'xclip -selection c'
+                                 end
+    @edit_command_format = case @os
+                           when :windows
+                             '%1$s'
+                           when :macosx
+                             'open -t %1$s'
+                           when :linux, :unix
+                             case ENV['DESKTOP_SESSION']
+                             when /kde/i
+                               'kde-open %1$s'
+                             when /gnome/i
+                               'gnome-open %1$s'
+                             end
+                           end
+    @vi_command_format = "vi -c 'startinsert' %1$s +%2$d"
+    @nano_command_format = 'nano +%2$d %1$s'
+    @ri_command_format =  "qri -f #{Colorer.color? ? 'ansi' : 'plain'} %s"
+    @debug = false
+  end
+
+  def init_files
+    @irt_file = IRB.conf[:SCRIPT]
+    @log = Log.new
+    @log.print_running_file
+    IRT::Directives.load_helper_files
+  end
+
+  def lib_path
+    File.expand_path '../../lib', __FILE__
+  end
+
+  # this fixes a little imperfection of the YAML::dump method
+  # which adds a space at the end of the class
+  def yaml_dump(val)
+    yml = "\n" + YAML.dump(val)
+    yml.gsub(/ +\n/, "\n")
+  end
+
+  def prompter
+    @prompter ||= begin
+                    require 'prompter'
+                    pr = Prompter.new
+                    def pr.say_echo(result, opts={})
+                      opts = {:style => :ignored_color}.merge opts
+                      say '   #> ' + result.inspect, opts
+                    end
+                    pr
+                  end
+  end
+
+private
+
+  def get_os
+    case RbConfig::CONFIG['host_os']
+    when /mswin|msys|mingw32|windows/i
+      :windows
+    when /darwin|mac os/i
+      :macosx
+    when /linux/i
+      :linux
+    when /solaris|bsd/i
+      :unix
+    else
+      :unknown
+    end
+  end
+
+end