fluiddb2 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7d3233bc931c69ea807e944dd613485b0f10212c
+  data.tar.gz: 3c14618c2e985e2a1e419ebffa298dd05b6afccd
+SHA512:
+  metadata.gz: 96a412a1de13c85d00e0fe36ed6bcb144fff9c9a38bb8a48f7e45592793bb1da83b1f104dea45d4c743bebb2448c4cd4c3cef4ad468046cd4a83c6c03cb01dde
+  data.tar.gz: 3204ac238c68f9a31121de945ae4f5dd3070b0f10732b9deb741623e224c3f5062cbfd64e6cbe62be0be30233600590ac0fde34446275a507380c72073bad799

data/LICENSE

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

data/README.md

@@ -0,0 +1,10 @@
+#Fluid DB
+
+A semantic layer for db interaction
+
+##install
+	gem install fluiddb2
+
+##Examples
+
+See the tests for a reasonable run down on usage.

data/lib/fluiddb2/firebird.rb

@@ -0,0 +1,126 @@
+require 'FluidDb2'
+require 'fb'
+include Fb
+
+module FluidDb2
+  # Firebird
+  class Firebird < Base
+    # Connect to Db.
+    #
+    # @param [String] uri a location for the resource to which we will attach,
+    #  eg mysql://user:pass@127.0.0.1/foo
+    def connect
+      uri = @uri
+
+      user = uri.user || 'sysdba'
+      password = uri.password || 'masterkey'
+      port = uri.port || 3050
+
+      path = uri.path
+      path = path.slice(1, uri.path.length - 1) if path.slice(0, 3) == '/C:'
+      path = URI.unescape(path)
+
+      # The Database class acts as a factory for Connections.
+      # It can also create and drop databases.
+      db = Database.new(:database => "#{uri.host}/#{port}:#{path}",
+                        :username => user,
+                        :password => password)
+      # :database is the only parameter without a default.
+      # Let's connect to the database, creating it if it doesn't already exist.
+      @connection = db.connect rescue db.create.connect
+    end
+
+    def close
+      @connection.close
+    end
+
+    def query_for_array(sql, params = [])
+      sql = format_to_sql(sql, params)
+      list = @connection.query(:hash, sql)
+
+      case list.length
+      when -1
+        fail FluidDb2::ConnectionError
+      when 0
+        fail FluidDb2::NoDataFoundError
+      when 1
+        return list[0]
+      else
+        fail FluidDb2::TooManyRowsError
+      end
+    end
+
+    def query_for_value(sql, params = [])
+      sql = format_to_sql(sql, params)
+      results = @connection.query(sql)
+
+      case results.length
+      when -1
+        fail FluidDb::ConnectionError
+      when 0
+        fail FluidDb::NoDataFoundError
+      when 1
+        return results[0][0]
+      else
+        fail FluidDb::TooManyRowsError
+      end
+    end
+
+    def query_for_resultset(sql, params = [])
+      sql = format_to_sql(sql, params)
+      list = @connection.query(:hash, sql)
+
+      case list.length
+      when -1
+        fail FluidDb::ConnectionError
+      else
+        return list
+      end
+    end
+
+    def execute(sql, params = [], expected_affected_rows = nil)
+      sql = format_to_sql(sql, params)
+      verbose_log "#{self.class.name}.execute. #{sql}"
+      affected_rows = @connection.execute(sql)
+
+      if !expected_affected_rows.nil? && affected_rows != expected_affected_rows
+        fail ExpectedAffectedRowsError,
+              "Expected affected rows, #{expected_affected_rows}, Actual affected rows, #{affected_rows}"
+      end
+    end
+
+    def exec_params(sql, params, expected_affected_rows = nil)
+      parts = sql.split('?')
+      sql = ''
+      parts.each_with_index do |p, idx|
+        sql += p
+        sql += "$#{idx + 1}" if idx < parts.length - 1
+      end
+      affected_rows = @connection.exec_params(sql, params)
+
+      if !expected_affected_rows.nil? && affected_rows != expected_affected_rows
+        fail ExpectedAffectedRowsError,
+             "Expected affected rows, #{expected_affected_rows}, Actual affected rows, #{affected_rows}"
+      end
+    end
+
+    def insert(_sql, _params)
+      fail 'Firebird uses SEQUENCES, so possibly easier to use 2 executes'
+    end
+
+    # Transaction Semantics
+    def begin
+      @connection.transaction
+    end
+
+    # Transaction Semantics
+    def commit
+      @connection.commit
+    end
+
+    # Transaction Semantics
+    def rollback
+      @connection.rollback
+    end
+  end
+end

