datamapper 0.1.1 → 0.2.0

data/lib/data_mapper/adapters/sql/commands/advanced_load_command.rb

@@ -1,140 +0,0 @@
-module DataMapper
-  module Adapters
-    module Sql
-      module Commands
-    
-        class AdvancedLoadCommand
-      
-          attr_reader :conditions, :options
-          
-          def initialize(adapter, session, primary_class, options = {})
-            @adapter, @session, @primary_class, @options = adapter, session, primary_class, options
-            
-            @order = @options[:order]
-            @limit = @options[:limit]
-            @offset = @options[:offset]
-            @reload = @options[:reload]
-            @include = @options[:include]
-            @instance_id = @options[:id]
-            @conditions = @options[:conditions]
-            @join_fetch = false
-            @joins = []
-          end
-          
-          # If +true+ then force the command to reload any objects
-          # already existing in the IdentityMap when executing.
-          def reload?
-            @reload
-          end
-          
-          # Determine if there is a limitation on the number of
-          # instances returned in the results. If +nil+, no limit
-          # is set. Can be used in conjunction with #offset for
-          # paging through a set of results.
-          def limit
-            @limit
-          end
-          
-          # Used in conjunction with #limit to page through a set
-          # of results.
-          def offset
-            @offset
-          end
-          
-          # Generate a select statement based on the initialization
-          # arguments.
-          def to_sql            
-            sql = 'SELECT ' << columns_for_select.join(', ')
-            sql << ' FROM ' << from_table_name            
-            
-            if @join_fetch
-              @joins.each do |entry|
-                primary_table, association_table, association = entry
-                sql << ' JOIN ' << association_table.to_sql << ' ON '
-                sql << association_table.to_sql << '.'
-                sql << @adapter.quote_column_name(association.foreign_key)
-                sql << ' = ' << primary_table.key.to_sql(true)
-              end
-            end
-            
-            return sql
-          end
-          
-          private
-          
-            # Return the Sql-escaped columns names to be selected in the results.
-            def columns_for_select
-              @columns_for_select || @columns_for_select = begin
-                columns.map { |column| column.to_sql(@join_fetch) }
-              end
-            end
-            
-            # Returns the DataMapper::Adapters::Sql::Mappings::Column instances to
-            # be selected in the results.
-            def columns
-              @columns || begin
-                @columns = if @options.has_key?(:select)
-                  primary_class_table.columns.select do |column|
-                    @options[:select].include?(column.name)
-                  end
-                else
-                  primary_class_table.columns.select do |column|
-                    include_column?(column.name) || !column.lazy?
-                  end
-                end
-                
-                # Return if there is no +:include+ option to evaluate.
-                return @columns if @include.nil?
-                
-                if @include.kind_of?(Array)
-                  # Return if all +:include+ parameters are columns in
-                  # the primary_class_table.
-                  return @columns if @include.all? do |name|
-                    !primary_class_table[name].nil?
-                  end
-                elsif @include.kind_of?(Symbol)
-                  # Return if the include is a column in the primary_class_table.
-                  return @columns if primary_class_table[@include]
-                  
-                  primary_class_table.associations.each do |association|
-                    next unless association.name == @include
-                    association_table = @adapter[association.constant]
-                    @columns += association_table.columns
-                    @joins << [ primary_class_table, association_table, association ]
-                  end
-                  
-                  @join_fetch = true
-                else
-                  raise ':include option must be a Symbol or Array of Symbols'
-                end
-                
-                @columns
-              end
-            end
-            
-            # Determine if a Column should be included based on the
-            # value of the +:include+ option.
-            def include_column?(name)
-              case @include
-                when nil then false
-                when Symbol then @include == name
-                when Array then @include.includes?(name)
-                else raise ':include option must be a Symbol or Array of Symbols'
-              end
-            end
-
-            # Return the Sql-escaped table name of the +primary_class+.
-            def from_table_name
-              @from_table_name || (@from_table_name = @adapter[@primary_class].to_sql)
-            end
-            
-            # Returns the DataMapper::Adapters::Sql::Mappings::Table for the +primary_class+.
-            def primary_class_table
-              @primary_class_table || (@primary_class_table = @adapter[@primary_class])
-            end
-          
-        end # class LoadCommand
-      end # module Commands
-    end # module Sql
-  end # module Adapters
-end # module DataMapper

data/lib/data_mapper/adapters/sql/commands/delete_command.rb

