updateable_views_inheritance 1.4.1 → 1.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 9fbbb9446777110e2bf865f105afbcb4e745df87
-  data.tar.gz: c7b1e21e88f857d6faca65194048044683ffb170
+SHA256:
+  metadata.gz: d1310b2e6e48b891171acd2c8eaebb3f194ee6cd9fac97ebbaa5a6eca5cc7ceb
+  data.tar.gz: 0d240ed0c411840f800e0e01a52e05933c5e64903d4ec648a39279fb358c8c53
 SHA512:
-  metadata.gz: b8326aa19c08ce403a26c7598c56bddf80a888c89bbd5707125d0429dbfe07e90c48674571531310ce16b458f44f42dbb64a9f5102a39c6767b0eada3d739dd0
-  data.tar.gz: e03ca1453d61313e673f5dcf543b39571fa3813a6e34a23f0d925e3238b9194f482840febb0a2812ef90ddc4b5180a723901c020c676e5745ae055d2294c60f0
+  metadata.gz: fdddba487660479c4ed5530764be9bee03aa13bea8ff658319d48938c34e8a276c9e5f7ba6d9769111a4c2e93e1d0b35632ccd111811402eb9188fce12e20d56
+  data.tar.gz: 4a50e703717eb50314beed8563134dc20cdd430533aead0398c42c7fd2082b63b00375dc0db39b012688d0d6ec6ad3a1b49c7a5b9e2873a90b556bdcada6515c

data/.gitignore

@@ -1,5 +1,6 @@
-Gemfile.lock
 .bundle/
