db_leftovers 1.1.1 → 1.2.0

data/.gitignore

@@ -0,0 +1,53 @@
+# rcov generated
+coverage
+
+# rdoc generated
+rdoc
+
+# yard generated
+doc
+.yardoc
+
+# bundler
+.bundle
+
+# jeweler generated
+pkg
+
+# Have editor/IDE/OS specific files you need to ignore? Consider using a global gitignore: 
+#
+# * Create a file at ~/.gitignore
+# * Include files you want ignored
+# * Run: git config --global core.excludesfile ~/.gitignore
+#
+# After doing this, these files will be ignored in all your git projects,
+# saving you from having to 'pollute' every project you touch with them
+#
+# Not sure what to needs to be ignored for particular editors/OSes? Here's some ideas to get you started. (Remember, remove the leading # of the line)
+#
+# For MacOS:
+#
+#.DS_Store
+
+# For TextMate
+#*.tmproj
+#tmtags
+
+# For emacs:
+#*~
+#\#*
+#.\#*
+
+# For vim:
+.*.swp
+.*.swo
+
+# For redcar:
+#.redcar
+
+# For rubinius:
+#*.rbc
+
+tmp
+README.html
+spec/config/database.yml

data/Gemfile

@@ -13,8 +13,6 @@ gem 'rails', '>= 3.0.0'
 group :development do
   gem "rspec", "~> 2.4.0"
   gem "bundler"
-  gem "jeweler", "~> 1.6.4"
-  gem "rcov", ">= 0"
 end
 
 group :test do

data/Gemfile.lock

@@ -44,15 +44,10 @@ GEM
     builder (3.0.0)
     diff-lcs (1.1.3)
     erubis (2.7.0)
-    git (1.2.5)
     hike (1.2.1)
     i18n (0.6.0)
     jdbc-mysql (5.1.13)
     jdbc-postgres (9.1.901)
-    jeweler (1.6.4)
-      bundler (~> 1.0)
-      git (>= 1.2.5)
-      rake
     json (1.6.5)
     json (1.6.5-java)
     mail (2.3.0)
@@ -89,8 +84,6 @@ GEM
       rdoc (~> 3.4)
       thor (~> 0.14.6)
     rake (0.9.2.2)
-    rcov (0.9.11)
-    rcov (0.9.11-java)
     rdoc (3.12)
       json (~> 1.4)
     rspec (2.4.0)
@@ -122,7 +115,5 @@ DEPENDENCIES
   activerecord-mysql2-adapter
   activerecord-postgresql-adapter
   bundler
-  jeweler (~> 1.6.4)
   rails (>= 3.0.0)
-  rcov
   rspec (~> 2.4.0)

data/README.md

@@ -102,6 +102,13 @@ The `table` call is just a convenience so you can group all a table's indexes et
 
 You can repeat `table` calls for the same table several times if you like. This lets you put your indexes in one place and your foreign keys in another, for example.
 
+### ignore(table\_name, [table\_name, ...])
+
+Lets you specify one or more tables you'd like db\_leftovers to ignore completely. No objects will be added/removed to these tables. This is useful if you have tables that shouldn't be managed under db\_leftovers.
+
+If you don't call `ignore`, the list of ignored tables defaults to `schema_migrations` and `delayed_jobs`. If you do call `ignore`, you should probably include those in your list. If you do want db\_leftovers to manage those tables, just say `ignore []`.
+
+
 
 Running db\_leftovers
 ---------------------
@@ -120,7 +127,7 @@ and want books to have at least 100 pages, you can change your config file to sa
 and db\_leftovers will notice the changed expression. It will drop and re-add the constraint.
 
 One caveat, however: we pull the current expression from the database, and sometimes Postgres does things like
-add type conversions and extra parentheses. If instance, suppose you said `check :users, :email_length, 'LENGTH(email) > 2'`.
+add type conversions and extra parentheses. For instance, suppose you said `check :users, :email_length, 'LENGTH(email) > 2'`.
 The second time you run db\_leftovers, it will read the expression from Postgres and get `length((email)::text) > 2`,
 and so it will drop and re-create the constraint.
 It will drop and re-create it every time you run the rake task.

