femto-sqlite3 1.3.7

data/API_CHANGES.rdoc

@@ -0,0 +1,50 @@
+= API Changes
+
+* SQLite3::Database#execute only accepts an array for bind parameters.
+
+* SQLite3::ResultSet used to query the database for the first row, regardless
+  of whether the user asked for it or not.  I have removed that so that rows
+  will not be returned until the user asks for them.  This is a subtle but
+  sometimes important change in behavior.
+
+  83882d2208ed189361617d5ab8532a325aaf729d
+  
+* SQLite3::Database#trace now takes either a block or an object that responds
+  to "call".  The previous implementation passed around a VALUE that was cast
+  to a void *.  This is dangerous because the value could get garbage collected
+  before the proc was called.  If the user wants data passed around with the
+  block, they should use variables available to the closure or create an
+  object.
+
+* SQLite3::Statement#step automatically converts to ruby types, where before
+  all values were automatically yielded as strings.  This will only be a
+  problem for people who were accessing information about the database that
+  wasn't previously passed through the pure ruby conversion code.
+
+* SQLite3::Database#errmsg no longer takes a parameter to return error
+  messages as UTF-16.  Do people even use that?  I opt for staying UTF-8 when
+  possible.  See test_integration.rb test_errmsg_utf16
+
+* SQLite3::Database#authorize same changes as trace
+
+* test/test_tc_database.rb was removed because we no longer use the Driver
+  design pattern.
+
+= Garbage Collection Strategy
+
+All statements keep pointers back to their respective database connections.
+The @connection instance variable on the Statement handle keeps the database
+connection alive.  Memory allocated for a statement handler will be freed in
+two cases:
+
+* close is called on the statement
+* The SQLite3::Database object gets garbage collected
+
+We can't free the memory for the statement in the garbage collection function
+for the statement handler.  The reason is because there exists a race
+condition.  We cannot guarantee the order in which objects will be garbage
+collected.  So, it is possible that a connection and a statement are up for
+garbage collection.  If the database connection were to be free'd before the
+statement, then boom.  Instead we'll be conservative and free unclosed
+statements when the connection is terminated.
+

data/CHANGELOG.rdoc

