amalgalite 0.1.0

data/spec/paths_spec.rb

@@ -0,0 +1,28 @@
+require File.expand_path(File.join(File.dirname(__FILE__),"spec_helper.rb"))
+
+describe Amalgalite::Paths do
+  before(:each) do
+    @root_dir = File.expand_path(File.join(File.dirname(__FILE__), ".."))
+    @root_dir += "/"
+  end
+
+  it "root dir should be correct" do
+    Amalgalite::Paths.root_dir.should == @root_dir
+  end
+
+  it "config_path should be correct" do
+    Amalgalite::Paths.config_path.should == File.join(@root_dir, "config/")
+  end
+
+  it "data path should be correct" do
+    Amalgalite::Paths.data_path.should == File.join(@root_dir, "data/")
+  end
+
+  it "lib path should be correct" do
+    Amalgalite::Paths.lib_path.should == File.join(@root_dir, "lib/")
+  end
+
+  it "ext path should be correct" do
+    Amalgalite::Paths.ext_path.should == File.join(@root_dir, "ext/")
+  end
+end

data/spec/schema_spec.rb

@@ -0,0 +1,46 @@
+require 'rubygems'
+require 'spec'
+
+$: << File.expand_path(File.join(File.dirname(__FILE__),"..","lib"))
+require 'amalgalite'
+require 'amalgalite/schema'
+
+describe Amalgalite::Schema do
+  before(:each) do
+    @schema = IO.read( SpecInfo.test_schema_file )
+    @iso_db_file = SpecInfo.make_iso_db
+    @iso_db = Amalgalite::Database.new( SpecInfo.make_iso_db )
+  end
+
+  after(:each) do
+    File.unlink SpecInfo.test_db if File.exist?( SpecInfo.test_db )
+    @iso_db.close
+    File.unlink @iso_db_file if File.exist?( @iso_db_file )
+  end
+
+  it "loads the schema of a database" do
+    schema = @iso_db.schema
+    schema.tables.size.should == 2
+  end
+
+  it "loads the views in the database" do
+    sql = "CREATE VIEW v1 AS SELECT c.name, c.two_letter, s.name, s.subdivision FROM country AS c JOIN subcountry AS s ON c.two_letter = s.country"
+    @iso_db.execute( sql )
+    @iso_db.schema.views.size.should == 1
+    @iso_db.schema.views["v1"].sql.should == sql
+  end
+
+  it "loads the tables and columns" do
+    @iso_db.schema.tables.size.should == 2
+    ct = @iso_db.schema.tables['country']
+    ct.name.should == "country"
+    ct.columns.size.should == 3
+    ct.indexes.size.should == 2
+
+    ct.columns['two_letter'].should be_primary_key
+    ct.columns['name'].should_not be_nullable
+    ct.columns['name'].should be_not_null_constraint
+    ct.columns['name'].should_not be_has_default_value
+    ct.columns['id'].should_not be_auto_increment
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,25 @@
+require 'rubygems'
+require 'spec'
+
+$: << File.expand_path(File.join(File.dirname(__FILE__),"..","lib"))
+require 'amalgalite'
+
+class SpecInfo
+  class << self
+    def test_db
+      @test_db ||=  File.expand_path(File.join(File.dirname(__FILE__), "test.db"))
+    end
+
+    def test_schema_file
+      @test_schema_file ||= File.expand_path(File.join(File.dirname(__FILE__),"iso-3166-schema.sql"))
+    end
+
+    def make_iso_db
+      @iso_db ||= File.expand_path(File.join(File.dirname(__FILE__), "iso-3166.db"))
+      @new_is_db =  File.expand_path(File.join(File.dirname(__FILE__), "iso-3166-testing.db"))
+      FileUtils.cp @iso_db, @new_is_db
+      return @new_is_db
+    end
+  end
+end
+

data/spec/sqlite3/constants_spec.rb

@@ -0,0 +1,25 @@
+require File.expand_path(File.join(File.dirname(__FILE__),%w[ .. spec_helper.rb ]))
+
+require 'amalgalite/sqlite3/constants'
+
+describe Amalgalite::SQLite3::Constants do
+
+  it "has Open constants" do
+    Amalgalite::SQLite3::Constants::Open::READONLY.should > 0
+  end
+  
+  it "has DataType constants" do
+    Amalgalite::SQLite3::Constants::DataType::BLOB.should > 0
+  end
+
+  it "has ResultCode constants" do
+    Amalgalite::SQLite3::Constants::ResultCode::OK.should == 0
+  end
+
+  it "can return the constant from a number" do
+    c = Amalgalite::SQLite3::Constants::ResultCode.from_int( 21 )
+    c.should == "MISUSE"
+  end
+
+
+end

