naming.rb 4.0 KB
Newer Older
1 2
require 'active_support/inflector'

J
Joshua Peek 已提交
3 4
module ActiveModel
  class Name < String
5
    attr_reader :singular, :plural, :element, :collection, :partial_path, :route_key, :param_key
6
    alias_method :cache_key, :collection
7

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

12
      @klass = klass
13
      @singular = _singularize(self).freeze
14
      @plural = ActiveSupport::Inflector.pluralize(@singular).freeze
15
      @element = ActiveSupport::Inflector.underscore(ActiveSupport::Inflector.demodulize(self)).freeze
16
      @human = ActiveSupport::Inflector.humanize(@element).freeze
17 18
      @collection = ActiveSupport::Inflector.tableize(self).freeze
      @partial_path = "#{@collection}/#{@element}".freeze
19 20
      @param_key = (namespace ? _singularize(@unnamespaced) : @singular).freeze
      @route_key = (namespace ? ActiveSupport::Inflector.pluralize(@param_key) : @plural).freeze
21
    end
22 23

    # Transform the model name into a more humane format, using I18n. By default,
24 25 26 27
    # it will underscore then humanize the class name
    #
    #   BlogPost.model_name.human # => "Blog post"
    #
28 29 30 31 32 33 34 35 36 37 38 39 40 41 42
    # Specify +options+ with additional translating options.
    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
43 44 45 46 47

    private
      def _singularize(str)
        ActiveSupport::Inflector.underscore(str).tr('/', '_')
      end
48
  end
R
Rizwan Reza 已提交
49

R
Rizwan Reza 已提交
50 51 52
  # == Active Model Naming
  #
  # Creates a +model_name+ method on your object.
53
  #
54
  # To implement, just extend ActiveModel::Naming in your object:
55
  #
56
  #   class BookCover
57
  #     extend ActiveModel::Naming
58
  #   end
59
  #
60 61
  #   BookCover.model_name        # => "BookCover"
  #   BookCover.model_name.human  # => "Book cover"
62
  #
63
  # Providing the functionality that ActiveModel::Naming provides in your object
64
  # is required to pass the Active Model Lint test.  So either extending the provided
65
  # method below, or rolling your own is required..
J
Joshua Peek 已提交
66 67 68 69
  module Naming
    # Returns an ActiveModel::Name object for module. It can be
    # used to retrieve all kinds of naming-related information.
    def model_name
70 71
      namespace = self.parents.detect { |n| n.respond_to?(:_railtie) }
      @_model_name ||= ActiveModel::Name.new(self, namespace)
J
Joshua Peek 已提交
72
    end
73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97

    # Returns the plural class name of a record or class. Examples:
    #
    #   ActiveModel::Naming.plural(post)             # => "posts"
    #   ActiveModel::Naming.plural(Highrise::Person) # => "highrise_people"
    def self.plural(record_or_class)
      model_name_from_record_or_class(record_or_class).plural
    end

    # Returns the singular class name of a record or class. Examples:
    #
    #   ActiveModel::Naming.singular(post)             # => "post"
    #   ActiveModel::Naming.singular(Highrise::Person) # => "highrise_person"
    def self.singular(record_or_class)
      model_name_from_record_or_class(record_or_class).singular
    end

    # Identifies whether the class name of a record or class is uncountable. Examples:
    #
    #   ActiveModel::Naming.uncountable?(Sheep) # => true
    #   ActiveModel::Naming.uncountable?(Post) => false
    def self.uncountable?(record_or_class)
      plural(record_or_class) == singular(record_or_class)
    end

98 99 100 101 102 103 104 105
    def self.route_key(record_or_class)
      model_name_from_record_or_class(record_or_class).route_key
    end

    def self.param_key(record_or_class)
      model_name_from_record_or_class(record_or_class).param_key
    end

106 107 108 109
    private
      def self.model_name_from_record_or_class(record_or_class)
        (record_or_class.is_a?(Class) ? record_or_class : record_or_class.class).model_name
      end
110
  end
111

112
end