subelsky_power_tools 1.0.0

data/.gitignore

@@ -0,0 +1 @@
+*.gem

data/.rspec

@@ -0,0 +1,3 @@
+--colour
+--drb
+--drb-port 9501

data/.rvmrc

@@ -0,0 +1 @@
+rvm use 1.9.2-p180-patched@subelsky_power_tools --create

data/Gemfile

@@ -0,0 +1,9 @@
+source :rubygems
+gemspec
+
+group :test do
+  gem "rb-fsevent", "0.4.0"
+  gem "growl", "1.0.3"
+  gem "guard-spork", "0.2.0"
+  gem "guard-rspec", "0.4.0"
+end

data/Gemfile.lock

@@ -0,0 +1,39 @@
+PATH
+  remote: .
+  specs:
+    subelsky_power_tools (1.0.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.2)
+    growl (1.0.3)
+    guard (0.4.2)
+      thor (~> 0.14.6)
+    guard-rspec (0.4.0)
+      guard (>= 0.4.0)
+    guard-spork (0.2.0)
+      guard (>= 0.2.2)
+      spork (>= 0.8.4)
+    rb-fsevent (0.4.0)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.4)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.6.0)
+    spork (0.8.5)
+    thor (0.14.6)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  growl (= 1.0.3)
+  guard-rspec (= 0.4.0)
+  guard-spork (= 0.2.0)
+  rb-fsevent (= 0.4.0)
+  rspec
+  subelsky_power_tools!

data/Guardfile

