require 'uri' class Object #:nodoc: # @return # # @example [].blank? #=> true # @example [1].blank? #=> false # @example [nil].blank? #=> false # # Returns true if the object is nil or empty (if applicable) def blank? nil? || (respond_to?(:empty?) && empty?) end unless method_defined?(:blank?) end # class Object class Numeric #:nodoc: # @return # # Numerics can't be blank def blank? false end unless method_defined?(:blank?) end # class Numeric class NilClass #:nodoc: # @return # # Nils are always blank def blank? true end unless method_defined?(:blank?) end # class NilClass class TrueClass #:nodoc: # @return # # True is not blank. def blank? false end unless method_defined?(:blank?) end # class TrueClass class FalseClass #:nodoc: # False is always blank. def blank? true end unless method_defined?(:blank?) end # class FalseClass class String #:nodoc: # @example "".blank? #=> true # @example " ".blank? #=> true # @example " hey ho ".blank? #=> false # # @return # # Strips out whitespace then tests if the string is empty. def blank? strip.empty? end unless method_defined?(:blank?) def snake_case return self.downcase if self =~ /^[A-Z]+$/ self.gsub(/([A-Z]+)(?=[A-Z][a-z]?)|\B[A-Z]/, '_\&') =~ /_*(.*)/ return $+.downcase end unless method_defined?(:snake_case) end # class String class Hash #:nodoc: # @return This hash as a query string # # @example # { :name => "Bob", # :address => { # :street => '111 Ruby Ave.', # :city => 'Ruby Central', # :phones => ['111-111-1111', '222-222-2222'] # } # }.to_params # #=> "name=Bob&address[city]=Ruby Central&address[phones][]=111-111-1111&address[phones][]=222-222-2222&address[street]=111 Ruby Ave." def to_params params = self.map { |k,v| normalize_param(k,v) }.join params.chop! # trailing & params end # @param key The key for the param. # @param value The value for the param. # # @return This key value pair as a param # # @example normalize_param(:name, "Bob Jones") #=> "name=Bob%20Jones&" def normalize_param(key, value) param = '' stack = [] if value.is_a?(Array) param << value.map { |element| normalize_param("#{key}[]", element) }.join elsif value.is_a?(Hash) stack << [key,value] else param << "#{key}=#{URI.encode(value.to_s, Regexp.new("[^#{URI::PATTERN::UNRESERVED}]"))}&" end stack.each do |parent, hash| hash.each do |key, value| if value.is_a?(Hash) stack << ["#{parent}[#{key}]", value] else param << normalize_param("#{parent}[#{key}]", value) end end end param end # @return The hash as attributes for an XML tag. # # @example # { :one => 1, "two"=>"TWO" }.to_xml_attributes # #=> 'one="1" two="TWO"' def to_xml_attributes map do |k,v| %{#{k.to_s.snake_case.sub(/^(.{1,1})/) { |m| m.downcase }}="#{v}"} end.join(' ') end end