@@ -1,113 +0,0 @@
-module DataMapper
-  module Adapters
-    module Sql
-      module Commands
-    
-        class DeleteCommand
-      
-          def initialize(adapter, klass_or_instance, options = nil)
-            @adapter, @klass_or_instance, @options = adapter, klass_or_instance, options
-          end
-      
-          def truncate?
-            return false if @options.nil?
-            @options[:truncate]
-          end
-          
-          def drop?
-            return false if @options.nil?
-            @options[:drop]
-          end
-          
-          def delete_all?
-            return !truncate? && !drop? && @klass_or_instance.kind_of?(Class)
-          end
-          
-          def klass
-            @klass_or_instance.kind_of?(Class) ? @klass_or_instance : @klass_or_instance.class
-          end
-          
-          def to_truncate_sql
-            "TRUNCATE TABLE " << @adapter[@klass_or_instance].to_sql
-          end
-          
-          def to_drop_sql
-            "DROP TABLE #{@adapter[@klass_or_instance].to_sql}"
-          end
-          
-          def to_delete_sql
-            sql = "DELETE FROM " << @adapter[klass].to_sql
-            sql << " WHERE id = " << @adapter.quote_value(@klass_or_instance.key) unless delete_all?
-            return sql
-          end
-          
-          def to_sql
-            if truncate?
-              to_truncate_sql
-            elsif drop?
-              to_drop_sql
-            else
-              to_delete_sql
-            end
-          end
-          
-          def session
-            return nil if @options.nil?
-            @options[:session]
-          end
-          
-          def call
-            result = nil
-            
-            if truncate?
-              result = execute_truncate(to_sql)
-              session.identity_map.clear!(klass) unless session.nil?
-            elsif drop?
-              result = execute_drop(to_sql)
-              session.identity_map.clear!(klass) unless session.nil?
-            elsif delete_all?
-              result = execute_delete_all(to_sql)
-              session.identity_map.clear!(klass) unless session.nil?
-            else
-              @klass_or_instance.class.callbacks.execute(:before_destroy, @klass_or_instance)
-              
-              result = execute(to_sql)
-              
-              if result
-                @klass_or_instance.instance_variable_set(:@new_record, true)
-                @klass_or_instance.session = session
-                @klass_or_instance.original_hashes.clear
-                session.identity_map.delete(@klass_or_instance) unless session.nil?
-                @klass_or_instance.class.callbacks.execute(:after_destroy, @klass_or_instance)
-              end
-            end
-            
-            return result
-          rescue => error
-            @adapter.log.error(error)
-            raise error
-          end
-          
-          protected
-          def execute_truncate(sql)
-            execute(sql)
-          end
-          
-          def execute_drop(sql)
-            execute(sql)
-          end
-          
-          def execute_delete_all(sql)
-            execute(sql)
-          end
-          
-          def execute(sql)
-            raise NotImplementedError.new
-          end
-          
-        end
-    
-      end
-    end
-  end
-end

data/lib/data_mapper/adapters/sql/commands/save_command.rb