data/spec/sqlite3/version_spec.rb

@@ -0,0 +1,14 @@
+require File.expand_path(File.join(File.dirname(__FILE__),"..","spec_helper.rb"))
+require 'amalgalite/sqlite3/version'
+
+describe "Amalgalite::SQLite3::Version" do
+  it "should have the sqlite3 version" do
+    Amalgalite::SQLite3::VERSION.should =~ /\d\.\d\.\d/
+    Amalgalite::SQLite3::Version.to_s.should =~ /\d\.\d\.\d/
+    Amalgalite::SQLite3::Version.to_i.should == 3005009
+    Amalgalite::SQLite3::Version::MAJOR.should == 3
+    Amalgalite::SQLite3::Version::MINOR.should == 5
+    Amalgalite::SQLite3::Version::RELEASE.should == 9
+    Amalgalite::SQLite3::Version.to_a.should have(3).items
+  end
+end

data/spec/sqlite3_spec.rb

@@ -0,0 +1,34 @@
+require File.expand_path(File.join(File.dirname(__FILE__),"spec_helper.rb"))
+require 'amalgalite/sqlite3'
+
+describe "Amalgalite::SQLite3" do
+  it "says if SQLite3 is in threadsafe mode or not" do
+    Amalgalite::SQLite3.threadsafe?.should == true
+  end
+
+  it "knows if an SQL statement is complete" do
+    Amalgalite::SQLite3.complete?("SELECT * FROM sometable;").should == true
+    Amalgalite::SQLite3.complete?("SELECT * FROM sometable;", :utf16 => true).should == true
+  end
+  
+  it "knows if an SQL statement is not complete" do
+    Amalgalite::SQLite3.complete?("SELECT * FROM sometable ").should == false
+    Amalgalite::SQLite3.complete?("SELECT * FROM sometable WHERE ", :utf16 => true).should == false
+  end
+
+  it "knows how much memory it has used" do
+    Amalgalite::SQLite3.memory_used.should >= 0
+  end
+  
+  it "knows the maximum amount of memory it has used so far" do
+    Amalgalite::SQLite3.memory_highwater_mark.should >= 0
+  end
+  
+  it "can reset it maximum memory usage counter" do
+    Amalgalite::SQLite3.memory_highwater_mark_reset!.should >= 0
+  end
+
+  it "can produce random data" do
+    Amalgalite::SQLite3.randomness( 42 ).size.should == 42
+  end
+end

data/spec/statement_spec.rb

