artdeco 1.1.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - jruby-19mode
+  - rbx-19mode

data/Gemfile

@@ -0,0 +1,7 @@
+source "http://rubygems.org"
+
+gem 'rake'
+gem 'activesupport'
+
+# Specify your gem's dependencies in artdeco.gemspec
+gemspec

data/README.md

@@ -0,0 +1,57 @@
+# Artdeco
+
+[![Build History][2]][1]
+
+[1]: http://travis-ci.org/tracksun/artdeco
+[2]: https://secure.travis-ci.org/tracksun/artdeco.png?branch=master
+
+Decorators for Rails 
+
+* extend an object with given classes (default is \<object.class\>Decorator, if defined)
+* make helpers accessible in object via :h
+
+### Example
+
+Decorate a model in your controller:
+
+    def show
+      article = Article.find(params[:id])
+      @article = Artdeco.decorate(article, self)
+    end
+ 
+    def index
+      articles = Article.all
+      @articles = Artdeco.decorate(articles, self)
+    end
+
+Then @article will be extended by module ArticleDecorator
+and has access to your helpers via :h
+
+    module ArticleDecorator
+      def image
+        h.image_tag('article')
+      end
+    end
+
+and your views may use the decorated model: 
+
+    # app/views/articles/show.html.haml
+    %h1 
+      Article
+      = @article.image
+
+
+Modules for decoration may be given explicitly:
+
+    Artdeco.decorate(user, self, decorator: Customer)
+
+    # or
+
+    Artdeco.decorate(user, self, decorator: [ Customer, Admin ] )
+
+
+For conveniance decorated objects may decorate other objects:
+
+    Artdeco.decorate(order, self)
+
+    order.decorate(shopping_card)

data/Rakefile

@@ -0,0 +1,10 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+
+require 'rake/testtask'
+
+task default: [:test]
+ 
+Rake::TestTask.new do |t|
+  t.pattern = "test/*.rb"
+end

data/artdeco.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "artdeco/version"
+
+Gem::Specification.new do |s|
+  s.name        = "artdeco"
+  s.version     = Artdeco::VERSION
+  s.authors     = ["Thomas Sonntag"]
+  s.email       = ["git@sonntagsbox.de"]
+  s.homepage    = ""
+  s.summary     = %q{Decorators for Rails}
+  s.description = %q{Decorate models with views in a object oriented way}
+
+  s.rubyforge_project = "artdeco"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  # s.add_development_dependency "rspec"
+  # s.add_runtime_dependency "rest-client"
+end

data/lib/artdeco/version.rb

@@ -0,0 +1,3 @@
+module Artdeco
+  VERSION = "1.1.0"
+end

data/lib/artdeco.rb

@@ -0,0 +1,81 @@
+require 'active_support/core_ext/array/extract_options'
+require 'active_support/core_ext/hash/keys'
+require 'active_support/core_ext/string/inflections'
+
+module Artdeco
+
+  module DecoratorMethods
+
+    def decorate model, *decorator_classes
+      return nil if model.nil?
+      decorator_classes = @decorator_classes || default_decorator_class(model) if decorator_classes.empty?
+      [decorator_classes].flatten.each{|dc|model.extend dc}
+      h = self.h
+      model.define_singleton_method(:h){h}
+      model.extend DecoratorMethods
+      model
+    end
+    
+    private
+    def default_decorator_class model 
+      @_decorator_classes_cache ||= {} 
+      [@_decorator_classes_cache.fetch(model.class){"::#{model.class}Decorator".constantize rescue nil}].compact
+    end
+
+  end
+
+  module ClassMethods
+    def decorate model, *args
+      Decorator.new(*args).decorate(model)
+    end
+  end
+
+  class Decorator
+
+    include DecoratorMethods
+
+    attr_reader :params, :view_context
+    alias_method :h, :view_context
+    
+    # Args may be either the params hash of the request
+    # or an object which responds to :params and optionally to :view_context, e.g. a controller instance
+    # If a view_context is given it will be accessible in various blocks by calling :h
+    def initialize *args
+      opts = args.extract_options!
+      
+      @decorator_classes = ([opts.delete(:decorators)] + [opts.delete(:decorator)]).flatten.compact
+      @decorator_classes = nil if @decorator_classes.empty? # required for #decorate
+
+      case args.size
+      when 0
+        @view_context = opts.delete :view_context 
+        @params = opts.delete(:params){opts}
+      when 1
+        arg = args.first
+        @view_context = arg.respond_to?(:view_context) ? arg.view_context : nil
+
+        if arg.respond_to? :params
+          @params = arg.params.symbolize_keys.merge(opts)
+        else
+          raise ArgumentError, 'argument must respond_to :params'
+        end
+      else
+        raise ArgumentError, 'too many arguments' if args.size > 1
+      end
+    end
+ 
+    # evaluate data (string or proc)
+    # if model is provided it will accessible in evaluated data
+    def eval data, model = nil
+      case data
+      when Proc
+        (model ? model : self).instance_exec(&data)
+      else
+        data
+      end
+    end
+
+  end
+
+  self.extend ClassMethods
+end

