nuodb 1.0.0.rc.1 → 1.0.0.rc.2

data/lib/nuodb/column.rb

@@ -0,0 +1,131 @@
+require 'set'
+
+module NuoDB
+
+  class Column
+    TRUE_VALUES = [true, 1, '1', 't', 'T', 'true', 'TRUE', 'on', 'ON'].to_set
+    FALSE_VALUES = [false, 0, '0', 'f', 'F', 'false', 'FALSE', 'off', 'OFF'].to_set
+
+    module Format
+      ISO_DATE = /\A(\d{4})-(\d\d)-(\d\d)\z/
+      ISO_DATETIME = /\A(\d{4})-(\d\d)-(\d\d) (\d\d):(\d\d):(\d\d)(\.\d+)?\z/
+    end
+
+    attr_reader :name, :default, :type, :limit, :null, :sql_type, :precision, :scale
+    attr_accessor :primary, :coder
+
+    alias :encoded? :coder
+
+    # Instantiates a new column in the table.
+    #
+    # +name+ is the column's name, such as <tt>supplier_id</tt> in <tt>supplier_id int(11)</tt>.
+    # +default+ is the type-casted default value, such as +new+ in <tt>sales_stage varchar(20) default 'new'</tt>.
+    # +sql_type+ is used to extract the column's length, if necessary. For example +60+ in
+    # <tt>company_name varchar(60)</tt>.
+    # It will be mapped to one of the standard Rails SQL types in the <tt>type</tt> attribute.
+    # +null+ determines if this column allows +NULL+ values.
+    def initialize(name, default, sql_type = nil, null = true)
+      @name = name
+      @sql_type = sql_type
+      @null = null
+      @limit = extract_limit(sql_type)
+      @precision = extract_precision(sql_type)
+      @scale = extract_scale(sql_type)
+      @type = simplified_type(sql_type)
+      @default = extract_default(default)
+      @primary = nil
+      @coder = nil
+    end
+
+    # Returns +true+ if the column is either of type string or text.
+    def text?
+      type == :string || type == :text
+    end
+
+    # Returns +true+ if the column is either of type integer, float or decimal.
+    def number?
+      type == :integer || type == :float || type == :decimal
+    end
+
+    def has_default?
+      !default.nil?
+    end
+
+    # Returns the Ruby class that corresponds to the abstract data type.
+    def klass
+      case type
+        when :integer then
+          Fixnum
+        when :float then
+          Float
+        when :decimal then
+          BigDecimal
+        when :datetime, :timestamp, :time then
+          Time
+        when :date then
+          Date
+        when :text, :string, :binary then
+          String
+        when :boolean then
+          Object
+      end
+    end
+
+    # Casts value (which is a String) to an appropriate instance.
+    def type_cast(value)
+      return nil if value.nil?
+      return coder.load(value) if encoded?
+      value
+    end
+
+    def extract_default(default)
+      type_cast(default)
+    end
+
+    private
+
+    def extract_limit(sql_type)
+      $1.to_i if sql_type =~ /\((.*)\)/
+    end
+
+    def extract_precision(sql_type)
+      $2.to_i if sql_type =~ /^(numeric|decimal|number)\((\d+)(,\d+)?\)/i
+    end
+
+    def extract_scale(sql_type)
+      case sql_type
+        when /^(numeric|decimal|number)\((\d+)\)/i then
+          0
+        when /^(numeric|decimal|number)\((\d+)(,(\d+))\)/i then
+          $4.to_i
+      end
+    end
+
+    def simplified_type(field_type)
+      case field_type
+        when /int/i
+          :integer
+        when /float|double/i
+          :float
+        when /decimal|numeric|number/i
+          extract_scale(field_type) == 0 ? :integer : :decimal
+        when /datetime/i
+          :datetime
+        when /timestamp/i
+          :timestamp
+        when /time/i
+          :time
+        when /date/i
+          :date
+        when /clob/i, /text/i
+          :text
+        when /blob/i, /binary/i
+          :binary
+        when /char/i, /string/i
+          :string
+        when /boolean/i
+          :boolean
+      end
+    end
+  end
+end

data/lib/nuodb/error.rb

@@ -1,34 +1,6 @@
-#
-# Copyright (c) 2012, NuoDB, Inc.
-# 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 NuoDB, Inc. 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 NUODB, INC. 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.
-#
-
 module NuoDB
 
-  class Error < StandardError
+  class DatabaseError < StandardError
 
     attr_accessor :error_code
 

data/lib/nuodb/version.rb

@@ -27,5 +27,5 @@
 #
 
 module NuoDB
-  VERSION = '1.0.0.rc.1'
+  VERSION = '1.0.0.rc.2'
 end

data/nuodb.gemspec

@@ -1,25 +1,33 @@
 # -*- encoding: utf-8 -*-
