activerecord-postgresql-extensions 0.0.10 → 0.0.11

data/Rakefile

@@ -4,7 +4,7 @@
 require 'rubygems'
 require 'rubygems/package_task'
 require 'rake/testtask'
-require 'rake/rdoctask'
+require 'rdoc/task'
 
 if RUBY_VERSION >= '1.9'
   begin
@@ -35,7 +35,7 @@ end
 
 desc 'Test PostgreSQL extensions'
 Rake::TestTask.new(:test) do |t|
-  t.pattern = 'test/**/*_test.rb'
+  t.test_files = FileList['test/**/*_tests.rb']
   t.verbose = false
 end
 

data/VERSION

@@ -1 +1 @@
-0.0.10
+0.0.11

data/activerecord-postgresql-extensions.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "activerecord-postgresql-extensions"
-  s.version = "0.0.10"
+  s.version = "0.0.11"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["J Smith"]
-  s.date = "2011-10-05"
+  s.date = "2011-11-09"
   s.description = "A whole bunch of extensions the ActiveRecord PostgreSQL adapter."
   s.email = "code@zoocasa.com"
   s.extra_rdoc_files = [
@@ -25,6 +25,7 @@ Gem::Specification.new do |s|
     "lib/postgresql_extensions/foreign_key_associations.rb",
     "lib/postgresql_extensions/postgresql_adapter_extensions.rb",
     "lib/postgresql_extensions/postgresql_constraints.rb",
+    "lib/postgresql_extensions/postgresql_extensions.rb",
     "lib/postgresql_extensions/postgresql_functions.rb",
     "lib/postgresql_extensions/postgresql_geometry.rb",
     "lib/postgresql_extensions/postgresql_indexes.rb",
@@ -35,27 +36,29 @@ Gem::Specification.new do |s|
     "lib/postgresql_extensions/postgresql_schemas.rb",
     "lib/postgresql_extensions/postgresql_sequences.rb",
     "lib/postgresql_extensions/postgresql_tables.rb",
+    "lib/postgresql_extensions/postgresql_text_search.rb",
     "lib/postgresql_extensions/postgresql_triggers.rb",
     "lib/postgresql_extensions/postgresql_types.rb",
     "lib/postgresql_extensions/postgresql_views.rb",
-    "postgresql-extensions.gemspec",
-    "test/adapter_test.rb",
-    "test/constraints_test.rb",
-    "test/functions_test.rb",
-    "test/geometry_test.rb",
-    "test/index_test.rb",
-    "test/languages_test.rb",
-    "test/permissions_test.rb",
-    "test/roles_test.rb",
-    "test/rules_test.rb",
-    "test/schemas_test.rb",
-    "test/sequences_test.rb",
-    "test/tables_test.rb",
-    "test/test_helper.rb"
+    "test/adapter_tests.rb",
+    "test/constraints_tests.rb",
+    "test/extensions_tests.rb",
+    "test/functions_tests.rb",
+    "test/geometry_tests.rb",
+    "test/index_tests.rb",
+    "test/languages_tests.rb",
+    "test/permissions_tests.rb",
+    "test/roles_tests.rb",
+    "test/rules_tests.rb",
+    "test/schemas_tests.rb",
+    "test/sequences_tests.rb",
+    "test/tables_tests.rb",
+    "test/test_helper.rb",
+    "test/text_search_tests.rb"
   ]
   s.homepage = "http://github.com/zoocasa/activerecord-postgresql-extensions"
   s.require_paths = ["lib"]
-  s.rubygems_version = "1.8.10"
+  s.rubygems_version = "1.8.11"
   s.summary = "A whole bunch of extensions the ActiveRecord PostgreSQL adapter."
 
   if s.respond_to? :specification_version then

data/lib/activerecord-postgresql-extensions.rb

@@ -22,6 +22,8 @@ dirname = File.join(File.dirname(__FILE__), 'postgresql_extensions')
   postgresql_geometry
   postgresql_types
   postgresql_roles
