viking-sequel 3.10.0

data/lib/sequel/adapters/shared/progress.rb

@@ -0,0 +1,44 @@
+module Sequel
+  module Progress
+    module DatabaseMethods
+
+      # Progress uses the :progress database type.
+      def database_type
+        :progress
+      end
+
+      def dataset(opts = nil)
+        ds = super
+        ds.extend(DatasetMethods)
+        ds
+      end
+    end
+  
+    module DatasetMethods
+      SELECT_CLAUSE_METHODS = Dataset.clause_methods(:select, %w'limit distinct columns from join where group order having compounds')
+
+      # Progress requires SQL standard datetimes
+      def requires_sql_standard_datetimes?
+        true
+      end
+
+      # Progress does not support INTERSECT or EXCEPT
+      def supports_intersect_except?
+        false
+      end
+
+      private
+
+      def select_clause_methods
+        SELECT_CLAUSE_METHODS
+      end
+
+      # Progress uses TOP for limit, but it is only supported in Progress 10.
+      # The Progress adapter targets Progress 9, so it silently ignores the option.
+      def select_limit_sql(sql)
+        raise(Error, "OFFSET not supported") if @opts[:offset]
+        #sql << " TOP #{@opts[:limit]}" if @opts[:limit]
+      end
+    end
+  end
+end

data/lib/sequel/adapters/shared/sqlite.rb