data/lib/fluiddb2/mock.rb

@@ -0,0 +1,103 @@
+require 'FluidDb2'
+
+module FluidDb2
+  class SqlNotMatchedError < StandardError
+  end
+
+  # A constant way of enabling testing for FluidDb
+  class Mock < Base
+    attr_reader :hash
+
+    def initialize(_uri)
+      @hash = {}
+      @verbose = false
+    end
+
+    def verbose
+      @verbose = true
+      self
+    end
+
+    def connect
+    end
+
+    def close
+    end
+
+    def get_sql_from_hash(sql)
+      fail SqlNotMatchedError, sql unless @hash.key?(sql)
+
+      @hash[sql]
+    end
+
+    def query_for_array(sql, params = [])
+      sql = format_to_sql(sql, params)
+      puts "FluidDb::Mock.query_for_array. sql: #{sql}" if @verbose == true
+
+      results = get_sql_from_hash(sql)
+      case results.length
+      when 0
+        fail FluidDb::NoDataFoundError
+      when 1
+        return results.first
+      else
+        fail FluidDb::TooManyRowsError
+      end
+    end
+
+    def query_for_value(sql, params = [])
+      sql = format_to_sql(sql, params)
+      puts "FluidDb::Mock.queryForValue. sql: #{sql}" if @verbose == true
+
+      results = get_sql_from_hash(sql)
+      case results.length
+      when 0
+        fail FluidDb::NoDataFoundError
+      when 1
+        return results.first.first[1]
+      else
+        fail FluidDb::TooManyRowsError
+      end
+      @hash[sql]
+    end
+
+    def query_for_resultset(sql, params = [])
+      sql = format_to_sql(sql, params)
+      puts "FluidDb::Mock.queryForResultset. sql: #{sql}" if @verbose == true
+      get_sql_from_hash(sql)
+    end
+
+    def execute(sql, params = [], _expected_affected_rows = nil)
+      sql = format_to_sql(sql, params)
+      puts "FluidDb::Mock.execute. sql: #{sql}" if @verbose == true
+      get_sql_from_hash(sql)
+    end
+
+    def insert(_sql, _params)
+      fail 'Mock uses SEQUENCES, so possibly easier to use 2 executes'
+    end
+
+    def add_sql(sql, result)
+      raise TypeError.new( "Expecting an Array of Hashes, eg [{'field1'=>1, 'field2'=>2}]. Note, the Array may be empty" ) unless result.is_a? Array
+
+      @hash[sql] = result
+    end
+
+    def add_sql_with_params(sql, params, result)
+      sql = format_to_sql(sql, params)
+      add_sql(sql, result)
+    end
+
+    # Transaction Semantics
+    def begin
+    end
+
+    # Transaction Semantics
+    def commit
+    end
+
+    # Transaction Semantics
+    def rollback
+    end
+  end
+end

data/lib/fluiddb2/mysql.rb

@@ -0,0 +1,89 @@
+require 'FluidDb2'
+require 'mysql'
+
+module FluidDb2
+  # Mysql
+  class Mysql < Base
+    # Connect to Db.
+    #
+    # @param [String] uri a location for the resource to which we will attach,
+    #  eg mysql://user:pass@127.0.0.1/foo
+    def connect
+      uri = @uri
+      database = uri.path.sub('/', '')
+
+      @connection = ::Mysql.new uri.host, uri.user, uri.password, database, nil, nil, ::Mysql::CLIENT_FOUND_ROWS
+    end
+
+    def close
+      @connection.close
+    end
+
+    def query_for_array(sql, params = [])
+      sql = format_to_sql(sql, params)
+      results = @connection.query(sql)
+
+      case results.num_rows
+      when -1
+        fail FluidDb::ConnectionError
+      when 0
+        fail FluidDb::NoDataFoundError
+      when 1
+        r = results.fetch_hash
+        return r
+      else
+        fail FluidDb::TooManyRowsError
+      end
+    end
+
+    def query_for_value(sql, params = [])
+      sql = format_to_sql(sql, params)
+      results = @connection.query(sql)
+
+      case results.num_rows
+      when -1
+        fail FluidDb::ConnectionError
+      when 0
+        fail FluidDb::NoDataFoundError
+      when 1
+        r = nil
+        results.each do |row|
+          r = row
+        end
+        return r[0]
+      else
+        fail FluidDb::TooManyRowsError
+      end
+    end
+
+    def query_for_resultset(sql, params = [])
+      sql = format_to_sql(sql, params)
+      results = @connection.query(sql)
+
+      case results.num_rows
+      when -1
+        fail FluidDb::ConnectionError
+      else
+        list = []
+        results.each_hash do |row|
+          list.push row
+        end
+        return list
+      end
+    end
+
+    def execute(sql, params = [], expected_affected_rows = nil)
+      sql = format_to_sql(sql, params)
+      @connection.query(sql)
+
+      if !expected_affected_rows.nil? && @connection.affected_rows != expected_affected_rows
+        fail ExpectedAffectedRowsError, "Expected affected rows, #{expected_affected_rows}, Actual affected rows, #{@connection.affected_rows}"
+      end
+    end
+
+    def insert(sql, params)
+      execute(sql, params)
+      @connection.insert_id
+    end
+  end
+end

