imparcial 0.0.1 → 0.0.2

data/lib/imparcial/driver/base/expression/table_operation.rb

@@ -1,137 +0,0 @@
-module Imparcial
-  module Driver
-    module ExpressionBase
-      module TableOperation
-        
-        private
-        
-        def expected_options_for_creating_table
-                    
-          {:table_name => :required, :fields => :required}
-          
-        end
-        
-        def expected_options_for_dropping_table
-          
-          {:table_name => :required}
-          
-        end
-        
-        ###########################################
-        #                                         #
-        #            Dropping Table               #
-        #                                         #
-        ###########################################
-            
-        public
-        
-        # Drop a table by table_name.
-        # An exception will be raised if nothing is found.
-        # Usage:
-        # drop_table :table_name => 'something'
-      
-        def drop_table ( options = {} )                     
- 
-          check_options expected_options_for_dropping_table, options
-            
-          query sql_for_dropping_table( options )
-            
-        rescue adapter_specific_exception => ex
-          
-          raise TableDropError.new(ex.message)
-
-        end
-      
-        # Drop a table by name.
-        # An exception shall not be raised independently of what happens.
-      
-        def drop_table_if_necessary ( options = {} )                       
-
-          drop_table options
-         
-        rescue TableDropError; end
-        
-        # Drop all tables.
-        
-        def drop_all_tables
-        
-          for table_name in retrieve_tables
-          
-            query sql_for_dropping_table( {:table_name => table_name} )
-          
-          end
-            
-        rescue adapter_specific_exception => ex
-          
-          raise TableDropError.new(ex.message)
-            
-        end
-        
-        ###########################################
-        #                                         #
-        #             Creating Table              #
-        #                                         #
-        ###########################################        
-
-        private
-
-        def column_format
-          
-          [:name, :type, :size, :allow_null, :auto_increment, :default_value]
-          
-        end
-
-        def build_column ( field )
-      
-          raise OptionError unless field
-        
-          # Fill it up with default values if needed.
-          
-          parse_field field
-          sql_column = field_to_column field
-  
-          syntax = ''
-          
-          for attr in column_format
-          
-            syntax += sql_column[attr] + ' ' if sql_column[attr]
-          
-          end
-
-          syntax
-      
-        end
-        
-        def field_to_column ( field )
-          
-          column = {}
-          column[:name] = quote(field[:name])
-          column[:type] = regular_types[field[:type]]
-          column[:size] = '(' + quote_value(field[:size]) + ')' if field[:size]
-          column[:allow_null] = field[:allow_null] == true ? 'NULL' : 'NOT NULL'
-          column[:default_value] = field[:default_value] != nil ? ' DEFAULT ' + quote_value(field[:default_value]) : ''          
-          
-          column
-          
-        end
-                                    
-        public
-
-        # Create a table.
-  
-        def create_table ( options = {} )                 
-
-          check_options expected_options_for_creating_table, options                          
-                              
-          query sql_for_creating_table( options )
-            
-        rescue adapter_specific_exception => ex
-          
-          raise TableCreateError.new(ex.message)               
-      
-        end                         
-        
-      end
-    end
-  end
-end

data/lib/imparcial/driver/base/expression/transaction.rb

@@ -1,59 +0,0 @@
-module Imparcial
-  module Driver
-    module ExpressionBase
-      module Transaction
-                
-        public
-        
-        # Create a savepoint for a transaction.
-        
-        def create_savepoint ( name )
-                    
-          query sql_for_saving_point( name )
-          
-        rescue adapter_specific_exception => ex
-        
-          raise TransactionError.new(ex.message)
-          
-        end
-        
-        # Rollback a transaction to the specified savepoint.
-        
-        def restore_savepoint ( name )
-                    
-          query sql_for_rolling_back( name )
-          
-        rescue adapter_specific_exception => ex
-        
-          raise TransactionError.new(ex.message)
-          
-        end
-        
-        # Initialize a transaction.
-        
-        def initialize_transaction
-          
-          query sql_for_initializing_a_transaction
-          
-        rescue adapter_specific_exception => ex
-        
-          raise TransactionError.new(ex.message)
-          
-        end
-        
-        # Finalize a transaction.
-        
-        def terminate_transaction
-          
-          query sql_for_terminating_a_transaction
-          
-        rescue adapter_specific_exception => ex
-        
-          raise TransactionError.new(ex.message)
-          
-        end
-        
-      end
-    end
-  end
-end

data/lib/imparcial/driver/base/expression.rb