+.byebug_history
+Gemfile.lock
 html/*
 pkg/*
 test/dummy/log/*.log

data/CHANGELOG.md

@@ -1,4 +1,19 @@
-## 1.4.0 (2 0 March 2017)
+## 1.4.3 (01 October 2024)
+
+Features:
+
+  - Add option to disable inheritance instantiation for less
+  database hits when loading large object collections from a
+  parent class.
+
+  - Add option to skip creating child table in migrations.
+
+## 1.4.2 (28 March 2017)
+
+Upgrade to Rails 4.2
+
+
+## 1.4.1 (20 March 2017)
 
 Upgrade to Rails 4.1
 
@@ -10,31 +25,31 @@ Upgrade to Rails 4
 
 Features:
 
-  - rebuild views in all inheritance chains (must be run when upgrading from <= 1.2.1)
+  - Rebuild views in all inheritance chains (must be run when upgrading from <= 1.2.1)
 
 ## 1.2.2 (18 August 2015)
 
 Bugfixes:
 
-  - fixed compatibility with Rails 3.2.19+ and ActiveRecord's prepared statements
+  - Fixed compatibility with Rails 3.2.19+ and ActiveRecord's prepared statements
 
 ## 1.2.1 (27 August 2014)
 
 Bugfixes:
 
-  - parent relations can be in a schema
+  - Parent relations can be in a schema
 
 ## 1.2.0 (27 August 2014)
 
 Features:
 
-  - support for PostgreSQL schemas
+  - Support for PostgreSQL schemas
 
 ## 1.1.2 (14 June 2013)
 
 Bugfixes:
 
-  - fixed generating migration on installation
+  - Fixed generating migration on installation
 
 Documentation:
 
@@ -44,17 +59,17 @@ Documentation:
 
 Features:
 
-  - gemified and released on rubygems.org
+  - Gemified and released on rubygems.org
 
 ## 1.1.0 (13 June 2013)
 
 Features:
 
-  - updated for rails 3.2.x
+  - Updated for Rails 3.2.x
 
 ## 1.0.0 (14 September 2009)
 
 Features:
 
   - class_table_inheritance plugin has behaved stably in production for a year
-  - supports rails 2.1, 2.2 and 2.3
+  - Supports Rails 2.1, 2.2 and 2.3

data/README.md

@@ -0,0 +1,163 @@
+# Class Table Inheritance
+
+Class Table Inheritance for ActiveRecord using updateable views
+
+More about the pattern on
+http://www.martinfowler.com/eaaCatalog/classTableInheritance.html. This gem
+messes very little with Rails inheritance mechanism. Instead it relies on
+updatable views in the database to represent classes in the inheritance chain.
+The approach was [first suggested by John
+Wilger](http://web.archive.org/web/20060408145717/johnwilger.com/articles/2005/09/29/class-table-inheritance-in-rails-with-postgresql).
+
+
+# Requirements
+
+Rails: 4.x
+
+Ruby: 1.9.3+
+
+Database: PostgreSQL only. Patches for other DBMS are welcome. Note that you are
+not required to use updateable views, children relations can be tables with
+some triggers involved.
+
+# Usage
+
+## Setup
+
+* Add `gem 'updateable_views_inheritance'` to your `Gemfile`
+* Run `rails generate updateable_views_inheritance:install && rake db:migrate`
+* In `config/environment.rb` set `config.active_record.schema_format = :sql`
+
+## Example
+
+The database migration:
+
+```ruby
+class CtiExample < ActiveRecord::Migration
+  def self.up
+    create_table :locomotives do |t|
+      t.column :name, :string
+      t.column :max_speed, :integer
+      t.column :type, :string
+    end
+
+    create_child(:steam_locomotives, parent: :locomotives) do |t|
+      t.decimal :water_consumption, precision: 6, scale: 2
+      t.decimal :coal_consumption,  precision: 6, scale: 2
+    end
+
+    create_child(:electric_locomotives,
+                 table: :raw_electric_locomotives,
+                 parent: :locomotives)  do |t|
+      t.decimal :electricity_consumption, precision: 6, scale: 2
+    end
+  end
+
+  def self.down
+    drop_child  :steam_locomotives
+    drop_child  :electric_locomotives
+    drop_table  :locomotives
+  end
+end
+```
+
+And the models:
+
+```ruby
+class Locomotive
+end
+
+class SteamLocomotive < Locomotive
+  self.table_name =  :steam_locomotives
+end
+
+class ElectricLocomotive < Locomotive
+  self.table_name =  :electric_locomotives
+end
+```
+
+Note that models of children classes must specify table name explicitly.
+
+### Changing Columns in Underlying Tables
+
+```ruby
+class RemoveColumnInParentTable < ActiveRecord::Migration
+  def self.up
+    remove_parent_and_children_views(:locomotives)
+    remove_column(:locomotives, :max_speed)
+    rename_column(:name, :title)
+    rebuild_parent_and_children_views(:locomotives)
+  end
+end
+```
+
+### Renaming Underlying Tables
+
+```ruby
+remove_parent_and_children_views(:old_name)
+rename_table(:old_name,:new_name)
+execute "UPDATE updateable_views_inheritance SET child_aggregate_view = 'new_name' WHERE child_aggregate_view = 'old_name'"
+execute "UPDATE updateable_views_inheritance SET parent_relation = 'new_name' WHERE parent_relation = 'old_name'"
+rebuild_parent_and_children_views(:new_name)
+```
+
+### Removing Classes
+
+Note that you should remove only leaf classes (i.e. those that do not have
+descendants). If you want to erase a whole chain or part of chain you have to
+remove first the leaves and then their ancestors. Use `drop_child(child_view)`
+in migrations.
+
+### Using parent class without instantiating subclass
+
+If you don't want to make a second SQL query to the subclass table when you instantiate
+parent class with `Locomotive.find(1)` use
+```ruby
+class Locomotive
+  self.disable_inheritance_instantiation = true
+end
+```
+Quite handy for flat and wide class hierarchies (one parent class, many subclasses).
+
+### Using existing table for inherited class
+
+```ruby
+class CreateIkarusBus < ActiveRecord::Migration
+  def self.up
+    # table `tbl_ikarus_buses` exists in the database
+    end
+    create_child(:ikarus_buses,
+                 table: :tbl_ikarus_buses,
+                 parent: :buses,
+                 skip_creating_child_table: true)
+  end
+end
+```
+Useful when converting legacy DB schema to use inheritance.
+
+## Compatibility with Single Table Inheritance
+
+The approach of this gem is completely independent from Rails built-in Single
+Table Inheritance. STI and CLTI can safely be mixed in one inheritance chain.
+
+## Testing Your App
+
+If you use fixtures, you must run `rake updateable_views_inheritance:fixture` to
+generate fixture for the updateable_views_inheritance table after you
+add/remove classes from the hierarchy or change underlying table or view names.
+**Without it primary key sequence for inheritors' tables won't be bumped to the
+max and it might not be possible to save objects!** If you don't use fixtures
+for the classes in the hierarchy you don't need to do that.
+
+This gem re-enables referential integrity on fixture loading. This means that
+`fixtures :all` may fail when there are foreign key constraints on tables. To
+fix this, explicitly declare fixture load order in `test_helper.rb`:
+
+```
+fixtures :roots, :trunks, :leafs, ...
+```
+for all fixtures you want to load.
+
+## Gem Development & Testing
+
+In order to run gem tests, you have to be a superuser in PostgreSQL.

data/lib/updateable_views_inheritance/active_record.rb

@@ -1,10 +1,12 @@
 module ActiveRecord #:nodoc:
   class Base #:nodoc:
     class << self
+      attr_accessor :disable_inheritance_instantiation
+
       private
       def instantiate_with_updateable_views_inheritance_support(attributes, column_types = {})
         object = instantiate_without_updateable_views_inheritance_support(attributes, column_types = {})
-        if object.class.name == self.name
+        if object.class.name == self.name || self.disable_inheritance_instantiation
           object
         else
           object.class.find(attributes.with_indifferent_access[:id])

data/lib/updateable_views_inheritance/postgresql_adapter.rb

@@ -1,251 +1,263 @@
+require 'active_record/connection_adapters/postgresql/utils'
+
 module ActiveRecord #:nodoc:
   module ConnectionAdapters #:nodoc:
-    class PostgreSQLAdapter
-      # Use this in migration to create child table and view.
-      # Options:
-      # [:parent]
-      #   parent relation
-      # [:child_table_name]
-      #   default is <tt>"#{child_view}_data"</tt>
-      def create_child(child_view, options)
-        raise 'Please call me with a parent, for example: create_child(:steam_locomotives, :parent => :locomotives)' unless options[:parent]
-
-        schema, unqualified_child_view_name = Utils.extract_schema_and_table(child_view)
-
-        parent_relation = options[:parent].to_s
-        if is_view?(parent_relation) # interpreted as inheritance chain deeper than two levels
-          parent_table = query("SELECT child_relation FROM updateable_views_inheritance WHERE child_aggregate_view = #{quote(parent_relation)}")[0][0]
-        else
-          parent_table = parent_relation
-        end
-
-        child_table = options[:table] || quote_table_name("#{child_view}_data")
-        child_table_pk = "#{unqualified_child_view_name.singularize}_id"
+    module PostgreSQL
+      module SchemaStatements
+        # Use this in migration to create child table and view.
+        # Options:
+        # [:parent]
+        #   parent relation
+        # [:table]
+        #   default is <tt>"#{child_view}_data"</tt>
+        # [:skip_creating_child_table]
+        #   use together with :table option
+        def create_child(child_view, options)
+          raise 'Please call me with a parent, for example: create_child(:steam_locomotives, :parent => :locomotives)' unless options[:parent]
+
+          parent_relation = options[:parent].to_s
+          parent_table =  if is_view?(parent_relation) # interpreted as inheritance chain deeper than two levels
+                            query(<<~SQL)[0][0]
+                              SELECT child_relation
+                              FROM updateable_views_inheritance
+                              WHERE child_aggregate_view = #{quote(parent_relation)}
+                            SQL
+                          else
+                            parent_relation
+                          end
+
+          child_table = options[:table] || quote_table_name("#{child_view}_data")
+
+          unless options.key?(:skip_creating_child_table)
+            unqualified_child_view_name = Utils.extract_schema_qualified_name(child_view).identifier
+            child_table_pk = "#{unqualified_child_view_name.singularize}_id"
+
+            create_table(child_table, :id => false) do |t|
+              t.integer child_table_pk, :null => false
+              yield t
+            end
+            execute "ALTER TABLE #{child_table} ADD PRIMARY KEY (#{child_table_pk})"
+            execute "ALTER TABLE #{child_table} ADD FOREIGN KEY (#{child_table_pk})
+                    REFERENCES #{parent_table} ON DELETE CASCADE ON UPDATE CASCADE"
+          end
 
-        create_table(child_table, :id => false) do |t|
-          t.integer child_table_pk, :null => false
-          yield t
+          create_child_view(parent_relation, child_view, child_table)
         end
-        execute "ALTER TABLE #{child_table} ADD PRIMARY KEY (#{child_table_pk})"
-        execute "ALTER TABLE #{child_table} ADD FOREIGN KEY (#{child_table_pk})
-                 REFERENCES #{parent_table} ON DELETE CASCADE ON UPDATE CASCADE"
 
-        create_child_view(parent_relation, child_view, child_table)
-      end
-
-      # Drop child view and table
-      def drop_child(child_view)
-        drop_view(child_view)
-        child_table = query("SELECT child_relation FROM updateable_views_inheritance WHERE child_aggregate_view = #{quote(child_view)}")[0][0]
-        drop_table(child_table)
-        execute "DELETE FROM updateable_views_inheritance WHERE child_aggregate_view = #{quote(child_view)}"
-      end
+        # Drop child view and table
+        def drop_child(child_view)
+          drop_view(child_view)
+          child_table = query("SELECT child_relation FROM updateable_views_inheritance WHERE child_aggregate_view = #{quote(child_view)}")[0][0]
+          drop_table(child_table)
+          execute "DELETE FROM updateable_views_inheritance WHERE child_aggregate_view = #{quote(child_view)}"
+        end
 
-      # Creates aggregate updateable view of parent and child relations. The convention for naming child tables is
-      # <tt>"#{child_view}_data"</tt>. If you don't follow it, supply +child_table_name+ as third argument.
-      def create_child_view(parent_table, child_view, child_table=nil)
-        child_table ||= child_view.to_s + "_data"
+        # Creates aggregate updateable view of parent and child relations. The convention for naming child tables is
+        # <tt>"#{child_view}_data"</tt>. If you don't follow it, supply +child_table_name+ as third argument.
+        def create_child_view(parent_table, child_view, child_table=nil)
+          child_table ||= child_view.to_s + "_data"
 
-        parent_columns = columns(parent_table)
-        child_columns  = columns(child_table)
+          parent_columns = columns(parent_table)
+          child_columns  = columns(child_table)
 
-        child_column_names = child_columns.collect{|c| c.name}
-        parent_column_names = parent_columns.collect{|c| c.name}
+          child_column_names = child_columns.collect{|c| c.name}
+          parent_column_names = parent_columns.collect{|c| c.name}
 
-        child_pk = pk_and_sequence_for(child_table)[0]
-        child_column_names.delete(child_pk)
+          child_pk = pk_and_sequence_for(child_table)[0]
+          child_column_names.delete(child_pk)
 
-        parent_pk, parent_pk_seq = pk_and_sequence_for(parent_table)
-        parent_column_names.delete(parent_pk)
+          parent_pk, parent_pk_seq = pk_and_sequence_for(parent_table)
+          parent_column_names.delete(parent_pk)
 
-        do_create_child_view(parent_table, parent_column_names, parent_pk, child_view, child_column_names, child_pk, child_table)
-        make_child_view_updateable(parent_table, parent_column_names, parent_pk, parent_pk_seq, child_view, child_column_names, child_pk, child_table)
+          do_create_child_view(parent_table, parent_column_names, parent_pk, child_view, child_column_names, child_pk, child_table)
+          make_child_view_updateable(parent_table, parent_column_names, parent_pk, parent_pk_seq, child_view, child_column_names, child_pk, child_table)
 
-        # assign default values for table columns on the view - it is not automatic in Postgresql 8.1
-        set_defaults(child_view, parent_table)
-        set_defaults(child_view, child_table)
-        create_system_table_records(parent_table, child_view, child_table)
-      end
+          # assign default values for table columns on the view - it is not automatic in Postgresql 8.1
+          set_defaults(child_view, parent_table)
+          set_defaults(child_view, child_table)
+          create_system_table_records(parent_table, child_view, child_table)
+        end
 
-      # Resets sequence to the max value of the table's pk if present respecting inheritance (i.e. one sequence can be shared by many tables).
-      def reset_pk_sequence!(table, pk = nil, sequence = nil)
-        parent = parent_table(table)
-        if parent
-          reset_pk_sequence!(parent, pk, sequence)
-        else
-          unless pk and sequence
-            default_pk, default_sequence = pk_and_sequence_for(table)
-            pk ||= default_pk
-            sequence ||= default_sequence
-          end
-          if pk
-            if sequence
-              select_value <<-end_sql, 'Reset sequence'
-                SELECT setval('#{sequence}', (SELECT COALESCE(MAX(#{pk})+(SELECT increment_by FROM #{sequence}), (SELECT min_value FROM #{sequence})) FROM #{table}), false)
-              end_sql
-            else
-              @logger.warn "#{table} has primary key #{pk} with no default sequence" if @logger
+        # Resets sequence to the max value of the table's pk if present respecting inheritance (i.e. one sequence can be shared by many tables).
+        def reset_pk_sequence!(table, pk = nil, sequence = nil)
+          parent = parent_table(table)
+          if parent
+            reset_pk_sequence!(parent, pk, sequence)
+          else
+            unless pk and sequence
+              default_pk, default_sequence = pk_and_sequence_for(table)
+              pk ||= default_pk
+              sequence ||= default_sequence
+            end
+            if pk
+              if sequence
+                select_value <<-end_sql, 'Reset sequence'
+                  SELECT setval('#{sequence}', (SELECT COALESCE(MAX(#{pk})+(SELECT increment_by FROM #{sequence}), (SELECT min_value FROM #{sequence})) FROM #{table}), false)
+                end_sql
+              else
+                @logger.warn "#{table} has primary key #{pk} with no default sequence" if @logger
+              end
             end
           end
         end
-      end
 
-      def primary_key(relation)
-        res = pk_and_sequence_for(relation)
-        res && res.first
-      end
+        def primary_key(relation)
+          res = pk_and_sequence_for(relation)
+          res && res.first
+        end
+
+        # Returns a relation's primary key and belonging sequence. If +relation+ is a table the result is its PK and sequence.
+        # When it is a view, PK and sequence of the table at the root of the inheritance chain are returned.
+        def pk_and_sequence_for(relation)
+          result = query(<<-end_sql, 'PK')[0]
+            SELECT attr.attname
+              FROM pg_attribute attr,
+                   pg_constraint cons
+             WHERE cons.conrelid = attr.attrelid
+               AND cons.conrelid = '#{relation}'::regclass
+               AND cons.contype  = 'p'
+               AND attr.attnum   = ANY(cons.conkey)
+          end_sql
+          if result.nil? or result.empty?
+            parent = parent_table(relation)
+            pk_and_sequence_for(parent) if parent
+          else
+            # log(result[0], "PK for #{relation}") {}
+            [result[0], query("SELECT pg_get_serial_sequence('#{relation}', '#{result[0]}') ")[0][0]]
+          end
+        rescue
+          nil
+        end
 
-      # Returns a relation's primary key and belonging sequence. If +relation+ is a table the result is its PK and sequence.
-      # When it is a view, PK and sequence of the table at the root of the inheritance chain are returned.
-      def pk_and_sequence_for(relation)
-        result = query(<<-end_sql, 'PK')[0]
-          SELECT attr.attname
-            FROM pg_attribute attr,
-                 pg_constraint cons
-           WHERE cons.conrelid = attr.attrelid
-             AND cons.conrelid = '#{relation}'::regclass
-             AND cons.contype  = 'p'
-             AND attr.attnum   = ANY(cons.conkey)
-        end_sql
-        if result.nil? or result.empty?
-          parent = parent_table(relation)
-          pk_and_sequence_for(parent) if parent
-        else
-          # log(result[0], "PK for #{relation}") {}
-          [result[0], query("SELECT pg_get_serial_sequence('#{relation}', '#{result[0]}') ")[0][0]]
+        # Drops a view from the database.
+        def drop_view(name)
+          execute "DROP VIEW #{name}"
         end
-      rescue
-        nil
-      end
 
-      # Drops a view from the database.
-      def drop_view(name)
-        execute "DROP VIEW #{name}"
-      end
+        # Return the list of all views in the schema search path.
+        def views(name=nil)
+          schemas = schema_search_path.split(/,\s*/).map { |p| quote(p) }.join(',')
+          query(<<~SQL, name).map { |row| row[0] }
+            SELECT viewname
+              FROM pg_views
+             WHERE schemaname IN (#{schemas})
+          SQL
+        end
 
-      # Return the list of all views in the schema search path.
-      def views(name=nil)
-        schemas = schema_search_path.split(/,\s*/).map { |p| quote(p) }.join(',')
-        query(<<-SQL, name).map { |row| row[0] }
-          SELECT viewname
-            FROM pg_views
-           WHERE schemaname IN (#{schemas})
-        SQL
-      end
+        # Checks whether relation +name+ is a view.
+        def is_view?(name)
+          result = query(<<~SQL, name).map { |row| row[0] }
+            SELECT viewname
+              FROM pg_views
+             WHERE viewname = '#{name}'
+          SQL
+          !result.empty?
+        end
 
-      # Checks whether relation +name+ is a view.
-      def is_view?(name)
-        result = query(<<-SQL, name).map { |row| row[0] }
-          SELECT viewname
-            FROM pg_views
-           WHERE viewname = '#{name}'
-        SQL
-        !result.empty?
-      end
+        # Recursively delete +parent_relation+ (if it is a view) and the children views the depend on it.
+        def remove_parent_and_children_views(parent_relation)
+          children_views = query(<<-end_sql).map{|row| row[0]}
+            SELECT child_aggregate_view
+              FROM updateable_views_inheritance
+             WHERE parent_relation = '#{parent_relation}'
+          end_sql
+          children_views.each do |cv|
+            remove_parent_and_children_views(cv)
+            # drop the view only if it wasn't dropped beforehand in recursive call from other method.
+            drop_view(cv) if is_view?(cv)
+          end
+          drop_view(parent_relation) if is_view?(parent_relation)
+        end
 
-      # Recursively delete +parent_relation+ (if it is a view) and the children views the depend on it.
-      def remove_parent_and_children_views(parent_relation)
-        children_views = query(<<-end_sql).map{|row| row[0]}
-          SELECT child_aggregate_view
-            FROM updateable_views_inheritance
-           WHERE parent_relation = '#{parent_relation}'
-        end_sql
-        children_views.each do |cv|
-          remove_parent_and_children_views(cv)
-          # drop the view only if it wasn't dropped beforehand in recursive call from other method.
-          drop_view(cv) if is_view?(cv)
+        # Recreates all views in all hierarchy chains
+        def rebuild_all_parent_and_children_views
+          parent_relations = select_values('SELECT DISTINCT parent_relation FROM updateable_views_inheritance')
+          parent_relations.each { |parent_relation| rebuild_parent_and_children_views(parent_relation) }
         end
-        drop_view(parent_relation) if is_view?(parent_relation)
-      end
 
-      # Recreates all views in all hierarchy chains
-      def rebuild_all_parent_and_children_views
-        parent_relations = select_values('SELECT DISTINCT parent_relation FROM updateable_views_inheritance')
-        parent_relations.each { |parent_relation| rebuild_parent_and_children_views(parent_relation) }
-      end
+        # Recreates views in the part of the hierarchy chain starting from the +parent_relation+.
+        def rebuild_parent_and_children_views(parent_relation)
+          # Current implementation is not very efficient - it can drop and recreate one and the same view in the bottom of the hierarchy many times.
+          remove_parent_and_children_views(parent_relation)
+          children = query(<<-end_sql)
+            SELECT parent_relation, child_aggregate_view, child_relation
+              FROM updateable_views_inheritance
+             WHERE parent_relation = '#{parent_relation}'
+          end_sql
+
+          #if the parent is in the middle of the inheritance chain, it's a view that should be rebuilt as well
+          parent = query(<<-end_sql)[0]
+            SELECT parent_relation, child_aggregate_view, child_relation
+              FROM updateable_views_inheritance
+             WHERE child_aggregate_view = '#{parent_relation}'
+          end_sql
+          create_child_view(parent[0], parent[1], parent[2]) if (parent && !parent.empty?)
 
-      # Recreates views in the part of the hierarchy chain starting from the +parent_relation+.
-      def rebuild_parent_and_children_views(parent_relation)
-        # Current implementation is not very efficient - it can drop and recreate one and the same view in the bottom of the hierarchy many times.
-        remove_parent_and_children_views(parent_relation)
-        children = query(<<-end_sql)
-          SELECT parent_relation, child_aggregate_view, child_relation
-            FROM updateable_views_inheritance
-           WHERE parent_relation = '#{parent_relation}'
-        end_sql
-
-        #if the parent is in the middle of the inheritance chain, it's a view that should be rebuilt as well
-        parent = query(<<-end_sql)[0]
-          SELECT parent_relation, child_aggregate_view, child_relation
-            FROM updateable_views_inheritance
-           WHERE child_aggregate_view = '#{parent_relation}'
-        end_sql
-        create_child_view(parent[0], parent[1], parent[2]) if (parent && !parent.empty?)
-
-        children.each do |child|
-          create_child_view(child[0], child[1], child[2])
-          rebuild_parent_and_children_views(child[1])
+          children.each do |child|
+            create_child_view(child[0], child[1], child[2])
+            rebuild_parent_and_children_views(child[1])
+          end
         end
-      end
 
-      # Creates Single Table Inheritanche-like aggregate view called +sti_aggregate_view+
-      # for +parent_relation+ and all its descendants. <i>The view isn't updateable.</i>
-      # The order of all or just the first few columns in the aggregate view can be explicitly set
-      # by passing array of column names as third argument.
-      # If there are columns with the same name but different types in two or more relations
-      # they will appear as a single column of type +text+ in the view.
-      def create_single_table_inheritance_view(sti_aggregate_view, parent_relation, columns_for_view = nil)
-        columns_for_view ||= []
-        relations_heirarchy = get_view_hierarchy_for(parent_relation)
-        relations = relations_heirarchy.flatten
-        leaves_relations = get_leaves_relations(relations_heirarchy)
-        all_columns = leaves_relations.map{|rel| columns(rel)}.flatten
-        columns_hash = {}
-        conflict_column_names = []
-        all_columns.each do |col|
-          c = columns_hash[col.name]
-          if(c && col.sql_type != c.sql_type)
-            conflict_column_names << col.name
-          else
-            columns_hash[col.name] = col
+        # Creates Single Table Inheritanche-like aggregate view called +sti_aggregate_view+
+        # for +parent_relation+ and all its descendants. <i>The view isn't updateable.</i>
+        # The order of all or just the first few columns in the aggregate view can be explicitly set
+        # by passing array of column names as third argument.
+        # If there are columns with the same name but different types in two or more relations
+        # they will appear as a single column of type +text+ in the view.
+        def create_single_table_inheritance_view(sti_aggregate_view, parent_relation, columns_for_view = nil)
+          columns_for_view ||= []
+          relations_heirarchy = get_view_hierarchy_for(parent_relation)
+          relations = relations_heirarchy.flatten
+          leaves_relations = get_leaves_relations(relations_heirarchy)
+          all_columns = leaves_relations.map{|rel| columns(rel)}.flatten
+          columns_hash = {}
+          conflict_column_names = []
+          all_columns.each do |col|
+            c = columns_hash[col.name]
+            if(c && col.sql_type != c.sql_type)
+              conflict_column_names << col.name
+            else
+              columns_hash[col.name] = col
+            end
           end
+          conflict_column_names = conflict_column_names.uniq.sort if !conflict_column_names.empty?
+          sorted_column_names = (columns_for_view + columns_hash.keys.sort).uniq
+          parent_klass_name = Tutuf::ClassTableReflection.get_klass_for_table(parent_relation)
+          quoted_inheritance_column = quote_column_name(parent_klass_name.inheritance_column)
+          queries = relations.map{|rel| generate_single_table_inheritanche_union_clause(rel, sorted_column_names, conflict_column_names, columns_hash, quoted_inheritance_column)}
+          unioin_clauses = queries.join("\n UNION ")
+          execute <<-end_sql
+            CREATE VIEW #{sti_aggregate_view} AS (
+              #{unioin_clauses}
+            )
+          end_sql
         end
-        conflict_column_names = conflict_column_names.uniq.sort if !conflict_column_names.empty?
-        sorted_column_names = (columns_for_view + columns_hash.keys.sort).uniq
-        parent_klass_name = Tutuf::ClassTableReflection.get_klass_for_table(parent_relation)
-        quoted_inheritance_column = quote_column_name(parent_klass_name.inheritance_column)
-        queries = relations.map{|rel| generate_single_table_inheritanche_union_clause(rel, sorted_column_names, conflict_column_names, columns_hash, quoted_inheritance_column)}
-        unioin_clauses = queries.join("\n UNION ")
-        execute <<-end_sql
-          CREATE VIEW #{sti_aggregate_view} AS (
-            #{unioin_clauses}
-          )
-        end_sql
-      end
 
