Module: Rabl::Helpers
- Included in:
- Partials
- Defined in:
- lib/rabl/helpers.rb
Instance Method Summary collapse
-
#collection_root_name ⇒ Object
Returns the root for the collection Sets the name of the collection i.e “people” => { “people” : [] }.
-
#context_scope ⇒ Object
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.
-
#data_name(data) ⇒ Object
data_name(data) => “user” data_name(@user => :person) => :person data_name(@users) => :user data_name() => “users” data_name([]) => “array”.
-
#data_object(data) ⇒ Object
data_object(data) => <AR Object> data_object(@user => :person) => @user data_object(:user => :person) => @_object.send(:user).
-
#data_object_attribute(data) ⇒ Object
data_object_attribute(data) => @_object.send(data).
-
#determine_object_root(data, include_root = true) ⇒ Object
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, true) => “user” determine_object_root(@user => :person) => “person” determine_object_root([@user, @user]) => “user”.
-
#escape_output(data) ⇒ Object
Escape output if configured and supported.
-
#fetch_result_from_cache(cache_key, cache_options = nil, &block) ⇒ Object
Fetches a key from the cache and stores rabl template result otherwise fetch_from_cache(‘some_key’) { …rabl template result… }.
-
#is_collection?(obj) ⇒ Boolean
Returns true if the obj is a collection of items.
-
#is_object?(obj) ⇒ Boolean
Returns true if obj is not a collection is_object?(@user) => true is_object?([]) => false is_object?({}) => false.
-
#object_root_name ⇒ Object
Returns the root (if any) name for an object within a collection Sets the name of the object i.e “person” => { “users” : [{ “person” : {} }] }.
-
#template_cache_configured? ⇒ Boolean
Returns true if the cache has been enabled for the application.
Instance Method Details
#collection_root_name ⇒ Object
Returns the root for the collection Sets the name of the collection i.e “people”
=> { "people" : [] }
82 83 84 |
# File 'lib/rabl/helpers.rb', line 82 def collection_root_name defined?(@_collection_name) ? @_collection_name : nil end |
#context_scope ⇒ Object
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
68 69 70 |
# File 'lib/rabl/helpers.rb', line 68 def context_scope defined?(@_scope) ? @_scope : nil end |
#data_name(data) ⇒ Object
data_name(data) => “user” data_name(@user => :person) => :person data_name(@users) => :user data_name() => “users” data_name([]) => “array”
24 25 26 27 28 29 30 31 32 33 34 35 36 |
# File 'lib/rabl/helpers.rb', line 24 def data_name(data) return nil unless data # nil or false return data.values.first if data.is_a?(Hash) # @user => :user data = @_object.__send__(data) if data.is_a?(Symbol) && @_object # :address if is_collection?(data) && data.respond_to?(:first) # data collection data_name(data.first).to_s.pluralize if data.first.present? elsif is_object?(data) # actual data object object_name = object_root_name if object_root_name 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) ⇒ Object
data_object(data) => <AR Object> data_object(@user => :person) => @user data_object(:user => :person) => @_object.send(:user)
9 10 11 12 |
# File 'lib/rabl/helpers.rb', line 9 def data_object(data) data = (data.is_a?(Hash) && data.keys.size == 1) ? data.keys.first : data data.is_a?(Symbol) && @_object ? @_object.__send__(data) : data end |
#data_object_attribute(data) ⇒ Object
data_object_attribute(data) => @_object.send(data)
15 16 17 |
# File 'lib/rabl/helpers.rb', line 15 def data_object_attribute(data) escape_output @_object.__send__(data) end |
#determine_object_root(data, include_root = true) ⇒ Object
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, true) => “user” determine_object_root(@user => :person) => “person” determine_object_root([@user, @user]) => “user”
43 44 45 46 47 48 49 50 51 |
# File 'lib/rabl/helpers.rb', line 43 def determine_object_root(data, include_root=true) return if object_root_name == false root_name = data_name(data).to_s if include_root if is_object?(data) root_name elsif is_collection?(data) object_root_name || (root_name.singularize if root_name) end end |
#escape_output(data) ⇒ Object
Escape output if configured and supported
99 100 101 |
# File 'lib/rabl/helpers.rb', line 99 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) ⇒ Object
Fetches a key from the cache and stores rabl template result otherwise fetch_from_cache(‘some_key’) { …rabl template result… }
88 89 90 91 |
# File 'lib/rabl/helpers.rb', line 88 def fetch_result_from_cache(cache_key, =nil, &block) = ActiveSupport::Cache.(cache_key, :rabl) Rails.cache.fetch(, , &block) if defined?(Rails) end |
#is_collection?(obj) ⇒ Boolean
Returns true if the obj is a collection of items
62 63 64 |
# File 'lib/rabl/helpers.rb', line 62 def is_collection?(obj) obj && data_object(obj).respond_to?(:map) && data_object(obj).respond_to?(:each) end |
#is_object?(obj) ⇒ Boolean
Returns true if obj is not a collection is_object?(@user) => true is_object?([]) => false is_object?({}) => false
57 58 59 |
# File 'lib/rabl/helpers.rb', line 57 def is_object?(obj) obj && (!data_object(obj).respond_to?(:map) || !data_object(obj).respond_to?(:each)) end |
#object_root_name ⇒ Object
Returns the root (if any) name for an object within a collection Sets the name of the object i.e “person”
> { “users” : [{ “person” : {} }] }
75 76 77 |
# File 'lib/rabl/helpers.rb', line 75 def object_root_name defined?(@_object_root_name) ? @_object_root_name : nil end |
#template_cache_configured? ⇒ Boolean
Returns true if the cache has been enabled for the application
94 95 96 |
# File 'lib/rabl/helpers.rb', line 94 def template_cache_configured? defined?(Rails) && defined?(ActionController::Base) && ActionController::Base.perform_caching end |