amalgalite 0.10.1-x86-mswin32

data/HISTORY

@@ -0,0 +1,201 @@
+= Amalgalite Changelog
+== Version 0.10.1 - 2009-08-01
+
+* Add version subdirectory for extension on all platforms for building locally
+  on gem install.
+* Small documentation change for Amalgalite::Database#new
+* Add gem for x86-ming32 platform  
+* Add specs to validate the R*Tree index is compiled correctly
+
+== Version 0.10.0 - 2009-06-28
+
+=== Enhancements 
+
+* windows gem is now a fat binary to support installing into ruby 1.8 and 1.9 
+  from the same gem
+* Update to Sqlite 3.6.16 and fix errors returned by define_aggregate and 
+  define_function based upon update
+
+== Version 0.9.0 - 2009-04-05
+
+=== Enhancements
+
+* Ruby 1.9 compatibility
+* Update to SQLite 3.6.12
+* Added support for the new SQLite Backup API, see Amalgalite::Database#replicate_to
+* Added exclusive/immediate/deferred transaction helpers
+
+== Version 0.8.0 - 2009-03-23
+
+=== Enhancements
+
+* Add in support for obtaining limited schema information on temporary tables
+  and indexes
+* Add support for returning the primary key columns of a table
+* Other miscellaneous items to support the ActiveRecord adapter
+
+== Version 0.7.7 - 2009-03-03
+
+=== Bug Fixes
+
+* roll back to SQLite 3.6.10 because of substr() bug in 3.6.11
+
+== Version 0.7.6 - 2009-03-02
+
+=== Enhancements
+
+* Update to SQLite 3.6.11
+
+=== Bug Fixes
+
+* fix issues with the wrong error message appearing in statement closing
+* incorrectly raise an exception if a transaction is started when rescuing an
+  exception [reported by James Edwared Gray II]
+
+== Version 0.7.5 - 2009-02-12
+
+=== Bug Fixes
+
+* another ruby -w pass to clear up warnings
+* force all tests to run with -w turned on
+
+== Version 0.7.4 - 2009-02-08
+
+=== Bug Fixes
+
+* fix Database#first_row_from not behaving the same as Database#execute() when
+  there are no results. [reported by James Edward Gray II]
+
+== Version 0.7.3 - 2009-02-08
+
+=== Enhancements
+
+* added Database#first_row_from
+* added Database#first_value_from
+
+=== Bug Fixes
+
+* clean up ruby warnings when run with -w
+* fix documenation on Database#execute
+
+== Version 0.7.2 - 2009-01-24
+=== Enhancements
+
+* added quoting and escaping of text support, used for database drivers
+* added ability to access columns of the schame in original definition order
+
+== Version 0.7.1 - 2009-01-18
+
+=== Enhancements
+
+* added support for sqlite's nexted transactions which appeared in sqlite
+* update to SQLite version 3.6.10
+* added ability to set the SQLite temporary directory
+* added amalgalite-pack --require-order
+
+=== Bug Fixes
+
+* fix exception when accessing the special 'rowid' column
+* fix internal require order list for use in packing
+
+== Version 0.6.0 - 2009-01-10
+
+=== Enhancements
+
+* Added ability to define custom SQL functions implemented in Ruby
+* Added ability to define custom SQL aggregates implemented in Ruby
+* Added support for Ruby busy handlers
+* Added database 'interrupt' support
+* Added support for Ruby progress handlers
+* update to SQLite version 3.6.7
+
+== Version 0.5.1 - 2008-11-30
+
+=== Enhancements
+
+* update to SQLite version 3.6.6.2
+
+== Version 0.5.0 - 2008-11-16
+
+=== Enhancements
+
+* amalgalite-pack-into-db has been reworked into amalgalite-pack
+* ruby code that is packed into a database for later requiring can now be
+  compressed
+* update to SQLite version 3.6.5
+
+== Version 0.4.2 - 2008-10-12
+
+=== Enhancements
+
+* release of windows gem
+
+== Version 0.4.1 - 2008-09-28
+
+=== Enhancements
+
+* update to SQLite3 version 3.6.3
+* change rdoc template to darkfish
+
+== Version 0.4.0 - 2008-09-14
+
+=== Enhancements
+* update to SQLite3 version 3.6.2 and enable the RTree option by default
+* Amalgalite::Requires module allowing ruby code to be 'required' from columns in an SQLite database
+* Amagalite::Requires::Bootstrap extension module enabling low level boot
+  strapping of the pure ruby Amalgalite code from an sqlite database
+* more indepth information about indexes is available via the Index class
+* add support for sqlite3_status and sqlite3_db_status information
+
+=== Bugfixes
+
+* fix nil exception when using a declared_data_type on primary key column that
+  has no declared_data_type
+* when Database#transaction is passed a block, the return value is the return
+  value of the block
+* nested transactions are 'faked'.  Calling Database#transaction while
+  Databased#in_transaction? is true does not result in an exception, but
+  continues on in the current transaction.  
+* raise LoadError if required in the same program as sqlite3-ruby.  These
+  libraries conflict with each other.
+
+== Version 0.2.4 - 2008-07-13
+
+===  Bugfixes
+* fix compilation when ruby is compiled without pthreads using 
+
+== Version 0.2.3 - 2008-07-12
+
+=== Bugfixes
+* make sure file permissions are all read before shipping gem
+
+== Version 0.2.2 - 2008-07-12
+
+=== Bugfixes
+* Database#pragma should accept a block just like Database#execute does
+* convert to using extconf.rb instead of mkrf to enable compilation as a
+  direct ruby extension in the ruby source tree
+
+== Version 0.2.1 - 2008-07-05
+
+=== Bugfixes
+* make sure that the pthread support in sqlite3 matches that of ruby
+* fix schema reloading in the example scripts
+
+== Version 0.2.0 - 2008-07-04
+
+=== Enhancements
+* blob support, both incremental access and normal access
+* added examples/gem_db.rb script demonstrating taps and prepared statements
+* added examples/schema-info.rb script demonstrating meta information
+* added examples/blob.rb demonstrating incremental blob IO
+* added access to the SQLite3 errcode and errmsg api
+
+=== Bugfixes
+* added taps.rb for requiring
+* fixed prepared statement reset
+* caught an error in executing prepared statements earlier in the process so the correct error is reported
+
+== Version 0.1.0 - 2008-06-21
+
+* Initial public release

