hobosupport 0.1 → 0.2

data/lib/hobosupport/enumerable.rb

@@ -82,11 +82,11 @@ end
 class Object
 
   def in?(enum)
-    enum.include?(self)
+    !enum.nil? && enum.include?(self)
   end
 
   def not_in?(enum)
-    not enum.include?(self)
+    enum.nil? || !enum.include?(self)
   end
   
 end

data/lib/hobosupport/hash.rb

@@ -55,6 +55,17 @@ class Hash
     args.map {|a| self[a] }
   end
   
+  def compact
+    res = {}
+    each { |k, v| res[k] = v unless v.nil? }
+    res
+  end
+  
+  def compact!
+    keys.each { |k| delete(k) if self[k].nil? }
+  end
+  
+  
 end
 
 

data/lib/hobosupport/methodcall.rb

@@ -7,6 +7,7 @@
 
 require 'delegate'
 require 'singleton'
+require 'blankslate'
 
 class Object
 
@@ -52,8 +53,12 @@ end
 
 class CallIfAvailable < BlankSlate
   
+  def initialize(target)
+    @target = target
+  end
+  
   def method_missing(name, *args, &b)
-    @me.send(name, *args, &b) if @me.respond_to?(name)
+    @target.send(name, *args, &b) if @target.respond_to?(name)
   end
   
 end

data/lib/hobosupport/methodphitamine.rb

@@ -1,5 +1,7 @@
 # From: http://jicksta.com/articles/2007/08/04/the-methodphitamine
 
+require 'blankslate'
+
 module Kernel
 
   def it() It.new end

data/lib/hobosupport/module.rb

@@ -14,12 +14,18 @@ class Module
     end
   end
   
-  # An attr_accessor for classes that will delegate to the superclass
+  # Creates a class attribute reader that will delegate to the superclass
   # if not defined on self