data/Rakefile

@@ -9,48 +9,19 @@ rescue Bundler::BundlerError => e
   $stderr.puts "Run `bundle install` to install missing gems"
   exit e.status_code
 end
-require 'rake'
 
-require 'jeweler'
-Jeweler::Tasks.new do |gem|
-  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
-  gem.name = "db_leftovers"
-  gem.homepage = "http://github.com/pjungwir/db_leftovers"
-  gem.license = "MIT"
-  gem.summary = 'Used to define indexes and foreign keys for your Rails app'
-  gem.description = <<-EOT
-        Define indexes and foreign keys for your Rails app
-        in one place using an easy-to-read DSL,
-        then run a rake task to bring your database up-to-date.
-  EOT
-  gem.email = "pj@illuminatedcomputing.com"
-  gem.authors = ["Paul A. Jungwirth"]
-  # dependencies defined in Gemfile
-end
-Jeweler::RubygemsDotOrgTasks.new
 
 require 'rspec/core'
 require 'rspec/core/rake_task'
 RSpec::Core::RakeTask.new(:spec) do |spec|
   spec.pattern = FileList['spec/**/*_spec.rb']
 end
-
-RSpec::Core::RakeTask.new(:rcov) do |spec|
-  spec.pattern = 'spec/**/*_spec.rb'
-  spec.rcov = true
-end
-
+desc 'Default: run specs'
 task :default => :spec
 
-require 'rdoc/task'
-Rake::RDocTask.new do |rdoc|
-  version = File.exist?('VERSION') ? File.read('VERSION') : ""
 
-  rdoc.rdoc_dir = 'rdoc'
-  rdoc.title = "db_leftovers #{version}"
-  rdoc.rdoc_files.include('README*')
-  rdoc.rdoc_files.include('lib/**/*.rb')
-end
+Bundler::GemHelper.install_tasks
+
 
 task :readme => [] do |task|
   `markdown README.md >README.html`

data/db_leftovers.gemspec

@@ -1,81 +1,28 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
-# -*- encoding: utf-8 -*-
+$:.push File.dirname(__FILE__) + '/lib'
+require 'db_leftovers/version'
 
 Gem::Specification.new do |s|
   s.name = "db_leftovers"
-  s.version = "1.1.1"
+  s.version = DbLeftovers::VERSION
+  s.date = "2013-01-15"
 
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Paul A. Jungwirth"]
-  s.date = "2012-10-11"
+  s.summary = "Used to define indexes and foreign keys for your Rails app"
   s.description = "        Define indexes and foreign keys for your Rails app\n        in one place using an easy-to-read DSL,\n        then run a rake task to bring your database up-to-date.\n"
-  s.email = "pj@illuminatedcomputing.com"
-  s.extra_rdoc_files = [
-    "LICENSE.txt",
-    "README.html",
-    "README.md",
-    "TODO"
-  ]
-  s.files = [
-    ".document",
-    "Gemfile",
-    "Gemfile.lock",
-    "LICENSE.txt",
-    "README.md",
-    "Rakefile",
-    "TODO",
-    "VERSION",
-    "db_leftovers.gemspec",
-    "lib/db_leftovers.rb",
-    "lib/db_leftovers/constraint.rb",
-    "lib/db_leftovers/definition.rb",
-    "lib/db_leftovers/dsl.rb",
-    "lib/db_leftovers/foreign_key.rb",
-    "lib/db_leftovers/generic_database_interface.rb",
-    "lib/db_leftovers/index.rb",
-    "lib/db_leftovers/mysql_database_interface.rb",
-    "lib/db_leftovers/postgres_database_interface.rb",
-    "lib/db_leftovers/table_dsl.rb",
-    "lib/tasks/leftovers.rake",
-    "spec/config/database.yml.sample",
-    "spec/db_leftovers_spec.rb",
-    "spec/mysql_spec.rb",
-    "spec/postgres_spec.rb",
-    "spec/spec_helper.rb",
-    "spec/support/mock_database_interface.rb",
-    "spec/support/shared_db_tests.rb",
-    "spec/support/sql_matcher.rb"
-  ]
+
+  s.authors = ["Paul A. Jungwirth"]
   s.homepage = "http://github.com/pjungwir/db_leftovers"