@@ -1,37 +0,0 @@
-require 'imparcial/driver/base/expression/base'
-require 'imparcial/driver/base/expression/statement'
-require 'imparcial/driver/base/expression/sequence'
-require 'imparcial/driver/base/expression/table_diff'
-require 'imparcial/driver/base/expression/table_operation'
-require 'imparcial/driver/base/expression/table_metadata'
-require 'imparcial/driver/base/expression/table_evolution'
-require 'imparcial/driver/base/expression/insert'
-require 'imparcial/driver/base/expression/select'
-require 'imparcial/driver/base/expression/delete'
-require 'imparcial/driver/base/expression/update'
-require 'imparcial/driver/base/expression/util'
-require 'imparcial/driver/base/expression/lock'
-require 'imparcial/driver/base/expression/transaction'
-require 'imparcial/driver/base/expression/index'
-
-module Imparcial
-  module Driver
-    module ExpressionBase
-      include Base
-      include Statement
-      include Sequence
-      include TableDiff
-      include TableOperation
-      include TableMetadata
-      include TableEvolution                     
-      include Insert
-      include Select
-      include Delete
-      include Update
-      include Util
-      include Lock
-      include Transaction
-      include Index
-    end
-  end
-end

data/lib/imparcial/driver/base/sql/table_metadata.rb

@@ -1,29 +0,0 @@
-module Imparcial
-  module Driver
-    module SQLBase
-      module TableMetadata
-        
-        private
-        
-        # There's no standard way to retrieve tables.
-        # Subclasses need to override this method.
-        
-        def sql_for_retrieving_tables
-      
-          raise FeatureNotFound
-      
-        end        
-        
-        # There's no standard way to retrieve columns.
-        # Subclasses need to override this method.        
-        
-        def sql_for_retrieving_columns ( options = {} )
-          
-          raise FeatureNotFound
-          
-        end
-        
-      end
-    end
-  end
-end

data/lib/imparcial/driver/base/sql.rb

@@ -1,25 +0,0 @@
-require 'imparcial/driver/base/sql/table_operation'
-require 'imparcial/driver/base/sql/table_metadata'
-require 'imparcial/driver/base/sql/sequence'
-require 'imparcial/driver/base/sql/transaction'
-require 'imparcial/driver/base/sql/index'
-require 'imparcial/driver/base/sql/insert'
-require 'imparcial/driver/base/sql/delete'
-require 'imparcial/driver/base/sql/select'
-require 'imparcial/driver/base/sql/update'
-
-module Imparcial
-  module Driver
-    module SQLBase
-      include TableOperation
-      include TableMetadata
-      include Sequence
-      include Transaction
-      include Index
-      include Insert
-      include Delete
-      include Select
-      include Update
-    end
-  end
-end

data/lib/imparcial/driver/base.rb

