real_fk 0.2.0

data/CHANGELOG

@@ -0,0 +1,5 @@
+0.2:
+    Properly packaged as a Gem
+    Fixed compatibility problems with SQLite
+0.1:
+    Project started (2008-03-12)

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2008 Gunnar Wolf <gwolf@gwolf.org>
+
+This is the MIT license, the license Ruby on Rails itself is licensed under.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Manifest.txt

@@ -0,0 +1,33 @@
+./Manifest.txt
+./LICENSE
+./init.rb
+./lib/real_fk.rb
+./doc/fr_class_index.html
+./doc/index.html
+./doc/files/README.html
+./doc/files/lib/real_fk_rb.html
+./doc/fr_file_index.html
+./doc/fr_method_index.html
+./doc/rdoc-style.css
+./doc/created.rid
+./README
+./Rakefile
+./test/rails_root/script/console
+./test/rails_root/config/boot.rb
+./test/rails_root/config/database.yml
+./test/rails_root/config/environments/postgresql.rb
+./test/rails_root/config/environments/sqlite3.rb
+./test/rails_root/config/environments/mysql.rb
+./test/rails_root/config/environments/sqlite.rb
+./test/rails_root/config/routes.rb
+./test/rails_root/config/environment.rb
+./test/rails_root/README
+./test/rails_root/db/migrate/001_create_people_conf.rb
+./test/rails_root/vendor/plugins/real_fk/init.rb
+./test/rails_root/app/models/person.rb
+./test/rails_root/app/models/conference.rb
+./test/rails_root/app/models/person_type.rb
+./test/rails_root/app/controllers/application.rb
+./test/test_helper.rb
+./test/unit/real_fk_test.rb
+./META.yml

data/README

@@ -0,0 +1,141 @@
+= real_fk
+
+This plugin extends the base <tt>Rails ActiveRecord::Migration</tt>
+with some commonly used functionality, aiming at keeping your
+migrations short, easy to understand and meaningful.
+
+= Installing the plugin
+
+The easiest way is through Rails' own +scripts/plugins+ utility. The
+first thing you should do is to tell Rails where the plugin's tree is
+located. 
+
+If you want to follow the latest changes, you will probably prefer
+following the project's trunk, however, for production, I strongly
+suggest you to stick to a stable release. Depending on what you
+prefer, from your project's base directory, type:
+
+  $ ./script/plugin source http://realfk.rubyforge.org/svn/trunk/
+
+Or, to follow a given release (say, 0.1 - Of course, check on the
+latest stable release before doing this):
+
+  $ ./script/plugin source http://realfk.rubyforge.org/svn/tags/0.1/
+
+Then, ask Rails to install the plugin:
+
+  $ ./script/plugin install real_fk
+
+If you use Subversion for tracking your project's development, you
+will probably want to mark the plugin as an <i>external</i>
+repository. To do so, add the -x switch:
+
+  $ ./script/plugin install -x real_fk
+
+= Using the plugin
+
+== References
+
+Rails is built upon a "dumb database" concept. Rails assumes the database
+will not force restrictions upon the user - i.e. that the model validators
+are all there is. But I disagree ;-)
+
+So, if you want to create a relation field, properly acting as a foreign
+key and refering to another table, instead of doing it via the 
+<tt>ActiveRecord::ConnectionAdapters::TableDefinition#column</tt> (or even 
+<tt>ActiveRecord::ConnectionAdapters::TableDefinition#references</tt>) 
+methods, declare them with +add_refrence+:
+
+  def self.up
+    create_table :proposals do |t|
+      (...)
+    end
+    create_table :proposal_types do |t|
+      (...)
+    end
+    create_table :proposal_statuses do |t|
+      (...)
+    end
+    add_reference :proposals, :proposal_types
+    add_reference :proposals, :proposal_statuses, :null => false, :default => 1
+  end
+
+The corresponding fields (+proposal_type_id+ and +proposal_status_id+,
+respectively) will be created in +proposals+, and the RDBMS will
+impose a Foreign Key constraint.
+
+The references can be removed via +remove_reference+, i.e., for inclusion in 
++down+ migrations:
+
+  def self.down
+    remove_reference :proposals, :proposal_types
+    remove_reference :proposals, :proposal_statuses
+    drop_table :proposal_statuses
+    drop_table :proposal_types
+    drop_table :proposals
+  end
+
+Of course, in this case the +remove_reference+ call is not really needed - But
+if you are dropping a table that is referred to from a table that will 
+remain existing, you will have to remove the foreign key constraints (that 
+is, the referring columns).
+
+== Join (HABTM) tables
+
+When you define a simple +has_and_belongs_to_many+ (HABTM) relation in your 
+model, you are expected to create an extra table representing this relation.
+This is a very simple table (i.e. it has only a row for each of the related
+table's IDs), and it carries foreign key constraints (see the +References+ 
+section). 
+
+Please note that join tables <i>are not supposed to carry any extra 
+columns</i> - If you need to add information to join tables, think twice and
+better use a <tt>has_many :elements, :through => :othermodel</tt> 
+declaration, and create the +othermodel+ table manually.
+
+To create a HABTM table representing that each person can attend many 
+conferences and each conference can be attended by many people:
+
+  def self.up
+    create_table :people do |t|
+      (...)
+    end
+    create_table :conferences do |t|
+      (...)
+    end
+    create_habtm :people, :conferences
+  end
+  def self.down
+    drop_habtm :people, :conferences
+    drop_table :people
+    drop_table :conferences
+  end
+
+The last call will create a +conferences_people+ table (according to Rails'
+conventions, table names are sorted alphabetically to get the join table's
+name).
+
+Note that in the +down+ migration, the +drop_habtm+ call <i>must appear 
+before</i> the +drop_table+ calls, as it carries foreign key constraints.
+
+= Author
+
+This plugin is Copyright (c) 2008 Gunnar Wolf <gwolf@gwolf.org>
+
+== Licensing information
+
+This plugin is under a MIT license. For further information, please
+check the LICENSE file.
+
+= Getting the code
+
+The plugin project's home page can be found at
+http://realfk.rubyforge.org/
+
+The Rubyforge project page is http://rubyforge.org/projects/realfk/
+
+The development branch of the SVN tree can be pulled anonymously from
+http://realfk.rubyforge.org/svn/trunk/
+
+Released versions can be found along the 'tags' directory of the SVN
+tree, at http://realfk.rubyforge.org/svn/tags/

