facade 1.0.2 → 1.0.3

data/CHANGES

@@ -1,13 +1,20 @@
-== 1.0.2 - 11-Jun-2007
-* Added a Rakefile with tasks for installation and testing.
-* Removed the install.rb file. Installation is now handled as a Rake task.
-* Some test suite refactoring.
-* Fixed the FACADE_VERSION number (now 1.0.2, was 1.1.0).
-
-== 1.0.1 - 8-Jun-2005
-* Moved project to RubyForge.
-* Added a .gemspec file.
-* Added a MANIFEST.
-
-== 1.0.0 - 18-May-2005
-* Initial release
+== 1.0.3 - 21-Jul-2009
+* License changed to Artistic 2.0.
+* Documentation updates.
+* Test file renamed to test_facade.rb.
+* Some Rakefile and gemspec updates
+* One test modified so that it passes with 1.9.x as well.
+
+== 1.0.2 - 11-Jun-2007
+* Added a Rakefile with tasks for installation and testing.
+* Removed the install.rb file. Installation is now handled as a Rake task.
+* Some test suite refactoring.
+* Fixed the FACADE_VERSION number (now 1.0.2, was 1.1.0).
+
+== 1.0.1 - 8-Jun-2005
+* Moved project to RubyForge.
+* Added a .gemspec file.
+* Added a MANIFEST.
+
+== 1.0.0 - 18-May-2005
+* Initial release

data/MANIFEST

@@ -4,4 +4,4 @@
 * Rakefile
 * facade.gemspec
 * lib/facade.rb
-* test/tc_facade.rb
+* test/test_facade.rb

data/README

@@ -1,22 +1,23 @@
 == Synopsis
-   An easy way to implement the facade pattern in your classes.
+   An easy way to implement the facade pattern in your classes. In short,
+   this library wraps singleton methods from another class as instance
+   methods of the current class.
 
 == Prerequisites
    Ruby 1.8.0 or later
 
 == Installation
-   ruby test/tc_facade.rb (optional)
-   ruby install.rb
+   rake test
+   rake install (non-gem) or rake install_gem (gem)
    
 == Usage
-   require "facade"
-   class Foo < String
+   require 'facade'
+   class MyString < String
       extend Facade
       facade File, :dirname, :basename
-      facade Dir
    end
 
-   f = Foo.new("/home/djberge")
+   f = MyString.new('/home/djberge')
    puts f.basename # 'djberge'
    puts f.dirname  # '/home'
 
@@ -25,8 +26,11 @@
    shamelessly plagiarized.
 
 == Copyright
-   Copyright (c) 2005-2007 Daniel J. Berger
-   Licensed under the same terms as Ruby itself. 
+   Copyright (c) 2005-2009 Daniel J. Berger
+   Licensed under the same terms as Ruby itself.
+   
+== License
+   Artistic 2.0 
 
 == Warranty
    This package is provided "as is" and without any express or
@@ -36,4 +40,4 @@
 == Author
    Daniel J. Berger
    djberg96 at nospam at gmail dot com
-   imperator on IRC (freenode)
+   imperator on IRC (freenode)

data/Rakefile

@@ -3,13 +3,14 @@ require 'rake/testtask'
 require 'rbconfig'
 include Config
 
-desc 'Install the facade package (non-gem)'
+desc 'Install the facade library (non-gem)'
 task :install do
    sitelibdir = CONFIG["sitelibdir"]
    file = "lib/facade.rb"
    FileUtils.cp(file, sitelibdir, :verbose => true)
 end
 
+desc 'Install the facade library as a gem'
 task :install_gem do
    ruby 'facade.gemspec'
    file = Dir["*.gem"].first
@@ -20,5 +21,4 @@ Rake::TestTask.new do |t|
    t.libs << 'test'
    t.verbose = true
    t.warning = true
-   t.test_files = FileList['test/tc_facade.rb']
-end
+end

data/facade.gemspec

