sqlite3 1.4.2 → 1.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ff35addc187325a243e752d17c9f38ac54ea4a5b8a48c4809c4dd91692f1f94d
-  data.tar.gz: c9c22fc4b4a091197b12ae09c13d199c2fcd5f8c836944bf04f50be919d32f8a
+  metadata.gz: 14940fe0b1e0cb9f9d1ea85675d7c31c814418e1dbaa5503d20b7c6979817780
+  data.tar.gz: 270770317eb93285810b1b5cb9572467bdf8869a63bc1b4e78b0bfcc54e69a73
 SHA512:
-  metadata.gz: 68c1c1233ff73049b7c1ff1e0bbeec883bc90228182bd090564ff4df2b9f37fe92e4e9333a374306ba7fcdd10b0b2f914c4116dff0c34ef5c2e964f9342de986
-  data.tar.gz: 698263b49e7efa9a3c06220d71e617657fdf31b8e8097a9e2278b5ca3a5fbbb3468b2492fa51670345a3756b4760169d2b79681fac523144166f99253f1e40f3
+  metadata.gz: d8fa16a98f024f558784bad14add322bd979c86a159ad51603633311fbcca7da8bbae559465dfef082d2a7867c8de6e56b7e7311cb23e18ab53976f71e89f96d
+  data.tar.gz: 82639bbe8d90f333d7f4bc2ca29beb0f235125b868418159d1f8c13d8f62735e3ff8a4edae9e38f963f2e252c8afea615227121f8fc71e5ebcb25968adc0ff7a

data/{API_CHANGES.rdoc → API_CHANGES.md}

@@ -1,4 +1,4 @@
-= API Changes
+# API Changes
 
 * SQLite3::Database#execute only accepts an array for bind parameters.
 
@@ -8,7 +8,7 @@
   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
@@ -30,7 +30,7 @@
 * test/test_tc_database.rb was removed because we no longer use the Driver
   design pattern.
 
-= Garbage Collection Strategy
+# Garbage Collection Strategy
 
 All statements keep pointers back to their respective database connections.
 The @connection instance variable on the Statement handle keeps the database
@@ -47,4 +47,3 @@ 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.md