-      # Recreates the Single_Table_Inheritanche-like aggregate view +sti_aggregate_view+
-      # for +parent_relation+ and all its descendants.
-      def rebuild_single_table_inheritance_view(sti_aggregate_view, parent_relation, columns_for_view = nil)
-        drop_view(sti_aggregate_view)
-        create_single_table_inheritance_view(sti_aggregate_view, parent_relation, columns_for_view)
-      end
+        # Recreates the Single_Table_Inheritanche-like aggregate view +sti_aggregate_view+
+        # for +parent_relation+ and all its descendants.
+        def rebuild_single_table_inheritance_view(sti_aggregate_view, parent_relation, columns_for_view = nil)
+          drop_view(sti_aggregate_view)
+          create_single_table_inheritance_view(sti_aggregate_view, parent_relation, columns_for_view)
+        end
 
-      # Overriden - it must return false, otherwise deleting fixtures won't work
-      def supports_disable_referential_integrity?
-        false
-      end
+        # Overriden - it solargraph-must return false, otherwise deleting fixtures won't work
+        def supports_disable_referential_integrity?
+          false
+        end
 
-      def table_exists_with_updateable_views_inheritance_support?(name)
-        is_view?(name) ? true : table_exists_without_updateable_views_inheritance_support?(name)
-      end
-      alias_method_chain :table_exists?, :updateable_views_inheritance_support
+        def table_exists_with_updateable_views_inheritance_support?(name)
+          is_view?(name) ? true : table_exists_without_updateable_views_inheritance_support?(name)
+        end
+        alias_method_chain :table_exists?, :updateable_views_inheritance_support
 