data/lib/fluiddb2/mysql2.rb

@@ -0,0 +1,92 @@
+require 'FluidDb2'
+require 'mysql2'
+
+module FluidDb2
+  class Mysql2 < Base
+    # Connect to Db.
+    #
+    # @param [String] uri a location for the resource to which we will attach,
+    #  eg mysql://user:pass@127.0.0.1/foo
+    def connect
+      uri = @uri
+      @connection = ::Mysql2::Client.new(:host => uri.host,
+                                         :database => uri.path.sub('/', ''),
+                                         :username => uri.user,
+                                         :flags => ::Mysql2::Client::FOUND_ROWS)
+    end
+
+    def close
+      @connection.close
+    end
+
+    def query_for_array(sql, params = [])
+      sql = format_to_sql(sql, params)
+      results = @connection.query(sql)
+
+      case results.count
+      when -1
+        fail FluidDb::ConnectionError
+      when 0
+        fail FluidDb::NoDataFoundError
+      when 1
+        r = nil
+        results.each do |row|
+          r = row
+        end
+        return r
+      else
+        fail FluidDb::TooManyRowsError
+      end
+    end
+
+    def query_for_value(sql, params = [])
+      sql = format_to_sql(sql, params)
+      results = @connection.query(sql, :as => :array)
+
+      case results.count
+      when -1
+        fail FluidDb::ConnectionError
+      when 0
+        fail FluidDb::NoDataFoundError
+      when 1
+        r = nil
+        results.each do |row|
+          r = row
+        end
+        return r[0]
+      else
+        fail FluidDb::TooManyRowsError
+      end
+    end
+
+    def query_for_resultset(sql, params = [])
+      sql = format_to_sql(sql, params)
+      results = @connection.query(sql)
+
+      case results.count
+      when -1
+        fail FluidDb::ConnectionError
+      else
+        list = []
+        results.each do |row|
+          list.push row
+        end
+        return list
+      end
+    end
+
+    def execute(sql, params = [], expected_affected_rows = nil)
+      sql = format_to_sql(sql, params)
+      @connection.query(sql)
+
+      if !expected_affected_rows.nil? && @connection.affected_rows != expected_affected_rows
+        raise ExpectedAffectedRowsError.new( "Expected affected rows, #{expected_affected_rows}, Actual affected rows, #{@connection.affected_rows}")
+      end
+    end
+
+    def insert(sql, params)
+      execute(sql, params)
+      @connection.last_id
+    end
+  end
+end

data/lib/fluiddb2/pgsql.rb

