authlogic 2.0.0 → 2.1.0

data/authlogic.gemspec

@@ -0,0 +1,205 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{authlogic}
+  s.version = "2.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Ben Johnson of Binary Logic"]
+  s.date = %q{2009-06-27}
+  s.email = %q{bjohnson@binarylogic.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".gitignore",
+     "CHANGELOG.rdoc",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION.yml",
+     "authlogic.gemspec",
+     "generators/session/session_generator.rb",
+     "generators/session/templates/session.rb",
+     "init.rb",
+     "lib/authlogic.rb",
+     "lib/authlogic/acts_as_authentic/base.rb",
+     "lib/authlogic/acts_as_authentic/email.rb",
+     "lib/authlogic/acts_as_authentic/logged_in_status.rb",
+     "lib/authlogic/acts_as_authentic/login.rb",
+     "lib/authlogic/acts_as_authentic/magic_columns.rb",
+     "lib/authlogic/acts_as_authentic/password.rb",
+     "lib/authlogic/acts_as_authentic/perishable_token.rb",
+     "lib/authlogic/acts_as_authentic/persistence_token.rb",
+     "lib/authlogic/acts_as_authentic/restful_authentication.rb",
+     "lib/authlogic/acts_as_authentic/session_maintenance.rb",
+     "lib/authlogic/acts_as_authentic/single_access_token.rb",
+     "lib/authlogic/acts_as_authentic/validations_scope.rb",
+     "lib/authlogic/authenticates_many/association.rb",
+     "lib/authlogic/authenticates_many/base.rb",
+     "lib/authlogic/controller_adapters/abstract_adapter.rb",
+     "lib/authlogic/controller_adapters/merb_adapter.rb",
+     "lib/authlogic/controller_adapters/rails_adapter.rb",
+     "lib/authlogic/crypto_providers/aes256.rb",
+     "lib/authlogic/crypto_providers/bcrypt.rb",
+     "lib/authlogic/crypto_providers/md5.rb",
+     "lib/authlogic/crypto_providers/sha1.rb",
+     "lib/authlogic/crypto_providers/sha512.rb",
+     "lib/authlogic/i18n.rb",
+     "lib/authlogic/random.rb",
+     "lib/authlogic/regex.rb",
+     "lib/authlogic/session/activation.rb",
+     "lib/authlogic/session/active_record_trickery.rb",
+     "lib/authlogic/session/base.rb",
+     "lib/authlogic/session/brute_force_protection.rb",
+     "lib/authlogic/session/callbacks.rb",
+     "lib/authlogic/session/cookies.rb",
+     "lib/authlogic/session/existence.rb",
+     "lib/authlogic/session/foundation.rb",
+     "lib/authlogic/session/http_auth.rb",
+     "lib/authlogic/session/id.rb",
+     "lib/authlogic/session/klass.rb",
+     "lib/authlogic/session/magic_columns.rb",
+     "lib/authlogic/session/magic_states.rb",
+     "lib/authlogic/session/params.rb",
+     "lib/authlogic/session/password.rb",
+     "lib/authlogic/session/perishable_token.rb",
+     "lib/authlogic/session/persistence.rb",
+     "lib/authlogic/session/priority_record.rb",
+     "lib/authlogic/session/scopes.rb",
+     "lib/authlogic/session/session.rb",
+     "lib/authlogic/session/timeout.rb",
+     "lib/authlogic/session/unauthorized_record.rb",
+     "lib/authlogic/session/validation.rb",
+     "lib/authlogic/test_case.rb",
+     "lib/authlogic/test_case/mock_controller.rb",
+     "lib/authlogic/test_case/mock_cookie_jar.rb",
+     "lib/authlogic/test_case/mock_logger.rb",
+     "lib/authlogic/test_case/mock_request.rb",
+     "lib/authlogic/test_case/rails_request_adapter.rb",
+     "rails/init.rb",
+     "shoulda_macros/authlogic.rb",
+     "test/acts_as_authentic_test/base_test.rb",
+     "test/acts_as_authentic_test/email_test.rb",
+     "test/acts_as_authentic_test/logged_in_status_test.rb",
+     "test/acts_as_authentic_test/login_test.rb",
+     "test/acts_as_authentic_test/magic_columns_test.rb",
+     "test/acts_as_authentic_test/password_test.rb",
+     "test/acts_as_authentic_test/perishable_token_test.rb",
+     "test/acts_as_authentic_test/persistence_token_test.rb",
+     "test/acts_as_authentic_test/restful_authentication_test.rb",
+     "test/acts_as_authentic_test/session_maintenance_test.rb",
+     "test/acts_as_authentic_test/single_access_test.rb",
+     "test/authenticates_many_test.rb",
+     "test/crypto_provider_test/aes256_test.rb",
+     "test/crypto_provider_test/bcrypt_test.rb",
+     "test/crypto_provider_test/sha1_test.rb",
+     "test/crypto_provider_test/sha512_test.rb",
+     "test/fixtures/companies.yml",
+     "test/fixtures/employees.yml",
+     "test/fixtures/projects.yml",
+     "test/fixtures/users.yml",
+     "test/libs/affiliate.rb",
+     "test/libs/company.rb",
+     "test/libs/employee.rb",
+     "test/libs/employee_session.rb",
+     "test/libs/ldaper.rb",
+     "test/libs/ordered_hash.rb",
+     "test/libs/project.rb",
+     "test/libs/user.rb",
+     "test/libs/user_session.rb",
+     "test/random_test.rb",
+     "test/session_test/activation_test.rb",
+     "test/session_test/active_record_trickery_test.rb",
+     "test/session_test/brute_force_protection_test.rb",
+     "test/session_test/callbacks_test.rb",
+     "test/session_test/cookies_test.rb",
+     "test/session_test/credentials_test.rb",
+     "test/session_test/existence_test.rb",
+     "test/session_test/http_auth_test.rb",
+     "test/session_test/id_test.rb",
+     "test/session_test/klass_test.rb",
+     "test/session_test/magic_columns_test.rb",
+     "test/session_test/magic_states_test.rb",
+     "test/session_test/params_test.rb",
+     "test/session_test/password_test.rb",
+     "test/session_test/perishability_test.rb",
+     "test/session_test/persistence_test.rb",
+     "test/session_test/scopes_test.rb",
+     "test/session_test/session_test.rb",
+     "test/session_test/timeout_test.rb",
+     "test/session_test/unauthorized_record_test.rb",
+     "test/session_test/validation_test.rb",
+     "test/test_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/binarylogic/authlogic}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{authlogic}
+  s.rubygems_version = %q{1.3.4}
+  s.summary = %q{A clean, simple, and unobtrusive ruby authentication solution.}
+  s.test_files = [
+    "test/acts_as_authentic_test/base_test.rb",
+     "test/acts_as_authentic_test/email_test.rb",
+     "test/acts_as_authentic_test/logged_in_status_test.rb",
+     "test/acts_as_authentic_test/login_test.rb",
+     "test/acts_as_authentic_test/magic_columns_test.rb",
+     "test/acts_as_authentic_test/password_test.rb",
+     "test/acts_as_authentic_test/perishable_token_test.rb",
+     "test/acts_as_authentic_test/persistence_token_test.rb",
+     "test/acts_as_authentic_test/restful_authentication_test.rb",
+     "test/acts_as_authentic_test/session_maintenance_test.rb",
+     "test/acts_as_authentic_test/single_access_test.rb",
+     "test/authenticates_many_test.rb",
+     "test/crypto_provider_test/aes256_test.rb",
+     "test/crypto_provider_test/bcrypt_test.rb",
+     "test/crypto_provider_test/sha1_test.rb",
+     "test/crypto_provider_test/sha512_test.rb",
+     "test/libs/affiliate.rb",
+     "test/libs/company.rb",
+     "test/libs/employee.rb",
+     "test/libs/employee_session.rb",
+     "test/libs/ldaper.rb",
+     "test/libs/ordered_hash.rb",
+     "test/libs/project.rb",
+     "test/libs/user.rb",
+     "test/libs/user_session.rb",
+     "test/random_test.rb",
+     "test/session_test/activation_test.rb",
+     "test/session_test/active_record_trickery_test.rb",
+     "test/session_test/brute_force_protection_test.rb",
+     "test/session_test/callbacks_test.rb",
+     "test/session_test/cookies_test.rb",
+     "test/session_test/credentials_test.rb",
+     "test/session_test/existence_test.rb",
+     "test/session_test/http_auth_test.rb",
+     "test/session_test/id_test.rb",
+     "test/session_test/klass_test.rb",
+     "test/session_test/magic_columns_test.rb",
+     "test/session_test/magic_states_test.rb",
+     "test/session_test/params_test.rb",
+     "test/session_test/password_test.rb",
+     "test/session_test/perishability_test.rb",
+     "test/session_test/persistence_test.rb",
+     "test/session_test/scopes_test.rb",
+     "test/session_test/session_test.rb",
+     "test/session_test/timeout_test.rb",
+     "test/session_test/unauthorized_record_test.rb",
+     "test/session_test/validation_test.rb",
+     "test/test_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activesupport>, [">= 0"])
+    else
+      s.add_dependency(%q<activesupport>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<activesupport>, [">= 0"])
+  end
+end

data/init.rb

@@ -1 +1 @@
-require "authlogic"
+require File.dirname(__FILE__) + "/rails/init.rb"

data/lib/authlogic/acts_as_authentic/base.rb

@@ -23,7 +23,13 @@ module Authlogic
         #   end
         #
         # See the various sub modules for the configuration they provide.
-        def acts_as_authentic(&block)
+        def acts_as_authentic(unsupported_options = nil, &block)
+          # Stop all configuration if the DB is not set up
+          return if !db_setup?
+          
+          raise ArgumentError.new("You are using the old v1.X.X configuration method for Authlogic. Instead of " +
+            "passing a hash of configuration options to acts_as_authentic, pass a block: acts_as_authentic { |c| c.my_option = my_value }") if !unsupported_options.nil?
+          
           yield self if block_given?
           acts_as_authentic_modules.each { |mod| include mod }
         end
@@ -34,9 +40,14 @@ module Authlogic
         # nothing to do with Authlogic.
         #
         # That being said, this is your tool for extending Authlogic and "hooking" into the acts_as_authentic call.
-        def add_acts_as_authentic_module(mod)
+        def add_acts_as_authentic_module(mod, action = :append)
           modules = acts_as_authentic_modules
-          modules << mod
+          case action
+          when :append
+            modules << mod
+          when :prepend
+            modules = [mod] + modules
+          end
           modules.uniq!
           write_inheritable_attribute(:acts_as_authentic_modules, modules)
         end
@@ -46,25 +57,35 @@ module Authlogic
           acts_as_authentic_modules.delete(mod)
           acts_as_authentic_modules
         end
-      
+        
         private
           def acts_as_authentic_modules
             key = :acts_as_authentic_modules
             inheritable_attributes.include?(key) ? read_inheritable_attribute(key) : []
           end
-        
-          def config(key, value, default_value = nil, read_value = nil)
+          
+          def db_setup?
+            begin
+              column_names
+              true
+            rescue Exception
+              false
+            end
+          end
+          
+          def rw_config(key, value, default_value = nil, read_value = nil)
             if value == read_value
-              return read_inheritable_attribute(key) if inheritable_attributes.include?(key)
-              write_inheritable_attribute(key, default_value)
+              inheritable_attributes.include?(key) ? read_inheritable_attribute(key) : default_value
             else
               write_inheritable_attribute(key, value)
             end
           end
-
-          def first_column_to_exist(*columns_to_check) # :nodoc:
-            columns_to_check.each { |column_name| return column_name.to_sym if column_names.include?(column_name.to_s) }
-            columns_to_check.first ? columns_to_check.first.to_sym : nil
+          
+          def first_column_to_exist(*columns_to_check)
+            if db_setup?
+              columns_to_check.each { |column_name| return column_name.to_sym if column_names.include?(column_name.to_s) }
+            end
+            columns_to_check.first && columns_to_check.first.to_sym
           end
       end
     end

data/lib/authlogic/acts_as_authentic/email.rb

@@ -19,7 +19,7 @@ module Authlogic
         # * <tt>Default:</tt> :email, if it exists
         # * <tt>Accepts:</tt> Symbol
         def email_field(value = nil)
-          config(:email_field, value, first_column_to_exist(nil, :email))
+          rw_config(:email_field, value, first_column_to_exist(nil, :email, :email_address))
         end
         alias_method :email_field=, :email_field
         
@@ -28,36 +28,69 @@ module Authlogic
         # * <tt>Default:</tt> true
         # * <tt>Accepts:</tt> Boolean
         def validate_email_field(value = nil)
-          config(:validate_email_field, value, true)
+          rw_config(:validate_email_field, value, true)
         end
         alias_method :validate_email_field=, :validate_email_field
         
         # A hash of options for the validates_length_of call for the email field. Allows you to change this however you want.
         #
+        # <b>Keep in mind this is ruby. I wanted to keep this as flexible as possible, so you can completely replace the hash or
+        # merge options into it. Checkout the convenience function merge_validates_length_of_email_field_options to merge
+        # options.</b>
+        #
         # * <tt>Default:</tt> {:within => 6..100}
         # * <tt>Accepts:</tt> Hash of options accepted by validates_length_of
         def validates_length_of_email_field_options(value = nil)
-          config(:validates_length_of_email_field_options, value, {:within => 6..100})
+          rw_config(:validates_length_of_email_field_options, value, {:within => 6..100})
         end
         alias_method :validates_length_of_email_field_options=, :validates_length_of_email_field_options
         
+        # A convenience function to merge options into the validates_length_of_email_field_options. So intead of:
+        #
+        #   self.validates_length_of_email_field_options = validates_length_of_email_field_options.merge(:my_option => my_value)
+        #
+        # You can do this:
+        #
+        #   merge_validates_length_of_email_field_options :my_option => my_value
+        def merge_validates_length_of_email_field_options(options = {})
+          self.validates_length_of_email_field_options = validates_length_of_email_field_options.merge(options)
+        end
+        
         # A hash of options for the validates_format_of call for the email field. Allows you to change this however you want.
         #
-        # * <tt>Default:</tt> {:with => email_regex, :message => I18n.t('error_messages.email_invalid', :default => "should look like an email address.")}
+        # <b>Keep in mind this is ruby. I wanted to keep this as flexible as possible, so you can completely replace the hash or
+        # merge options into it. Checkout the convenience function merge_validates_format_of_email_field_options to merge
+        # options.</b>
+        #
+        # * <tt>Default:</tt> {:with => Authlogic::Regex.email, :message => I18n.t('error_messages.email_invalid', :default => "should look like an email address.")}
         # * <tt>Accepts:</tt> Hash of options accepted by validates_format_of
         def validates_format_of_email_field_options(value = nil)
-          config(:validates_format_of_email_field_options, value, {:with => email_regex, :message => I18n.t('error_messages.email_invalid', :default => "should look like an email address.")})
+          rw_config(:validates_format_of_email_field_options, value, {:with => Authlogic::Regex.email, :message => I18n.t('error_messages.email_invalid', :default => "should look like an email address.")})
         end
         alias_method :validates_format_of_email_field_options=, :validates_format_of_email_field_options
         
-        private
-          def email_regex
-            return @email_regex if @email_regex
-            email_name_regex  = '[\w\.%\+\-]+'
-            domain_head_regex = '(?:[A-Z0-9\-]+\.)+'
-            domain_tld_regex  = '(?:[A-Z]{2}|aero|ag|asia|at|be|biz|ca|cc|cn|com|de|edu|eu|fm|gov|gs|jobs|jp|in|info|me|mil|mobi|museum|ms|name|net|nu|nz|org|tc|tw|tv|uk|us|vg|ws)'
-            @email_regex = /\A#{email_name_regex}@#{domain_head_regex}#{domain_tld_regex}\z/i
-          end
+        # See merge_validates_length_of_email_field_options. The same thing except for validates_format_of_email_field_options.
+        def merge_validates_format_of_email_field_options(options = {})
+          self.validates_format_of_email_field_options = validates_format_of_email_field_options.merge(options)
+        end
+        
+        # A hash of options for the validates_uniqueness_of call for the email field. Allows you to change this however you want.
+        #
+        # <b>Keep in mind this is ruby. I wanted to keep this as flexible as possible, so you can completely replace the hash or
+        # merge options into it. Checkout the convenience function merge_validates_uniqueness_of_email_field_options to merge
+        # options.</b>
+        #
+        # * <tt>Default:</tt> {:case_sensitive => false, :scope => validations_scope, :if => "#{email_field}_changed?".to_sym}
+        # * <tt>Accepts:</tt> Hash of options accepted by validates_uniqueness_of
+        def validates_uniqueness_of_email_field_options(value = nil)
+          rw_config(:validates_uniqueness_of_email_field_options, value, {:case_sensitive => false, :scope => validations_scope, :if => "#{email_field}_changed?".to_sym})
+        end
+        alias_method :validates_uniqueness_of_email_field_options=, :validates_uniqueness_of_email_field_options
+        
+        # See merge_validates_length_of_email_field_options. The same thing except for validates_uniqueness_of_email_field_options.
+        def merge_validates_uniqueness_of_email_field_options(options = {})
+          self.validates_uniqueness_of_email_field_options = validates_uniqueness_of_email_field_options.merge(options)
+        end
       end
       
       # All methods relating to the email field
@@ -67,7 +100,7 @@ module Authlogic
             if validate_email_field && email_field
               validates_length_of email_field, validates_length_of_email_field_options
               validates_format_of email_field, validates_format_of_email_field_options
-              validates_uniqueness_of email_field, :scope => validations_scope, :if => "#{email_field}_changed?".to_sym
+              validates_uniqueness_of email_field, validates_uniqueness_of_email_field_options
             end
           end
         end

data/lib/authlogic/acts_as_authentic/logged_in_status.rb

@@ -19,7 +19,7 @@ module Authlogic
         # * <tt>Default:</tt> 10.minutes
         # * <tt>Accepts:</tt> Fixnum
         def logged_in_timeout(value = nil)
-          config(:logged_in_timeout, (!value.nil? && value.to_i) || value, 10.minutes.to_i)
+          rw_config(:logged_in_timeout, (!value.nil? && value.to_i) || value, 10.minutes.to_i)
         end
         alias_method :logged_in_timeout=, :logged_in_timeout
       end
@@ -27,27 +27,33 @@ module Authlogic
       # All methods for the logged in status feature seat.
       module Methods
         def self.included(klass)
+          return if !klass.column_names.include?("last_request_at")
+          
           klass.class_eval do
+            include InstanceMethods
+            
             named_scope :logged_in, lambda { {:conditions => ["last_request_at > ?", logged_in_timeout.seconds.ago]} }
             named_scope :logged_out, lambda { {:conditions => ["last_request_at is NULL or last_request_at <= ?", logged_in_timeout.seconds.ago]} }
           end
         end
         
-        # Returns true if the last_request_at > logged_in_timeout.
-        def logged_in?
-          raise "Can not determine the records login state because there is no last_request_at column" if !respond_to?(:last_request_at)
-          !last_request_at.nil? && last_request_at > logged_in_timeout.seconds.ago
-        end
-        
-        # Opposite of logged_in?
-        def logged_out?
-          !logged_in?
-        end
+        module InstanceMethods
+          # Returns true if the last_request_at > logged_in_timeout.
+          def logged_in?
+            raise "Can not determine the records login state because there is no last_request_at column" if !respond_to?(:last_request_at)
+            !last_request_at.nil? && last_request_at > logged_in_timeout.seconds.ago
+          end
         
-        private
-          def logged_in_timeout
-            self.class.logged_in_timeout
+          # Opposite of logged_in?
+          def logged_out?
+            !logged_in?
           end
+        
+          private
+            def logged_in_timeout
+              self.class.logged_in_timeout
+            end
+        end
       end
     end
   end

data/lib/authlogic/acts_as_authentic/login.rb

@@ -16,7 +16,7 @@ module Authlogic
         # * <tt>Default:</tt> :login or :username, if they exist
         # * <tt>Accepts:</tt> Symbol
         def login_field(value = nil)
-          config(:login_field, value, first_column_to_exist(nil, :login, :username))
+          rw_config(:login_field, value, first_column_to_exist(nil, :login, :username))
         end
         alias_method :login_field=, :login_field
         
@@ -25,37 +25,113 @@ module Authlogic
         # * <tt>Default:</tt> true
         # * <tt>Accepts:</tt> Boolean
         def validate_login_field(value = nil)
-          config(:validate_login_field, value, true)
+          rw_config(:validate_login_field, value, true)
         end
         alias_method :validate_login_field=, :validate_login_field
         
         # A hash of options for the validates_length_of call for the login field. Allows you to change this however you want.
         #
-        # * <tt>Default:</tt> {:within => 6..100}
+        # <b>Keep in mind this is ruby. I wanted to keep this as flexible as possible, so you can completely replace the hash or
+        # merge options into it. Checkout the convenience function merge_validates_length_of_login_field_options to merge
+        # options.</b>
+        #
+        # * <tt>Default:</tt> {:within => 3..100}
         # * <tt>Accepts:</tt> Hash of options accepted by validates_length_of
         def validates_length_of_login_field_options(value = nil)
-          config(:validates_length_of_login_field_options, value, {:within => 3..100})
+          rw_config(:validates_length_of_login_field_options, value, {:within => 3..100})
         end
         alias_method :validates_length_of_login_field_options=, :validates_length_of_login_field_options
         
-        # A hash of options for the validates_format_of call for the email field. Allows you to change this however you want.
+        # A convenience function to merge options into the validates_length_of_login_field_options. So intead of:
+        #
+        #   self.validates_length_of_login_field_options = validates_length_of_login_field_options.merge(:my_option => my_value)
+        #
+        # You can do this:
+        #
+        #   merge_validates_length_of_login_field_options :my_option => my_value
+        def merge_validates_length_of_login_field_options(options = {})
+          self.validates_length_of_login_field_options = validates_length_of_login_field_options.merge(options)
+        end
+        
+        # A hash of options for the validates_format_of call for the login field. Allows you to change this however you want.
+        #
+        # <b>Keep in mind this is ruby. I wanted to keep this as flexible as possible, so you can completely replace the hash or
+        # merge options into it. Checkout the convenience function merge_validates_format_of_login_field_options to merge
+        # options.</b>
         #
-        # * <tt>Default:</tt> {:with => /\A\w[\w\.\-_@ ]+\z/, :message => I18n.t('error_messages.login_invalid', :default => "should use only letters, numbers, spaces, and .-_@ please.")}
+        # * <tt>Default:</tt> {:with => Authlogic::Regex.login, :message => I18n.t('error_messages.login_invalid', :default => "should use only letters, numbers, spaces, and .-_@ please.")}
         # * <tt>Accepts:</tt> Hash of options accepted by validates_format_of
         def validates_format_of_login_field_options(value = nil)
-          config(:validates_format_of_login_field_options, value, {:with => /\A\w[\w\.\-_@ ]+\z/, :message => I18n.t('error_messages.login_invalid', :default => "should use only letters, numbers, spaces, and .-_@ please.")})
+          rw_config(:validates_format_of_login_field_options, value, {:with => Authlogic::Regex.login, :message => I18n.t('error_messages.login_invalid', :default => "should use only letters, numbers, spaces, and .-_@ please.")})
         end
         alias_method :validates_format_of_login_field_options=, :validates_format_of_login_field_options
+        
+        # See merge_validates_length_of_login_field_options. The same thing, except for validates_format_of_login_field_options
+        def merge_validates_format_of_login_field_options(options = {})
+          self.validates_format_of_login_field_options = validates_format_of_login_field_options.merge(options)
+        end
+        
+        # A hash of options for the validates_uniqueness_of call for the login field. Allows you to change this however you want.
+        #
+        # <b>Keep in mind this is ruby. I wanted to keep this as flexible as possible, so you can completely replace the hash or
+        # merge options into it. Checkout the convenience function merge_validates_format_of_login_field_options to merge
+        # options.</b>
+        #
+        # * <tt>Default:</tt> {:case_sensitive => false, :scope => validations_scope, :if => "#{login_field}_changed?".to_sym}
+        # * <tt>Accepts:</tt> Hash of options accepted by validates_uniqueness_of
+        def validates_uniqueness_of_login_field_options(value = nil)
+          rw_config(:validates_uniqueness_of_login_field_options, value, {:case_sensitive => false, :scope => validations_scope, :if => "#{login_field}_changed?".to_sym})
+        end
+        alias_method :validates_uniqueness_of_login_field_options=, :validates_uniqueness_of_login_field_options
+        
+        # See merge_validates_length_of_login_field_options. The same thing, except for validates_uniqueness_of_login_field_options
+        def merge_validates_uniqueness_of_login_field_options(options = {})
+          self.validates_uniqueness_of_login_field_options = validates_uniqueness_of_login_field_options.merge(options)
+        end
+        
+        # This method allows you to find a record with the given login. If you notice, with ActiveRecord you have the
+        # validates_uniqueness_of validation function. They give you a :case_sensitive option. I handle this in the same
+        # manner that they handle that. If you are using the login field and set false for the :case_sensitive option in
+        # validates_uniqueness_of_login_field_options this method will modify the query to look something like:
+        #
+        #   first(:conditions => ["LOWER(#{quoted_table_name}.#{login_field}) = ?", login.downcase])
+        #
+        # If you don't specify this it calls the good old find_by_* method:
+        #
+        #   find_by_login(login)
+        #
+        # The above also applies for using email as your login, except that you need to set the :case_sensitive in
+        # validates_uniqueness_of_email_field_options to false.
+        #
+        # The only reason I need to do the above is for Postgres and SQLite since they perform case sensitive searches with the
+        # find_by_* methods.
+        def find_by_smart_case_login_field(login)
+          if login_field
+            find_with_case(login_field, login, validates_uniqueness_of_login_field_options[:case_sensitive] != false)
+          else
+            find_with_case(email_field, login, validates_uniqueness_of_email_field_options[:case_sensitive] != false)
+          end
+        end
+        
+        private
+          def find_with_case(field, value, sensitivity = true)
+            if sensitivity
+              send("find_by_#{field}", value)
+            else
+              first(:conditions => ["LOWER(#{quoted_table_name}.#{field}) = ?", value.downcase])
+            end
+          end
       end
       
       # All methods relating to the login field
       module Methods
+        # Adds in various validations, modules, etc.
         def self.included(klass)
           klass.class_eval do
             if validate_login_field && login_field
               validates_length_of login_field, validates_length_of_login_field_options
               validates_format_of login_field, validates_format_of_login_field_options
-              validates_uniqueness_of login_field, :scope => validations_scope, :if => "#{login_field}_changed?".to_sym
+              validates_uniqueness_of login_field, validates_uniqueness_of_login_field_options
             end
           end
         end