require 'time' # Copyright (c) 2008 Sam Smoot. # # Permission is hereby granted, free of charge, to any person obtaining # a copy of this software and associated documentation files (the # "Software"), to deal in the Software without restriction, including # without limitation the rights to use, copy, modify, merge, publish, # distribute, sublicense, and/or sell copies of the Software, and to # permit persons to whom the Software is furnished to do so, subject to # the following conditions: # # The above copyright notice and this permission notice shall be # included in all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, # EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF # MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND # NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE # LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 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 end