@@ -0,0 +1,26 @@
+require 'rubygems'
+
+spec = Gem::Specification.new do |gem|
+   gem.name      = 'facade'
+   gem.version   = '1.0.3'
+   gem.author    = 'Daniel J. Berger'
+   gem.license   = 'Artistic 2.0'
+   gem.email     = 'djberg96@gmail.com'
+   gem.homepage  = 'http://www.rubyforge.org/projects/shards'
+   gem.platform  = Gem::Platform::RUBY
+   gem.summary   = 'An easy way to implement the facade pattern in your class'
+   gem.test_file = 'test/test_facade.rb'
+   gem.has_rdoc  = true
+   gem.files     = Dir['**/*'].reject{ |f| f.include?('CVS') }
+
+   gem.rubyforge_project = 'shards'
+   gem.extra_rdoc_files  = ['README', 'CHANGES', 'MANIFEST']
+
+   gem.description = <<-EOF
+      The facade library allows you to mixin singleton methods from classes
+      or modules as instance methods of the extending class.
+   EOF
+end
+
+Gem.manage_gems if Gem::RubyGemsVersion.to_f < 1.0
+Gem::Builder.new(spec).build

data/lib/facade.rb

@@ -1,63 +1,52 @@
-# == Synopsis
-# An easy way to implement the facade pattern for your Ruby classes
-#
-# == Usage
-# require "facade"
-# class Foo < String
-#    extend Facade
-#    facade File, :dirname, :basename
-# end
-#
-# f = Foo.new("/home/djberge")
-# puts f.basename # 'djberge'
-# puts f.dirname  # '/home'
-#
-# == Author
-# Daniel J. Berger
-# djberg96 at yahoo dot com
-# imperator on IRC (freenode)
-#
-# == Copyright
-# Copyright (c) 2005 Daniel J. Berger
-# Licensed under the same terms as Ruby itself.
- 
 module Facade
-   FACADE_VERSION = '1.0.2'
+   FACADE_VERSION = '1.0.3'
 
-   # Forward a class or module method as an instance method of the
-   # including class.
+   # The facade method will forward a singleton method as an instance
+   # method of the extending class. If no arguments are provided, then all
+   # singleton methods of the class or module become instance methods.
    #
-   # call-seq:
-   #   forward +klass+, :method
-   #   forward +klass+, :method1, :method2, ...
+   # Existing instance methods are NOT overridden, but are instead ignored.
+   #
+   # Example:
+   #
+   # require 'facade'
    # 
-   # This will not override the class' existing methods.
+   # class MyString < String
+   #    extend Facade
+   #    facade File, :dirname, :basename
+   # end
+   #
+   # s = MyString.new('/home/djberge')
+   # s.basename # => 'djberge'
+   # s.dirname  # => '/home'
    #
    def facade(klass, *methods)
-      methods.flatten!
-      if methods.empty?                                # Default to all methods
+      methods = methods.flatten
+
+      if methods.empty? # Default to all methods
          if klass.kind_of?(Class)
             methods = klass.methods(false)
          else
             methods = klass.public_instance_methods(false)
          end
       end
-      methods.collect!{ |m| m.to_s }                   # Symbols or strings
-      methods -= self.instance_methods                 # No clobber
+
+      methods.collect!{ |m| m.to_s }   # Symbols or strings
+      methods -= self.instance_methods # No clobber
 
       methods.each do |methname|
          methname = methname.to_sym