@@ -0,0 +1,116 @@
+require 'rubygems'
+require 'spec'
+
+$: << File.expand_path(File.join(File.dirname(__FILE__),"..","lib"))
+require 'amalgalite'
+
+describe Amalgalite::Statement do
+  before(:each) do
+    @db = Amalgalite::Database.new( SpecInfo.test_db )
+    @schema_sql = IO.read( SpecInfo.test_schema_file )
+    @iso_db_file = SpecInfo.make_iso_db
+    @iso_db = Amalgalite::Database.new( SpecInfo.make_iso_db )
+  end
+
+  after(:each) do
+    @db.close
+    File.unlink SpecInfo.test_db if File.exist?( SpecInfo.test_db )
+    
+    @iso_db.close
+    File.unlink @iso_db_file if File.exist?( @iso_db_file )
+  end
+
+  it "a statement has a copy of the sql it was prepared with" do
+    stmt = @db.prepare( "SELECT strftime('%Y-%m-%d %H:%M:%S', 'now')")
+    stmt.sql.should == "SELECT strftime('%Y-%m-%d %H:%M:%S', 'now')"
+    stmt.close
+  end
+
+  it "steps through results" do
+    now = Time.new.utc.strftime("%Y-%m-%d %H:%M")
+    @db.prepare( "SELECT strftime('%Y-%m-%d %H:%M', 'now') as now") do |stmt|
+      stmt.should_not == nil
+      stmt.each do |row|
+        row['now'].should == now
+      end
+    end
+  end
+
+  it "can prepare a statement without a block" do
+    stmt = @iso_db.prepare("SELECT * FROM country WHERE two_letter = :two") 
+    rs = stmt.execute( ":two" => "JP" )
+    rs.size.should == 1
+    stmt.close
+  end
+
+  it "knows how many parameters are in the statement" do
+    @iso_db.prepare("SELECT * FROM country WHERE two_letter = :two") do |stmt|
+      stmt.check_parameter_count!( 1 ).should == 1
+    end
+  end
+
+  it "raises an error if there are not enough parameters are passed in a statement" do
+    @iso_db.prepare("SELECT * FROM country WHERE two_letter = :two") do |stmt|
+      lambda{ stmt.execute }.should raise_error( Amalgalite::Error )
+    end
+  end
+
+
+  it "can run a query with a named parameter" do
+    @iso_db.prepare("SELECT * FROM country WHERE two_letter = :two") do |stmt|
+      all_rows = stmt.execute( ":two" => "JP" )
+      all_rows.size.should == 1
+      all_rows.first['name'].should == "Japan"
+    end
+  end
+
+  it "it can execute a query with a named parameter and yield the rows" do 
+    @iso_db.prepare("SELECT * FROM country WHERE id = @id ORDER BY name") do |stmt|
+      rows = []
+      stmt.execute( "@id" => 891 ) do |row|
+        rows << row
+      end
+      rows.size.should == 2
+      rows.last['name'].should == "Yugoslavia"
+      rows.first['two_letter'].should == "CS"
+    end
+  end
+
+  it "binds a integer variable correctly" do
+    @iso_db.prepare("SELECT * FROM country WHERE id = ? ORDER BY name ") do |stmt|
+      all_rows = stmt.execute( 891 )
+      all_rows.size.should == 2
+      all_rows.last['name'].should == "Yugoslavia"
+      all_rows.first['two_letter'].should == "CS"
+    end
+  end
+
+  it "raises and error if an invaliding binding is attempted" do 
+    @iso_db.prepare("SELECT * FROM country WHERE id = :somevar ORDER BY name ") do |stmt|
+      lambda{ stmt.execute( "blah" => 42 ) }.should raise_error(Amalgalite::Error)
+    end
+  end
+
+  it "can reset the statement to the state it was before executing" do
+    stmt = @iso_db.prepare("SELECT * FROM country WHERE id = :somevar ORDER BY name ") 
+    stmt.reset_and_clear_bindings!
+    stmt.close
+  end
+
+  it "can execute a single sql command and say if there is remaining sql to execute" do
+    db = Amalgalite::Database.new( SpecInfo.test_db )
+    stmt = @db.prepare( @schema_sql )
+    stmt.execute
+    stmt.remaining_sql.size.should > 0
+    stmt.close
+  end
+
+  it "has index based access to the result set" do
+    @iso_db.prepare("SELECT * FROM country WHERE id = ? ORDER BY name ") do |stmt|
+      all_rows = stmt.execute( 891 )
+      all_rows.size.should == 2
+      all_rows.last.first.should == "Yugoslavia"
+      all_rows.first[1].should == "CS"
+    end
+  end
+end

data/spec/storage_map_spec.rb

@@ -0,0 +1,41 @@
+require 'rubygems'
+require 'spec'
+
+$: << File.expand_path(File.join(File.dirname(__FILE__),"..","lib"))
+require 'amalgalite/type_maps/storage_map'
+
+describe Amalgalite::TypeMaps::StorageMap do
+  before(:each) do
+    @map = Amalgalite::TypeMaps::StorageMap.new
+  end
+
+  describe "#bind_type_of" do
+
+    it "Float is bound to DataType::FLOAT" do
+      @map.bind_type_of( 3.14 ).should == ::Amalgalite::SQLite3::Constants::DataType::FLOAT
+    end
+
+    it "Fixnum is bound to DataType::INTGER" do
+      @map.bind_type_of( 42 ).should == ::Amalgalite::SQLite3::Constants::DataType::INTEGER
+    end
+
+    it "nil is bound to DataType::NULL" do
+      @map.bind_type_of( nil ).should == ::Amalgalite::SQLite3::Constants::DataType::NULL
+    end
+
+    it "::Amalgalite::Blob is bound to DataType::BLOB" do
+      @map.bind_type_of( ::Amalgalite::Blob.new ).should == ::Amalgalite::SQLite3::Constants::DataType::BLOB
+    end
+
+    it "everything else is bound to DataType::TEXT" do
+      @map.bind_type_of( "everything else" ).should == ::Amalgalite::SQLite3::Constants::DataType::TEXT
+    end
+
+  end
+
+  describe "#result_value_of" do
+    it "returns the original object for everything passed in" do
+      @map.result_value_of( "doesn't matter", 42 ).should == 42
+    end
+  end
+end