+  postgresql_text_search
+  postgresql_extensions
   foreign_key_associations
 }.each do |file|
   require File.join(dirname, file)

data/lib/postgresql_extensions/postgresql_adapter_extensions.rb

@@ -57,16 +57,15 @@ module ActiveRecord
       #
       # Examples:
       #
-      #  ### ruby
-      #  # should produce '"geospatial"."my_tables"
-      #  with_schema :geospatial do
-      #    quote_table_name('my_table')
-      #  end
+      #   # should produce '"geospatial"."my_tables"'
+      #   with_schema :geospatial do
+      #     quote_table_name('my_table')
+      #   end
       #
-      #  # should produce 'SELECT * FROM "geospatial"."models"'
-      #  with_schema :geospatial do
-      #    Model.find(:all)
-      #  end
+      #   # should produce 'SELECT * FROM "geospatial"."models"'
+      #   with_schema :geospatial do
+      #     Model.find(:all)
+      #   end
       def with_schema schema
         scoped_schemas << schema
         begin
@@ -81,30 +80,28 @@ module ActiveRecord
       #
       # Example:
       #
-      #  ### ruby
-      #  with_schema :geospatial do
-      #    create_table(:test) do |t|
-      #      ignore_schema do
-      #        t.integer(
-      #          :ref_id,
-      #          :references => {
-      #            :table => :refs,
-      #            :column => :id,
-      #            :deferrable => true
-      #          }
-      #        )
-      #      end
-      #    end
-      #  end
+      #   with_schema :geospatial do
+      #     create_table(:test) do |t|
+      #       ignore_schema do
+      #         t.integer(
+      #           :ref_id,
+      #           :references => {
+      #             :table => :refs,
+      #             :column => :id,
+      #             :deferrable => true
+      #           }
+      #         )
+      #       end
+      #     end
+      #   end
       #
-      # Should produce:
-      #
-      #  ### sql
-      #  CREATE TABLE "geospatial"."test" (
-      #    "id" serial primary key,
-      #    "ref_id" integer DEFAULT NULL NULL,
-      #    FOREIGN KEY ("ref_id") REFERENCES "refs" ("id")
-      #  )
+      #   # Produces:
+      #   #
+      #   # CREATE TABLE "geospatial"."test" (
+      #   #   "id" serial primary key,
+      #   #   "ref_id" integer DEFAULT NULL NULL,
+      #   #   FOREIGN KEY ("ref_id") REFERENCES "refs" ("id")
+      #   # )
       #
       # Here we see that we used the geospatial schema when naming the
       # test table and dropped back to not specifying a schema when
@@ -112,8 +109,7 @@ module ActiveRecord
       # used ignore_schema, the foreign key would have been defined
       # thusly:
       #
-      #  ### sql
-      #  FOREIGN KEY ("ref_id") REFERENCES "geospatial"."refs" ("id")
+      #   FOREIGN KEY ("ref_id") REFERENCES "geospatial"."refs" ("id")
       def ignore_schema
         with_schema nil do
           yield
@@ -209,22 +205,21 @@ module ActiveRecord
       #
       # Example of using a Hash as a table name:
       #
-      #  ### ruby
-      #  quote_table_name(:geospatial => :epois) # => "geospatial"."epois"
-      #  # => "geospatial"."epois"
+      #   quote_table_name(:geospatial => :epois) # => "geospatial"."epois"
+      #   # => "geospatial"."epois"
       #
-      #  quote_table_name(:epois)
-      #  # => "epois"
+      #   quote_table_name(:epois)
+      #   # => "epois"
       #
-      #  with_schema(:geospatial) { quote_table_name(:epois) }
-      #  # => "geospatial"."epois"
+      #   with_schema(:geospatial) { quote_table_name(:epois) }
+      #   # => "geospatial"."epois"
       #
