kitchensink 0.0.1 → 0.1.1

data/Manifest.txt

@@ -7,6 +7,12 @@ config/hoe.rb
 config/requirements.rb
 lib/kitchensink.rb
 lib/kitchensink/version.rb
+lib/kitchensink/patches/array.rb
+lib/kitchensink/patches/class.rb
+lib/kitchensink/patches/enumerable.rb
+lib/kitchensink/patches/hash.rb
+lib/kitchensink/patches/object.rb
+lib/kitchensink/patches/symbol.rb
 log/debug.log
 script/destroy
 script/generate

data/lib/kitchensink.rb

@@ -1,200 +1 @@
-$:.unshift File.dirname(__FILE__)
-
-unless Enumerable.method_defined? :rest
-  module Enumerable
-    # Returns all elements after the first.
-    def rest
-      self[1..-1]
-    end
-  end
-end
-
-unless Enumerable.method_defined? :rrest
-  module Enumerable
-    # Returns a new collection containing all elements except for the last
-    #--
-    # This has a very PHPesque name and needs a better one. (PHP has an idiom
-    # where array methods that work in one direction can be reversed by
-    # prepending r to them. See sort=>rsort, ksort=>krsort, and asort=>arsort.
-    # Problem is, what's a good word meaning "everything but the last"? I
-    # briefly toyed with "lizard" since it's the Enumeration "with the tail
-    # cut off" but that's not very intuitive to somebody looking at the method
-    # for the first time. I need a word that suggests to the reader what it
-    # means, and that with a little context the reader could determine the
-    # meaning correctly almost all every time.
-    def rrest
-      self[0..-2]
-    end
-  end
-end
-
-unless Array.method_defined? :sum
-  class Array
-    # Adds all elements of an array together:
-    # * [1,2,3].sum => 6
-    # * [1.0, 2.0, 3.0].sum => 6.0
-    # * %w{a b c}.sum => "abc"
-    # * [Vector[1,0,0], Vector[0,2,0], Vector[0,0,3]].sum => Vector[1,2,3]
-    def sum
-      inject {|sum,element| sum+element}
-    end
-  end
-end
-
-unless Array.method_defined? :product
-  class Array
-    # Multiplies all elements of an array together:
-    # * [2,3,4].product => 24
-    # * [2.0, 3.0, 4.0].product => 24.0
-    # * ["NO", 3, 2].product => "NONONONONONO"
-    def product
-      inject {|product,element| product*element}
-    end
-  end
-end
-
-unless Array.method_defined? :hash_by
-  class Array
-    # Construct a hash of objects, keyed by some object attribute.
-    # 
-    # Original idea and code by Brian Dainton. Taken from his blog, The Budding Rubyist.
-    # http://buddingrubyist.wordpress.com/2008/02/05/why-i-like-to-inject/
-    def hash_by(attribute)
-      inject({}) do |results, obj|
-        results[obj.send(attribute)] = obj
-        results
-      end
-    end
-  end
-end
-
- 
-unless Object.respond_to? :class_method
-  class Object
-    # Returns an +UnboundMethod+ representing a given class method in a class.
-    # 
-    # See Also: instance_method
-    #
-    # Examples:
-    #   sc = String.class_method(:superclass)
-    #   sc.bind(String).call()
-    #   => Object
-    #--
-    # Note that here we use the "class << self; self; end.send" trick, which
-    # gives us access to the singleton class rather than the class itself.
-    # Setting instance methods here causes the subclass to receive class
-    # methods. Yay!
-    def self.class_method(name)
-      class << self; self; end.send :instance_method, name
-    end
-  end
-end
-
-unless Object.respond_to? :remove_class_method
-  class Object
-    # Removes a class method.
-    def self.remove_class_method(name)
-      class << self; self; end.send :remove_method, name
-    end
-  end
-end
-
-unless Object.respond_to? :define_class_method
-  class Object
-    # Works like define_method, only creates a class method.
-    # * <tt>define_class_method(symbol, method)</tt> => new_method
-    # * <tt>define_class_method(symbol) {block}</tt> => proc
-    #
-    # Examples:
-    #   String.define_class_method :get_parent_class, String.class_method(:superclass)
-    #   String.define_class_method :make_runon do |str, num|
-    #     String.new(str) * num
-    #   end
-    #   String.make_runon "abc", 3
-    #   => "abcabcabc"
-    def self.define_class_method(name, method=nil, &block)
-      if method
-        class << self; self; end.send :define_method, name, method
-      else
-        class << self; self; end.send :define_method, name, &block
-      end
-    end
-  end
-end
-
-unless Object.method_defined? :included_in?
-  class Object
-    # True if a collection includes this object.
-    #    
-    # Note: I wrote this because
-    # sometimes <tt>collection.include?(object)</tt> violates left-to-right reading
-    # order, such as when +object+ is more important than the +collection+.
-    def included_in?(collection)
-      collection.include? self
-    end
-  end
-end
-
-unless Symbol.method_defined? :to_proc
-  class Symbol
-    # Convert a Symbol to proc.
-    # 
-    # This is already in Ruby CVS, and should appear in Ruby 1.9
-    def to_proc
-      Proc.new { |obj, *args| obj.send(self, *args) }
-    end
-  end
-end
-
-unless Hash.method_defined? :except
-  class Hash
-    # Filter keys out of a Hash.
-    #
-    #  >> {:a=>1, :b=>2, :c=>3}.except(:a)
-    #  => {:b=>2, :c=>3}
-    #
-    # Source:
-    # * http://wincent.com/knowledge-base/Fixtures_considered_harmful%3F
-    # * Neil Rahilly
-    # * Peepcode episode 11. Geoffrey Grosenbach alludes to this being a
-    #   common idiom among rSpec coders.
-    def except(*keys)
-      self.reject { |k,v| keys.include?(k || k.to_sym) }
-    end
-  end
-end
-
-unless Hash.method_defined? :only
-  class Hash
-    # Returns a hash with only the pairs identified by +keys+
-    #
-    # Source:
-    # * http://wincent.com/knowledge-base/Fixtures_considered_harmful%3F
-    # * Neil Rahilly
-    # * Peepcode episode 11. Geoffrey Grosenbach alludes to this being a
-    #   common idiom among rSpec coders.
-    def only(*keys)
-      self.reject { |k,v| !keys.include?(k || k.to_sym) }
-    end
-  end
-end
-
-unless Hash.method_defined? :with
-  class Hash
-    # Merge keys into a Hash.
-    #
-    #  >> {:a=>1, :b=>2, :c=>3}.with({:a=>4,:b=>5})
-    #  => {:a=>4, :b=>5, :c=>3}
-    #
-    # Source:
-    # * http://wincent.com/knowledge-base/Fixtures_considered_harmful%3F
-    # * Neil Rahilly
-    # * Peepcode episode 11. Geoffrey Grosenbach alludes to this being a
-    #   common idiom among rSpec coders.
-    #
-    # Known Issue: This method conflicts with utility_belt's with statement.
-    def with(overrides = {})
-      self.merge overrides
-    end
-  end
-end
+Dir.glob(File.join(File.dirname(__FILE__), "kitchensink", "patches", "*.rb")).each {|f| require f}