-         define_method(methname){ ||
+         define_method(methname){
             if klass.kind_of?(Class)
                meth = klass.method(methname)
             else
                meth = Object.new.extend(klass).method(methname)
             end
 
-            if meth.arity.zero?                        # Zero or one argument
+            if meth.arity.zero? # Zero or one argument
                meth.call
             else
-               meth.call( self )
+               meth.call(self)
             end
          }
       end

data/test/test_facade.rb

@@ -0,0 +1,66 @@
+#########################################################################
+# test_facade.rb
+#
+# Test suite for the Facade module. This test suite should be run via
+# the 'rake test' task.
+#########################################################################
+require 'test/unit'
+require 'facade'
+
+module Baz
+   def testme(str)
+      str
+   end
+end
+
+class FooString < String
+   extend Facade
+   facade File, :basename, 'dirname'
+   facade Dir
+   facade Baz
+
+   def blockdev?
+      'test'
+   end
+end
+
+class TC_Facade < Test::Unit::TestCase
+   def setup
+      @str = FooString.new('/home/djberge')
+   end
+   
+   def test_facade_version
+      assert_equal('1.0.3', Facade::FACADE_VERSION)
+   end
+
+   def test_file_methods
+      assert_respond_to(@str, :basename)
+      assert_respond_to(@str, :dirname)
+      assert_raises(NoMethodError){ @str.executable? }
+      assert_raises(NoMethodError){ @str.chardev? }
+   end
+
+   def test_file_method_return_values
+      assert_equal('djberge', @str.basename)
+      assert_equal('/home', @str.dirname)
+   end
+
+   def test_dir_methods
+      assert_respond_to(@str, :pwd)
+      assert_respond_to(@str, :entries)
+   end
+   
+   def test_no_clobber
+      assert_respond_to(@str, :blockdev?)
+      assert_equal('test', @str.blockdev?)
+   end
+
+   def test_module_methods
+      assert_respond_to(@str, :testme)
+      assert_equal('/home/djberge', @str.testme)
+   end
+
+   def teardown
+      @str = nil
+   end
+end

metadata

@@ -1,53 +1,63 @@
 --- !ruby/object:Gem::Specification 
-rubygems_version: 0.9.4
-specification_version: 1
 name: facade
 version: !ruby/object:Gem::Version 
-  version: 1.0.2
-date: 2007-06-11 00:00:00 -06:00
-summary: An easy way to implement the facade pattern in your class
-require_paths: 
-- lib
-email: djberg96@gmail.com
-homepage: http://www.rubyforge.org/projects/shards
-rubyforge_project: 
-description: 
-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: 1.0.3
 platform: ruby
-signing_key: 
-cert_chain: 
-post_install_message: 
 authors: 
 - Daniel J. Berger
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-07-21 00:00:00 -06:00
+default_executable: 
+dependencies: []
+
+description: "      The facade library allows you to mixin singleton methods from classes\n      or modules as instance methods of the extending class.\n"
+email: djberg96@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+- CHANGES
+- MANIFEST
 files: 
-- lib/facade.rb
 - CHANGES
+- facade.gemspec
+- lib/facade.rb
 - MANIFEST
 - Rakefile
 - README
-- test/tc_facade.rb
-test_files: 
-- test/tc_facade.rb
+- test/test_facade.rb
+has_rdoc: true
+homepage: http://www.rubyforge.org/projects/shards
+licenses: 
+- Artistic 2.0
+post_install_message: 
 rdoc_options: []
 
-extra_rdoc_files: 
-- README
-- CHANGES
-- MANIFEST
-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: []
-
+rubyforge_project: shards
+rubygems_version: 1.3.4
+signing_key: 
+specification_version: 3
+summary: An easy way to implement the facade pattern in your class
+test_files: 
+- test/test_facade.rb

data/test/tc_facade.rb

@@ -1,65 +0,0 @@
-#########################################################################
-# tc_facade.rb
-#
-# Test suite for the Facade module. This test suite should be run via
-# the 'rake test' task.
-#########################################################################
-require "test/unit"
-require "facade"
-
-module Baz
-   def testme(str)
-      str
-   end
-end
-
-class Foo < String
-   extend Facade
-   facade File, :basename, "dirname"
-   facade Dir
-   facade Baz
-   def blockdev?
-      "test"
-   end
-end
-
-class TC_Facade < Test::Unit::TestCase
-   def setup
-      @f = Foo.new("/home/djberge")
-   end
-   
-   def test_facade_version
-      assert_equal('1.0.2', Facade::FACADE_VERSION)
-   end
-
-   def test_file_methods
-      assert_respond_to(@f, :basename)
-      assert_respond_to(@f, :dirname)
-      assert_raises(NoMethodError){ @f.exists? }
-      assert_raises(NoMethodError){ @f.chardev? }
-   end
-
-   def test_file_method_return_values
-      assert_equal("djberge", @f.basename)
-      assert_equal("/home", @f.dirname)
-   end
-
-   def test_dir_methods
-      assert_respond_to(@f, :pwd)
-      assert_respond_to(@f, :entries)
-   end
-   
-   def test_no_clobber
-      assert_respond_to(@f, :blockdev?)
-      assert_equal("test", @f.blockdev?)
-   end
-
-   def test_module_methods
-      assert_respond_to(@f, :testme)
-      assert_equal("/home/djberge", @f.testme)
-   end
-
-   def teardown
-      @f = nil
-   end
-end