do_sqlserver-tinytds 0.10.17.alpha

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e4350cba1497e5dedf23f8f292ade5f41f37f0c5
+  data.tar.gz: 0d713306670222a6eebe2bc2776f41bd11fd8dcb
+SHA512:
+  metadata.gz: 26a8cb0d7faa67fffdd71e27ba35a1d2eaf96adcc1697a1cb7c873215229a966c015974b11ebd83ff3fa65bb7b2d56d2003c6a2486b63aa99be9d987f06f2d7e
+  data.tar.gz: f41621cfb2ec8ed5424484d0d17b8022bf07e941adc4beaf66caa0c5c3a4c331fc3c59aaa0990c26063bc1be936e93e4f1ed73cc11e2869bafdef1176f60450f

data/.gitignore

@@ -0,0 +1,3 @@
+.idea/
+.bundle/
+pkg/

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--colour

data/CONNECTING.markdown

@@ -0,0 +1,40 @@
+CONNECTING
+==========
+
+Various notes (needs to be cleaned-up).
+
+See:
+ * <http://blogs.msdn.com/sqlexpress/archive/2004/07/23/192044.aspx>
+ * <http://blogs.msdn.com/b/bethmassi/archive/2008/09/17/enabling-remote-sql-express-2008-network-connections-on-vista.aspx>
+
+
+Example Setup
+-------------
+
+* In Visual Studio, click Server Explorer
+* Right click Data Connections
+* Create New SQL Server Database
+* Server Name: YOURPCNAME\SQLEXPRESS
+* Use Windows Authentication
+* #Use SQL Server Authentication
+* #User name: do_test
+* #Password:  do_test
+* New database name: do_test
+
+See:
+<http://social.msdn.microsoft.com/Forums/en-US/Vsexpressinstall/thread/aaf2f68c-4a40-44c8-b7ee-b2f5d94e23c3>
+
+---
+
+
+Tips
+----
+
+* Check the password is not required to be set on first connect.
+* Test you can connect locally. Either through Visual Studio SQL Server tools,
+  SQL Server Management Studio, or simply using telnet: `telnet localhost 4322`.
+* Configure Firewall correctly: http://support.microsoft.com/kb/287932
+* Specify an instance: in the DO URL append `INSTANCE=SQLEXPRESS`.
+* You can not add the instance to the hostname, i.e. `192.168.2.110\SQLEXPRESS`
+  as the underlying jTDS driver needs a URL that looks like this:
+  `jdbc:jtds:sqlserver://192.168.2.110:1433/do_test;instance=SQLEXPRESS`.

data/ChangeLog.markdown

@@ -0,0 +1,56 @@
+## 0.10.7 2011-10-13
+
+No changes
+
+## 0.10.6 2011-05-22
+
+No changes
+
+## 0.10.5 2011-05-03
+
+No changes
+
+## 0.10.4 2011-04-28
+
+New features
+* Add save point to transactions (all)
+* JRuby 1.9 mode support (encodings etc.)
+
+Bugfixes
+* Fix bug when using nested transactions in concurrent scenarios (all)
+* Use column aliases instead of names (jruby)
+
+Other
+* Switch back to RSpec
+
+## 0.10.3 2011-01-30
+* No changes
+
+## 0.10.2 2010-05-19
+* No changes
+
+## 0.10.1 2010-01-08
+
+Initial release as part of mainline DataObjects project.
+
+* Switch to Jeweler for Gem building tasks (this change may be temporary).
+* Switch to using Bacon for running specs: This should make specs friendlier to
+  new Ruby implementations that are not yet 100% MRI-compatible, and in turn,
+  pave the road for our own IronRuby and MacRuby support.
+* Switch to the newly added rake-compiler `JavaExtensionTask` for compiling
+  JRuby extensions, instead of our (broken) home-grown solution.
+
+* Known Issues:
+  * Writing Extlib::ByteArray is not currently supported.
+
+## 0.10.0 2009-09-15
+
+(NOT RELEASED)
+
+* Improvements
+  * JRuby Support (using *do_jdbc*)
+
+## 0.0.1 2009-05-11
+
+* 1 major enhancement:
+  * Initial release