+  s.email = "pj@illuminatedcomputing.com"
+
   s.licenses = ["MIT"]
+
   s.require_paths = ["lib"]
-  s.rubygems_version = "1.8.24"
-  s.summary = "Used to define indexes and foreign keys for your Rails app"
+  s.executables = []
+  s.files = `git ls-files`.split("\n")
+  s.test_files = `git ls-files -- {test,spec,fixtures}/*`.split("\n")
 
-  if s.respond_to? :specification_version then
-    s.specification_version = 3
+  s.add_runtime_dependency 'rails', '>= 3.0.0'
+  s.add_development_dependency 'rspec', '~> 2.4.0'
+  s.add_development_dependency 'bundler', '>= 0'
 
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<rails>, [">= 3.0.0"])
-      s.add_development_dependency(%q<rspec>, ["~> 2.4.0"])
-      s.add_development_dependency(%q<bundler>, [">= 0"])
-      s.add_development_dependency(%q<jeweler>, ["~> 1.6.4"])
-      s.add_development_dependency(%q<rcov>, [">= 0"])
-    else
-      s.add_dependency(%q<rails>, [">= 3.0.0"])
-      s.add_dependency(%q<rspec>, ["~> 2.4.0"])
-      s.add_dependency(%q<bundler>, [">= 0"])
-      s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
-      s.add_dependency(%q<rcov>, [">= 0"])
-    end
-  else
-    s.add_dependency(%q<rails>, [">= 3.0.0"])
-    s.add_dependency(%q<rspec>, ["~> 2.4.0"])
-    s.add_dependency(%q<bundler>, [">= 0"])
-    s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
-    s.add_dependency(%q<rcov>, [">= 0"])
-  end
 end
 

data/lib/db_leftovers/dsl.rb

@@ -10,6 +10,8 @@ module DBLeftovers
       @verbose = !!opts[:verbose]
       @db = opts[:db_interface] || get_database_interface
 
+      @ignored_tables = Set.new(['delayed_jobs', 'schema_migrations'].map{|x| [x.to_s, x.to_sym]}.flatten)
+
       @indexes_by_table = {}      # Set from the DSL
       @old_indexes = @db.lookup_all_indexes
       @new_indexes = {}
@@ -27,6 +29,12 @@ module DBLeftovers
       instance_eval(&block)
     end
 
+    def ignore(*table_names)
+      table_names = [table_names] unless table_names.is_a? Array
+      table_names = table_names.map{|x| [x.to_s, x.to_sym]}.flatten
+      @ignored_tables = Set.new(table_names)
+    end
+
     def table(table_name, &block)
       table_dsl = TableDSL.new(self, table_name)
       table_dsl.define(&block)
@@ -73,6 +81,7 @@ module DBLeftovers
       # First create any new indexes:
       @indexes_by_table.each do |table_name, indexes|
         indexes.each do |idx|
+          next if ignore_index?(idx)
           # puts "#{idx.table_name}.[#{idx.column_names.join(',')}]"
           case index_status(idx)
           when STATUS_EXISTS
@@ -91,6 +100,7 @@ module DBLeftovers
 
       # Now drop any old indexes that are no longer in the definition file:
       @old_indexes.each do |index_name, idx|
+        next if ignore_index?(idx)
         if not @new_indexes[index_name]
           # puts "#{index_name} #{table_name}"
           @db.execute_drop_index(idx.table_name, index_name)
@@ -103,6 +113,7 @@ module DBLeftovers
       # First create any new foreign keys:
       @foreign_keys_by_table.each do |table_name, fks|
         fks.each do |fk|
+          next if ignore_foreign_key?(fk)
           case foreign_key_status(fk)
           when STATUS_EXISTS
             puts "Foreign Key already exists: #{fk.constraint_name} on #{fk.from_table}" if @verbose
