pre_render 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c3476896a3dfcf2a171a65e3f6e52baf0457000e
-  data.tar.gz: 5ce05cbe2b9f9d80f6afb66be37bb4f76853a26f
+  metadata.gz: 0e072582c9529942abe36c58341c2d277674e7b6
+  data.tar.gz: d8b8c39f4fafcb8a2e94f2ed09e683050a95a5c1
 SHA512:
-  metadata.gz: 295e79ae45cf471552f0016e96bba3a433da627da0cb4764aebce5c84b00ea85e50061ba3e4398bd144784b022e59cb1a22ac38e21b6b54ceb8261a8ba0ed26b
-  data.tar.gz: 2c56548248bca50c19494f19036a59318eff675154b383c9634382be81536d741c90c7b5448a40927e5fe3c7170670523aae81d114a47e0b84ff2ffce626621a
+  metadata.gz: 0b1f47fba0855065a07e3f23e638421a8abd7fe3bc8d1399c8f3fa239e6d1deb355c965fab24f544b0083cc4dfb1d6e1ee0078897a42bccef761e5ab50a2baf6
+  data.tar.gz: cb264f0ad4ff5359d95fad28f1a58a11d64bf8386c095c9d1e66d9499f3638548b152e6b872fb4c8691d8b206242dcdd4dd654b412eecba3472f0e6ddce9a707

data/README.md

@@ -43,6 +43,7 @@ class PeopleController < ApplicationController
     when :edit
       # ...
     # ...
+    end
   end
 
   private
@@ -60,15 +61,31 @@ class PeopleController < ApplicationController
 end
 ```
 
-The ```pre_render()``` method will be called right before Rails' ```render()``` method.  This will give your controller a last chance to
-fully initialize any instance variables a view might need to render itself.  If you are using any view model construct, this is a
-good place to initialize or finish initializing it.
+The ```pre_render()``` method will be called right before Rails' ```render()``` method.  This will give your controller a last chance
+to fully initialize any instance variables a view might need to render itself.  If you are using some sort of view model or
+presenter construct, this is a good place to initialize or finish initializing it.
+
+The usefulness of this construct becomes apparent when validation comes into play.  Suppose your ```Person``` model looks like this:
+
+```ruby
+class Person < ActiveRecord::Base
+  validates :first_name, presence: true
+  validates :last_name, presence: true
+  validates :age, presence: true
+end
+```
+
+When someone goes to create a new ```Person``` record, but forgets to enter a required field and hits the ```Create``` button,
+```PeopleController#create()``` will refuse to create the record due to failed validation.  At that point, the controller will want
+to render the ```new``` view once more, even though the ```action_name``` is ```create```.  Except this time when ```pre_render()```
+is called, the ```view``` argument will rightly be ```:new```, allowing you to do whatever is needed to ensure the view
+renders successfully.
 
 ## Credits
 
-The idea for this gem came from my time spent working as a classic ASP.NET developer.  The classic ASP.NET page event model
-also supports the notion of a ```PreRender()``` method being called right before the ```Render()``` method to allow an application's
-code-behind class to finish initialization of its properties and fields.
+The idea for this gem came from my time spent working as a classic ASP.NET developer.  The ASP.NET Page Event model supports the
+notion of a ```PreRender()``` method being called right before the ```Render()``` method to allow an application's code-behind
+class to finish initialization of its properties and fields.
 
 I found this to be useful then, as I do now in the Rails world.
 

data/lib/pre_render/version.rb

@@ -1,3 +1,3 @@
 module PreRender
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pre_render
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Nathan Brazil