@@ -0,0 +1,245 @@
+=== Unreleased
+
+* Bugfixes
+  * Closing a bad statement twice will not segv.
+
+=== 1.3.6 / 2012-04-16
+
+* Enhancements
+  * Windows: build against SQLite 3.7.11
+  * Added SQLite3::ResultSet#each_hash for fetching each row as a hash.
+  * Added SQLite3::ResultSet#next_hash for fetching one row as a hash.
+
+* Bugfixes
+  * Support both UTF-16LE and UTF-16BE encoding modes on PPC. Closes #63
+  * Protect parameters to custom functions from being garbage collected too
+    soon. Fixes #60. Thanks hirataya!
+  * Fix backwards compatibility with 1.2.5 with bind vars and `query` method.
+    Fixes #35.
+  * Fix double definition error caused by defining sqlite3_int64/uint64.
+  * Fix suspicious version regexp.
+
+* Deprecations
+  * ArrayWithTypesAndFields#types is deprecated and the class will be removed
+    in version 2.0.0.  Please use the `types` method on the ResultSet class
+    that created this object.
+  * ArrayWithTypesAndFields#fields is deprecated and the class will be removed
+    in version 2.0.0.  Please use the `columns` method on the ResultSet class
+    that created this object.
+  * The ArrayWithTypesAndFields class will be removed in 2.0.0
+  * The ArrayWithTypes class will be removed in 2.0.0
+  * HashWithTypesAndFields#types is deprecated and the class will be removed
+    in version 2.0.0.  Please use the `types` method on the ResultSet class
+    that created this object.
+  * HashWithTypesAndFields#fields is deprecated and the class will be removed
+    in version 2.0.0.  Please use the `columns` method on the ResultSet class
+    that created this object.
+
+=== 1.3.5 / 2011-12-03 - ZOMG Holidays are here Edition!
+
+* Enhancements
+  * Windows: build against SQLite 3.7.9
+  * Static: enable SQLITE_ENABLE_COLUMN_METADATA
+  * Added Statement#clear_bindings! to set bindings back to nil
+
+* Bugfixes
+  * Fixed a segv on Database.new. Fixes #34 (thanks nobu!)
+  * Database error is not reset, so don't check it in Statement#reset!
+  * Remove conditional around Bignum statement bindings.
+    Fixes #52. Fixes #56. Thank you Evgeny Myasishchev.
+
+* Internal
+  * Use proper endianness when testing database connection with UTF-16.
+    Fixes #40. Fixes #51
+  * Use -fPIC for static compilation when host is x86_64.
+
+=== 1.3.4 / 2011-07-25
+
+* Enhancements:
+  * Windows: build against SQLite 3.7.7.1
+  * Windows: build static binaries that do not depend on sqlite3.dll be
+    installed anymore
+
+* Bugfixes
+  * Backup API is conditionaly required so that older libsqlite3 can be used.
+    Thanks Hongli Lai.
+  * Fixed segmentation fault when nil is passed to SQLite3::Statement.new
+  * Fix extconf's hardcoded path that affected installation on certain systems.
+
+=== 1.3.3 / 2010-01-16
+
+* Bugfixes
+  * Abort on installation if sqlite3_backup_init is missing. Fixes #19
+  * Gem has been renamed to 'sqlite3'.  Please use `gem install sqlite3`
+
+=== 1.3.2 / 2010-10-30 / RubyConf Uruguay Edition!
+
+* Enhancements:
+  * Windows: build against 3.7.3 version of SQLite3
+  * SQLite3::Database can now be open as readonly
+
+      db = SQLite3::Database.new('my.db', :readonly => true)
+
+  * Added SQLite3::SQLITE_VERSION and SQLite3::SQLITE_VERSION_NUMBER [nurse]
+
+* Bugfixes
+  * type_translation= works along with Database#execute and a block
+  * defined functions are kept in a hash to prevent GC. #7
+  * Removed GCC specific flags from extconf.
+
+* DEPRECATIONS
+  * SQLite3::Database#type_translation= will be deprecated in the future with
+    no replacement.
+  * SQlite3::Version will be deprecated in 2.0.0 with SQLite3::VERSION as the
+    replacement.
+
+=== 1.3.1 / 2010-07-09
+
+* Enhancements
+  * Custom collations may be defined using SQLite3::Database#collation
+
+* Bugfixes
+  * Statements returning 0 columns are automatically stepped. [RF #28308]
+  * SQLite3::Database#encoding works on 1.8 and 1.9
+
+=== 1.3.0 / 2010-06-06
+
+* Enhancements
+  * Complete rewrite of C-based adapter from SWIG to hand-crafted one [tenderlove]
+    See API_CHANGES document for details.
+    This closes: Bug #27300, Bug #27241, Patch #16020
+  * Improved UTF, Unicode, M17N, all that handling and proper BLOB handling [tenderlove, nurse]
+  * Added support for type translations [tenderlove]
+
+      @db.translator.add_translator('sometime') do |type, thing|
+        'output' # this will be returned as value for that column
+      end
+
+* Experimental
+  * Added API to access and load extensions. [kashif]
+    These functions maps directly into SQLite3 own enable_load_extension()
+    and load_extension() C-API functions. See SQLite3::Database API documentation for details.
+    This closes: Patches #9178
+
+* Bugfixes
+  * Corrected gem dependencies (runtime and development)
+  * Fixed threaded tests [Alexey Borzenkov]
+  * Removed GitHub gemspec
+  * Fixed "No definition for" warnings from RDoc
+  * Generate zip and tgz files for releases
+  * Added Luis Lavena as gem Author (maintainer)
+  * Prevent mkmf interfere with Mighty Snow Leopard
+  * Allow extension compilation search for common lib paths [kashif]
+    (lookup /usr/local, /opt/local and /usr)
+  * Corrected extension compilation under MSVC [romuloceccon]
+  * Define load_extension functionality based on availability [tenderlove]
+  * Deprecation notices for Database#query. Fixes RF #28192
+
+=== 1.3.0.beta.2 / 2010-05-15
+
+* Enhancements
+  * Added support for type translations [tenderlove]
+
+      @db.translator.add_translator('sometime') do |type, thing|
+        'output' # this will be returned as value for that column
+      end
+
+* Bugfixes
+  * Allow extension compilation search for common lib paths [kashif]
+    (lookup /usr/local, /opt/local and /usr)
+  * Corrected extension compilation under MSVC [romuloceccon]
+  * Define load_extension functionality based on availability [tenderlove]
+  * Deprecation notices for Database#query. Fixes RF #28192
+
+=== 1.3.0.beta.1 / 2010-05-10
+
+* Enhancements
+  * Complete rewrite of C-based adapter from SWIG to hand-crafted one [tenderlove]
+    See API_CHANGES document for details.
+    This closes: Bug #27300, Bug #27241, Patch #16020
+  * Improved UTF, Unicode, M17N, all that handling and proper BLOB handling [tenderlove, nurse]
+
+* Experimental
+  * Added API to access and load extensions. [kashif]
+    These functions maps directly into SQLite3 own enable_load_extension()
+    and load_extension() C-API functions. See SQLite3::Database API documentation for details.
+    This closes: Patches #9178
+
+* Bugfixes
+  * Corrected gem dependencies (runtime and development)
+  * Fixed threaded tests [Alexey Borzenkov]
+  * Removed GitHub gemspec
+  * Fixed "No definition for" warnings from RDoc
+  * Generate zip and tgz files for releases
+  * Added Luis Lavena as gem Author (maintainer)
+  * Prevent mkmf interfere with Mighty Snow Leopard
+
+=== 1.2.5 / 25 Jul 2009
+
+* Check for illegal nil before executing SQL [Erik Veenstra]
+* Switch to Hoe for gem task management and packaging.
+* Advertise rake-compiler as development dependency.
+* Build gem binaries for Windows.
+* Improved Ruby 1.9 support compatibility.
+* Taint returned values. Patch #20325.
+* Database.open and Database.new now take an optional block [Gerrit Kaiser]
+
+
+=== 1.2.4.1 (internal) / 5 Jul 2009
+
+* Check for illegal nil before executing SQL [Erik Veenstra]
+* Switch to Hoe for gem task management and packaging.
+* Advertise rake-compiler as development dependency.
+* Build gem binaries for Windows.
+* Improved Ruby 1.9 support compatibility.
+
+
+=== 1.2.4 / 27 Aug 2008
+
+* Package the updated C file for source builds. [Jamis Buck]
+
+
+=== 1.2.3 / 26 Aug 2008
+
+* Fix incorrect permissions on database.rb and translator.rb [Various]
+
+* Avoid using Object#extend for greater speedups [Erik Veenstra]
+
+* Ruby 1.9 compatibility tweaks for Array#zip [jimmy88@gmail.com]
+
+* Fix linking against Ruby 1.8.5 [Rob Holland <rob@inversepath.com>]
+
+
+=== 1.2.2 / 31 May 2008
+
+* Make the table_info method adjust the returned default value for the rows
+  so that the sqlite3 change in 3.3.8 and greater can be handled
+  transparently [Jamis Buck <jamis@37signals.com>]
+
+* Ruby 1.9 compatibility tweaks [Roman Le Negrate <roman2k@free.fr>]
+
+* Various performance enhancements [thanks Erik Veenstra]
+
+* Correct busy_handler documentation [Rob Holland <rob@inversepath.com>]
+
+* Use int_bind64 on Fixnum values larger than a 32bit C int can take. [Rob Holland <rob@inversepath.com>]
+
+* Work around a quirk in SQLite's error reporting by calling sqlite3_reset
+  to produce a more informative error code upon a failure from
+  sqlite3_step. [Rob Holland <rob@inversepath.com>]
+
+* Various documentation, test, and style tweaks [Rob Holland <rob@inversepath.com>]
+
+* Be more granular with time/data translation [Rob Holland <rob@inversepath.com>]
+
+* Use Date directly for parsing rather than going via Time [Rob Holland <rob@inversepath.com>]
+
+* Check for the rt library and fdatasync so we link against that when
+  needed [Rob Holland <rob@inversepath.com>]
+
+* Rename data structures to avoid collision on win32. based on patch
+  by: Luis Lavena [Rob Holland <rob@inversepath.com>]
+
+* Add test for defaults [Daniel Rodríguez Troitiño]
+
+* Correctly unquote double-quoted pragma defaults [Łukasz Dargiewicz <lukasz.dargiewicz@gmail.com>]

data/ChangeLog.cvs

@@ -0,0 +1,88 @@
+2005-01-05 09:40  minam
+
+	* Rakefile, sqlite3-ruby-win32.gemspec, sqlite3-ruby.gemspec: Added
+	  win32 gem.
+
+2005-01-05 07:31  minam
+
+	* Rakefile, test/tc_integration.rb, test/tests.rb: Added
+	  native-vs-dl benchmark to Rakefile. Added SQLITE3_DRIVERS
+	  environment variable to integration test to specify which
+	  driver(s) should be tested (defaults to "Native").
+
+2005-01-04 14:26  minam
+
+	* ext/sqlite3_api/sqlite3_api.i, lib/sqlite3/database.rb,
+	  lib/sqlite3/driver/native/driver.rb, test/tc_database.rb,
+	  test/tc_integration.rb, test/tests.rb: Unit tests: done. Bugs:
+	  fixed.
+
+2005-01-03 23:13  minam
+
+	* ext/sqlite3_api/sqlite3_api.i, lib/sqlite3/database.rb,
+	  lib/sqlite3/driver/dl/driver.rb,
+	  lib/sqlite3/driver/native/driver.rb, test/tc_integration.rb:
+	  Custom functions (aggregate and otherwise) are supported by the
+	  native driver now. Test cases for the same.
+
+2005-01-03 13:51  minam
+
+	* ext/sqlite3_api/MANIFEST, ext/sqlite3_api/extconf.rb,
+	  ext/sqlite3_api/post-clean.rb, ext/sqlite3_api/post-distclean.rb,
+	  ext/sqlite3_api/sqlite3_api.i, lib/sqlite3/database.rb,
+	  lib/sqlite3/resultset.rb, lib/sqlite3/version.rb,
+	  lib/sqlite3/driver/dl/driver.rb,
+	  lib/sqlite3/driver/native/driver.rb, test/native-vs-dl.rb,
+	  test/tc_integration.rb: Added preliminary implementation of
+	  native driver (swig-based), and integration tests.
+
+2004-12-29 19:37  minam
+
+	* lib/sqlite3/driver/dl/driver.rb: Some fixes to allow the DL
+	  driver to work with Ruby 1.8.1.
+
+2004-12-29 14:52  minam
+
+	* lib/sqlite3/: database.rb, version.rb: Made #quote a class method
+	  (again). Bumped version to 0.6.
+
+2004-12-25 22:59  minam
+
+	* lib/sqlite3/driver/dl/api.rb: Added check for darwin in supported
+	  platforms (thanks to bitsweat).
+
+2004-12-22 12:38  minam
+
+	* Rakefile: Rakefile wasn't packaging the README file.
+
+2004-12-21 22:28  minam
+
+	* Rakefile, sqlite3-ruby.gemspec, test/bm.rb: Packaging now works.
+	  Added benchmarks.
+
+2004-12-21 21:45  minam
+
+	* LICENSE, README, Rakefile, setup.rb, sqlite3-ruby.gemspec,
+	  doc/faq/faq.rb, doc/faq/faq.yml, lib/sqlite3.rb,
+	  lib/sqlite3/statement.rb, lib/sqlite3/constants.rb,
+	  lib/sqlite3/database.rb, lib/sqlite3/resultset.rb,
+	  lib/sqlite3/translator.rb, lib/sqlite3/value.rb,
+	  lib/sqlite3/version.rb, lib/sqlite3/errors.rb,
+	  lib/sqlite3/pragmas.rb, lib/sqlite3/driver/dl/api.rb,
+	  lib/sqlite3/driver/dl/driver.rb, test/mocks.rb,
+	  test/tc_database.rb, test/tests.rb, test/driver/dl/tc_driver.rb:
+	  Initial import
+
+2004-12-21 21:45  minam
+
+	* LICENSE, README, Rakefile, setup.rb, sqlite3-ruby.gemspec,
+	  doc/faq/faq.rb, doc/faq/faq.yml, lib/sqlite3.rb,
+	  lib/sqlite3/statement.rb, lib/sqlite3/constants.rb,
+	  lib/sqlite3/database.rb, lib/sqlite3/resultset.rb,
+	  lib/sqlite3/translator.rb, lib/sqlite3/value.rb,
+	  lib/sqlite3/version.rb, lib/sqlite3/errors.rb,
+	  lib/sqlite3/pragmas.rb, lib/sqlite3/driver/dl/api.rb,
+	  lib/sqlite3/driver/dl/driver.rb, test/mocks.rb,
+	  test/tc_database.rb, test/tests.rb, test/driver/dl/tc_driver.rb:
+	  Initial revision
+

data/LICENSE

@@ -0,0 +1,27 @@
+Copyright (c) 2004, Jamis Buck (jamis@jamisbuck.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:
+
+    * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+
+    * 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.
+
+    * The names of its contributors may not be used to endorse or promote
+      products derived from this software without specific prior written
+      permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "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 COPYRIGHT OWNER OR CONTRIBUTORS 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/Manifest.txt

@@ -0,0 +1,50 @@
+API_CHANGES.rdoc
+CHANGELOG.rdoc
+ChangeLog.cvs
+LICENSE
+Manifest.txt
+README.rdoc
+Rakefile
+ext/sqlite3/backup.c
+ext/sqlite3/backup.h
+ext/sqlite3/database.c
+ext/sqlite3/database.h
+ext/sqlite3/exception.c
+ext/sqlite3/exception.h
+ext/sqlite3/extconf.rb
+ext/sqlite3/sqlite3.c
+ext/sqlite3/sqlite3_ruby.h
+ext/sqlite3/statement.c
+ext/sqlite3/statement.h
+faq/faq.rb
+faq/faq.yml
+lib/sqlite3.rb
+lib/sqlite3/constants.rb
+lib/sqlite3/database.rb
+lib/sqlite3/errors.rb
+lib/sqlite3/pragmas.rb
+lib/sqlite3/resultset.rb
+lib/sqlite3/statement.rb
+lib/sqlite3/translator.rb
+lib/sqlite3/value.rb
+lib/sqlite3/version.rb
+setup.rb
+tasks/faq.rake
+tasks/gem.rake
+tasks/native.rake
+tasks/vendor_sqlite3.rake
+test/helper.rb
+test/test_backup.rb
+test/test_collation.rb
+test/test_database.rb
+test/test_database_readonly.rb
+test/test_deprecated.rb
+test/test_encoding.rb
+test/test_integration.rb
+test/test_integration_open_close.rb
+test/test_integration_pending.rb
+test/test_integration_resultset.rb
+test/test_integration_statement.rb
+test/test_sqlite3.rb
+test/test_statement.rb
+test/test_statement_execute.rb