@@ -0,0 +1,128 @@
+require 'FluidDb2'
+require 'pg'
+
+module FluidDb2
+  # Pgsql
+  class Pgsql < Base
+    # Connect to Db.
+    #
+    # @param [String] uri a location for the resource to which we will attach,
+    #  eg mysql://user:pass@127.0.0.1/foo
+    def connect
+      uri = @uri
+      host = uri.host
+      dbname = uri.path.sub('/', '')
+
+      hash = Hash['host', host, 'dbname', dbname]
+      hash['port'] = uri.port unless uri.port.nil?
+      hash['user'] = uri.user unless uri.user.nil?
+      hash['password'] = uri.password unless uri.password.nil?
+
+      @connection = PG.connect(hash)
+    end
+
+    def close
+      @connection.close
+    end
+
+    def query_for_array(sql, params = [])
+      sql = FluidDb2.format_to_sql(sql, params)
+      results = @connection.exec(sql)
+
+      case results.num_tuples
+      when -1
+        fail FluidDb2::ConnectionError
+      when 0
+        fail FluidDb2::NoDataFoundError
+      when 1
+        return FluidDb2.convert_tuple_to_hash(results.fields, results, 0)
+      else
+        fail FluidDb2::TooManyRowsError
+      end
+    end
+
+    def query_for_value(sql, params = [])
+      sql = FluidDb2.format_to_sql(sql, params)
+      results = @connection.exec(sql)
+
+      case results.num_tuples
+      when -1
+        fail FluidDb2::ConnectionError
+      when 0
+        fail FluidDb2::NoDataFoundError
+      when 1
+        return results.getvalue(0, 0)
+      else
+        fail FluidDb2::TooManyRowsError
+      end
+    end
+
+    def query_for_resultset(sql, params = [])
+      sql = FluidDb2.format_to_sql(sql, params)
+      results = @connection.exec(sql)
+
+      case results.num_tuples
+      when -1
+        fail FluidDb2::ConnectionError
+      else
+        list = []
+        fields = results.fields
+        0.upto(results.ntuples - 1) do |nbr|
+          list.push FluidDb2.convert_tuple_to_hash(fields, results, nbr)
+        end
+
+        return list
+      end
+    end
+
+    def execute(sql, params = [], expected_affected_rows = nil)
+      sql = FluidDb2.format_to_sql(sql, params)
+
+      verbose_log "#{self.class.name}.execute. #{sql}"
+      r = @connection.exec(sql)
+
+      if !expected_affected_rows.nil? && r.cmd_tuples != expected_affected_rows
+        fail ExpectedAffectedRowsError, "Expected affected rows, #{expected_affected_rows}, Actual affected rows, #{r.cmd_tuples}"
+      end
+    rescue PG::Error => e
+      raise DuplicateKeyError(e.message) unless e.message.index('duplicate key value violates unique constraint').nil?
+      raise e
+    end
+
+    def exec_params(sql, params = [], expected_affected_rows = nil)
+      parts = sql.split('?')
+      sql = ''
+      parts.each_with_index do |p, idx|
+        sql += p
+        sql += "$#{idx + 1}" if idx < parts.length - 1
+      end
+      r = @connection.exec_params(sql, params)
+
+      if !expected_affected_rows.nil? and r.cmd_tuples != expected_affected_rows
+        fail ExpectedAffectedRowsError, "Expected affected rows, #{expected_affected_rows}, Actual affected rows, #{r.cmd_tuples}"
+      end
+    rescue PG::Error => e
+      raise DuplicateKeyError(e.message) unless e.message.index("duplicate key value violates unique constraint").nil?
+      raise e
+    end
+
+    # Transaction Semantics
+    def begin
+      @connection.exec('BEGIN', [])
+    end
+
+    # Transaction Semantics
+    def commit
+      @connection.exec('COMMIT', [])
+    end
+
+    # Transaction Semantics
+    def rollback
+      @connection.exec('ROLLBACK', [])
+    end
+
+    def insert(_sql, _params)
+      fail 'Pgsql uses SEQUENCES, so possibly easier to use 2 executes'
+    end
+  end
+end

data/lib/fluiddb2/sqlite.rb

