Class: ActiveModel::Name

Inherits:
String
  • Object
show all
Defined in:
lib/active_model/naming.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(klass, namespace = nil, name = nil) ⇒ Name

Returns a new instance of Name.



12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
 
# File 'lib/active_model/naming.rb', line 12

def initialize(klass, namespace = nil, name = nil)
  name ||= klass.name
  super(name)
  @unnamespaced = self.sub(/^#{namespace.name}::/, '') if namespace

  @klass = klass
  @singular = _singularize(self).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
  @param_key    = (namespace ? _singularize(@unnamespaced) : @singular).freeze
  @i18n_key     = self.underscore.to_sym

  @route_key          = (namespace ? ActiveSupport::Inflector.pluralize(@param_key) : @plural.dup)
  @singular_route_key = ActiveSupport::Inflector.singularize(@route_key).freeze
  @route_key << "_index" if @plural == @singular
  @route_key.freeze
end

Instance Attribute Details

#collection ⇒ Object (readonly) Also known as: cache_key

Returns the value of attribute collection.



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

def collection
  @collection
end

#element ⇒ Object (readonly)

Returns the value of attribute element.



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

def element
  @element
end

#i18n_key ⇒ Object (readonly)

Returns the value of attribute i18n_key.



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

def i18n_key
  @i18n_key
end

#param_key ⇒ Object (readonly)

Returns the value of attribute param_key.



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

def param_key
  @param_key
end

#partial_path ⇒ Object (readonly)

Returns the value of attribute partial_path.



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

def partial_path
  @partial_path
end

#plural ⇒ Object (readonly)

Returns the value of attribute plural.



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

def plural
  @plural
end

#route_key ⇒ Object (readonly)

Returns the value of attribute route_key.



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

def route_key
  @route_key
end

#singular ⇒ Object (readonly)

Returns the value of attribute singular.



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

def singular
  @singular
end

#singular_route_key ⇒ Object (readonly)

Returns the value of attribute singular_route_key.



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

def singular_route_key
  @singular_route_key
end

Instance Method Details

#human(options = {}) ⇒ Object

Transform the model name into a more humane format, using I18n. By default, it will underscore then humanize the class name

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

Specify options with additional translating options.



39
40
41
42
43
44
45
46
47
48
49
50
51
52
 
# File 'lib/active_model/naming.rb', line 39

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.i18n_key
  end

  defaults << options[:default] if options[:default]
  defaults << @human

  options = {:scope => [@klass.i18n_scope, :models], :count => 1, :default => defaults}.merge(options.except(:default))
  I18n.translate(defaults.shift, options)
end