data/lib/real_fk.rb

@@ -0,0 +1,83 @@
+module GWolf #:nodoc:
+  module UNAM #:nodoc:
+    module RealFkMigrations #:nodoc:
+
+      def self.append_features(base)
+        super
+
+        # Adds a belongs_to relation from the first table to the second one, creating
+        # the foreign key, and creating the fields in the first table corresponding
+        # to what Rails expects them to be called. 
+        #
+        # The received options will be passed on to the add_column call.
+        def add_reference(from, dest, options = {})
+          fieldname = fldname(dest)
+        
+          add_column(from, fieldname, :integer, options)
+          add_constraint(from, dest)
+        end
+
+        def remove_reference(from, dest)
+          remove_column from, fldname(dest)
+        end
+
+        # Creates a HABTM join-table between two given tables, so they can be 
+        # linked with a has_and_belongs_to_many declaration in the model.
+        #
+        # Three indexes will be created for the table: A unique index, ensuring
+        # only one relation is created between any two given records, and two
+        # regular indexes, to ensure speedy lookups.
+        def create_habtm(first, second)
+          first, second = sort_tables(first, second)
+          first_fld = fldname(first)
+          second_fld = fldname(second)
+          join_tbl = "#{first}_#{second}"
+
+          # It is sad we cannot use our own tricks here, isn't it? :-/
+          # Some RDBMSs (notably, SQLite) won't allow for the creation of a 
+          # table with no columns - So we create the table with a reference 
+          # to the first table by hand... And just add cleanly the second 
+          # table afterwards
+          create_table(join_tbl, :id => false) do |t|
+            t.integer fldname(first)
+          end
+          add_constraint join_tbl, first 
+          add_reference join_tbl, second
+
+          add_index join_tbl, first_fld
+          add_index join_tbl, second_fld
+          add_index join_tbl, [first_fld, second_fld], :unique => true
+        end
+
+        # Drops a HABTM join-table between the two given tables.
+        def drop_habtm(first, second)
+          first, second = sort_tables(first, second)
+          drop_table "#{first}_#{second}"
+        end
+
+        private
+        def fldname(tbl) #:nodoc:
+          "#{tbl.to_s.singularize}_id"
+        end
+
+        def sort_tables(first, second) #:nodoc:
+          first, second = second, first if first.to_s > second.to_s 
+          return first, second
+        end
+
+        def add_constraint(from, to)
+          fld = fldname(to)
+          if ActiveRecord::Base.connection.adapter_name == 'PostgreSQL'
+            execute "ALTER TABLE #{from} ADD CONSTRAINT " <<
+              "#{from}_#{fld}_fkey FOREIGN KEY (#{fld}) " <<
+              "REFERENCES #{to}(id) ON DELETE RESTRICT"
+          else
+            warn "Reference rquested from #{from} to #{to} - References " <<
+              "are not yet supported in " <<
+              ActiveRecord::Base.connection.adapter_name
+          end
+        end
+      end
+    end
+  end
+end