-require File.expand_path('../lib/nuodb/version', __FILE__)
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'nuodb/version'
 
-Gem::Specification.new do |gem|
-  gem.name        = 'nuodb'
-  gem.version     = NuoDB::VERSION
-  gem.authors     = %w('Robert Buck')
-  gem.email       = %w(support@nuodb.com)
-  gem.description = %q{An easy to use database API for the NuoDB distributed database.}
-  gem.summary     = %q{Native Ruby driver for NuoDB.}
-  gem.homepage    = 'http://nuodb.github.com/ruby-nuodb/'
-  gem.license     = 'BSD'
+Gem::Specification.new do |spec|
+  spec.name        = 'nuodb'
+  spec.version     = NuoDB::VERSION
+  spec.authors     = ['Robert Buck']
+  spec.email       = %w(support@nuodb.com)
+  spec.description = %q{An easy to use database API for the NuoDB distributed database.}
+  spec.summary     = %q{Native Ruby driver for NuoDB.}
+  spec.homepage    = 'http://nuodb.github.com/ruby-nuodb/'
+  spec.license     = 'BSD'
 
-  gem.rdoc_options = %w(--charset=UTF-8)
-  gem.extra_rdoc_files = %w[README.rdoc]
+  spec.rdoc_options = %w(--charset=UTF-8)
+  spec.extra_rdoc_files = %w[AUTHORS README.rdoc LICENSE]
 
-  gem.extensions = %w(ext/nuodb/extconf.rb)
+  spec.extensions = %w(ext/nuodb/extconf.rb)
 
-  gem.add_development_dependency('rake', '~> 0.9')
-  gem.add_development_dependency('rdoc', '~> 3.10')
+  spec.files = `git ls-files`.split($\)
+  spec.test_files = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = %w(lib ext)
 
-  gem.files = `git ls-files`.split($\)
-  gem.test_files = gem.files.grep(%r{^(test|spec|features)/})
-  gem.require_paths = %w(lib ext)
+  spec.add_development_dependency('erubis', '~> 2.7.0')
+  spec.add_development_dependency('rake', '~> 0.9')
+  spec.add_development_dependency('rdoc', '~> 3.10')
+  spec.add_development_dependency('hanna-nouveau', '~> 0.2.4')
+
+  %w(rake rdoc simplecov hanna-nouveau rubydoc sdoc).each { |gem| spec.add_development_dependency gem }
+  %w(ruby-prof).each { |gem| spec.add_development_dependency gem }
+  %w(rspec rspec-core rspec-expectations rspec-mocks).each { |gem| spec.add_development_dependency gem, "~> 2.11.0" }
 end

data/spec/functional/connection_spec.rb

@@ -0,0 +1,110 @@
+require 'spec_helper'
+require 'nuodb'
+
+describe NuoDB::Connection do
+  before do
+  end
+
+  after do
+  end
+
+  context "creating a connection" do
+
+    before(:each) do
+    end
+
+    after(:each) do
+    end
+
+    it "should raise an ArgumentError error when provided no configuration" do
+      lambda {
+        NuoDB::Connection.new
+      }.should raise_error(ArgumentError)
+    end
+
+    it "should raise an DatabaseError error when provided invalid credentials" do
+      lambda {
+        config = BaseTest.connection_config.clone
+        config[:password] = 'invalid'
+        NuoDB::Connection.new config do |connection|
+          connection.connected?.should be_true
+        end
+      }.should raise_error(NuoDB::DatabaseError)
+    end
+
+    #it "should permissibly support a code block after which the connection is automatically disconnected" do
+    #  local_connection = nil
+    #  NuoDB::Connection.new BaseTest.connection_config do |connection|
+    #    connection.connected?.should be_true
+    #    local_connection = connection # todo when real ref counting implementation is added
+    #  end
+    #  local_connection.connected?.should be_false
+    #end
+
+    # decision: we will not support this as we cannot guarantee that there are
+    # no outstanding references for the object, say for instance, the user
+    # passes a variable out of scope, and as the outer variable does not create
+    # a copy of the VALUE object (it is identical from what I see) there is no
+    # way to detect closure.
+    #
+    #it "should permissibly support a code block after which the connection is automatically disconnected even if an exception is raised" do
+    #  @local_connection = nil
+    #  lambda {
+    #    NuoDB::Connection.new BaseTest.connection_config do |connection|
+    #      connection.connected?.should be_true
+    #      @local_connection = connection # todo when real ref counting implementation is added
+    #      raise ArgumentError
+    #    end
+    #  }.should raise_error(ArgumentError)
+    #  @local_connection.connected?.should be_false
+    #end
+
+  end
+
+  context "active connections" do
+
+    before(:each) do
+      @connection = BaseTest.connect
+    end
+
+    after(:each) do
+      #@connection.disconnect
+      @connection = nil
+    end
+
+    it "should yield true when connected? is called" do
+      @connection.connected?.should be_true
+    end
+
+    it "should yield true when ping is called" do
+      @connection.ping.should be_true
+    end
+
+    it "support configuring autocommit at the connection level" do
+      @connection.autocommit = true
+      @connection.autocommit?.should be_true
+
+      @connection.autocommit = false
+      @connection.autocommit?.should be_false
+    end
+
+  end
+
+  #context "inactive connections" do
+  #
+  #  before(:each) do
+  #    @connection = BaseTest.connect
+  #    @connection.disconnect # todo when real ref counting implementation is added
+  #  end
+  #
+  #  after(:each) do
+  #    @connection = nil
+  #  end
+  #
+  #  it "should yield false when connected? is called" do
+  #    @connection.connected?.should be_false
+  #  end
+  #
+  #end
+
+end

