path: root/activerecord/lib/active_record/associations/builder/singular_association.rb

# This class is inherited by the has_one and belongs_to association classes 

module ActiveRecord::Associations::Builder
  class SingularAssociation < Association #:nodoc:
    def valid_options
      super + [:remote, :dependent, :counter_cache, :primary_key, :inverse_of]
    end

    def constructable?
      true
    end

    def define_accessors(model)
      super
      define_constructors(model.generated_feature_methods) if constructable?
    end

    # Defines the (build|create)_association methods for belongs_to or has_one association

    def define_constructors(mixin)
      mixin.class_eval <<-CODE, __FILE__, __LINE__ + 1
        def build_#{name}(*args, &block)
          association(:#{name}).build(*args, &block)
        end

        def create_#{name}(*args, &block)
          association(:#{name}).create(*args, &block)
        end

        def create_#{name}!(*args, &block)
          association(:#{name}).create!(*args, &block)
        end
      CODE
    end
  end
end