rectify 0.7.1 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0bcd5f022557ed0df7cc716ed09c8b9001c0303d
-  data.tar.gz: f021048068ca88137eb53b3b023972305f791cb5
+  metadata.gz: 2d2a653fa353d25d4303b71cddb5858ad2562355
+  data.tar.gz: 783cacad47dd54af9d9adb22afc5399214715443
 SHA512:
-  metadata.gz: 18d2d0ea2a75fd8d3b462a26be50fb6c13d0094289d5f21e427d0b9dd3ea4b67317d1e9a976e1b6aec47e0f3eef9d0506243d8e0c82dc920e955022af3241cf5
-  data.tar.gz: 38dc5dffd208fb1540b607589626711897b18ab6454e89e5f476eae477bbb87fc001c38a053a45c6feb8df88cdcb479371ce8aa5a2aee69c3bce8356c6502f39
+  metadata.gz: 7240ab43419d70d321e9000473639e3397752ed5d3dc6b8a589c86af2193b5f17dab94f7f4628f904f174a147f1500104e27f317c9f2ed85ebd408040699e305
+  data.tar.gz: b56649c7dcac2d0fbebd93fe78c1f4757afb93f0db3653d7d9143860bf5e2b3e59941b4da004ad09b328fdaeb5feae77183abb463b7ad2f9274ef7d72cd233cc

data/lib/rectify/form.rb

@@ -3,6 +3,8 @@ module Rectify
     include Virtus.model
     include ActiveModel::Validations
 
+    attr_reader :context
+
     attribute :id, Integer
 
     def self.from_params(params, additional_params = {})
@@ -102,24 +104,48 @@ module Rectify
       # some processing before validation happens (optional).
     end
 
+    def with_context(new_context)
+      @context = if new_context.is_a?(Hash)
+                   OpenStruct.new(new_context)
+                 else
+                   new_context
+                 end
+
+      attributes_that_respond_to(:with_context)
+        .each { |f| f.with_context(context) }
+
+      array_attributes_that_respond_to(:with_context)
+        .each { |f| f.with_context(context) }
+
+      self
+    end
+
     private
 
     def form_attributes_valid?
-      attributes
-        .each_value
-        .select { |f| f.respond_to?(:valid?) }
+      attributes_that_respond_to(:valid?)
         .map(&:valid?)
         .all?
     end
 
     def arrays_attributes_valid?
+      array_attributes_that_respond_to(:valid?)
+        .map(&:valid?)
+        .all?
+    end
+
+    def attributes_that_respond_to(message)
+      attributes
+        .each_value
+        .select { |f| f.respond_to?(message) }
+    end
+
+    def array_attributes_that_respond_to(message)
       attributes
         .each_value
         .select { |a| a.is_a?(Array) }
         .flatten
-        .select { |f| f.respond_to?(:valid?) }
-        .map(&:valid?)
-        .all?
+        .select { |f| f.respond_to?(message) }
     end
   end
 end

data/lib/rectify/presenter.rb

@@ -26,9 +26,7 @@ module Rectify
     end
 
     def view_context
-      @view_context ||= begin
-        controller && controller.view_context
-      end
+      @view_context ||= controller.view_context
     end
   end
 end

data/lib/rectify/version.rb

@@ -1,3 +1,3 @@
 module Rectify
-  VERSION = "0.7.1".freeze
+  VERSION = "0.8.0".freeze
 end

data/readme.md

@@ -371,6 +371,61 @@ your form as well as any (deeply) nested form objects and array attributes that
 contain form objects. There is also an `#invalid?` method that returns the
 opposite of `#valid?`.
 
+### Deep Context
+
+It's sometimes useful to have some context within your form objects when performing
+validations or some other type of data manipulation of the input. For example, you
+might want to check that the current user owns a particular resource as part of your
+validations. You could add the current user as an additional contextual option as
+the example shows above. However, sometimes you need this context to be available
+at all levels within your form not just at the root form object. You might have nested
+forms or arrays of form objects and they all might need access to this context. As
+there is no link up the chain from child to parent forms, we need a way to supply
+some context and make it available to all child forms.
+
+You can do that using the `#with_context` method.
+
+```ruby
+form = UserForm.from_params(params).with_context(:user => current_user)
+```
+
+This allows us to access `#context` in any form, and use the information within
+it when we perform validations or other work:
+
+```ruby
+class PostForm < Rectify::Form
+  attribute :blog_id, Integer
+  attribute :title,   String
+  attribute :body,    String
+  attribute :tags,    Array[TagForm]
+
+  validate :check_blog_ownership
+
+  def check_blog_ownership
+    return if context.user.blogs.exists?(:id => blog_id)
+
+    errors.add(:blog_id, "not owned by this user")
+  end
+end
+
+class TagForm < Rectify::Form
+  attribute :name,        String
+  attribute :category_id, Integer
+
+  validate :check_category
+
+  def check_category
+    return if context.user.categories.exists?(:id => category_id)
+
+    errors.add(:category_id, "not a category for this user")
+  end
+end
+```
+
+The context is passed to all nested forms within a form object to make it easy
+to perform all the validations and data conversions you might need from within
+the form object without having to do this as part of the command.
+
 ### Strong Parameters
 
 Did you notice in the example above that there was no mention of Strong

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rectify
 version: !ruby/object:Gem::Version
-  version: 0.7.1
+  version: 0.8.0
 platform: ruby
 authors:
 - Andy Pike
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-11-01 00:00:00.000000000 Z
+date: 2016-12-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: virtus