pres 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6c26aeb59d5a25f1249d32e9b31c52dd40c55262
-  data.tar.gz: fe9fb9d51ac9010b57d95cff1c7f00e55d04752d
+  metadata.gz: 871d21e9da20da6b0ba8ba1f448c86fb91e24087
+  data.tar.gz: ec4a5cca68060275991ea5bd0f13ead4f113c077
 SHA512:
-  metadata.gz: e315003283e6fed583e5f8b7399a3640a99b9177a9da67c0eb9adf1e94cdee6d06821979cecb824fef5fc26288177eea5dfd4aa71e8885636ec92afb9769e6b0
-  data.tar.gz: d47003fd1650d6800cf0b1380b5cd48aeb48279a52f1cfe28bf7bf0e264db2b6b396a1268751b1b9ee58ae2d87053eb3e9cdcd30f92af11b13d780be209f685e
+  metadata.gz: 9eb0e651996a5a2712f1b034e914ff69655d34c345583c49f5a273f016829a4543045bc44ce102bbed701a68edff0fac97e81e5fc66c7d3701a1c4a9a90e8e7a
+  data.tar.gz: d02df0e3db9d705038b2790ea4cbbc1d0ffbb8f60b2859345650da67a8e336a68a20cb5d7d0492a0558348c4227e669baa4162957fd2c01885e65349ee9bfb5f

data/README.md

@@ -15,7 +15,7 @@ Rails' `ViewContext` contains convenience methods for views, such as `link_to`,
 Rails views nice to work with.
 
 Other presenter libraries mix in all the methods from the Rails `ViewContext` to
-make it easy to call those methods in the Presenter class.  `pres` instead injects 
+make it easy to call those methods in the Presenter class. `pres` instead injects 
 the `ViewContext` as a dependency into the Presenter class, and uses `method_missing` 
 to delegate to `ViewContext` methods. `pres` produces small classes that contain and 
 delegate to an existing object that handles server-side rendering.
@@ -36,12 +36,6 @@ class ApplicationController
 end
 ```
 
-Add `app/presenters` to your application's autoload paths in `application.rb`:
-
-```ruby
-config.autoload_paths += %W( #{ config.root }/app/presenters )
-```
-
 ### Usage
 
 The quickest way to get started is to use the `Pres::Presenter` base class.
@@ -83,8 +77,7 @@ class DogesController
 
   private
 
-  helper_method :doge
-
+  helper_method \
   def doge
     @doge ||= present(Doge.find(params[:id]))
   end  
@@ -120,8 +113,7 @@ class DogesController
 
   private
 
-  helper_method :doges
-
+  helper_method \
   def doges
     @doges ||= present(Doge.all)
   end  
@@ -175,8 +167,8 @@ present(user, presenter: UserEditPresenter, cool: true)
 
 #### Creating presenters in views
 
-You should create presenters in your controllers or within other presenters. If you would like to create
-a presenter in your view code, make the `present` method visible to your views:
+If you would like to create a presenter in your view code, make the `present` method 
+visible to your views.
 
 ```ruby
 class ApplicationController
@@ -185,6 +177,13 @@ class ApplicationController
 end
 ```
 
+This makes it easy to create presenters inline in a view:
+
+```haml
+- present(@doge) do |doge|
+  = doge.name_header
+```
+
 ### Presenters are objects
 
 You can mix in common methods.
@@ -267,3 +266,5 @@ Change your code references to `Pres::Presents` and `Pres::Presenter`.
 
 * http://nithinbekal.com/posts/rails-presenters/
 * https://github.com/drapergem/draper
+* http://thepugautomatic.com/2014/03/draper/
+* https://robots.thoughtbot.com/sandi-metz-rules-for-developers

data/lib/pres/presents.rb

@@ -14,6 +14,12 @@ module Pres
     # => #<UserPresenter object: #<User> ...>
     #
     # user = User.new
+    # present(user) do |up|
+    #   up.something
+    # end
+    # up => #<UserPresenter object: #<User> ...>
+    #
+    # user = User.new
     # present(user, presenter: NiceUserPresenter, cool: true)
     # => #<NiceUserPresenter object: #<User> ...>
     #
@@ -24,13 +30,15 @@ module Pres
     # => [#<Presenter object: nil ...>]
     #
     # Returns a new Presenter object or array of new Presenter objects
+    # Yields a new Presenter object if a block is given
     def present(object, presenter: nil, **args)
       if object.respond_to?(:to_ary)
         object.map { |item| present(item, presenter: presenter, **args) }
       else
         presenter ||= Presenter if object.nil?
         presenter ||= Object.const_get("#{object.class.name}Presenter")
-        presenter.new(object, view_context, **args)
+        wrapper = presenter.new(object, view_context, **args)
+        block_given? ? yield(wrapper) : wrapper
       end
     end
   end

data/lib/pres/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pres
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Tee Parham
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-09-01 00:00:00.000000000 Z
+date: 2016-10-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -116,7 +116,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.6
+rubygems_version: 2.6.7
 signing_key: 
 specification_version: 4
 summary: A Simple Rails Presenter