@@ -0,0 +1,9 @@
+guard 'spork', :rspec_port => 9501 do
+  watch(%r{^spec/spec_helper.rb$})
+end
+
+guard 'rspec', :version => 2 do
+  watch(%r{spec/(.*)_spec.rb})
+  watch(%r{lib/(.*)\.rb})                            { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')                       { "spec" }
+end

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Mike Subelsky
+
+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/README.md

@@ -0,0 +1,25 @@
+# Subelsky Power Tools Gem
+
+This is a collection of Ruby extensions and utilities I've been carting around from project to project. 
+Many are taken from the [Facets](http://rubyworks.github.com/facets/) project (I just don't want to
+include that whole gem in my codebases).
+
+The name is a tribute to [Topfunky Power Tools](http://topfunky.net/svn/plugins/topfunky_power_tools/).
+
+# Installation
+
+    gem install subelsky_power_tools
+
+# Usage
+
+The gem does not automatically require anything, so you can pick and choose which extensions get
+added, by requiring them individually, e.g.:
+
+    require 'subelsky_power_tools/ext/hash'
+    require 'subelsky_power_tools/ext/exception'
+
+See the individual extensions in `lib` or their tests in the `spec` directory.
+
+# Problems? Questions?
+
+Email <mike@subelsky.com> or file an issue on [GitHub](https://github.com/subelsky/subelsky_power_tools). Thanks!

data/Rakefile

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby"
+
+require 'rake/clean'
+require 'rake/testtask'
+
+task :default => :spec
+
+task :spec do
+  sh "rspec spec"
+end

data/lib/subelsky_power_tools/ext/exception.rb

@@ -0,0 +1,19 @@
+# https://github.com/rubyworks/facets/blob/master/lib/core/facets/exception/detail.rb
+class Exception
+
+  # Pretty string output of exception/error
+  # object useful for helpful debug messages.
+  #
+  # Input:
+  # The Exception/StandardError object
+  #
+  # Output:
+  # The pretty printed string
+  #
+  # CREDIT: George Moschovitis
+
+  def detail
+    return %{#{self.class.name}: #{message}\n#{backtrace.join("\n  ")}\n  LOGGED FROM: #{caller[0]}}
+  end
+
+end

data/lib/subelsky_power_tools/ext/hash.rb

@@ -0,0 +1,54 @@
+# https://github.com/rubyworks/facets/blob/master/lib/core/facets/hash/except.rb
+# https://github.com/rubyworks/facets/blob/master/lib/core/facets/hash/slice.rb
+
+class Hash
+
+  # Returns a new hash less the given keys.
+  def except(*less_keys)
+    hash = dup
+    less_keys.each{ |k| hash.delete(k) }
+    hash
+  end
+
+  # Replaces hash with new hash less the given keys.
+  # This returns the hash of keys removed.
+  #
+  #   h = {:a=>1, :b=>2, :c=>3}
+  #   h.except!(:a)  #=> {:a=>1}
+  #   h              #=> {:b=>2,:c=>3}
+  #
+  # Returns a Hash of the removed pairs.
+  def except!(*rejected)
+    removed = {}
+    rejected.each{ |k| removed[k] = delete(k) }
+    removed
+  end
+
+  # Returns a new hash with only the given keys.
+  #
+  #   h = {:a=>1, :b=>2}
+  #   h.only(:a)  #=> {:a=>1}
+  #
+  def only(*keep_keys)
+    hash = {}
+    keep_keys.each do |key|
+      hash[key] = fetch(key)
+    end
+    hash
+  end
+
+  # Replaces hash with a new hash having only the given keys.
+  # This return the hash of keys removed.
+  #
+  #   h = {:a=>1, :b=>2}
+  #   h.only!(:a)  #=> {:b=>2}
+  #   h             #=> {:a=>1}
+  #
+  # Returns a Hash of the removed pairs.
+  def only!(*keep_keys)
+    rejected = keys - keep_keys
+    removed = {}
+    rejected.each{ |k| removed[k] = delete(k) }
+    removed
+  end
+end

data/lib/subelsky_power_tools/version.rb

@@ -0,0 +1,3 @@
+module SubelskyPowerTools
+  VERSION = "1.0.0"
+end

data/lib/subelsky_power_tools.rb

@@ -0,0 +1,2 @@
+module SubelskyPowerTools
+end

data/spec/exception_spec.rb

@@ -0,0 +1,12 @@
+require "spec_helper"
+require "subelsky_power_tools/ext/exception"
+
+describe Exception do
+  it "reports details" do
+    begin
+      raise StandardError.new("something bad happened")
+    rescue StandardError => e
+      e.detail.should =~ /StandardError: something bad happened\n/
+    end
+  end
+end

data/spec/hash_spec.rb

@@ -0,0 +1,30 @@
+require "spec_helper"
+require "subelsky_power_tools/ext/hash"
+
+describe Hash do
+
+  let(:h) do
+    { :a => 1, :b => 2, :c => 3 }
+  end
+
+  it "should except given keys" do
+    h.except(:a).should == { :b => 2, :c => 3 }
+    h.except(:a,:c).should == { :b => 2 }
+  end
+
+  it "should perform destructive exceptions" do
+    h.except!(:c).should == { :c => 3 }
+    h.should == { :a => 1, :b => 2 }
+    h.except!(:a,:b)
+    h.should be_empty
+  end
+
+  it "should include given keys only" do
+    h.only(:a,:b).should == { :a => 1, :b => 2 }
+  end
+
+  it "should perform destructive inclusion" do
+    h.only!(:c).should == { :a => 1, :b => 2}
+    h.should == { :c => 3 }
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,31 @@
+require "spork"
+$:.unshift(File.join(File.dirname(__FILE__),"..","lib"))
+
+Spork.prefork do
+  require "rspec"
+
+  RSpec.configure do |config|
+    config.mock_with :rspec
+
+    last_gc_run = Time.now
+    
+    config.before(:each) do
+      GC.disable
+    end
+    
+    config.after(:each) do
+      if Time.now - last_gc_run > 1.0
+        GC.enable
+        GC.start
+        last_gc_run = Time.now
+      end
+    end
+
+  end
+
+  require 'rspec/expectations'
+  require 'rspec/core/expecting/with_rspec'
+end
+
+Spork.each_run do
+end

data/subelsky_power_tools.gemspec

@@ -0,0 +1,23 @@
+$:.unshift(File.dirname(__FILE__))
+require 'lib/subelsky_power_tools/version'
+
+Gem::Specification.new do |s|
+  s.name = %q{subelsky_power_tools}
+  s.version = SubelskyPowerTools::VERSION
+  s.authors = ["Mike Subelsky"]
+  s.date = Time.now.utc.strftime("%Y-%m-%d")
+  s.email = %q{mike@subelsky.com}
+  s.extra_rdoc_files = %w(README.md)
+  s.files = `git ls-files`.split("\n")
+  s.homepage = %q{http://github.com/subelsky/subelsky_power_tools}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.summary = %q{This is a collection of Ruby extensions and utilities I've been carting around from project to project.}
+  s.description = <<-DESC
+This is a collection of Ruby extensions and utilities I've been carting around from project to project. 
+Many are taken from the Facets project (I just don't want to include that whole gem in my codebases).
+DESC
+  s.test_files = `git ls-files spec`.split("\n")
+  s.add_development_dependency 'rspec'
+  s.license = "MIT"
+end

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification
+name: subelsky_power_tools
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Mike Subelsky
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-07-05 00:00:00.000000000 -04:00
+default_executable: 
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2157564940 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2157564940
+description: ! "This is a collection of Ruby extensions and utilities I've been carting
+  around from project to project. \nMany are taken from the Facets project (I just
+  don't want to include that whole gem in my codebases).\n"
+email: mike@subelsky.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- .gitignore
+- .rspec
+- .rvmrc
+- Gemfile
+- Gemfile.lock
+- Guardfile
+- MIT-LICENSE
+- README.md
+- Rakefile
+- lib/subelsky_power_tools.rb
+- lib/subelsky_power_tools/ext/exception.rb
+- lib/subelsky_power_tools/ext/hash.rb
+- lib/subelsky_power_tools/version.rb
+- spec/exception_spec.rb
+- spec/hash_spec.rb
+- spec/spec_helper.rb
+- subelsky_power_tools.gemspec
+has_rdoc: true
+homepage: http://github.com/subelsky/subelsky_power_tools
+licenses:
+- MIT
+post_install_message: 
+rdoc_options:
+- --charset=UTF-8
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: This is a collection of Ruby extensions and utilities I've been carting around
+  from project to project.
+test_files:
+- spec/exception_spec.rb
+- spec/hash_spec.rb
+- spec/spec_helper.rb