@@ -1,141 +0,0 @@
-module DataMapper
-  module Adapters
-    module Sql
-      module Commands
-    
-        class SaveCommand
-      
-          def initialize(adapter, session, instance)
-            @adapter, @session, @instance = adapter, session, instance
-          end
-      
-          def to_update_sql
-            table = @adapter[@instance.class]
-        
-            sql = "UPDATE " << table.to_sql << " SET "
-        
-            @instance.dirty_attributes.map do |k, v|
-              sql << table[k].to_sql << " = " << @adapter.quote_value(v) << ", "
-            end
-        
-            sql[0, sql.size - 2] << " WHERE #{table.key.to_sql} = " << @adapter.quote_value(@instance.key)
-          end
-          
-          def to_insert_sql
-        
-            table = @adapter[@instance.class]
-        
-            keys = []
-            values = []
-        
-            @instance.dirty_attributes.each_pair { |k,v| keys << table[k].to_sql; values << v }
-        
-            # Formatting is a bit off here, but it looks nicer in the log this way.
-            sql = "INSERT INTO #{table.to_sql} (#{keys.join(', ')}) \
-    VALUES (#{values.map { |v| @adapter.quote_value(v) }.join(', ')})"
-          end
-          
-          def to_create_table_sql
-            table = @adapter[@instance]
-        
-            sql = "CREATE TABLE " << table.to_sql << " ("
-        
-            sql << table.columns.map do |column|
-              column_long_form(column)
-            end.join(', ')
-        
-            sql << ", PRIMARY KEY (#{table.key.to_sql}))"
-        
-            return sql
-          end
-      
-          def column_long_form(column)
-            long_form = "#{column.to_sql} #{@adapter.class::TYPES[column.type] || column.type}"
-        
-            long_form << "(#{column.size})" unless column.size.nil?
-            long_form << " NOT NULL" unless column.nullable?
-            long_form << " auto_increment" if column.key?
-            long_form << " default #{column.options[:default]}" if column.options.has_key?(:default)
-        
-            return long_form
-          end
-          
-          def callback(name)
-            @instance.class.callbacks.execute(name, @instance)
-          end
-          
-          def insert!
-            callback(:before_create)
-            
-            result = execute_insert(to_insert_sql)
-            
-            if result
-              @instance.instance_variable_set(:@new_record, false)
-              @instance.instance_variable_set(:@id, result)
-              calculate_original_hashes(@instance)
-              @session.identity_map.set(@instance)
-              callback(:after_create)
-            end
-
-            return result
-          rescue => error
-            @adapter.log.error(error)
-            raise error
-          end
-
-          def update!
-            callback(:before_update)
-            
-            result = execute_update(to_update_sql)
-            
-            calculate_original_hashes(@instance)
-            callback(:after_update)
-            return result
-          rescue => error
-            @adapter.log.error(error)
-            raise error
-          end
-          
-          def call
-            if @instance.kind_of?(Class)
-              return false if @adapter.table_exists?(@instance)
-              execute_create_table(to_create_table_sql)
-            else
-              return false unless @instance.dirty?
-              callback(:before_save)
-              result = @instance.new_record? ? insert! : update!
-              @instance.session = @session
-              callback(:after_save)
-              result
-            end
-          end
-          
-          protected
-          def execute_insert(sql)
-            raise NotImplementedError.new
-          end
-          
-          def execute_update(sql)
-            raise NotImplementedError.new
-          end
-          
-          def execute_create_table(sql)
-            raise NotImplementedError.new
-          end
-          
-          private
-          # Calculates the original hashes for each value
-          # in an instance's set of attributes, and adds
-          # them to the original_hashes hash.
-          def calculate_original_hashes(instance)
-            instance.attributes.each_pair do |name, value|
-              instance.original_hashes[name] = value.hash
-            end
-          end
-      
-        end
-    
-      end
-    end
-  end
-end

data/lib/data_mapper/adapters/sql/commands/table_exists_command.rb

@@ -1,33 +0,0 @@
-module DataMapper
-  module Adapters
-    module Sql
-      module Commands
-    
-        class TableExistsCommand
-      
-          def initialize(adapter, klass_or_name)
-            @adapter, @klass_or_name = adapter, klass_or_name
-          end
-      
-          def table_name
-            @table_name || @table_name = case @klass_or_name
-            when String then @adapter.quote_value(@klass_or_name)
-            when Class then @adapter.quote_value(@adapter[@klass_or_name].name)
-            else raise ArgumentError.new('klass_or_name must be a mapped-class or a table name')
-            end
-          end
-          
-          def to_sql
-            "SHOW TABLES LIKE #{table_name}"
-          end
-          
-          def call
-            raise NotImplementedError.new
-          end
-      
-        end
-    
-      end
-    end
-  end
-end

data/lib/data_mapper/adapters/sql_adapter.rb

