Contents

require "active_support/concern"
require "active_support/hash_with_indifferent_access"

module Machined
  module Helpers
    module LocalsHelpers
      extend ActiveSupport::Concern
      
      # Returns the locals hash. It's actually an instance
      # of `ActiveSupport::HashWithIndifferentAccess`, so strings
      # and symbols can be used interchangeably.
      def locals
        @locals ||= ActiveSupport::HashWithIndifferentAccess.new
      end
      
      # Adds psuedo local variables from the given hash, where
      # the key is the name of the variable. This is provided so
      # processors can add local variables without having access
      # to the next processor or template.
      def locals=(locals)
        if locals.nil?
          @locals = nil
        else
          self.locals.merge! locals
        end
      end
      
      # Temporarily changes the locals. The given +temporary_locals+
      # will be merged into the current locals. After the block is
      # executed, the locals will be restored to their original state.
      def with_locals(temporary_locals)
        old_locals, self.locals = self.locals.dup, temporary_locals
        yield
      ensure
        @locals = old_locals
      end
      
      # Returns true if the given +name+ has been set as a local
      # variable.
      def has_local?(name)
        locals.key? name
      end
      
      def method_missing(method, *args, &block) # :nodoc:
        if args.empty? && has_local?(method)
          locals[method]
        else
          super
        end
      end
      
      def respond_to?(method) # :nodoc:
        super or has_local?(method)
      end
    end
  end
end

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
machined-0.2.2	lib/machined/helpers/locals_helpers.rb
machined-0.2.1	lib/machined/helpers/locals_helpers.rb
machined-0.2.0	lib/machined/helpers/locals_helpers.rb