Contents

module Lev

  # A utility method for calling handlers from controllers.  To use,
  # include this in your relevant controllers (or in your ApplicationController),
  # e.g.:
  #
  #   class ApplicationController
  #     include Lev::HandleWith
  #     ...
  #   end
  #
  # Then, call it from your various controller actions, e.g.:
  #
  #   handle_with(MyFormHandler,
  #               params: params,
  #               success: lambda { redirect_to 'show', notice: 'Success!'},
  #               failure: lambda { render 'new', alert: 'Error' })
  #
  # handle_with takes care of calling the handler and populates
  # a @handler_result object with the return value from the handler
  #
  # The 'success' and 'failure' lambdas are called if there aren't or are errors,
  # respectively.  Alternatively, if you supply a 'complete' lambda, that lambda
  # will be called regardless of whether there are any errors.  Inside these lambdas
  # (and inside the views they connect to), there will be the @handler_outcome 
  # variable containing the errors and results from the handler.
  #
  # Specifying 'params' is optional.  If you don't specify it, HandleWith will
  # use the entire params hash from the request.
  #
  module HandleWith
    def handle_with(handler, options)
      success_action = options.delete(:success)
      failure_action = options.delete(:failure)
      complete_action = options.delete(:complete)

      complete_action ||= lambda { render } if !(success_action || failure_action)

      options[:params]  ||= params
      options[:request] ||= request
      options[:caller] ||= current_user

      @handler_result = handler.handle(options)

      if complete_action.nil?
        @handler_result.errors.empty? ?
          success_action.call :
          failure_action.call    
      else
        complete_action.call
      end
    end
  end

end

Version data entries

4 entries across 4 versions & 1 rubygems

Version	Path
lev-2.0.2	lib/lev/handle_with.rb
lev-2.0.1	lib/lev/handle_with.rb
lev-1.0.1	lib/lev/handle_with.rb
lev-1.0.0	lib/lev/handle_with.rb