poser 0.0.1

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.rspec
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Austin Schneider
+
+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,64 @@
+# Poser
+
+A minimal implementation of the presenter pattern.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'poser'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install poser
+
+## Usage
+
+```
+class Battle
+end
+
+class Warrior < Poser::Presenter
+  def fighting?
+    true
+  end
+end
+
+class Person
+  def initialize(name)
+    @name = name
+  end
+
+  attr_reader :name
+
+  def to_presenter(context)
+    Warrior.new(self, context) if context.is_a?(Battle)
+  end
+
+  def fighting?
+    false
+  end
+end
+
+person = Person.new 'Austin'
+person.name       # 'Austin'
+person.fighting?  # false
+
+battle = Battle.new
+
+warrior = person.to_presenter battle
+warrior.name       # 'Austin'
+warrior.fighting?  # true
+```
+
+## 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/poser.rb

@@ -0,0 +1,7 @@
+module Poser
+end
+
+require "poser/version"
+require 'poser/enumerable_presenter'
+require 'poser/presenter'
+require 'poser/presenter/helper'

data/lib/poser/enumerable_presenter.rb

@@ -0,0 +1,11 @@
+require 'poser/presenter'
+
+module Poser
+  class EnumerablePresenter < Presenter
+
+    def each
+      __getobj__.each { |object| yield present(object) }
+    end
+
+  end
+end

data/lib/poser/presenter.rb

@@ -0,0 +1,54 @@
+require 'delegate'
+
+module Poser
+  class Presenter < SimpleDelegator
+
+    class << self
+      def present(object, context)
+        if object.respond_to?(:presented?) && object.presented?
+          object
+        elsif object.respond_to? :to_presenter
+          object.to_presenter context
+        else
+          determine_presenter_class(object).new object, context
+        end
+      end
+
+      def presents(name)
+        alias_method name, :__getobj__
+      end
+
+    private
+
+      def determine_presenter_class(object)
+        object.class::Presenter
+      rescue NameError
+        if object.is_a?(Enumerable) || (defined?(ActiveRecord) && object.is_a?(ActiveRecord::Relation))
+          EnumerablePresenter
+        else
+          self
+        end
+      end
+    end
+
+    def initialize(presentee, context)
+      super presentee
+      @context = context
+    end
+
+    attr_reader :context
+
+    def present(object)
+      self.class.present object, context
+    end
+
+    def presented?
+      true
+    end
+
+    def ==(other)
+      other.is_a?(self.class) && context == other.context && __getobj__ == other.__getobj__
+    end
+
+  end
+end

data/lib/poser/presenter/helper.rb

@@ -0,0 +1,13 @@
+require 'poser/presenter'
+
+module Poser
+  class Presenter
+    module Helper
+
+      def present(object, context = self)
+        Presenter.present object, context
+      end
+
+    end
+  end
+end

data/lib/poser/version.rb

@@ -0,0 +1,3 @@
+module Poser
+  VERSION = "0.0.1"
+end

data/poser.gemspec

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/poser/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Austin Schneider"]
+  gem.email         = ["austinthecoder@gmail.com"]
+  gem.description   = 'A minimal implementation of the presenter pattern.'
+  gem.summary       = 'A minimal implementation of the presenter pattern.'
+  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          = "poser"
+  gem.require_paths = ["lib"]
+  gem.version       = Poser::VERSION
+
+  gem.add_development_dependency "rspec", ">= 2.9.0"
+end

data/spec/poser/presenter_spec.rb

@@ -0,0 +1,69 @@
+require 'spec_helper'
+
+describe Poser::Presenter do
+  describe "class methods" do
+    subject { described_class }
+
+    describe "present" do
+      before do
+        @object = mock Object
+        @context = Object.new
+      end
+
+      it "returns the object if it's presented" do
+        @object.stub(:presented?) { true }
+        subject.present(@object, @context).should == @object
+      end
+
+      it "returns the result of the object presenting itself if it knows how" do
+        result = Object.new
+        @object.stub(:to_presenter) { result }
+        subject.present(@object, @context).should == result
+      end
+    end
+  end
+
+  describe "instance methods" do
+    subject { described_class.new @presentee, @context }
+
+    before do
+      @presentee = Object.new
+      @context = Object.new
+    end
+
+    describe "==" do
+      it "is true given a #{described_class} instantiated with the same presentee and context" do
+        subject.should == described_class.new(@presentee, @context)
+      end
+
+      it "is not true given a non-#{described_class}" do
+        subject.should_not == Object.new
+      end
+
+      it "is not true given a #{described_class} with a different presentee" do
+        subject.should_not == described_class.new(Object.new, @context)
+      end
+
+      it "is not true given a #{described_class} with a different context" do
+        subject.should_not == described_class.new(@presentee, Object.new)
+      end
+    end
+
+    it { should be_presented }
+
+    describe "present" do
+      it "returns the result of telling the #{described_class} to present the given object with the same context" do
+        result = Object.new
+        object = Object.new
+
+        described_class.stub :present do |presentee, context|
+          result if presentee == object && context == @context
+        end
+
+        subject.present(object).should == result
+      end
+    end
+
+    its(:context) { should == @context }
+  end
+end

data/spec/poser_spec.rb

@@ -0,0 +1,4 @@
+require 'spec_helper'
+
+describe Poser do
+end

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+require 'rspec'
+require 'poser'
+
+RSpec.configure do |c|
+  c.mock_with :rspec
+end

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification
+name: poser
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Austin Schneider
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-04-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.9.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.9.0
+description: A minimal implementation of the presenter pattern.
+email:
+- austinthecoder@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/poser.rb
+- lib/poser/enumerable_presenter.rb
+- lib/poser/presenter.rb
+- lib/poser/presenter/helper.rb
+- lib/poser/version.rb
+- poser.gemspec
+- spec/poser/presenter_spec.rb
+- spec/poser_spec.rb
+- spec/spec_helper.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: 
+rubygems_version: 1.8.21
+signing_key: 
+specification_version: 3
+summary: A minimal implementation of the presenter pattern.
+test_files:
+- spec/poser/presenter_spec.rb
+- spec/poser_spec.rb
+- spec/spec_helper.rb