@@ -0,0 +1,389 @@
+module Sequel
+  module SQLite
+    # No matter how you connect to SQLite, the following Database options
+    # can be used to set PRAGMAs on connections in a thread-safe manner:
+    # :auto_vacuum, :foreign_keys, :synchronous, and :temp_store.
+    module DatabaseMethods
+      AUTO_VACUUM = [:none, :full, :incremental].freeze
+      PRIMARY_KEY_INDEX_RE = /\Asqlite_autoindex_/.freeze
+      SYNCHRONOUS = [:off, :normal, :full].freeze
+      TABLES_FILTER = "type = 'table' AND NOT name = 'sqlite_sequence'"
+      TEMP_STORE = [:default, :file, :memory].freeze
+      
+      # Run all alter_table commands in a transaction.  This is technically only
+      # needed for drop column.
+      def alter_table(name, generator=nil, &block)
+        remove_cached_schema(name)
+        generator ||= Schema::AlterTableGenerator.new(self, &block)
+        transaction{generator.operations.each{|op| alter_table_sql_list(name, [op]).flatten.each{|sql| execute_ddl(sql)}}}
+      end
+
+      # A symbol signifying the value of the auto_vacuum PRAGMA.
+      def auto_vacuum
+        AUTO_VACUUM[pragma_get(:auto_vacuum).to_i]
+      end
+      
+      # Set the auto_vacuum PRAGMA using the given symbol (:none, :full, or
+      # :incremental).  See pragma_set.  Consider using the :auto_vacuum
+      # Database option instead.
+      def auto_vacuum=(value)
+        value = AUTO_VACUUM.index(value) || (raise Error, "Invalid value for auto_vacuum option. Please specify one of :none, :full, :incremental.")
+        pragma_set(:auto_vacuum, value)
+      end
+      
+      # SQLite uses the :sqlite database type.
+      def database_type
+        :sqlite
+      end
+      
+      # Boolean signifying the value of the foreign_keys PRAGMA, or nil
+      # if not using SQLite 3.6.19+.
+      def foreign_keys
+        pragma_get(:foreign_keys).to_i == 1 if sqlite_version >= 30619
+      end
+      
+      # Set the foreign_keys PRAGMA using the given boolean value, if using
+      # SQLite 3.6.19+.  If not using 3.6.19+, no error is raised. See pragma_set.
+      # Consider using the :foreign_keys Database option instead.
+      def foreign_keys=(value)
+        pragma_set(:foreign_keys, !!value ? 'on' : 'off') if sqlite_version >= 30619
+      end
+
+      # Return a hash containing index information. Hash keys are index name symbols.
+      # Values are subhashes with two keys, :columns and :unique.  The value of :columns
+      # is an array of symbols of column names.  The value of :unique is true or false
+      # depending on if the index is unique.
+      def indexes(table)
+        m = output_identifier_meth
+        im = input_identifier_meth
+        indexes = {}
+        begin
+          metadata_dataset.with_sql("PRAGMA index_list(?)", im.call(table)).each do |r|
+            next if r[:name] =~ PRIMARY_KEY_INDEX_RE
+            indexes[m.call(r[:name])] = {:unique=>r[:unique].to_i==1}
+          end
+        rescue Sequel::DatabaseError
+          nil
+        else
+          indexes.each do |k, v|
+            v[:columns] = metadata_dataset.with_sql("PRAGMA index_info(?)", im.call(k)).map(:name).map{|x| m.call(x)}
+          end
+        end
+        indexes
+      end
+
+      # Get the value of the given PRAGMA.
+      def pragma_get(name)
+        self["PRAGMA #{name}"].single_value
+      end
+      
+      # Set the value of the given PRAGMA to value.
+      #
+      # This method is not thread safe, and will not work correctly if there
+      # are multiple connections in the Database's connection pool. PRAGMA
+      # modifications should be done when the connection is created, using
+      # an option provided when creating the Database object.
+      def pragma_set(name, value)
+        execute_ddl("PRAGMA #{name} = #{value}")
+      end
+      
+      # The version of the server as an integer, where 3.6.19 = 30619.
+      # If the server version can't be determined, 0 is used.
+      def sqlite_version
+        return @sqlite_version if defined?(@sqlite_version)
+        @sqlite_version = begin
+          v = get{sqlite_version{}}
+          [10000, 100, 1].zip(v.split('.')).inject(0){|a, m| a + m[0] * Integer(m[1])}
+        rescue
+          0
+        end
+      end
+      
+      # SQLite 3.6.8+ supports savepoints. 
+      def supports_savepoints?
+        sqlite_version >= 30608
+      end
+
+      # A symbol signifying the value of the synchronous PRAGMA.
+      def synchronous
+        SYNCHRONOUS[pragma_get(:synchronous).to_i]
+      end
+      
+      # Set the synchronous PRAGMA using the given symbol (:off, :normal, or :full). See pragma_set.
+      # Consider using the :synchronous Database option instead.
+      def synchronous=(value)
+        value = SYNCHRONOUS.index(value) || (raise Error, "Invalid value for synchronous option. Please specify one of :off, :normal, :full.")
+        pragma_set(:synchronous, value)
+      end
+      
+      # Array of symbols specifying the table names in the current database.
+      #
+      # Options:
+      # * :server - Set the server to use.
+      def tables(opts={})
+        m = output_identifier_meth
+        metadata_dataset.from(:sqlite_master).server(opts[:server]).filter(TABLES_FILTER).map{|r| m.call(r[:name])}
+      end
+      
+      # A symbol signifying the value of the temp_store PRAGMA.
+      def temp_store
+        TEMP_STORE[pragma_get(:temp_store).to_i]
+      end
+      
+      # Set the temp_store PRAGMA using the given symbol (:default, :file, or :memory). See pragma_set.
+      # Consider using the :temp_store Database option instead.
+      def temp_store=(value)
+        value = TEMP_STORE.index(value) || (raise Error, "Invalid value for temp_store option. Please specify one of :default, :file, :memory.")
+        pragma_set(:temp_store, value)
+      end
+      
+      private
+
+      # SQLite supports limited table modification.  You can add a column
+      # or an index.  Dropping columns is supported by copying the table into
+      # a temporary table, dropping the table, and creating a new table without
+      # the column inside of a transaction.
+      def alter_table_sql(table, op)
+        case op[:op]
+        when :add_index, :drop_index
+          super
+        when :add_column
+          if op[:unique] || op[:primary_key]
+            duplicate_table(table){|columns| columns.push(op)}
+          else
+            super
+          end
+        when :drop_column
+          ocp = lambda{|oc| oc.delete_if{|c| c.to_s == op[:name].to_s}}
+          duplicate_table(table, :old_columns_proc=>ocp){|columns| columns.delete_if{|s| s[:name].to_s == op[:name].to_s}}
+        when :rename_column
+          ncp = lambda{|nc| nc.map!{|c| c.to_s == op[:name].to_s ? op[:new_name] : c}}
+          duplicate_table(table, :new_columns_proc=>ncp){|columns| columns.each{|s| s[:name] = op[:new_name] if s[:name].to_s == op[:name].to_s}}
+        when :set_column_default
+          duplicate_table(table){|columns| columns.each{|s| s[:default] = op[:default] if s[:name].to_s == op[:name].to_s}}
+        when :set_column_null
+          duplicate_table(table){|columns| columns.each{|s| s[:null] = op[:null] if s[:name].to_s == op[:name].to_s}}
+        when :set_column_type
+          duplicate_table(table){|columns| columns.each{|s| s[:type] = op[:type] if s[:name].to_s == op[:name].to_s}}
+        else
+          raise Error, "Unsupported ALTER TABLE operation"
+        end
+      end
+      
+      # The array of column symbols in the table, except for ones given in opts[:except]
+      def backup_table_name(table, opts={})
+        table = table.gsub('`', '')
+        (opts[:times]||1000).times do |i|
+          table_name = "#{table}_backup#{i}"
+          return table_name unless table_exists?(table_name)
+        end
+      end
+
+      # Allow use without a generator, needed for the alter table hackery that Sequel allows.
+      def column_list_sql(generator)
+        generator.is_a?(Schema::Generator) ? super : generator.map{|c| column_definition_sql(c)}.join(', ')
+      end
+
+      # The array of column schema hashes, except for the ones given in opts[:except]
+      def defined_columns_for(table, opts={})
+        cols = parse_pragma(table, {})
+        cols.each do |c|
+          c[:default] = LiteralString.new(c[:default]) if c[:default]
+          c[:type] = c[:db_type]
+        end
+        if opts[:except]
+          nono= Array(opts[:except]).compact.map{|n| n.to_s}
+          cols.reject!{|c| nono.include? c[:name] }
+        end
+        cols
+      end
+      
+      # Duplicate an existing table by creating a new table, copying all records
+      # from the existing table into the new table, deleting the existing table
+      # and renaming the new table to the existing table's name.
+      def duplicate_table(table, opts={})
+        remove_cached_schema(table)
+        def_columns = defined_columns_for(table)
+        old_columns = def_columns.map{|c| c[:name]}
+        opts[:old_columns_proc].call(old_columns) if opts[:old_columns_proc]
+
+        yield def_columns if block_given?
+        def_columns_str = column_list_sql(def_columns)
+        new_columns = old_columns.dup
+        opts[:new_columns_proc].call(new_columns) if opts[:new_columns_proc]
+
+        qt = quote_schema_table(table)
+        bt = quote_identifier(backup_table_name(qt))
+        [
+           "CREATE TABLE #{bt}(#{def_columns_str})",
+           "INSERT INTO #{bt}(#{dataset.send(:identifier_list, new_columns)}) SELECT #{dataset.send(:identifier_list, old_columns)} FROM #{qt}",
+           "DROP TABLE #{qt}",
+           "ALTER TABLE #{bt} RENAME TO #{qt}"
+        ]
+      end
+
+      # SQLite folds unquoted identifiers to lowercase, so it shouldn't need to upcase identifiers on input.
+      def identifier_input_method_default
+        nil
+      end
+      
+      # SQLite folds unquoted identifiers to lowercase, so it shouldn't need to upcase identifiers on output.
+      def identifier_output_method_default
+        nil
+      end
+      
+      # Array of PRAGMA SQL statements based on the Database options that should be applied to
+      # new connections.
+      def connection_pragmas
+        ps = []
+        v = typecast_value_boolean(opts.fetch(:foreign_keys, 1))
+        ps << "PRAGMA foreign_keys = #{v ? 1 : 0}"
+        [[:auto_vacuum, AUTO_VACUUM], [:synchronous, SYNCHRONOUS], [:temp_store, TEMP_STORE]].each do |prag, con|
+          if v = opts[prag]
+            raise(Error, "Value for PRAGMA #{prag} not supported, should be one of #{con.join(', ')}") unless v = con.index(v.to_sym)
+            ps << "PRAGMA #{prag} = #{v}"
+          end
+        end
+        ps
+      end
+
+      # Parse the output of the table_info pragma
+      def parse_pragma(table_name, opts)
+        metadata_dataset.with_sql("PRAGMA table_info(?)", input_identifier_meth.call(table_name)).map do |row|
+          row.delete(:cid)
+          row[:allow_null] = row.delete(:notnull).to_i == 0
+          row[:default] = row.delete(:dflt_value)
+          row[:primary_key] = row.delete(:pk).to_i == 1
+          row[:default] = nil if blank_object?(row[:default]) || row[:default] == 'NULL'
+          row[:db_type] = row.delete(:type)
+          row[:type] = schema_column_type(row[:db_type])
+          row
+        end
+      end
+      
+      # SQLite treats integer primary keys as autoincrementing (alias of rowid).
+      def schema_autoincrementing_primary_key?(schema)
+        super and schema[:db_type].downcase == 'integer'
+      end
+
+      # SQLite supports schema parsing using the table_info PRAGMA, so
+      # parse the output of that into the format Sequel expects.
+      def schema_parse_table(table_name, opts)
+        m = output_identifier_meth
+        parse_pragma(table_name, opts).map do |row|
+          [m.call(row.delete(:name)), row]
+        end
+      end
+      
+      # SQLite uses the integer data type even for bignums.  This is because they
+      # are both stored internally as text, and converted when returned from
+      # the database.  Using an integer type instead of bigint makes it more likely
+      # that software will automatically return the column as an integer.
+      def type_literal_generic_bignum(column)
+        :integer
+      end
+    end
+    
+    # Instance methods for datasets that connect to an SQLite database
+    module DatasetMethods
+      SELECT_CLAUSE_METHODS = Dataset.clause_methods(:select, %w'distinct columns from join where group having compounds order limit')
+      CONSTANT_MAP = {:CURRENT_DATE=>"date(CURRENT_TIMESTAMP, 'localtime')".freeze, :CURRENT_TIMESTAMP=>"datetime(CURRENT_TIMESTAMP, 'localtime')".freeze, :CURRENT_TIME=>"time(CURRENT_TIMESTAMP, 'localtime')".freeze}
+    
+      # SQLite does not support pattern matching via regular expressions.
+      # SQLite is case insensitive (depending on pragma), so use LIKE for
+      # ILIKE.
+      def complex_expression_sql(op, args)
+        case op
+        when :~, :'!~', :'~*', :'!~*'
+          raise Error, "SQLite does not support pattern matching via regular expressions"
+        when :LIKE, :'NOT LIKE', :ILIKE, :'NOT ILIKE'
+          # SQLite is case insensitive for ASCII, and non case sensitive for other character sets
+          "#{'NOT ' if [:'NOT LIKE', :'NOT ILIKE'].include?(op)}(#{literal(args.at(0))} LIKE #{literal(args.at(1))})"
+        else
+          super(op, args)
+        end
+      end
+      
+      # MSSQL doesn't support the SQL standard CURRENT_DATE or CURRENT_TIME
+      def constant_sql(constant)
+        CONSTANT_MAP[constant] || super
+      end
+      
+      # SQLite performs a TRUNCATE style DELETE if no filter is specified.
+      # Since we want to always return the count of records, add a condition
+      # that is always true and then delete.
+      def delete
+        @opts[:where] ? super : filter(1=>1).delete
+      end
+      
+      # Return an array of strings specifying a query explanation for a SELECT of the
+      # current dataset.
+      def explain
+        db.send(:metadata_dataset).clone(:sql=>"EXPLAIN #{select_sql}").
+          map{|x| "#{x[:addr]}|#{x[:opcode]}|#{(1..5).map{|i| x[:"p#{i}"]}.join('|')}|#{x[:comment]}"}
+      end
+      
+      # HAVING requires GROUP BY on SQLite
+      def having(*cond, &block)
+        raise(InvalidOperation, "Can only specify a HAVING clause on a grouped dataset") unless @opts[:group]
+        super
+      end
+      
+      # SQLite uses the nonstandard ` (backtick) for quoting identifiers.
+      def quoted_identifier(c)
+        "`#{c}`"
+      end
+      
+      # SQLite does not support INTERSECT ALL or EXCEPT ALL
+      def supports_intersect_except_all?
+        false
+      end
+
+      # SQLite does not support IS TRUE
+      def supports_is_true?
+        false
+      end
+      
+      # SQLite does not support multiple columns for the IN/NOT IN operators
+      def supports_multiple_column_in?
+        false
+      end
+      
+      # SQLite supports timezones in literal timestamps, since it stores them
+      # as text.
+      def supports_timestamp_timezones?
+        true
+      end
+
+      private
+      
+      # SQLite uses string literals instead of identifiers in AS clauses.
+      def as_sql(expression, aliaz)
+        aliaz = aliaz.value if aliaz.is_a?(SQL::Identifier)
+        "#{expression} AS #{literal(aliaz.to_s)}"
+      end
+      
+      # SQLite uses a preceding X for hex escaping strings
+      def literal_blob(v)
+        blob = ''
+        v.each_byte{|x| blob << sprintf('%02x', x)}
+        "X'#{blob}'"
+      end
+      
+      # SQLite does not support the SQL WITH clause
+      def select_clause_methods
+        SELECT_CLAUSE_METHODS
+      end
+      
+      # Support FOR SHARE locking when using the :share lock style.
+      def select_lock_sql(sql)
+        super unless @opts[:lock] == :update
+      end
+      
+      # SQLite treats a DELETE with no WHERE clause as a TRUNCATE
+      def _truncate_sql(table)
+        "DELETE FROM #{table}"
+      end
+    end
+  end
+end

data/lib/sequel/adapters/sqlite.rb

@@ -0,0 +1,224 @@
+require 'sqlite3'
+begin
+  SQLite3::Database.instance_method(:type_translation)
+rescue
+  raise(Sequel::Error, "SQLite3::Database#type_translation is not defined.  If you are using the sqlite3 gem, please install the sqlite3-ruby gem.")
+end
+Sequel.require 'adapters/shared/sqlite'
+
+module Sequel
+  # Top level module for holding all SQLite-related modules and classes
+  # for Sequel.
+  module SQLite
+    # Database class for SQLite databases used with Sequel and the
+    # ruby-sqlite3 driver.
+    class Database < Sequel::Database
+      UNIX_EPOCH_TIME_FORMAT = /\A\d+\z/.freeze
+      include ::Sequel::SQLite::DatabaseMethods
+      
+      set_adapter_scheme :sqlite
+      
+      # Mimic the file:// uri, by having 2 preceding slashes specify a relative
+      # path, and 3 preceding slashes specify an absolute path.
+      def self.uri_to_options(uri) # :nodoc:
+        { :database => (uri.host.nil? && uri.path == '/') ? nil : "#{uri.host}#{uri.path}" }
+      end
+      
+      private_class_method :uri_to_options
+      
+      # Connect to the database.  Since SQLite is a file based database,
+      # the only options available are :database (to specify the database
+      # name), and :timeout, to specify how long to wait for the database to
+      # be available if it is locked, given in milliseconds (default is 5000).
+      def connect(server)
+        opts = server_opts(server)
+        opts[:database] = ':memory:' if blank_object?(opts[:database])
+        db = ::SQLite3::Database.new(opts[:database])
+        db.busy_timeout(opts.fetch(:timeout, 5000))
+        db.type_translation = true
+        
+        connection_pragmas.each{|s| log_yield(s){db.execute_batch(s)}}
+        
+        # Handle datetimes with Sequel.datetime_class
+        prok = proc do |t,v|
+          v = Time.at(v.to_i).iso8601 if UNIX_EPOCH_TIME_FORMAT.match(v)
+          Sequel.database_to_application_timestamp(v)
+        end
+        db.translator.add_translator("timestamp", &prok)
+        db.translator.add_translator("datetime", &prok)
+        
+        # Handle numeric values with BigDecimal
+        prok = proc{|t,v| BigDecimal.new(v) rescue v}
+        db.translator.add_translator("numeric", &prok)
+        db.translator.add_translator("decimal", &prok)
+        db.translator.add_translator("money", &prok)
+        
+        # Handle floating point values with Float
+        prok = proc{|t,v| Float(v) rescue v}
+        db.translator.add_translator("float", &prok)
+        db.translator.add_translator("real", &prok)
+        db.translator.add_translator("double precision", &prok)
+        
+        # Handle blob values with Sequel::SQL::Blob
+        db.translator.add_translator("blob"){|t,v| ::Sequel::SQL::Blob.new(v)}
+        
+        db
+      end
+      
+      # Return instance of Sequel::SQLite::Dataset with the given options.
+      def dataset(opts = nil)
+        SQLite::Dataset.new(self, opts)
+      end
+      
+      # Run the given SQL with the given arguments and return the number of changed rows.
+      def execute_dui(sql, opts={})
+        _execute(opts){|conn| log_yield(sql, opts[:arguments]){conn.execute_batch(sql, opts[:arguments])}; conn.changes}
+      end
+      
+      # Run the given SQL with the given arguments and return the last inserted row id.
+      def execute_insert(sql, opts={})
+        _execute(opts){|conn| log_yield(sql, opts[:arguments]){conn.execute(sql, opts[:arguments])}; conn.last_insert_row_id}
+      end
+      
+      # Run the given SQL with the given arguments and yield each row.
+      def execute(sql, opts={})
+        _execute(opts) do |conn|
+          begin
+            yield(result = log_yield(sql, opts[:arguments]){conn.query(sql, opts[:arguments])})
+          ensure
+            result.close if result
+          end
+        end
+      end
+      
+      # Run the given SQL with the given arguments and return the first value of the first row.
+      def single_value(sql, opts={})
+        _execute(opts){|conn| log_yield(sql, opts[:arguments]){conn.get_first_value(sql, opts[:arguments])}}
+      end
+      
+      private
+      
+      # Yield an available connection.  Rescue
+      # any SQLite3::Exceptions and turn them into DatabaseErrors.
+      def _execute(opts, &block)
+        begin
+          synchronize(opts[:server], &block)
+        rescue SQLite3::Exception => e
+          raise_error(e)
+        end
+      end
+      
+      # The SQLite adapter does not need the pool to convert exceptions.
+      # Also, force the max connections to 1 if a memory database is being
+      # used, as otherwise each connection gets a separate database.
+      def connection_pool_default_options
+        o = super.dup
+        # Default to only a single connection if a memory database is used,
+        # because otherwise each connection will get a separate database
+        o[:max_connections] = 1 if @opts[:database] == ':memory:' || blank_object?(@opts[:database])
+        o
+      end
+      
+      # The main error class that SQLite3 raises
+      def database_error_classes
+        [SQLite3::Exception]
+      end
+
+      # Disconnect given connections from the database.
+      def disconnect_connection(c)
+        c.close
+      end
+    end
+    
+    # Dataset class for SQLite datasets that use the ruby-sqlite3 driver.
+    class Dataset < Sequel::Dataset
+      include ::Sequel::SQLite::DatasetMethods
+      
+      PREPARED_ARG_PLACEHOLDER = ':'.freeze
+      
+      # SQLite already supports named bind arguments, so use directly.
+      module ArgumentMapper
+        include Sequel::Dataset::ArgumentMapper
+        
+        protected
+        
+        # Return a hash with the same values as the given hash,
+        # but with the keys converted to strings.
+        def map_to_prepared_args(hash)
+          args = {}
+          hash.each{|k,v| args[k.to_s] = v}
+          args
+        end
+        
+        private
+        
+        # SQLite uses a : before the name of the argument for named
+        # arguments.
+        def prepared_arg(k)
+          LiteralString.new("#{prepared_arg_placeholder}#{k}")
+        end
+      end
+      
+      # SQLite prepared statement uses a new prepared statement each time
+      # it is called, but it does use the bind arguments.
+      module PreparedStatementMethods
+        include ArgumentMapper
+        
+        private
+        
+        # Run execute_select on the database with the given SQL and the stored
+        # bind arguments.
+        def execute(sql, opts={}, &block)
+          super(sql, {:arguments=>bind_arguments}.merge(opts), &block)
+        end
+        
+        # Same as execute, explicit due to intricacies of alias and super.
+        def execute_dui(sql, opts={}, &block)
+          super(sql, {:arguments=>bind_arguments}.merge(opts), &block)
+        end
+        
+        # Same as execute, explicit due to intricacies of alias and super.
+        def execute_insert(sql, opts={}, &block)
+          super(sql, {:arguments=>bind_arguments}.merge(opts), &block)
+        end
+      end
+      
+      # Yield a hash for each row in the dataset.
+      def fetch_rows(sql)
+        execute(sql) do |result|
+          i = -1
+          cols = result.columns.map{|c| [output_identifier(c), i+=1]}
+          @columns = cols.map{|c| c.first}
+          result.each do |values|
+            row = {}
+            cols.each{|n,i| row[n] = values[i]}
+            yield row
+          end
+        end
+      end
+      
+      # Prepare the given type of query with the given name and store
+      # it in the database.  Note that a new native prepared statement is
+      # created on each call to this prepared statement.
+      def prepare(type, name=nil, *values)
+        ps = to_prepared_statement(type, values)
+        ps.extend(PreparedStatementMethods)
+        db.prepared_statements[name] = ps if name
+        ps.prepared_sql
+        ps
+      end
+      
+      private
+      
+      # Quote the string using the adapter class method.
+      def literal_string(v)
+        "'#{::SQLite3::Database.quote(v)}'"
+      end
+
+      # SQLite uses a : before the name of the argument as a placeholder.
+      def prepared_arg_placeholder
+        PREPARED_ARG_PLACEHOLDER
+      end
+    end
+  end
+end