data/LICENSE

@@ -0,0 +1,29 @@
+Copyright (c) 2008, Jeremy Hinegardner
+
+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.  
+      
+* Neither the name of Jeremy Hinegardner nor the names of its contributors 
+  may 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/README

@@ -0,0 +1,51 @@
+== Amalgalite
+
+* Homepage[http://copiousfreetime.rubyforge.org/amalgalite]
+* {Rubyforge Project}[http://rubyforge.org/projects/copiousfreetime/]
+* email jeremy at copiousfreetime dot org
+* git clone url git://github.com/copiousfreetime/amalgalite.git
+
+== Articles
+
+*  {Writing SQL Functions in Ruby}[http://copiousfreetime.org/articles/2009/01/10/writing-sql-functions-in-ruby.html]
+
+== INSTALL
+
+* gem install amalgalite
+
+== DESCRIPTION
+
+Amalgalite embeds the SQLite database engine in a ruby extension.  There is no
+need to install SQLite separately.  
+
+Look in the examples/ directory to see
+
+* general usage
+* blob io
+* schema information
+* custom functions
+* custom aggregates
+* requiring ruby code from a database
+
+Also Scroll through Amalgalite::Database for a quick example, and a general
+overview of the API.
+
+Amalgalite adds in the following additional non-default SQLite extension(s):
+
+* {R*Tree index extension}[http://sqlite.org/rtree.html]
+
+== CREDITS
+
+* Jamis Buck for the first {ruby sqlite implementation}[http://www.rubyforge.org/projects/sqlite-ruby]
+
+== CHANGES
+
+Read the HISTORY file.
+
+== LICENSE
+
+Copyright (c) 2008 Jeremy Hinegardner
+
+All rights reserved.
+
+See LICENSE and/or COPYING for details.

data/bin/amalgalite-pack

@@ -0,0 +1,126 @@
+#!/usr/bin/env ruby
+require 'optparse'
+require 'pathname'
+require 'rubygems'
+
+#
+# add relative paths to the load path if we are not a gem and calculate what the
+# strip path will be if we decide to pack --self
+#
+this_path  = Pathname.new( File.expand_path( __FILE__ ) )
+gem_path   = Pathname.new( Gem.dir )
+rel_path   = this_path.relative_path_from( gem_path )
+if  ".." == rel_path.to_s.split( File::SEPARATOR ).first then
+  lib_path = File.join( File.dirname( __FILE__ ), "../lib" )
+  $:.unshift lib_path
+  $:.unshift File.join( File.dirname( __FILE__ ), "../ext" )
+end
+
+# 
+# snapshot of what is needed for amalgalite requires, this info may only be used
+# when packing amalgalite itself
+#
+loaded_features_before = $LOADED_FEATURES.dup
+require 'amalgalite/packer'
+loaded_features_after  = $LOADED_FEATURES.dup
+amalgalite_needs = loaded_features_after - loaded_features_before
+
+#
+# Commandline parser
+#
+options = {}
+begin
+  parser = OptionParser.new do |op|
+    op.banner  = "Usage: #{op.program_name} [options] <files>"
+    op.separator ""
+
+    op.on("--dbfile DB", "The Database file in which to pack files") do |d|
+      options[:dbfile] = d
+    end
+
+    op.on("--drop-table", "Drop the table before inserting rows") do |t|
+      options[:drop_table] = t
+    end
+
+    op.on("-m", "--merge", "Merge these files into the existing table overwriting rows that conflict") do |m|
+      options[:merge] = true
+    end
+
+    op.on("--require-order", "Dump Amalgalite's require order" ) do |m|
+      puts amalgalite_needs
+      exit 0
+    end
+
+    op.on("--self", "pack amalgalite itself into the database") do |d|
+      options[:self] = true
+    end
+
+    op.on("--strip-prefix PREFIX", "strip this path prefix off the front of each file") do |p|
+      options[:strip_prefix] = File.expand_path( p )
+    end
+
+    op.on("-t", "--table TABLE", "the table name to pack into") do |t|
+      options[:table_name] = t
+    end
+
+    op.on("--verbose", "Be verbose about output") do |v|
+      options[:verbose] = v
+    end
+
+    op.on("-z", "--compressed", "compress the file contents on storage") do |z|
+      options[:compressed] = true
+    end
+
+  end
+
+  parser.parse!
+  require 'amalgalite/packer'
+  file_list = ARGV.dup
+
+  
+  if options[:self] then
+    options[:table_name] = Amalgalite::Requires::Bootstrap::DEFAULT_BOOTSTRAP_TABLE
+    core_libs = (amalgalite_needs - Amalgalite::Packer.amalgalite_require_order).delete_if { |l| l.index(".rb").nil? }
+
+    #
+    # check and make sure nothing is missed
+    #
+    core_libs.each do |l| 
+      if l.index("malgalite") then
+        STDERR.puts "ERROR!  require_order needs an update #{l}" 
+        exit 2
+      end
+    end
+    file_list = core_libs.concat( Amalgalite::Packer.amalgalite_require_order )
+    if options[:compressed] then
+      STDERR.puts "Compressing --self is not allowed, reverting to uncompressed"
+      options[:compressed] = false
+    end
+  end
+  STDERR.puts parser if file_list.empty?
+
+  packer = Amalgalite::Packer.new( options )
+  packer.pack( file_list )
+
+rescue OptionParser::ParseError => pe
+  STDERR.puts "ERROR : #{pe}"
+  STDERR.puts parser
+  exit 1
+end
+
+__END__
+
+puts <<-text
+
+Packing complete.  To utilize the bootstrapping in #{dbfile} you must do
+one of the following:
+
+  * statically compile the amalgalite C extension into your application
+  * require 'amalgalite/amalgalite3'
+
+Once one of those is working you can boostrap the Amalgalite library with
+this line in your code:
+
+  Amalgalite::Requries::Boostrap.lift( 'dbfile' => '#{dbfile}' )
+
+text

data/examples/a.rb

@@ -0,0 +1,9 @@
+class A
+  def initialize 
+    puts "Initialized A"
+  end
+
+  def a
+    puts "called a"
+  end
+end

data/examples/blob.rb

@@ -0,0 +1,88 @@
+#!/usr/bin/env ruby
+
+#
+# An Amalgalite example showing how Blob's can be utilized
+#
+# We'll make a database with one table, that we store files in.  We'll use the
+# Blob incremental IO to store the files and retrieve them from the database
+#
+# This little program will store 1 or more files in the sqlite3 database when
+# the 'store' action is given, and cat a file to stdout on 'retrieve'
+#
+# e.g.
+#
+#   ruby blob.rb store a.rb b.rb c.rb # => stores a.rb b.rb and c.rb in the db
+#
+#   ruby blob.rb retrieve a.rb        # => dumps a.rb to stdout
+#
+
+require 'rubygems'
+$: << "../lib"
+$: << "../ext"
+require 'amalgalite'
+require 'amalgalite/packer'
+VALID_ACTIONS = %w[ list retrieve store ]
+def usage 
+  STDERR.puts "Usage: #{File.basename($0)} ( #{VALID_ACTIONS.join(' | ')} )  file(s)"
+  exit 1
+end
+
+#
+# This does the basic command line parsing
+#
+usage if ARGV.size < 1
+action    = ARGV.shift
+usage unless VALID_ACTIONS.include? action 
+file_list = ARGV
+
+#
+# create the database if it doesn't exist
+#
+db = Amalgalite::Database.new( "filestore.db" )
+
+case action
+  #
+  # list all the files that are stored in the database
+  #
+when 'list'
+  db.execute("SELECT filename FROM rubylibs") do |row|
+    puts row['filename']
+  end
+
+  #
+  # if we are doing the store action, then loop over the files and store them in
+  # the database.  This will use incremental IO to store the files directly from
+  # the file names. 
+  #
+  # It is slightly strange in that you have to tell the Blob object what column
+  # it is going to, but that is necessary at this point to be able to hook
+  # automatically into the lower level incremental blob IO api.
+  #
+  # This also shows using the $var syntax for binding name sql values in a
+  # prepared statement.
+  #
+when 'store'
+  usage if file_list.empty?
+  require 'amalgalite/packer'
+
+  packer = Amalgalite::Packer.new( :dbfile => 'filestore.db',
+                                   :compressed => false )
+  packer.pack( file_list )
+
+  #
+  # dump the file that matches the right path to stdout.  This also shows
+  # positional sql varible binding using the '?' syntax.
+  #
+when 'retrieve'
+  usage if file_list.empty?
+  db.execute("SELECT id, compressed, filename, contents FROM rubylibs WHERE filename = ?", file_list.first) do |row|
+    STDERR.puts "Dumping #{row['filename']} to stdout"
+    if row['compressed'] then
+      s = row['contents'].to_s
+      STDOUT.puts Amalgalite::Packer.gunzip( s )
+    else
+      row['contents'].write_to_io( STDOUT )
+    end
+  end
+end
+db.close