rendition 0.0.2

data/.gitignore

@@ -0,0 +1,35 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+.idea/workspace.xml
+
+.idea/scopes/scope_settings.xml
+
+.idea/.name
+
+.idea/.rakeTasks
+
+.idea/encodings.xml
+
+.idea/misc.xml
+
+.idea/modules.xml
+
+.idea/rendition.iml
+
+.idea/vcs.xml

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in rendition.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 jake hoffner
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,29 @@
+# Rendition
+
+TODO: Write a gem description
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'rendition'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install rendition
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/lib/rendition.rb

@@ -0,0 +1,8 @@
+
+require 'rendition/version'
+require 'rendition/system'
+require 'rendition/presenter'
+require 'rendition/action_support'
+require 'rendition/view_context'
+require 'rendition/rspec_integration' if defined?(RSpec) and RSpec.respond_to?(:configure)
+require 'rendition/railtie' if defined?(Rails)

data/lib/rendition/action_support.rb

@@ -0,0 +1,54 @@
+
+module Rendition
+  module ActionSupport
+    extend ActiveSupport::Concern
+
+    module ClassMethods
+      # @param [Symbol] name
+      # @param [Block] block
+      def expose_presenter(name, default_type = :default, &block)
+        _expose_presenter_or_presenters(:presenter, name, default_type, &block)
+      end
+
+      # @param [Symbol] name
+      # @param [Block] block
+      def expose_presenters(name, default_type = :default, &block)
+        _expose_presenter_or_presenters(:presenters, name, default_type, &block)
+      end
+
+      private
+
+      def _expose_presenter_or_presenters(method_name, name, default_type, &block)
+        default_exposure = begin self.default_exposure rescue nil end
+        define_method name do |type = default_type, attributes = {}|
+          @_resources ||= {}
+          @_resources.fetch(name) do
+            model = if block_given?
+                      instance_eval(&block)
+                    else
+                      instance_exec(name, &default_exposure)
+                    end
+
+            @_resources[name] = send method_name, type, model, attributes
+          end
+        end
+
+        define_method "#{name}=".to_sym do |value|
+          @_resources ||= {}
+          @_resources[name] = value
+        end
+
+        helper_method name
+        hide_action name
+      end
+    end
+
+    def presenter(type = :default, model = nil, attributes = {}, &block)
+      Rendition::Presenter.presenter(self.view_context, type, model, attributes, &block)
+    end
+
+    def presenters(type = :default, models = nil, attributes = {}, &block)
+      Rendition::Presenter.presenters(self.view_context, type, models, attributes, &block)
+    end
+  end
+end

data/lib/rendition/presenter.rb

@@ -0,0 +1,118 @@
+module Rendition
+  class Presenter
+
+    attr_reader :view_context
+    attr_reader :model
+    attr_reader :parent_presenter
+
+    def initialize (view_context, model, attributes = {})
+      @view_context = view_context
+      @model = model
+
+      @parent_presenter = attributes[:parent_presenter] if attributes.has_key? :parent_presenter
+      set_attrs(attributes)
+
+      setup
+    end
+
+    def set_attrs(attributes)
+      attributes.each do |name, value|
+        self.send "#{name}=", value if self.respond_to? :"#{name}="
+      end
+    end
+
+    def setup
+    end
+
+    def method_missing(method, *args, &block)
+      if model and model.respond_to? method
+        val = model.send method, *args, &block
+
+        # if the value is an array then we want to extend that instance of the array to have a presenters method
+        if val.is_a? Array and !val.respond_to? :presenters
+          parent = self
+          val.define_singleton_method :presenters do |type = nil, attributes = {}|
+            type ||= :default
+            @__presenters ||= {}
+            @__presenters.fetch(type) do
+              parent.presenters(type, self, attributes)
+            end
+          end
+        end
+        val
+        #elsif view_context.respond_to? method
+        #  view_context.send method, *args, &block
+      else
+        super
+      end
+    end
+
+    def presenter(type = :default, model = nil, attributes = {}, &block)
+      attributes[:parent_presenter] = self
+      self.class.presenter(view_context, type, model, attributes, &block)
+    end
+
+    def presenters(type = :default, models = nil, attributes = {}, &block)
+      attributes[:parent_presenter] = self
+      self.class.presenters(view_context, type, models, attributes, &block)
+    end
+
+    class << self
+
+      def presenter(view_context, types = nil, model = nil, attributes = {}, &block)
+
+        types, model, attributes = _process_args(types, model, attributes, &block)
+
+        if model
+          _find_presenter_class(types, model, attributes).new(view_context, model, attributes)
+        else
+          nil
+        end
+      end
+
+      def presenters(view_context, type = nil, models = nil, attributes = {}, &block)
+        type, models, attributes = _process_args(type, models, attributes, &block)
+
+        return [] if models.empty?
+
+        klass = _find_presenter_class(type, models.first, attributes)
+        models.collect do |model|
+          klass.new(view_context, model, attributes.clone) if model
+        end
+      end
+
+      private
+
+      def _process_args(type, model_or_models, attributes = {}, &block)
+        type ||= :default
+
+        # if the model was passed in as the first argument
+        unless type.is_a? Symbol
+          model_or_models = type
+          type = :default
+        end
+
+        if block_given?
+          model_or_models.merge!(attributes) if model_or_models
+          attributes = model_or_models || {}
+          model_or_models = block.call
+        end
+
+        [type, model_or_models, attributes]
+      end
+
+      def _find_presenter_class(type, model, attributes)
+        model = model.model if model.is_a? Rendition::Presenter # allow other presenters to be passed in
+
+        presenter_name = "#{type == :default ? "" : type.to_s.classify}Presenter"
+        begin
+          klass = model.class.const_get(presenter_name)
+          return klass
+        rescue
+          nil
+        end
+
+      end
+    end
+  end
+end