@@ -120,6 +131,7 @@ module DBLeftovers
 
       # Now drop any old foreign keys that are no longer in the definition file:
       @old_foreign_keys.each do |constraint_name, fk|
+        next if ignore_foreign_key?(fk)
         if not @new_foreign_keys[constraint_name]
           @db.execute_drop_foreign_key(constraint_name, fk.from_table, fk.from_column)
           puts "Dropped foreign key: #{constraint_name} on #{fk.from_table}"
@@ -131,6 +143,7 @@ module DBLeftovers
       # First create any new constraints:
       @constraints_by_table.each do |table_name, chks|
         chks.each do |chk|
+          next if ignore_constraint?(chk)
           case constraint_status(chk)
           when STATUS_EXISTS
             puts "Constraint already exists: #{chk.constraint_name} on #{chk.on_table}" if @verbose
@@ -148,6 +161,7 @@ module DBLeftovers
 
       # Now drop any old constraints that are no longer in the definition file:
       @old_constraints.each do |constraint_name, chk|
+        next if ignore_constraint?(chk)
         if not @new_constraints[constraint_name]
           @db.execute_drop_constraint(constraint_name, chk.on_table)
           puts "Dropped CHECK constraint: #{constraint_name} on #{chk.on_table}"
@@ -234,6 +248,18 @@ module DBLeftovers
       end
     end
 
+    def ignore_index?(idx)
+      @ignored_tables.include?(idx.table_name)
+    end
+
+    def ignore_foreign_key?(fk)
+      @ignored_tables.include?(fk.from_table)
+    end
+
+    def ignore_constraint?(chk)
+      @ignored_tables.include?(chk.on_table)
+    end
+
   end
 
 end

data/lib/db_leftovers/postgres_database_interface.rb

@@ -26,7 +26,6 @@ module DBLeftovers
           AND     t.relkind = 'r'
           AND     n.nspname NOT IN ('pg_catalog', 'pg_toast')
           AND     pg_catalog.pg_table_is_visible(t.oid)
-          AND     t.relname NOT IN ('delayed_jobs', 'schema_migrations')
           AND     NOT ix.indisprimary
           GROUP BY  t.relname,
                     i.relname,

data/lib/db_leftovers/version.rb

@@ -0,0 +1,3 @@
+module DbLeftovers
+  VERSION = '1.2.0'
+end

data/spec/db_leftovers_spec.rb

@@ -459,4 +459,45 @@ describe DBLeftovers do
     EOQ
   end
 
+  it "should not try to change anything on an ignored table" do
+    @db.starts_with([
+      DBLeftovers::Index.new(:books, :shelf_id),
+    ], [
+      DBLeftovers::ForeignKey.new('fk_books_shelf_id', 'books', 'shelf_id', 'shelves', 'id'),
+      DBLeftovers::ForeignKey.new('fk_books_author_id', 'books', 'author_id', 'authors', 'id')
+    ], [
+      DBLeftovers::Constraint.new(:books_have_positive_pages, :books, 'pages_count > 0')
+    ])
+    DBLeftovers::Definition.define :db_interface => @db do
+      ignore :books
+    end
+    @db.sqls.should have(0).items
+  end
+
+  it "should accept multiple ignored tables" do
+    @db.starts_with([
+      DBLeftovers::Index.new(:books, :shelf_id),
+      DBLeftovers::Index.new(:authors, :last_name),
+    ], [
+      DBLeftovers::ForeignKey.new('fk_books_shelf_id', 'books', 'shelf_id', 'shelves', 'id'),
+      DBLeftovers::ForeignKey.new('fk_books_author_id', 'books', 'author_id', 'authors', 'id')
+    ], [
+      DBLeftovers::Constraint.new(:books_have_positive_pages, :books, 'pages_count > 0')
+    ])
+    DBLeftovers::Definition.define :db_interface => @db do
+      ignore :books, :authors
+    end
+    @db.sqls.should have(0).items
+  end
+
+  it "should ignore schema_migrations and delayed_jobs by default" do
+    @db.starts_with([
+      DBLeftovers::Index.new(:schema_migrations, :foo),
+      DBLeftovers::Index.new(:delayed_jobs, :bar),
+    ], [], [])
+    DBLeftovers::Definition.define :db_interface => @db do
+    end
+    @db.sqls.should have(0).items
+  end
+
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: db_leftovers
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-10-11 00:00:00.000000000 Z
+date: 2013-01-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -59,58 +59,22 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: jeweler
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 1.6.4
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 1.6.4
-- !ruby/object:Gem::Dependency
-  name: rcov
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
 description: ! "        Define indexes and foreign keys for your Rails app\n        in
   one place using an easy-to-read DSL,\n        then run a rake task to bring your
   database up-to-date.\n"
 email: pj@illuminatedcomputing.com
 executables: []
 extensions: []
