Class: ActiveModel::Name

Inherits:

String

• Object
• String
• ActiveModel::Name

show all

Defined in:

activemodel/lib/active_model/naming.rb

Instance Attribute Summary (collapse)

• - (Object) collection (also: #cache_key) readonly

  Returns the value of attribute collection.

• - (Object) element readonly

  Returns the value of attribute element.

• - (Object) partial_path readonly

  Returns the value of attribute partial_path.

• - (Object) plural readonly

  Returns the value of attribute plural.

• - (Object) singular readonly

  Returns the value of attribute singular.

Instance Method Summary (collapse)

• - (Object) human(options = {})

  Transform the model name into a more humane format, using I18n.

• - (Name) initialize(klass) constructor

  A new instance of Name.

Methods inherited from String

#acts_like_string?, #as_json, #at, #blank?, #camelize, #classify, #constantize, #dasherize, #demodulize, #encode_json, #encoding_aware?, #exclude?, #first, #foreign_key, #from, #html_safe, #html_safe!, #humanize, #is_utf8?, #last, #mb_chars, #ord, #parameterize, #pluralize, #singularize, #squish, #squish!, #strip_heredoc, #tableize, #titleize, #to, #to_date, #to_datetime, #to_time, #truncate, #underscore

8
9
10
11
12
13
14
15
16
17

# File 'activemodel/lib/active_model/naming.rb', line 8

def initialize(klass)
  super(klass.name)
  @klass = klass
  @singular = ActiveSupport::Inflector.underscore(self).tr('/', '_').freeze
  @plural = ActiveSupport::Inflector.pluralize(@singular).freeze
  @element = ActiveSupport::Inflector.underscore(ActiveSupport::Inflector.demodulize(self)).freeze
  @human = ActiveSupport::Inflector.humanize(@element).freeze
  @collection = ActiveSupport::Inflector.tableize(self).freeze
  @partial_path = "#{@collection}/#{@element}".freeze
end

5
6
7

# File 'activemodel/lib/active_model/naming.rb', line 5

def collection
  @collection
end

5
6
7

# File 'activemodel/lib/active_model/naming.rb', line 5

def element
  @element
end

5
6
7

# File 'activemodel/lib/active_model/naming.rb', line 5

def partial_path
  @partial_path
end

5
6
7

# File 'activemodel/lib/active_model/naming.rb', line 5

def plural
  @plural
end

5
6
7

# File 'activemodel/lib/active_model/naming.rb', line 5

def singular
  @singular
end

BlogPost.model_name.human # => "Blog post"

25
26
27
28
29
30
31
32
33
34
35
36
37
38

# File 'activemodel/lib/active_model/naming.rb', line 25

def human(options={})
  return @human unless @klass.respond_to?(:lookup_ancestors) &&
                       @klass.respond_to?(:i18n_scope)

  defaults = @klass.lookup_ancestors.map do |klass|
    klass.model_name.underscore.to_sym
  end

  defaults << options.delete(:default) if options[:default]
  defaults << @human

  options.reverse_merge! :scope => [@klass.i18n_scope, :models], :count => 1, :default => defaults
  I18n.translate(defaults.shift, options)
end