-      #  with_schema(:geospatial) do
-      #    ignore_schema do
-      #      quote_table_name(:epois)
-      #    end
-      #  end
-      #  # => "epois"
+      #   with_schema(:geospatial) do
+      #     ignore_schema do
+      #       quote_table_name(:epois)
+      #     end
+      #   end
+      #   # => "epois"
       def quote_table_name_with_schemas(name)
         if current_schema || name.is_a?(Hash)
           quote_generic_with_schema(name)
@@ -450,16 +445,16 @@ module ActiveRecord
 
         sql = 'SET '
         sql << "#{duration} " if duration
-        sql << "ROLE #{quote_role(role)}"
+        sql << "ROLE #{quote_role(role)};"
         execute(sql, "Setting current role")
       end
 
       def reset_role
-        execute('RESET ROLE')
+        execute('RESET ROLE;')
       end
 
       def current_role
-        execute('SELECT current_role')
+        execute('SELECT current_role;')
       end
       alias :current_user :current_role
 
@@ -468,7 +463,7 @@ module ActiveRecord
         query(<<-SQL, name).map { |row| row[0] }
           SELECT tablename
           FROM pg_tables
-          WHERE schemaname IN ('pg_catalog')
+          WHERE schemaname IN ('pg_catalog');
         SQL
       end
 
@@ -483,7 +478,7 @@ module ActiveRecord
       alias_method_chain :schema_search_path=, :csv_fix
 
       def schema_search_path_with_csv_fix #:nodoc:
-        @schema_search_path ||= query('SHOW search_path')[0][0].gsub(/, /, ',')
+        @schema_search_path ||= query('SHOW search_path;')[0][0].gsub(/, /, ',')
       end
       alias_method_chain :schema_search_path, :csv_fix
 
@@ -543,6 +538,7 @@ module ActiveRecord
             a.attnum = conkey
               AND
             a.attrelid = conrelid
+          ;
         SQL
 
         query(sql, name).inject([]) do |memo, (tbl, column, referenced_column)|
@@ -603,6 +599,7 @@ module ActiveRecord
             a.attnum = conkey
               AND
             a.attrelid = conrelid
+          ;
         SQL
 
         query(sql, name).inject([]) do |memo, (tbl, column, referenced_column)|
@@ -630,7 +627,7 @@ module ActiveRecord
 
       def change_column_default_with_expression(table_name, column_name, default) #:nodoc:
         if default.is_a?(Hash) && default.has_key?(:expression)
-          execute "ALTER TABLE #{quote_table_name(table_name)} ALTER COLUMN #{quote_column_name(column_name)} SET DEFAULT #{default[:expression]}"
+          execute "ALTER TABLE #{quote_table_name(table_name)} ALTER COLUMN #{quote_column_name(column_name)} SET DEFAULT #{default[:expression]};"
         else
           change_column_default_without_expression(table_name, column_name, default)
         end

data/lib/postgresql_extensions/postgresql_constraints.rb

@@ -31,7 +31,7 @@ module ActiveRecord
       def add_check_constraint(table, expression, options = {})
         sql = "ALTER TABLE #{quote_table_name(table)} ADD "
         sql << PostgreSQLCheckConstraint.new(self, expression, options).to_s
-        execute sql
+        execute("#{sql};")
       end
 
       # Adds a UNIQUE constraint to the table. See
@@ -39,7 +39,7 @@ module ActiveRecord
       def add_unique_constraint(table, columns, options = {})
         sql = "ALTER TABLE #{quote_table_name(table)} ADD "
         sql << PostgreSQLUniqueConstraint.new(self, columns, options).to_s
-        execute sql
+        execute("#{sql};")
       end
 
       # Adds a FOREIGN KEY constraint to the table. See
@@ -47,7 +47,7 @@ module ActiveRecord
       def add_foreign_key(table, columns, ref_table, *args)
         sql = "ALTER TABLE #{quote_table_name(table)} ADD "
         sql << PostgreSQLForeignKeyConstraint.new(self, columns, ref_table, *args).to_s
-        execute sql
+        execute("#{sql};")
       end
 
       # Drops a constraint from the table. Use this to drop CHECK,