-      module Tutuf #:nodoc:
-        class ClassTableReflection
-          class << self
+        module Tutuf #:nodoc:
+          class ClassTableReflection
+            class << self
               # Returns all models' class objects that are ActiveRecord::Base descendants
               def all_db_klasses
                 return @@klasses if defined?(@@klasses)
+
                 @@klasses = []
                 # load model classes so that inheritance_column is set correctly where defined
                 model_filenames.collect{|m| load "#{Rails.root}/app/models/#{m}";m.match(%r{([^/]+?)\.rb$})[1].camelize.constantize }.each do |klass|
@@ -263,6 +275,7 @@ module ActiveRecord #:nodoc:
               # {table_name1 => ClassName1, ...}
               def klass_for_tables
                 return @@tables_klasses if defined?(@@tables_klasses)
+
                 @@tables_klasses = {}
                 all_db_klasses.each do |klass|
                   @@tables_klasses[klass.table_name] = klass if klass.respond_to?(:table_name)
@@ -274,11 +287,20 @@ module ActiveRecord #:nodoc:
               def model_filenames
                 Dir.chdir("#{Rails.root}/app/models"){ Dir["**/*.rb"] }
               end
+            end
           end
         end
-      end
 
-      private
+        # Set default values from the table columns for a view
+        def set_defaults(view_name, table_name)
+          column_definitions(table_name).each do |column_name, type, default, notnull|
+            if !default.nil?
+              execute("ALTER TABLE #{quote_table_name(view_name)} ALTER #{quote_column_name(column_name)} SET DEFAULT #{default}")
+            end
+          end
+        end
+
+        private
 
         def do_create_child_view(parent_table, parent_columns, parent_pk, child_view, child_columns, child_pk, child_table)
           view_columns = parent_columns + child_columns