@@ -1,156 +0,0 @@
-require 'imparcial/driver/base/util'
-require 'imparcial/driver/base/typemap'
-require 'imparcial/driver/base/result'
-require 'imparcial/driver/base/sql'
-require 'imparcial/driver/base/expression'
-
-module Imparcial
-  module Driver
-  
-    # You have seriously to pay attention on this class.
-    # Basically speaking, it servers as base for all new drivers.
-    # The idea behind Imparcial is to keep an abstract interface without
-    # exposing any database-specific-features.
-    # Of course, it's an impossible mission anyhow. There are so many 
-    # databases out there and there are so many cool features that
-    # make impossible not to expose them.
-    # We recommend you to obey the interface as much as possible.
-    # However you may develop some specific features.
-  
-    class AdapterBase
-    
-      # Include SQL syntax generation.
-      # Here where all SQL syntax lies on.
-      
-      include SQLBase
-    
-      # Include the expression mechanism.
-      # Things like create table, drop table, select and so forth.
-      # They all come from this module.
-    
-      include ExpressionBase
-      
-      # Include some util methods.
-      # Things like quoting columns, tables and values.
-      
-      include UtilBase
-      
-      # Include Typemap mechanism.
-      
-      include TypemapBase
-    
-      # Let's keep a track of the initializer. We'll need some info eventually.
-    
-      attr_reader :initializer
-      
-      # Let's also keep a track of the connection.
-      
-      attr_accessor :conn
-      alias_method  :connection, :conn
-      
-      attr_reader   :host, :user, :pass, :database, :socket, :port
-    
-      def initialize ( initializer )
-      
-        # Cannot accept classes different from Initializer.
-      
-        if initializer.class != Imparcial::Initializer
-
-          msg = 'An initializer is needed in order to start a driver'
-          raise AdapterConfigError.new(msg)
-          
-        end
-      
-        @initializer = initializer
-      
-        @host     = initializer.host
-        
-        if not initializer.user
-          
-          raise AdapterConfigError.new('Adapter requires an username')
-          
-        end
-        
-        @user     = initializer.user
-        
-        if not initializer.pass
-          
-          raise AdapterConfigError.new('Adapter requires a password')
-          
-        end
-        
-        @pass     = initializer.pass
-        
-        if not initializer.database
-          
-          raise AdapterConfigErrornew('Adapter requires a database')
-          
-        end        
-        
-        @database = initializer.database
-        @socket   = initializer.socket
-        @port     = initializer.port 
-      
-      end
-
-      #####################################################
-      #                                                   #
-      # Those are methods shared among all databases.     #
-      # Hardly, one will need to override them.           #
-      #                                                   #
-      #####################################################
-
-      def conn
-      
-        raise AdapterConnectionError.new('Have you connected?') unless @conn
-        @conn
-      
-      end
-
-      def close
-      
-        conn.close
-      
-      end
-                        
-      def result
-      
-        raise ResultError.new('Have you made a query?') unless @result
-        @result
-      
-      end
-
-      #####################################################
-      #                                                   #
-      # Subclasses must override those following methods. #
-      # They are driver-specific.                         #
-      #                                                   #
-      #####################################################
-      
-      def connect
-      
-        raise FeatureNotFound
-      
-      end
-            
-      def version
-      
-        raise FeatureNotFound
-      
-      end
-      
-      def query ( sql )
-            
-        raise FeatureNotFound
-      
-      end      
-      
-      def adapter_specific_exception
-        
-        raise FeatureNotFound
-        
-      end
-      
-    end
-  end
-end

data/lib/imparcial/driver/mysql/expression/index.rb

@@ -1,44 +0,0 @@
-module Imparcial
-  module Driver
-    module ExpressionMysql
-      module Index
-                
-        public
-
-        def drop_all_indexes          
-          
-          for index in retrieve_indexes
-
-            meta = {:index_name => index[:name], :table_name => index[:table]}
-            query sql_for_dropping_index(meta)
-          
-          end
-
-        rescue adapter_specific_exception => ex
-        
-          raise IndexDropError.new(ex.message)                       
-          
-        end       
-        
-        def drop_all_indexes_for_table ( options = {} )
-          
-          check_options expected_options_for_index_table, options      
-          
-          for index in retrieve_indexes_for_table options
-            
-            meta = {:index_name => index[:name], :table_name => options[:table_name]}
-            query sql_for_dropping_index(meta)
-          
-          end
-          
-        rescue adapter_specific_exception => ex
-        
-          raise IndexDropError.new(ex.message)                       
-          
-        end        
-                
-        
-      end
-    end
-  end
-end

data/lib/imparcial/driver/mysql/sql/table_operation.rb

@@ -1,20 +0,0 @@
-module Imparcial
-  module Driver
-    module SQLMysql
-      module TableOperation
-        
-        private
-        
-        def sql_for_creating_table ( options = {} )
-          
-          syntax  = super
-          syntax += 'ENGINE = ' + options[:engine].to_s if options[:engine]
-          
-          syntax
-          
-        end   
-        
-      end      
-    end
-  end
-end

data/lib/imparcial/driver/postgre/expression/index.rb

@@ -1,10 +0,0 @@
-module Imparcial
-  module Driver
-    module ExpressionPostgre
-      module Index
-        
-         
-      end
-    end
-  end
-end

data/lib/imparcial/driver/postgre/expression/sequence.rb

@@ -1,9 +0,0 @@
-module Imparcial
-  module Driver
-    module ExpressionPostgre
-      module Sequence
-                
-      end
-    end
-  end
-end

data/lib/imparcial/driver/postgre/expression/table.rb

@@ -1,20 +0,0 @@
-module Imparcial
-  module Driver
-    module ExpressionPostgre
-      module Table
-
-        private
-
-        def field_to_column ( field )
-      
-          column = super
-          column[:type] = 'SERIAL' if field[:auto_increment]
-          
-          column
-  
-        end
-        
-      end  
-    end
-  end
-end

data/lib/imparcial/driver/postgre/sql/table_operation.rb

@@ -1,9 +0,0 @@
-module Imparcial
-  module Driver
-    module SQLPostgre
-      module TableOperation
-                
-      end      
-    end
-  end
-end