data/lib/rendition/railtie.rb

@@ -0,0 +1,57 @@
+require 'rails/railtie'
+
+#module ActiveModel
+#  class Railtie < Rails::Railtie
+#    generators do |app|
+#      Rails::Generators.configure!(app.config.generators)
+#      require "generators/resource_override"
+#    end
+#  end
+#end
+
+module Rendition
+  class Railtie < Rails::Railtie
+
+    ##
+    # Decorators are loaded in
+    # => at app boot in non-development environments
+    # => after each request in the development environment
+    #
+    # This is necessary because we might never explicitly reference
+    # Decorator constants.
+    #
+    config.to_prepare do
+      ::Rendition::System.load_app_local_presenters
+    end
+
+    ##
+    # The `app/decorators` path is eager loaded
+    #
+    # This is the standard "Rails Way" to add paths from which constants
+    # can be loaded.
+    #
+    config.after_initialize do |app|
+      app.config.paths.add 'app/presenters', :eager_load => true
+    end
+
+    initializer "rendition.extend_action_controller_base" do |app|
+      ActiveSupport.on_load(:action_controller) do
+        Rendition::System.setup(:action_controller)
+      end
+    end
+
+    initializer "rendition.extend_action_mailer_base" do |app|
+      ActiveSupport.on_load(:action_mailer) do
+        Rendition::System.setup(:action_mailer)
+      end
+    end
+
+    console do
+      require 'action_controller/test_case'
+      #ApplicationController.new.set_current_view_context
+      #Rendition::ViewContext.current.controller.request ||= ActionController::TestRequest.new
+      #Rendition::ViewContext.current.request            ||= Rendition::ViewContext.current.controller.request
+      #Rendition::ViewContext.current.params             ||= {}
+    end
+  end
+end

data/lib/rendition/rspec_integration.rb

@@ -0,0 +1,24 @@
+module Rendition
+  module PresenterExampleGroup
+    extend ActiveSupport::Concern
+    included { metadata[:type] = :presenter }
+  end
+end
+
+RSpec.configure do |config|
+  # Automatically tag specs in specs/Presenters as type: :presenter
+  config.include Rendition::PresenterExampleGroup, :type => :presenter, :example_group => {
+      :file_path => /spec[\\\/]Presenters/
+  }
+
+  # Specs tagged type: :presenter set the Rendition view context
+  config.around do |example|
+    if :presenter == example.metadata[:type]
+      ApplicationController.new.set_current_view_context
+      Rendition::ViewContext.current.controller.request ||= ActionController::TestRequest.new
+      Rendition::ViewContext.current.request            ||= Rendition::ViewContext.current.controller.request
+      Rendition::ViewContext.current.params             ||= {}
+    end
+    example.call
+  end
+end

data/lib/rendition/system.rb

