pres 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 871d21e9da20da6b0ba8ba1f448c86fb91e24087
-  data.tar.gz: ec4a5cca68060275991ea5bd0f13ead4f113c077
+  metadata.gz: bc021d5c9372478d941b2beea539420d82de377e
+  data.tar.gz: 54a3bd206edc161d6f414329a2c9fe885faee57d
 SHA512:
-  metadata.gz: 9eb0e651996a5a2712f1b034e914ff69655d34c345583c49f5a273f016829a4543045bc44ce102bbed701a68edff0fac97e81e5fc66c7d3701a1c4a9a90e8e7a
-  data.tar.gz: d02df0e3db9d705038b2790ea4cbbc1d0ffbb8f60b2859345650da67a8e336a68a20cb5d7d0492a0558348c4227e669baa4162957fd2c01885e65349ee9bfb5f
+  metadata.gz: '098c8e5eb4c4c62f5ce807ee6333e232295607d732f308dfb0eb2f19a25d1d9ad81f9edbe1443c56c82d0ec807d100394234389c28e2131fb56b10ccf2782e11'
+  data.tar.gz: 20a2b0fbe3666005827b0406fac9095afc19c28186184d4c862ffdf28b4b5537153ca1d94cba127e34f64bd52d3b37623cc1f96b5c232065284c9005a923c808

data/README.md

@@ -89,7 +89,7 @@ Use the presenter object in `doges/show.haml.html`
 ```haml
 = doge.name_header
 .status
-  You are #{ doge.signed_in_status }
+  You are #{doge.signed_in_status}
 .links
   .meme-link= doge.know_your_meme_link
 ```
@@ -165,6 +165,19 @@ present(user, presenter: UserEditPresenter, cool: true)
 => #<UserEditPresenter object: #<User> ...>
 ```
 
+You may also define a custom presenter class on any class you want to present:
+
+```ruby
+class User
+  def presenter_class
+    MyPresenter
+  end
+end
+
+present(User.new)
+# => #<MyPresenter object: #<User> ...>
+```
+
 #### Creating presenters in views
 
 If you would like to create a presenter in your view code, make the `present` method 
@@ -215,7 +228,7 @@ end
 
 #### Presenters can create other presenters
 
-If you are awesome, you could have one top-level presenter exposed per controller,
+Ideally, you can have one top-level presenter exposed per controller,
 which can then wrap child objects in presenters of their own.
 
 ```ruby
@@ -234,7 +247,7 @@ end
 
 If you don't want to inherit from `Pres::Presenter`, you can include
 `Pres::ViewDelegation` and implement your own initializer (so the `present` helper
-will work). 
+will work).
 
 This technique is useful if you would like to delegate all methods in a model
 by default, instead of whitelisting methods on the wrapped model explicitly.

data/lib/pres/presents.rb

@@ -4,8 +4,17 @@ module Pres
 
     # Wrap an object or collection of objects with a presenter class.
     #
-    # object    - a ruby class, or nil
-    # presenter - a Presenter class (optional)
+    # object    - A ruby object. May be nil.
+    # presenter - A Presenter class (optional)
+    # args      - optional hash / kwargs passed to the presenter
+    #
+    # An instance of a presenter class is created. The class is
+    # one of the following:
+    # - the `presenter` argument
+    # - `Pres::Presenter` if object is nil
+    # - object.presenter_class (if that method is defined)
+    # - the default presenter class for the object
+    #   (for example: User -> UserPresenter)
     #
     # Examples
     #
@@ -23,6 +32,15 @@ module Pres
     # present(user, presenter: NiceUserPresenter, cool: true)
     # => #<NiceUserPresenter object: #<User> ...>
     #
+    # class User
+    #   def presenter_class
+    #     MyPresenter
+    #   end
+    # end
+    # user = User.new
+    # present(user)
+    # => #<MyPresenter object: #<User> ...>
+    #
     # present([user])
     # => [#<UserPresenter object: #<User> ...>]
     #
@@ -36,6 +54,7 @@ module Pres
         object.map { |item| present(item, presenter: presenter, **args) }
       else
         presenter ||= Presenter if object.nil?
+        presenter ||= object.respond_to?(:presenter_class) && object.presenter_class
         presenter ||= Object.const_get("#{object.class.name}Presenter")
         wrapper = presenter.new(object, view_context, **args)
         block_given? ? yield(wrapper) : wrapper

data/lib/pres/version.rb

@@ -1,3 +1,3 @@
 module Pres
-  VERSION = "1.2.0"
+  VERSION = "1.3.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pres
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Tee Parham
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-10-24 00:00:00.000000000 Z
+date: 2017-02-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -73,14 +73,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '11.0'
+        version: '12.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '11.0'
+        version: '12.0'
 description: A Simple Rails Presenter base class and controller helper
 email:
 - tee@neighborland.com
@@ -116,7 +116,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.7
+rubygems_version: 2.6.8
 signing_key: 
 specification_version: 4
 summary: A Simple Rails Presenter