data/spec/tap_spec.rb

@@ -0,0 +1,59 @@
+require 'rubygems'
+require 'spec'
+
+$: << File.expand_path(File.join(File.dirname(__FILE__),"..","lib"))
+require 'amalgalite'
+require 'amalgalite/trace_tap'
+require 'amalgalite/profile_tap'
+require 'amalgalite/taps/console'
+require 'stringio'
+
+describe Amalgalite::TraceTap do
+  it "wraps up an object and delegates the 'trace' method to a method on that object" do
+    s = StringIO.new
+    tt = ::Amalgalite::TraceTap.new( s, 'puts' )
+    tt.trace('test trace')
+    s.string.should == "test trace\n"
+  end
+  
+  it "raises an error if an the wrapped object does not respond to the indicated method"  do
+    lambda{ ::Amalgalite::TraceTap.new( Object.new ) }.should raise_error( Amalgalite::Error )
+  end
+end
+
+describe Amalgalite::ProfileTap do
+  it "raises an error if an the wrapped object does not respond to the indicated method"  do
+    lambda{ ::Amalgalite::ProfileTap.new( Object.new ) }.should raise_error( Amalgalite::Error )
+  end
+end
+
+describe Amalgalite::Taps::StringIO do
+  it "dumps profile information" do
+    s = ::Amalgalite::Taps::StringIO.new
+    s.profile( 'test', 42 )
+    s.dump_profile
+    s.string.should == "42 : test\ntest[test] => sum: 42, sumsq: 1764, n: 1, mean: 42.000000, stddev: 0.000000, min: 42, max: 42\n"
+  end
+
+  it "has a stdout tap" do
+    s = ::Amalgalite::Taps::Stdout.new
+  end
+  
+  it "has a stderr tap" do
+    s = ::Amalgalite::Taps::Stderr.new
+  end
+end
+
+describe Amalgalite::ProfileSampler do
+  it "aggregates samples" do
+    s = Amalgalite::ProfileSampler.new( 'test1' )
+    s.sample( 42 )
+    s.sample( 84 )
+    s.sample( 21 )
+    h = s.to_h
+    h['min'].should == 21
+    h['max'].should == 84
+    h['mean'].should == 49
+    h['n'].should == 3
+  end
+end

data/spec/text_map_spec.rb

@@ -0,0 +1,23 @@
+require 'rubygems'
+require 'spec'
+
+$: << File.expand_path(File.join(File.dirname(__FILE__),"..","lib"))
+require 'amalgalite/type_maps/text_map'
+
+describe Amalgalite::TypeMaps::TextMap do
+  before(:each) do
+    @map = Amalgalite::TypeMaps::TextMap.new
+  end
+
+  describe "#bind_type_of" do
+    it "returnes text for everything" do
+      @map.bind_type_of( 3.14 ).should == ::Amalgalite::SQLite3::Constants::DataType::TEXT
+    end
+  end
+
+  describe "#result_value_of" do
+    it "returns the string value of the object for everything passed in" do
+      @map.result_value_of( "doesn't matter", 42 ).should == "42"
+    end
+  end
+end

data/spec/type_map_spec.rb

@@ -0,0 +1,17 @@
+require 'rubygems'
+require 'spec'
+
+$: << File.expand_path(File.join(File.dirname(__FILE__),"..","lib"))
+require 'amalgalite/type_map'
+
+describe Amalgalite::TypeMap do
+  it "#bind_type_of raises NotImplemented error" do
+    tm = Amalgalite::TypeMap.new
+    lambda { tm.bind_type_of( Object.new ) }.should raise_error( NotImplementedError )
+  end
+
+  it "#result_value_of raises NotImplemented error" do
+    tm = Amalgalite::TypeMap.new
+    lambda { tm.result_value_of( "foo", Object.new ) }.should raise_error( NotImplementedError )
+  end
+end

data/spec/version_spec.rb

@@ -0,0 +1,9 @@
+require File.expand_path(File.join(File.dirname(__FILE__),"spec_helper.rb"))
+require 'amalgalite/version'
+
+describe "Amalgalite::Version" do
+  it "should have a version string" do
+    Amalgalite::Version.to_s.should =~ /\d+\.\d+\.\d+/
+    Amalgalite::VERSION.should =~ /\d+\.\d+\.\d+/
+  end
+end