Contents

module HasEmailAuthentication::Module

  def self.included(base)
    base.extend(ClassMethods)
  end

  module ClassMethods

    # Generates the +find_by_email+ class method. Downcases the +:email+
    # attribute before saving. Validates the presence, format and uniqueness
    # of the +:email+ attribute.
    #
    # @example
    #
    #   class User < ActiveRecord::Base
    #     has_email_authentication
    #   end
    #
    #   User.create(email: "[e-mail]")
    #   User.find_by_email("[e-mail])
    #
    def has_email_authentication
      validates :email,
        presence: true,
        format: { with: /\A[\w+\-.]+@[a-z\d\-.]+\.[a-z]+\z/i },
        uniqueness: { case_sensitive: false }

      before_save do
        self.email = email.try(:downcase)
      end

      extend(FindByEmail)
    end
  end

  module FindByEmail

    # Convenience method for finding a record by email. Attempts
    # to downcase the provided +email+ prior to searching the database for it.
    #
    # @param email [String] the email to find the record by.
    # @return [Object, nil]
    #
    def find_by_email(email)
      find_by(email: email.try(:downcase))
    end
  end
end

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
has_email_authentication-1.0.0	lib/has_email_authentication/module.rb
has_email_authentication-0.0.1	lib/has_email_authentication/module.rb