rdo-sqlite 0.0.1

data/spec/sqlite/driver_spec.rb

@@ -0,0 +1,279 @@
+require "spec_helper"
+require "uri"
+
+describe RDO::SQLite::Driver do
+  let(:options) { connection_uri }
+  let(:db)      { RDO.open(options) }
+
+  after(:each) { db.close rescue nil }
+
+  describe "#initialize" do
+    context "with a relative path to a database" do
+      let(:path)   { "./tmp/test.db" }
+      let(:options) { "sqlite:#{path}" }
+
+      before(:each) { File.delete(path) if File.exist?(path) }
+      after(:each)  { File.delete(path) if File.exist?(path) }
+
+      it "opens a database file" do
+        db.should be_open
+      end
+
+      it "creates the database file" do
+        db
+        File.should exist(path)
+      end
+    end
+
+    context "with an absolute path to a database" do
+      let(:path)   { "/tmp/test.db" }
+      let(:options) { "sqlite:#{path}" }
+
+      before(:each) { File.delete(path) if File.exist?(path) }
+      after(:each)  { File.delete(path) if File.exist?(path) }
+
+      it "opens a database file" do
+        db.should be_open
+      end
+
+      it "creates the database file" do
+        db
+        File.should exist(path)
+      end
+    end
+
+    context "with an in-memory database" do
+      let(:options) { "sqlite::memory:" }
+
+      it "opens a database in memory" do
+        db.should be_open
+      end
+    end
+
+    context "with a temporary file database" do
+      let(:options) { "sqlite:" }
+
+      it "opens a database file" do
+        db.should be_open
+      end
+    end
+
+    context "with an unusable path" do
+      let(:options) { "sqlite:/some/bad/path/to/a.db" }
+
+      it "raises an RDO::Exception" do
+        expect { db }.to raise_error(RDO::Exception)
+      end
+
+      it "provides a meaningful error message" do
+        begin
+          db && fail("RDO::Exception should be raised")
+        rescue RDO::Exception =>e
+          e.message.should =~ /sqlite.*file/i
+        end
+      end
+    end
+  end
+
+  describe "#close" do
+    it "closes the database" do
+      db.close
+      db.should_not be_open
+    end
+
+    it "returns true" do
+      db.close.should == true
+    end
+
+    context "called multiple times" do
+      it "has no negative side-effects" do
+        5.times { db.close }
+        db.should_not be_open
+      end
+    end
+  end
+
+  describe "#open" do
+    it "opens the database" do
+      db.close && db.open
+      db.should be_open
+    end
+
+    it "returns true" do
+      db.close
+      db.open.should == true
+    end
+
+    context "called multiple times" do
+      it "has no negative side-effects" do
+        db.close
+        5.times { db.open }
+        db.should be_open
+      end
+    end
+  end
+
+  describe "#execute" do
+    let(:options) { "sqlite::memory:" }
+
+    before(:each) do
+      db.execute <<-SQL
+      CREATE TABLE test (
+        id   INTEGER PRIMARY KEY AUTOINCREMENT,
+        name VARCHAR(32),
+        age  INTEGER
+      )
+      SQL
+    end
+
+    context "with a bad query" do
+      let(:result) { db.execute("SELECT * FROM bad_table") }
+
+      it "raises an RDO::Exception" do
+        expect { result }.to raise_error(RDO::Exception)
+      end
+
+      it "provides a meaningful error message" do
+        begin
+          result && fail("RDO::Exception should be raised")
+        rescue RDO::Exception => e
+          e.message.should =~ /bad_table/
+        end
+      end
+    end
+
+    context "with an insert" do
+      let(:result) { db.execute("INSERT INTO test (name, age) VALUES ('bob', 12)") }
+
+      it "returns a RDO::Result" do
+        result.should be_a_kind_of(RDO::Result)
+      end
+
+      it "provides the #insert_id" do
+        result.insert_id.should == 1
+      end
+
+      context "using bind parameters" do
+        let(:result) { db.execute("INSERT INTO test (name, age) VALUES (?, ?)", "bob", 12) }
+
+        it "returns a RDO::Result" do
+          result.should be_a_kind_of(RDO::Result)
+        end
+
+        it "provides the #insert_id" do
+          result.insert_id.should == 1
+        end
+      end
+    end
+
+    context "with a select" do
+      before(:each) do
+        db.execute("INSERT INTO test (name, age) VALUES ('bob', 12)")
+        db.execute("INSERT INTO test (name, age) VALUES ('jane', 23)")
+      end
+
+      let(:result) { db.execute("SELECT * FROM test") }
+
+      it "returns a RDO::Result" do
+        result.should be_a_kind_of(RDO::Result)
+      end
+
+      it "provides the #count" do
+        result.count.should == 2
+      end
+
+      it "allows enumeration of the rows" do
+        rows = []
+        result.each {|row| rows << row}
+        rows.should == [{id: 1, name: "bob", age: 12}, {id: 2, name: "jane", age: 23}]
+      end
+
+      context "using bind parameters" do
+        let(:result) { db.execute("SELECT * FROM test WHERE name = ?", "bob") }
+
+        it "returns a RDO::Result" do
+          result.should be_a_kind_of(RDO::Result)
+        end
+
+        it "provides the #count" do
+          result.count.should == 1
+        end
+
+        it "allows enumeration of the rows" do
+          rows = []
+          result.each {|row| rows << row}
+          rows.should == [{id: 1, name: "bob", age: 12}]
+        end
+      end
+    end
+
+    context "with an update" do
+      before(:each) do
+        db.execute("INSERT INTO test (name, age) VALUES ('bob', 12)")
+        db.execute("INSERT INTO test (name, age) VALUES ('jane', 23)")
+      end
+
+      let(:result) { db.execute("UPDATE test SET age = age + 3") }
+
+      it "returns a RDO::Result" do
+        result.should be_a_kind_of(RDO::Result)
+      end
+
+      it "provides the number of #affected_rows" do
+        result.affected_rows.should == 2
+      end
+
+      context "using bind parameters" do
+        let(:result) { db.execute("UPDATE test SET age = age + ?", 2) }
+
+        it "returns a RDO::Result" do
+          result.should be_a_kind_of(RDO::Result)
+        end
+
+        it "provides the #affected_rows" do
+          result.affected_rows.should == 2
+        end
+      end
+    end
+  end
+
+  describe "#prepare" do
+    before(:each) do
+      db.execute("CREATE TABLE test (id integer primary key, name text, age integer)")
+    end
+
+    it "creates a RDO::Statement" do
+      db.prepare("INSERT INTO test (name, age) VALUES (?, ?)").should be_a_kind_of(RDO::Statement)
+    end
+
+    context "when executed" do
+      let(:stmt) { db.prepare("INSERT INTO test (name, age) VALUES (?, ?)") }
+
+      it "returns a RDO::Result" do
+        stmt.execute("bob", 27).should be_a_kind_of(RDO::Result)
+      end
+
+      context "multiple times" do
+        before(:each) do
+          stmt.execute("bob", 27)
+          stmt.execute("jim", 19)
+        end
+
+        it "returns a Result for each execution" do
+          stmt2 = db.prepare("SELECT * FROM test WHERE name = ?")
+          result1 = stmt2.execute("bob")
+          result2 = stmt2.execute("jim")
+
+          result1.first[:age].should == 27
+          result2.first[:age].should == 19
+        end
+      end
+    end
+  end
+
+  describe "#quote" do
+    it "returns a value safe to insert into SQL" do
+      db.quote("That's a quote!").should == "That''s a quote!"
+    end
+  end
+end