@@ -307,7 +329,7 @@ module ActiveRecord #:nodoc:
               INSERT INTO #{child_table}
                      ( #{ [child_pk, child_columns].flatten.join(",")} )
                      VALUES( currval('#{parent_pk_seq}') #{ child_columns.empty? ? '' : ' ,' + child_columns.collect{ |col| "NEW." + col}.join(", ") }  )
-                     #{insert_returning_clause(parent_pk, child_pk, child_view) if supports_insert_with_returning?}
+                     #{insert_returning_clause(parent_pk, child_pk, child_view)}
             )
           end_sql
 
@@ -324,11 +346,11 @@ module ActiveRecord #:nodoc:
             ON UPDATE TO #{child_view} DO INSTEAD (
               #{ parent_columns.empty? ? '':
                  "UPDATE #{parent_table}
-                     SET #{ parent_columns.collect{ |col| col + "= NEW." +col }.join(", ") }
+                     SET #{ parent_columns.collect{ |col| col + "= NEW." + col }.join(", ") }
                      WHERE #{parent_pk} = OLD.#{parent_pk};"}
               #{ child_columns.empty? ? '':
                  "UPDATE #{child_table}
-                     SET #{ child_columns.collect{ |col| col + " = NEW." +col }.join(", ") }
+                     SET #{ child_columns.collect{ |col| col + " = NEW." + col }.join(", ") }
                      WHERE #{child_pk} = OLD.#{parent_pk}"
                 }
             )
