module Rabl::Helpers

Constants

KNOWN_OBJECT_CLASSES

Set of class names known to be objects, not collections

Public Instance Methods

collection_root_name() click to toggle source

Returns the root for the collection Sets the name of the collection i.e “people”

=> { "people" : [] }
# File lib/rabl/helpers.rb, line 91
def collection_root_name
  defined?(@_collection_name) ? @_collection_name : nil
end
context_scope() click to toggle source

Returns the scope wrapping this engine, used for retrieving data, invoking methods, etc In Rails, this is the controller and in Padrino this is the request context

# File lib/rabl/helpers.rb, line 77
def context_scope
  defined?(@_scope) ? @_scope : nil
end
data_name(data_token) click to toggle source

#data_name(data) => “user” #data_name(@user => :person) => :person #data_name(@users) => :user user“>data_name( at #data_name([]) => ”array“

# File lib/rabl/helpers.rb, line 26
def data_name(data_token)
  return unless data_token # nil or false
  return data_token.values.first if data_token.is_a?(Hash) # @user => :user
  data = data_object(data_token)
  if is_collection?(data) && data.respond_to?(:first) # data is a collection
    object_name = data_name(data.first).to_s.pluralize if data.first.present?
    object_name ||= data_token if data_token.is_a?(Symbol)
    object_name
  elsif is_object?(data) # data is an object
    object_name = object_root_name if object_root_name
    object_name ||= data if data.is_a?(Symbol)
    object_name ||= collection_root_name.to_s.singularize if collection_root_name
    object_name ||= data.class.respond_to?(:model_name) ? data.class.model_name.element : data.class.to_s.downcase
    object_name
  end
end
data_object(data) click to toggle source

#data_object(data) => <AR Object> #data_object(@user => :person) => @user #data_object(:user => :person) => @_object.send(:user)

# File lib/rabl/helpers.rb, line 11
def data_object(data)
  data = (data.is_a?(Hash) && data.keys.size == 1) ? data.keys.first : data
  data.is_a?(Symbol) && defined?(@_object) && @_object ? @_object.__send__(data) : data
end
data_object_attribute(data) click to toggle source

#data_object_attribute(data) => @_object.send(data)

# File lib/rabl/helpers.rb, line 17
def data_object_attribute(data)
  escape_output @_object.__send__(data)
end
determine_object_root(data_token, data_name=nil, include_root=true) click to toggle source

Returns the object rootname based on if the root should be included Can be called with data as a collection or object #determine_object_root(@user, :user, true) => “user” #determine_object_root(@user, :person) => “person” #determine_object_root([@user, @user]) => “user”

# File lib/rabl/helpers.rb, line 48
def determine_object_root(data_token, data_name=nil, include_root=true)
  return if object_root_name == false
  root_name = data_name.to_s if include_root
  if is_object?(data_token)
    root_name
  elsif is_collection?(data_token)
    object_root_name || (root_name.singularize if root_name)
  end
end
escape_output(data) click to toggle source

Escape output if configured and supported

# File lib/rabl/helpers.rb, line 112
def escape_output(data)
  (data && defined?(ERB::Util.h) && Rabl.configuration.escape_all_output) ? ERB::Util.h(data) : data
end
fetch_result_from_cache(cache_key, cache_options=nil, &block) click to toggle source

Fetches a key from the cache and stores rabl template result otherwise fetch_from_cache('some_key') { …rabl template result… }

# File lib/rabl/helpers.rb, line 97
def fetch_result_from_cache(cache_key, cache_options=nil, &block)
  expanded_cache_key = ActiveSupport::Cache.expand_cache_key(cache_key, :rabl)
  Rabl.configuration.cache_engine.fetch(expanded_cache_key, cache_options, &block)
end
is_collection?(obj) click to toggle source

Returns true if the obj is a collection of items is_collection?(@user) => false is_collection?([]) => true

# File lib/rabl/helpers.rb, line 70
def is_collection?(obj)
  obj && data_object(obj).respond_to?(:map) && data_object(obj).respond_to?(:each) &&
    (KNOWN_OBJECT_CLASSES & obj.class.ancestors.map(&:name)).empty?
end
is_object?(obj) click to toggle source

Returns true if obj is not a collection is_object?(@user) => true is_object?([]) => false is_object?({}) => false

# File lib/rabl/helpers.rb, line 62
def is_object?(obj)
  obj && (!data_object(obj).respond_to?(:map) || !data_object(obj).respond_to?(:each) ||
   (KNOWN_OBJECT_CLASSES & obj.class.ancestors.map(&:name)).any?)
end
object_root_name() click to toggle source

Returns the root (if any) name for an object within a collection Sets the name of the object i.e “person”

> { “users” : [{ “person” : {} }] }

# File lib/rabl/helpers.rb, line 84
def object_root_name
  defined?(@_object_root_name) ? @_object_root_name : nil
end
template_cache_configured?() click to toggle source

Returns true if the cache has been enabled for the application

# File lib/rabl/helpers.rb, line 103
def template_cache_configured?
  if defined?(Rails)
    defined?(ActionController::Base) && ActionController::Base.perform_caching
  else
    Rabl.configuration.perform_caching
  end
end