@@ -60,7 +60,7 @@ module ActiveRecord
       def drop_constraint(table, name, options = {})
         sql = "ALTER TABLE #{quote_table_name(table)} DROP CONSTRAINT #{quote_generic(name)}"
         sql << ' CASCADE' if options[:cascade]
-        execute sql
+        execute("#{sql};")
       end
     end
 
@@ -119,18 +119,17 @@ module ActiveRecord
     #
     # ==== Example
     #
-    #  ### ruby
-    #  create_table(:foo) do |t|
-    #    t.integer :fancy_id, :check => "fancy_id != 10"
-    #  end
+    #   create_table(:foo) do |t|
+    #     t.integer :fancy_id, :check => "fancy_id != 10"
+    #   end
     #
-    #  # Produces:
-    #  #
-    #  # CREATE TABLE "foo" (
-    #  #   "id" serial primary key,
-    #  #   "fancy_id" integer DEFAULT NULL NULL,
-    #  #   CHECK (fancy_id != 10)
-    #  # );
+    #   # Produces:
+    #   #
+    #   # CREATE TABLE "foo" (
+    #   #   "id" serial primary key,
+    #   #   "fancy_id" integer DEFAULT NULL NULL,
+    #   #   CHECK (fancy_id != 10)
+    #   # );
     #
     # You can also provide an Array to <tt>:check</tt> with multiple CHECK
     # constraints. Each CHECK constraint can be either a String containing
@@ -140,10 +139,9 @@ module ActiveRecord
     # automatically. Thus, the  following is equivalent to the example
     # above:
     #
-    #  ### ruby
-    #  create_table(:foo) do |t|
-    #    t.integer :fancy_id, :check => [ { :expression => "fancy_id != 10" } ]
-    #  end
+    #   create_table(:foo) do |t|
+    #     t.integer :fancy_id, :check => [ { :expression => "fancy_id != 10" } ]
+    #   end
     #
     # See below for additional options.
     #
@@ -154,36 +152,35 @@ module ActiveRecord
     #
     # ==== Examples
     #
-    #  ### ruby
-    #  create_table(:foo) do |t|
-    #    t.integer :fancy_id
-    #    t.integer :another_fancy_id
-    #    t.check_constraint 'fancy_id != another_fancy_id'
-    #  end
-    #
-    #  # Produces:
-    #  #
-    #  # CREATE TABLE "foo" (
-    #  #   "id" serial primary key,
-    #  #   "fancy_id" integer DEFAULT NULL NULL,
-    #  #   "another_fancy_id" integer DEFAULT NULL NULL,
-    #  #   CHECK (fancy_id != another_fancy_id)
-    #  # );
-    #
-    #  create_table(:foo) do |t|
-    #    t.integer :fancy_id
-    #    t.integer :another_fancy_id
-    #    t.check_constraint 'fancy_id != another_fancy_id', :name => 'my_constraint'
-    #  end
-    #
-    #  # Produces:
-    #  #
-    #  # CREATE TABLE "foo" (
-    #  #   "id" serial primary key,
-    #  #   "fancy_id" integer DEFAULT NULL NULL,
-    #  #   "another_fancy_id" integer DEFAULT NULL NULL,
-    #  #   CONSTRAINT "my_constraint" CHECK (fancy_id != another_fancy_id)
-    #  # );
+    #   create_table(:foo) do |t|
+    #     t.integer :fancy_id
+    #     t.integer :another_fancy_id
+    #     t.check_constraint 'fancy_id != another_fancy_id'
+    #   end
+    #
+    #   # Produces:
+    #   #
+    #   # CREATE TABLE "foo" (
+    #   #   "id" serial primary key,
+    #   #   "fancy_id" integer DEFAULT NULL NULL,
+    #   #   "another_fancy_id" integer DEFAULT NULL NULL,
+    #   #   CHECK (fancy_id != another_fancy_id)
+    #   # );
+    #
+    #   create_table(:foo) do |t|
+    #     t.integer :fancy_id
+    #     t.integer :another_fancy_id
+    #     t.check_constraint 'fancy_id != another_fancy_id', :name => 'my_constraint'
+    #   end
+    #
+    #   # Produces:
+    #   #
+    #   # CREATE TABLE "foo" (
+    #   #   "id" serial primary key,
+    #   #   "fancy_id" integer DEFAULT NULL NULL,
+    #   #   "another_fancy_id" integer DEFAULT NULL NULL,
+    #   #   CONSTRAINT "my_constraint" CHECK (fancy_id != another_fancy_id)
+    #   # );
     #
     # See below for additional options.
     #
