dbd-sqlite3 1.2.2

data/LICENSE

@@ -0,0 +1,25 @@
+(C) 2008 Erik Hollensbe <erik@hollensbe.org>. All rights reserved.
+
+Please see "README" for earlier copyrights.
+
+Redistribution and use in source and binary forms, with or without 
+modification, are permitted provided that the following conditions 
+are met:
+1. Redistributions of source code must retain the above copyright 
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright 
+   notice, this list of conditions and the following disclaimer in the 
+   documentation and/or other materials provided with the distribution.
+3. The name of the author may not be used to endorse or promote products
+   derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL
+THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
+OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README

@@ -0,0 +1,271 @@
+= Description
+    The DBI package is a vendor independent interface for accessing databases.
+    It is similar, but not identical to, Perl's DBI module.
+
+= Synopsis
+
+    require 'dbi'
+    
+    # Connect to a database, old style
+    dbh = DBI.connect('DBI:Mysql:test', 'testuser', 'testpwd')
+    
+    # Insert some rows, use placeholders
+    1.upto(13) do |i|
+        sql = "insert into simple01 (SongName, SongLength_s) VALUES (?, ?)"
+        dbh.do(sql, "Song #{i}", "#{i*10}")
+    end 
+    
+    # Select all rows from simple01
+    sth = dbh.prepare('select * from simple01')
+    sth.execute
+    
+    # Print out each row
+    while row=sth.fetch do
+        p row
+    end
+    
+    # Close the statement handle when done
+    sth.finish
+    
+    # Don't prepare, just do it!
+    dbh.do('delete from simple01 where internal_id > 10')
+      
+    # And finally, disconnect
+    dbh.disconnect
+        
+    # Same example, but a little more Ruby-ish
+    DBI.connect('DBI:Mysql:test', 'testuser', 'testpwd') do | dbh |
+      
+        sql = "insert into simple01 (SongName, SongLength_s) VALUES (?, ?)"
+        
+        dbh.prepare(sql) do | sth | 
+            1.upto(13) { |i| sth.execute("Song #{i}", "#{i*10}") }
+        end 
+        
+        dbh.select_all('select * from simple01') do | row |
+            p row
+        end
+        
+        dbh.do('delete from simple01 where internal_id > 10')
+      
+    end
+
+= Prerequisites
+    Ruby 1.8.6 or later is the test target, however you may have success with
+    earlier 1.8.x versions of Ruby.
+
+= RubyForge Project
+    General information: http://ruby-dbi.rubyforge.org
+    Project information: http://rubyforge.org/projects/ruby-dbi/
+    Downloads: http://rubyforge.org/frs/?group_id=234
+
+= Installation
+    There are many database drivers (DBDs) available.  You only need to install
+    the DBDs for the database software that you will be using.
+
+== Gem setup:
+
+    gem install dbi
+    # One or more of:
+    gem install dbd-mysql
+    gem install dbd-pg
+    gem install dbd-sqlite3
+    gem install dbd-sqlite
+
+== Without rubygems:
+
+    ruby setup.rb config
+    ruby setup.rb setup
+    ruby setup.rb install
+
+== The bleeding edge:
+
+    git clone git://hollensbe.org/git/ruby-dbi.git
+    git checkout -b development origin/development
+    
+    Also available at
+    
+    git clone git://github.com/erikh/ruby-dbi.git
+      
+= Available Database Drivers (DBDs)
+
+== DBD::MySQL
+    MySQL
+    Depends on the mysql-ruby package from http://www.tmtm.org/mysql or
+    available from the RAA.
+
+== DBD::ODBC
+    ODBC
+    Depends on the ruby-odbc package (0.5 or later, 0.9.3 or later recommended) at
+    http://www.ch-werner.de/rubyodbc or available from the RAA.  Works together
+    with unix-odbc.
+
+== DBD::OCI8
+    OCI8 (Oracle)
+    Depends on the the ruby-oci8 package, available on the RAA and RubyForge.
+
+== DBD::Pg
+    PostgreSQL
+    Depends on the pg package, available on RubyForge.
+
+== DBD::SQLite
+    SQLite (versions 2.x and earlier)
+    Depends on the sqlite-ruby package, available on rubyforge.
+
+== DBD::SQLite3
+    SQLite 3.x
+    Depends on the sqlite3-ruby package, available on rubyforge.
+
+= Additional Documentation
+    See the directories doc/* for DBI and DBD specific information.
+    The DBI specification is at doc/DBI_SPEC.rdoc.
+    The DBD specification is at doc/DBD_SPEC.rdoc.
+
+= Articles
+== Tutorial: Using the Ruby DBI Module
+    http://www.kitebird.com/articles/ruby-dbi.html
+   
+= Applications
+== dbi
+    The SQL command line interpreter dbi is available in directory
+    bin/. It gets installed by default.
+
+= License
+
+   Copyright (c) 2008 Erik Hollensbe
+
+   Copyright (c) 2005-2006 Kirk Haines, Francis Hwang, Patrick May and Daniel
+   Berger.
+
+   Copyright (c) 2001, 2002, 2003, 2004 Michael Neumann <mneumann@ntecs.de>
+   and others (see the beginning of each file for copyright holder information).
+
+   All rights reserved.
+
+   Redistribution and use in source and binary forms, with or without
+   modification, are permitted provided that the following conditions are met:
+
+   1. Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+   2. Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimer in the documentation
+      and/or other materials provided with the distribution.
+   3. The name of the author may not be used to endorse or promote products
+      derived from this software without specific prior written permission.
+
+   THIS SOFTWARE IS PROVIDED 'AS IS' AND ANY EXPRESS OR IMPLIED WARRANTIES,
+   INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
+   AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL
+   THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+   EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+   PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
+   OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+   WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+   OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+   ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+   This is the BSD license which is less restrictive than GNU's GPL
+   (General Public License).
+
+= Contributors
+   
+   Pistos
+      Too much to specify. Infinite patience and help.
+
+   Christopher Maujean
+      Lots of initial help when reviving the project.
+
+   Jun Mukai <mukai@jmuk.org>
+      Contributed initial SQLite3 DBD.
+
+   John J. Fox IV
+      Lots of help testing on multiple platforms.
+
+   Kirk Haines
+      One of the authors of the rewrite effort (January 2006).
+
+   Francis Hwang
+      One of the authors of the rewrite effort (January 2006).
+
+   Patrick May
+      One of the authors of the rewrite effort (January 2006).
+
+   Daniel Berger
+      One of the authors of the rewrite effort (January 2006).
+
+   Michael Neumann
+      Original author of Ruby/DBI; wrote the DBI and most of the DBDs.
+
+   Rainer Perl
+      Author of Ruby/DBI 0.0.4 from which many good ideas were taken.
+
+   Jim Weirich
+      Original author of DBD::Pg.  Wrote additional code (e.g. sql.rb,
+      testcases).  Gave many helpful hints and comments. 
+
+   Eli Green
+      Implemented DatabaseHandle#columns for Mysql and Pg. 
+
+   Masatoshi SEKI
+      For his version of module BasicQuote in sql.rb. 
+
+   John Gorman
+      For his case insensitive load_driver patch and parameter parser. 
+
+   David Muse
+      For testing the DBD::SQLRelay and for his initial DBD. 
+
+   Jim Menard
+      Extended DBD::Oracle for method columns. 
+
+   Joseph McDonald
+      Fixed bug in DBD::Pg (default values in method columns). 
+
+   Norbert Gawor
+      Fixed bug in DBD::ODBC (method columns) and proxyserver. 
+
+   James F. Hranicky
+      Patch for DBD::Pg (cache PGResult#result in Tuples) which increased
+      performance by a factor around 100. 
+
+   Stephen Davies
+      Added method Statement#fetch_scroll for DBD::Pg. 
+
+   Dave Thomas
+      Several enhancements. 
+
+   Brad Hilton
+      Column coercing patch for DBD::Mysql. 
+
+   Sean Chittenden
+      Originally a co-owner of the project.  Submitted several patches
+      and helped with lots of comments.
+
+   MoonWolf
+      Provided the quote/escape_byte patch for DBD::Pg, DBD::SQLite patch and
+      Database#columns implementation. Further patches. 
+
+   Paul DuBois
+      Fixed typos and formatting. Maintains DBD::Mysql. 
+
+   Tim Bates
+      Bug fixes for Mysql and DBI.
+
+   Brian Candler
+      Zero-padding date/time/timestamps fix. 
+
+   Florian G. Pflug
+      Discussion and helpful comments/benchmarks about DBD::Pg async_exec vs.
+      exec. 
+   
+   Oliver M. Bolzer
+      Patches to support Postgres arrays for DBD::Pg. 
+
+   Stephen R. Veit
+      ruby-db2 and DBD::DB2 enhancements. 
+
+   Dennis Vshivkov
+      DBD::Pg patches 
+
+   Cail Borrell from frontbase.com
+      For the Frontbase DBD and C interface. 

data/lib/dbd/SQLite3.rb

@@ -0,0 +1,122 @@
+#--
+# DBD::SQLite3
+# 
+# copyright (c) 2005 Jun Mukai <mukai@jmuk.org>
+# Compatibility patches by Erik Hollensbe <erik@hollensbe.org>
+# 
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without 
+# modification, are permitted provided that the following conditions 
+# are met:
+# 1. Redistributions of source code must retain the above copyright 
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright 
+#    notice, this list of conditions and the following disclaimer in the 
+#    documentation and/or other materials provided with the distribution.
+# 3. The name of the author may not be used to endorse or promote products
+#    derived from this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
+# INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
+# AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL
+# THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
+# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#++
+
+begin
+  require 'rubygems'
+  gem 'sqlite3-ruby'
+  gem 'dbi'
+rescue LoadError
+end
+
+require 'dbi'
+require 'sqlite3'
+require 'sqlite3/version'
+
+module DBI
+    module DBD
+        #
+        # DBD::SQLite3 - Database Driver for SQLite versions 3.x
+        #
+        # Requires DBI and the 'sqlite3-ruby' gem to work.
+        #
+        # Only things that extend DBI's results are documented.
+        #
+        module SQLite3
+            VERSION = ::SQLite3::Version::STRING
+            DESCRIPTION = "SQLite 3.x DBD for DBI"
+
+            #
+            # returns 'SQLite3'
+            #
+            # See DBI::TypeUtil#convert for more information.
+            #
+            def self.driver_name
+                "SQLite3"
+            end
+
+            #
+            # Validates that the SQL has no literal NUL characters. (ASCII 0)
+            #
+            # SQLite apparently really hates it when you do that.
+            #
+            # It will raise DBI::DatabaseError should it find any.
+            #
+            def self.parse_type(type_name)
+                # FIXME plucked from SQLite driver, this needs to be in DBI proper 
+                return ['varchar'] unless type_name
+                type_name.match(/^([^\(]+)(\((\d+)(,(\d+))?\))?$/)
+            end
+
+            #
+            # See DBI::BaseDriver.
+            #
+            class Driver < DBI::BaseDriver
+                def initialize
+                    @dbs = []
+                    super "0.4.0"
+                end
+
+                def connect(dbname, user, auth, attr)
+                    raise DBI::InterfaceError, "dbname must be a string" unless dbname.kind_of? String
+                    raise DBI::InterfaceError, "dbname must have some length" unless dbname.length > 0
+                    raise DBI::InterfaceError, "attrs must be a hash" unless attr.kind_of? Hash
+                    db = DBI::DBD::SQLite3::Database.new(dbname, attr)
+                    @dbs.push(db)
+                    db
+                end
+
+                def disconnect_all()
+                    @dbs.each{|db| db.disconnect()}
+                end
+            end
+        end
+    end
+end
+
+require 'dbd/sqlite3/database'
+require 'dbd/sqlite3/statement'
+
+DBI::TypeUtil.register_conversion(DBI::DBD::SQLite3.driver_name) do |obj|
+    newobj = case obj
+             when ::TrueClass
+                '1'
+             when ::FalseClass
+                '0'
+             else
+                 # SQLite3 is managing its own conversion right now, until I'm happy let's keep it that way
+                 obj.dup rescue obj
+             end
+    if newobj.object_id == obj.object_id
+        [newobj, true]
+    else
+        [newobj, false]
+    end
+end

data/lib/dbd/sqlite3/database.rb

@@ -0,0 +1,192 @@
+#
+# See DBI::BaseDatabase.
+#
+class DBI::DBD::SQLite3::Database < DBI::BaseDatabase
+    #
+    # Constructor. Valid attributes:
+    #
+    # * AutoCommit: Commit after every statement execution.
+    #
+    # The following attributes go directly to the low-level SQLite3 driver. 
+    # Please consult it's documentation for more information.
+    #
+    # * auto_vacuum
+    # * cache_size
+    # * default_cache_size
+    # * default_synchronous
+    # * default_temp_store
+    # * full_column_names
+    # * synchronous
+    # * temp_store
+    # * type_translation
+    #
+    def initialize(dbname, attr)
+        @db = ::SQLite3::Database.new(dbname)
+
+        @db.type_translation = false
+
+        @attr = {'AutoCommit' => true}
+        if attr then
+            attr.each_pair do |key, value|
+                begin
+                    self[key] = value
+                rescue DBI::NotSupportedError
+                end
+            end
+        end
+        __generate_attr__
+    end
+
+    def disconnect()
+        @db.rollback if @db.transaction_active?
+        @db.close
+    end
+
+    def prepare(statement)
+        DBI::DBD::SQLite3::Statement.new(statement, @db)
+    end
+
+    def ping()
+        not @db.closed?
+    end
+
+    def commit()
+        if @db.transaction_active?
+            @db.commit
+            @db.transaction
+        else
+            raise DBI::ProgrammingError.new("No active transaction.")
+        end
+    end
+
+    #
+    # See DBI::BaseDatabase#rollback.
+    #
+    # If all statements were not closed before the rollback occurs, a
+    # DBI::Warning may be raised if the database encounters an error because of
+    # it.
+    #
+    # This method will also raise DBI::ProgrammingError if not in a
+    # transaction.
+    #
+    def rollback()
+        if @db.transaction_active?
+            begin 
+                @db.rollback 
+                @db.transaction
+            rescue Exception => e
+                raise DBI::Warning, "Statements were not closed prior to rollback"
+            end
+        else
+            raise DBI::ProgrammingError.new("No active transaction.")
+        end
+    end
+
+    def tables()
+        ret = []
+        result = @db.execute(%q(
+            SELECT name FROM sqlite_master WHERE type IN ('table', 'view') 
+            UNION ALL 
+            SELECT name FROM sqlite_temp_master WHERE type in ('table', 'view') ORDER BY 1
+        ))
+        result.each{|row| ret.push(row[0])}
+        ret
+    end
+
+    #
+    # See DBI::BaseDatabase#columns.
+    #
+    # Additional Attributes:
+    #
+    # * sql_type: XOPEN integer SQL Type.
+    # * nullable: true if NULL is allowed in this column.
+    # * default: the value that will be used in new rows if this column
+    #   receives no data.
+    #
+    def columns(table)
+        @db.type_translation = false
+        ret =
+            @db.table_info(table).map do |hash|
+                m = DBI::DBD::SQLite3.parse_type(hash['type'])
+                h = { 
+                    'name' => hash['name'],
+                    'type_name' => m[1],
+                    'sql_type' => 
+                        begin
+                            DBI.const_get('SQL_'+hash['type'].upcase)
+                        rescue NameError
+                            DBI::SQL_OTHER
+                        end,
+                    'nullable' => (hash['notnull'] == '0'),
+                    'default' => (@attr['type_translation'] && (not hash['dflt_value'])) ? 
+                                    @db.translator.translate(hash['type'], hash['dflt_value']) :
+                                    hash['dflt_value'] 
+                }
+
+                h['precision'] = m[3].to_i if m[3]
+                h['scale']     = m[5].to_i if m[5]
+
+                h
+            end
+        @db.type_translation = @attr['type_translation']
+        ret
+    end
+
+    def quote(value)
+        ::SQLite3::Database.quote(value.to_s)
+    end
+
+    #
+    # This method is used to aid the constructor and probably should not be
+    # used independently.
+    #
+    def __generate_attr__()
+        tt = @db.type_translation
+        @db.type_translation = false
+        [ 'auto_vacuum', 'cache_size', 'default_cache_size',
+        'default_synchronous', 'default_temp_store', 'full_column_names',
+        'synchronous', 'temp_store', 'type_translation' ].each do |key|
+            unless @attr.has_key?(key) then
+                @attr[key] = @db.__send__(key)
+            end
+        end
+        @db.type_translation = tt
+    end
+
+    #
+    # See #new for valid attributes.
+    #
+    # If Autocommit is set to true, commit happens immediately if a transaction
+    # is open.
+    #
+    def []=(attr, value)
+        case attr
+        when 'AutoCommit'
+            if value
+                @db.commit if @db.transaction_active?
+            else
+                @db.transaction unless @db.transaction_active?
+            end
+        @attr[attr] = value
+        when 'auto_vacuum', 'cache_size', 'count_changes',
+          'default_cache_size', 'encoding', 'full_column_names',
+          'page_size', 'short_column_names', 'synchronous',
+          'temp_store', 'temp_store_directory'
+          @db.__send__((attr+'='), value)
+            @attr[attr] = @db.__send__(attr)
+        when 'busy_timeout'
+            @db.busy_timeout(value)
+            @attr[attr] = value
+        when 'busy_handler'
+            @db.busy_timeout(&value)
+            @attr[attr] = value
+        when 'type_translation'
+            @db.type_translation = value
+            @attr[attr] = value
+        else
+            raise DBI::NotSupportedError
+        end
+
+        return value
+    end
+end