data/lib/kitchensink/patches/array.rb

@@ -0,0 +1,39 @@
+unless Array.method_defined? :hash_by
+  class Array
+    # Construct a hash of objects, keyed by some object attribute.
+    # 
+    # Original idea and code by Brian Dainton. Taken from his blog, The Budding Rubyist.
+    # http://buddingrubyist.wordpress.com/2008/02/05/why-i-like-to-inject/
+    def hash_by(attribute)
+      inject({}) do |results, obj|
+        results[obj.send(attribute)] = obj
+        results
+      end
+    end
+  end
+end
+
+unless Array.method_defined? :product
+  class Array
+    # Multiplies all elements of an array together:
+    # * [2,3,4].product => 24
+    # * [2.0, 3.0, 4.0].product => 24.0
+    # * ["NO", 3, 2].product => "NONONONONONO"
+    def product
+      inject {|product,element| product*element}
+    end
+  end
+end
+
+unless Array.method_defined? :sum
+  class Array
+    # Adds all elements of an array together:
+    # * [1,2,3].sum => 6
+    # * [1.0, 2.0, 3.0].sum => 6.0
+    # * %w{a b c}.sum => "abc"
+    # * [Vector[1,0,0], Vector[0,2,0], Vector[0,0,3]].sum => Vector[1,2,3]
+    def sum
+      inject {|sum,element| sum+element}
+    end
+  end
+end

