pragma-operation 1.5.0 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0d6cc18cf80b23f1275cdea3bdbdb5f898ab18bc
-  data.tar.gz: 432bbd348981310bff295afb60c4e188d6767f4d
+  metadata.gz: 9eb3cf53720469a289a53f3a93125af42f1dce5e
+  data.tar.gz: 69ef331da2c7f241928fa6328d5fd5d30574d693
 SHA512:
-  metadata.gz: 34357046619e0302eacf52f6143c72eab02324a8ce781eb1f400afcb315f06cba2ef9aa469c67a68174fb117c8d281410458c27cc078f909c57a4f4768918a1d
-  data.tar.gz: 530f950bb5901d6436edb3954ab4553483b6f4375c8f37fa36dfe5805e2595dca6885295c7d55aa3f130e911932f08ca999bebafd87e71b36ac9b5a726604312
+  metadata.gz: ebe0ec7683d681eb68b14e4b424a98dbd5454e9b051205a544d078a448bc946e8232914b98049601762d21fd5860de2ba38b7d9a50b211b07a42b82a74eb34b3
+  data.tar.gz: 68120660aae43abb27be4ac0ecc475ef97ff4956caf764fb9cef2d217500e5acb25b7452641ea735c1062714d470eeade194277a5587631ca58a077fb3dc3faa

data/doc/02-contracts.md

@@ -113,3 +113,42 @@ module API
   end
 end
 ```
+
+If you want to run some logic after validation, you can override the `#after_validation` method
+in your operation. It takes the result of the validation as its first argument:
+
+```ruby
+module API
+  module V1
+    module Post
+      module Operation
+        class Create < Pragma::Operation::Base
+          contract API::V1::Post::Contract::Create
+
+          def call
+            post = Post.new
+            contract = build_contract(post)
+
+            unless validate(contract)
+              respond_with!(
+                status: :unprocessable_entity,
+                resource: nil
+              )
+            end
+
+            contract.save
+
+            respond_with status: :created, resource: post
+          end
+
+          protected
+
+          def after_validation(result)
+            # ...
+          end
+        end
+      end
+    end
+  end
+end
+```

data/doc/03-policies.md

@@ -115,6 +115,44 @@ module API
 end
 ```
 
+If you want to run some logic after authorization, you can override the `#after_authorization` method
+in your operation. It takes the result of the authorization as its first argument:
+
+```ruby
+module API
+  module V1
+    module Post
+      module Operation
+        class Create < Pragma::Operation::Base
+          policy API::V1::Post::Policy
+
+          def call
+            post = Post.new(params)
+
+            unless authorize(post)
+              respond_with!(
+                status: :forbidden,
+                resource: nil # if you don't need error info
+              )
+            end
+
+            post.save!
+
+            respond_with status: :created, resource: post
+          end
+
+          protected
+
+          def after_authorization(result)
+            # ...
+          end
+        end
+      end
+    end
+  end
+end
+```
+
 ## Authorizing collections
 
 To authorize a collection, use `#authorize_collection`. This will call `.accessible_by` on the

data/lib/pragma/operation/authorization.rb

@@ -73,7 +73,9 @@ module Pragma
             policy.resource.send("#{name}=", value)
           end
 
-          policy.send("#{self.class.operation_name}?")
+          policy.send("#{self.class.operation_name}?").tap do |result|
+            after_authorization result
+          end
         end
 
         # Authorizes this operation on the provided resource or policy. If the user is not
@@ -93,6 +95,12 @@ module Pragma
           )
         end
 
+        # Runs after authorization is done.
+        #
+        # @param result [Boolean] the result of the authorization
+        def after_authorization(result)
+        end
+
         # Scopes the provided collection.
         #
         # If no policy class is defined, simply returns the collection.

data/lib/pragma/operation/validation.rb

@@ -72,6 +72,8 @@ module Pragma
             contract.validate(params)
           else
             contract.respond_to?(:validate) ? contract.validate : true
+          end.tap do |result|
+            after_validation(result)
           end
         end
 
@@ -91,6 +93,12 @@ module Pragma
           respond_with_validation_errors!(contract) unless validate(contract)
         end
 
+        # Runs after validation is done.
+        #
+        # @param result [Boolean] the result of the validation
+        def after_validation(result)
+        end
+
         # Sets a response suitable for reporting validation errors.
         #
         # The response will be a 422 Unprocessable Entity, contain the +error_type+, +error_message+

data/lib/pragma/operation/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 module Pragma
   module Operation
-    VERSION = '1.5.0'
+    VERSION = '1.6.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pragma-operation
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.6.0
 platform: ruby
 authors:
 - Alessandro Desantis
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-01-19 00:00:00.000000000 Z
+date: 2017-01-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: interactor