data/test/rails_root/README

@@ -0,0 +1,4 @@
+This mini-Rails directory was created following the recipe at:
+
+http://www.pluginaweek.org/2006/11/24/plugin-tip-of-the-week-testing-your-plugins-the-right-way/
+

data/test/rails_root/app/controllers/application.rb

@@ -0,0 +1,10 @@
+# Filters added to this controller apply to all controllers in the application.
+# Likewise, all the methods added will be available for all controllers.
+
+class ApplicationController < ActionController::Base
+  helper :all # include all helpers, all the time
+
+  # See ActionController::RequestForgeryProtection for details
+  # Uncomment the :secret if you're not using the cookie session store
+  protect_from_forgery # :secret => 'ec8a7a583ea1cce8b10146acadcad842'
+end

data/test/rails_root/app/models/conference.rb

@@ -0,0 +1,3 @@
+class Conference < ActiveRecord::Base
+  has_and_belongs_to_many :people
+end

data/test/rails_root/app/models/person.rb

@@ -0,0 +1,4 @@
+class Person < ActiveRecord::Base
+  has_and_belongs_to_many :conferences
+  belongs_to :person_type
+end

data/test/rails_root/app/models/person_type.rb

@@ -0,0 +1,3 @@
+class PersonType < ActiveRecord::Base
+  has_many :people
+end

data/test/rails_root/config/boot.rb

