mirror of
https://github.com/rails/rails.git
synced 2022-11-09 12:12:34 -05:00
update AS/inflector docs [ci skip]
This commit is contained in:
parent
8673c2eefb
commit
5ea3f284a4
3 changed files with 167 additions and 142 deletions
|
@ -5,9 +5,10 @@ module ActiveSupport
|
||||||
module Inflector
|
module Inflector
|
||||||
extend self
|
extend self
|
||||||
|
|
||||||
# A singleton instance of this class is yielded by Inflector.inflections, which can then be used to specify additional
|
# A singleton instance of this class is yielded by Inflector.inflections,
|
||||||
# inflection rules. If passed an optional locale, rules for other languages can be specified. The default locale is
|
# which can then be used to specify additional inflection rules. If passed
|
||||||
# <tt>:en</tt>. Only rules for English are provided.
|
# an optional locale, rules for other languages can be specified. The
|
||||||
|
# default locale is <tt>:en</tt>. Only rules for English are provided.
|
||||||
#
|
#
|
||||||
# ActiveSupport::Inflector.inflections(:en) do |inflect|
|
# ActiveSupport::Inflector.inflections(:en) do |inflect|
|
||||||
# inflect.plural /^(ox)$/i, '\1\2en'
|
# inflect.plural /^(ox)$/i, '\1\2en'
|
||||||
|
@ -15,12 +16,13 @@ module ActiveSupport
|
||||||
#
|
#
|
||||||
# inflect.irregular 'octopus', 'octopi'
|
# inflect.irregular 'octopus', 'octopi'
|
||||||
#
|
#
|
||||||
# inflect.uncountable "equipment"
|
# inflect.uncountable 'equipment'
|
||||||
# end
|
# end
|
||||||
#
|
#
|
||||||
# New rules are added at the top. So in the example above, the irregular rule for octopus will now be the first of the
|
# New rules are added at the top. So in the example above, the irregular
|
||||||
# pluralization and singularization rules that is runs. This guarantees that your rules run before any of the rules that may
|
# rule for octopus will now be the first of the pluralization and
|
||||||
# already have been loaded.
|
# singularization rules that is runs. This guarantees that your rules run
|
||||||
|
# before any of the rules that may already have been loaded.
|
||||||
class Inflections
|
class Inflections
|
||||||
def self.instance(locale = :en)
|
def self.instance(locale = :en)
|
||||||
@__instance__ ||= Hash.new { |h, k| h[k] = new }
|
@__instance__ ||= Hash.new { |h, k| h[k] = new }
|
||||||
|
@ -34,36 +36,40 @@ module ActiveSupport
|
||||||
end
|
end
|
||||||
|
|
||||||
# Private, for the test suite.
|
# Private, for the test suite.
|
||||||
def initialize_dup(orig)
|
def initialize_dup(orig) # :nodoc:
|
||||||
%w(plurals singulars uncountables humans acronyms acronym_regex).each do |scope|
|
%w(plurals singulars uncountables humans acronyms acronym_regex).each do |scope|
|
||||||
instance_variable_set("@#{scope}", orig.send(scope).dup)
|
instance_variable_set("@#{scope}", orig.send(scope).dup)
|
||||||
end
|
end
|
||||||
end
|
end
|
||||||
|
|
||||||
# Specifies a new acronym. An acronym must be specified as it will appear in a camelized string. An underscore
|
# Specifies a new acronym. An acronym must be specified as it will appear
|
||||||
# string that contains the acronym will retain the acronym when passed to `camelize`, `humanize`, or `titleize`.
|
# in a camelized string. An underscore string that contains the acronym
|
||||||
# A camelized string that contains the acronym will maintain the acronym when titleized or humanized, and will
|
# will retain the acronym when passed to +camelize+, +humanize+, or
|
||||||
# convert the acronym into a non-delimited single lowercase word when passed to +underscore+.
|
# +titleize+. A camelized string that contains the acronym will maintain
|
||||||
|
# the acronym when titleized or humanized, and will convert the acronym
|
||||||
|
# into a non-delimited single lowercase word when passed to +underscore+.
|
||||||
#
|
#
|
||||||
# acronym 'HTML'
|
# acronym 'HTML'
|
||||||
# titleize 'html' #=> 'HTML'
|
# titleize 'html' #=> 'HTML'
|
||||||
# camelize 'html' #=> 'HTML'
|
# camelize 'html' #=> 'HTML'
|
||||||
# underscore 'MyHTML' #=> 'my_html'
|
# underscore 'MyHTML' #=> 'my_html'
|
||||||
#
|
#
|
||||||
# The acronym, however, must occur as a delimited unit and not be part of another word for conversions to recognize it:
|
# The acronym, however, must occur as a delimited unit and not be part of
|
||||||
|
# another word for conversions to recognize it:
|
||||||
#
|
#
|
||||||
# acronym 'HTTP'
|
# acronym 'HTTP'
|
||||||
# camelize 'my_http_delimited' #=> 'MyHTTPDelimited'
|
# camelize 'my_http_delimited' #=> 'MyHTTPDelimited'
|
||||||
# camelize 'https' #=> 'Https', not 'HTTPs'
|
# camelize 'https' #=> 'Https', not 'HTTPs'
|
||||||
# underscore 'HTTPS' #=> 'http_s', not 'https'
|
# underscore 'HTTPS' #=> 'http_s', not 'https'
|
||||||
#
|
#
|
||||||
# acronym 'HTTPS'
|
# acronym 'HTTPS'
|
||||||
# camelize 'https' #=> 'HTTPS'
|
# camelize 'https' #=> 'HTTPS'
|
||||||
# underscore 'HTTPS' #=> 'https'
|
# underscore 'HTTPS' #=> 'https'
|
||||||
#
|
#
|
||||||
# Note: Acronyms that are passed to `pluralize` will no longer be recognized, since the acronym will not occur as
|
# Note: Acronyms that are passed to +pluralize+ will no longer be
|
||||||
# a delimited unit in the pluralized result. To work around this, you must specify the pluralized form as an
|
# recognized, since the acronym will not occur as a delimited unit in the
|
||||||
# acronym as well:
|
# pluralized result. To work around this, you must specify the pluralized
|
||||||
|
# form as an acronym as well:
|
||||||
#
|
#
|
||||||
# acronym 'API'
|
# acronym 'API'
|
||||||
# camelize(pluralize('api')) #=> 'Apis'
|
# camelize(pluralize('api')) #=> 'Apis'
|
||||||
|
@ -71,42 +77,49 @@ module ActiveSupport
|
||||||
# acronym 'APIs'
|
# acronym 'APIs'
|
||||||
# camelize(pluralize('api')) #=> 'APIs'
|
# camelize(pluralize('api')) #=> 'APIs'
|
||||||
#
|
#
|
||||||
# `acronym` may be used to specify any word that contains an acronym or otherwise needs to maintain a non-standard
|
# +acronym+ may be used to specify any word that contains an acronym or
|
||||||
# capitalization. The only restriction is that the word must begin with a capital letter.
|
# otherwise needs to maintain a non-standard capitalization. The only
|
||||||
|
# restriction is that the word must begin with a capital letter.
|
||||||
#
|
#
|
||||||
# acronym 'RESTful'
|
# acronym 'RESTful'
|
||||||
# underscore 'RESTful' #=> 'restful'
|
# underscore 'RESTful' #=> 'restful'
|
||||||
# underscore 'RESTfulController' #=> 'restful_controller'
|
# underscore 'RESTfulController' #=> 'restful_controller'
|
||||||
# titleize 'RESTfulController' #=> 'RESTful Controller'
|
# titleize 'RESTfulController' #=> 'RESTful Controller'
|
||||||
# camelize 'restful' #=> 'RESTful'
|
# camelize 'restful' #=> 'RESTful'
|
||||||
# camelize 'restful_controller' #=> 'RESTfulController'
|
# camelize 'restful_controller' #=> 'RESTfulController'
|
||||||
#
|
#
|
||||||
# acronym 'McDonald'
|
# acronym 'McDonald'
|
||||||
# underscore 'McDonald' #=> 'mcdonald'
|
# underscore 'McDonald' #=> 'mcdonald'
|
||||||
# camelize 'mcdonald' #=> 'McDonald'
|
# camelize 'mcdonald' #=> 'McDonald'
|
||||||
def acronym(word)
|
def acronym(word)
|
||||||
@acronyms[word.downcase] = word
|
@acronyms[word.downcase] = word
|
||||||
@acronym_regex = /#{@acronyms.values.join("|")}/
|
@acronym_regex = /#{@acronyms.values.join("|")}/
|
||||||
end
|
end
|
||||||
|
|
||||||
# Specifies a new pluralization rule and its replacement. The rule can either be a string or a regular expression.
|
# Specifies a new pluralization rule and its replacement. The rule can
|
||||||
# The replacement should always be a string that may include references to the matched data from the rule.
|
# either be a string or a regular expression. The replacement should
|
||||||
|
# always be a string that may include references to the matched data from
|
||||||
|
# the rule.
|
||||||
def plural(rule, replacement)
|
def plural(rule, replacement)
|
||||||
@uncountables.delete(rule) if rule.is_a?(String)
|
@uncountables.delete(rule) if rule.is_a?(String)
|
||||||
@uncountables.delete(replacement)
|
@uncountables.delete(replacement)
|
||||||
@plurals.prepend([rule, replacement])
|
@plurals.prepend([rule, replacement])
|
||||||
end
|
end
|
||||||
|
|
||||||
# Specifies a new singularization rule and its replacement. The rule can either be a string or a regular expression.
|
# Specifies a new singularization rule and its replacement. The rule can
|
||||||
# The replacement should always be a string that may include references to the matched data from the rule.
|
# either be a string or a regular expression. The replacement should
|
||||||
|
# always be a string that may include references to the matched data from
|
||||||
|
# the rule.
|
||||||
def singular(rule, replacement)
|
def singular(rule, replacement)
|
||||||
@uncountables.delete(rule) if rule.is_a?(String)
|
@uncountables.delete(rule) if rule.is_a?(String)
|
||||||
@uncountables.delete(replacement)
|
@uncountables.delete(replacement)
|
||||||
@singulars.prepend([rule, replacement])
|
@singulars.prepend([rule, replacement])
|
||||||
end
|
end
|
||||||
|
|
||||||
# Specifies a new irregular that applies to both pluralization and singularization at the same time. This can only be used
|
# Specifies a new irregular that applies to both pluralization and
|
||||||
# for strings, not regular expressions. You simply pass the irregular in singular and plural form.
|
# singularization at the same time. This can only be used for strings, not
|
||||||
|
# regular expressions. You simply pass the irregular in singular and
|
||||||
|
# plural form.
|
||||||
#
|
#
|
||||||
# irregular 'octopus', 'octopi'
|
# irregular 'octopus', 'octopi'
|
||||||
# irregular 'person', 'people'
|
# irregular 'person', 'people'
|
||||||
|
@ -129,26 +142,29 @@ module ActiveSupport
|
||||||
|
|
||||||
# Add uncountable words that shouldn't be attempted inflected.
|
# Add uncountable words that shouldn't be attempted inflected.
|
||||||
#
|
#
|
||||||
# uncountable "money"
|
# uncountable 'money'
|
||||||
# uncountable "money", "information"
|
# uncountable 'money', 'information'
|
||||||
# uncountable %w( money information rice )
|
# uncountable %w( money information rice )
|
||||||
def uncountable(*words)
|
def uncountable(*words)
|
||||||
(@uncountables << words).flatten!
|
(@uncountables << words).flatten!
|
||||||
end
|
end
|
||||||
|
|
||||||
# Specifies a humanized form of a string by a regular expression rule or by a string mapping.
|
# Specifies a humanized form of a string by a regular expression rule or
|
||||||
# When using a regular expression based replacement, the normal humanize formatting is called after the replacement.
|
# by a string mapping. When using a regular expression based replacement,
|
||||||
# When a string is used, the human form should be specified as desired (example: 'The name', not 'the_name')
|
# the normal humanize formatting is called after the replacement. When a
|
||||||
|
# string is used, the human form should be specified as desired (example:
|
||||||
|
# 'The name', not 'the_name').
|
||||||
#
|
#
|
||||||
# human /_cnt$/i, '\1_count'
|
# human /_cnt$/i, '\1_count'
|
||||||
# human "legacy_col_person_name", "Name"
|
# human 'legacy_col_person_name', 'Name'
|
||||||
def human(rule, replacement)
|
def human(rule, replacement)
|
||||||
@humans.prepend([rule, replacement])
|
@humans.prepend([rule, replacement])
|
||||||
end
|
end
|
||||||
|
|
||||||
# Clears the loaded inflections within a given scope (default is <tt>:all</tt>).
|
# Clears the loaded inflections within a given scope (default is
|
||||||
# Give the scope as a symbol of the inflection type, the options are: <tt>:plurals</tt>,
|
# <tt>:all</tt>). Give the scope as a symbol of the inflection type, the
|
||||||
# <tt>:singulars</tt>, <tt>:uncountables</tt>, <tt>:humans</tt>.
|
# options are: <tt>:plurals</tt>, <tt>:singulars</tt>, <tt>:uncountables</tt>,
|
||||||
|
# <tt>:humans</tt>.
|
||||||
#
|
#
|
||||||
# clear :all
|
# clear :all
|
||||||
# clear :plurals
|
# clear :plurals
|
||||||
|
@ -162,13 +178,13 @@ module ActiveSupport
|
||||||
end
|
end
|
||||||
end
|
end
|
||||||
|
|
||||||
# Yields a singleton instance of Inflector::Inflections so you can specify additional
|
# Yields a singleton instance of Inflector::Inflections so you can specify
|
||||||
# inflector rules. If passed an optional locale, rules for other languages can be specified.
|
# additional inflector rules. If passed an optional locale, rules for other
|
||||||
# If not specified, defaults to <tt>:en</tt>. Only rules for English are provided.
|
# languages can be specified. If not specified, defaults to <tt>:en</tt>.
|
||||||
#
|
# Only rules for English are provided.
|
||||||
#
|
#
|
||||||
# ActiveSupport::Inflector.inflections(:en) do |inflect|
|
# ActiveSupport::Inflector.inflections(:en) do |inflect|
|
||||||
# inflect.uncountable "rails"
|
# inflect.uncountable 'rails'
|
||||||
# end
|
# end
|
||||||
def inflections(locale = :en)
|
def inflections(locale = :en)
|
||||||
if block_given?
|
if block_given?
|
||||||
|
|
|
@ -4,14 +4,16 @@ require 'active_support/inflector/inflections'
|
||||||
require 'active_support/inflections'
|
require 'active_support/inflections'
|
||||||
|
|
||||||
module ActiveSupport
|
module ActiveSupport
|
||||||
# The Inflector transforms words from singular to plural, class names to table names, modularized class names to ones without,
|
# The Inflector transforms words from singular to plural, class names to table
|
||||||
# and class names to foreign keys. The default inflections for pluralization, singularization, and uncountable words are kept
|
# names, modularized class names to ones without, and class names to foreign
|
||||||
# in inflections.rb.
|
# keys. The default inflections for pluralization, singularization, and
|
||||||
|
# uncountable words are kept in inflections.rb.
|
||||||
#
|
#
|
||||||
# The Rails core team has stated patches for the inflections library will not be accepted
|
# The Rails core team has stated patches for the inflections library will not
|
||||||
# in order to avoid breaking legacy applications which may be relying on errant inflections.
|
# be accepted in order to avoid breaking legacy applications which may be
|
||||||
# If you discover an incorrect inflection and require it for your application or wish to
|
# relying on errant inflections. If you discover an incorrect inflection and
|
||||||
# define rules for languages other than English, please correct or add them yourself (explained below).
|
# require it for your application or wish to define rules for languages other
|
||||||
|
# than English, please correct or add them yourself (explained below).
|
||||||
module Inflector
|
module Inflector
|
||||||
extend self
|
extend self
|
||||||
|
|
||||||
|
@ -21,46 +23,49 @@ module ActiveSupport
|
||||||
# pluralized using rules defined for that language. By default,
|
# pluralized using rules defined for that language. By default,
|
||||||
# this parameter is set to <tt>:en</tt>.
|
# this parameter is set to <tt>:en</tt>.
|
||||||
#
|
#
|
||||||
# "post".pluralize # => "posts"
|
# 'post'.pluralize # => "posts"
|
||||||
# "octopus".pluralize # => "octopi"
|
# 'octopus'.pluralize # => "octopi"
|
||||||
# "sheep".pluralize # => "sheep"
|
# 'sheep'.pluralize # => "sheep"
|
||||||
# "words".pluralize # => "words"
|
# 'words'.pluralize # => "words"
|
||||||
# "CamelOctopus".pluralize # => "CamelOctopi"
|
# 'CamelOctopus'.pluralize # => "CamelOctopi"
|
||||||
# "ley".pluralize(:es) # => "leyes"
|
# 'ley'.pluralize(:es) # => "leyes"
|
||||||
def pluralize(word, locale = :en)
|
def pluralize(word, locale = :en)
|
||||||
apply_inflections(word, inflections(locale).plurals)
|
apply_inflections(word, inflections(locale).plurals)
|
||||||
end
|
end
|
||||||
|
|
||||||
# The reverse of +pluralize+, returns the singular form of a word in a string.
|
# The reverse of +pluralize+, returns the singular form of a word in a
|
||||||
|
# string.
|
||||||
#
|
#
|
||||||
# If passed an optional +locale+ parameter, the word will be
|
# If passed an optional +locale+ parameter, the word will be
|
||||||
# pluralized using rules defined for that language. By default,
|
# pluralized using rules defined for that language. By default,
|
||||||
# this parameter is set to <tt>:en</tt>.
|
# this parameter is set to <tt>:en</tt>.
|
||||||
#
|
#
|
||||||
# "posts".singularize # => "post"
|
# 'posts'.singularize # => "post"
|
||||||
# "octopi".singularize # => "octopus"
|
# 'octopi'.singularize # => "octopus"
|
||||||
# "sheep".singularize # => "sheep"
|
# 'sheep'.singularize # => "sheep"
|
||||||
# "word".singularize # => "word"
|
# 'word'.singularize # => "word"
|
||||||
# "CamelOctopi".singularize # => "CamelOctopus"
|
# 'CamelOctopi'.singularize # => "CamelOctopus"
|
||||||
# "leyes".singularize(:es) # => "ley"
|
# 'leyes'.singularize(:es) # => "ley"
|
||||||
def singularize(word, locale = :en)
|
def singularize(word, locale = :en)
|
||||||
apply_inflections(word, inflections(locale).singulars)
|
apply_inflections(word, inflections(locale).singulars)
|
||||||
end
|
end
|
||||||
|
|
||||||
# By default, +camelize+ converts strings to UpperCamelCase. If the argument to +camelize+
|
# By default, +camelize+ converts strings to UpperCamelCase. If the argument
|
||||||
# is set to <tt>:lower</tt> then +camelize+ produces lowerCamelCase.
|
# to +camelize+ is set to <tt>:lower</tt> then +camelize+ produces
|
||||||
|
# lowerCamelCase.
|
||||||
#
|
#
|
||||||
# +camelize+ will also convert '/' to '::' which is useful for converting paths to namespaces.
|
# +camelize+ will also convert '/' to '::' which is useful for converting
|
||||||
|
# paths to namespaces.
|
||||||
#
|
#
|
||||||
# "active_model".camelize # => "ActiveModel"
|
# 'active_model'.camelize # => "ActiveModel"
|
||||||
# "active_model".camelize(:lower) # => "activeModel"
|
# 'active_model'.camelize(:lower) # => "activeModel"
|
||||||
# "active_model/errors".camelize # => "ActiveModel::Errors"
|
# 'active_model/errors'.camelize # => "ActiveModel::Errors"
|
||||||
# "active_model/errors".camelize(:lower) # => "activeModel::Errors"
|
# 'active_model/errors'.camelize(:lower) # => "activeModel::Errors"
|
||||||
#
|
#
|
||||||
# As a rule of thumb you can think of +camelize+ as the inverse of +underscore+,
|
# As a rule of thumb you can think of +camelize+ as the inverse of
|
||||||
# though there are cases where that does not hold:
|
# +underscore+, though there are cases where that does not hold:
|
||||||
#
|
#
|
||||||
# "SSLError".underscore.camelize # => "SslError"
|
# 'SSLError'.underscore.camelize # => "SslError"
|
||||||
def camelize(term, uppercase_first_letter = true)
|
def camelize(term, uppercase_first_letter = true)
|
||||||
string = term.to_s
|
string = term.to_s
|
||||||
if uppercase_first_letter
|
if uppercase_first_letter
|
||||||
|
@ -75,13 +80,13 @@ module ActiveSupport
|
||||||
#
|
#
|
||||||
# Changes '::' to '/' to convert namespaces to paths.
|
# Changes '::' to '/' to convert namespaces to paths.
|
||||||
#
|
#
|
||||||
# "ActiveModel".underscore # => "active_model"
|
# 'ActiveModel'.underscore # => "active_model"
|
||||||
# "ActiveModel::Errors".underscore # => "active_model/errors"
|
# 'ActiveModel::Errors'.underscore # => "active_model/errors"
|
||||||
#
|
#
|
||||||
# As a rule of thumb you can think of +underscore+ as the inverse of +camelize+,
|
# As a rule of thumb you can think of +underscore+ as the inverse of
|
||||||
# though there are cases where that does not hold:
|
# +camelize+, though there are cases where that does not hold:
|
||||||
#
|
#
|
||||||
# "SSLError".underscore.camelize # => "SslError"
|
# 'SSLError'.underscore.camelize # => "SslError"
|
||||||
def underscore(camel_cased_word)
|
def underscore(camel_cased_word)
|
||||||
word = camel_cased_word.to_s.dup
|
word = camel_cased_word.to_s.dup
|
||||||
word.gsub!('::', '/')
|
word.gsub!('::', '/')
|
||||||
|
@ -94,10 +99,11 @@ module ActiveSupport
|
||||||
end
|
end
|
||||||
|
|
||||||
# Capitalizes the first word and turns underscores into spaces and strips a
|
# Capitalizes the first word and turns underscores into spaces and strips a
|
||||||
# trailing "_id", if any. Like +titleize+, this is meant for creating pretty output.
|
# trailing "_id", if any. Like +titleize+, this is meant for creating pretty
|
||||||
|
# output.
|
||||||
#
|
#
|
||||||
# "employee_salary" # => "Employee salary"
|
# 'employee_salary'.humanize # => "Employee salary"
|
||||||
# "author_id" # => "Author"
|
# 'author_id'.humanize # => "Author"
|
||||||
def humanize(lower_case_and_underscored_word)
|
def humanize(lower_case_and_underscored_word)
|
||||||
result = lower_case_and_underscored_word.to_s.dup
|
result = lower_case_and_underscored_word.to_s.dup
|
||||||
inflections.humans.each { |(rule, replacement)| break if result.sub!(rule, replacement) }
|
inflections.humans.each { |(rule, replacement)| break if result.sub!(rule, replacement) }
|
||||||
|
@ -108,39 +114,40 @@ module ActiveSupport
|
||||||
}.gsub(/^\w/) { $&.upcase }
|
}.gsub(/^\w/) { $&.upcase }
|
||||||
end
|
end
|
||||||
|
|
||||||
# Capitalizes all the words and replaces some characters in the string to create
|
# Capitalizes all the words and replaces some characters in the string to
|
||||||
# a nicer looking title. +titleize+ is meant for creating pretty output. It is not
|
# create a nicer looking title. +titleize+ is meant for creating pretty
|
||||||
# used in the Rails internals.
|
# output. It is not used in the Rails internals.
|
||||||
#
|
#
|
||||||
# +titleize+ is also aliased as +titlecase+.
|
# +titleize+ is also aliased as +titlecase+.
|
||||||
#
|
#
|
||||||
# "man from the boondocks".titleize # => "Man From The Boondocks"
|
# 'man from the boondocks'.titleize # => "Man From The Boondocks"
|
||||||
# "x-men: the last stand".titleize # => "X Men: The Last Stand"
|
# 'x-men: the last stand'.titleize # => "X Men: The Last Stand"
|
||||||
# "TheManWithoutAPast".titleize # => "The Man Without A Past"
|
# 'TheManWithoutAPast'.titleize # => "The Man Without A Past"
|
||||||
# "raiders_of_the_lost_ark".titleize # => "Raiders Of The Lost Ark"
|
# 'raiders_of_the_lost_ark'.titleize # => "Raiders Of The Lost Ark"
|
||||||
def titleize(word)
|
def titleize(word)
|
||||||
humanize(underscore(word)).gsub(/\b(?<!['’`])[a-z]/) { $&.capitalize }
|
humanize(underscore(word)).gsub(/\b(?<!['’`])[a-z]/) { $&.capitalize }
|
||||||
end
|
end
|
||||||
|
|
||||||
# Create the name of a table like Rails does for models to table names. This method
|
# Create the name of a table like Rails does for models to table names. This
|
||||||
# uses the +pluralize+ method on the last word in the string.
|
# method uses the +pluralize+ method on the last word in the string.
|
||||||
#
|
#
|
||||||
# "RawScaledScorer".tableize # => "raw_scaled_scorers"
|
# 'RawScaledScorer'.tableize # => "raw_scaled_scorers"
|
||||||
# "egg_and_ham".tableize # => "egg_and_hams"
|
# 'egg_and_ham'.tableize # => "egg_and_hams"
|
||||||
# "fancyCategory".tableize # => "fancy_categories"
|
# 'fancyCategory'.tableize # => "fancy_categories"
|
||||||
def tableize(class_name)
|
def tableize(class_name)
|
||||||
pluralize(underscore(class_name))
|
pluralize(underscore(class_name))
|
||||||
end
|
end
|
||||||
|
|
||||||
# Create a class name from a plural table name like Rails does for table names to models.
|
# Create a class name from a plural table name like Rails does for table
|
||||||
# Note that this returns a string and not a Class. (To convert to an actual class
|
# names to models. Note that this returns a string and not a Class (To
|
||||||
# follow +classify+ with +constantize+.)
|
# convert to an actual class follow +classify+ with +constantize+).
|
||||||
#
|
#
|
||||||
# "egg_and_hams".classify # => "EggAndHam"
|
# 'egg_and_hams'.classify # => "EggAndHam"
|
||||||
# "posts".classify # => "Post"
|
# 'posts'.classify # => "Post"
|
||||||
#
|
#
|
||||||
# Singular names are not handled correctly:
|
# Singular names are not handled correctly:
|
||||||
# "business".classify # => "Busines"
|
#
|
||||||
|
# 'business'.classify # => "Busines"
|
||||||
def classify(table_name)
|
def classify(table_name)
|
||||||
# strip out any leading schema name
|
# strip out any leading schema name
|
||||||
camelize(singularize(table_name.to_s.sub(/.*\./, '')))
|
camelize(singularize(table_name.to_s.sub(/.*\./, '')))
|
||||||
|
@ -148,15 +155,15 @@ module ActiveSupport
|
||||||
|
|
||||||
# Replaces underscores with dashes in the string.
|
# Replaces underscores with dashes in the string.
|
||||||
#
|
#
|
||||||
# "puni_puni".dasherize # => "puni-puni"
|
# 'puni_puni'.dasherize # => "puni-puni"
|
||||||
def dasherize(underscored_word)
|
def dasherize(underscored_word)
|
||||||
underscored_word.tr('_', '-')
|
underscored_word.tr('_', '-')
|
||||||
end
|
end
|
||||||
|
|
||||||
# Removes the module part from the expression in the string:
|
# Removes the module part from the expression in the string.
|
||||||
#
|
#
|
||||||
# "ActiveRecord::CoreExtensions::String::Inflections".demodulize # => "Inflections"
|
# 'ActiveRecord::CoreExtensions::String::Inflections'.demodulize # => "Inflections"
|
||||||
# "Inflections".demodulize # => "Inflections"
|
# 'Inflections'.demodulize # => "Inflections"
|
||||||
#
|
#
|
||||||
# See also +deconstantize+.
|
# See also +deconstantize+.
|
||||||
def demodulize(path)
|
def demodulize(path)
|
||||||
|
@ -168,13 +175,13 @@ module ActiveSupport
|
||||||
end
|
end
|
||||||
end
|
end
|
||||||
|
|
||||||
# Removes the rightmost segment from the constant expression in the string:
|
# Removes the rightmost segment from the constant expression in the string.
|
||||||
#
|
#
|
||||||
# "Net::HTTP".deconstantize # => "Net"
|
# 'Net::HTTP'.deconstantize # => "Net"
|
||||||
# "::Net::HTTP".deconstantize # => "::Net"
|
# '::Net::HTTP'.deconstantize # => "::Net"
|
||||||
# "String".deconstantize # => ""
|
# 'String'.deconstantize # => ""
|
||||||
# "::String".deconstantize # => ""
|
# '::String'.deconstantize # => ""
|
||||||
# "".deconstantize # => ""
|
# ''.deconstantize # => ""
|
||||||
#
|
#
|
||||||
# See also +demodulize+.
|
# See also +demodulize+.
|
||||||
def deconstantize(path)
|
def deconstantize(path)
|
||||||
|
@ -185,26 +192,27 @@ module ActiveSupport
|
||||||
# +separate_class_name_and_id_with_underscore+ sets whether
|
# +separate_class_name_and_id_with_underscore+ sets whether
|
||||||
# the method should put '_' between the name and 'id'.
|
# the method should put '_' between the name and 'id'.
|
||||||
#
|
#
|
||||||
# "Message".foreign_key # => "message_id"
|
# 'Message'.foreign_key # => "message_id"
|
||||||
# "Message".foreign_key(false) # => "messageid"
|
# 'Message'.foreign_key(false) # => "messageid"
|
||||||
# "Admin::Post".foreign_key # => "post_id"
|
# 'Admin::Post'.foreign_key # => "post_id"
|
||||||
def foreign_key(class_name, separate_class_name_and_id_with_underscore = true)
|
def foreign_key(class_name, separate_class_name_and_id_with_underscore = true)
|
||||||
underscore(demodulize(class_name)) + (separate_class_name_and_id_with_underscore ? "_id" : "id")
|
underscore(demodulize(class_name)) + (separate_class_name_and_id_with_underscore ? "_id" : "id")
|
||||||
end
|
end
|
||||||
|
|
||||||
# Tries to find a constant with the name specified in the argument string:
|
# Tries to find a constant with the name specified in the argument string.
|
||||||
#
|
#
|
||||||
# "Module".constantize # => Module
|
# 'Module'.constantize # => Module
|
||||||
# "Test::Unit".constantize # => Test::Unit
|
# 'Test::Unit'.constantize # => Test::Unit
|
||||||
#
|
#
|
||||||
# The name is assumed to be the one of a top-level constant, no matter whether
|
# The name is assumed to be the one of a top-level constant, no matter
|
||||||
# it starts with "::" or not. No lexical context is taken into account:
|
# whether it starts with "::" or not. No lexical context is taken into
|
||||||
|
# account:
|
||||||
#
|
#
|
||||||
# C = 'outside'
|
# C = 'outside'
|
||||||
# module M
|
# module M
|
||||||
# C = 'inside'
|
# C = 'inside'
|
||||||
# C # => 'inside'
|
# C # => 'inside'
|
||||||
# "C".constantize # => 'outside', same as ::C
|
# 'C'.constantize # => 'outside', same as ::C
|
||||||
# end
|
# end
|
||||||
#
|
#
|
||||||
# NameError is raised when the name is not in CamelCase or the constant is
|
# NameError is raised when the name is not in CamelCase or the constant is
|
||||||
|
@ -235,28 +243,28 @@ module ActiveSupport
|
||||||
end
|
end
|
||||||
end
|
end
|
||||||
|
|
||||||
# Tries to find a constant with the name specified in the argument string:
|
# Tries to find a constant with the name specified in the argument string.
|
||||||
#
|
#
|
||||||
# "Module".safe_constantize # => Module
|
# 'Module'.safe_constantize # => Module
|
||||||
# "Test::Unit".safe_constantize # => Test::Unit
|
# 'Test::Unit'.safe_constantize # => Test::Unit
|
||||||
#
|
#
|
||||||
# The name is assumed to be the one of a top-level constant, no matter whether
|
# The name is assumed to be the one of a top-level constant, no matter
|
||||||
# it starts with "::" or not. No lexical context is taken into account:
|
# whether it starts with "::" or not. No lexical context is taken into
|
||||||
|
# account:
|
||||||
#
|
#
|
||||||
# C = 'outside'
|
# C = 'outside'
|
||||||
# module M
|
# module M
|
||||||
# C = 'inside'
|
# C = 'inside'
|
||||||
# C # => 'inside'
|
# C # => 'inside'
|
||||||
# "C".safe_constantize # => 'outside', same as ::C
|
# 'C'.safe_constantize # => 'outside', same as ::C
|
||||||
# end
|
# end
|
||||||
#
|
#
|
||||||
# nil is returned when the name is not in CamelCase or the constant (or part of it) is
|
# +nil+ is returned when the name is not in CamelCase or the constant (or
|
||||||
# unknown.
|
# part of it) is unknown.
|
||||||
#
|
|
||||||
# "blargle".safe_constantize # => nil
|
|
||||||
# "UnknownModule".safe_constantize # => nil
|
|
||||||
# "UnknownModule::Foo::Bar".safe_constantize # => nil
|
|
||||||
#
|
#
|
||||||
|
# 'blargle'.safe_constantize # => nil
|
||||||
|
# 'UnknownModule'.safe_constantize # => nil
|
||||||
|
# 'UnknownModule::Foo::Bar'.safe_constantize # => nil
|
||||||
def safe_constantize(camel_cased_word)
|
def safe_constantize(camel_cased_word)
|
||||||
begin
|
begin
|
||||||
constantize(camel_cased_word)
|
constantize(camel_cased_word)
|
||||||
|
@ -318,8 +326,8 @@ module ActiveSupport
|
||||||
|
|
||||||
# Applies inflection rules for +singularize+ and +pluralize+.
|
# Applies inflection rules for +singularize+ and +pluralize+.
|
||||||
#
|
#
|
||||||
# apply_inflections("post", inflections.plurals) # => "posts"
|
# apply_inflections('post', inflections.plurals) # => "posts"
|
||||||
# apply_inflections("posts", inflections.singulars) # => "post"
|
# apply_inflections('posts', inflections.singulars) # => "post"
|
||||||
def apply_inflections(word, rules)
|
def apply_inflections(word, rules)
|
||||||
result = word.to_s.dup
|
result = word.to_s.dup
|
||||||
|
|
||||||
|
|
|
@ -39,13 +39,13 @@ module ActiveSupport
|
||||||
# }
|
# }
|
||||||
# })
|
# })
|
||||||
#
|
#
|
||||||
# The value for <tt>i18n.transliterate.rule</tt> can be a simple Hash that maps
|
# The value for <tt>i18n.transliterate.rule</tt> can be a simple Hash that
|
||||||
# characters to ASCII approximations as shown above, or, for more complex
|
# maps characters to ASCII approximations as shown above, or, for more
|
||||||
# requirements, a Proc:
|
# complex requirements, a Proc:
|
||||||
#
|
#
|
||||||
# I18n.backend.store_translations(:de, i18n: {
|
# I18n.backend.store_translations(:de, i18n: {
|
||||||
# transliterate: {
|
# transliterate: {
|
||||||
# rule: lambda { |string| MyTransliterator.transliterate(string) }
|
# rule: ->(string) { MyTransliterator.transliterate(string) }
|
||||||
# }
|
# }
|
||||||
# })
|
# })
|
||||||
#
|
#
|
||||||
|
@ -64,7 +64,8 @@ module ActiveSupport
|
||||||
:replacement => replacement)
|
:replacement => replacement)
|
||||||
end
|
end
|
||||||
|
|
||||||
# Replaces special characters in a string so that it may be used as part of a 'pretty' URL.
|
# Replaces special characters in a string so that it may be used as part of
|
||||||
|
# a 'pretty' URL.
|
||||||
#
|
#
|
||||||
# class Person
|
# class Person
|
||||||
# def to_param
|
# def to_param
|
||||||
|
|
Loading…
Reference in a new issue