dm-core 0.9.11 → 0.10.0

data/lib/dm-core/core_ext/kernel.rb

@@ -0,0 +1,12 @@
+module Kernel
+  private
+
+  # Delegates to DataMapper.repository()
+  #
+  # TODO: document
+  #
+  # @api public
+  def repository(*args, &block)
+    DataMapper.repository(*args, &block)
+  end
+end # module Kernel

data/lib/dm-core/core_ext/symbol.rb

@@ -0,0 +1,10 @@
+class Symbol
+  (DataMapper::Query::Conditions::Comparison.slugs | [ :not, :asc, :desc ]).each do |sym|
+    class_eval <<-RUBY, __FILE__, __LINE__ + 1
+      def #{sym}
+        #{"warn \"explicit use of '#{sym}' operator is deprecated (#{caller[0]})\"" if sym == :eql || sym == :in}
+        DataMapper::Query::Operator.new(self, #{sym.inspect})
+      end
+    RUBY
+  end
+end # class Symbol

data/lib/dm-core/identity_map.rb

@@ -2,41 +2,11 @@ module DataMapper
 
   # Tracks objects to help ensure that each object gets loaded only once.
   # See: http://www.martinfowler.com/eaaCatalog/identityMap.html
-  class IdentityMap
-    # Get a resource from the IdentityMap
-    def get(key)
-      @cache[key] || (@second_level_cache && @second_level_cache.get(key))
-    end
+  class IdentityMap < Hash
+    extend Deprecate
 
-    alias [] get
+    deprecate :get, :[]
+    deprecate :set, :[]=
 
-    # Add a resource to the IdentityMap
-    def set(key, resource)
-      @second_level_cache.set(key, resource) if @second_level_cache
-      @cache[key] = resource
-    end
-
-    alias []= set
-
-    # Remove a resource from the IdentityMap
-    def delete(key)
-      @second_level_cache.delete(key) if @second_level_cache
-      @cache.delete(key)
-    end
-
-    private
-
-    def initialize(second_level_cache = nil)
-      @cache = {}
-      @second_level_cache = second_level_cache
-    end
-
-    def cache
-      @cache
-    end
-
-    def method_missing(method, *args, &block)
-      cache.__send__(method, *args, &block)
-    end
   end # class IdentityMap
 end # module DataMapper

data/lib/dm-core/migrations.rb

@@ -0,0 +1,1283 @@
+# TODO: move to dm-more/dm-migrations
+
+module DataMapper
+  module Migrations
+    module SingletonMethods
+      # destructively migrates the repository upwards to match model definitions
+      #
+      # @param [Symbol] name repository to act on, :default is the default
+      #
+      # @api public
+      def migrate!(repository_name = nil)
+        repository(repository_name).migrate!
+      end
+
+      # drops and recreates the repository upwards to match model definitions
+      #
+      # @param [Symbol] name repository to act on, :default is the default
+      #
+      # @api public
+      def auto_migrate!(repository_name = nil)
+        auto_migrate_down!(repository_name)
+        auto_migrate_up!(repository_name)
+      end
+
+      # TODO: document
+      # @api public
+      def auto_upgrade!(repository_name = nil)
+        repository_execute(:auto_upgrade!, repository_name)
+      end
+
+      private
+
+      # TODO: document
+      # @api private
+      def auto_migrate_down!(repository_name)
+        repository_execute(:auto_migrate_down!, repository_name)
+      end
+
+      # TODO: document
+      # @api private
+      def auto_migrate_up!(repository_name)
+        repository_execute(:auto_migrate_up!, repository_name)
+      end
+
+      # TODO: document
+      # @api private
+      def repository_execute(method, repository_name)
+        DataMapper::Model.descendants.each do |model|
+          model.send(method, repository_name || model.default_repository_name)
+        end
+      end
+    end
+
+    module DataObjectsAdapter
+      # TODO: document
+      # @api private
+      def self.included(base)
+        base.extend ClassMethods
+
+        DataMapper.extend(Migrations::SingletonMethods)
+
+        [ :Repository, :Model ].each do |name|
+          DataMapper.const_get(name).send(:include, Migrations.const_get(name))
+        end
+      end
+
+      # Returns whether the storage_name exists.
+      #
+      # @param [String] storage_name
+      #   a String defining the name of a storage, for example a table name.
+      #
+      # @return [Boolean]
+      #   true if the storage exists
+      #
+      # @api semipublic
+      def storage_exists?(storage_name)
+        statement = <<-SQL.compress_lines
+          SELECT COUNT(*)
+          FROM "information_schema"."tables"
+          WHERE "table_type" = 'BASE TABLE'
+          AND "table_schema" = ?
+          AND "table_name" = ?
+        SQL
+
+        query(statement, schema_name, storage_name).first > 0
+      end
+
+      # Returns whether the field exists.
+      #
+      # @param [String] storage_name
+      #   a String defining the name of a storage, for example a table name.
+      # @param [String] field
+      #   a String defining the name of a field, for example a column name.
+      #
+      # @return [Boolean]
+      #   true if the field exists.
+      #
+      # @api semipublic
+      def field_exists?(storage_name, column_name)
+        statement = <<-SQL.compress_lines
+          SELECT COUNT(*)
+          FROM "information_schema"."columns"
+          WHERE "table_schema" = ?
+          AND "table_name" = ?
+          AND "column_name" = ?
+        SQL
+
+        query(statement, schema_name, storage_name, column_name).first > 0
+      end
+
+      # TODO: document
+      # @api semipublic
+      def upgrade_model_storage(model)
+        properties = model.properties_with_subclasses(name)
+
+        if success = create_model_storage(model)
+          return properties
+        end
+
+        table_name = model.storage_name(name)
+
+        with_connection do |connection|
+          properties.map do |property|
+            schema_hash = property_schema_hash(property)
+            next if field_exists?(table_name, schema_hash[:name])
+
+            statement = alter_table_add_column_statement(connection, table_name, schema_hash)
+            command   = connection.create_command(statement)
+            command.execute_non_query
+
+            property
+          end.compact
+        end
+      end
+
+      # TODO: document
+      # @api semipublic
+      def create_model_storage(model)
+        properties = model.properties_with_subclasses(name)
+
+        return false if storage_exists?(model.storage_name(name))
+        return false if properties.empty?
+
+        with_connection do |connection|
+          statement = create_table_statement(connection, model, properties)
+          command   = connection.create_command(statement)
+          command.execute_non_query
+
+          (create_index_statements(model) + create_unique_index_statements(model)).each do |statement|
+            command   = connection.create_command(statement)
+            command.execute_non_query
+          end
+        end
+
+        true
+      end
+
+      # TODO: document
+      # @api semipublic
+      def destroy_model_storage(model)
+        return true unless supports_drop_table_if_exists? || storage_exists?(model.storage_name(name))
+        execute(drop_table_statement(model))
+        true
+      end
+
+      module SQL #:nodoc:
+#        private  ## This cannot be private for current migrations
+
+        # Adapters that support AUTO INCREMENT fields for CREATE TABLE
+        # statements should overwrite this to return true
+        #
+        # @api private
+        def supports_serial?
+          false
+        end
+
+        # TODO: document
+        # @api private
+        def supports_drop_table_if_exists?
+          false
+        end
+
+        # TODO: document
+        # @api private
+        def schema_name
+          raise NotImplementedError, "#{self.class}#schema_name not implemented"
+        end
+
+        # TODO: document
+        # @api private
+        def alter_table_add_column_statement(connection, table_name, schema_hash)
+          "ALTER TABLE #{quote_name(table_name)} ADD COLUMN #{property_schema_statement(connection, schema_hash)}"
+        end
+
+        # TODO: document
+        # @api private
+        def create_table_statement(connection, model, properties)
+          statement = <<-SQL.compress_lines
+            CREATE TABLE #{quote_name(model.storage_name(name))}
+            (#{properties.map { |property| property_schema_statement(connection, property_schema_hash(property)) }.join(', ')},
+            PRIMARY KEY(#{ properties.key.map { |property| quote_name(property.field) }.join(', ')}))
+          SQL
+
+          statement
+        end
+
+        # TODO: document
+        # @api private
+        def drop_table_statement(model)
+          if supports_drop_table_if_exists?
+            "DROP TABLE IF EXISTS #{quote_name(model.storage_name(name))}"
+          else
+            "DROP TABLE #{quote_name(model.storage_name(name))}"
+          end
+        end
+
+        # TODO: document
+        # @api private
+        def create_index_statements(model)
+          table_name = model.storage_name(name)
+          model.properties(name).indexes.map do |index_name, fields|
+            <<-SQL.compress_lines
+              CREATE INDEX #{quote_name("index_#{table_name}_#{index_name}")} ON
+              #{quote_name(table_name)} (#{fields.map { |field| quote_name(field) }.join(', ')})
+            SQL
+          end
+        end
+
+        # TODO: document
+        # @api private
+        def create_unique_index_statements(model)
+          table_name = model.storage_name(name)
+          model.properties(name).unique_indexes.map do |index_name, fields|
+            <<-SQL.compress_lines
+              CREATE UNIQUE INDEX #{quote_name("unique_#{table_name}_#{index_name}")} ON
+              #{quote_name(table_name)} (#{fields.map { |field| quote_name(field) }.join(', ')})
+            SQL
+          end
+        end
+
+        # TODO: document
+        # @api private
+        def property_schema_hash(property)
+          schema = (self.class.type_map[property.type] || self.class.type_map[property.primitive]).merge(:name => property.field)
+
+          if property.primitive == String && schema[:primitive] != 'TEXT' && schema[:primitive] != 'CLOB'
+            schema[:length] = property.length
+          elsif property.primitive == BigDecimal || property.primitive == Float
+            schema[:precision] = property.precision
+            schema[:scale]     = property.scale
+          end
+
+          schema[:nullable] = property.nullable?
+          schema[:serial]   = property.serial?
+
+          if property.default.nil? || property.default.respond_to?(:call)
+            # remove the default if the property is not nullable
+            schema.delete(:default) unless property.nullable?
+          else
+            if property.type.respond_to?(:dump)
+              schema[:default] = property.type.dump(property.default, property)
+            else
+              schema[:default] = property.default
+            end
+          end
+
+          schema
+        end
+
+        # TODO: document
+        # @api private
+        def property_schema_statement(connection, schema)
+          statement = quote_name(schema[:name])
+          statement << " #{schema[:primitive]}"
+
+          if schema[:precision] && schema[:scale]
+            statement << "(#{[ :precision, :scale ].map { |key| connection.quote_value(schema[key]) }.join(', ')})"
+          elsif schema[:length]
+            statement << "(#{connection.quote_value(schema[:length])})"
+          end
+
+          statement << " DEFAULT #{connection.quote_value(schema[:default])}" if schema.key?(:default)
+          statement << ' NOT NULL' unless schema[:nullable]
+          statement
+        end
+      end # module SQL
+
+      include SQL
+
+      module ClassMethods
+        # Default types for all data object based adapters.
+        #
+        # @return [Hash] default types for data objects adapters.
+        #
+        # @api private
+        def type_map
+          length    = Property::DEFAULT_LENGTH
+          precision = Property::DEFAULT_PRECISION
+          scale     = Property::DEFAULT_SCALE_BIGDECIMAL
+
+          @type_map ||= {
+            Integer       => { :primitive => 'INTEGER'                                           },
+            String        => { :primitive => 'VARCHAR', :length => length                        },
+            Class         => { :primitive => 'VARCHAR', :length => length                        },
+            BigDecimal    => { :primitive => 'DECIMAL', :precision => precision, :scale => scale },
+            Float         => { :primitive => 'FLOAT',   :precision => precision                  },
+            DateTime      => { :primitive => 'TIMESTAMP'                                         },
+            Date          => { :primitive => 'DATE'                                              },
+            Time          => { :primitive => 'TIMESTAMP'                                         },
+            TrueClass     => { :primitive => 'BOOLEAN'                                           },
+            Types::Object => { :primitive => 'TEXT'                                              },
+            Types::Text   => { :primitive => 'TEXT'                                              },
+          }.freeze
+        end
+      end # module ClassMethods
+    end # module DataObjectsAdapter
+
+    module MysqlAdapter
+      DEFAULT_ENGINE        = 'InnoDB'.freeze
+      DEFAULT_CHARACTER_SET = 'utf8'.freeze
+      DEFAULT_COLLATION     = 'utf8_unicode_ci'.freeze
+
+      # TODO: document
+      # @api private
+      def self.included(base)
+        base.extend ClassMethods
+      end
+
+      # TODO: document
+      # @api semipublic
+      def storage_exists?(storage_name)
+        query('SHOW TABLES LIKE ?', storage_name).first == storage_name
+      end
+
+      # TODO: document
+      # @api semipublic
+      def field_exists?(storage_name, field)
+        result = query("SHOW COLUMNS FROM #{quote_name(storage_name)} LIKE ?", field).first
+        result ? result.field == field : false
+      end
+
+      module SQL #:nodoc:
+#        private  ## This cannot be private for current migrations
+
+        # TODO: document
+        # @api private
+        def supports_serial?
+          true
+        end
+
+        # TODO: document
+        # @api private
+        def supports_drop_table_if_exists?
+          true
+        end
+
+        # TODO: document
+        # @api private
+        def schema_name
+          # TODO: is there a cleaner way to find out the current DB we are connected to?
+          normalized_uri.path.split('/').last
+        end
+
+        # TODO: update dkubb/dm-more/dm-migrations to use schema_name and remove this
+        alias db_name schema_name
+
+        # TODO: document
+        # @api private
+        def create_table_statement(connection, model, properties)
+          "#{super} ENGINE = #{DEFAULT_ENGINE} CHARACTER SET #{character_set} COLLATE #{collation}"
+        end
+
+        # TODO: document
+        # @api private
+        def property_schema_hash(property)
+          schema = super
+
+          if schema[:primitive] == 'TEXT'
+            schema[:primitive] = text_column_statement(property.length)
+            schema.delete(:default)
+          end
+
+          if property.primitive == Integer && property.min && property.max
+            schema[:primitive] = integer_column_statement(property.min..property.max)
+          end
+
+          schema
+        end
+
+        # TODO: document
+        # @api private
+        def property_schema_statement(connection, schema)
+          statement = super
+
+          if supports_serial? && schema[:serial]
+            statement << ' AUTO_INCREMENT'
+          end
+
+          statement
+        end
+
+        # TODO: document
+        # @api private
+        def character_set
+          @character_set ||= show_variable('character_set_connection') || DEFAULT_CHARACTER_SET
+        end
+
+        # TODO: document
+        # @api private
+        def collation
+          @collation ||= show_variable('collation_connection') || DEFAULT_COLLATION
+        end
+
+        # TODO: document
+        # @api private
+        def show_variable(name)
+          result = query('SHOW VARIABLES LIKE ?', name).first
+          result ? result.value.freeze : nil
+        end
+
+        private
+
+        # Return SQL statement for the text column
+        #
+        # @param [Integer] length
+        #   the max allowed length
+        #
+        # @return [String]
+        #   the statement to create the text column
+        #
+        # @api private
+        def text_column_statement(length)
+          if    length < 2**8  then 'TINYTEXT'
+          elsif length < 2**16 then 'TEXT'
+          elsif length < 2**24 then 'MEDIUMTEXT'
+          elsif length < 2**32 then 'LONGTEXT'
+
+          # http://www.postgresql.org/files/documentation/books/aw_pgsql/node90.html
+          # Implies that PostgreSQL doesn't have a size limit on text
+          # fields, so this param validation happens here instead of
+          # DM::Property#initialize.
+          else
+            raise ArgumentError, "length of #{length} exceeds maximum size supported"
+          end
+        end
+
+        # Return SQL statement for the integer column
+        #
+        # @param [Range] range
+        #   the min/max allowed integers
+        #
+        # @return [String]
+        #   the statement to create the integer column
+        #
+        # @api private
+        def integer_column_statement(range)
+          '%s(%d)%s' % [
+            integer_column_type(range),
+            integer_display_size(range),
+            integer_statement_sign(range),
+          ]
+        end
+
+        # Return the integer column type
+        #
+        # Use the smallest available column type that will satisfy the
+        # allowable range of numbers
+        #
+        # @param [Range] range
+        #   the min/max allowed integers
+        #
+        # @return [String]
+        #   the column type
+        #
+        # @api private
+        def integer_column_type(range)
+          if range.first < 0
+            signed_integer_column_type(range)
+          else
+            unsigned_integer_column_type(range)
+          end
+        end
+
+        # Return the signed integer column type
+        #
+        # @param [Range] range
+        #   the min/max allowed integers
+        #
+        # @return [String]
+        #
+        # @api private
+        def signed_integer_column_type(range)
+          min = range.first
+          max = range.last
+
+          if    min >= -2**7  && max < 2**7  then 'TINYINT'
+          elsif min >= -2**15 && max < 2**15 then 'SMALLINT'
+          elsif min >= -2**23 && max < 2**23 then 'MEDIUMINT'
+          elsif min >= -2**31 && max < 2**31 then 'INT'
+          elsif min >= -2**63 && max < 2**63 then 'BIGINT'
+          else
+            raise ArgumentError, "min #{min} and max #{max} exceeds supported range"
+          end
+        end
+
+        # Return the unsigned integer column type
+        #
+        # @param [Range] range
+        #   the min/max allowed integers
+        #
+        # @return [String]
+        #
+        # @api private
+        def unsigned_integer_column_type(range)
+          max = range.last
+
+          if    max < 2**8  then 'TINYINT'
+          elsif max < 2**16 then 'SMALLINT'
+          elsif max < 2**24 then 'MEDIUMINT'
+          elsif max < 2**32 then 'INT'
+          elsif max < 2**64 then 'BIGINT'
+          else
+            raise ArgumentError, "min #{range.first} and max #{max} exceeds supported range"
+          end
+        end
+
+        # Return the integer column display size
+        #
+        # Adjust the display size to match the maximum number of
+        # expected digits. This is more for documentation purposes
+        # and does not affect what can actually be stored in a
+        # specific column
+        #
+        # @param [Range] range
+        #   the min/max allowed integers
+        #
+        # @return [Integer]
+        #   the display size for the integer
+        #
+        # @api private
+        def integer_display_size(range)
+          [ range.first.to_s.length, range.last.to_s.length ].max
+        end
+
+        # Return the integer sign statement
+        #
+        # @param [Range] range
+        #   the min/max allowed integers
+        #
+        # @return [String, nil]
+        #   statement if unsigned, nil if signed
+        #
+        # @api private
+        def integer_statement_sign(range)
+          ' UNSIGNED' unless range.first < 0
+        end
+      end # module SQL
+
+      include SQL
+
+      module ClassMethods
+        # Types for MySQL databases.
+        #
+        # @return [Hash] types for MySQL databases.
+        #
+        # @api private
+        def type_map
+          @type_map ||= super.merge(
+            DateTime => { :primitive => 'DATETIME' },
+            Time     => { :primitive => 'DATETIME' }
+          ).freeze
+        end
+      end # module ClassMethods
+    end # module MysqlAdapter
+
+    module PostgresAdapter
+      # TODO: document
+      # @api private
+      def self.included(base)
+        base.extend ClassMethods
+      end
+
+      # TODO: document
+      # @api semipublic
+      def upgrade_model_storage(model)
+        without_notices { super }
+      end
+
+      # TODO: document
+      # @api semipublic
+      def create_model_storage(model)
+        without_notices { super }
+      end
+
+      # TODO: document
+      # @api semipublic
+      def destroy_model_storage(model)
+        if supports_drop_table_if_exists?
+          without_notices { super }
+        else
+          super
+        end
+      end
+
+      module SQL #:nodoc:
+#        private  ## This cannot be private for current migrations
+
+        # TODO: document
+        # @api private
+        def supports_drop_table_if_exists?
+          @supports_drop_table_if_exists ||= postgres_version >= '8.2'
+        end
+
+        # TODO: document
+        # @api private
+        def schema_name
+          @schema_name ||= query('SELECT current_schema()').first.freeze
+        end
+
+        # TODO: document
+        # @api private
+        def postgres_version
+          @postgres_version ||= query('SELECT version()').first.split[1].freeze
+        end
+
+        # TODO: document
+        # @api private
+        def without_notices
+          # execute the block with NOTICE messages disabled
+          begin
+            execute('SET client_min_messages = warning')
+            yield
+          ensure
+            execute('RESET client_min_messages')
+          end
+        end
+
+        # TODO: document
+        # @api private
+        def property_schema_hash(property)
+          schema = super
+
+          # Postgres does not support precision and scale for Float
+          if property.primitive == Float
+            schema.delete(:precision)
+            schema.delete(:scale)
+          end
+
+          if property.primitive == Integer && property.min && property.max
+            schema[:primitive] = integer_column_statement(property.min..property.max)
+          end
+
+          if schema[:serial]
+            schema[:primitive] = serial_column_statement(property.min..property.max)
+          end
+
+          schema
+        end
+
+        private
+
+        # Return SQL statement for the integer column
+        #
+        # @param [Range] range
+        #   the min/max allowed integers
+        #
+        # @return [String]
+        #   the statement to create the integer column
+        #
+        # @api private
+        def integer_column_statement(range)
+          min = range.first
+          max = range.last
+
+          if    min >= -2**15 && max < 2**15 then 'SMALLINT'
+          elsif min >= -2**31 && max < 2**31 then 'INTEGER'
+          elsif min >= -2**63 && max < 2**63 then 'BIGINT'
+          else
+            raise ArgumentError, "min #{min} and max #{max} exceeds supported range"
+          end
+        end
+
+        # Return SQL statement for the serial column
+        #
+        # @param [Integer] max
+        #   the max allowed integer
+        #
+        # @return [String]
+        #   the statement to create the serial column
+        #
+        # @api private
+        def serial_column_statement(range)
+          max = range.last
+
+          if    max.nil? || max < 2**31 then 'SERIAL'
+          elsif             max < 2**63 then 'BIGSERIAL'
+          else
+            raise ArgumentError, "min #{range.first} and max #{max} exceeds supported range"
+          end
+        end
+      end # module SQL
+
+      include SQL
+
+      module ClassMethods
+        # Types for PostgreSQL databases.
+        #
+        # @return [Hash] types for PostgreSQL databases.
+        #
+        # @api private
+        def type_map
+          precision = Property::DEFAULT_PRECISION
+          scale     = Property::DEFAULT_SCALE_BIGDECIMAL
+
+          @type_map ||= super.merge(
+            BigDecimal => { :primitive => 'NUMERIC', :precision => precision, :scale => scale },
+            Float      => { :primitive => 'DOUBLE PRECISION'                                  }
+          ).freeze
+        end
+      end # module ClassMethods
+    end # module PostgresAdapter
+
+    module Sqlite3Adapter
+      # TODO: document
+      # @api private
+      def self.included(base)
+        base.extend ClassMethods
+      end
+
+      # TODO: document
+      # @api semipublic
+      def storage_exists?(storage_name)
+        query_table(storage_name).size > 0
+      end
+
+      # TODO: document
+      # @api semipublic
+      def field_exists?(storage_name, column_name)
+        query_table(storage_name).any? do |row|
+          row.name == column_name
+        end
+      end
+
+      module SQL #:nodoc:
+#        private  ## This cannot be private for current migrations
+
+        # TODO: document
+        # @api private
+        def supports_serial?
+          @supports_serial ||= sqlite_version >= '3.1.0'
+        end
+
+        # TODO: document
+        # @api private
+        def supports_drop_table_if_exists?
+          @supports_drop_table_if_exists ||= sqlite_version >= '3.3.0'
+        end
+
+        # TODO: document
+        # @api private
+        def query_table(table_name)
+          query("PRAGMA table_info(#{quote_name(table_name)})")
+        end
+
+        # TODO: document
+        # @api private
+        def create_table_statement(connection, model, properties)
+          statement = <<-SQL.compress_lines
+            CREATE TABLE #{quote_name(model.storage_name(name))}
+            (#{properties.map { |property| property_schema_statement(connection, property_schema_hash(property)) }.join(', ')}
+          SQL
+
+          # skip adding the primary key if one of the columns is serial.  In
+          # SQLite the serial column must be the primary key, so it has already
+          # been defined
+          unless properties.any? { |property| property.serial? }
+            statement << ", PRIMARY KEY(#{properties.key.map { |property| quote_name(property.field) }.join(', ')})"
+          end
+
+          statement << ')'
+          statement
+        end
+
+        # TODO: document
+        # @api private
+        def property_schema_statement(connection, schema)
+          statement = super
+
+          if supports_serial? && schema[:serial]
+            statement << ' PRIMARY KEY AUTOINCREMENT'
+          end
+
+          statement
+        end
+
+        # TODO: document
+        # @api private
+        def sqlite_version
+          @sqlite_version ||= query('SELECT sqlite_version(*)').first.freeze
+        end
+      end # module SQL
+
+      include SQL
+
+      module ClassMethods
+        # Types for SQLite 3 databases.
+        #
+        # @return [Hash] types for SQLite 3 databases.
+        #
+        # @api private
+        def type_map
+          @type_map ||= super.merge(Class => { :primitive => 'VARCHAR' }).freeze
+        end
+      end # module ClassMethods
+    end # module Sqlite3Adapter
+
+    module OracleAdapter
+      # TODO: document
+      # @api private
+      def self.included(base)
+        base.extend ClassMethods
+      end
+
+      # TODO: document
+      # @api semipublic
+      def storage_exists?(storage_name)
+        statement = <<-SQL.compress_lines
+          SELECT COUNT(*)
+          FROM all_tables
+          WHERE owner = ?
+          AND table_name = ?
+        SQL
+
+        query(statement, schema_name, oracle_upcase(storage_name)).first > 0
+      end
+
+      # TODO: document
+      # @api semipublic
+      def sequence_exists?(sequence_name)
+        return false unless sequence_name
+        statement = <<-SQL.compress_lines
+          SELECT COUNT(*)
+          FROM all_sequences
+          WHERE sequence_owner = ?
+          AND sequence_name = ?
+        SQL
+
+        query(statement, schema_name, oracle_upcase(sequence_name)).first > 0
+      end
+
+      # TODO: document
+      # @api semipublic
+      def field_exists?(storage_name, field_name)
+        statement = <<-SQL.compress_lines
+          SELECT COUNT(*)
+          FROM all_tab_columns
+          WHERE owner = ?
+          AND table_name = ?
+          AND column_name = ?
+        SQL
+
+        query(statement, schema_name, oracle_upcase(storage_name), oracle_upcase(field_name)).first > 0
+      end
+
+      # TODO: document
+      # @api semipublic
+      def storage_fields(storage_name)
+        statement = <<-SQL.compress_lines
+          SELECT column_name
+          FROM all_tab_columns
+          WHERE owner = ?
+          AND table_name = ?
+        SQL
+
+        query(statement, schema_name, oracle_upcase(storage_name))
+      end
+
+      # TODO: document
+      # @api semipublic
+      def create_model_storage(model)
+        properties = model.properties_with_subclasses(name)
+        table_name = model.storage_name(name)
+        truncate_or_delete = self.class.auto_migrate_with
+        table_is_truncated = truncate_or_delete && @truncated_tables && @truncated_tables[table_name]
+
+        return false if storage_exists?(table_name) && !table_is_truncated
+        return false if properties.empty?
+
+        with_connection do |connection|
+          # if table was truncated then check if all columns for properties are present
+          # TODO: check all other column definition options
+          if table_is_truncated && storage_has_all_fields?(table_name, properties)
+            @truncated_tables[table_name] = nil
+          else
+            # forced drop of table if properties are different
+            if truncate_or_delete
+              destroy_model_storage(model, true)
+            end
+
+            statement = create_table_statement(connection, model, properties)
+            command   = connection.create_command(statement)
+            command.execute_non_query
+
+            (create_index_statements(model) + create_unique_index_statements(model)).each do |statement|
+              command   = connection.create_command(statement)
+              command.execute_non_query
+            end
+
+            # added creation of sequence
+            create_sequence_statements(model).each do |statement|
+              command   = connection.create_command(statement)
+              command.execute_non_query
+            end
+          end
+
+        end
+
+        true
+      end
+
+      # TODO: document
+      # @api semipublic
+      def destroy_model_storage(model, forced = false)
+        table_name = model.storage_name(name)
+        truncate_or_delete = self.class.auto_migrate_with
+        if storage_exists?(table_name)
+          if truncate_or_delete && !forced
+            statement = case truncate_or_delete
+            when :truncate
+              truncate_table_statement(model)
+            when :delete
+              delete_table_statement(model)
+            else
+              raise ArgumentError, "Unsupported auto_migrate_with option"
+            end
+            execute(statement)
+            @truncated_tables ||= {}
+            @truncated_tables[table_name] = true
+          else
+            execute(drop_table_statement(model))
+            @truncated_tables[table_name] = nil if @truncated_tables
+          end
+        end
+        # added destroy of sequences
+        reset_sequences = self.class.auto_migrate_reset_sequences
+        table_is_truncated = @truncated_tables && @truncated_tables[table_name]
+        unless truncate_or_delete && !reset_sequences && !forced
+          if sequence_exists?(model_sequence_name(model))
+            if table_is_truncated && !forced
+              statement = reset_sequence_statement(model)
+            else
+              statement = drop_sequence_statement(model)
+            end
+            execute(statement) if statement
+          end
+        end
+        true
+      end
+
+      private
+
+      def storage_has_all_fields?(table_name, properties)
+        properties.map{|p| oracle_upcase(p.field)}.sort == storage_fields(table_name).sort
+      end
+
+      # If table or column name contains just lowercase characters then do uppercase
+      # as uppercase version will be used in Oracle data dictionary tables
+      def oracle_upcase(name)
+        name =~ /[A-Z]/ ? name : name.upcase
+      end
+
+      module SQL #:nodoc:
+#        private  ## This cannot be private for current migrations
+
+        # TODO: document
+        # @api private
+        def schema_name
+          @schema_name ||= query("SELECT SYS_CONTEXT('userenv','current_schema') FROM dual").first.freeze
+        end
+
+        # TODO: document
+        # @api private
+        def create_sequence_statements(model)
+          table_name = model.storage_name(name)
+          serial = model.serial(name)
+
+          statements = []
+          if sequence_name = model_sequence_name(model)
+            statements << <<-SQL.compress_lines
+              CREATE SEQUENCE #{quote_name(sequence_name)} NOCACHE
+            SQL
+
+            # create trigger only if custom sequence name was not specified
+            unless serial.options[:sequence]
+              statements << <<-SQL.compress_lines
+                CREATE OR REPLACE TRIGGER #{quote_name(default_trigger_name(table_name))}
+                BEFORE INSERT ON #{quote_name(table_name)} FOR EACH ROW
+                BEGIN
+                  IF inserting THEN
+                    IF :new.#{quote_name(serial.field)} IS NULL THEN
+                      SELECT #{quote_name(sequence_name)}.NEXTVAL INTO :new.#{quote_name(serial.field)} FROM dual;
+                    END IF;
+                  END IF;
+                END;
+              SQL
+            end
+          end
+
+          statements
+        end
+
+        # TODO: document
+        # @api private
+        def drop_sequence_statement(model)
+          if sequence_name = model_sequence_name(model)
+            "DROP SEQUENCE #{quote_name(sequence_name)}"
+          else
+            nil
+          end
+        end
+
+        # TODO: document
+        # @api private
+        def reset_sequence_statement(model)
+          if sequence_name = model_sequence_name(model)
+            <<-SQL.compress_lines
+            DECLARE
+              cval   INTEGER;
+            BEGIN
+              SELECT #{quote_name(sequence_name)}.NEXTVAL INTO cval FROM dual;
+              EXECUTE IMMEDIATE 'ALTER SEQUENCE #{quote_name(sequence_name)} INCREMENT BY -' || cval || ' MINVALUE 0';
+              SELECT #{quote_name(sequence_name)}.NEXTVAL INTO cval FROM dual;
+              EXECUTE IMMEDIATE 'ALTER SEQUENCE #{quote_name(sequence_name)} INCREMENT BY 1';
+            END;
+            SQL
+          else
+            nil
+          end
+        end
+
+        # TODO: document
+        # @api private
+        def truncate_table_statement(model)
+          "TRUNCATE TABLE #{quote_name(model.storage_name(name))}"
+        end
+
+        # TODO: document
+        # @api private
+        def delete_table_statement(model)
+          "DELETE FROM #{quote_name(model.storage_name(name))}"
+        end
+
+        private
+
+        def model_sequence_name(model)
+          table_name = model.storage_name(name)
+          serial = model.serial(name)
+
+          if serial
+            serial.options[:sequence] || default_sequence_name(table_name)
+          else
+            nil
+          end
+        end
+
+        def default_sequence_name(table_name)
+          # truncate table name if necessary to fit in max length of identifier
+          "#{table_name[0,self.class::IDENTIFIER_MAX_LENGTH-4]}_seq"
+        end
+
+        def default_trigger_name(table_name)
+          # truncate table name if necessary to fit in max length of identifier
+          "#{table_name[0,self.class::IDENTIFIER_MAX_LENGTH-4]}_pkt"
+        end
+
+      end # module SQL
+
+      include SQL
+
+      module ClassMethods
+        # Types for Oracle databases.
+        #
+        # @return [Hash] types for Oracle databases.
+        #
+        # @api private
+        def type_map
+          length    = Property::DEFAULT_LENGTH
+          precision = Property::DEFAULT_PRECISION
+          scale     = Property::DEFAULT_SCALE_BIGDECIMAL
+
+          @type_map ||= {
+            Integer       => { :primitive => 'NUMBER',   :precision => precision, :scale => 0   },
+            String        => { :primitive => 'VARCHAR2', :length => length                      },
+            Class         => { :primitive => 'VARCHAR2', :length => length                      },
+            BigDecimal    => { :primitive => 'NUMBER',   :precision => precision, :scale => nil },
+            Float         => { :primitive => 'BINARY_FLOAT',                                    },
+            DateTime      => { :primitive => 'DATE'                                             },
+            Date          => { :primitive => 'DATE'                                             },
+            Time          => { :primitive => 'DATE'                                             },
+            TrueClass     => { :primitive => 'NUMBER',  :precision => 1, :scale => 0            },
+            Types::Object => { :primitive => 'CLOB'                                             },
+            Types::Text   => { :primitive => 'CLOB'                                             },
+          }.freeze
+        end
+
+        # Use table truncate or delete for auto_migrate! to speed up test execution
+        #
+        # @param [Symbol] :truncate, :delete or :drop_and_create (or nil)
+        #   do not specify parameter to return current value
+        #
+        # @return [Symbol] current value of auto_migrate_with option (nil returned for :drop_and_create)
+        #
+        # @api semipublic
+        def auto_migrate_with(value = :not_specified)
+          return @auto_migrate_with if value == :not_specified
+          value = nil if value == :drop_and_create
+          raise ArgumentError unless [nil, :truncate, :delete].include?(value)
+          @auto_migrate_with = value
+        end
+
+        # Set if sequences will or will not be reset during auto_migrate!
+        #
+        # @param [TrueClass, FalseClass] reset sequences?
+        #   do not specify parameter to return current value
+        #
+        # @return [Symbol] current value of auto_migrate_reset_sequences option (default value is true)
+        #
+        # @api semipublic
+        def auto_migrate_reset_sequences(value = :not_specified)
+          return @auto_migrate_reset_sequences.nil? ? true : @auto_migrate_reset_sequences if value == :not_specified
+          raise ArgumentError unless [true, false].include?(value)
+          @auto_migrate_reset_sequences = value
+        end
+
+      end # module ClassMethods
+    end # module PostgresAdapter
+
+    module Repository
+      # Determine whether a particular named storage exists in this repository
+      #
+      # @param [String]
+      #   storage_name name of the storage to test for
+      #
+      # @return [Boolean]
+      #   true if the data-store +storage_name+ exists
+      #
+      # @api semipublic
+      def storage_exists?(storage_name)
+        if adapter.respond_to?(:storage_exists?)
+          adapter.storage_exists?(storage_name)
+        end
+      end
+
+      # TODO: document
+      # @api semipublic
+      def upgrade_model_storage(model)
+        if adapter.respond_to?(:upgrade_model_storage)
+          adapter.upgrade_model_storage(model)
+        end
+      end
+
+      # TODO: document
+      # @api semipublic
+      def create_model_storage(model)
+        if adapter.respond_to?(:create_model_storage)
+          adapter.create_model_storage(model)
+        end
+      end
+
+      # TODO: document
+      # @api semipublic
+      def destroy_model_storage(model)
+        if adapter.respond_to?(:destroy_model_storage)
+          adapter.destroy_model_storage(model)
+        end
+      end
+
+      # Destructively automigrates the data-store to match the model.
+      # First migrates all models down and then up.
+      # REPEAT: THIS IS DESTRUCTIVE
+      #
+      # @api public
+      def auto_migrate!
+        DataMapper.auto_migrate!(name)
+      end
+
+      # Safely migrates the data-store to match the model
+      # preserving data already in the data-store
+      #
+      # @api public
+      def auto_upgrade!
+        DataMapper.auto_upgrade!(name)
+      end
+    end # module Repository
+
+    module Model
+      # TODO: document
+      # @api private
+      def self.included(mod)
+        mod.descendants.each { |model| model.extend self }
+      end
+
+      # TODO: document
+      # @api semipublic
+      def storage_exists?(repository_name = default_repository_name)
+        repository(repository_name).storage_exists?(storage_name(repository_name))
+      end
+
+      # Destructively automigrates the data-store to match the model
+      # REPEAT: THIS IS DESTRUCTIVE
+      #
+      # @param Symbol repository_name the repository to be migrated
+      #
+      # @api public
+      def auto_migrate!(repository_name = self.repository_name)
+        assert_valid
+        auto_migrate_down!(repository_name)
+        auto_migrate_up!(repository_name)
+      end
+
+      # Safely migrates the data-store to match the model
+      # preserving data already in the data-store
+      #
+      # @param Symbol repository_name the repository to be migrated
+      #
+      # @api public
+      def auto_upgrade!(repository_name = self.repository_name)
+        assert_valid
+        if base_model == self
+          repository(repository_name).upgrade_model_storage(self)
+        else
+          base_model.auto_upgrade!(repository_name)
+        end
+      end
+
+      # Destructively migrates the data-store down, which basically
+      # deletes all the models.
+      # REPEAT: THIS IS DESTRUCTIVE
+      #
+      # @param Symbol repository_name the repository to be migrated
+      #
+      # @api private
+      def auto_migrate_down!(repository_name = self.repository_name)
+        assert_valid
+        if base_model == self
+          repository(repository_name).destroy_model_storage(self)
+        else
+          base_model.auto_migrate_down!(repository_name)
+        end
+      end
+
+      # Auto migrates the data-store to match the model
+      #
+      # @param Symbol repository_name the repository to be migrated
+      #
+      # @api private
+      def auto_migrate_up!(repository_name = self.repository_name)
+        assert_valid
+        if base_model == self
+          repository(repository_name).create_model_storage(self)
+        else
+          base_model.auto_migrate_up!(repository_name)
+        end
+      end
+    end # module Model
+  end
+
+  module Adapters
+    extendable do
+
+      # TODO: document
+      # @api private
+      def const_added(const_name)
+        if DataMapper::Migrations.const_defined?(const_name)
+          adapter = const_get(const_name)
+          adapter.send(:include, DataMapper::Migrations.const_get(const_name))
+        end
+
+        super
+      end
+    end
+  end # module Adapters
+end # module DataMapper