data/FAQS.markdown

@@ -0,0 +1,8 @@
+FAQS
+====
+
+* Can I use Microsoft's SQL Server driver instead of jTDS?
+
+No, not currently. Currently the DataObjects Driver implementation is tied not
+only to a relational database, but to its JDBC driver implementation. You could
+create an alternate database implementation.

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,30 @@
+PATH
+  remote: .
+  specs:
+    do_sqlserver-tinytds (0.10.15)
+      data_objects (~> 0.10.13)
+      tiny_tds (~> 0.5)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.3.4)
+    data_objects (0.10.13)
+      addressable (~> 2.1)
+    diff-lcs (1.1.3)
+    rspec (2.7.0)
+      rspec-core (~> 2.7.0)
+      rspec-expectations (~> 2.7.0)
+      rspec-mocks (~> 2.7.0)
+    rspec-core (2.7.1)
+    rspec-expectations (2.7.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.7.0)
+    tiny_tds (0.5.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  do_sqlserver-tinytds!
+  rspec (~> 2.5)

data/INSTALL.markdown

@@ -0,0 +1,76 @@
+INSTALLING
+==========
+
+JRuby variant driver
+--------------------
+
+  * Install the jTDS JDBC Driver. For your convenience, DO packages it as a Ruby
+    Gem. If installing from source, `cd` to `../jdbc_drivers/sqlserver/` and run
+    `rake install`.
+  * There are currently no other prerequisites for installation.
+
+1.8.6/7 (MRI) and 1.9.x (YARV) variant
+--------------------------------------
+
+  1. Install the DBI and DBD::ODBC dependencies:
+
+        sudo gem install dbi
+        sudo gem install dbd-odbc
+
+  2. Install [ODBC Binding for Ruby][rubyodbc]. It it *not* currently available
+     via RubyGems, so you'll have to download the source tarball:
+
+        wget http://www.ch-werner.de/rubyodbc/ruby-odbc-0.9997.tar.gz
+        tar xvfz ruby-odbc-0.9997.tar.gz
+        cd ruby-odbc-0.9997
+
+
+  3. Ensure you read the accompanying `COPYING` file, as the ODBC Binding for Ruby
+     is licensed under the GPL, unlike DataObjects. To install read the
+     accompanying `INSTALL` file. On a recent variant of OS X, installation
+     should look like this:
+
+        ruby extconf.rb
+        make
+        sudo make install
+
+  4. You must also have FreeTDS or [unixODBC][unixodbc] (SQL Server license for
+     unixODBC is commercially licensed though) installed.
+
+  5. To install FreeTDS on OS X, you can use MacPorts:
+
+        sudo port install freetds
+
+        ****************************************************************
+        Configuration file freetds.conf does not exist and has been created using
+            /opt/local/etc/freetds/freetds.conf.sample
+        Configuration file locales.conf does not exist and has been created using
+            /opt/local/etc/freetds/locales.conf.sample
+        Configuration file pool.conf does not exist and has been created using
+            /opt/local/etc/freetds/pool.conf.sample
+        ****************************************************************
+
+
+  * Then edit your ODBC configuration and add the FreeTDS driver.
+
+    * Using a text editor: On OS X, open `/Library/ODBC/odbcinst.ini` and add
+      the following entries:
+
+            [FreeTDS]
+            Driver = /opt/local/lib/libtdsodbc.so
+            Setup  = /opt/local/lib/libtdsodbc.so
+
+    * You can also use a GUI for this (provided in Mac OS X 10.3 - 10.5;
+      [ODBCManager][odbcmanager] available for OS X 10.6)..
+      * Start ODBC Manager
+      * Go to *Drivers*, *Add...*
+      * Enter _FreeTDS_ as Driver Name.
+      * Enter `/usr/local/freetds/lib/libtdsodbc.so` as Driver File
+      * Enter `/usr/local/freetds/lib/libtdsodbc.so` as Setup File
+      * Select *System*
+      * Click *OK*.
+
+
+[rubyodbc]:http://www.ch-werner.de/rubyodbc/README
+[unixodbc]:http://www.unixodbc.org/
+[odbcmanager]:http://www.odbcmanager.net/index.php

data/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2009 Clifford Heath
+Copyright (c) 2009 - 2011 Alex Coles
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,95 @@
+# do_sqlserver
+
+* <http://dataobjects.info>
+
+## Description
+
+A Microsoft SQL Server adapter for DataObjects,
+
+## Features/Problems
+
+This driver implements the DataObjects API for the Microsoft SQL Server
+relational database.
+
+Problems with previous MRI implementation (unreleased):
+
+* Relies on DBI's support for either ADO or ODBC with FreeTDS
+* Has no tests and no data type conversion yet
+
+This version uses TinyTDS instead. Is still alpha, and not production ready.
+
+## Synopsis
+
+Examples of usage:
+
+    # default port (using SQL Server Express Edition)
+    DataObjects::Connection.new('sqlserver://user:pass@host/database;instance=SQLEXPRESS')
+    # port specified (using SQL Server Express Edition)
+    DataObjects::Connection.new('sqlserver://user:pass@host:1433/database;instance=SQLEXPRESS')
+
+    @connection = DataObjects::Connection.new("sqlserver://john:p3$$@localhost:1433/userinfo")
+    @reader = @connection.create_command('SELECT * FROM users').execute_reader
+    @reader.next!
+
+* See also the accompanying `CONNECTING.markdown`.
+
+## Requirements
+
+This driver is provided for the following platforms:
+ * JRuby 1.3.1 + (1.4+ recommended).
+
+Code for the following platform is in the repository, but is still under EARLY
+DEVELOPMENT and is neither RELEASED or SUPPORTED:
+ * Ruby MRI (1.8.6/7), 1.9: tested on Linux, Mac OS X and Windows platforms.
+
+Additionally you should have the following prerequisites:
+ * `data_objects` gem
+ * `do_jdbc` gem (shared library), if running on JRuby.
+ * `dbi` gem, if running on MRI.
+ * On non-Windows platforms, unixODBC and FreeTDS libraries.
+
+## Install
+
+To install the gem:
+
+    gem install do_sqlserver
+
+To compile and install from source:
+
+ * For MRI:
+  * Installation of do_sqlserver is significantly more involved than for other
+    drivers. Please see the accompanying `INSTALL.markdown`.
+
+Then:
+
+    sudo gem install do_sqlserver
+
+For more information, see the SQL Server driver wiki page:
+<http://wiki.github.com/datamapper/do/sql-server>.
+
+## Developers
+
+Follow the above installation instructions. Additionally, you'll need:
+  * `rspec` gem for running specs.
+  * `YARD` gem for generating documentation.
+
+See the DataObjects wiki for more comprehensive information on installing and
+contributing to the JRuby-variant of this driver:
+<http://wiki.github.com/datamapper/do/jruby>.
+
+To run specs:
+
+    rake spec
+
+To run specs without compiling extensions first:
+
+    rake spec_no_compile
+
+To run individual specs:
+
+    rake spec SPEC=spec/connection_spec.rb
+
+## License
+
+This code is licensed under an **MIT (X11) License**. Please see the
+accompanying `LICENSE` file.

data/Rakefile

@@ -0,0 +1,7 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new
+
+task :default => :spec
+task :test => :spec

data/buildfile

@@ -0,0 +1,27 @@
+# Apache Buildr buildfile for do_sqlserver
+# see http://incubator.apache.org/buildr/ for more information on Apache Buildr
+require 'buildr'
+require 'pathname'
+
+VERSION_NUMBER = '1.0'
+JDBC_SUPPORT = ['data_objects:jdbc:jar:1.0']
+TARGET_DIR = 'pkg/classes'
+repositories.remote << 'http://www.ibiblio.org/maven2/'
+
+define 'do_sqlserver' do
+  project.version = VERSION_NUMBER
+  project.group = 'data_objects.rb'
+
+  manifest['Copyright'] = 'Raimonds Simanovskis (C) 2009'
+
+  compile.using :target => '1.5', :lint => 'all', :deprecation => 'true'
+
+  define 'ext-java' do
+    package(:jar).clean.include(TARGET_DIR)
+        
+    jdbc_support_jar = file('../../do_jdbc/lib/do_jdbc_internal.jar')
+    jdbc_support = artifact('data_objects:jdbc:jar:1.0').from(jdbc_support_jar)
+    
+    compile.into(TARGET_DIR).with(JDBC_SUPPORT)
+  end
+end

data/do_sqlserver_tinytds.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'do_sqlserver_tinytds/version'
+
+
+Gem::Specification.new do |spec|
+  spec.name           = %q{do_sqlserver-tinytds}
+  spec.version        = DataObjects::SqlServer::VERSION
+
+  spec.authors        = ["Juan Leal", "Caleb Tutty"]
+  spec.description    = %q{Implements the DataObjects API for Microsoft SQL Server using TinyTDS}
+  spec.email          = %q{sellingangle@hotmail.com caleb@prettymint.co.nz}
+  spec.summary        = %q{DataObjects SQL Server Driver using TinyTDS}
+
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.require_paths = ["lib"]
+
+  
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+
+
+  spec.add_dependency 'data_objects', '~> 0.10.13'
+  spec.add_dependency 'tiny_tds', '~> 0.5'
+  spec.add_development_dependency 'rspec', '~> 2.5'
+
+end

data/lib/do_sqlserver.rb

@@ -0,0 +1 @@
+require 'do_sqlserver_tinytds'

data/lib/do_sqlserver_tinytds.rb

@@ -0,0 +1,360 @@
+$:.unshift File.dirname(__FILE__)
+
+require 'data_objects'
+require 'bigdecimal'
+require 'date'
+require 'base64'
+require 'do_sqlserver_tinytds/version'
+require 'do_sqlserver_tinytds/transaction'
+require 'do_sqlserver_tinytds/tiny_tds_extension'
+require 'do_sqlserver_tinytds/addressable_extension'
+
+
+  module DataObjects
+    module SqlServer
+
+      class Connection < DataObjects::Connection
+        def method_missing(method, *args)
+          if @connection.respond_to?(method)
+            begin
+              @connection.send(method , *args)
+            rescue TinyTds::Error => te
+              case te.db_error_number
+                when 20019
+                  #Got a pending transcation there, lets make it let go
+                  @connection.close
+                  set_tiny_tds_connection
+                  #give it another try
+                  @connection.send(method, *args)
+                else
+                  raise te
+              end
+            end
+          end
+        end
+
+        def set_tiny_tds_connection
+          @connection = TinyTds::Client.new(@options).tap do |client|
+            client.execute("SET ANSI_NULLS ON").do
+            client.execute("SET QUOTED_IDENTIFIER ON").do
+          end
+        end
+
+        def initialize uri
+          host = uri.host
+          user = uri.user || "sa"
+          password = uri.password || ""
+          path = uri.path.sub(%r{^/*}, '')
+          port = uri.port || "1433"
+          azure = uri.query['azure'] || false
+
+          begin
+            _encoding = uri.query && uri.query["encoding"] || "UTF-8"
+            @encoding = Encoding.find(_encoding) ? _encoding : "UTF-8"
+          rescue
+            @encoding = "UTF-8"
+          end
+
+          @options = {:username => user,
+                     :password => password,
+                     :port => port ,
+                     :encoding => @encoding,
+                     :timeout => 5000,
+                     :dataserver => host,
+                     :database => path,
+                     :azure => azure
+                     }
+
+          @options[:dataserver] = host
+
+          begin
+            set_tiny_tds_connection
+            #@connection = DBI.connect(connection_string, user, password)
+          rescue Exception => e
+            raise
+          end
+
+          set_date_format = create_command("SET DATEFORMAT YMD").execute_non_query
+          options_reader = create_command("DBCC USEROPTIONS").execute_reader
+          while options_reader.next!
+            key, value = *options_reader.values
+            value = options_reader.values
+            case key
+            when "textsize"                     # "64512"
+            when "language"                     # "us_english", "select * from master..syslanguages" for info
+            when "dateformat"                   # "ymd"
+            when "datefirst"                    # "7" = Sunday, first day of the week, change with "SET DATEFIRST"
+            when "quoted_identifier"            # "SET"
+            when "ansi_null_dflt_on"            # "SET"
+            when "ansi_defaults"                # "SET"
+            when "ansi_warnings"                # "SET"
+            when "ansi_padding"                 # "SET"
+            when "ansi_nulls"                   # "SET"
+            when "concat_null_yields_null"      # "SET"
+            else
+            end
+          end
+        end
+
+        def using_socket?
+          # This might be an unnecessary feature dragged from the mysql driver
+          raise "Not yet implemented"
+        end
+
+        def character_set
+          @encoding
+        end
+
+        def dispose
+          return false if @connection.closed?
+          @connection.close
+          true
+        rescue
+          false
+        end
+
+        def raw
+          @connection
+        end
+
+        :private
+
+        #debugger_on - used only for development when debugging things
+        def debugger_on=(value)
+          $debugger_on = value
+        end
+      end
+
+      class Command < DataObjects::Command
+        IDENTITY_ROWCOUNT_QUERY = 'SELECT CAST(SCOPE_IDENTITY() AS bigint) AS Ident, @@ROWCOUNT AS AffectedRows'
+
+        attr_reader :types
+
+        def debugger_on(value)
+          $debugger_on = value
+        end
+
+        def set_types *t
+          @types = t.flatten
+        end
+
+        def execute_non_query *args
+          DataObjects::SqlServer.check_params @text, args
+
+          begin
+            handle = @connection.raw_execute(@text , *args)
+            handle.do
+          rescue TinyTds::Error => te
+
+            handle.cancel if handle && handle.respond_to?(:cancel) && !@connection.sqlsent?
+
+            DataObjects::SqlServer.raise_db_error(te, @text, args)
+          rescue RuntimeError => re
+            case re.message
+              when "closed connection"
+                raise DataObjects::ConnectionError.new(re.message)
+            end
+          rescue Exception => e
+            raise e
+          end
+
+          # Get the inserted ID and the count of affected rows:
+          inserted_id = @connection.execute("SELECT CAST(SCOPE_IDENTITY() AS bigint) AS Ident").each.first['Ident']
+          row_count = handle.affected_rows
+          Result.new(self, row_count, inserted_id)
+        end
+
+        def execute_reader *args
+          DataObjects::SqlServer.check_params @text, args
+          massage_limit_and_offset args
+          begin
+            handle = @connection.raw_execute(@text, *args)
+
+          rescue Exception => e
+
+           handle.cancel if handle && handle.respond_to?(:cancel) && !@connection.sqlsent?
+           raise
+          end
+
+          Reader.new(self, handle)
+        end
+
+      private
+        def massage_limit_and_offset args
+          @text.sub!(%r{SELECT (.*) ORDER BY (.*) LIMIT ([?0-9]*)( OFFSET ([?0-9]*))?}) {
+            what, order, limit, offset = $1, $2, $3, $5
+
+            # LIMIT and OFFSET will probably be set by args. We need exact values, so must
+            # do substitution here, and remove those args from the array. This is made easier
+            # because LIMIT and OFFSET are always the last args in the array.
+            offset = args.pop if offset == '?'
+            limit = args.pop if limit == '?'
+            offset = offset.to_i
+            limit = limit.to_i
+
+            #Reverse the sort direction of each field in the ORDER BY:
+            rev_order = order.split(/, */).map{ |f|
+              f =~ /(.*) DESC *$/ ? $1 : f+" DESC"
+            }*", "
+
+            "SELECT TOP #{limit} * FROM (SELECT TOP #{offset+limit} #{what} ORDER BY #{rev_order}) ORDER BY #{order}"
+          }
+        end
+      end
+
+      class Result < DataObjects::Result
+      end
+
+      class Reader < DataObjects::Reader
+        def initialize command, handle
+          @command, @handle = command, handle
+          return unless @handle
+
+          @fields = handle.fields
+
+          @rows = []
+          types = @command.types
+          if types && types.size != @fields.size
+            @handle.cancel if @handle && @handle.respond_to?(:cancel)
+            raise ArgumentError, "Field-count mismatch. Expected #{types.size} fields, but the query yielded #{@fields.size}"
+          end
+
+
+          @handle.each(:as => :array) do |row|
+            field = -1
+            @rows << row.map do |value|
+              field += 1
+
+              next value if !types && !value.is_a?(Time)
+
+              field_type = types && types[field]
+              value_class = value.class
+
+              r_value = case
+                when field_type == NilClass || value.nil?
+                  nil
+                when field_type.nil? && value.is_a?(Time)
+                  #sql small dates have zeros for hr, min, sec
+                  # and needs to be cast as Date, else cast as DateTime
+                  if (value.hour + value.min + value.sec) == 0
+                    time_to_date(value)
+                  else
+                    time_to_date_time(value)
+                  end
+                when value.is_a?(field_type) || value_class.kind_of?(field_type) || field_type == TrueClass
+                  value
+                when field_type == Integer
+                  Integer(value)
+                when field_type == Float
+                  Float(value)
+                when field_type == String
+                  raise "Value '#{value.inspect}' does not respond to #to_s" unless value.respond_to?(:to_s)
+                  value.to_s
+                when field_type == DateTime
+                  case
+                    when value.is_a?(Time)
+                      time_to_date_time(value)
+                    when value.is_a?(String)
+                      DateTime.parse(value)
+                    else
+                      DateTime.parse(value.to_s)
+                  end
+                when field_type == Date
+                  case
+                    when value.is_a?(Time) || value.is_a?(DateTime)
+                      Date.parse(value.strftime('%Y/%m/%d'))
+                    else
+                      Date.parse(value)
+                  end
+                when field_type == Time
+                  Time.parse(value)
+                when field_type == BigDecimal
+                  BigDecimal.new(value.to_s)
+                else
+                  if value.respond_to?(:to_s)
+                    value.to_s
+                  else
+                    value
+                  end
+              end
+
+              r_value
+
+            end
+          end
+          @handle.cancel if @handle && @handle.respond_to?(:cancel)
+          @current_row = -1
+        end
+
+        def close
+          if @handle
+            @handle.finish if  @handle.respond_to?(:finish) && !@handle.finished?
+            @handle = nil
+            true
+          else
+            false
+          end
+        end
+
+        def next!
+          (@current_row += 1) < @rows.size
+        end
+
+        def values
+          raise DataObjects::DataError.new("First row has not been fetched") if @current_row < 0
+          raise DataObjects::DataError.new("Last row has been processed") if @current_row >= @rows.size
+          @rows[@current_row]
+        end
+
+        def fields
+          @fields
+        end
+
+        def field_count
+          @fields.size
+        end
+
+        def row_count
+          @rows.size
+        end
+
+        private
+
+        def time_to_date_time(value)
+          DateTime.new(value.year, value.month, value.day,
+                     value.hour, value.min, value.sec,
+                     Rational(value.gmt_offset / 3600, 24))
+        end
+
+        def time_to_date(value)
+          Date.parse(time_to_date_time(value).strftime('%Y/%m/%d'))
+        end
+      end
+
+    private
+
+      def self.check_params cmd, args
+        actual = args.size
+        expected = param_count(cmd)
+        raise ArgumentError.new("Binding mismatch: #{actual} for #{expected}") if actual != expected
+      end
+
+      def self.raise_db_error(e, cmd, args)
+        msg = e.to_str
+        case msg
+        when /Too much parameters/, /No data found/
+          check_params(cmd, args)
+        else
+          e.errstr << " running '#{cmd}'"
+        end
+        raise DataObjects::SQLError.new(e.errstr)
+      end
+
+      def self.param_count cmd
+        cmd.gsub(/'[^']*'/,'').gsub(/"[_|A-Z|a-z|0-9|?]+"/,'').scan(/\?/).size
+      end
+
+    end
+
+  end
+