utility_belt 1.0.0

data/History.txt

@@ -0,0 +1,5 @@
+== 1.0.0 / 2007-11-03
+
+* 1 major enhancement
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,7 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/utility_belt
+lib/utility_belt.rb
+test/test_utility_belt.rb

data/README

@@ -0,0 +1,343 @@
+== Utility Belt
+
+by Giles Bowkett (and many others)
+
+http://utilitybelt.rubyforge.org
+
+== DESCRIPTION
+  
+Utility Belt is a grab-bag of tricks, tools, techniques, trifles, and toys for IRB, including convenience methods, language patches, and useful extensions. It also includes a couple command-line widgets. Its primary inspirations were an awesome gem called Wirble and a blog post by Amy Hoy called "Secrets Of The Rails Console Ninjas".
+
+(http://slash7.com/articles/2006/12/21/secrets-of-the-rails-console-ninjas)
+
+== INSTALL
+
+sudo gem install utility_belt
+
+== FEATURES
+
+* Interactively edit IRB code in your preferred text editor
+* Read from and write to OS X clipboard
+* Post your code to Pastie with one command (OS X only)
+* Kick-ass Unix-style history buffer
+* Write command history to file or vi
+* Grep classes and methods for strings
+* Verbosity controls for regular IRB and Rails console
+* Finder shortcuts for Rails console
+* Upload shortcut for Amazon S3
+* Command-line Amazon S3 upload script
+* Command-line Google shortcut (OS X only)
+* Auto-indentation
+* _ special variable (like Unix shell var !!)
+* Extremely basic themes for Wirble syntax coloring
+* Pascal/JavaScript-style "with" statement
+* String#to_proc
+* Grammatically-correct is_an? method - no more "is_a? Array" statements
+* One-character exit command
+
+== MAYBE GONNA HAPPEN
+
+* Class and method greps to take regexes and symbols
+* Gem require to take arrays and symbols
+* Copy history to clipboard or arbitrary editor
+* Verbosity off switch for Rails
+* Test-driven strategy encompassing IRB and external editors
+
+== COMMUNITY EFFORT
+
+The majority of this code was written by other people and compiled, nicked, nabbed, herded, gathered, copied, or pilfered by me (Giles Bowkett). See copyright notice for the credits. A lot of this code comes from blogs. Check out the source code for numerous links to the original posts the code came from.
+
+== SYNOPSIS
+
+Utility Belt gives you a ton of new options and techniques in IRB. (You may find yourself putting its language patches in actual projects as well.) The way to use Utility Belt is to edit, or create, your .irbrc file. This is analogous to a Unix .bashrc, .tcshrc, .profile, or similar file.
+
+(Windows users are probably out of luck here - sorry. There may be a solution, but I don't know what it is.)
+
+Adding Utility Belt to your .irbrc is easy:
+
+  require 'rubygems'
+  require 'utility_belt'
+
+To use the Amazon shortcuts, you also need to set some environment variables. See the section on S3 under "Usage" for more. Also, if your terminal has a light background, you'll need to enable the light-background syntax coloring theme - see the section on themes under "Usage" for more.
+
+== USAGE
+
+Using each of Utility Belt's tools is different:
+
+== Interactively edit IRB code in your preferred text editor
+
+If your preferred text editor is vi(m), emacs, or TextMate, there are built-in commands: vi, emacs, and mate, respectively. To use another editor, use this command:
+
+  edit(:the_name_of_my_editor)
+
+or
+
+  edit("the name of my editor")
+
+or
+
+  edit("/the/path/to/my/editor")
+
+== Read from and write to OS X clipboard
+
+To read:
+
+  MacClipboard.read
+
+To write:
+
+  MacClipboard.write("something")
+
+== Post your code to Pastie with one command (OS X only)
+
+First copy some code into your clipboard, or put it there with the MacClipboard.write() class method. Then use the command:
+
+  pastie
+
+or the shortcut version:
+
+  pst
+
+Note that this method currently auto-formats all code as Ruby. Support for other languages is possible but not implemented yet. Also, this code is OS X only because it uses the MacClipboard. (A platform-agnostic version without the clipboard aspect is certainly possible.)
+
+== Unix-style history buffer
+
+Use "h" or "history" to view your command history, and "h! 123" to re-invoke command #123 in your buffer. "h!" with no args will run the last command.
+
+== Write command history to file or vi
+
+To write your history to a file, use "history_write('/path/to/file')". To edit your history in vi, use "history_to_vi" or its shortcut alias "hvi".
+
+== Grep classes and methods for strings
+
+Classes:
+
+  >> grep_classes("ixnum")
+  #=> ["Fixnum"]
+
+  >> grep_classes("num")
+  #=> ["Bignum", "Fixnum", "Numeric", "REXML::SyncEnumerator"]
+
+Methods:
+
+  >> "any arbitrary string".grep_methods("pretty")
+  #=> ["pretty_inspect", "pretty_print_instance_variables", "pretty_print_inspect", "pretty_print", "pretty_print_cycle"]
+
+  >> 32.grep_methods("*")
+  #=> ["*", "**"]
+
+At some point it'll probably be a good idea to add regex support for these methods.
+
+== Verbosity controls for regular IRB and Rails console
+
+regular IRB: "verbose" or "v" / "quiet" or "q"
+
+Rails: "log" method turns verbosity on, there isn't actually any method for turning it off. (Might add one at some point.)
+
+== Finder shortcuts for Rails console
+
+  user(:all) / user(1)
+
+instead of
+
+  User.find(:all) / User.find(1)
+
+Supports arbitrarily complex finds.
+
+== Upload shortcut for Amazon S3
+
+First, define your secret keys in your environment variables:
+
+export AMAZON_ACCESS_KEY_ID='foofoofoofoofoo'
+export AMAZON_SECRET_ACCESS_KEY='barbarbarbarbar'
+
+(Obviously, replace those with actual values.)
+
+Then, you can use
+
+  aws_upload("bucket_name","filename")
+
+To easily upload public-access files. This method will automatically connect to Amazon S3 for you, if your keys are defined in your environment variables. It also writes the resulting Amazon URL to your clipboard, if you're on OS X, so you can easily share the file with others. Note that you have to create the initial buckets manually - see amazon.rubyforge.org for details on that.
+
+A good way to use this is actually to have a default bucket, and create a further method in your .irbrc file:
+
+  def my_bucket_name(filename)
+    aws_upload("my_default_bucket",filename)
+  end
+
+== Command-line Amazon S3 upload script
+
+Utility Belt also includes amazon, a simple command-line uploader for S3. It requires that you set your Amazon environment variables (see above). The usage is:
+
+  amazon -b my_bucket_name filename other_filename
+
+(For any arbitrary number of filenames.)
+
+Anytime you want to upload a file to your default bucket on S3, for example, the "images" bucket for your blog - or the "mp3" bucket if you're running a blog like Projectionist - all you have to do is
+
+  amazon -b blog_files some_file.name
+
+Or
+
+  amazon --bucket blog_files some_file.name
+
+And you're good to go. Of course, if that were too many characters to type, you could always take it one step further with a shell script. For instance, in bash:
+
+  alias b1="amazon --bucket my_main_bucket $1"
+  alias b2="amazon --bucket my_other_bucket $1"
+
+And then you would only have to type:
+
+  b1 file.name
+
+And of course tab completion will handle all the typing of the file name, assuming you choose your file names deliberately ahead of time to make tab completion effective, in which case all you have to type is "b1 f[tab]" and bam.
+
+== Command-line Google shortcut (OS X only)
+
+To pop open a new window in your default browser with Google search results for a given search term, do:
+
+  google "any given term"
+
+For one-word terms, you can omit the quotes:
+
+  google term
+
+If you already have the search term in your clipboard, you can just type:
+
+  google
+
+(The last approach is useful for unusual command-line error messages.)
+
+== Auto-indentation and tab completion
+
+Just type as normally. This just enables built-in but underused functionality in IRB. (The IRB default auto-indentation isn't perfect, but it clobbers the living hell out of no indentation at all.)
+
+== _ special variable (like Unix shell var !!)
+
+More activation of built-in but underused functionality in IRB. _ functions like !! in Unix, with one subtle difference. Instead of re-issuing the previous command in your history, it gives you the last result of evaluating a command. This means when you start a new IRB session, _ won't go to your history, it'll just give you nil, and it means that some commands can't be repeated exactly. Nine out of ten times, however, it's pretty much the same thing.
+
+Note that when combined with the h! in the command history code, you basically have two synonyms for !! here. Neither one is an exact replica, but between the two of them, you should have what you need.
+
+== Extremely basic themes for Wirble syntax coloring
+
+Utility Belt incorporates Wirble as a dependency. Wirble provides syntax coloring. Utility Belt allows you to choose between two syntax coloring themes: Wirble's default, and an alternate color set for terminals with light backgrounds. The default theme is enabled by default (duh), but if you have a terminal with a light background, you can enable the light-background theme just by putting the following line of code in your .irbrc:
+
+  UtilityBelt::Themes.background(:light)
+
+To revert back to the default, just use this:
+
+  UtilityBelt::Themes.background(:dark)
+
+To specify an entirely new syntax color scheme, see the source code for this gem or for Wirble.
+
+== Pascal/JavaScript-style "with" statement
+
+I use this with RSpec's spec_helper. Instead of:
+
+  Spec::Runner.configure do |config|
+    config.use_transactional_fixtures = true
+    config.use_instantiated_fixtures  = false
+    config.fixture_path = RAILS_ROOT + '/spec/fixtures'
+    config.mock_with :flexmock
+  end
+
+I do this:
+
+  Spec::Runner.configure do |config|
+    with(config) do
+      use_transactional_fixtures = true
+      use_instantiated_fixtures  = false
+      fixture_path = RAILS_ROOT + '/spec/fixtures'
+      mock_with :flexmock
+    end
+  end
+
+Note however that this blew up once and I have no idea why. Caveat emptor, et cetera.
+
+== String#to_proc
+
+Syntactic sugar for functional programming.
+
+  (1..3).map(&'*2') => [2, 4, 6]
+  (1..3).map(&'[-1, _, 0]') => [[-1, 1, 0], [-1, 2, 0], [-1, 3, 0]]
+  (1..3).map(&'x -> y -> x * y').map(&'[2]') => [2, 4, 6]
+  (1..5).select(&'>2') => [3, 4, 5]
+  (1..3).map(&'x -> y -> x * y').map(&'.call(2)') => [2, 4, 6]
+  [5].map(&"(1.._).inject(&'*')") => [120]
+
+For more detail see: http://weblog.raganwald.com/2007/10/stringtoproc.html
+
+== Grammatically-correct is_an? method - no more "is_a? Array" statements
+
+  >> [].is_an? Array
+  #=> true
+
+Most people don't care, but personally, "is_a? Array" drives me completely insane.
+
+== Object#not
+
+Replace this:
+
+  if !response.incomplete? && !response.invalid? && response.total > 0
+
+With this:
+
+  if response.not.incomplete? && response.not.invalid? && response.total > 0
+
+Syntactic sugar for boolean conditions.
+
+More detail here:
+
+http://blog.jayfields.com/2007/08/ruby-adding-not-method-for-readability.html
+
+== One-character exit command
+
+x
+
+Because life is too short to type whole words.
+
+== REQUIREMENTS
+
+* ReadLine
+* Wirble
+* Amazon S3
+* Platform
+* Some features require OS X
+
+== LICENSE
+
+  (The MIT License)
+
+  Copyright (c) 2006-2007 Giles Bowkett
+  Portions Copyright (c) 2006-2007 Ben Bleything
+  Portions Copyright (c) 2006-2007 Reginald Braithwaite
+  Portions Copyright (c) 2006-2007 Gregory Brown
+  Portions Copyright (c) 2006-2007 Jamis Buck
+  Portions Copyright (c) 2006-2007 Mike Clark
+  Portions Copyright (c) 2006-2007 Jay Fields
+  Portions Copyright (c) 2005 David Heinemeier Hansson
+  Portions Copyright (c) 2006-2007 Ara T. Howard
+  Portions Copyright (c) 2006-2007 Pat Maddox
+  Portions Copyright (c) 2006-2007 Marcel Molina, Jr.
+  Portions Copyright (c) 2006-2007 Rick D. Natale
+  Portions Copyright (c) 2006-2007 Projectionist (Marcel Molina? Chad Fowler?)
+  Portions Copyright (c) 2006-2007 Dan Yoder
+
+  Permission is hereby granted, free of charge, to any person obtaining
+  a copy of this software and associated documentation files (the
+  'Software'), to deal in the Software without restriction, including
+  without limitation the rights to use, copy, modify, merge, publish,
+  distribute, sublicense, and/or sell copies of the Software, and to
+  permit persons to whom the Software is furnished to do so, subject to
+  the following conditions:
+
+  The above copyright notice and this permission notice shall be
+  included in all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+  IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+  CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+  TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+  SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,20 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/utility_belt.rb'
+
+Hoe.new('UtilityBelt', UtilityBelt::VERSION) do |p|
+  p.rubyforge_name = 'utility_belt'
+  # p.author = 'Giles Bowkett'
+  # p.email = 'gilesb@gmail.com'
+  # p.summary = 'IRB funk'
+  # p.description = p.paragraphs_of('README.txt', 2..5).join("\n\n")
+  # p.url = p.paragraphs_of('README.txt', 0).first.split(/\n/)[1..-1]
+  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+end
+
+# vim: syntax=Ruby
+
+# I used Hoe to create the dirs etc., but from then on did most of it manually.
+# (I figure if you're reading this at all, the reason is curiousity.)

data/bin/amazon

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+%w{rubygems platform aws/s3 optparse}.each {|library| require library}
+
+option_parser = OptionParser.new
+option_parser.on("-b", "--bucket NAME", String) {|bucket| @bucket = bucket}
+filenames = option_parser.parse(ARGV)
+
+if @bucket && filenames
+  UTILITY_BELT_IRB_STARTUP_PROCS = {}
+
+  utility_belt_lib = File.dirname(__FILE__) + '/../lib'
+  require "#{utility_belt_lib}/mac_clipboard"
+  require "#{utility_belt_lib}/amazon_upload_shortcut"
+
+  UTILITY_BELT_IRB_STARTUP_PROCS[:define_s3_convenience_methods].call
+
+  filenames.each {|filename| puts aws_upload(@bucket, filename)}
+else
+  puts "Usage: amazon -b bucket_name file_name"
+  exit
+end

data/bin/google

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+%w{rubygems platform}.each {|library| require library}
+require "#{File.dirname(__FILE__) + '/../lib'}/mac_clipboard"
+
+if :macosx == Platform::IMPL
+  search_term = ARGV[0] || MacClipboard.read
+  if search_term.empty?
+    puts "Usage: google search_term_without_spaces"
+    puts "       google 'search term with spaces'"
+    puts "       google"
+    puts "              (if invoking without command-line args, must have text in clipboard buffer)"
+    exit
+  end
+  system("open http://google.com/search?q=#{search_term.gsub(/ |\n/, '%20')}")
+end

data/lib/amazon_upload_shortcut.rb

@@ -0,0 +1,12 @@
+# S3 (http://amazon.rubyforge.org/)
+UTILITY_BELT_IRB_STARTUP_PROCS[:define_s3_convenience_methods] = lambda do
+  require 'aws/s3'
+  def aws_upload(bucket,filename)
+    AWS::S3::Base.establish_connection!(:access_key_id => ENV['AMAZON_ACCESS_KEY_ID'], 
+                                        :secret_access_key => ENV['AMAZON_SECRET_ACCESS_KEY'])
+    AWS::S3::S3Object.store(filename, open(filename), bucket, :access => :public_read)
+    url = "http://s3.amazonaws.com/#{bucket}/#{filename}".gsub(/ /, "%20")
+    MacClipboard.write(url) if :macosx == Platform::IMPL
+    url
+  end
+end

data/lib/command_history.rb

@@ -0,0 +1,74 @@
+# history
+# http://blog.bleything.net/pages
+# http://gilesbowkett.blogspot.com/2007/06/irbrc-modifications.html
+# Ben's history stuff, slightly modified, plus hvi method
+class Object
+  def history(how_many = 50)
+    history_size = Readline::HISTORY.size
+    # no lines, get out of here
+    puts "No history" and return if history_size == 0
+    start_index = 0
+    # not enough lines, only show what we have
+    if history_size <= how_many
+      how_many  = history_size - 1
+      end_index = how_many
+    else
+      end_index = history_size - 1 # -1 to adjust for array offset
+      start_index = end_index - how_many 
+    end
+    start_index.upto(end_index) {|i| print_line i}
+  end
+  alias :h  :history
+
+  # -2 because -1 is ourself
+  def history_do(lines = (Readline::HISTORY.size - 2))
+    irb_eval lines
+  end 
+  alias :h! :history_do
+
+  def history_write(filename, lines)
+    file = File.open(filename, 'w')
+    get_lines(lines).each do |l|
+      file << "#{l}\n"
+    end
+    file.close
+  end
+
+  # TODO: history_write should go to a file, or the clipboard, or a file which opens in an application
+  def history_to_vi
+    file = Tempfile.new("irb_tempfile")
+    get_lines(0..(Readline::HISTORY.size - 1)).each do |line|
+      file << "#{line}\n"
+    end
+    file.close
+    system("vim #{file.path}")
+  end
+  alias :hvi :history_to_vi
+
+  private
+  def get_line(line_number)
+    Readline::HISTORY[line_number]
+  end
+
+  def get_lines(lines = [])
+    return [get_line(lines)] if lines.is_a? Fixnum
+    out = []
+    lines = lines.to_a if lines.is_a? Range
+    lines.each do |l|
+      out << Readline::HISTORY[l]
+    end
+    out
+  end
+
+  def print_line(line_number, show_line_numbers = true)
+    print line_number.to_s + ": " if show_line_numbers
+    puts get_line(line_number)
+  end
+
+  def irb_eval(lines)
+    to_eval = get_lines(lines)
+    to_eval.each {|l| Readline::HISTORY << l}
+    eval to_eval.join("\n")
+  end
+end
+

data/lib/interactive_editor.rb

@@ -0,0 +1,42 @@
+# Giles Bowkett, Greg Brown, and several audience members from Giles' Ruby East presentation.
+class InteractiveEditor
+  attr_accessor :editor
+  def initialize(editor = :vim)
+    @editor = editor.to_s
+    if @editor == "mate"
+      @editor = "mate -w"
+    end
+  end
+  def edit
+    unless @file
+      @file = Tempfile.new("irb_tempfile")
+    end
+    system("#{@editor} #{@file.path}")
+    Object.class_eval(`cat #{@file.path}`)
+    rescue Exception => error
+      puts error
+  end
+end
+
+class Object
+  def edit(editor)
+    unless IRB.conf[:interactive_editors] && IRB.conf[:interactive_editors][editor]
+      IRB.conf[:interactive_editors] ||= {}
+      IRB.conf[:interactive_editors][editor] = InteractiveEditor.new(editor)
+    end
+    IRB.conf[:interactive_editors][editor].edit
+  end
+
+  def vi
+    edit(:vim)
+  end
+
+  def mate
+    edit(:mate)
+  end
+
+  def emacs
+    edit(:emacs)
+  end
+end
+

data/lib/irb_options.rb

@@ -0,0 +1,3 @@
+# auto indent, _ special var
+IRB.conf[:AUTO_INDENT] = true
+IRB.conf[:EVAL_HISTORY] = 1000

data/lib/irb_verbosity_control.rb

@@ -0,0 +1,30 @@
+# IRB verbosity: http://groups.google.com/group/ruby-talk-google/browse_thread/thread/9c1febbe05513dc0
+module IRB 
+  def self.result_format 
+     conf[:PROMPT][conf[:PROMPT_MODE]][:RETURN] 
+  end 
+  def self.result_format=(str) 
+     result_format.replace(str) 
+  end 
+  def self.show_results 
+     self.result_format = "=> %s\n"
+  end 
+  def self.hide_results 
+     self.result_format = '' 
+  end 
+end
+
+class Object
+  def verbose
+    IRB.show_results
+  end
+  alias :v :verbose
+
+  def quiet
+    IRB.hide_results
+  end
+  alias :q :quiet
+
+  alias :x :exit
+end
+

data/lib/is_an.rb

@@ -0,0 +1,4 @@
+# is_a? Array bothers me
+class Object
+  alias :is_an? :is_a?
+end

data/lib/language_greps.rb

@@ -0,0 +1,19 @@
+# TODO: upgrade these to take either regexes or strings
+
+# http://gilesbowkett.blogspot.com/2006/12/smalltalk-cleverness-translated-into.html
+# http://gilesbowkett.com/blog_code_samples/122906_seaside_rails/controller.txt
+class Object
+  def grep_classes(search_term)
+    classes = []
+    ObjectSpace.each_object {|object| classes << object.name if object.is_a? Class and not object.name.blank?}
+    classes.find_all {|klass| klass.downcase.include? search_term.downcase}
+  end
+end
+
+# http://gilesbowkett.blogspot.com/2007/11/irb-what-was-that-method-again.html
+class Object
+  def grep_methods(search_term)
+    methods.find_all {|method| method.downcase.include? search_term.downcase}
+  end
+end
+

data/lib/mac_clipboard.rb

@@ -0,0 +1,15 @@
+# original clipboard code: http://project.ioni.st/post/1334#snippet_1334
+# turned it into a class to make it flexxy:
+# http://gilesbowkett.blogspot.com/2007/09/improved-auto-pastie-irb-code.html
+class MacClipboard
+  if :macosx == Platform::IMPL
+    class << self
+      def read
+        IO.popen('pbpaste') {|clipboard| clipboard.read}
+      end
+      def write(stuff)
+        IO.popen('pbcopy', 'w+') {|clipboard| clipboard.write(stuff)}
+      end
+    end
+  end
+end

data/lib/not.rb

@@ -0,0 +1,15 @@
+# http://blog.jayfields.com/2007/08/ruby-adding-not-method-for-readability.html
+class Object
+  define_method :not do
+    Not.new(self)
+  end
+  class Not
+    private *instance_methods.select { |m| m !~ /(^__|^\W|^binding$)/ }
+    def initialize(subject)
+      @subject = subject
+    end
+    def method_missing(sym, *args, &blk)
+      !@subject.send(sym,*args,&blk)
+    end
+  end
+end

data/lib/pastie.rb

@@ -0,0 +1,16 @@
+# automate creating pasties
+class Object
+  if :macosx == Platform::IMPL
+    def pastie
+      url = 
+      pastie_url = Net::HTTP.post_form(URI.parse("http://pastie.caboo.se/pastes/create"),
+                                       {"paste_parser" => "ruby",
+                                        "paste[authorization]" => "burger",
+                                        "paste[body]" => MacClipboard.read}).body.match(/href="([^\"]+)"/)[1]
+      MacClipboard.write(pastie_url)
+      system("open #{pastie_url}")
+      pastie_url
+    end
+    alias :pst :pastie
+  end
+end

data/lib/rails_finder_shortcut.rb

@@ -0,0 +1,18 @@
+# http://www.clarkware.com/cgi/blosxom/2007/09/03#ConsoleFindShortcut
+# Mike Clark's find() shortcut for Rails console
+
+# Creates shortcut methods for finding models.
+UTILITY_BELT_IRB_STARTUP_PROCS[:define_model_find_shortcuts] = lambda do
+  if defined? ActiveRecord::Base || defined? ActiveResource::Base
+    model_files = Dir.glob("app/models/**/*.rb")
+    table_names = model_files.map { |f| File.basename(f).split('.')[0..-2].join }
+    table_names.each do |table_name|
+      Object.instance_eval do
+        define_method(table_name) do |*args|
+          table_name.camelize.constantize.send(:find, *args)
+        end
+      end
+    end
+  end
+end
+# note: Mike wrote this for ARec, but it works on ARes too since it doesn't hit the DB

data/lib/rails_verbosity_control.rb

@@ -0,0 +1,9 @@
+# Rails verbosity: http://weblog.jamisbuck.org/2007/1/8/watching-activerecord-do-it-s-thing
+# Marcel said they toyed with making this the console default on core
+class Object
+  def log
+    ActiveRecord::Base.clear_active_connections!
+    ActiveRecord::Base.logger = Logger.new(STDOUT)
+  end
+end
+

data/lib/string_to_proc.rb

@@ -0,0 +1,72 @@
+# String#to_proc
+#
+# See http://weblog.raganwald.com/2007/10/stringtoproc.html
+#
+# Ported from the String Lambdas in Oliver Steele's Functional Javascript
+# http://osteele.com/sources/javascript/functional/
+#
+# This work is licensed under the MIT License:
+#
+# (c) 2007 Reginald Braithwaite
+# Portions Copyright (c) 2006 Oliver Steele
+# 
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+# 
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+class String
+  unless public_method_defined? :to_proc
+    def to_proc &block
+      params = []
+      expr = self
+      sections = expr.split(/\s*->\s*/m)
+      if sections.length > 1 then
+          eval_block(sections.reverse!.inject { |e, p| "(Proc.new { |#{p.split(/\s/).join(', ')}| #{e} })" }, block)
+      elsif expr.match(/\b_\b/)
+          eval_block("Proc.new { |_| #{expr} }", block)
+      else
+          leftSection = expr.match(/^\s*(?:[+*\/%&|\^\.=<>\[]|!=)/m)
+          rightSection = expr.match(/[+\-*\/%&|\^\.=<>!]\s*$/m)
+          if leftSection || rightSection then
+              if (leftSection) then
+                  params.push('$left')
+                  expr = '$left' + expr
+              end
+              if (rightSection) then
+                  params.push('$right')
+                  expr = expr + '$right'
+              end
+          else
+              self.gsub(
+                  /(?:\b[A-Z]|\.[a-zA-Z_$])[a-zA-Z_$\d]*|[a-zA-Z_$][a-zA-Z_$\d]*:|self|arguments|'(?:[^'\\]|\\.)*'|"(?:[^"\\]|\\.)*"/, ''
+              ).scan(
+                /([a-z_$][a-z_$\d]*)/i
+              ) do |v|  
+                params.push(v) unless params.include?(v)
+              end
+          end
+          eval_block("Proc.new { |#{params.join(', ')}| #{expr} }", block)
+      end
+    end
+    private
+    def eval_block(code, block)
+      eval code, block && block.binding
+    end
+  end
+end
+

data/lib/symbol_to_proc.rb

@@ -0,0 +1,30 @@
+#--
+# Copyright (c) 2005 David Heinemeier Hansson
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#++
+
+class Symbol
+  unless public_method_defined? :to_proc
+    def to_proc
+      Proc.new { |*args| args.shift.__send__(self, *args) }
+    end
+  end
+end

data/lib/themes.rb

@@ -0,0 +1,79 @@
+module UtilityBelt
+  module Themes
+    def self.background(bkg)
+      case bkg
+      when :dark
+        Wirble::Colorize.colors = UtilityBelt::Themes::WIRBLE_DEFAULT_THEME
+      when :light
+        Wirble::Colorize.colors = UtilityBelt::Themes::THEME_FOR_WHITE_BKG
+      end
+    end
+    WIRBLE_DEFAULT_THEME = {
+      # delimiter colors
+      :comma              => :blue,
+      :refers             => :blue,
+
+      # container colors (hash and array)
+      :open_hash          => :green,
+      :close_hash         => :green,
+      :open_array         => :green,
+      :close_array        => :green,
+
+      # object colors
+      :open_object        => :light_red,
+      :object_class       => :white,
+      :object_addr_prefix => :blue,
+      :object_line_prefix => :blue,
+      :close_object       => :light_red,
+
+      # symbol colors
+      :symbol             => :yellow,
+      :symbol_prefix      => :yellow,
+
+      # string colors
+      :open_string        => :red,
+      :string             => :cyan,
+      :close_string       => :red,
+
+      # misc colors
+      :number             => :cyan,
+      :keyword            => :green,
+      :class              => :light_green,
+      :range              => :red,
+    }
+    THEME_FOR_WHITE_BKG = {
+      # delimiter colors
+      :comma              => :purple,
+      :refers             => :blue,
+
+      # container colors (hash and array)
+      :open_hash          => :red,
+      :close_hash         => :red,
+      :open_array         => :red,
+      :close_array        => :red,
+
+      # object colors
+      :open_object        => :dark_gray,
+      :object_class       => :purple,
+      :object_addr_prefix => :blue,
+      :object_line_prefix => :blue,
+      :close_object       => :dark_gray,
+
+      # symbol colors
+      :symbol             => :black,
+      :symbol_prefix      => :light_gray,
+
+      # string colors
+      :open_string        => :blue,
+      :string             => :dark_gray,
+      :close_string       => :blue,
+
+      # misc colors
+      :number             => :black,
+      :keyword            => :brown,
+      :class              => :red,
+      :range              => :blue,
+    }
+    COLORS = WIRBLE_DEFAULT_THEME
+  end
+end

data/lib/utility_belt.rb

@@ -0,0 +1,39 @@
+# This started as my (Giles Bowkett's) .irbrc file, turned into a recipe on IRB for the Pragmatic Programmers,
+# and soon became a scrapbook of cool code snippets from all over the place. All the RDoc lives in the README.
+# Check that file for usage information, authorship, copyright, and extensive details. This file contains the
+# actual code (duh), and a bunch of links to relevant blog posts. You can also find a nice, HTMLified version
+# of the README content at http://utilitybelt.rubyforge.org.
+
+UTILITY_BELT_IRB_STARTUP_PROCS = {}
+
+%w{rubygems
+   platform
+   wirble
+   net/http
+   tempfile}.each {|library| require library}
+%w{init colorize}.each {|message| Wirble.send(message)}
+%w{mac_clipboard
+   is_an
+   pastie
+   themes
+   irb_verbosity_control
+   rails_verbosity_control
+   command_history
+   not
+   language_greps
+   rails_finder_shortcut
+   amazon_upload_shortcut
+   irb_options
+   interactive_editor
+   string_to_proc
+   symbol_to_proc
+   with}.each {|internal_library| require internal_library}
+
+# default: dark background
+UtilityBelt::Themes.background(:dark)
+
+# Called when the irb session is ready, after any external libraries have been loaded. I can't
+# remember why I did this. it might be a cargo cult thing.
+IRB.conf[:IRB_RC] = lambda do
+  UTILITY_BELT_IRB_STARTUP_PROCS.each {|symbol, proc| proc.call}
+end

data/lib/with.rb

@@ -0,0 +1,21 @@
+# Object#with -- by Dan Yoder, dev.zeraweb.com -- this is something from Pascal
+# and JavaScript. here's the use case.
+
+# instead of:
+#   some_object.do_x
+#   some_object.do_y
+#   some_object.do_z
+#
+# you can instead do:
+#   with(some_object)
+#     do_x
+#     do_y
+#     do_z
+#   end
+
+class Object
+  def with(object, &block)
+    object.instance_eval &block
+  end
+end
+

data/test/string_to_proc_spec.rb

@@ -0,0 +1,40 @@
+require "string_to_proc"
+describe "String to Proc" do
+
+  before(:all) do
+    @one2five = 1..5
+  end
+
+  it "should handle simple arrow notation" do
+    @one2five.map(&'x -> x + 1').should eql(@one2five.map { |x| x + 1 })
+    @one2five.map(&'x -> x*x').should eql(@one2five.map { |x| x*x })
+    @one2five.inject(&'x y -> x*y').should eql(@one2five.inject { |x,y| x*y })
+    'x y -> x**y'.to_proc()[2,3].should eql(lambda { |x,y| x**y }[2,3])
+    'y x -> x**y'.to_proc()[2,3].should eql(lambda { |y,x| x**y }[2,3])
+  end
+
+  it "should handle chained arrows" do
+    'x -> y -> x**y'.to_proc()[2][3].should eql(lambda { |x| lambda { |y| x**y } }[2][3])
+    'x -> y z -> y**(z-x)'.to_proc()[1][2,3].should eql(lambda { |x| lambda { |y,z| y**(z-x) } }[1][2,3])
+  end
+
+  it "should handle the default parameter" do
+    @one2five.map(&'2**_/2').should eql(@one2five.map { |x| 2**x/2 })
+    @one2five.select(&'_%2==0').should eql(@one2five.select { |x| x%2==0 })
+  end
+
+  it "should handle point-free notation" do
+    @one2five.inject(&'*').should eql(@one2five.inject { |mem, var| mem * var })
+    @one2five.select(&'>2').should eql(@one2five.select { |x| x>2 })
+    @one2five.select(&'2<').should eql(@one2five.select { |x| 2<x })
+    @one2five.map(&'2*').should eql(@one2five.map { |x| 2*x })
+    (-3..3).map(&'.abs').should eql((-3..3).map { |x| x.abs })
+  end
+
+  it "should handle implied parameters as best it can" do
+    @one2five.inject(&'x*y').should eql(@one2five.inject(&'*'))
+    'x**y'.to_proc()[2,3].should eql(8)
+    'y**x'.to_proc()[2,3].should eql(8)
+  end
+
+end

data/test/utility_belt_spec.rb

@@ -0,0 +1,2 @@
+# yeah, I know. I know! but you try to write specs for code which launches vi. most of this was
+# already written by the time I started tasting the BDD Kool-Aid.

data/utility_belt.gemspec

@@ -0,0 +1,22 @@
+require 'rubygems' 
+SPEC = Gem::Specification.new do |s| 
+  s.name = "utility_belt"
+  s.version = "1.0.0"
+  s.author = "Giles Bowkett"
+  s.email = "gilesb@gmail.com"
+  s.homepage = "http://utilitybelt.rubyforge.org"
+  s.platform = Gem::Platform::RUBY
+  s.summary = "A grab-bag of IRB power user madness."
+  s.files = Dir.glob("**/*")
+  %w{amazon google}.each do |command_line_utility_for_interacting_with_a_gigantic_self_aware_ai|
+    s.executables << command_line_utility_for_interacting_with_a_gigantic_self_aware_ai
+  end
+  s.require_path = "lib"
+  s.autorequire = "utility_belt"
+  s.test_file = "test/utility_belt_spec.rb"
+  s.has_rdoc = true 
+  s.extra_rdoc_files = ["README"] 
+  s.add_dependency("wirble", ">= 0.1.2")
+  s.add_dependency("aws-s3", ">= 0.4.0")
+  s.add_dependency("Platform", ">= 0.4.0")
+end 

metadata

@@ -0,0 +1,109 @@
+--- !ruby/object:Gem::Specification 
+name: utility_belt
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Giles Bowkett
+autorequire: utility_belt
+bindir: bin
+cert_chain: []
+
+date: 2007-12-03 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: wirble
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.1.2
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: aws-s3
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.4.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: Platform
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.4.0
+    version: 
+description: 
+email: gilesb@gmail.com
+executables: 
+- amazon
+- google
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- bin
+- bin/amazon
+- bin/google
+- History.txt
+- lib
+- lib/amazon_upload_shortcut.rb
+- lib/command_history.rb
+- lib/interactive_editor.rb
+- lib/irb_options.rb
+- lib/irb_verbosity_control.rb
+- lib/is_an.rb
+- lib/language_greps.rb
+- lib/mac_clipboard.rb
+- lib/not.rb
+- lib/pastie.rb
+- lib/rails_finder_shortcut.rb
+- lib/rails_verbosity_control.rb
+- lib/string_to_proc.rb
+- lib/symbol_to_proc.rb
+- lib/themes.rb
+- lib/utility_belt.rb
+- lib/with.rb
+- Manifest.txt
+- Rakefile
+- README
+- test
+- test/string_to_proc_spec.rb
+- test/utility_belt_spec.rb
+- utility_belt-1.0.0.gem
+- utility_belt.gemspec
+has_rdoc: true
+homepage: http://utilitybelt.rubyforge.org
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 0.9.5
+signing_key: 
+specification_version: 2
+summary: A grab-bag of IRB power user madness.
+test_files: 
+- test/utility_belt_spec.rb