@@ -194,12 +191,11 @@ module ActiveRecord
     #
     # ==== Example
     #
-    #  ### ruby
-    #  add_check_constraint(:foo, 'fancy_id != 10')
+    #   add_check_constraint(:foo, 'fancy_id != 10')
     #
-    #  # Produces:
-    #  #
-    #  # ALTER TABLE "foo" ADD CHECK (fancy_id != 10);
+    #   # Produces:
+    #   #
+    #   # ALTER TABLE "foo" ADD CHECK (fancy_id != 10);
     #
     # See below for additional options.
     #
@@ -254,18 +250,17 @@ module ActiveRecord
     #
     # ==== Example:
     #
-    #  ### ruby
-    #  create_table(:foo) do |t|
-    #    t.integer :fancy_id, :unique => true
-    #  end
+    #   create_table(:foo) do |t|
+    #     t.integer :fancy_id, :unique => true
+    #   end
     #
-    #  # Produces:
-    #  #
-    #  # CREATE TABLE "foo" (
-    #  #   "id" serial primary key,
-    #  #   "fancy_id" integer DEFAULT NULL NULL,
-    #  #   UNIQUE ("fancy_id")
-    #  # );
+    #   # Produces:
+    #   #
+    #   # CREATE TABLE "foo" (
+    #   #   "id" serial primary key,
+    #   #   "fancy_id" integer DEFAULT NULL NULL,
+    #   #   UNIQUE ("fancy_id")
+    #   # );
     #
     # You can provide additional options to the UNIQUE constraint by
     # passing a Hash instead of true. See below for details on these
@@ -279,21 +274,20 @@ module ActiveRecord
     #
     # ==== Example:
     #
-    #  ### ruby
-    #  create_table(:foo) do |t|
-    #    t.integer :fancy_id
-    #    t.integer :another_fancy_id
-    #    t.unique_constraint [ :fancy_id, :another_fancy_id ]
-    #  end
-    #
-    #  # Produces:
-    #  #
-    #  # CREATE TABLE "foo" (
-    #  #   "id" serial primary key,
-    #  #   "fancy_id" integer DEFAULT NULL NULL,
-    #  #   "another_fancy_id" integer DEFAULT NULL NULL,
-    #  #   UNIQUE ("fancy_id", "another_fancy_id")
-    #  # );
+    #   create_table(:foo) do |t|
+    #     t.integer :fancy_id
+    #     t.integer :another_fancy_id
+    #     t.unique_constraint [ :fancy_id, :another_fancy_id ]
+    #   end
+    #
+    #   # Produces:
+    #   #
+    #   # CREATE TABLE "foo" (
+    #   #   "id" serial primary key,
+    #   #   "fancy_id" integer DEFAULT NULL NULL,
+    #   #   "another_fancy_id" integer DEFAULT NULL NULL,
+    #   #   UNIQUE ("fancy_id", "another_fancy_id")
+    #   # );
     #
     # See below for additional options.
     #
@@ -312,18 +306,17 @@ module ActiveRecord
     #
     # ==== Examples:
     #
-    #  ### ruby
-    #  # using the constraint method:
-    #  add_unique_constraint(:foo, [ :fancy_id, :another_fancy_id ])
-    #  # => ALTER TABLE "foo" ADD UNIQUE ("fancy_id", "another_fancy_id");
+    #   # using the constraint method:
+    #   add_unique_constraint(:foo, [ :fancy_id, :another_fancy_id ])
+    #   # => ALTER TABLE "foo" ADD UNIQUE ("fancy_id", "another_fancy_id");
     #