@@ -343,24 +365,15 @@ module ActiveRecord #:nodoc:
           "RETURNING #{child_pk}, #{columns_cast_to_null}"
         end
 
-        # Set default values from the table columns for a view
-        def set_defaults(view_name, table_name)
-          column_definitions(table_name).each do |column_name, type, default, notnull|
-            if !default.nil?
-              execute("ALTER TABLE #{quote_table_name(view_name)} ALTER #{quote_column_name(column_name)} SET DEFAULT #{default}")
-            end
-          end
-        end
-
         def create_system_table_records(parent_relation, child_aggregate_view, child_relation)
           parent_relation, child_aggregate_view, child_relation = [parent_relation, child_aggregate_view, child_relation].collect{|rel| quote(rel.to_s)}
-          exists = query <<-end_sql
+          exists = query <<~SQL
             SELECT parent_relation, child_aggregate_view, child_relation
               FROM updateable_views_inheritance
              WHERE parent_relation      = #{parent_relation}
                AND child_aggregate_view = #{child_aggregate_view}
                AND child_relation       = #{child_relation}
-          end_sql
+          SQL
           # log "res: #{exists}"
           if exists.nil? or exists.empty?
             execute "INSERT INTO updateable_views_inheritance (parent_relation, child_aggregate_view, child_relation)" +
@@ -431,6 +444,7 @@ module ActiveRecord #:nodoc:
           where_clause = " WHERE #{quoted_inheritance_column} = '#{rel_klass_name}'"
           ["SELECT", columns_select, "FROM #{rel} #{where_clause}"].join(" ")
         end
+      end
     end
   end
 end

data/lib/updateable_views_inheritance/version.rb

@@ -1,3 +1,3 @@
 module UpdateableViewsInheritance
-  VERSION = "1.4.1"
+  VERSION = "1.4.3"
 end

data/test/content_test.rb

@@ -3,9 +3,6 @@ require File.join(File.dirname(__FILE__), 'test_helper')
 class UpdateableViewsInheritanceContentTest < ActiveSupport::TestCase
   def setup
     ActiveRecord::Migrator.up(File.dirname(__FILE__) + '/fixtures/migrations/', 5)
-  end
-
-  def teardown
     ActiveRecord::FixtureSet.reset_cache
   end
 

data/test/deep_hierarchy_test.rb

@@ -15,7 +15,7 @@ class DeepHierarchyTest < ActiveSupport::TestCase
   end
 
   def test_deeper_hierarchy
-    assert_equal [["boats"], ["railed_vehicles", ["trains", ["electric_trains", ["maglev_trains"]], ["rack_trains"], ["steam_trains"]]], ["wheeled_vehicles", ["bicycles"], ["cars"]]].sort,
+    assert_equal [["boats"], ["railed_vehicles", ["trains", ["steam_trains"], ["rack_trains"], ["electric_trains", ["maglev_trains"]]]], ["wheeled_vehicles", ["bicycles"], ["cars"]]].sort,
                   @connection.send(:get_view_hierarchy_for, :vehicles).sort
   end
 

data/test/dummy/config/environments/test.rb