@@ -1,163 +0,0 @@
-require 'data_mapper/adapters/abstract_adapter'
-require 'data_mapper/adapters/sql/commands/load_command'
-require 'data_mapper/adapters/sql/commands/advanced_load_command'
-require 'data_mapper/adapters/sql/commands/save_command'
-require 'data_mapper/adapters/sql/commands/delete_command'
-require 'data_mapper/adapters/sql/commands/table_exists_command'
-require 'data_mapper/adapters/sql/coersion'
-require 'data_mapper/adapters/sql/quoting'
-require 'data_mapper/adapters/sql/mappings/schema'
-
-module DataMapper
-  
-  # An Adapter is really a Factory for three types of object,
-  # so they can be selectively sub-classed where needed.
-  # 
-  # The first type is a Query. The Query is an object describing
-  # the database-specific operations we wish to perform, in an
-  # abstract manner. For example: While most if not all databases
-  # support a mechanism for limiting the size of results returned,
-  # some use a "LIMIT" keyword, while others use a "TOP" keyword.
-  # We can set a SelectStatement#limit field then, and allow
-  # the adapter to override the underlying SQL generated.
-  # Refer to DataMapper::Queries.
-  # 
-  # The second type provided by the Adapter is a DataMapper::Connection.
-  # This allows us to execute queries and return results in a clear and
-  # uniform manner we can use throughout the DataMapper.
-  #
-  # The final type provided is a DataMapper::Transaction.
-  # Transactions are duck-typed Connections that span multiple queries.
-  #
-  # Note: It is assumed that the Adapter implements it's own
-  # ConnectionPool if any since some libraries implement their own at
-  # a low-level, and it wouldn't make sense to pay a performance
-  # cost twice by implementing a secondary pool in the DataMapper itself.
-  # If the library being adapted does not provide such functionality,
-  # DataMapper::Support::ConnectionPool can be used.
-  module Adapters
-      
-    # You must inherit from the SqlAdapter, and implement the
-    # required methods to adapt a database library for use with the DataMapper.
-    #
-    # NOTE: By inheriting from SqlAdapter, you get a copy of all the
-    # standard sub-modules (Quoting, Coersion and Queries) in your own Adapter.
-    # You can extend and overwrite these copies without affecting the originals.
-    class SqlAdapter < AbstractAdapter
-      
-      FIND_OPTIONS = [
-        :select, :limit, :class, :include, :reload, :conditions, :order
-      ]
-      
-      def initialize(configuration)
-        super
-        @single_threaded = configuration.single_threaded
-      end
-      
-      def single_threaded?
-        @single_threaded
-      end
-           
-      def connection(&block)
-        raise NotImplementedError.new
-      end
-  
-      def transaction(&block)
-        raise NotImplementedError.new
-      end
-      
-      def query(sql)
-        raise NotImplementedError.new
-      end
-      
-      def schema
-        @schema || ( @schema = Mappings::Schema.new(self) )
-      end
-      
-      def table_exists?(name)
-        self.class::Commands::TableExistsCommand.new(self, name).call
-      end
-      
-      def delete(klass_or_instance, options = nil)
-        self.class::Commands::DeleteCommand.new(self, klass_or_instance, options).call
-      end
-      
-      def save(session, instance)
-        self.class::Commands::SaveCommand.new(self, session, instance).call
-      end
-      
-      def load(session, klass, options)
-        self.class::Commands::LoadCommand.new(self, session, klass, options).call
-      end
-      
-      def [](klass_or_table_name)
-        schema[klass_or_table_name]
-      end
-      
-      # Escape a string of SQL with a set of arguments.
-      # The first argument is assumed to be the SQL to escape,
-      # the remaining arguments (if any) are assumed to be
-      # values to escape and interpolate.
-      #
-      # ==== Examples
-      #   escape_sql("SELECT * FROM zoos")
-      #   # => "SELECT * FROM zoos"
-      # 
-      #   escape_sql("SELECT * FROM zoos WHERE name = ?", "Dallas")
-      #   # => "SELECT * FROM zoos WHERE name = `Dallas`"
-      #
-      #   escape_sql("SELECT * FROM zoos WHERE name = ? AND acreage > ?", "Dallas", 40)
-      #   # => "SELECT * FROM zoos WHERE name = `Dallas` AND acreage > 40"
-      # 
-      # ==== Warning
-      # This method is meant mostly for adapters that don't support
-      # bind-parameters.
-      def escape_sql(*args)
-        sql = args.shift
-      
-        unless args.empty?
-          sql.gsub!(/\?/) do |x|
-            quote_value(args.shift)
-          end
-        end
-        
-        sql
-      end
-      
-      # This callback copies and sub-classes modules and classes
-      # in the AbstractAdapter to the inherited class so you don't
-      # have to copy and paste large blocks of code from the
-      # SqlAdapter.
-      # 
-      # Basically, when inheriting from the AbstractAdapter, you
-      # aren't just inheriting a single class, you're inheriting
-      # a whole graph of Types. For convenience.
-      def self.inherited(base)
-        
-        queries = base.const_set('Commands', Module.new)
-
-        Sql::Commands.constants.each do |name|
-          queries.const_set(name, Class.new(Sql::Commands.const_get(name)))
-        end  
-        
-        base.const_set('TYPES', TYPES.dup)
-        base.const_set('FIND_OPTIONS', FIND_OPTIONS.dup)
-        
-        super
-      end
-      
-      TYPES = {
-        :integer => 'int'.freeze,
-        :string => 'varchar'.freeze,
-        :text => 'text'.freeze,
-        :class => 'varchar'.freeze
-      }
-
-      include Sql
-      include Quoting
-      include Coersion
-      
-    end # class SqlAdapter
-    
-  end # module Adapters
-end # module DataMapper