-    #  # using create_index:
-    #  create_index('my_index_name', :foo, [ :fancy_id, :another_fancy_id ], :unique => true)
-    #  # => CREATE UNIQUE INDEX "my_index_name" ON "foo"("fancy_id", "another_fancy_id");
+    #   # using create_index:
+    #   create_index('my_index_name', :foo, [ :fancy_id, :another_fancy_id ], :unique => true)
+    #   # => CREATE UNIQUE INDEX "my_index_name" ON "foo"("fancy_id", "another_fancy_id");
     #
-    #  # using the standard ActiveRecord add_index:
-    #  add_index(:foo, [ :fancy_id, :another_fancy_id ], :unique => true)
-    #  # => CREATE UNIQUE INDEX "index_foo_on_fancy_id_and_another_fancy_id" ON "foo" ("fancy_id", "another_fancy_id");
+    #   # using the standard ActiveRecord add_index:
+    #   add_index(:foo, [ :fancy_id, :another_fancy_id ], :unique => true)
+    #   # => CREATE UNIQUE INDEX "index_foo_on_fancy_id_and_another_fancy_id" ON "foo" ("fancy_id", "another_fancy_id");
     #
     # You'll notice that in create_index we must manually supply a name
     # while add_index can generate one for us automatically. See the
@@ -395,18 +388,17 @@ module ActiveRecord
     #
     # ==== Example:
     #
-    #  ### ruby
-    #  create_table(:foo) do |t|
-    #    t.integer :bar_id, :references => { :table => :bar, :column => :id }
-    #  end
+    #   create_table(:foo) do |t|
+    #     t.integer :bar_id, :references => { :table => :bar, :column => :id }
+    #   end
     #
-    #  # Produces:
-    #  #
-    #  # CREATE TABLE "foo" (
-    #  #   "id" serial primary key,
-    #  #   "bar_id" integer DEFAULT NULL NULL,
-    #  #   FOREIGN KEY ("bar_id") REFERENCES "bar" ("id")
-    #  # );
+    #   # Produces:
+    #   #
+    #   # CREATE TABLE "foo" (
+    #   #   "id" serial primary key,
+    #   #   "bar_id" integer DEFAULT NULL NULL,
+    #   #   FOREIGN KEY ("bar_id") REFERENCES "bar" ("id")
+    #   # );
     #
     # You can leave out the :column option if you are following the Rails
     # standards for foreign key referral, as PostgreSQL automatically
@@ -426,54 +418,52 @@ module ActiveRecord
     #
     # The following example produces the same result as above:
     #
-    #  ### ruby
-    #  create_table(:foo) do |t|
-    #    t.integer :bar_id
-    #    t.foreign_key :bar_id, :bar, :id
-    #  end
+    #   create_table(:foo) do |t|
+    #     t.integer :bar_id
+    #     t.foreign_key :bar_id, :bar, :id
+    #   end
     #
-    #  # Produces:
-    #  #
-    #  # CREATE TABLE "foo" (
-    #  #   "id" serial primary key,
-    #  #   "bar_id" integer DEFAULT NULL NULL,
-    #  #   FOREIGN KEY ("bar_id") REFERENCES "bar" ("id")
-    #  # );
+    #   # Produces:
+    #   #
+    #   # CREATE TABLE "foo" (
+    #   #   "id" serial primary key,
+    #   #   "bar_id" integer DEFAULT NULL NULL,
+    #   #   FOREIGN KEY ("bar_id") REFERENCES "bar" ("id")
+    #   # );
     #
     # Defining a FOREIGN KEY constraint on the table-level allows you to
     # create multicolumn foreign keys. You can define these super advanced
     # foreign keys thusly:
     #
