hobosupport 0.8.5 → 0.8.6

data/Rakefile

@@ -1,5 +1,12 @@
 require 'echoe'
 
+namespace "test" do
+  desc "Run the doctests"
+  task :doctest do |t|
+    exit(1) if !system("rubydoctest test/*.rdoctest test/hobosupport/*.rdoctest")
+  end
+end
+
 Echoe.new('hobosupport') do |p|
   p.author  = "Tom Locke"
   p.email   = "tom@tomlocke.com"
@@ -8,7 +15,7 @@ Echoe.new('hobosupport') do |p|
   p.project = "hobo"
   
   p.changelog = "CHANGES.txt"
-  p.version   = "0.8.5"
+  p.version   = "0.8.6"
   
   p.development_dependencies = []
 end

data/hobosupport.gemspec

@@ -1,103 +1,31 @@
+# -*- encoding: utf-8 -*-
 
-# Gem::Specification for Hobosupport-0.8.5
-# Originally generated by Echoe
+Gem::Specification.new do |s|
+  s.name = %q{hobosupport}
+  s.version = "0.8.6"
 
---- !ruby/object:Gem::Specification 
-name: hobosupport
-version: !ruby/object:Gem::Version 
-  version: 0.8.5
-platform: ruby
-authors: 
-- Tom Locke
-autorequire: 
-bindir: bin
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Tom Locke"]
+  s.date = %q{2009-05-14}
+  s.description = %q{Core Ruby extensions from the Hobo project}
+  s.email = %q{tom@tomlocke.com}
+  s.extra_rdoc_files = ["lib/hobo_support/array.rb", "lib/hobo_support/blankslate.rb", "lib/hobo_support/enumerable.rb", "lib/hobo_support/fixes/chronic.rb", "lib/hobo_support/fixes/module.rb", "lib/hobo_support/fixes/pp.rb", "lib/hobo_support/fixes.rb", "lib/hobo_support/hash.rb", "lib/hobo_support/implies.rb", "lib/hobo_support/metaid.rb", "lib/hobo_support/methodcall.rb", "lib/hobo_support/methodphitamine.rb", "lib/hobo_support/module.rb", "lib/hobo_support/string.rb", "lib/hobo_support.rb", "lib/hobosupport.rb", "README.txt"]
+  s.files = ["CHANGES.txt", "lib/hobo_support/array.rb", "lib/hobo_support/blankslate.rb", "lib/hobo_support/enumerable.rb", "lib/hobo_support/fixes/chronic.rb", "lib/hobo_support/fixes/module.rb", "lib/hobo_support/fixes/pp.rb", "lib/hobo_support/fixes.rb", "lib/hobo_support/hash.rb", "lib/hobo_support/implies.rb", "lib/hobo_support/metaid.rb", "lib/hobo_support/methodcall.rb", "lib/hobo_support/methodphitamine.rb", "lib/hobo_support/module.rb", "lib/hobo_support/string.rb", "lib/hobo_support.rb", "lib/hobosupport.rb", "Manifest", "Manifest.txt", "Rakefile", "README.txt", "test/hobosupport/enumerable.rdoctest", "test/hobosupport/hash.rdoctest", "test/hobosupport/implies.rdoctest", "test/hobosupport/metaid.rdoctest", "test/hobosupport/methodphitamine.rdoctest", "test/hobosupport/module.rdoctest", "test/hobosupport.rdoctest", "hobosupport.gemspec"]
+  s.has_rdoc = true
+  s.homepage = %q{http://hobocentral.net/hobosupport}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Hobosupport", "--main", "README.txt"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{hobo}
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{Core Ruby extensions from the Hobo project}
 
-date: 2008-12-09 00:00:00 +00:00
-default_executable: 
-dependencies: []
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
 
-description: Core Ruby extensions from the Hobo project
-email: tom@tomlocke.com
-executables: []
-
-extensions: []
-
-extra_rdoc_files: 
-- lib/hobo_support/array.rb
-- lib/hobo_support/blankslate.rb
-- lib/hobo_support/enumerable.rb
-- lib/hobo_support/fixes/chronic.rb
-- lib/hobo_support/fixes/module.rb
-- lib/hobo_support/fixes/pp.rb
-- lib/hobo_support/fixes.rb
-- lib/hobo_support/hash.rb
-- lib/hobo_support/implies.rb
-- lib/hobo_support/metaid.rb
-- lib/hobo_support/methodcall.rb
-- lib/hobo_support/methodphitamine.rb
-- lib/hobo_support/module.rb
-- lib/hobo_support/string.rb
-- lib/hobo_support.rb
-- lib/hobosupport.rb
-- README.txt
-files: 
-- CHANGES.txt
-- lib/hobo_support/array.rb
-- lib/hobo_support/blankslate.rb
-- lib/hobo_support/enumerable.rb
-- lib/hobo_support/fixes/chronic.rb
-- lib/hobo_support/fixes/module.rb
-- lib/hobo_support/fixes/pp.rb
-- lib/hobo_support/fixes.rb
-- lib/hobo_support/hash.rb
-- lib/hobo_support/implies.rb
-- lib/hobo_support/metaid.rb
-- lib/hobo_support/methodcall.rb
-- lib/hobo_support/methodphitamine.rb
-- lib/hobo_support/module.rb
-- lib/hobo_support/string.rb
-- lib/hobo_support.rb
-- lib/hobosupport.rb
-- Manifest
-- Manifest.txt
-- Rakefile
-- README.txt
-- test/hobosupport/enumerable.rdoctest
-- test/hobosupport/hash.rdoctest
-- test/hobosupport/implies.rdoctest
-- test/hobosupport/metaid.rdoctest
-- test/hobosupport/methodphitamine.rdoctest
-- test/hobosupport/module.rdoctest
-- test/hobosupport.rdoctest
-- hobosupport.gemspec
-has_rdoc: true
-homepage: http://hobocentral.net/hobosupport
-post_install_message: 
-rdoc_options: 
-- --line-numbers
-- --inline-source
-- --title
-- Hobosupport
-- --main
-- README.txt
-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: "1.2"
-  version: 
-requirements: []
-
-rubyforge_project: hobo
-rubygems_version: 1.3.1
-specification_version: 2
-summary: Core Ruby extensions from the Hobo project
-test_files: []
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/lib/hobo_support/methodcall.rb

@@ -9,14 +9,26 @@ require 'delegate'
 require 'singleton'
 require 'blankslate'
 
+module HoboSupport
+  def self.hobo_try(this, *args, &block)
+    if args.length==0
+      # Hobo style try
+      CallIfAvailable.new(this)
+    else
+      # activesupport 2.3 style try
+      this.send(*args, &block)
+    end
+  end
+end
+
 class Object
 
   def _?()
     self
   end
 
-  def try
-    CallIfAvailable.new(self)
+  def try(*args, &block)
+    HoboSupport.hobo_try(self, *args, &block)
   end
 
 end
@@ -26,6 +38,18 @@ class NilClass
   def _?()
     SafeNil.instance
   end
+
+  
+  def try(*args)
+    if args.length==0
+      # Hobo style try
+      CallIfAvailable.new(self)
+    else
+      # activesupport 2.3 style try
+      nil
+    end
+  end
+  
 end
 
 
@@ -63,4 +87,14 @@ class CallIfAvailable < BlankSlate
 
 end
 
+module ActiveRecord
+  module Associations
+    class AssociationProxy
 
+      # 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,18 +1,16 @@
 module HoboSupport
 
-  VERSION = "0.8.5"
+  VERSION = "0.8.6"
 
 end
 
 
-# Some teeny fixes too diminutive to go elsewhere
+# Some teeny bit and bobs too diminutive to go elsewhere
 
 class Object
 
-  # Often nice to ask e.g. some_object.is_a?(Symbol, String)
-  alias_method :is_a_without_multiple_args?, :is_a?
-  def is_a?(*args)
-    args.any? {|a| is_a_without_multiple_args?(a) }
+  def is_one_of?(*args)
+    args.any? {|a| is_a?(a) }
   end
 
 end
@@ -53,4 +51,4 @@ module Kernel
     args.first
   end
 
-end
+end

data/test/hobosupport/enumerable.rdoctest

@@ -1,6 +1,6 @@
 # HoboSupport - Eumerable extensions
 
-    >> require 'hobosupport'
+    doctest_require: '../../lib/hobosupport'
 
 ## `Enumerable#map_and_find`
 
@@ -117,6 +117,8 @@ Shorthand for `enum.include?(obj)`
 
 * `obj.not_in?(enum)`
 
+Negation of `in?`
+
     >> 3.not_in?(0..10)
     => false
     >> 300.not_in?(0..10)

data/test/hobosupport/hash.rdoctest

@@ -1,6 +1,7 @@
 # HoboSupport - Hash extensions
 
-    >> require 'hobosupport'
+    doctest_require: '../../lib/hobosupport'
+{.hidden}
 
 ## `Hash#select_hash`
 

data/test/hobosupport/implies.rdoctest

@@ -1,6 +1,7 @@
 # HoboSupport - implies
 
-    >> require 'hobosupport'
+    doctest_require: '../../lib/hobosupport'
+{.hidden}
 
 The implies operator comes from Eiffel. Often comes in handy in Hobo's model-permission methods.
 

data/test/hobosupport/metaid.rdoctest

@@ -1,6 +1,7 @@
 # HoboSupport - Metaid
 
-    >> require 'hobosupport'
+    doctest_require: '../../lib/hobosupport'
+{.hidden}
 
 Why the Luck Stiff's essential meta-programming additions to Object. These are probably distributed elsewhere, but they're small enough to throw them in to HoboSupport and remove an external dependency.
 

data/test/hobosupport/methodphitamine.rdoctest

@@ -1,6 +1,7 @@
 # HoboSupport - Methodphitamine
 
-    >> require 'hobosupport'
+    doctest_require: '../../lib/hobosupport'
+{.hidden}
 
 ## `Kernel#it` and `Kernel#its`
 

data/test/hobosupport/module.rdoctest

@@ -1,6 +1,7 @@
 # HoboSupport - Module extensions
 
-    >> require 'hobosupport'
+    doctest_require: '../../lib/hobosupport'
+{.hidden}
 
 ## `Module#included_in_class_callbacks`
 
@@ -13,30 +14,30 @@ When a module is included in a class, it gets a callback on the `included` metho
 (Note we're using the metaid extensions here too)
 
     >>
-    module M2
-      def self.included_in_class(klass)
-        klass.metaclass_eval do
-          def name_with_shouting; name_without_shouting.upcase; end
-          alias_method_chain :name, :shouting
-        end
-      end
-    end
-
-    module M1
-      def self.included(base)
-        included_in_class_callbacks(base)
-      end
-      include M2
-    end
-
-    class C
-      def self.name
-        "my name is C"
-      end
-      include M1
-    end
-
-    C.name
+     module M2
+       def self.included_in_class(klass)
+         klass.metaclass_eval do
+           def name_with_shouting; name_without_shouting.upcase; end
+           alias_method_chain :name, :shouting
+         end
+       end
+     end 
+
+     module M1
+       def self.included(base)
+         included_in_class_callbacks(base)
+       end
+       include M2
+     end
+
+     class C
+       def self.name
+         "my name is C"
+       end
+       include M1
+     end
+
+     C.name
     => "MY NAME IS C"
 
 
@@ -45,11 +46,11 @@ When a module is included in a class, it gets a callback on the `included` metho
 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
-      inheriting_cattr_reader :nickname => "Andy"
-    end
+     class A
+       inheriting_cattr_reader :nickname => "Andy"
+     end
 
-    class B < A; end
+     class B < A; end
 
 `B` has the same nickname as its superclass `A`
 
@@ -72,17 +73,17 @@ Now we change the nickname of `B`. `A` retains it's existing nickname.
 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 M
+       def self.included(base)
+         base.send(:extend, ClassMethods)
+       end 
 
-      module ClassMethods
-        def foo; 123; end
-      end
-    end
+       module ClassMethods
+         def foo; 123; end
+       end
+     end
 
-    class C; include M; end
+     class C; include M; end
 
     >> C.foo
     => 123
@@ -92,11 +93,11 @@ 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
+     MyClassyModule = classy_module do
 
-      def self.foo; 123; end
+       def self.foo; 123; end
 
-    end
+     end
 
     >> MyClassyModule.class
     => Module

data/test/hobosupport.rdoctest

@@ -4,40 +4,34 @@ HoboSupport is a mixed bag of core ruby extensions that have been extracted from
 
 [Hobo]: http://hobocentral.net
 
-    >> require 'hobosupport'
+    doctest_require: '../lib/hobosupport'
+{.hidden}
+
     >> HoboSupport::VERSION
-    => "0.7.5"
+    => "0.8.6"
 
 ## Contents
 
- * [Enumerable](/hobosupport/hobosupport/enumerable/)
- * [Hash](/hobosupport/hobosupport/hash/)
- * [Implies](/hobosupport/hobosupport/implies/)
- * [Metaid](/hobosupport/hobosupport/metaid/)
- * [Methodphitamine](/hobosupport/hobosupport/methodphitamine)
- * [Module](/hobosupport/hobosupport/module)
+ * [Enumerable](/manual/hobosupport/enumerable)
+ * [Hash](/manual/hobosupport/hash)
+ * [Implies](/manual/hobosupport/implies)
+ * [Metaid](/manual/hobosupport/metaid)
+ * [Methodphitamine](/manual/hobosupport/methodphitamine)
+ * [Module](/manual/hobosupport/module)
 
 ## Object extensions
 
-### `Object#is_a?`
+### `Object#is_one_of?`
 
-Extended to allow multiple types to be checked in one go
+Like `is_a?` but multiple types to be checked in one go
 
-    >> "foo".is_a?(String, Symbol)
-    => true
-    >> :foo.is_a?(String, Symbol)
+    >> "foo".is_one_of?(String, Symbol)
     => true
-    >> 1.is_a?(String, Symbol)
-    => false
-
-Still works the old way
-
-    >> "foo".is_a?(String)
+    >> :foo.is_one_of?(String, Symbol)
     => true
-    >> :foo.is_a?(String)
+    >> 1.is_one_of?(String, Symbol)
     => false
 
-
 ## Method call extensions
 
 ### `Object#_?`

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: hobosupport
 version: !ruby/object:Gem::Version 
-  version: 0.8.5
+  version: 0.8.6
 platform: ruby
 authors: 
 - Tom Locke
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-12-09 00:00:00 +00:00
+date: 2009-05-14 00:00:00 +01:00
 default_executable: 
 dependencies: []