data/lib/kitchensink/patches/class.rb

@@ -0,0 +1,29 @@
+unless Class.respond_to? :descendants
+  class Class
+    # Return a list of all classes currently known to inherit from this class, directly or indirectly.
+    #
+    # NOTE that this only checks objects currently in memory. For instance, if you start a Rails console and check the descendants of ActiveRecord::Base, you'll only find those objects that have been dynamically loaded.
+    def descendants
+      dd = []
+      ObjectSpace::each_object(Class) do |c|
+        dd << c if c.ancestors.include?(self)
+      end
+      dd
+    end
+  end
+end
+
+unless Class.respond_to? :immediate_descendants
+  class Class
+    # Return a list of all classes currently known to directly inherit from this class.
+    #
+    # NOTE that this only checks objects currently in memory. For instance, if you start a Rails console and check the descendants of ActiveRecord::Base, you'll only find those objects that have been dynamically loaded.
+    def immediate_descendants
+      dd = []
+      ObjectSpace::each_object(Class) do |c|
+        dd << c if c.ancestors.size > 1 && c.ancestors[1] == self
+      end
+      dd
+    end
+  end
+end

data/lib/kitchensink/patches/enumerable.rb

@@ -0,0 +1,28 @@
+unless Enumerable.method_defined? :rest
+  module Enumerable
+    # Returns all elements after the first.
+    def rest
+      self[1..-1]
+    end
+  end
+end
+
+unless Enumerable.method_defined? :rrest
+  module Enumerable
+    # Returns a new collection containing all elements except for the last
+    #--
+    # This has a very PHPesque name and needs a better one. (PHP has an idiom
+    # where array methods that work in one direction can be reversed by
+    # prepending r to them. See sort=>rsort, ksort=>krsort, and asort=>arsort.
+    # Problem is, what's a good word meaning "everything but the last"? I
+    # briefly toyed with "lizard" since it's the Enumeration "with the tail
+    # cut off" but that's not very intuitive to somebody looking at the method
+    # for the first time. I need a word that suggests to the reader what it
+    # means, and that with a little context the reader could determine the
+    # meaning correctly almost all every time.
+    def rrest
+      self[0..-2]
+    end
+  end
+end
+

data/lib/kitchensink/patches/hash.rb

@@ -0,0 +1,53 @@
+unless Hash.method_defined? :except
+  class Hash
+    # Filter keys out of a Hash.
+    #
+    #  >> {:a=>1, :b=>2, :c=>3}.except(:a)
+    #  => {:b=>2, :c=>3}
+    #
+    # Source:
+    # * http://wincent.com/knowledge-base/Fixtures_considered_harmful%3F
+    # * Neil Rahilly
+    # * Peepcode episode 11. Geoffrey Grosenbach alludes to this being a
+    #   common idiom among rSpec coders.
+    def except(*keys)
+      self.reject { |k,v| keys.include?(k || k.to_sym) }
+    end
+  end
+end
+
+unless Hash.method_defined? :only
+  class Hash
+    # Returns a hash with only the pairs identified by +keys+
+    #
+    # Source:
+    # * http://wincent.com/knowledge-base/Fixtures_considered_harmful%3F
+    # * Neil Rahilly
+    # * Peepcode episode 11. Geoffrey Grosenbach alludes to this being a
+    #   common idiom among rSpec coders.
+    def only(*keys)
+      self.reject { |k,v| !keys.include?(k || k.to_sym) }
+    end
+  end
+end
+
+unless Hash.method_defined? :with
+  class Hash
+    # Merge keys into a Hash.
+    #
+    #  >> {:a=>1, :b=>2, :c=>3}.with({:a=>4,:b=>5})
+    #  => {:a=>4, :b=>5, :c=>3}
+    #
+    # Source:
+    # * http://wincent.com/knowledge-base/Fixtures_considered_harmful%3F
+    # * Neil Rahilly
+    # * Peepcode episode 11. Geoffrey Grosenbach alludes to this being a
+    #   common idiom among rSpec coders.
+    #
+    # Known Issue: This method conflicts with utility_belt's with statement.
+    def with(overrides = {})
+      self.merge overrides
+    end
+  end
+end
+