-    #  ### ruby
-    #  create_table(:foo) {}
-    #
-    #  create_table(:bar) do |t|
-    #    t.integer :foo_id
-    #    t.unique_constraint [ :id, :foo_id ]
-    #  end
-    #
-    #  create_table(:funk) do |t|
-    #    t.integer :bar_id
-    #    t.foreign_key [ :id, :bar_id ], :bar, [ :id, :foo_id ]
-    #  end
-    #
-    #  # Produces:
-    #  #
-    #  # CREATE TABLE "foo" (
-    #  #   "id" serial primary key
-    #  # );
-    #  #
-    #  # CREATE TABLE "bar" (
-    #  #   "id" serial primary key,
-    #  #   "foo_id" integer DEFAULT NULL NULL,
-    #  #   UNIQUE ("id", "foo_id")
-    #  # );
-    #  #
-    #  # CREATE TABLE "funk" (
-    #  #   "id" serial primary key,
-    #  #   "bar_id" integer DEFAULT NULL NULL,
-    #  #   FOREIGN KEY ("id", "bar_id") REFERENCES "bar" ("id", "foo_id")
-    #  # );
+    #   create_table(:foo) {}
+    #
+    #   create_table(:bar) do |t|
+    #     t.integer :foo_id
+    #     t.unique_constraint [ :id, :foo_id ]
+    #   end
+    #
+    #   create_table(:funk) do |t|
+    #     t.integer :bar_id
+    #     t.foreign_key [ :id, :bar_id ], :bar, [ :id, :foo_id ]
+    #   end
+    #
+    #   # Produces:
+    #   #
+    #   # CREATE TABLE "foo" (
+    #   #   "id" serial primary key
+    #   # );
+    #   #
+    #   # CREATE TABLE "bar" (
+    #   #   "id" serial primary key,
+    #   #   "foo_id" integer DEFAULT NULL NULL,
+    #   #   UNIQUE ("id", "foo_id")
+    #   # );
+    #   #
+    #   # CREATE TABLE "funk" (
+    #   #   "id" serial primary key,
+    #   #   "bar_id" integer DEFAULT NULL NULL,
+    #   #   FOREIGN KEY ("id", "bar_id") REFERENCES "bar" ("id", "foo_id")
+    #   # );
     #
     # === Table Manipulation
     #
@@ -482,18 +472,17 @@ module ActiveRecord
     #
     # ==== Examples:
     #
-    #  ### ruby
-    #  add_foreign_key(:foo, :bar_id, :bar)
-    #  # => ALTER TABLE "funk" ADD FOREIGN KEY ("bar_id") REFERENCES "bar";
+    #   add_foreign_key(:foo, :bar_id, :bar)
+    #   # => ALTER TABLE "funk" ADD FOREIGN KEY ("bar_id") REFERENCES "bar";
     #
-    #  add_foreign_key(:foo, :bar_id, :bar, :id)
-    #  # => ALTER TABLE "funk" ADD FOREIGN KEY ("bar_id") REFERENCES "bar"("id");
+    #   add_foreign_key(:foo, :bar_id, :bar, :id)
+    #   # => ALTER TABLE "funk" ADD FOREIGN KEY ("bar_id") REFERENCES "bar"("id");
     #
-    #  add_foreign_key(:foo, [ :bar_id, :blort_id ], :bar, [ :id, :blort_id ],
-    #    :name => 'my_fk', :match => :simple
-    #  )
-    #  # => ALTER TABLE "foo" ADD CONSTRAINT "my_fk" FOREIGN KEY ("id", "blort_id")
-    #  #    REFERENCES "bar" ("id", "blort_id") MATCH SIMPLE;
+    #   add_foreign_key(:foo, [ :bar_id, :blort_id ], :bar, [ :id, :blort_id ],
+    #     :name => 'my_fk', :match => :simple
+    #   )
+    #   # => ALTER TABLE "foo" ADD CONSTRAINT "my_fk" FOREIGN KEY ("id", "blort_id")
+    #   #    REFERENCES "bar" ("id", "blort_id") MATCH SIMPLE;
     #
     # === Options for FOREIGN KEY Constraints
     #