-  def inheriting_attr_reader(*names)
-    for name in names
+  def inheriting_cattr_reader(*names)
+    names_with_defaults = (names.pop if names.last.is_a?(Hash)) || {}
+    
+    names_with_defaults.each do |name, default|
+      instance_variable_set("@#{name}", default) unless instance_variable_get("@#{name}") != nil || superclass.respond_to?(name)
+    end
+    
+    (names + names_with_defaults.keys).each do |name|
       class_eval %{
-        def #{name}
+        def self.#{name}
           if defined? @#{name}
             @#{name}
           elsif superclass.respond_to?('#{name}')
@@ -33,7 +39,8 @@ class Module
   # creates a #foo= and #foo? pair, with optional default values, e.g.
   # bool_attr_accessor :happy => true
   def bool_attr_accessor(*args)
-    options = args.extract_options!
+    options = (args.pop if args.last.is_a?(Hash)) || {}
+    
     (args + options.keys).each {|n| class_eval "def #{n}=(x); @#{n} = x; end" }
     
     args.each {|n| class_eval "def #{n}?; @#{n}; end" }
@@ -49,6 +56,12 @@ class Module
       set_field_type(n => TrueClass) if respond_to?(:set_field_type)
     end
   end
+  
+  def alias_class_method_chain(method, feature)
+    meta_eval do
+      alias_method_chain method, feature
+    end
+  end
 
 end
 
@@ -62,6 +75,7 @@ module Kernel
     m.meta_def :included do |base|
       base.class_eval &b
     end
+    m
   end
   
 end

data/lib/hobosupport.rb

@@ -1,3 +1,5 @@
+require 'activesupport'
+
 require "hobosupport/fixes"
 require 'hobosupport/blankslate'
 require 'hobosupport/methodcall'
@@ -11,7 +13,7 @@ require 'hobosupport/module'
 
 module HoboSupport
   
-  VERSION = "0.1"
+  VERSION = "0.2"
   
 end
 
@@ -27,15 +29,3 @@ class Object
   end
   
 end
-
-
-# --- Rails extensions --- #
-
-# Nice tip from Jamis Buck
-if defined? ActiveRecord
-  class << ActiveRecord::Base
-    alias_method :[], :find
-  end
-end
-
-

data/test/hobosupport/enumerable.rdoctest

@@ -110,6 +110,11 @@ Shorthand for `enum.include?(obj)`
     >> 300.in?(0..10)
     => false
 
+`in?` treats nil as an empty enumeration:
+
+    >> 3.in?(nil)
+    => false
+
 ## Object#not_in?
 
 * `obj.not_in?(enum)`
@@ -118,3 +123,8 @@ Shorthand for `enum.include?(obj)`
     => false
     >> 300.not_in?(0..10)
     => true
+
+`not_in?` treats nil as an empty enumeration:
+
+    >> 3.not_in?(nil)
+    => true

data/test/hobosupport/hash.rdoctest

@@ -100,4 +100,25 @@ Returns an array of values for the given keys. Useful for extracting a few optio
     >> {1=>2, 3=>4, 6=>5}.get(1, 3)
     => [2, 4]
     
+## Hash#compact
+
+* `hash.compact => hash`
+
+Returns a hash with the same items as the receiver except those where the value is nil
+
+    >> {1=>'a', 2=>nil, 3=>'b'}.compact
+    => {1=>'a', 3=>'b'}
+    
+## Hash#compact
+
+* `hash.compact!`
+
+Removes every pair from the hash where the value is nil
+
+    >> h = {1=>'a', 2=>nil, 3=>'b'}
+    >> h.compact!
+    >> h
+    => {1=>'a', 3=>'b'}
+    
+
 

data/test/hobosupport/module.rdoctest

@@ -42,31 +42,68 @@ When a module is included in a class, it gets a callback on the `included` metho
     => "MY NAME IS C"
     
     
-## Module#interiting_attr_accessor
+## Module#interiting_cattr_reader
 
-Only for use on classes. Like `attr_accessor`, but the attribute is looked up on the superclass if not defined on the receiving class. In other words, the superclass defines a default that subclasses can override.
+Declares a reader for an instance variable on the class. The attribute is looked up on the superclass if not defined on the receiving class. In other words, the superclass defines a default that subclasses can override. The declaration can also give a default, as shown here.
 
     >>
     class A
-      class << self
-        inheriting_attr_reader :name
-      end
-      @name = "Andy"
+      inheriting_cattr_reader :nickname => "Andy"
     end
     
     class B < A; end
     
-`B` has the same name as its superclass `A`
+`B` has the same nickname as its superclass `A`
     
-    >> A.name
+    >> A.nickname
     => "Andy"
-    >> B.name
+    >> B.nickname
     => "Andy"
     
-Now we change the name of `B`. `A` retains it's existing name.
+Now we change the nickname of `B`. `A` retains it's existing nickname.
     
-    >> class B; @name = "Bob"; end
-    >> B.name
+    >> class B; @nickname = "Bob"; end
+    >> B.nickname
     => "Bob"
-    >> A.name
+    >> A.nickname
     => "Andy"
+    
+    
+## Kernel#classy_module
+
+In Ruby we use modules to factor out features that are shared by more than one class. By including the module, a class gets the module's features, just as if they were defined inside the class. This mechanism is very simple if the shared features are all instance methods, but starts to get complicated when we want to share class-level features. For example, to create a module that adds class-methods to the including class, Ruby programmers often use the ClassMethods sub-module idiom:
+
+    >>
+    module M
+      def self.included(base)
+        base.send(:extend, ClassMethods)
+      end
+      
+      module ClassMethods
+        def foo; 123; end
+      end
+    end
+    
+    class C; include M; end
+    
+    >> C.foo
+    => 123
+    
+It's a shame that such a basic capability isn't more declarative.
+    
+`classy_module` provides a mechanism for creating a module that, when included, will `class_eval` it's entire body (the block passed to `classy_module`). This means we can write shared class features exactly as we would write them if they were inside the class:
+
+    >> 
+    MyClassyModule = classy_module do
+    
+      def self.foo; 123; end
+      
+    end
+    
+    >> MyClassyModule.class
+    => Module
+    >> class C2; include MyClassyModule; end
+    >> C2.foo
+    => 123
+    
+    

metadata

@@ -1,33 +1,36 @@
 --- !ruby/object:Gem::Specification 
-rubygems_version: 0.9.4
-specification_version: 1
 name: hobosupport
 version: !ruby/object:Gem::Version 
-  version: "0.1"
-date: 2008-02-11 00:00:00 +00:00
-summary: Core Ruby extensions from the Hobo project
-require_paths: 
-- lib
-email: tom@tomlocke.com
-homepage: http://hobocentral.net/hobo-support
-rubyforge_project: hobo
-description: "== DESCRIPTION:  A mixed bag of core Ruby extenstion that have been extracted from the Hobo project.  == INSTALL:  * sudo gem install hobosupport"
-autorequire: 
-default_executable: 
-bindir: bin
-has_rdoc: true
-required_ruby_version: !ruby/object:Gem::Version::Requirement 
-  requirements: 
-  - - ">"
-    - !ruby/object:Gem::Version 
-      version: 0.0.0
-  version: 
+  version: "0.2"
 platform: ruby
-signing_key: 
-cert_chain: 
-post_install_message: 
 authors: 
 - Tom Locke
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-03-14 00:00:00 +00:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.5.0
+    version: 
+description: "== DESCRIPTION:  A mixed bag of core Ruby extenstion that have been extracted from the Hobo project.  == INSTALL:  * sudo gem install hobosupport"
+email: tom@tomlocke.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
 files: 
 - History.txt
 - Manifest.txt
@@ -54,28 +57,32 @@ files:
 - test/hobosupport/metaid.rdoctest
 - test/hobosupport/methodphitamine.rdoctest
 - test/hobosupport/module.rdoctest
-test_files: []
-
+has_rdoc: true
+homepage: http://hobocentral.net/hobo-support
+post_install_message: 
 rdoc_options: 
 - --main
 - README.txt
-extra_rdoc_files: 
-- History.txt
-- Manifest.txt
-- README.txt
-executables: []
-
-extensions: []
-
+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: []
 
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: hoe
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Version::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 1.5.0
-    version: 
+rubyforge_project: hobo
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: Core Ruby extensions from the Hobo project
+test_files: []
+