@@ -0,0 +1,111 @@
+require 'FluidDb2'
+require 'sqlite3'
+
+module FluidDb2
+  # SQLite
+  class SQLite < Base
+    # Connect to Db.
+    #
+    # @param [String] uri a location for the resource to which we will attach,
+    #  eg mysql://user:pass@127.0.0.1/foo
+    def connect
+      uri = @uri
+      @connection = SQLite3::Database.new uri.path
+    end
+
+    def close
+      @connection.close
+    end
+
+    def query_for_array(sql, params = [])
+      sql = format_to_sql(sql, params)
+      @connection.results_as_hash = true
+      results = @connection.execute(sql)
+
+      case results.length
+      when -1
+        fail FluidDb::ConnectionError
+      when 0
+        fail FluidDb::NoDataFoundError
+      when 1
+        return results[0]
+      else
+        fail FluidDb::TooManyRowsError
+      end
+    end
+
+    def query_for_value(sql, params = [])
+      sql = format_to_sql(sql, params)
+      @connection.results_as_hash = false
+      results = @connection.execute(sql)
+
+      case results.length
+      when -1
+        fail FluidDb::ConnectionError
+      when 0
+        fail FluidDb::NoDataFoundError
+      when 1
+        return results[0][0]
+      else
+        fail FluidDb::TooManyRowsError
+      end
+    end
+
+    def query_for_resultset(sql, params = [])
+      sql = format_to_sql(sql, params)
+      @connection.results_as_hash = true
+      results = @connection.execute(sql)
+
+      case results.length
+      when -1
+        fail FluidDb::ConnectionError
+      else
+        return results
+      end
+    end
+
+    def execute(sql, params = [], expected_affected_rows = nil)
+      sql = format_to_sql(sql, params)
+
+      verbose_log "#{self.class.name}.execute. #{sql}"
+      r = @connection.execute(sql)
+
+      if !expected_affected_rows.nil? && r.changes != expected_affected_rows
+        fail ExpectedAffectedRowsError, "Expected affected rows, #{expected_affected_rows}, Actual affected rows, #{r.cmd_tuples}"
+      end
+    end
+
+    def exec_params(sql, params = [], expected_affected_rows = nil)
+      parts = sql.split('?')
+      sql = ''
+      parts.each_with_index do |p, idx|
+        sql += p
+        sql += "$#{idx + 1}" if idx < parts.length - 1
+      end
+      r = @connection.exec_params(sql, params)
+
+      if !expected_affected_rows.nil? && r.changes != expected_affected_rows
+        fail ExpectedAffectedRowsError, "Expected affected rows, #{expected_affected_rows}, Actual affected rows, #{r.cmd_tuples}"
+      end
+    end
+
+    # Transaction Semantics
+    def begin
+      @connection.transaction
+    end
+
+    # Transaction Semantics
+    def commit
+      @connection.commit
+    end
+
+    # Transaction Semantics
+    def rollback
+      @connection.rollback
+    end
+
+    def insert(_sql, _params)
+      fail 'SQLite uses SEQUENCES, so possibly easier to use 2 executes'
+    end
+  end
+end

data/lib/fluiddb2/tiny_tds.rb

@@ -0,0 +1,139 @@
+require 'FluidDb2'
+require 'tiny_tds'
+require 'cgi'
+
+module FluidDb2
+  class TinyTds < Base
+
+    # Connect to Db.
+    #
+    # @param [String] uri a location for the resource to which we will attach,
+    #  eg tinytds://<user>:<pass>@<dataserver>/<database>
+    def connect
+      uri = @uri
+
+      dataserver = uri.host
+      database = uri.path.sub('/', '')
+      username = URI.unescape(uri.user)
+      password = uri.password
+
+      if dataserver == '' || database == ''
+        fail '*** You need to specify both a dataserver and a database for ' \
+              'the tinytds driver. Expected format: ' \
+              'tinytds://<user>:<pass>@<dataserver>/<database>\n' \
+              '*** The specified dataserver should have an entry in ' \
+              '/etc/freetds/freetds.conf'
+      end
+
+      if username == '' || password == ''
+        puts '*** Warning - you will normally need to specify both a username ' \
+             'and password for the tinytds driver to work correctly.'
+      end
+
+      hash = Hash[:username, username,
+                  :password, password,
+                  :database, database,
+                  :dataserver, dataserver]
+      fail_over_data_server = nil
+      unless uri.query.nil?
+        cgi = CGI.parse(uri.query)
+        hash[:timeout] = cgi['timeout'][0].to_i if cgi.key?('timeout')
+        if cgi.key?('host')
+          hash.delete(:dataserver)
+          hash[:host] = dataserver
+        end
+
+        fail_over_data_server =
+          cgi['failoverdataserver'][0] if cgi.key?('failoverdataserver')
+      end
+
+      begin
+        @connection = ::TinyTds::Client.new(hash)
+      rescue ::TinyTds::Error => e
+        # Message for an incorrect password,
+        # Login failed. The login is from an untrusted domain and cannot be used
+        #  with Windows authentication.
+        # Message for unavailable db
+        # Cannot open user default database. Login failed.
+        if e.message == 'Cannot open user default database. Login failed.' &&
+           !fail_over_data_server.nil?
+          hash[:dataserver] = fail_over_data_server
+          @connection = ::TinyTds::Client.new(hash)
+        else
+          raise e
+        end
+      end
+
+      fail 'Unable to connect to the database' unless @connection.active?
+    end
+
+    def close
+      @connection.close
+    end
+
+    def escape_string(input)
+      @connection.escape(input)
+    end
+
+    def query_for_array(sql, params = [])
+      sql = format_to_sql(sql, params)
+      results = @connection.execute(sql)
+
+      count = 0
+      tuple = ''
+      results.each do |row|
+        count += 1
+        fail FluidDb2::TooManyRowsError if count > 1
+        tuple = row
+      end
+      fail FluidDb2::NoDataFoundError if count == 0
+      tuple
+    end
+
+    def query_for_value(sql, params = [])
+      sql = format_to_sql(sql, params)
+      results = @connection.execute(sql)
+
+      count = 0
+      value = ''
+      results.each do |row|
+        count += 1
+        fail FluidDb2::TooManyRowsError if count > 1
+        value = row[results.fields[0]]
+      end
+
+      fail FluidDb2::NoDataFoundError if count == 0
+
+      value
+    end
+
+    def query_for_resultset(sql, params = [])
+      sql = format_to_sql(sql, params)
+      results = @connection.execute(sql)
+
+      list = []
+      results.each do |row|
+        list << row
+      end
+
+      list
+    end
+
+    def execute(sql, params = [], expected_affected_rows = nil)
+      sql = format_to_sql(sql, params)
+      r = @connection.execute(sql)
+      r.each
+
+      if !expected_affected_rows.nil? &&
+         r.affected_rows != expected_affected_rows
+        msg = "Expected affected rows, #{expected_affected_rows}, " \
+              "Actual affected rows, #{r.affected_rows}"
+        fail ExpectedAffectedRowsError, msg
+      end
+    end
+
+    def insert(_sql, _params)
+      fail 'Not implemented'
+    end
+  end
+end