data/spec/functional/datatypes_spec.rb

@@ -0,0 +1,165 @@
+require 'spec_helper'
+require 'nuodb'
+require 'bigdecimal'
+
+describe NuoDB::Result do
+
+  attr_reader :connection
+
+  before(:all) do
+    @connection = BaseTest.connect
+  end
+
+  after(:all) do
+  end
+
+  context "nuodb naturally handles ruby datatypes" do
+
+    attr_reader :statement
+    attr_reader :prepared_statement
+    attr_accessor :data_array
+
+    make_type_table_ddl = 'CREATE TABLE test_datatypes (f1 BOOLEAN, f2 DOUBLE, f3 INTEGER, f4 BIGINT, f5 STRING, f6 DATE, f7 TIMESTAMP)' #, f8 NUMERIC)'
+    drop_type_table_ddl = "DROP TABLE IF EXISTS test_datatypes"
+    insert_dml = "insert into test_datatypes(f1, f2, f3, f4, f5, f6, f7) values(?, ?, ?, ?, ?, ?, ?)" # , f8)  later, ", ?)"
+    select_dml = "select * from test_datatypes"
+    delete_dml = "delete from test_datatypes"
+
+    machine_bytes = %w(foo).pack('p').size
+    machine_bits = machine_bytes * 8
+    machine_max_signed = 2**(machine_bits-1) - 1
+    machine_max_unsigned = 2**machine_bits - 1
+    machine_min_signed = -(2**(machine_bits-1))
+    machine_min_unsigned = -(2**machine_bits)
+    machine_bits_32 = 32
+    machine_max_signed_32 = 2**(machine_bits_32-1) - 1
+    machine_max_unsigned_32 = 2**machine_bits_32 - 1
+    machine_min_signed_32 = -(2**(machine_bits_32-1))
+    machine_min_unsigned_32 = -(2**machine_bits_32)
+
+    before(:all) do
+      @data_array = [
+          [false, 12345.67890, -1, 222222222, 'Bofur and Bifur', Date.new(1957, 3, 27), Time.new], #, BigDecimal("1000234000567.95")],
+          [false, -12345.67890, -1, -222222222, 'Bofur and Bifur', Date.new(1957, 3, 27), Time.new], #, BigDecimal("-1000234000567.95")],
+          [false, -0.0, -0, -0, 'Kili and Fili', Date.new(2001, 12, 3), Time.new], #, BigDecimal("-0.0")],
+          [true, +0.0, +0, +0, 'Kili and Fili', Date.new(2001, 12, 3), Time.new], #, BigDecimal("+0.0")],
+          [false, -1.0, -1, -1, 'Kili and Fili', Date.new(2001, 12, 3), Time.new], #, BigDecimal("-1.0")],
+          [true, +1.0, +1, -1, 'Kili and Fili', Date.new(2001, 12, 3), Time.new], #, BigDecimal("+1.0")],
+          [false, (1.0 * machine_min_signed_32), machine_min_signed_32, machine_min_signed, 'Kili and Fili', Date.new(2001, 12, 3), Time.new], #, BigDecimal("-1.0")],
+          [true, (1.0 * machine_max_signed_32), machine_max_signed_32, machine_max_signed, 'Kili and Fili', Date.new(2001, 12, 3), Time.new], #, BigDecimal("-1.0")],
+          [false, (1.0 * machine_min_signed_32), machine_min_signed_32, machine_max_unsigned_32, 'Kili and Fili', Date.new(2001, 12, 3), Time.new], #, BigDecimal("-1.0")],
+          [true, (1.0 * machine_max_signed_32), machine_max_signed_32, machine_min_unsigned_32, 'Kili and Fili', Date.new(2001, 12, 3), Time.new], #, BigDecimal("-1.0")],
+          [false, (1.0 * machine_min_signed_32), machine_min_signed_32, machine_max_unsigned_32, 'Kili and Fili', Date.new(2001, 12, 3), Time.new], #, BigDecimal("#{machine_max_unsigned}")],
+          [true, (1.0 * machine_max_signed_32), machine_max_signed_32, machine_min_unsigned_32, 'Kili and Fili', Date.new(2001, 12, 3), Time.new], #, BigDecimal("#{machine_min_unsigned}")],
+      ]
+      [-1, 1].each do |sign|
+        random = Random.new(Random.new_seed)
+        data_array << [rand(2).zero?, sign * random.rand(1.0 * machine_max_signed_32), random.rand(machine_max_signed_32),
+                       random.rand(machine_max_signed), 'Kili and Fili', Date.new(2001, 12, 3), Time.new] #, BigDecimal("-1.0")
+      end
+    end
+
+    before(:each) do
+      @statement = @connection.statement
+      statement.execute(drop_type_table_ddl)
+      statement.execute(make_type_table_ddl)
+      @prepared_statement = connection.prepare insert_dml
+    end
+
+    after(:each) do
+      statement.execute(drop_type_table_ddl)
+    end
+
+    # n.b. product defect, set this to false when it is fixed; no numeric support
+    jira_db_2288_is_open = true
+
+    it "input data types are be matched with output data types" do
+      data_array.each do |binds|
+        statement.execute(delete_dml).should be_false
+        prepared_statement.bind_params binds
+        prepared_statement.execute.should be_false
+        statement.execute(select_dml).should be_true
+        statement.results.rows.each do |row|
+          row[0].should eql(binds[0])
+          row[1].should be_within(0.001).of(binds[1])
+          row[2].should eql(binds[2])
+          row[3].should eql(binds[3])
+          row[4].should eql(binds[4])
+          row[5].should be_within(1).of(binds[5])
+          row[6].should be_within(1).of(binds[6])
+          #row[7].should eql(binds[7]) unless jira_db_2288_is_open
+
+          row.each_with_index do |data, idx|
+            #unless idx == 7 and jira_db_2288_is_open
+            data.should be_a(binds[idx].class)
+            #end
+          end
+        end
+      end
+    end
+
+    it "string input data types are be matched with type-specific output data types" do
+      data_array.each do |binds|
+        statement.execute(delete_dml).should be_false
+        string_binds = binds.each_with_index.inject([]) do |array, (bind, index)|
+          if [6].include? index
+            array << bind.getutc
+          else
+            array << bind.to_s
+          end
+        end
+        prepared_statement.bind_params string_binds
+        prepared_statement.execute.should be_false
+        statement.execute(select_dml).should be_true
+        statement.results.rows.each do |row|
+          row[0].should eql(binds[0])
+          row[1].should be_within(0.001).of(binds[1])
+          row[2].should eql(binds[2])
+          row[3].should eql(binds[3])
+          row[4].should eql(binds[4])
+          row[5].should be_within(1).of(binds[5])
+          row[6].should be_within(1).of(binds[6])
+          #row[7].should eql(binds[7]) unless jira_db_2288_is_open
+
+          row.each_with_index do |data, idx|
+            #unless idx == 7 and jira_db_2288_is_open
+            data.should be_a(binds[idx].class)
+            #end
+          end
+        end
+      end
+    end
+
+  end
+
+  #context "nuodb naturally handles ruby date/time conversions" do
+  #
+  #  it "preserves time objects with local_time conversion to default timezone utc" do
+  #    with_env_tz 'America/New_York' do
+  #      with_default_timezone :utc do
+  #        time = Time.local(2000)
+  #        #topic = Topic.create('written_on' => time)
+  #        #saved_time = Topic.find(topic.id).reload.written_on
+  #        #assert_equal time, saved_time
+  #        #assert_equal [0, 0, 0, 1, 1, 2000, 6, 1, false, "EST"], time.to_a
+  #        #assert_equal [0, 0, 5, 1, 1, 2000, 6, 1, false, "UTC"], saved_time.to_a
+  #      end
+  #    end
+  #  end
+  #
+  #  it "preserves time objects with time with zone conversion to default timezone utc" do
+  #    with_env_tz 'America/New_York' do
+  #      with_default_timezone :utc do
+  #        Time.use_zone 'Central Time (US & Canada)' do
+  #          time = Time.zone.local(2000)
+  #          #topic = Topic.create('written_on' => time)
+  #          #saved_time = Topic.find(topic.id).reload.written_on
+  #          #assert_equal time, saved_time
+  #          #assert_equal [0, 0, 0, 1, 1, 2000, 6, 1, false, "CST"], time.to_a
+  #          #assert_equal [0, 0, 6, 1, 1, 2000, 6, 1, false, "UTC"], saved_time.to_a
+  #        end
+  #      end
+  #    end
+  #  end
+  #end
+end