data/spec/sqlite/type_cast_spec.rb

@@ -0,0 +1,48 @@
+require "spec_helper"
+
+describe RDO::SQLite::Driver, "type casting" do
+  let(:options) { "sqlite::memory:" }
+  let(:db)      { RDO.open(options) }
+
+  after(:each) { db.close rescue nil }
+
+  describe "null cast" do
+    let(:value) { db.execute("SELECT NULL").first_value }
+
+    it "returns nil" do
+      value.should be_nil
+    end
+  end
+
+  describe "text cast" do
+    let(:value) { db.execute("SELECT CAST(42 AS TEXT)").first_value }
+
+    it "returns a String" do
+      value.should == "42"
+    end
+  end
+
+  describe "integer cast" do
+    let(:value) { db.execute("SELECT CAST('57' AS INTEGER)").first_value }
+
+    it "returns a Fixnum" do
+      value.should == 57
+    end
+  end
+
+  describe "float cast" do
+    let(:value) { db.execute("SELECT CAST('56.4' AS FLOAT)").first_value }
+
+    it "returns a Float" do
+      value.should == 56.4
+    end
+  end
+
+  describe "blob cast" do
+    let(:value) { db.execute("SELECT CAST(x'001122' AS BLOB)").first_value }
+
+    it "returns a String" do
+      value.should == "\x00\x11\x22"
+    end
+  end
+end

metadata

@@ -0,0 +1,121 @@
+--- !ruby/object:Gem::Specification
+name: rdo-sqlite
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- d11wtq
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-09-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rdo
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.0.1
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake-compiler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Provides access to SQLite3 using the RDO interface
+email:
+- chris@w3style.co.uk
+executables: []
+extensions:
+- ext/rdo_sqlite/extconf.rb
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- ext/rdo_sqlite/driver.c
+- ext/rdo_sqlite/driver.h
+- ext/rdo_sqlite/extconf.rb
+- ext/rdo_sqlite/macros.h
+- ext/rdo_sqlite/rdo_sqlite.c
+- ext/rdo_sqlite/statements.c
+- ext/rdo_sqlite/statements.h
+- lib/rdo-sqlite.rb
+- lib/rdo/sqlite.rb
+- lib/rdo/sqlite/driver.rb
+- lib/rdo/sqlite/version.rb
+- rdo-sqlite.gemspec
+- spec/spec_helper.rb
+- spec/sqlite/bind_params_spec.rb
+- spec/sqlite/driver_spec.rb
+- spec/sqlite/type_cast_spec.rb
+homepage: https://github.com/d11wtq/rdo-sqlite
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: SQLite3 Driver for RDO
+test_files:
+- spec/spec_helper.rb
+- spec/sqlite/bind_params_spec.rb
+- spec/sqlite/driver_spec.rb
+- spec/sqlite/type_cast_spec.rb
+has_rdoc: