module SyncwiseApi::Inflector

Public Class Methods

camelize(term, uppercase_first_letter = true) click to toggle source

By default, camelize converts strings to UpperCamelCase. If the argument to camelize is set to :lower then camelize produces lowerCamelCase.

camelize will also convert '/' to '::' which is useful for converting paths to namespaces.

Examples:

"active_model".camelize                # => "ActiveModel"
"active_model".camelize(:lower)        # => "activeModel"
"active_model/errors".camelize         # => "ActiveModel::Errors"
"active_model/errors".camelize(:lower) # => "activeModel::Errors"

As a rule of thumb you can think of camelize as the inverse of underscore, though there are cases where that does not hold:

"SSLError".underscore.camelize # => "SslError"
# File lib/syncwise_api/ext/inflector_methods.rb, line 49
def camelize(term, uppercase_first_letter = true)
  string = term.to_s
  if uppercase_first_letter
    string = string.sub(/^[a-z\d]*/) { inflections.acronyms[$&] || $&.capitalize }
  else
    string = string.sub(/^(?:#{inflections.acronym_regex}(?=\b|[A-Z_])|\w)/) { $&.downcase }
  end
  string.gsub(/(?:_|(\/))([a-z\d]*)/i) { "#{$1}#{inflections.acronyms[$2] || $2.capitalize}" }.gsub('/', '::')
end
dehumanize(word) click to toggle source

downcase words, and replace ' ' with '_'. Example 'Big Bob'.dehumanize => 'big_bob'

# File lib/syncwise_api/ext/inflector_methods.rb, line 8
def dehumanize(word)
  # should be OK to remove the respond_to? as long as we ensure we call this only on Strings or things that can be
  # cast to Strings
  #if word.respond_to?(:to_s)
  dh_word = word.to_s.dup
  dh_word.gsub!(/ /, '_')
  dh_word.downcase!
  dh_word
  #end
end
underscore(camel_cased_word) click to toggle source
# File lib/syncwise_api/ext/inflector_methods.rb, line 19
def underscore(camel_cased_word)
  # should be OK to remove the respond_to? as long as we ensure we call this only on Strings or things that can be
  # cast to Strings
  #if camel_cased_word.respond_to?(:to_s)
  word = camel_cased_word.to_s.dup
  word.gsub!(/::/, '/')
  word.gsub!(/(?:([A-Za-z\d])|^)(#{inflections.acronym_regex})(?=\b|[^a-z])/) { "#{$1}#{$1 && '_'}#{$2.downcase}" }
  word.gsub!(/([A-Z\d]+)([A-Z][a-z])/,'\1_\2')
  word.gsub!(/([a-z\d])([A-Z])/,'\1_\2')
  word.tr!("-", "_")
  word.downcase!
  word
  #end
end

Public Instance Methods

inflections() { |instance| ... } click to toggle source

Yields a singleton instance of Inflector::Inflections so you can specify additional inflector rules.

Example:

ActiveSupport::Inflector.inflections do |inflect|
  inflect.uncountable "rails"
end
# File lib/syncwise_api/ext/inflector/inflections.rb, line 169
def inflections
  if block_given?
    yield Inflections.instance
  else
    Inflections.instance
  end
end

Private Instance Methods

camelize(term, uppercase_first_letter = true) click to toggle source

By default, camelize converts strings to UpperCamelCase. If the argument to camelize is set to :lower then camelize produces lowerCamelCase.

camelize will also convert '/' to '::' which is useful for converting paths to namespaces.

Examples:

"active_model".camelize                # => "ActiveModel"
"active_model".camelize(:lower)        # => "activeModel"
"active_model/errors".camelize         # => "ActiveModel::Errors"
"active_model/errors".camelize(:lower) # => "activeModel::Errors"

As a rule of thumb you can think of camelize as the inverse of underscore, though there are cases where that does not hold:

"SSLError".underscore.camelize # => "SslError"
# File lib/syncwise_api/ext/inflector_methods.rb, line 49
def camelize(term, uppercase_first_letter = true)
  string = term.to_s
  if uppercase_first_letter
    string = string.sub(/^[a-z\d]*/) { inflections.acronyms[$&] || $&.capitalize }
  else
    string = string.sub(/^(?:#{inflections.acronym_regex}(?=\b|[A-Z_])|\w)/) { $&.downcase }
  end
  string.gsub(/(?:_|(\/))([a-z\d]*)/i) { "#{$1}#{inflections.acronyms[$2] || $2.capitalize}" }.gsub('/', '::')
end
dehumanize(word) click to toggle source

downcase words, and replace ' ' with '_'. Example 'Big Bob'.dehumanize => 'big_bob'

# File lib/syncwise_api/ext/inflector_methods.rb, line 8
def dehumanize(word)
  # should be OK to remove the respond_to? as long as we ensure we call this only on Strings or things that can be
  # cast to Strings
  #if word.respond_to?(:to_s)
  dh_word = word.to_s.dup
  dh_word.gsub!(/ /, '_')
  dh_word.downcase!
  dh_word
  #end
end
underscore(camel_cased_word) click to toggle source
# File lib/syncwise_api/ext/inflector_methods.rb, line 19
def underscore(camel_cased_word)
  # should be OK to remove the respond_to? as long as we ensure we call this only on Strings or things that can be
  # cast to Strings
  #if camel_cased_word.respond_to?(:to_s)
  word = camel_cased_word.to_s.dup
  word.gsub!(/::/, '/')
  word.gsub!(/(?:([A-Za-z\d])|^)(#{inflections.acronym_regex})(?=\b|[^a-z])/) { "#{$1}#{$1 && '_'}#{$2.downcase}" }
  word.gsub!(/([A-Z\d]+)([A-Z][a-z])/,'\1_\2')
  word.gsub!(/([a-z\d])([A-Z])/,'\1_\2')
  word.tr!("-", "_")
  word.downcase!
  word
  #end
end