Module: ActiveModel::Naming
- Included in:
- Translation
- Defined in:
- lib/active_model/naming.rb
Overview
Active Model Naming
Creates a model_name
method on your object.
To implement, just extend ActiveModel::Naming in your object:
class BookCover
extend ActiveModel::Naming
end
BookCover.model_name.name # => "BookCover"
BookCover.model_name.human # => "Book cover"
BookCover.model_name.i18n_key # => :book_cover
BookModule::BookCover.model_name.i18n_key # => :"book_module/book_cover"
Providing the functionality that ActiveModel::Naming provides in your object is required to pass the Active Model Lint test. So either extending the provided method below, or rolling your own is required.
Class Method Summary collapse
-
.extended(base) ⇒ Object
:nodoc:.
-
.param_key(record_or_class) ⇒ Object
Returns string to use for params names.
-
.plural(record_or_class) ⇒ Object
Returns the plural class name of a record or class.
-
.route_key(record_or_class) ⇒ Object
Returns string to use while generating route names.
-
.singular(record_or_class) ⇒ Object
Returns the singular class name of a record or class.
-
.singular_route_key(record_or_class) ⇒ Object
Returns string to use while generating route names.
-
.uncountable?(record_or_class) ⇒ Boolean
Identifies whether the class name of a record or class is uncountable.
Instance Method Summary collapse
-
#model_name ⇒ Object
Returns an ActiveModel::Name object for module.
Class Method Details
.extended(base) ⇒ Object
:nodoc:
217 218 219 220 |
# File 'lib/active_model/naming.rb', line 217 def self.extended(base) #:nodoc: base.remove_possible_method :model_name base.delegate :model_name, to: :class end |
.param_key(record_or_class) ⇒ Object
Returns string to use for params names. It differs for namespaced models regarding whether it’s inside isolated engine.
# For isolated engine:
ActiveModel::Naming.param_key(Blog::Post) # => "post"
# For shared engine:
ActiveModel::Naming.param_key(Blog::Post) # => "blog_post"
302 303 304 |
# File 'lib/active_model/naming.rb', line 302 def self.param_key(record_or_class) model_name_from_record_or_class(record_or_class).param_key end |
.plural(record_or_class) ⇒ Object
Returns the plural class name of a record or class.
ActiveModel::Naming.plural(post) # => "posts"
ActiveModel::Naming.plural(Highrise::Person) # => "highrise_people"
247 248 249 |
# File 'lib/active_model/naming.rb', line 247 def self.plural(record_or_class) model_name_from_record_or_class(record_or_class).plural end |
.route_key(record_or_class) ⇒ Object
Returns string to use while generating route names. It differs for namespaced models regarding whether it’s inside isolated engine.
# For isolated engine:
ActiveModel::Naming.route_key(Blog::Post) # => "posts"
# For shared engine:
ActiveModel::Naming.route_key(Blog::Post) # => "blog_posts"
The route key also considers if the noun is uncountable and, in such cases, automatically appends _index.
290 291 292 |
# File 'lib/active_model/naming.rb', line 290 def self.route_key(record_or_class) model_name_from_record_or_class(record_or_class).route_key end |
.singular(record_or_class) ⇒ Object
Returns the singular class name of a record or class.
ActiveModel::Naming.singular(post) # => "post"
ActiveModel::Naming.singular(Highrise::Person) # => "highrise_person"
255 256 257 |
# File 'lib/active_model/naming.rb', line 255 def self.singular(record_or_class) model_name_from_record_or_class(record_or_class).singular end |
.singular_route_key(record_or_class) ⇒ Object
Returns string to use while generating route names. It differs for namespaced models regarding whether it’s inside isolated engine.
# For isolated engine:
ActiveModel::Naming.singular_route_key(Blog::Post) # => "post"
# For shared engine:
ActiveModel::Naming.singular_route_key(Blog::Post) # => "blog_post"
275 276 277 |
# File 'lib/active_model/naming.rb', line 275 def self.singular_route_key(record_or_class) model_name_from_record_or_class(record_or_class).singular_route_key end |
.uncountable?(record_or_class) ⇒ Boolean
Identifies whether the class name of a record or class is uncountable.
ActiveModel::Naming.uncountable?(Sheep) # => true
ActiveModel::Naming.uncountable?(Post) # => false
263 264 265 |
# File 'lib/active_model/naming.rb', line 263 def self.uncountable?(record_or_class) plural(record_or_class) == singular(record_or_class) end |
Instance Method Details
#model_name ⇒ Object
Returns an ActiveModel::Name object for module. It can be used to retrieve all kinds of naming-related information (See ActiveModel::Name for more information).
class Person
include ActiveModel::Model
end
Person.model_name.name # => "Person"
Person.model_name.class # => ActiveModel::Name
Person.model_name.singular # => "person"
Person.model_name.plural # => "people"
234 235 236 237 238 239 240 241 |
# File 'lib/active_model/naming.rb', line 234 def model_name @_model_name ||= begin namespace = self.parents.detect do |n| n.respond_to?(:use_relative_model_naming?) && n.use_relative_model_naming? end ActiveModel::Name.new(self, namespace) end end |