monkey-patches 0.0.0 → 0.5.0

data/LICENSE

@@ -1,20 +1,19 @@
-Copyright (c) 2009 Stephen Touset
+Copyright (c) 2010 Stephen Karl Touset
 
-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:
+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 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.
+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.rdoc

@@ -1,17 +1,19 @@
 = monkey-patches
 
-Description goes here.
+This is a set of commonly-used extensions to Ruby core classes, implemented
+using the Monkey[http://github.com/stouset/monkey] monkeypatching framework.
 
-== Note on Patches/Pull Requests
- 
-* Fork the project.
-* Make your feature addition or bug fix.
-* Add tests for it. This is important so I don't break it in a
-  future version unintentionally.
-* Commit, do not mess with rakefile, version, or history.
-  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
-* Send me a pull request. Bonus points for topic branches.
+== Usage
 
-== Copyright
+The easiest way to use monkey-patches is to simply require the whole set of
+patches.
 
-Copyright (c) 2010 Stephen Touset. See LICENSE for details.
+  require 'monkey/patches'
+  
+  Monkey.patch(Array, :blank?) { [].blank? }
+
+Alternatively, you can require patches as-needed.
+
+  require 'monkey/patch/object/metaclass'
+  
+  Monkey.patch(String, :metaclass) { "foo".metaclass }

data/Rakefile

@@ -1,53 +1,42 @@
 require 'rubygems'
-require 'rake'
 
-begin
-  require 'jeweler'
-  Jeweler::Tasks.new do |gem|
-    gem.name = "monkey-patches"
-    gem.summary = %Q{A set of monkeypatches for the monkey gem}
-    gem.description = %Q{This is just a dummy package to reserve the name until the project is ready to be released}
-    gem.email = "stephen@touset.org"
-    gem.homepage = "http://github.com/stouset/monkey-patches"
-    gem.authors = ["Stephen Touset"]
-    gem.add_development_dependency "thoughtbot-shoulda", ">= 0"
-    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
-  end
-  Jeweler::GemcutterTasks.new
-rescue LoadError
-  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
-end
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+require 'rake/version_task'
+require 'spec/rake/spectask'
 
-require 'rake/testtask'
-Rake::TestTask.new(:test) do |test|
-  test.libs << 'lib' << 'test'
-  test.pattern = 'test/**/test_*.rb'
-  test.verbose = true
+spec = Gem::Specification.new do |s|
+  s.name     = 'monkey-patches'
+  s.version  = Version.current
+  s.summary  = 'Monkeypatches build on the monkey extension framework'
+  s.homepage = 'http://github.com/stouset/monkey-patches'
+  
+  s.author = 'Stephen Touset'
+  s.email  = 'stephen@touset.org'
+  
+  s.files = Dir['[A-Z]*', 'lib/**/*.rb']
+  
+  s.extra_rdoc_files = Dir['*.rdoc']
+  s.rdoc_options     = %w{ --main README.rdoc }
+  
+  s.add_dependency 'monkey'
+  
+  s.add_development_dependency 'version'
 end
 
-begin
-  require 'rcov/rcovtask'
-  Rcov::RcovTask.new do |test|
-    test.libs << 'test'
-    test.pattern = 'test/**/test_*.rb'
-    test.verbose = true
-  end
-rescue LoadError
-  task :rcov do
-    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
-  end
+Rake::GemPackageTask.new(spec) do |gem|
+  gem.need_tar = true
 end
 
-task :test => :check_dependencies
-
-task :default => :test
-
-require 'rake/rdoctask'
-Rake::RDocTask.new do |rdoc|
-  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+Rake::RDocTask.new do |doc|
+  doc.title    = "monkey-patches #{Version.current}"
+  doc.rdoc_dir = 'doc'
+  doc.main     = 'README.rdoc'
+  doc.rdoc_files.include('*.rdoc')
+  doc.rdoc_files.include('lib/**/*.rb')
+end
 
-  rdoc.rdoc_dir = 'rdoc'
-  rdoc.title = "monkey-patches #{version}"
-  rdoc.rdoc_files.include('README*')
-  rdoc.rdoc_files.include('lib/**/*.rb')
+Rake::VersionTask.new do |v|
+  v.with_git_tag = true
+  v.with_gemspec = spec
 end

data/VERSION

@@ -1 +1 @@
-0.0.0
+0.5.0

data/lib/monkey/patch/array/from.rb

@@ -0,0 +1,13 @@
+require 'monkey'
+
+# 
+# Copyright (c) 2005-2010 David Heinemeier Hansson
+#
+Monkey.see(Array) do
+  #
+  # Returns the tail of the array from +position+.
+  #
+  def from(position)
+    self[position .. -1]
+  end
+end

data/lib/monkey/patch/array/to.rb

@@ -0,0 +1,11 @@
+# 
+# Copyright (c) 2005-2010 David Heinemeier Hansson
+#
+Monkey.see(Array) do
+  #
+  # Returns the beginning of the array up to +position+.
+  #
+  def to(position)
+    self[0 .. position]
+  end
+end

data/lib/monkey/patch/object/blank.rb

@@ -0,0 +1,13 @@
+require 'monkey'
+
+# 
+# Copyright (c) 2005-2010 David Heinemeier Hansson
+#
+Monkey.see(Object) do
+  #
+  # An object is blank if it's false, empty, or a whitespace string.
+  #
+  def blank?
+    respond_to?(:empty?) ? empty? : !self
+  end
+end

data/lib/monkey/patch/object/metaclass.rb

@@ -0,0 +1,10 @@
+require 'monkey'
+
+Monkey.see(Object) do
+  #
+  # Returns the object's singleton class.
+  #
+  def metaclass
+    class << self; self; end
+  end
+end

data/lib/monkey/patch/object/returning.rb

@@ -0,0 +1,49 @@
+require 'monkey'
+
+# 
+# Copyright (c) 2005-2010 David Heinemeier Hansson
+#
+Monkey.see(Object) do
+  #
+  # Returns +value+ after yielding +value+ to the block. This simplifies the
+  # process of constructing an object, performing work on the object, and then
+  # returning the object from a method. It is a Ruby-ized realization of the K
+  # combinator, courtesy of Mikael Brockman.
+  #
+  # ==== Examples
+  #
+  #  # Without returning
+  #  def foo
+  #    values = []
+  #    values << "bar"
+  #    values << "baz"
+  #    return values
+  #  end
+  #
+  #  foo # => ['bar', 'baz']
+  #
+  #  # returning with a local variable
+  #  def foo
+  #    returning values = [] do
+  #      values << 'bar'
+  #      values << 'baz'
+  #    end
+  #  end
+  #
+  #  foo # => ['bar', 'baz']
+  #
+  #  # returning with a block argument
+  #  def foo
+  #    returning [] do |values|
+  #      values << 'bar'
+  #      values << 'baz'
+  #    end
+  #  end
+  #
+  #  foo # => ['bar', 'baz']
+  #
+  def returning(value)
+    yield(value)
+    value
+  end
+end

data/lib/monkey/patch/object/try.rb

@@ -0,0 +1,31 @@
+require 'monkey'
+
+# 
+# Copyright (c) 2005-2010 David Heinemeier Hansson
+#
+Monkey.see(Object) do
+  #
+  # Invokes the method identified by the symbol +method+, passing it any arguments
+  # and/or the block specified, just like the regular Ruby <tt>Object#send</tt> does.
+  #
+  # *Unlike* that method however, a +NoMethodError+ exception will *not* be raised
+  # and +nil+ will be returned instead, if the receiving object is a +nil+ object or NilClass.
+  #
+  # ==== Examples
+  #
+  # Without try
+  #   @person && @person.name
+  # or
+  #   @person ? @person.name : nil
+  #
+  # With try
+  #   @person.try(:name)
+  #
+  # +try+ also accepts arguments and/or a block, for the method it is trying
+  #   Person.try(:find, 1)
+  #   @people.try(:collect) {|p| p.name}
+  #
+  def try(method, *args, &block)
+    self.nil? ? nil : self.send(method, *args, &block)
+  end
+end

data/lib/monkey/patches.rb

@@ -0,0 +1,5 @@
+require 'pathname'
+
+Dir[Pathname.new(__FILE__).dirname.join('patch/**/*.rb')].each do |patch|
+  require patch
+end

metadata

@@ -1,7 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: monkey-patches
 version: !ruby/object:Gem::Version 
-  version: 0.0.0
+  hash: 11
+  prerelease: false
+  segments: 
+  - 0
+  - 5
+  - 0
+  version: 0.5.0
 platform: ruby
 authors: 
 - Stephen Touset
@@ -9,66 +15,91 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-02-26 00:00:00 -05:00
+date: 2010-07-14 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
-  name: thoughtbot-shoulda
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  name: monkey
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: version
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
         version: "0"
-    version: 
-description: This is just a dummy package to reserve the name until the project is ready to be released
+  type: :development
+  version_requirements: *id002
+description: 
 email: stephen@touset.org
 executables: []
 
 extensions: []
 
 extra_rdoc_files: 
-- LICENSE
 - README.rdoc
 files: 
-- .document
-- .gitignore
 - LICENSE
-- README.rdoc
 - Rakefile
+- README.rdoc
 - VERSION
-- lib/monkey-patches.rb
-- test/helper.rb
-- test/test_monkey-patches.rb
+- lib/monkey/patch/array/from.rb
+- lib/monkey/patch/array/to.rb
+- lib/monkey/patch/object/blank.rb
+- lib/monkey/patch/object/metaclass.rb
+- lib/monkey/patch/object/returning.rb
+- lib/monkey/patch/object/try.rb
+- lib/monkey/patches.rb
 has_rdoc: true
 homepage: http://github.com/stouset/monkey-patches
 licenses: []
 
 post_install_message: 
 rdoc_options: 
-- --charset=UTF-8
+- --main
+- README.rdoc
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
       version: "0"
-  version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
       version: "0"
-  version: 
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.5
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
-summary: A set of monkeypatches for the monkey gem
-test_files: 
-- test/helper.rb
-- test/test_monkey-patches.rb
+summary: Monkeypatches build on the monkey extension framework
+test_files: []
+

data/.document

@@ -1,5 +0,0 @@
-README.rdoc
-lib/**/*.rb
-bin/*
-features/**/*.feature
-LICENSE

data/.gitignore

@@ -1,21 +0,0 @@
-## MAC OS
-.DS_Store
-
-## TEXTMATE
-*.tmproj
-tmtags
-
-## EMACS
-*~
-\#*
-.\#*
-
-## VIM
-*.swp
-
-## PROJECT::GENERAL
-coverage
-rdoc
-pkg
-
-## PROJECT::SPECIFIC

data/test/helper.rb

@@ -1,10 +0,0 @@
-require 'rubygems'
-require 'test/unit'
-require 'shoulda'
-
-$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
-$LOAD_PATH.unshift(File.dirname(__FILE__))
-require 'monkey-patches'
-
-class Test::Unit::TestCase
-end

data/test/test_monkey-patches.rb

@@ -1,7 +0,0 @@
-require 'helper'
-
-class TestMonkeyPatches < Test::Unit::TestCase
-  should "probably rename this file and start testing for real" do
-    flunk "hey buddy, you should probably rename this file and start testing for real"
-  end
-end