Ticket #10517: belongs_to_with_inferred_foreign_key_and_docs.patch

test/associations/eager_test.rb

@@ -115 +115 @@
-    assert_equal [2], posts.collect { |p| p.id }
-  end
-  
+  def test_eager_association_loading_with_belongs_to_inferred_foreign_key_from_association_name
+    author_favorite = AuthorFavorite.find(:first, :include => :favorite_author)
+    assert_equal authors(:mary), assert_no_queries { author_favorite.favorite_author }
+  end
+  
-  def test_eager_association_loading_with_explicit_join
-    posts = Post.find(:all, :include => :comments, :joins => "INNER JOIN authors ON posts.author_id = authors.id AND authors.name = 'Mary'", :limit => 1, :order => 'author_id')
-    assert_equal 1, posts.length

test/fixtures/author.rb

@@ -105 +105 @@
-
-class AuthorFavorite < ActiveRecord::Base
-  belongs_to :author
-, :foreign_key => 'favorite_author_id'
+
-end

lib/active_record/associations.rb

@@ -772 +772 @@
-      # * <tt>:order</tt>       - specify the order in which the associated objects are returned as an <tt>ORDER BY</tt> SQL fragment,
-      #   such as <tt>last_name, first_name DESC</tt>
-      # * <tt>:foreign_key</tt> - specify the foreign key used for the association. By default this is guessed to be the name
-ed class in lower-case and +_id+ suffixed. So a +Person+ class that makes a +belongs_to+ association to a
-+Boss+ class will use +boss_id+ as the default +foreign_key
+ion with an +_id+ suffix. So a class that defines a +belongs_to :person+ association will use +person_id+ as the default +foreign_key+.
+Similarly, +belongs_to :favorite_person, :class_name => "Person"+ will use a foreign key of +favorite_person_id
-      # * <tt>:counter_cache</tt> - caches the number of belonging objects on the associate class through the use of +increment_counter+ 
-      #   and +decrement_counter+. The counter cache is incremented when an object of this class is created and decremented when it's
-      #   destroyed. This requires that a column named <tt>#{table_name}_count</tt> (such as +comments_count+ for a belonging +Comment+ class)
@@ -1707 +1707 @@
-                     connection.quote_table_name(aliased_table_name),
-                     reflection.klass.primary_key,
-                     connection.quote_table_name(parent.aliased_table_name),
-klass.to_s.foreign_key
+reflection.primary_key_name
-                    ]
-                else
-                  ""