data/lib/fluiddb2.rb

@@ -0,0 +1,210 @@
+require 'date'
+require 'time'
+require 'uri'
+
+require 'fluiddb/db'
+
+# FluidDb2
+module FluidDb2
+  class ConnectionError < StandardError
+  end
+  class NoDataFoundError < StandardError
+  end
+  class TooManyRowsError < StandardError
+  end
+  class ParamTypeNotSupportedError < StandardError
+  end
+  class ExpectedAffectedRowsError < StandardError
+  end
+  class IncorrectNumberOfParametersError < StandardError
+  end
+  class DuplicateKeyError < StandardError
+  end
+
+  def self.db(uri)
+    uri = URI.parse(uri) if uri.is_a? String
+
+    case uri.scheme
+    when 'mysql'
+      require 'fluiddb2/mysql'
+      return FluidDb2::Mysql.new(uri)
+    when 'mysql2'
+      require 'fluiddb2/mysql2'
+      return FluidDb2::Mysql2.new(uri)
+    when 'pgsql'
+      require 'fluiddb2/pgsql'
+      return FluidDb2::Pgsql.new(uri)
+    when 'fb'
+      require 'fluiddb2/firebird'
+      return FluidDb2::Firebird.new(uri)
+    when 'mock'
+      require 'fluiddb2/Mock'
+      return FluidDb2::Mock.new(uri)
+    when 'tinytds'
+      require 'fluiddb2/tiny_tds'
+      return FluidDb2::TinyTds.new(uri)
+    when 'sqlite'
+      require 'fluiddb2/sqlite'
+      return FluidDb2::SQLite.new(uri)
+    else
+      abort("Scheme, #{uri.scheme}, not recognised when configuring creating " \
+             'db connection')
+    end
+  end
+
+  def self.splice_sql(sql, params)
+    fail IncorrectNumberOfParametersError if params.length != sql.count('?')
+
+    sql_out = ''
+    sql.split('?').each_with_index do |s, idx|
+      sql_out += s
+      sql_out += params[idx] unless params[idx].nil?
+    end
+
+    sql_out
+  end
+
+  def self.escape_string(input)
+    input.split("'").join("''")
+  end
+
+  def self.format_to_sql(sql, params = nil)
+    return sql if params.nil? || params.count == 0
+
+    params.each_with_index do |v, idx|
+      if v.is_a? String
+        v = "'#{escape_string(v)}'"
+      elsif v.is_a? DateTime
+        v = "'" + v.strftime('%Y-%m-%d %H:%M:%S.%6N %z') + "'"
+      elsif v.is_a? Time
+        v = "'" + v.strftime('%Y-%m-%d %H:%M:%S.%6N %z') + "'"
+      elsif v.is_a? Date
+        v = "'#{v}'"
+      elsif v.is_a? Numeric
+        v = v.to_s
+      elsif v.is_a? TrueClass
+        v = 'true'
+      elsif v.is_a? FalseClass
+        v = 'false'
+      elsif v.nil?
+        v = 'NULL'
+      else
+        fail ParamTypeNotSupportedError,
+             "Name of unknown param type, #{v.class.name}, for sql, #{sql}"
+      end
+      params[idx] = v
+    end
+
+    sql_out = splice_sql(sql, params)
+    if @verbose == true
+      puts self.class.name
+      puts sql
+      puts params.join(',')
+      puts sql_out
+    end
+
+    sql_out
+  end
+
+  def self.convert_tuple_to_hash(fields, tuple, j)
+    hash = {}
+    0.upto(fields.length - 1).each do |i|
+      hash[fields[i].to_s] = tuple.getvalue(j, i)
+    end
+
+    hash
+  end
+
+  # Base
+  class Base
+    attr_writer :verbose
+    attr_reader :connection
+
+    # Constructor.
+    #
+    # @param [String] uri a location for the resource to which we will attach,
+    #  eg mysql://user:pass@127.0.0.1/foo
+    def initialize(uri)
+      if uri.is_a? String
+        @uri = URI.parse(uri)
+      else
+        @uri = uri
+      end
+
+      connect
+
+      @verbose = !ENV['VERBOSE'].nil?
+    end
+
+    def verbose_log(string)
+      puts string if @verbose == true
+    end
+
+    def connect
+      fail NotImplementedError, "You must implement 'connect'."
+    end
+
+    def close
+      fail NotImplementedError, "You must implement 'close'."
+    end
+
+    def reconnect
+      close
+      connect
+    end
+
+    # Return a single row from the database, given the sql parameter.
+    # Throws an error for no data.
+    # Throws an error for more than 1 row
+    #
+    # @param [String] sql The SELECT statement to run
+    # @param [Array] parama The parameters to be added to the sql query. Ruby
+    #  types are used to determine formatting and escaping.
+    def query_for_array(_sql, _params)
+      fail NotImplementedError, "You must implement 'queryForArray'."
+    end
+
+    # Return a single value is returned from a single row from the database,
+    #  given the sql parameter.
+    # Throws an error for no data.
+    # Throws an error for more than 1 row
+    #
+    # @param [String] sql The SELECT statement to run
+    # @param [Array] parama The parameters to be added to the sql query. Ruby
+    #  types are used to determine formatting and escaping.
+    def query_for_value(_sql, _params)
+      fail NotImplementedError, "You must implement 'queryForValue'."
+    end
+
+    def query_for_resultset(_sql, _params)
+      fail NotImplementedError, "You must implement 'queryForResultset'."
+    end
+
+    # Execute an insert, update or delete, then check the impact that statement
+    #  has on the data.
+    #
+    # @param [String] sql The SELECT statement to run
+    # @param [Array] parama The parameters to be added to the sql query. Ruby
+    #  types are used to determine formatting and escaping.
+    # @param [String] expected_affected_rows The number of rows that should
+    #  have been updated.
+    def execute(_sql, _params, _expected_affected_rows)
+      fail NotImplementedError, "You must implement 'execute'."
+    end
+
+    # Transaction Semantics
+    def begin
+      @connection.execute('BEGIN', [])
+    end
+
+    # Transaction Semantics
+    def commit
+      @connection.execute('COMMIT', [])
+    end
+
+    # Transaction Semantics
+    def rollback
+      @connection.execute('ROLLBACK', [])
+    end
+  end
+end

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: fluiddb2
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Guy Irvine
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-07-30 00:00:00.000000000 Z
+dependencies: []
+description: A semantic layer for db interaction
+email: guy@guyirvine.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/fluiddb2/firebird.rb
+- lib/fluiddb2/mock.rb
+- lib/fluiddb2/mysql.rb
+- lib/fluiddb2/mysql2.rb
+- lib/fluiddb2/pgsql.rb
+- lib/fluiddb2/sqlite.rb
+- lib/fluiddb2/tiny_tds.rb
+- lib/fluiddb2.rb
+- LICENSE
+- README.md
+homepage: http://rubygems.org/gems/fluiddb2
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.14.1
+signing_key: 
+specification_version: 4
+summary: FluidDB
+test_files: []