@@ -30,4 +30,6 @@ Dummy::Application.configure do
   config.active_support.deprecation = :stderr;
 
   config.eager_load = false
+
+  config.active_support.test_order = :random
 end

data/test/dummy/config/initializers/backtrace_silencers.rb

@@ -4,4 +4,4 @@
 # Rails.backtrace_cleaner.add_silencer { |line| line =~ /my_noisy_library/ }
 
 # You can also remove all the silencers if you're trying to debug a problem that might stem from framework code.
-# Rails.backtrace_cleaner.remove_silencers!
+Rails.backtrace_cleaner.remove_silencers!

data/test/instantiation_test.rb

@@ -0,0 +1,40 @@
+require File.join(File.dirname(__FILE__), 'test_helper')
+
+class InstantiationTest < ActiveSupport::TestCase
+  def setup
+    ActiveRecord::Migrator.up(File.dirname(__FILE__) + '/fixtures/migrations/', 7)
+    # order of fixtures is important for the test - last loaded should not be with max(id)
+    %w[steam_locomotives electric_locomotives maglev_locomotives bicycles].each do |f|
+      ActiveRecord::FixtureSet.create_fixtures(File.dirname(__FILE__) + '/fixtures/', f)
+    end
+    @connection = ActiveRecord::Base.connection
+  end
+
+  def teardown
+    ActiveRecord::FixtureSet.reset_cache
+  end
+
+  class ::Locomotive < ActiveRecord::Base
+    self.disable_inheritance_instantiation = true
+  end
+
+  class ::ElectricLocomotive < Locomotive
+    self.disable_inheritance_instantiation = false
+  end
+
+  def test_setting_disable_inheritance_instantiation_does_not_load_child_columns
+    assert_equal %w[id max_speed name type],
+                 Locomotive.first.attributes.keys.sort
+  end
+
+  def test_switching_off_disable_inheritance_instantiation_loads_child_columns
+    assert_equal %w[electricity_consumption id magnetic_field max_speed name type],
+                 MaglevLocomotive.first.attributes.keys.sort
+  end
+
+  def test_disable_inheritance_instantiatioon_not_set_loads_child_attributes
+    assert_equal %w[id name number_of_gears number_of_wheels vehicle_type],
+                 Bicycle.first.attributes.keys.sort
+
+  end
+end

data/test/schema_test.rb

@@ -16,7 +16,7 @@ class UpdateableViewsInheritanceSchemaTest < ActiveSupport::TestCase
 
 
   def test_content_columns
-    assert !SteamLocomotive.content_columns.include?("id")
+    assert !SteamLocomotive.content_columns.map(&:name).include?("id")
   end
 
   def test_views
@@ -221,4 +221,22 @@ class UpdateableViewsInheritanceSchemaTest < ActiveSupport::TestCase
     assert @connection.columns(:bicycles).map{ |c| c.name }.include?('wheel_size'),
            "Newly added column not present in view after rebuild for 2. hierarchy"
   end
+
+  class UseExistingTable < ActiveRecord::Migration
+    def self.up
+      create_table :tbl_diesel_locomotives do |t|
+        t.belongs_to :locomotives
+        t.integer :num_cylinders
+      end
+      create_child(:diesel_locomotives,
+                   table: :tbl_diesel_locomotives,
+                   parent: :locomotives,
+                   skip_creating_child_table: true)
+    end
+  end
+
+  def test_skip_creating_child_table
+    UseExistingTable.up
+    assert @connection.columns(:diesel_locomotives).map(&:name).include?("num_cylinders")
+  end
 end

data/test/test_helper.rb

@@ -5,10 +5,6 @@ require File.expand_path("../dummy/config/environment.rb",  __FILE__)
 require 'rails/test_help'
 require 'updateable_views_inheritance'
 
-# get full stack trace on errors
-require "minitest/reporters"
-Minitest::Reporters.use!
-
 begin
   if RUBY_VERSION > "2"
     require 'byebug'

data/updateable_views_inheritance.gemspec

@@ -18,12 +18,13 @@ Gem::Specification.new do |s|
   s.test_files    = s.files.grep(%r{^(test|spec|features)/})
   s.require_paths = ["lib"]
 
-  s.add_dependency "activerecord", ">= 4.0", "< 5"
-  s.add_dependency "pg"
+  s.add_dependency "activerecord", "~> 4.2.8"
+  s.add_dependency "pg", "~> 0.21"
 
   s.add_development_dependency 'minitest'
-  s.add_development_dependency 'minitest-reporters'
-  s.add_development_dependency "rails", ' ~> 4.1.16' # ">= 4.0", "< 5"
-  s.add_development_dependency "bundler", "~> 1.3"
+  s.add_development_dependency "rails", '= 4.2.11.1'
+  s.add_development_dependency "bundler"
   s.add_development_dependency "rake"
+  s.add_development_dependency 'bigdecimal', '1.3.5'
+  s.add_development_dependency "solargraph"
 end

metadata

@@ -1,50 +1,44 @@
 --- !ruby/object:Gem::Specification
 name: updateable_views_inheritance
 version: !ruby/object:Gem::Version
-  version: 1.4.1
+  version: 1.4.3
 platform: ruby
 authors:
 - Sava Chankov
 - Denitsa Belogusheva
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2017-03-20 00:00:00.000000000 Z
+date: 2024-10-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '4.0'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '5'
+        version: 4.2.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '4.0'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '5'
+        version: 4.2.8
 - !ruby/object:Gem::Dependency
   name: pg
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.21'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.21'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -60,7 +54,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: minitest-reporters
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 4.2.11.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 4.2.11.1
+- !ruby/object:Gem::Dependency
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -74,35 +82,35 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rails
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 4.1.16
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 4.1.16
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: bigdecimal
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - '='
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: 1.3.5
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - '='
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: 1.3.5
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: solargraph
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -128,7 +136,7 @@ files:
 - CHANGELOG.md
 - Gemfile
 - MIT-LICENSE
-- README.rdoc
+- README.md
 - Rakefile
 - doc/template/horo.rb
 - lib/generators/updateable_views_inheritance/install_generator.rb
@@ -141,6 +149,7 @@ files:
 - test/content_test.rb
 - test/deep_hierarchy_test.rb
 - test/dummy/Rakefile