-extra_rdoc_files:
-- LICENSE.txt
-- README.html
-- README.md
-- TODO
+extra_rdoc_files: []
 files:
 - .document
+- .gitignore
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
 - TODO
-- VERSION
 - db_leftovers.gemspec
 - lib/db_leftovers.rb
 - lib/db_leftovers/constraint.rb
@@ -122,6 +86,7 @@ files:
 - lib/db_leftovers/mysql_database_interface.rb
 - lib/db_leftovers/postgres_database_interface.rb
 - lib/db_leftovers/table_dsl.rb
+- lib/db_leftovers/version.rb
 - lib/tasks/leftovers.rake
 - spec/config/database.yml.sample
 - spec/db_leftovers_spec.rb
@@ -131,7 +96,6 @@ files:
 - spec/support/mock_database_interface.rb
 - spec/support/shared_db_tests.rb
 - spec/support/sql_matcher.rb
-- README.html
 homepage: http://github.com/pjungwir/db_leftovers
 licenses:
 - MIT
@@ -147,7 +111,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -4583534380635157212
+      hash: 1094789418074050073
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:

data/README.html

@@ -1,190 +0,0 @@
-<h1>db_leftovers</h1>
-
-<p>Db_leftovers lets you define indexes, foreign keys, and CHECK constraints for your Rails app
-in one place using an easy-to-read DSL,
-then run a rake task to bring your database up-to-date.
-Whenever you edit the DSL, you can re-run the rake task and db_leftovers will alter your database accordingly.
-This is useful because of the following limitations in vanilla Rails:</p>
-
-<ul>
-<li>There are no built-in migration methods to create foreign keys or CHECK constraints.</li>
-<li>Even if created, foreign keys and CHECK constraints won't appear in your schema.rb.</li>
-<li>The built-in <code>add_index</code> method doesn't support WHERE clauses on your indexes.</li>
-<li>If you're using Heroku, <code>db:push</code> and <code>db:pull</code> won't transfer your foreign keys and CHECK constraints.</li>
-<li>Creating indexes in your migrations makes it hard to manage them.</li>
-</ul>
-
-<p>That last point deserves some elaboration. First, using <code>add_index</code> in your migrations is bug-prone because without rare developer discipline, you wind up missing indexes in some environments. (My rule is "never change a migration after a <code>git push</code>," but I haven't seen this followed elsewhere, and there is nothing that automatically enforces it.) Also, since missing indexes don't cause errors, it's easy to be missing one and not notice until users start complaining about performance.</p>
-
-<p>Second, Scattering <code>add_index</code> methods throughout migrations also doesn't match the workflow of optimizing database queries. Hopefully you create appropriate indexes when you set up your tables originally, but in practice you often need to go back later and add/remove indexes according to your database usage patterns. Or you just forget the indexes, because you're thinking about modeling the data, not optimizing the queries.
-It's easier to vet and analyze database indexes if you can see them all in one place,
-and db_leftovers lets you do that easily.
-And since you can rest assured that each environment conforms to the same definition, you don't need to second-guess yourself about indexes that are present in development but missing in production.
-Db_leftovers lets you rest assured that each environment conforms to a definition that is easy to read and checked into version control.</p>
-
-<p>At present db_leftovers supports PostgreSQL and MySQL, although since MySQL doesn't support index WHERE clauses or CHECK constraints, using that functionality will raise errors. (If you need to share the same definitions across Postgres and MySQL, you can run arbitrary Ruby code inside the DSL to avoid defining unsupported objects when run against MySQL.)</p>
-
-<h2>Configuration File</h2>
-
-<p>db_leftovers reads a file named <code>config/db_leftovers.rb</code> to find out which indexes and constraints you want in your database. This file is a DSL implemented in Ruby, sort of like <code>config/routes.rb</code>. It should look something like this:</p>
-
-<pre><code>DBLeftovers::Definition.define do
-
-  table :users do
-    index :email, :unique =&gt; true
-    check :registered_at_unless_guest, "role_name = 'guest' OR registered_at IS NOT NULL"
-  end
-
-  foreign_key :orders, :users
-
-  # . . 
-end
-</code></pre>
-
-<p>Within the DSL file, the following methods are supported:</p>
-
-<h3>index(table_name, columns, [opts])</h3>
-
-<p>This ensures that you have an index on the given table and column(s). The <code>columns</code> parameter can be either a string/symbol or a list of strings/symbols. Opts is a hash with the following possible keys:</p>
-
-<ul>
-<li><p><code>:name</code> The name of the index. Defaults to <code>index_</code><em>table_name</em><code>_on_</code><em>column_names</em>, like the <code>add_index</code> method from Rails migrations.</p></li>
-<li><p><code>:unique</code> Set this to <code>true</code> if you'd like a unique index.</p></li>
-<li><p><code>:where</code> Accepts SQL to include in the <code>WHERE</code> part of the <code>CREATE INDEX</code> command, in case you want to limit the index to a subset of the table's rows.</p></li>
-</ul>
-
-<h4>Examples</h4>
-
-<pre><code>index :books, :author_id
-index :books, [:publisher_id, :published_at]
-index :books, :isbn, :unique =&gt; true
-</code></pre>
-
-<h3>foreign_key(from_table, [from_column], to_table, [to_column], [opts])</h3>
-
-<p>This ensures that you have a foreign key relating the given tables and columns.
-All parameters are strings/symbols except <code>opts</code>, which is a hash.
-If you omit the column names, db_leftovers will infer them based on Rails conventions. (See examples below.)
-The only option that is supported is <code>:on_delete</code>, which may have any of these values:</p>
-
-<ul>
-<li><code>nil</code> Indicates that attempting to delete the referenced row should fail (the default).</li>
-<li><code>:set_null</code> Indicates that the foreign key should be set to null if the referenced row is deleted.</li>
-<li><code>:cascade</code> Indicates that the referencing row should be deleted if the referenced row is deleted.</li>
-</ul>
-
-<h4>Examples</h4>
-
-<pre><code>foreign_key :books, :author_id, :authors, :id
-foreign_key :pages, :book_id, :books, :id, :on_delete =&gt; :cascade
-</code></pre>
-
-<p>With implicit column names:</p>
-
-<pre><code>foreign_key :books, :authors
-foreign_key :books, :authors, :on_delete =&gt; :cascade
-foreign_key :books, :co_author_id, :authors
-foreign_key :books, :co_author_id, :authors, :on_delete =&gt; :cascade
-</code></pre>
-
-<h3>check(constraint_name, on_table, expression)</h3>
-
-<p>This ensures that you have a CHECK constraint on the given table with the given name and expression.
-All parameters are strings or symbols.</p>
-
-<h4>Examples</h4>
-
-<pre><code>check :books, :books_have_positive_pages, 'page_count &gt; 0'
-</code></pre>
-
-<h3>table(table_name, &amp;block)</h3>
-
-<p>The <code>table</code> call is just a convenience so you can group all a table's indexes et cetera together and not keep repeating the table name. You use it like this:</p>
-
-<pre><code>table :books do
-  index :author_id
-  foreign_key :publisher_id, :publishers
-  check :books_have_positive_pages, 'page_count &gt; 0'
-end
-</code></pre>
-
-<p>You can repeat <code>table</code> calls for the same table several times if you like. This lets you put your indexes in one place and your foreign keys in another, for example.</p>
-
-<h2>Running db_leftovers</h2>
-
-<p>db_leftovers comes with a Rake task named <code>db:leftovers</code>. So you can update your database to match your config file by saying this:</p>
-
-<pre><code>rake db:leftovers
-</code></pre>
-
-<p>db_leftovers will notice whenever an index, foreign key, or CHECK constraint needs to be added, dropped, or changed.
-It will even catch cases where the name of the managed object is the same, but its attributes have changed.
-For instance, if you previously required books to have at least 1 page, but now you are introducing a "pamphlet"
-and want books to have at least 100 pages, you can change your config file to say:</p>
-
-<pre><code>check :books, :books_have_positive_pages, 'page_count &gt;= 100'
-</code></pre>
-
-<p>and db_leftovers will notice the changed expression. It will drop and re-add the constraint.</p>
-
-<p>One caveat, however: we pull the current expression from the database, and sometimes Postgres does things like
-add type conversions. If instance, suppose you said <code>check :users, :email_length, 'LENGTH(email) &gt; 2'</code>.
-The second time you run db_leftovers, it will read the expression from Postgres and get <code>LENGTH((email)::text) &gt; 2</code>,
-and so it will drop and re-create the constraint.
-It will drop and re-create it every time you run the rake task.
-To get around this, make sure your config file uses the same expression as printed by db_leftovers in the rake output.
-This can also happen for index WHERE clauses, fixable by a similar workaround.
-MySQL doesn't have this problem because it doesn't support CHECK constraints or index WHERE clauses.</p>
-
-<p>To print messages even about indexes/foreign keys/constraints that haven't changed, you can say:</p>
-
-<pre><code>rake db:leftovers VERBOSE=true
-</code></pre>
-
-<p>or</p>
-
-<pre><code>rake db:leftovers DB_LEFTOVERS_VERBOSE=true
-</code></pre>
-
-<h2>Capistrano Integration</h2>
-
-<p>I recommend running <code>rake db:migrate</code> any time you deploy, and then running <code>rake db:leftovers</code> after that. Here is what you need in your <code>config/deploy.rb</code> to make that happen:</p>
-
-<pre><code>set :rails_env, "production"
-
-namespace :db do
-  desc "Set up constraints and indexes"
-  task :leftovers do
-    run("cd #{deploy_to}/current &amp;&amp; bundle exec rake db:leftovers RAILS_ENV=#{rails_env}")  
-  end
-end
-
-after :deploy, 'deploy:migrate'
-after 'deploy:migrate', 'db:leftovers'
-</code></pre>
-
-<p>You could also change this code to <em>not</em> run migrations after each deploy, if you like. But in that case I'd recommend not running db:leftovers until after the latest migrations (if any), since new entries in the DSL are likely to reference newly-created tables/columns.</p>
-
-<h2>Known Issues</h2>
-
-<ul>
-<li><p>When db_leftovers interrogates your database for the currently-defined indexes et cetera, it doesn't filter things by the current database name. So if you have mutliple Rails projects all accessible to the same user, you'll wind up changing more than you like (probably by DROPing things).</p></li>
-<li><p>It'd be nice to have another Rake task that will read your database and generate a new <code>db_leftovers.rb</code> file, to help people migrating existing projects that already have lots of tables.</p></li>
-</ul>
-
-<h2>Contributing to db_leftovers</h2>
-
-<ul>
-<li>Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.</li>
-<li>Check out the issue tracker to make sure someone hasn't already requested and/or contributed it.</li>
-<li>Fork the project.</li>
-<li>Start a feature/bugfix branch.</li>
-<li>Commit and push until you are happy with your contribution.</li>
-<li>Make be sure to add tests for it. This is important so I don't break it in a future version unintentionally.</li>
-<li>Please try not to mess with the Rakefile, version, or history. If you want to have your own version, that is fine, but please isolate that change to its own commit so I can cherry-pick around it.</li>
-</ul>
-
-<h2>Copyright</h2>
-
-<p>Copyright (c) 2012 Paul A. Jungwirth.
-See LICENSE.txt for further details.</p>

data/VERSION

@@ -1 +0,0 @@
-1.1.1