data/lib/kitchensink/patches/object.rb

@@ -0,0 +1,66 @@
+unless Object.respond_to? :class_method
+  class Object
+    # Returns an +UnboundMethod+ representing a given class method in a class.
+    # 
+    # See Also: instance_method
+    #
+    # Examples:
+    #   sc = String.class_method(:superclass)
+    #   sc.bind(String).call()
+    #   => Object
+    #--
+    # Note that here we use the "class << self; self; end.send" trick, which
+    # gives us access to the singleton class rather than the class itself.
+    # Setting instance methods here causes the subclass to receive class
+    # methods. Yay!
+    def self.class_method(name)
+      class << self; self; end.send :instance_method, name
+    end
+  end
+end
+
+unless Object.respond_to? :define_class_method
+  class Object
+    # Works like define_method, only creates a class method.
+    # * <tt>define_class_method(symbol, method)</tt> => new_method
+    # * <tt>define_class_method(symbol) {block}</tt> => proc
+    #
+    # Examples:
+    #   String.define_class_method :get_parent_class, String.class_method(:superclass)
+    #   String.define_class_method :make_runon do |str, num|
+    #     String.new(str) * num
+    #   end
+    #   String.make_runon "abc", 3
+    #   => "abcabcabc"
+    def self.define_class_method(name, method=nil, &block)
+      if method
+        class << self; self; end.send :define_method, name, method
+      else
+        class << self; self; end.send :define_method, name, &block
+      end
+    end
+  end
+end
+
+unless Object.method_defined? :included_in?
+  class Object
+    # True if a collection includes this object.
+    #    
+    # Note: I wrote this because
+    # sometimes <tt>collection.include?(object)</tt> violates left-to-right reading
+    # order, such as when +object+ is more important than the +collection+.
+    def included_in?(collection)
+      collection.include? self
+    end
+  end
+end
+
+unless Object.respond_to? :remove_class_method
+  class Object
+    # Removes a class method.
+    def self.remove_class_method(name)
+      class << self; self; end.send :remove_method, name
+    end
+  end
+end
+

data/lib/kitchensink/patches/symbol.rb

@@ -0,0 +1,11 @@
+unless Symbol.method_defined? :to_proc
+  class Symbol
+    # Convert a Symbol to proc.
+    # 
+    # This is already in Ruby CVS, and should appear in Ruby 1.9
+    def to_proc
+      Proc.new { |obj, *args| obj.send(self, *args) }
+    end
+  end
+end
+

data/lib/kitchensink/version.rb

@@ -1,7 +1,7 @@
 module Kitchensink #:nodoc:
   module VERSION #:nodoc:
     MAJOR = 0
-    MINOR = 0
+    MINOR = 1
     TINY  = 1
 
     STRING = [MAJOR, MINOR, TINY].join('.')

data/tasks/deployment.rake

@@ -31,4 +31,4 @@ namespace :manifest do
   task :refresh do
     `rake check_manifest | patch -p0 > Manifest.txt`
   end
-end
+end

data/website/index.html