@@ -0,0 +1,23 @@
+module Rendition
+  class System
+    def self.app_local_presenter_glob
+      'app/presenters/**/*_presenter.rb'
+    end
+
+    def self.load_app_local_presenters
+      presenter_files = Dir[ "#{ Rails.root }/#{ app_local_presenter_glob }" ]
+      presenter_files.each { |d| require_dependency d }
+    end
+
+    def self.setup(component)
+      if component == :action_controller
+        #ActionController::Base.send(:include, Rendition::ViewContextFilter)
+        ActionController::Base.send(:include, Rendition::ActionSupport)
+        #ActionController::Base.extend(Rendition::HelperSupport)
+      elsif component == :action_mailer
+        #ActionMailer::Base.send(:include, Rendition::ViewContextFilter)
+        ActionMailer::Base.send(:include, Rendition::ActionSupport)
+      end
+    end
+  end
+end

data/lib/rendition/version.rb

@@ -0,0 +1,3 @@
+module Rendition
+  VERSION = "0.0.2"
+end

data/lib/rendition/view_context.rb

@@ -0,0 +1,21 @@
+module Rendition
+  module ViewContext
+    def self.current
+      Thread.current[:current_view_context]
+    end
+
+    def self.current=(input)
+      Thread.current[:current_view_context] = input
+    end
+  end
+
+  module ViewContextFilter
+    def set_current_view_context
+      Rendition::ViewContext.current = self.view_context
+    end
+
+    def self.included(source)
+      source.send(:before_filter, :set_current_view_context) if source.respond_to?(:before_filter)
+    end
+  end
+end

data/rendition.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/rendition/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Jake Hoffner"]
+  gem.email         = ["jake.hoffner@hoffnercorporation.com"]
+  gem.description   = %q{Rails 3 MVC Presenter pattern library}
+  gem.summary       = %q{}
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "rendition"
+  gem.require_paths = ["lib"]
+  gem.version       = Rendition::VERSION
+  gem.rubyforge_project = "rendition"
+
+  gem.add_dependency 'activesupport', '~> 3.2'
+  gem.add_dependency 'actionpack', '~> 3.2'
+
+  gem.add_development_dependency 'ammeter', '~> 0.2.2'
+  gem.add_development_dependency 'rake', '~> 0.9.2'
+  gem.add_development_dependency 'rspec', '~> 2.10'
+  gem.add_development_dependency 'rails', '~> 3.2.3'
+end

data/spec/rendition/action_support_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe Rendition::ActionSupport do
+  let(:app_controller) { ApplicationController }
+  let(:app_controller_instance) { app_controller.new }
+
+  it "implements #presenter" do
+    app_controller_instance.should respond_to(:presenter)
+  end
+
+  it "implements #presenters" do
+    app_controller_instance.should respond_to(:presenters)
+  end
+
+  it "implements #expose_presenter" do
+    app_controller.should respond_to(:expose_presenter)
+  end
+
+  it "implements #expose_presenters" do
+    app_controller.should respond_to(:expose_presenters)
+  end
+
+  describe "expose_presenter" do
+    let(:product) { app_controller_instance.product }
+
+    it "should always return a presenter instance when the underlying model is available" do
+      product.is_a?(Rendition::Presenter).should be_true
+      product.is_a?(Product::Presenter).should be_true
+    end
+  end
+end

data/spec/rendition/presenter_spec.rb

@@ -0,0 +1,48 @@
+require 'spec_helper'
+
+describe Rendition::Presenter do
+  let(:app_controller_instance) {ApplicationController.new}
+  let(:presenter) { app_controller_instance.product }
+
+  it "should have its model attribute set to the underlying model" do
+    presenter.model.is_a?(Product).should be_true
+  end
+
+  it "should pass-through to the decorated model" do
+    presenter.name.empty?.should be_false
+  end
+
+  it "should implement #context" do
+    presenter.view_context.should_not be_nil
+  end
+
+  it "should implement #model" do
+    presenter.model.should_not be_nil
+  end
+
+  it "should provide access to presenter specific methods" do
+    presenter.name_and_id.should == "#{presenter.name}_#{presenter.id}"
+  end
+
+  describe "nested presenters" do
+    let(:nested_presenters) { presenter.related_products.presenters }
+
+    it "should provide the ability to load child presenters on arrays within the model" do
+      nested_presenters.first.is_a?(Product::Presenter).should be_true
+    end
+
+    it "should have their #parent_presenter attr set" do
+      nested_presenters.first.parent_presenter.should == presenter
+    end
+  end
+
+
+  describe "specifying a non-default presenter type" do
+    let(:alt_presenter) {alt_presenter = app_controller_instance.presenter(:alt, presenter)}
+
+    it "should return itself as a different type of presenter if manually specified" do
+      alt_presenter.is_a?(Product::AltPresenter).should be_true
+    end
+
+  end
+end

