classic_presenter 0.0.1 → 1.0.0

data/.gitignore

@@ -0,0 +1,4 @@
+*~
+.bundle
+rdoc/*
+pkg

data/README.rdoc

@@ -0,0 +1,61 @@
+== Classic Presenter
+
+Presenter Pattern for Rails Applications
+
+== Installation
+
+gem install classic_presenter
+
+== Usage
+
+* In your Gemfile you should set:
+
+    gem 'classic_presenter'
+
+* Create a simple ActiveRecord class that you want to present:
+
+    class Product < ActiveRecord::Base
+    end
+
+* Create a presenter class inheriting from ClassicPresenter::Base:
+
+    class ProductPresenter < ClassicPresenter::Base
+      def display_name
+          if user
+            context.content_tag :strong, name
+          else
+          context.link_to name, context.product_path
+        end
+      end
+
+      def display_description
+        context.render "products/description", :product => self
+      end
+    end
+
+* In your view, show.html.erb for example, you can present your Product object using this syntax:
+
+    <% present ProductPresenter, @product, :user => current_user do |presenter| %>
+    <%= presenter.display_name %>
+    <%= presenter.display_description %>
+    <% end %>
+
+== Additional details
+
+* We can pass many objects to the presenter. In this example we are using :user => current_user and current_user is a helper that returns a User that is logged in. But we can use this for example:
+
+    <% present ProductPresenter, @product, :foo => "bar", :bar => "foo" do |presenter| %>
+
+* Since ClassicPresenter::Base is a Decorator, it implements the “transparent interface” requirements of the Gang of Four’s definition. This means that when we call some method in ProductPresenter, it will be delegated to the decorated object (in this case Product), like this:
+
+    #products_controller.rb
+    @product = ProductPresenter.new(Product.find(params[:id]))
+
+    #show.html.erb
+    <%= @product.name %>
+    <%= @product.display_name %>
+
+
+
+
+

data/lib/classic_presenter/helper.rb

@@ -2,7 +2,7 @@ module ClassicPresenter
   module Helper
     extend self
 
-    def present(presenter_class, model, objects)
+    def present(presenter_class, model = nil, objects = {})
       presenter = presenter_class.new(model, self, objects)
       yield presenter if block_given?
       presenter

data/lib/classic_presenter/version.rb

@@ -1,3 +1,3 @@
 module ClassicPresenter
-  VERSION = "0.0.1"
+  VERSION = "1.0.0"
 end

data/lib/generators/presenter_generator.rb

@@ -0,0 +1,10 @@
+class PresenterGenerator < Rails::Generators::Base
+  source_root File.expand_path('../templates', __FILE__)
+  argument :presenter_name, :type => :string
+
+  desc "Generates a Presenter Class"
+  def generate_presenter
+    template "presenter.rb", "app/presenters/#{presenter_name.underscore}_presenter.rb"
+  end
+end
+

data/lib/generators/templates/presenter.rb

@@ -0,0 +1,2 @@
+class <%= presenter_name %>Presenter < ClassicPresenter::Base
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: classic_presenter
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 1.0.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-05-23 00:00:00.000000000Z
+date: 2012-06-21 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70331810353200 !ruby/object:Gem::Requirement
+  requirement: &70257448795260 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,7 +21,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70331810353200
+  version_requirements: *70257448795260
 description: A simple Presenter Pattern for Rails Applications
 email:
 - rinaldifonseca@gmail.com
@@ -29,8 +29,10 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- .gitignore
 - Gemfile
 - Gemfile.lock
+- README.rdoc
 - Rakefile
 - classic_presenter.gemspec
 - lib/classic_presenter.rb
@@ -38,6 +40,8 @@ files:
 - lib/classic_presenter/helper.rb
 - lib/classic_presenter/railtie.rb
 - lib/classic_presenter/version.rb
+- lib/generators/presenter_generator.rb
+- lib/generators/templates/presenter.rb
 - spec/classic_presenter_base_spec.rb
 - spec/classic_presenter_helper_spec.rb
 - spec/spec_helper.rb