@@ -1,11 +1,93 @@
-<html>
-	<head>
-		<meta http-equiv="Content-type" content="text/html; charset=utf-8">
-		<title>kitchensink</title>
-		
-	</head>
-	<body id="body">
-		<p>This page has not yet been created for RubyGem <code>kitchensink</code></p>
-		<p>To the developer: To generate it, update website/index.txt and run the rake task <code>website</code> to generate this <code>index.html</code> file.</p>
-	</body>
-</html>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <link rel="stylesheet" href="stylesheets/screen.css" type="text/css" media="screen" />
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+  <title>
+      kitchensink
+  </title>
+  <script src="javascripts/rounded_corners_lite.inc.js" type="text/javascript"></script>
+<style>
+
+</style>
+  <script type="text/javascript">
+    window.onload = function() {
+      settings = {
+          tl: { radius: 10 },
+          tr: { radius: 10 },
+          bl: { radius: 10 },
+          br: { radius: 10 },
+          antiAlias: true,
+          autoPad: true,
+          validTags: ["div"]
+      }
+      var versionBox = new curvyCorners(settings, document.getElementById("version"));
+      versionBox.applyCornersToAll();
+    }
+  </script>
+</head>
+<body>
+<div id="main">
+
+    <h1>kitchensink</h1>
+    <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/kitchensink"; return false'>
+      <p>Get Version</p>
+      <a href="http://rubyforge.org/projects/kitchensink" class="numbers">0.1.1</a>
+    </div>
+    <h1>&#x2192; &#8216;kitchensink&#8217;</h1>
+
+
+	<h2>What</h2>
+
+
+	<h2>Installing</h2>
+
+
+	<p><pre class='syntax'><span class="ident">sudo</span> <span class="ident">gem</span> <span class="ident">install</span> <span class="ident">kitchensink</span></pre></p>
+
+
+	<h2>The basics</h2>
+
+
+	<h2>Demonstration of usage</h2>
+
+
+	<h2>Forum</h2>
+
+
+	<p><a href="http://groups.google.com/group/kitchensink">http://groups.google.com/group/kitchensink</a></p>
+
+
+	<p><span class="caps">TODO</span> &#8211; create Google Group &#8211; kitchensink</p>
+
+
+	<h2>How to submit patches</h2>
+
+
+	<p>Read the <a href="http://drnicwilliams.com/2007/06/01/8-steps-for-fixing-other-peoples-code/">8 steps for fixing other people&#8217;s code</a> and for section <a href="http://drnicwilliams.com/2007/06/01/8-steps-for-fixing-other-peoples-code/#8b-google-groups">8b: Submit patch to Google Groups</a>, use the Google Group above.</p>
+
+
+	<p>The trunk repository is <code>svn://rubyforge.org/var/svn/kitchensink/trunk</code> for anonymous access.</p>
+
+
+	<h2>License</h2>
+
+
+	<p>This code is free to use under the terms of the <span class="caps">MIT</span> license.</p>
+
+
+	<h2>Contact</h2>
+
+
+	<p>Comments are welcome. Send an email to <a href="mailto:FIXME"><span class="caps">FIXME</span> full name</a> email via the <a href="http://groups.google.com/group/kitchensink">forum</a></p>
+    <p class="coda">
+      <a href="FIXME email">FIXME full name</a>, 1st March 2008<br>
+      Theme extended from <a href="http://rb2js.rubyforge.org/">Paul Battley</a>
+    </p>
+</div>
+
+<!-- insert site tracking codes here, like Google Urchin -->
+
+</body>
+</html>

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: kitchensink
 version: !ruby/object:Gem::Version 
-  version: 0.0.1
+  version: 0.1.1
 platform: ruby
 authors: 
 - FIXME full name
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-03-01 00:00:00 -07:00
+date: 2008-03-18 00:00:00 -06:00
 default_executable: 
 dependencies: []
 
@@ -36,6 +36,12 @@ files:
 - config/requirements.rb
 - lib/kitchensink.rb
 - lib/kitchensink/version.rb
+- lib/kitchensink/patches/array.rb
+- lib/kitchensink/patches/class.rb
+- lib/kitchensink/patches/enumerable.rb
+- lib/kitchensink/patches/hash.rb
+- lib/kitchensink/patches/object.rb
+- lib/kitchensink/patches/symbol.rb
 - log/debug.log
 - script/destroy
 - script/generate