@@ -0,0 +1,446 @@
+# sqlite3-ruby Changelog
+
+## 1.5.1 / 2022-09-29
+
+### Dependencies
+
+* Vendored sqlite is updated to [v3.39.4](https://sqlite.org/releaselog/3_39_4.html).
+
+### Security
+
+The vendored version of sqlite, v3.39.4, should be considered to be a security release. From the release notes:
+
+> Version 3.39.4 is a minimal patch against the prior release that addresses issues found since the
+> prior release. In particular, a potential vulnerability in the FTS3 extension has been fixed, so
+> this should be considered a security update.
+>
+> In order to exploit the vulnerability, an attacker must have full SQL access and must be able to
+> construct a corrupt database with over 2GB of FTS3 content. The problem arises from a 32-bit
+> signed integer overflow.
+
+For more information please see [GHSA-mgvv-5mxp-xq67](https://github.com/sparklemotion/sqlite3-ruby/security/advisories/GHSA-mgvv-5mxp-xq67).
+
+
+## 1.5.0 / 2022-09-08
+
+### Packaging
+
+#### Faster, more reliable installation
+
+Native (precompiled) gems are available for Ruby 2.6, 2.7, 3.0, and 3.1 on all these platforms:
+
+- `aarch64-linux`
+- `arm-linux`
+- `arm64-darwin`
+- `x64-mingw32` and `x64-mingw-ucrt`
+- `x86-linux`
+- `x86_64-darwin`
+- `x86_64-linux`
+
+If you are using one of these Ruby versions on one of these platforms, the native gem is the recommended way to install sqlite3-ruby.
+
+See [the README](https://github.com/sparklemotion/sqlite3-ruby#native-gems-recommended) for more information.
+
+
+#### More consistent developer experience
+
+Both the native (precompiled) gems and the vanilla "ruby platform" (source) gem include sqlite v3.39.3 by default.
+
+Defaulting to a consistent version of sqlite across all systems means that your development environment behaves exactly like your production environment, and you have access to the latest and greatest features of sqlite.
+
+You can opt-out of the packaged version of sqlite (and use your system-installed library as in versions < 1.5.0). See [the README](https://github.com/sparklemotion/sqlite3-ruby#avoiding-the-precompiled-native-gem) for more information.
+
+[Release notes for this version of sqlite](https://sqlite.org/releaselog/3_39_3.html)
+
+
+### Rubies and Platforms
+
+* TruffleRuby is supported.
+* Apple Silicon is supported (M1, arm64-darwin).
+* vcpkg system libraries supported. [#332] (Thanks, @MSP-Greg!)
+
+
+### Added
+
+* `SQLite3::SQLITE_LOADED_VERSION` contains the version string of the sqlite3 library that is dynamically loaded (compare to `SQLite3::SQLITE_VERSION` which is the version at compile-time).
+
+
+### Fixed
+
+* `SQLite3::Database#load_extensions` now raises a `TypeError` unless a String is passed as the file path. Previously it was possible to pass a non-string and cause a segfault. [#339]
+
+
+## 1.4.4 / 2022-06-14
+
+### Fixes
+
+* Compilation no longer fails against SQLite3 versions < 3.29.0. This issue was introduced in v1.4.3. [#324] (Thank you, @r6e!)
+
+
+## 1.4.3 / 2022-05-25
+
+### Enhancements
+
+* Disable non-standard support for double-quoted string literals via the `:strict` option. [#317] (Thank you, @casperisfine!)
+* Column type names are now explicitly downcased on platforms where they may have been in shoutcaps. [#315] (Thank you, @petergoldstein!)
+* Support File or Pathname arguments to `Database.new`. [#283] (Thank you, @yb66!)
+* Support building on MSVC. [#285] (Thank you, @jmarrec!)
+
+
+## 1.4.2 / 2019-12-18
+
+* Travis: Drop unused setting "sudo: false"
+* The taint mechanism will be deprecated in Ruby 2.7
+* Fix Ruby 2.7 rb_check_safe_obj warnings
+* Update travis config
+
+
+## 1.4.1
+
+* Don't mandate dl functions for the extention build
+* bumping version
+
+
+## 1.4.0
+
+### Enhancements
+
+* Better aggregator support
+
+### Bugfixes
+
+* Various
+
+
+## 1.3.13
+
+### Enhancements
+
+* Support SQLite flags when defining functions
+* Add definition for SQLITE_DETERMINISTIC flag
+
+
+## 1.3.12
+
+### Bugfixes
+
+* OS X install will default to homebrew if available. Fixes #195
+
+
+## 1.3.11 / 2015-10-10
+
+### Enhancements
+
+* Windows: build against SQLite 3.8.11.1
+
+### Internal
+
+* Use rake-compiler-dock to build Windows binaries. Pull #159 [larskanis]
+* Expand Ruby versions being tested for Travis and AppVeyor
+
+
+## 1.3.10 / 2014-10-30
+
+### Enhancements
+
+* Windows: build against SQLite 3.8.6. Closes #135 [Hubro]
+
+
+## 1.3.9 / 2014-02-25
+
+### Bugfixes
+
+* Reset exception message. Closes #80
+* Reduce warnings due unused pointers. Closes #89
+* Add BSD-3 license reference to gemspec. Refs #99 and #106
+
+
+## 1.3.8 / 2013-08-17
+
+### Enhancements
+
+* Windows: build against SQLite 3.7.17
+
+### Bugfixes
+
+* Reset exception message. Closes #80
+* Correctly convert BLOB values to Ruby. Closes #65
+* Add MIT license reference to gemspec. Closes #99
+* Remove unused pointer. Closes #89
+
+### Internal
+
+* Backport improvements in cross compilation for Windows
+* Use of Minitest for internal tests
+* Use Gemfile (generated by Hoe) to deal with dependencies
+* Cleanup Travis CI
+
+
+## 1.3.7 / 2013-01-11
+
+### Bugfixes
+
+* Closing a bad statement twice will not segv.
+* Aggregate handlers are initialized on each query. Closes #44
+
+### Internal
+
+* Unset environment variables that could affect cross compilation.
+
+
+## 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 conditionally 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 / 2009-07-25
+
+* 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) / 2009-07-05
+
+* 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 / 2008-08-27
+
+* Package the updated C file for source builds. [Jamis Buck]
+
+
+## 1.2.3 / 2008-08-26
+
+* 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 / 2008-05-31
+
+* 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/CONTRIBUTING.md

@@ -0,0 +1,24 @@
+# Contributing to sqlite3-ruby
+
+**This document is a work-in-progress.**
+
+This doc is a short introduction on how to modify and maintain the sqlite3-ruby gem.
+
+
+## Building gems
+
+As a prerequisite please make sure you have `docker` correctly installed, so that you're able to cross-compile the native gems.
+
+Run `bin/build-gems` which will package gems for all supported platforms, and run some basic sanity tests on those packages using `bin/test-gem-set` and `bin/test-gem-file-contents`.
+
+
+## Making a release
+
+A quick checklist:
+
+- [ ] make sure CI is green!
+- [ ] update `CHANGELOG.md` and `lib/sqlite3/version.rb` including `VersionProxy::{MINOR,TINY}`
+- [ ] create a git tag using a format that matches the pattern `v\d+\.\d+\.\d+`, e.g. `v1.3.13`
+- [ ] run `bin/build-gems` and make sure it completes and all the tests pass
+- [ ] `for g in gems/*.gem ; do gem push $g ; done`
+- [ ] create a release at https://github.com/sparklemotion/sqlite3-ruby/releases and include sha2 checksums

data/Gemfile

@@ -1,17 +1,3 @@
-# -*- ruby -*-
+source "https://rubygems.org"
 
-# DO NOT EDIT THIS FILE. Instead, edit Rakefile, and run `rake bundler:gemfile`.
-
-source "https://rubygems.org/"
-
-
-gem "minitest", "~>5.11", :group => [:development, :test]
-gem "rake-compiler", "~>1.0", :group => [:development, :test]
-gem "rake-compiler-dock", "~>0.6.0", :group => [:development, :test]
-gem "mini_portile", "~>0.6.2", :group => [:development, :test]
-gem "hoe-bundler", "~>1.0", :group => [:development, :test]
-gem "hoe-gemspec", "~>1.0", :group => [:development, :test]
-gem "rdoc", ">=4.0", "<6", :group => [:development, :test]
-gem "hoe", "~>3.17", :group => [:development, :test]
-
-# vim: syntax=ruby
+gemspec

data/LICENSE-DEPENDENCIES

@@ -0,0 +1,20 @@
+# Vendored Dependency Licenses
+
+The library `sqlite3-ruby` (which lives at https://github.com/sparklemotion/sqlite3-ruby) may include the source code for `sqlite` (which lives at https://www.sqlite.org/)
+
+`sqlite` source code is licensed under the public domain:
+
+> https://www.sqlite.org/copyright.html
+
+The license terms shipped with `sqlite` are included here for your convenience:
+
+```
+The author disclaims copyright to this source code.  In place of
+a legal notice, here is a blessing:
+
+    May you do good and not evil.
+    May you find forgiveness for yourself and forgive others.
+    May you share freely, never taking more than you give.
+```
+
+Note that these license terms do not apply to the `sqlite3-ruby` library itself.