armin-joellenbeck-decorator 0.0.2

data/README

@@ -0,0 +1,54 @@
+=Decorator Pattern for Ruby
+
+This library supports the Decorator Pattern for Ruby.
+
+=Installation
+
+Install the *decorator* gem itself by the following command:
+
+  $ gem install armin-joellenbeck-decorator
+
+=Usage
+
+...
+
+=Support
+
+The project home is at
+GitHub[http://github.com/armin-joellenbeck/decorator/tree/master]:
+http://github.com/armin-joellenbeck/decorator/tree/master
+
+Feel free to send:
+* bug reports
+* support requests
+* feature requests
+* patches
+
+=Copyright
+
+Copyright (c) 2008 by Armin Jöllenbeck
+<armin@joellenbeck.net[mailto:armin@joellenbeck.net]>
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+3. The names of the contributors may not be used to endorse or promote products
+   derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/Rakefile

@@ -0,0 +1,32 @@
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+require 'spec/rake/spectask'
+
+task :default => 'spec'
+
+task :all =>  [:clobber, :spec, :doc, :package]
+
+Spec::Rake::SpecTask.new do |t|
+  t.libs << 'spec' << 'examples' << 'lib'
+  t.spec_opts << '--diff' << 'unified'
+  t.spec_opts << '--format' << 'progress'
+end
+
+Rake::RDocTask.new(:doc) do |t|
+  t.rdoc_dir = 'doc'
+  t.rdoc_files.include('README', 'lib/**/*.rb')
+  t.options = [
+    '--all',
+    '--charset', 'utf8',
+    '--inline-source',
+    '--main', 'README',
+    '--title', 'Decorator Pattern for Ruby'
+  ]
+end
+
+Rake::GemPackageTask.new(eval(File.read('decorator.gemspec'))) do |pkg|
+end
+
+task :auto do
+  sh 'RUBYLIB=spec:examples:lib:$RUBYLIB autospec'
+end

data/decorator.gemspec

@@ -0,0 +1,26 @@
+Gem::Specification.new do |s|
+  s.name = 'decorator'
+  s.version = '0.0.2'
+  s.summary = 'Decorator Pattern for Ruby.'
+  s.author = 'Armin Joellenbeck'
+  s.email = 'armin@joellenbeck.net'
+  s.homepage = 'http://github.com/armin-joellenbeck/decorator/tree/master'
+  s.description = <<-EOF
+  EOF
+  s.files = Dir.glob([
+    'README',
+    'Rakefile',
+    '*.gemspec',
+    'examples/**/*',
+    'lib/**/*',
+    'spec/**/*'
+  ])
+  s.has_rdoc = true
+  s.extra_rdoc_files << 'README'
+  s.rdoc_options = [
+    '--all',
+    '--charset', 'utf8',
+    '--main', 'README',
+    '--title', 'Decorator Pattern for Ruby'
+  ]
+end

data/lib/decorator.rb

@@ -0,0 +1,31 @@
+class Decorator
+  alias_method :__class__, :class
+
+  instance_methods.each do |method|
+    undef_method(method) unless /__.+__/ === method
+  end
+
+  # Initialize with the object which should be decorated.
+  def initialize(object)
+    @object = object
+  end
+
+  # The standard implementation delegates to the decorated object.
+  def method_missing(method, *args)
+    @object.send(method, *args)
+  end
+end
+
+
+class Class
+  # Declare the using of a decorator class within a class defination.
+  # Each instance of that class is decorated by an individual instance of the
+  # decorator class. A decorator class should inherit from Decorator.
+  def decorate(decorator_class)
+    old_new = self.method(:new)
+    (class << self; self; end).send(:define_method, :new) do |*args|
+      object = old_new.call(*args)
+      decorator_class.new(object)
+    end
+  end
+end

data/spec/decorator_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+require 'decorator'
+
+
+describe 'A decorator' do
+  before do
+    @object = Object.new
+    @decorator = Decorator.new(@object)
+  end
+
+  it 'should delegate to the decorated object' do
+    mock(@object).foo
+    @decorator.foo
+  end
+end
+
+
+describe 'Decorating a class' do
+  it 'should delegate to each decorated object' do
+    decorator_class = Class.new(Decorator)
+    decorator_class.send(:define_method, :foo) {:bar}
+    object_class = Class.new
+    object_class.decorate(decorator_class)
+    object = object_class.new
+    object.foo.should == :bar
+  end
+end

data/spec/spec.opts

@@ -0,0 +1,3 @@
+--color
+--diff unified
+--format specdoc

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+require 'rubygems'
+
+require 'spec'
+require 'rr'
+
+Spec::Runner.configure do |config|
+  config.mock_with :rr
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification 
+name: armin-joellenbeck-decorator
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Armin Joellenbeck
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-10-27 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: ""
+email: armin@joellenbeck.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- README
+- Rakefile
+- decorator.gemspec
+- lib/decorator.rb
+- spec/spec_helper.rb
+- spec/decorator_spec.rb
+- spec/spec.opts
+has_rdoc: true
+homepage: http://github.com/armin-joellenbeck/decorator/tree/master
+post_install_message: 
+rdoc_options: 
+- --all
+- --charset
+- utf8
+- --main
+- README
+- --title
+- Decorator Pattern for Ruby
+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: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Decorator Pattern for Ruby.
+test_files: []
+