+- test/dummy/app/assets/config/manifest.js
 - test/dummy/app/assets/javascripts/application.js
 - test/dummy/app/assets/stylesheets/application.css
 - test/dummy/app/controllers/application_controller.rb
@@ -205,6 +214,7 @@ files:
 - test/fixtures/steam_locomotives.yml
 - test/fixtures/steam_trains.yml
 - test/install_generator_test.rb
+- test/instantiation_test.rb
 - test/migration_test.rb
 - test/pg_insert_returning_with_rules_spec.rb
 - test/schema_test.rb
@@ -215,7 +225,7 @@ homepage: http://github.com/tutuf/updateable_views_inheritance
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -230,15 +240,15 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.10
-signing_key: 
+rubygems_version: 3.4.12
+signing_key:
 specification_version: 4
 summary: Class table inheritance for ActiveRecord
 test_files:
 - test/content_test.rb
 - test/deep_hierarchy_test.rb
 - test/dummy/Rakefile
+- test/dummy/app/assets/config/manifest.js
 - test/dummy/app/assets/javascripts/application.js
 - test/dummy/app/assets/stylesheets/application.css
 - test/dummy/app/controllers/application_controller.rb
@@ -303,6 +313,7 @@ test_files:
 - test/fixtures/steam_locomotives.yml
 - test/fixtures/steam_trains.yml
 - test/install_generator_test.rb
+- test/instantiation_test.rb
 - test/migration_test.rb
 - test/pg_insert_returning_with_rules_spec.rb
 - test/schema_test.rb

data/README.rdoc

@@ -1,121 +0,0 @@
-==Class Table Inheritance
-
-Class Table Inheritance for ActiveRecord using updateable views.
-
-More about the pattern on http://www.martinfowler.com/eaaCatalog/classTableInheritance.html. This gem messes very little with Rails inheritance mechanism.
-Instead it relies on updatable views in the database to represent classes in the inheritance chain. The approach was {first suggested by John
-Wilger}[http://web.archive.org/web/20060408145717/johnwilger.com/articles/2005/09/29/class-table-inheritance-in-rails-with-postgresql].
-
-
-==Requirements
-
-Rails: 4.x
-
-Ruby: 1.9.3+
-
-Database: PostgreSQL 8.1+ only. Patches for other DBMS are welcome. Note that you are not required to use updateable views, children relations can be tables (with some triggers involved) or materialized views.
-
-==Install
-Run
-  gem install updateable_views_inheritance
-
-==Usage
-
-===Setup
-
-* In <tt>Gemfile</tt> add <tt>gem 'updateable_views_inheritance'</tt>
-* Run <tt>rails generate updateable_views_inheritance:install && rake db:migrate</tt>
-* In <tt>config/environment.rb</tt> set <tt>config.active_record.schema_format = :sql</tt>
-* In case you're using fixtures, don't forget to run
-
-    rake updateable_views_inheritance:fixture
-
-after every change to the class hierarchy. Otherwise tests may fail.
-
-===Example
-
-  class CtiExample < ActiveRecord::Migration
-    def self.up
-      create_table :locomotives do |t|
-        t.column :name, :string
-        t.column :max_speed, :integer
-        t.column :type, :string
-      end
-
-      create_child(:steam_locomotives, :parent => :locomotives) do |t|
-        t.decimal :water_consumption, :precision => 6, :scale => 2
-        t.decimal :coal_consumption,  :precision => 6, :scale => 2
-      end
-
-      create_child(:electric_locomotives, :table => :raw_electric_locomotives, :parent => :locomotives)  do |t|
-        t.decimal :electricity_consumption, :precision => 6, :scale => 2
-      end
-    end
-
-    def self.down
-      drop_child  :steam_locomotives
-      drop_child  :electric_locomotives
-      drop_table  :locomotives
-    end
-  end
-
-And the models:
-  class Locomotive
-  end
-
-  class SteamLocomotive < Locomotive
-    self.table_name =  :steam_locomotives
-  end
-
-  class ElectricLocomotive < Locomotive
-    self.table_name =  :electric_locomotives
-  end
-
-Note that models of children classes must specify table name explicitly.
-
-===Changing Columns in Underlying Tables
-
-  class RemoveColumnInParentTable < ActiveRecord::Migration
-    def self.up
-      remove_parent_and_children_views(:locomotives)
-      remove_column(:locomotives, :max_speed)
-      rename_column(:name, :title)
-      rebuild_parent_and_children_views(:locomotives)
-    end
-  end
-
-===Renaming Underlying Tables
-
-  remove_parent_and_children_views(:old_name)
-  rename_table(:old_name,:new_name)
-  execute "UPDATE updateable_views_inheritance SET child_aggregate_view = 'new_name' WHERE child_aggregate_view = 'old_name'"
-  execute "UPDATE updateable_views_inheritance SET parent_relation = 'new_name' WHERE parent_relation = 'old_name'"
-  rebuild_parent_and_children_views(:new_name)
-
-===Removing Classes
-
-Note that you should remove only leaf classes (i.e. those that do not have descendants). If you want to erase a whole chain or part of chain you have to remove first the leaves and then their ancestors. Use <tt>drop_child(child_view)</tt> in migrations.
-
-==Compatibility with Single Table Inheritance
-
-The approach of this gem is completely independent from Rails built-in Single Table Inheritance. STI and CLTI can safely be mixed in one inheritance chain.
-
-==Testing Your App
-
-If you use fixtures, you must run <tt>rake updateable_views_inheritance:fixture</tt> to generate fixture for the updateable_views_inheritance table after you add/remove
-classes from the hierarchy or change underlying table or view names. <b>Without it primary key sequence for inheritors' tables won't be bumped to the max and it might not be possible to save objects!</b> If you don't use fixtures for the classes in the hierarchy you don't need to do that.
-
-This gem re-enables referential integrity on fixture loading. This means that
-
-  fixtures :all
-
-may fail when there are foreign key constraints on tables. To fix this, explicitly declare fixture load order in <tt>test_helper.rb</tt>:
-
-  fixtures :roots, :trunks, :leafs, ...
-
-for all fixtures you want to load.
-
-==Gem Development & Testing
-
-The gem has a comprehensive test suite. In order to run it, your user must be a superuser in PostgreSQL.
-If this is not the case, run <tt>createuser -s pesho</tt> (assuming your Unix account is <tt>pesho</tt>).