@@ -0,0 +1,109 @@
+# Don't change this file!
+# Configure your app in config/environment.rb and config/environments/*.rb
+
+RAILS_ROOT = "#{File.dirname(__FILE__)}/.." unless defined?(RAILS_ROOT)
+
+module Rails
+  class << self
+    def boot!
+      unless booted?
+        preinitialize
+        pick_boot.run
+      end
+    end
+
+    def booted?
+      defined? Rails::Initializer
+    end
+
+    def pick_boot
+      (vendor_rails? ? VendorBoot : GemBoot).new
+    end
+
+    def vendor_rails?
+      File.exist?("#{RAILS_ROOT}/vendor/rails")
+    end
+
+    # FIXME : Ruby 1.9
+    def preinitialize
+      load(preinitializer_path) if File.exists?(preinitializer_path)
+    end
+
+    def preinitializer_path
+      "#{RAILS_ROOT}/config/preinitializer.rb"
+    end
+  end
+
+  class Boot
+    def run
+      load_initializer
+      Rails::Initializer.run(:set_load_path)
+    end
+  end
+
+  class VendorBoot < Boot
+    def load_initializer
+      require "#{RAILS_ROOT}/vendor/rails/railties/lib/initializer"
+    end
+  end
+
+  class GemBoot < Boot
+    def load_initializer
+      self.class.load_rubygems
+      load_rails_gem
+      require 'initializer'
+    end
+
+    def load_rails_gem
+      if version = self.class.gem_version
+        gem 'rails', version
+      else
+        gem 'rails'
+      end
+    rescue Gem::LoadError => load_error
+      $stderr.puts %(Missing the Rails #{version} gem. Please `gem install -v=#{version} rails`, update your RAILS_GEM_VERSION setting in config/environment.rb for the Rails version you do have installed, or comment out RAILS_GEM_VERSION to use the latest version installed.)
+      exit 1
+    end
+
+    class << self
+      def rubygems_version
+        Gem::RubyGemsVersion if defined? Gem::RubyGemsVersion
+      end
+
+      def gem_version
+        if defined? RAILS_GEM_VERSION
+          RAILS_GEM_VERSION
+        elsif ENV.include?('RAILS_GEM_VERSION')
+          ENV['RAILS_GEM_VERSION']
+        else
+          parse_gem_version(read_environment_rb)
+        end
+      end
+
+      def load_rubygems
+        require 'rubygems'
+
+        unless rubygems_version >= '0.9.4'
+          $stderr.puts %(Rails requires RubyGems >= 0.9.4 (you have #{rubygems_version}). Please `gem update --system` and try again.)
+          exit 1
+        end
+
+      rescue LoadError
+        $stderr.puts %(Rails requires RubyGems >= 0.9.4. Please install RubyGems and try again: http://rubygems.rubyforge.org)
+        exit 1
+      end
+
+      def parse_gem_version(text)
+        $1 if text =~ /^[^#]*RAILS_GEM_VERSION\s*=\s*["']([!~<>=]*\s*[\d.]+)["']/
+      end
+
+      private
+        def read_environment_rb
+          File.read("#{RAILS_ROOT}/config/environment.rb")
+        end
+    end
+  end
+end
+
+# All that for this:
+Rails.boot!

data/test/rails_root/config/database.yml

@@ -0,0 +1,21 @@
+postgresql:
+  :adapter: postgresql
+  :username: gwolf
+#  :password: postgres
+  :database: real_fk_test
+  :min_messages: ERROR
+# There is really not much point in testing this plugin with "lesser" 
+# RDBMS-like systems, such as SQLite or MySQL. It's not impossible, though...
+#
+# mysql:
+#   :adapter: mysql
+#   :host: localhost
+#   :username: root
+#   :password:
+#   :database: real_fk_test
+# sqlite:
+#   :adapter: sqlite
+#   :dbfile: real_fk_test.sqlite.db
+# sqlite3:
+#   :adapter: sqlite3
+#   :dbfile: real_fk_test.sqlite3.db

data/test/rails_root/config/environment.rb

@@ -0,0 +1,13 @@
+# Specifies gem version of Rails to use when vendor/rails is not present
+#RAILS_GEM_VERSION = '2.0.2'
+ 
+require File.join(File.dirname(__FILE__), 'boot')
+ 
+Rails::Initializer.run do |config|
+  config.log_level = :debug
+  config.cache_classes = false
+  config.whiny_nils = true
+  config.load_paths << "#{File.dirname(__FILE__)}/../../../lib/"
+end
+ 
+Dependencies.log_activity = true

data/test/rails_root/config/routes.rb

@@ -0,0 +1,35 @@
+ActionController::Routing::Routes.draw do |map|
+  # The priority is based upon order of creation: first created -> highest priority.
+
+  # Sample of regular route:
+  #   map.connect 'products/:id', :controller => 'catalog', :action => 'view'
+  # Keep in mind you can assign values other than :controller and :action
+
+  # Sample of named route:
+  #   map.purchase 'products/:id/purchase', :controller => 'catalog', :action => 'purchase'
+  # This route can be invoked with purchase_url(:id => product.id)
+
+  # Sample resource route (maps HTTP verbs to controller actions automatically):
+  #   map.resources :products
+
+  # Sample resource route with options:
+  #   map.resources :products, :member => { :short => :get, :toggle => :post }, :collection => { :sold => :get }
+
+  # Sample resource route with sub-resources:
+  #   map.resources :products, :has_many => [ :comments, :sales ], :has_one => :seller
+
+  # Sample resource route within a namespace:
+  #   map.namespace :admin do |admin|
+  #     # Directs /admin/products/* to Admin::ProductsController (app/controllers/admin/products_controller.rb)
+  #     admin.resources :products
+  #   end
+
+  # You can have the root of your site routed with map.root -- just remember to delete public/index.html.
+  # map.root :controller => "welcome"
+
+  # See how all your routes lay out with "rake routes"
+
+  # Install the default routes as the lowest priority.
+  map.connect ':controller/:action/:id'
+  map.connect ':controller/:action/:id.:format'
+end

data/test/rails_root/db/migrate/001_create_people_conf.rb

@@ -0,0 +1,36 @@
+class CreatePeopleConf < ActiveRecord::Migration
+  def self.up
+    create_table :person_types, :force => true do |t|
+      t.column :name, :string
+    end
+    create_table :people, :force => true do |t|
+      t.column :name, :string
+    end
+    create_table :conferences, :force => true do |t|
+      t.column :name, :string
+    end
+
+    add_reference :people, :person_types, :null => false
+    create_habtm :people, :conferences
+
+    ['Attendee', 'Organizer', 'Speaker'].map do |item|
+      PersonType.new(:name => item).save!
+    end
+    ['Some Body', 'Some Buddy', 'Sum baddy'].map do |pers| 
+      Person.new(:name => pers, 
+                 :person_type => PersonType.find(:all).rand).save!
+    end
+    ['Boring', 'Interesting', 'Mediocre', 'Fun'].map do |conf|
+      Conference.new(:name => conf).save!
+    end
+  end
+
+  def self.down
+    drop_habtm :people, :conferences
+    drop_reference :people, :person_types
+
+    drop_table :people
+    drop_table :conferences
+  end
+end
+

data/test/rails_root/log/postgresql.log

@@ -0,0 +1,403 @@
+# Logfile created on Tue Nov 25 12:15:40 -0600 2008Dependencies: called new_constants_in(Object)
+Dependencies: called require_or_load("/home/gwolf/cvs/realfk/test/rails_root/app/controllers/application.rb", nil)
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: OptionParser
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: New constants: Mocha
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: CSV
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: Fixtures, FixtureClassNotFound, Fixture
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: Error during loading, removing partially loaded constants 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: Error during loading, removing partially loaded constants 
+Dependencies: New constants: 
+  SQL (0.000132)   SET client_min_messages TO 'panic'
+  SQL (0.000083)   SET client_min_messages TO 'notice'
+  SQL (0.000089)   SET client_min_messages TO 'ERROR'
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: CreatePeopleConf
+  SQL (0.000488)   SELECT version FROM schema_migrations
+Migrating to CreatePeopleConf (1)
+  SQL (0.000127)   SELECT version FROM schema_migrations
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: New constants: 
+Dependencies: called new_constants_in(Object)
+Dependencies: New constants: 
+Dependencies: New constants: 
+  SQL (0.000141)   BEGIN
+Dependencies: called load_missing_constant(RealFkTest, :PersonType)
+Dependencies: called load_missing_constant(Object, :PersonType)
+Dependencies: called require_or_load("/home/gwolf/cvs/realfk/test/rails_root/app/models/person_type.rb", nil)
+Dependencies: loading /home/gwolf/cvs/realfk/test/rails_root/app/models/person_type
+Dependencies: called load_file("/home/gwolf/cvs/realfk/test/rails_root/app/models/person_type.rb", ["Models::PersonType", "PersonType"])
+Dependencies: called new_constants_in("Models", :Object)
+Dependencies: New constants: PersonType
+Dependencies: loading /home/gwolf/cvs/realfk/test/rails_root/app/models/person_type.rb defined PersonType
+  PersonType Load (0.000614)   SELECT * FROM "person_types" 
+Dependencies: called load_missing_constant(RealFkTest, :Person)
+Dependencies: called load_missing_constant(Object, :Person)
+Dependencies: called require_or_load("/home/gwolf/cvs/realfk/test/rails_root/app/models/person.rb", nil)
+Dependencies: loading /home/gwolf/cvs/realfk/test/rails_root/app/models/person
+Dependencies: called load_file("/home/gwolf/cvs/realfk/test/rails_root/app/models/person.rb", ["Models::Person", "Person"])
+Dependencies: called new_constants_in("Models", :Object)
+Dependencies: New constants: Person
+Dependencies: loading /home/gwolf/cvs/realfk/test/rails_root/app/models/person.rb defined Person
+  Person Load (0.000627)   SELECT * FROM "people" LIMIT 1
+  Person Update (0.000000)   PGError: ERROR: null value in column "person_type_id" violates not-null constraint
+: UPDATE "people" SET "person_type_id" = NULL WHERE "id" = 2
+  SQL (0.000182)   SET client_min_messages TO 'ERROR'
+  Person Update (0.000000)   PGError: ERROR: insert or update on table "people" violates foreign key constraint "people_person_type_id_fkey"
+DETAIL: Key (person_type_id)=(4) is not present in table "person_types".
+: UPDATE "people" SET "person_type_id" = 4 WHERE "id" = 2
+  SQL (0.000185)   SET client_min_messages TO 'ERROR'
+  Person Update (0.002232)   UPDATE "people" SET "person_type_id" = 3 WHERE "id" = 2
+  Person Load (0.000336)   SELECT * FROM "people" WHERE ("people"."id" = 2) 
+  Person Exists (0.000360)   SELECT "people".id FROM "people" WHERE ("people"."id" = 2) AND ("people".person_type_id = 3) LIMIT 1
+  PersonType Load (0.000433)   SELECT * FROM "person_types" WHERE ("person_types"."id" = 3) 
+  SQL (0.000223)   ROLLBACK
+  SQL (0.000060)   BEGIN
+Dependencies: called load_missing_constant(RealFkTest, :Conference)
+Dependencies: called load_missing_constant(Object, :Conference)
+Dependencies: called require_or_load("/home/gwolf/cvs/realfk/test/rails_root/app/models/conference.rb", nil)
+Dependencies: loading /home/gwolf/cvs/realfk/test/rails_root/app/models/conference
+Dependencies: called load_file("/home/gwolf/cvs/realfk/test/rails_root/app/models/conference.rb", ["Models::Conference", "Conference"])
+Dependencies: called new_constants_in("Models", :Object)
+Dependencies: New constants: Conference
+Dependencies: loading /home/gwolf/cvs/realfk/test/rails_root/app/models/conference.rb defined Conference
+  Conference Load (0.000496)   SELECT * FROM "conferences" 
+  Person Load (0.000146)   SELECT * FROM "people" 
+  Person Load (0.000740)   SELECT * FROM "people" INNER JOIN "conferences_people" ON "people".id = "conferences_people".person_id WHERE ("conferences_people".conference_id = 3 ) 
+  SQL (0.000684)   INSERT INTO "conferences_people" ("person_id", "conference_id") VALUES (3, 3)
+  SQL (0.000232)   INSERT INTO "conferences_people" ("person_id", "conference_id") VALUES (1, 3)
+  SQL (0.000234)   INSERT INTO "conferences_people" ("person_id", "conference_id") VALUES (2, 3)
+  Person Load (0.000151)   SELECT * FROM "people" 
+  Conference Exists (0.000419)   SELECT "conferences".id FROM "conferences" INNER JOIN "conferences_people" ON "conferences".id = "conferences_people".conference_id WHERE ("conferences"."id" = 3) AND ("conferences_people".person_id = 3 ) LIMIT 1
+  Conference Exists (0.000331)   SELECT "conferences".id FROM "conferences" INNER JOIN "conferences_people" ON "conferences".id = "conferences_people".conference_id WHERE ("conferences"."id" = 3) AND ("conferences_people".person_id = 1 ) LIMIT 1
+  Conference Exists (0.000322)   SELECT "conferences".id FROM "conferences" INNER JOIN "conferences_people" ON "conferences".id = "conferences_people".conference_id WHERE ("conferences"."id" = 3) AND ("conferences_people".person_id = 2 ) LIMIT 1
+  Person Load (0.000138)   SELECT * FROM "people" 
+  Conference Load (0.000372)   SELECT * FROM "conferences" INNER JOIN "conferences_people" ON "conferences".id = "conferences_people".conference_id WHERE ("conferences_people".person_id = 3 ) 
+  SQL (0.000260)   DELETE FROM "conferences_people" WHERE person_id = 3 AND conference_id IN (3)
+  SQL (0.000235)   INSERT INTO "conferences_people" ("person_id", "conference_id") VALUES (3, 4)
+  Conference Load (0.000196)   SELECT * FROM "conferences" WHERE ("conferences"."id" = 3) 
+  Conference Load (0.000163)   SELECT * FROM "conferences" WHERE ("conferences"."id" = 4) 
+  Person Exists (0.000361)   SELECT "people".id FROM "people" INNER JOIN "conferences_people" ON "people".id = "conferences_people".person_id WHERE ("people"."id" = 3) AND ("conferences_people".conference_id = 4 ) LIMIT 1
+  Person Exists (0.000327)   SELECT "people".id FROM "people" INNER JOIN "conferences_people" ON "people".id = "conferences_people".person_id WHERE ("people"."id" = 3) AND ("conferences_people".conference_id = 3 ) LIMIT 1
+  Conference Load (0.000134)   SELECT * FROM "conferences" 
+  Conference Load (0.000366)   SELECT * FROM "conferences" INNER JOIN "conferences_people" ON "conferences".id = "conferences_people".conference_id WHERE ("conferences_people".person_id = 1 ) 
+  SQL (0.000234)   INSERT INTO "conferences_people" ("person_id", "conference_id") VALUES (1, 1)
+  SQL (0.000228)   INSERT INTO "conferences_people" ("person_id", "conference_id") VALUES (1, 2)
+  SQL (0.000227)   INSERT INTO "conferences_people" ("person_id", "conference_id") VALUES (1, 4)
+  Conference Load (0.000197)   SELECT * FROM "conferences" WHERE ("conferences"."id" = 3) 
+  Conference Load (0.000162)   SELECT * FROM "conferences" WHERE ("conferences"."id" = 4) 
+  Person Exists (0.000361)   SELECT "people".id FROM "people" INNER JOIN "conferences_people" ON "people".id = "conferences_people".person_id WHERE ("people"."id" = 1) AND ("conferences_people".conference_id = 3 ) LIMIT 1
+  Person Exists (0.000332)   SELECT "people".id FROM "people" INNER JOIN "conferences_people" ON "people".id = "conferences_people".person_id WHERE ("people"."id" = 1) AND ("conferences_people".conference_id = 4 ) LIMIT 1
+  SQL (0.000112)   ROLLBACK
+  SQL (0.000114)   BEGIN
+  SQL (0.000056)   ROLLBACK

data/test/rails_root/script/console

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require File.dirname(__FILE__) + '/../config/boot'
+require 'commands/console'

data/test/rails_root/vendor/plugins/real_fk/init.rb

@@ -0,0 +1,2 @@
+init_path = "#{RAILS_ROOT}/../../init.rb"
+silence_warnings { eval(IO.read(init_path), binding, init_path) }

data/test/test_helper.rb

@@ -0,0 +1,27 @@
+# Load the environment
+ENV['RAILS_ENV'] ||= 'postgresql'
+require File.dirname(__FILE__) + '/rails_root/config/environment.rb'
+ 
+# Load the testing framework
+require 'test_help'
+silence_warnings { RAILS_ENV = ENV['RAILS_ENV'] }
+ 
+# Run the migrations
+ActiveRecord::Migrator.migrate("#{RAILS_ROOT}/db/migrate")
+ 
+# Setup the fixtures path
+Test::Unit::TestCase.fixture_path = File.dirname(__FILE__) + "/fixtures/"
+$LOAD_PATH.unshift(Test::Unit::TestCase.fixture_path)
+ 
+class Test::Unit::TestCase #:nodoc:
+  def create_fixtures(*table_names)
+    if block_given?
+      Fixtures.create_fixtures(Test::Unit::TestCase.fixture_path, table_names) { yield }
+    else
+      Fixtures.create_fixtures(Test::Unit::TestCase.fixture_path, table_names)
+    end
+  end
+ 
+  self.use_transactional_fixtures = true
+  self.use_instantiated_fixtures  = false
+end

data/test/unit/real_fk_test.rb

@@ -0,0 +1,66 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+class RealFkTest < ActiveSupport::TestCase
+  def test_relation_defined
+    assert Person.column_names.include?('person_type_id')
+  end
+
+  def test_constraints_in_place
+    types = PersonType.find(:all)
+
+    # We didn't specify any validations in the model - So a person without a
+    # person_type must be valid, although will bomb when saving it.
+    person = Person.find(:first)
+    person.person_type = nil
+    assert person.valid?
+    assert_raises(ActiveRecord::StatementInvalid) { person.save }
+
+    # An exception was raised - The DB won't like it!
+    ActiveRecord::Base.connection.reconnect!
+
+    # ...Of course, giving an invalid person type also fails
+    highest_type = types.sort {|a,b| a.id <=> b.id}.last
+    person.person_type_id = highest_type.id + 1
+    assert person.valid?
+    assert_raises(ActiveRecord::StatementInvalid) { person.save }
+
+    # An exception was raised - The DB won't like it!
+    ActiveRecord::Base.connection.reconnect!
+
+    # But if it is a valid type, the person will be properly and finally saved
+    person.person_type_id = highest_type.id
+    assert person.save
+
+    # Finally, check the relation is in effect and Rails gets it. It looks 
+    # contorted... :-}
+    people = highest_type.people
+    assert people.include?(Person.find(person.id))
+    assert_equal(highest_type.id, person.person_type.id)
+  end
+
+  def test_habtm 
+    (c1, c2) = Conference.find(:all).sort_by{rand}
+
+    # Just set up some relations and check they get saved...
+    # Everybody goes to conference 1!
+    c1.people = Person.find(:all)
+    Person.find(:all).map {|p| assert p.conferences.include?(c1) }
+
+    # Person 2 will only go to conference 2, not to conference 1.
+    # Rails is lazy on related items - Force it to reload.
+    (p1, p2) = Person.find(:all).sort_by{rand}
+    p1.conferences = [c2]
+    c1.reload
+    c2.reload
+    assert c2.people.include?(p1)
+    assert ! c1.people.include?(p1)
+
+    # Person 2 will only go every conference!
+    # Rails is lazy on related items - Force it to reload.
+    p2.conferences = Conference.find(:all)
+    c1.reload
+    c2.reload
+    assert c1.people.include?(p2)
+    assert c2.people.include?(p2)
+  end
+end

metadata

@@ -0,0 +1,94 @@
+--- !ruby/object:Gem::Specification 
+name: real_fk
+version: !ruby/object:Gem::Version 
+  version: 0.2.0
+platform: ruby
+authors: 
+- Gunnar Wolf
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-11-25 00:00:00 -06:00
+default_executable: 
+dependencies: []
+
+description: This plugin extends the base <tt>Rails ActiveRecord::Migration</tt> with some commonly used functionality, aiming at keeping your migrations short, easy to understand and meaningful.
+email: gwolf@gwolf.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- test/rails_root
+- test/rails_root/log
+- test/rails_root/log/postgresql.log
+- test/rails_root/script
+- test/rails_root/script/console
+- test/rails_root/config
+- test/rails_root/config/boot.rb
+- test/rails_root/config/database.yml
+- test/rails_root/config/environments
+- test/rails_root/config/environments/postgresql.rb
+- test/rails_root/config/environments/sqlite3.rb
+- test/rails_root/config/environments/mysql.rb
+- test/rails_root/config/environments/sqlite.rb
+- test/rails_root/config/routes.rb
+- test/rails_root/config/environment.rb
+- test/rails_root/README
+- test/rails_root/db
+- test/rails_root/db/migrate
+- test/rails_root/db/migrate/001_create_people_conf.rb
+- test/rails_root/vendor
+- test/rails_root/vendor/plugins
+- test/rails_root/vendor/plugins/real_fk
+- test/rails_root/vendor/plugins/real_fk/init.rb
+- test/rails_root/vendor/rails
+- test/rails_root/app
+- test/rails_root/app/models
+- test/rails_root/app/models/person.rb
+- test/rails_root/app/models/conference.rb
+- test/rails_root/app/models/person_type.rb
+- test/rails_root/app/controllers
+- test/rails_root/app/controllers/application.rb
+- test/test_helper.rb
+- test/unit
+- test/unit/real_fk_test.rb
+- lib/real_fk.rb
+- Manifest.txt
+- LICENSE
+- README
+- CHANGELOG
+has_rdoc: true
+homepage: http://realfk.rubyforge.org/
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- charset
+- utf-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: realfk
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Rails plugin aimed towards simplifying declaration and usage of tables with proper foreign key constraints.
+test_files: []
+