hobosupport 0.9.103 → 0.9.104

data/Rakefile

@@ -3,16 +3,17 @@ ActiveRecord::ActiveRecordError # hack for https://rails.lighthouseapp.com/proje
 require File.dirname(__FILE__) + '/lib/hobo_support.rb'
 
 RUBY = File.join(Config::CONFIG['bindir'], Config::CONFIG['ruby_install_name']).sub(/.*\s.*/m, '"\&"')
-RUBYDOCTEST = ENV['RUBYDOCTEST'] || "#{RUBY} `which rubydoctest`"
+RUBYDOCTEST = ENV['RUBYDOCTEST'] || "#{RUBY} -S rubydoctest"
 
 namespace "test" do
   desc "Run the doctests"
   task :doctest do |t|
-    exit(1) if !system("#{RUBYDOCTEST} test/*.rdoctest test/hobosupport/*.rdoctest")
+    files=Dir['test/*.rdoctest','test/hobosupport/*.rdoctest'].map {|f| File.expand_path(f)}.join(' ')
+    exit(1) if !system("#{RUBYDOCTEST} --single #{files}")
   end
 end
 
-# --- build gem via Jeweller --- #
+# --- build gem via Jeweler --- #
 
 require 'jeweler'
 Jeweler::Tasks.new do |gemspec|

data/lib/hobo_support/methodcall.rb

@@ -1,9 +1,9 @@
 # The dot operator calls methods on objects. Power Dots are dots with extra features
 #
-#   .? calls a method if the reciever is not nil, returns nil
+#   .? calls a method if the receiver is not nil, returns nil
 #   otherwise. We have to write it ._?. in order to be valid Ruby
 #
-#   .try. calls a mehod only if the recipient resonds to that method
+#   .try. calls a method only if the recipient responds to that method
 
 require 'delegate'
 require 'singleton'
@@ -56,30 +56,13 @@ end
 class SafeNil
   include Singleton
 
-  DONT_REDEFINE_METHODS = "__id__", "__send__", "object_id"
-
-  NIL_RESPONSE_METHODS = ["to_s", "to_json", "to_yaml", "__id__", "__is_a__", "__metaclass__", "__send__"]
-
-  (NIL_RESPONSE_METHODS - DONT_REDEFINE_METHODS).each do |method|
-    # can't use define_method with a block
-    eval "
-      def #{method}(*args, &b)
-        nil.send(:#{method}, *args, &b)
-      end"
-  end
-
-  (instance_methods.map{|m| m.to_s} - NIL_RESPONSE_METHODS - DONT_REDEFINE_METHODS).each do |method|
-    # can't use define_method with a block
-    eval "
-      def #{method}(*args, &b)
-        nil
-      end"
+  begin
+    old_verbose, $VERBOSE = $VERBOSE, nil   # just like Rails silence_warnings: suppress "warning: undefining `object_id' may cause serious problem"
+    instance_methods.each { |m| undef_method m unless m[0,2] == '__' }
+  ensure
+    $VERBOSE = old_verbose
   end
 
-  def to_s
-    ""
-  end  
-
   def method_missing(method, *args, &b)
     return nil
   end
@@ -120,4 +103,15 @@ module ActiveRecord
       end
     end
   end
+
+  module NamedScope
+    class Scope
+      # we need to make sure we don't trigger AssociationCollections' method_missing
+      def try(*args, &block)
+        HoboSupport.hobo_try(self, *args, &block)
+      end
+    end
+  end
+
 end
+

data/lib/hobo_support.rb

@@ -1,6 +1,6 @@
 module HoboSupport
 
-  VERSION = "0.9.103"
+  VERSION = "0.9.104"
 
   RAILS_VERSION_FLOAT = Object.const_defined?(:Rails) ? Rails::VERSION::STRING.match(/^\d+\.\d+/)[0].to_f : 0
   
@@ -28,7 +28,7 @@ class String
   def safe_constantize
     Object.class_eval self
   rescue NameError => e
-    # Unforunately we have to rely on the error message to figure out which constant was missing.
+    # Unfortunately we have to rely on the error message to figure out which constant was missing.
     # NameError has a #name method but it is always nil
     if e.message !~ /\b#{self}$/
       # oops - some other name error

data/test/hobosupport.rdoctest

@@ -8,7 +8,7 @@ HoboSupport is a mixed bag of core ruby extensions that have been extracted from
 {.hidden}
 
     >> HoboSupport::VERSION
-    => "0.9.103"
+    => "0.9.104"
 
 ## Contents
 
@@ -38,21 +38,26 @@ We have the "." operator to call methods on objects. These extensions introduce
 
 ### `Object#_?`
 
-"`._?.`" only calls the method if the receiver is not `nil`.  Otherwise it returns nil.
+"`._?.`" only calls the method if the receiver is not `nil`.  Otherwise it returns nil.  So `x._?.method(*args)` is equivalent to `(nil == x ? nil : x.method(*args))`.
 
     >> "foo"._?.length
     => 3
     >> nil._?.length
     => nil
 
-`to_s`, `to_yaml` and `to_json` and a few system functions that start with an underscore are the only exceptions -- they call their corresponding functions on nil.
+When the receiver is nil, any method with any arguments will return nil.  You can use Ruby's || idiom to provide a different value when nil.
 
-    >> nil._?.to_s
-    => ""
+    >> expires = nil
+    >> expires._?.to_s( :default ) || "never"
+    => "never"
+
+Note that `_?` should *always* be followed by a method call.  It is not intended to store the intermediate result.  Don't do this!
+
+intermediate = nil._?
 
 ### `Object#try`
 
-"`.try`" only calls the method if the receiver responds to that method.
+"`.try`" only calls the method if the receiver responds to that method.  Otherwise it returns nil.  So `x.try.method(*args)` is equivalent to `(x.respond_to?(:method) ? x.method(*args) : nil)`.
 
     >> "foo".try.reverse
     => "oof"
@@ -61,10 +66,10 @@ We have the "." operator to call methods on objects. These extensions introduce
 
 ### What's the difference?
 
-`_?` is generally used when nil is an expected response.  `try` is
-generally used when interfaces may be different.  For instance, you
+Use `_?` when you want to call a method but you know the receiver may be nil.
+Use `try` when you want to call a method but you know the receiver may not respond to it.  For instance, you
 may use `try` to call a Rails 2.3 function that doesn't exist on Rails
-2.2.  nil responds to some functions that may surprise you.
+2.2.  Note that nil responds to some functions that may surprise you.
 
     >> nil.try.to_i
     => 0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: hobosupport
 version: !ruby/object:Gem::Version 
-  version: 0.9.103
+  version: 0.9.104
 platform: ruby
 authors: 
 - Tom Locke
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-12-10 00:00:00 -05:00
+date: 2010-01-21 00:00:00 -05:00
 default_executable: 
 dependencies: []