data/test/artdeco_test.rb

@@ -0,0 +1,127 @@
+# encoding: UTF-8
+$:.unshift File.expand_path( '../lib/', File.dirname( __FILE__))
+
+require 'minitest/autorun'
+require 'artdeco'
+
+class ArtdecoTest < MiniTest::Unit::TestCase
+
+  class Foo
+     def foo
+     end
+  end
+
+  class FooHelper
+    def hi
+    end
+  end
+
+  module FooDecorator
+    def ho
+    end
+  end
+
+  module BlaDecorator
+    def bla
+    end
+  end
+
+  class FakeController
+
+    def view_context
+      @view_context ||= FooHelper.new
+    end 
+
+    def params
+      {}
+    end
+
+    def method_missing *args
+      view_content.send *args
+    end
+  end
+  
+  def test_decorate_model
+     model = Foo.new
+     controller = FakeController.new
+     Artdeco.decorate model, controller
+
+     assert_respond_to model, :h
+     assert_respond_to model, :ho
+     assert_respond_to model, :decorate
+
+     h = model.h
+     assert_equal FooHelper, h.class
+     assert_respond_to h, :hi
+  end
+
+  def test_decorate_model_with_given_decorator
+     model = Foo.new
+     controller = FakeController.new
+     Artdeco.decorate model, controller, decorators: BlaDecorator
+
+     assert_respond_to model, :h
+     assert_respond_to model, :bla
+     assert_respond_to model, :decorate
+
+     h = model.h
+     assert_equal FooHelper, h.class
+     assert_respond_to h, :hi
+  end
+
+  def test_decorate_model_with_given_decorators
+     model = Foo.new
+     controller = FakeController.new
+     Artdeco.decorate model, controller, decorators: [BlaDecorator, FooDecorator]
+
+     assert_respond_to model, :h
+     assert_respond_to model, :ho
+     assert_respond_to model, :bla
+     assert_respond_to model, :decorate
+
+     h = model.h
+     assert_equal FooHelper, h.class
+     assert_respond_to h, :hi
+  end
+
+  def test_decorated_model_can_decorate
+     model = Foo.new
+     controller = FakeController.new
+     model = Artdeco.decorate model, controller
+
+     other = Foo.new
+     model.decorate other
+
+     assert_respond_to other, :h
+     assert_respond_to other, :ho
+     assert_respond_to other, :decorate
+
+     h = other.h
+     assert_equal FooHelper, h.class
+
+
+     another = Foo.new
+     model.decorate another, BlaDecorator
+
+     assert_respond_to another, :h
+     assert_respond_to another, :bla
+     assert !another.respond_to?(:ho)
+     assert_respond_to another, :decorate
+
+     h = another.h
+     assert_equal FooHelper, h.class
+  end
+
+  def decorator_with_hash_argument
+     model = Foo.new
+     Artdeco.decorate model, view_context: FooHelper.new, params: {}
+
+     assert_respond_to model, :h
+     assert_respond_to model, :ho
+     assert_respond_to model, :decorate
+
+     h = model.h
+     assert_equal FooHelper, h.class
+     assert_respond_to h, :hi
+  end
+end

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: artdeco
+version: !ruby/object:Gem::Version
+  version: 1.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Thomas Sonntag
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-06-06 00:00:00.000000000 Z
+dependencies: []
+description: Decorate models with views in a object oriented way
+email:
+- git@sonntagsbox.de
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- README.md
+- Rakefile
+- artdeco.gemspec
+- lib/artdeco.rb
+- lib/artdeco/version.rb
+- test/artdeco_test.rb
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: artdeco
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: Decorators for Rails
+test_files: []