data/spec/rendition/view_context_spec.rb

@@ -0,0 +1,19 @@
+#require 'spec_helper'
+#
+#describe Rendition::ViewContext do
+#  let(:app_controller) { ApplicationController }
+#  let(:app_controller_instance) { app_controller.new }
+#
+#  it "implements #set_current_view_context" do
+#    app_controller_instance.should respond_to(:set_current_view_context)
+#  end
+#
+#  it "calls #before_filter with #set_current_view_context" do
+#    app_controller.before_filters.should include(:set_current_view_context)
+#  end
+#
+#  it "raises an exception if the view_context is fetched without being set" do
+#    Rendition::ViewContext.current = nil
+#    expect {app_controller.current_view_context}.should raise_exception(Exception)
+#  end
+#end

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+require 'bundler/setup'
+require 'ammeter/init'
+require 'rails'
+
+require 'action_controller'
+
+Bundler.require
+
+require 'support/application_helper'
+require 'support/application_controller'
+require 'support/models'

data/spec/support/application_controller.rb

@@ -0,0 +1,46 @@
+
+module ActionController
+  class Base
+    @@before_filters = []
+    def self.before_filters
+      @@before_filters
+    end
+    def self.before_filter(name)
+      @@before_filters << name
+    end
+  end
+end
+
+Rendition::System.setup(:action_controller)
+
+class ApplicationController < ActionController::Base
+  #extend ActionView::Helpers
+  #extend ActionView::Helpers::TagHelper
+  #extend ActionView::Helpers::UrlHelper
+  extend ApplicationHelper
+
+  expose_presenter :product do
+    Product.test_instance
+  end
+
+  def view_context
+    @view_context ||= ApplicationController
+  end
+
+  def view_context=(input)
+    @view_context = input
+  end
+
+  def self.hello
+    "Hello!"
+  end
+
+  def self.capture(&block)
+    @@capture = true
+    block.call
+  end
+
+  def self.capture_triggered
+    @@capture ||= false
+  end
+end

data/spec/support/application_helper.rb

@@ -0,0 +1,5 @@
+module ApplicationHelper
+  def hello_world
+    "Hello, World!"
+  end
+end

data/spec/support/models.rb

@@ -0,0 +1,33 @@
+
+class Product
+  attr_accessor :name, :id, :related_products
+
+  def initialize
+    self.related_products = []
+  end
+
+  def self.test_instance
+    p = Product.new
+    p.name = "test_name"
+    p.id = "test_id"
+
+    p2 = Product.new
+    p2.name = "related_product_name"
+    p2.id = "related_product_id"
+
+    p.related_products << p2
+    p
+  end
+
+  class Presenter < Rendition::Presenter
+    def name_and_id
+      "#{name}_#{id}"
+    end
+  end
+
+  class AltPresenter < Product::Presenter
+    def is_alt?
+      true
+    end
+  end
+end

metadata

@@ -0,0 +1,169 @@
+--- !ruby/object:Gem::Specification
+name: rendition
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+  prerelease: 
+platform: ruby
+authors:
+- Jake Hoffner
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-05-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: actionpack
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: ammeter
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.2.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.2.2
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.10'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.3
+description: Rails 3 MVC Presenter pattern library
+email:
+- jake.hoffner@hoffnercorporation.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/rendition.rb
+- lib/rendition/action_support.rb
+- lib/rendition/presenter.rb
+- lib/rendition/railtie.rb
+- lib/rendition/rspec_integration.rb
+- lib/rendition/system.rb
+- lib/rendition/version.rb
+- lib/rendition/view_context.rb
+- rendition.gemspec
+- spec/rendition/action_support_spec.rb
+- spec/rendition/presenter_spec.rb
+- spec/rendition/view_context_spec.rb
+- spec/spec_helper.rb
+- spec/support/application_controller.rb
+- spec/support/application_helper.rb
+- spec/support/models.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: rendition
+rubygems_version: 1.8.21
+signing_key: 
+specification_version: 3
+summary: ''
+test_files:
+- spec/rendition/action_support_spec.rb
+- spec/rendition/presenter_spec.rb
+- spec/rendition/view_context_spec.rb
+- spec/spec_helper.rb
+- spec/support/application_controller.rb
+- spec/support/application_helper.rb
+- spec/support/models.rb