ruby-plsql 0.5.2 → 0.5.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6146c4b4e96437d80996671df0f6ca68829dfc0a
-  data.tar.gz: f058454a9f207d41ef3a98e05c9aad90857da253
+  metadata.gz: f9c79fd3f97babd3bfa0f5a54b0830a12a6510c9
+  data.tar.gz: b3ec4ad1f9db5aa761fc751b1db9a1263c2dd6f1
 SHA512:
-  metadata.gz: e1b0537e8c4b32233661d316e93f91e2aa53dc5515e0e4c6b82b4dbb3049f782e85cc4ae78e52b47fb4cf05b7cc5c64aa4b585dd8b840622839730baaf37fdfa
-  data.tar.gz: eb17b6511c06ebe93ad09c9c5fefe19bd7aa298651802f54f41fdaae5b5b03308fe4ec2a141b17ac762e109e8838ff99c3303b51e58e3b0a7ba04253d4e5ae5c
+  metadata.gz: 88a0bf576dd829b0cbd7102a72a7a9d8bdfe3aee2e8771353756887f292c5c364ea9b24004c41e4cb14882cfd82c4d8ef7a9cd3709e04ab4693236dd163011c7
+  data.tar.gz: ac9bde40f6690697c63acb443a8a9f02afa9fc1bb1670e477c09b21f6c4aa368c61326047ae8733860d337dd862efe4432fba81f3eee35d9a9affc72c60e32ff

data/Gemfile

@@ -5,7 +5,7 @@ group :development do
   gem 'rspec', '~> 3.1'
 
   unless ENV['NO_ACTIVERECORD']
-    gem 'activerecord', '>= 3.2.3', '< 4.2.0'
+    gem 'activerecord', '>= 3.2.3', '< 4.3.0'
     gem 'activerecord-oracle_enhanced-adapter', '>= 1.4.1', '< 1.6.0'
     gem 'simplecov', '>= 0'
   end

data/History.txt

@@ -1,3 +1,15 @@
+== 0.5.3 2015-05-07
+
+* Improvements
+  * Support for ActiveRecord 4.2
+* Docs
+  * README formatting fixed (Usage with Rails section)
+* Bug fixes
+  * Force to convert String type value as real string to avoid error when used JRuby and for VARCHAR2 parameter is assigned non String value
+  * Fix dbms_output functionality in case when database exception is raised
+* Internal (development) improvements
+  * Vagrant box provisioning added
+
 == 0.5.2 2014-10-23
 
 * Bug fixes

data/README.md

@@ -59,6 +59,7 @@ plsql.logoff
 
 Look at RSpec tests under spec directory for more usage examples.
 
+Note: named arguments in procedures calls should be in lower case.
 
 ### Table operations:
 
@@ -69,7 +70,7 @@ ruby-plsql also provides simple API for select/insert/update/delete table operat
 employee = { :employee_id => 1, :first_name => 'First', :last_name => 'Last', :hire_date => Time.local(2000,01,31) }
 plsql.employees.insert employee           # INSERT INTO employees VALUES (1, 'First', 'Last', ...)
 
-# insert many records 
+# insert many records
 employees = [employee1, employee2, ... ]  # array of many Hashes
 plsql.employees.insert employees
 
@@ -104,7 +105,7 @@ plsql.employees.delete(:employee_id => 1) # DELETE FROM employees WHERE employee
 # select from sequences
 plsql.employees_seq.nextval               # SELECT employees_seq.NEXTVAL FROM dual
 plsql.employees_seq.currval               # SELECT employees_seq.CURRVAL FROM dual
-
+```
 
 ### Usage with Rails:
 
@@ -140,7 +141,17 @@ If you are using JRuby then you need to download latest [Oracle JDBC driver](htt
 TESTS
 -----
 
-* Create Oracle database schema for test purposes. Review `spec/spec_helper.rb` to see default schema/user names and database names (use environment variables to override defaults)
+Review `spec/spec_helper.rb` to see default schema/user names and database names (use environment variables to override defaults)
+
+##### Prepare database
+
+* With local [Vagrant](https://www.vagrantup.com) based Oracle XE database.
+
+    Download Oracle XE database ```oracle-xe-11.2.0-1.0.x86_64.rpm.zip``` from [Oracle Home page](http://www.oracle.com/technetwork/database/database-technologies/express-edition/downloads/index.html) and put it into project home directory.
+
+    From project home directory run ```vagrant up``` command to build fully functioning **Centos 6.6** virtual machine with installed Oracle XE database.
+
+* Within other Oracle Database create Oracle database schema for test purposes.
 
         SQL> CREATE USER hr IDENTIFIED BY hr;
         SQL> GRANT unlimited tablespace, create session, create table, create sequence, create procedure, create type, create view, create synonym TO hr;
@@ -148,6 +159,8 @@ TESTS
         SQL> CREATE USER arunit IDENTIFIED BY arunit;
         SQL> GRANT create session TO arunit;
 
+##### Prepare dependencies
+
 * Install bundler with
 
         gem install bundler
@@ -156,7 +169,13 @@ TESTS
 
         bundle install
 
-* Run tests with
+##### Run tests
+
+* Run tests with local Vagrant based Oracle XE database
+
+        USE_VM_DATABASE=Y rake spec
+
+* Run tests with other Oracle database
 
         rake spec
 

data/VERSION

@@ -1 +1 @@
-0.5.2
+0.5.3

data/Vagrantfile

@@ -0,0 +1,38 @@
+# Vagrantfile API/syntax version. Don't touch unless you know what you're doing!
+VAGRANTFILE_API_VERSION = "2"
+
+Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
+
+  # Every Vagrant virtual environment requires a box to build off of.
+  config.vm.box = "chef/centos-6.6"
+  config.vm.hostname = "vagrant.oracle"
+  config.vm.network :forwarded_port, guest: 1521, host: 1521
+
+  config.vm.provider :virtualbox do |vb|
+    vb.name = "Ruby-PLSQL Oracle XE box"
+    # Speed up network
+    #   http://serverfault.com/a/453260/105586
+    #   http://serverfault.com/a/595010/105586
+    vb.customize ["modifyvm", :id, "--natdnshostresolver1", "on"]
+    vb.customize ["modifyvm", :id, "--natdnsproxy1", "on"]
+  end
+
+  # Check for Oracle XE installation file
+  config.vm.provision :shell, path: "./spec/support/file_check_script.sh"
+
+  config.vm.provision :shell, inline: "yum update -y"
+  config.vm.provision :shell, inline: "yum install -y libaio bc flex unzip"
+  config.vm.provision :shell, inline: "mkdir -p /opt/oracle"
+  config.vm.provision :shell, inline: "unzip -q -d /opt/oracle /vagrant/oracle-xe-11.2.0-1.0.x86_64.rpm.zip"
+  config.vm.provision :shell, inline: "cd /opt/oracle/Disk1 && rpm -ivh oracle-xe-11.2.0-1.0.x86_64.rpm"
+  config.vm.provision :shell, inline: %q{sed -i -E "s/<value required>/oracle/" /opt/oracle/Disk1/response/xe.rsp}
+  config.vm.provision :shell, inline: "/etc/init.d/oracle-xe configure responseFile=/opt/oracle/Disk1/response/xe.rsp >> /opt/oracle/XEsilentinstall.log"
+  config.vm.provision :shell, inline: ". /u01/app/oracle/product/11.2.0/xe/bin/oracle_env.sh"
+  config.vm.provision :shell, inline: "touch /etc/profile.d/oracle_profile.sh && cat /u01/app/oracle/product/11.2.0/xe/bin/oracle_env.sh >> /etc/profile.d/oracle_profile.sh"
+  config.vm.provision :shell, inline: %q{sed -i -E "s/HOST = [^)]+/HOST = $HOSTNAME/g" /u01/app/oracle/product/11.2.0/xe/network/admin/listener.ora}
+  config.vm.provision :shell, inline: %q{sed -i -E "s/<ORACLE_BASE>/\/u01\/app\/oracle/" /u01/app/oracle/product/11.2.0/xe/dbs/init.ora}
+
+  # Change password for Oracle user
+  config.vm.provision :shell, inline: "echo -e \"oracle\noracle\" | passwd oracle"
+
+end

data/lib/plsql/jdbc_connection.rb

@@ -109,14 +109,14 @@ module PLSQL
           @out_types[arg] = type || ora_value.class
           @out_index[arg] = bind_param_index(arg)
           if ['TABLE','VARRAY','OBJECT'].include?(metadata[:data_type])
-            @statement.registerOutParameter(@out_index[arg], @connection.get_java_sql_type(ora_value,type), 
+            @statement.registerOutParameter(@out_index[arg], @connection.get_java_sql_type(ora_value,type),
               metadata[:sql_type_name])
           else
             @statement.registerOutParameter(@out_index[arg],@connection.get_java_sql_type(ora_value,type))
           end
         end
       end
-      
+
       def exec
         @statement.execute
       end
@@ -128,9 +128,9 @@ module PLSQL
       def close
         @statement.close
       end
-      
+
       private
-      
+
       def bind_param_index(key)
         return key if key.kind_of? Integer
         key = ":#{key.to_s}" unless key.to_s =~ /^:/
@@ -301,7 +301,7 @@ module PLSQL
         raise ArgumentError, "Don't know how to bind variable with type #{type_symbol}"
       end
     end
-    
+
     def get_bind_variable(stmt, i, type)
       case type.to_s.to_sym
       when :Fixnum, :Bignum, :Integer
@@ -337,7 +337,7 @@ module PLSQL
     end
 
     def result_set_to_ruby_data_type(column_type, column_type_name)
-      
+
     end
 
     def plsql_to_ruby_data_type(metadata)
@@ -371,8 +371,10 @@ module PLSQL
     def ruby_value_to_ora_value(value, type=nil, metadata={})
       type ||= value.class
       case type.to_s.to_sym
-      when :Fixnum, :String
+      when :Fixnum
         value
+      when :String
+        value.to_s
       when :BigDecimal
         case value
         when TrueClass
@@ -521,7 +523,7 @@ module PLSQL
     end
 
     private
-    
+
     def java_date(value)
       value && Java::oracle.sql.DATE.new(value.strftime("%Y-%m-%d %H:%M:%S"))
     end
@@ -538,7 +540,7 @@ module PLSQL
       # return BigDecimal instead of Float to avoid rounding errors
       num == (num_to_i = num.to_i) ? num_to_i : (num.is_a?(BigDecimal) ? num : BigDecimal.new(num.to_s))
     end
-    
+
   end
-  
+
 end

data/lib/plsql/package.rb

@@ -37,6 +37,10 @@ module PLSQL
       @package_objects = {}
     end
 
+    def procedure_defined?(name)
+      PLSQL::Procedure.find(@schema, name, @package) ? true : false
+    end
+
     private
     
     def method_missing(method, *args, &block)

data/lib/plsql/procedure_call.rb

@@ -26,8 +26,6 @@ module PLSQL
 
       @cursor.exec
 
-      dbms_output_log
-
       if block_given?
         yield get_return_value
         nil
@@ -36,6 +34,7 @@ module PLSQL
       end
     ensure
       @cursor.close if @cursor
+      dbms_output_log
     end
 
     private
@@ -215,10 +214,8 @@ module PLSQL
       end
       add_out_variables
 
-      dbms_output_enable_sql, dbms_output_get_sql = dbms_output_sql
-
       @sql = @declare_sql.empty? ? "" : "DECLARE\n" << @declare_sql
-      @sql << "BEGIN\n" << @assignment_sql << dbms_output_enable_sql << @call_sql << dbms_output_get_sql << @return_sql << "END;\n"
+      @sql << "BEGIN\n" << @assignment_sql << dbms_output_enable_sql << @call_sql << @return_sql << "END;\n"
     end
 
     def add_argument(argument, value, argument_metadata=nil)
@@ -539,34 +536,24 @@ module PLSQL
       @procedure_name ||= @procedure.procedure
     end
 
-    def dbms_output_sql
-      if @dbms_output_stream
-        dbms_output_enable_sql = "DBMS_OUTPUT.ENABLE(#{@schema.dbms_output_buffer_size});\n"
-        # if database version is at least 10.2 then use DBMS_OUTPUT.GET_LINES with SYS.DBMSOUTPUT_LINESARRAY
-        if (@schema.connection.database_version <=> [10, 2, 0, 0]) >= 0
-          @declare_sql << "l_dbms_output_numlines INTEGER := #{Schema::DBMS_OUTPUT_MAX_LINES};\n"
-          dbms_output_get_sql = "DBMS_OUTPUT.GET_LINES(:dbms_output_lines, l_dbms_output_numlines);\n"
-          @bind_values[:dbms_output_lines] = nil
-          @bind_metadata[:dbms_output_lines] = {:data_type => 'TABLE', :data_length => nil,
-            :sql_type_name => "SYS.DBMSOUTPUT_LINESARRAY", :in_out => 'OUT'}
-        # if database version is less than 10.2 then use individual DBMS_OUTPUT.GET_LINE calls
-        else
-          dbms_output_get_sql = ""
-        end
-        [dbms_output_enable_sql, dbms_output_get_sql]
-      else
-        ["", ""]
-      end
+    def dbms_output_enable_sql
+      @dbms_output_stream ? "DBMS_OUTPUT.ENABLE(#{@schema.dbms_output_buffer_size});\n" : ""
     end
 
-    def dbms_output_log
+    def dbms_output_lines
+      lines = []
       if @dbms_output_stream
-        # if database version is at least 10.2 then :dbms_output_lines output bind variable has dbms_output lines
-        if @bind_metadata[:dbms_output_lines]
-          @cursor[':dbms_output_lines'].each do |line|
-            @dbms_output_stream.puts "DBMS_OUTPUT: #{line}" if line
-          end
-        # if database version is less than 10.2 then use individual DBMS_OUTPUT.GET_LINE calls
+        if (@schema.connection.database_version <=> [10, 2, 0, 0]) >= 0
+          cursor = @schema.connection.parse("BEGIN DBMS_OUTPUT.GET_LINES(:dbms_output_lines, :dbms_output_numlines); END;\n")
+          cursor.bind_param(':dbms_output_lines', nil,
+                            :data_type => 'TABLE',
+                            :data_length => nil,
+                            :sql_type_name => "SYS.DBMSOUTPUT_LINESARRAY",
+                            :in_out => 'OUT')
+          cursor.bind_param(':dbms_output_numlines', Schema::DBMS_OUTPUT_MAX_LINES, :data_type => 'NUMBER', :in_out => 'IN/OUT')
+          cursor.exec
+          lines = cursor[':dbms_output_lines']
+          cursor.close
         else
           cursor = @schema.connection.parse("BEGIN sys.dbms_output.get_line(:line, :status); END;")
           while true do
@@ -574,14 +561,21 @@ module PLSQL
             cursor.bind_param(':status', nil, :data_type => 'NUMBER', :in_out => 'OUT')
             cursor.exec
             break unless cursor[':status'] == 0
-            @dbms_output_stream.puts "DBMS_OUTPUT: #{cursor[':line']}"
+            lines << cursor[':line']
           end
           cursor.close
         end
-        @dbms_output_stream.flush
       end
+      lines
+    end
+
+    def dbms_output_log
+      dbms_output_lines.each do |line|
+        @dbms_output_stream.puts "DBMS_OUTPUT: #{line}" if line
+      end
+      @dbms_output_stream.flush if @dbms_output_stream
     end
 
   end
 
-end
+end

data/ruby-plsql.gemspec

@@ -2,16 +2,16 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: ruby-plsql 0.5.2 ruby lib
+# stub: ruby-plsql 0.5.3 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "ruby-plsql"
-  s.version = "0.5.2"
+  s.version = "0.5.3"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib"]
   s.authors = ["Raimonds Simanovskis"]
-  s.date = "2014-10-23"
+  s.date = "2015-05-07"
   s.description = "ruby-plsql gem provides simple Ruby API for calling Oracle PL/SQL procedures.\nIt could be used both for accessing Oracle PL/SQL API procedures in legacy applications\nas well as it could be used to create PL/SQL unit tests using Ruby testing libraries.\n"
   s.email = "raimonds.simanovskis@gmail.com"
   s.extra_rdoc_files = [
@@ -24,6 +24,7 @@ Gem::Specification.new do |s|
     "README.md",
     "Rakefile",
     "VERSION",
+    "Vagrantfile",
     "lib/plsql/connection.rb",
     "lib/plsql/helpers.rb",
     "lib/plsql/jdbc_connection.rb",
@@ -55,10 +56,12 @@ Gem::Specification.new do |s|
     "spec/plsql/version_spec.rb",
     "spec/plsql/view_spec.rb",
     "spec/spec.opts",
-    "spec/spec_helper.rb"
+    "spec/spec_helper.rb",
+    "spec/support/file_check_script.sh",
+    "spec/support/test_db.rb"
   ]
   s.homepage = "http://github.com/rsim/ruby-plsql"
-  s.rubygems_version = "2.2.2"
+  s.rubygems_version = "2.4.6"
   s.summary = "Ruby API for calling Oracle PL/SQL procedures."
 
   if s.respond_to? :specification_version then
@@ -67,14 +70,14 @@ Gem::Specification.new do |s|
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
       s.add_development_dependency(%q<jeweler>, ["~> 2.0.1"])
       s.add_development_dependency(%q<rspec>, ["~> 3.1"])
-      s.add_development_dependency(%q<activerecord>, ["< 4.2.0", ">= 3.2.3"])
+      s.add_development_dependency(%q<activerecord>, ["< 4.3.0", ">= 3.2.3"])
       s.add_development_dependency(%q<activerecord-oracle_enhanced-adapter>, ["< 1.6.0", ">= 1.4.1"])
       s.add_development_dependency(%q<simplecov>, [">= 0"])
       s.add_development_dependency(%q<ruby-oci8>, ["~> 2.1.2"])
     else
       s.add_dependency(%q<jeweler>, ["~> 2.0.1"])
       s.add_dependency(%q<rspec>, ["~> 3.1"])
-      s.add_dependency(%q<activerecord>, ["< 4.2.0", ">= 3.2.3"])
+      s.add_dependency(%q<activerecord>, ["< 4.3.0", ">= 3.2.3"])
       s.add_dependency(%q<activerecord-oracle_enhanced-adapter>, ["< 1.6.0", ">= 1.4.1"])
       s.add_dependency(%q<simplecov>, [">= 0"])
       s.add_dependency(%q<ruby-oci8>, ["~> 2.1.2"])
@@ -82,7 +85,7 @@ Gem::Specification.new do |s|
   else
     s.add_dependency(%q<jeweler>, ["~> 2.0.1"])
     s.add_dependency(%q<rspec>, ["~> 3.1"])
-    s.add_dependency(%q<activerecord>, ["< 4.2.0", ">= 3.2.3"])
+    s.add_dependency(%q<activerecord>, ["< 4.3.0", ">= 3.2.3"])
     s.add_dependency(%q<activerecord-oracle_enhanced-adapter>, ["< 1.6.0", ">= 1.4.1"])
     s.add_dependency(%q<simplecov>, [">= 0"])
     s.add_dependency(%q<ruby-oci8>, ["~> 2.1.2"])

data/spec/plsql/connection_spec.rb

@@ -117,7 +117,7 @@ describe "Connection" do
         clob = OCI8::CLOB.new(@raw_conn, large_text)
         expect(@conn.ora_value_to_ruby_value(clob)).to eq large_text
       end
-      
+
     end
 
   # JRuby
@@ -132,19 +132,23 @@ describe "Connection" do
       it "should translate PL/SQL NUMBER to Ruby BigDecimal" do
         expect(@conn.plsql_to_ruby_data_type(:data_type => "NUMBER", :data_length => 15)).to eq [BigDecimal, nil]
       end
-      
+
       it "should translate PL/SQL DATE to Ruby DateTime" do
         expect(@conn.plsql_to_ruby_data_type(:data_type => "DATE", :data_length => nil)).to eq [DateTime, nil]
       end
-      
+
       it "should translate PL/SQL TIMESTAMP to Ruby Time" do
         expect(@conn.plsql_to_ruby_data_type(:data_type => "TIMESTAMP", :data_length => nil)).to eq [Time, nil]
       end
-      
+
       it "should not translate Ruby Fixnum when BigDecimal type specified" do
         expect(@conn.ruby_value_to_ora_value(100, BigDecimal)).to eq java.math.BigDecimal.new(100)
       end
-      
+
+      it "should translate Ruby String to string value" do
+        expect(@conn.ruby_value_to_ora_value(1.1, String)).to eq '1.1'
+      end
+
       it "should translate Ruby Bignum value to BigDecimal when BigDecimal type specified" do
         big_decimal = @conn.ruby_value_to_ora_value(12345678901234567890, BigDecimal)
         expect(big_decimal).to eq java.math.BigDecimal.new("12345678901234567890")
@@ -167,7 +171,7 @@ describe "Connection" do
       it "should translate Oracle BigDecimal integer value to Fixnum" do
         expect(@conn.ora_value_to_ruby_value(BigDecimal("100"))).to eql(100)
       end
-      
+
       it "should translate Oracle BigDecimal float value to BigDecimal" do
         expect(@conn.ora_value_to_ruby_value(BigDecimal("100.11"))).to eql(BigDecimal("100.11"))
       end
@@ -210,7 +214,7 @@ describe "Connection" do
       expect(@conn.select_first("SELECT :1,:2,:3,:4,:5 FROM dual",
         'abc',123,123.456,@now,@today)).to eq ["abc",123,123.456,@now,Time.parse(@today.to_s)]
     end
-    
+
     it "should execute SQL statement with NULL values and return first result" do
       @now = Time.local(2008,05,31,23,22,11)
       expect(@conn.select_first("SELECT NULL,123,123.456,
@@ -226,7 +230,7 @@ describe "Connection" do
         expect(@conn.select_first("SELECT :1,:2,:3,:4,:5 FROM dual",
           nil,123,123.456,@now,@today)).to eq [nil,123,123.456,@now,Time.parse(@today.to_s)]
       end
-    
+
     end
 
     it "should execute SQL statement and return all results" do
@@ -254,7 +258,7 @@ describe "Connection" do
       expect(@conn.select_all("SELECT :1,:2,:3,:4 FROM dual UNION ALL SELECT :1,:2,:3,:4 FROM dual",
         'abc',123,123.456,@now,'abc',123,123.456,@now)).to eq [["abc",123,123.456,@now],["abc",123,123.456,@now]]
     end
-    
+
     it "should execute SQL statement and yield all results in block" do
       @now = Time.local(2008,05,31,23,22,11)
       expect(@conn.select_all("SELECT 'abc',123,123.456,
@@ -266,7 +270,7 @@ describe "Connection" do
         expect(r).to eq ["abc",123,123.456,@now]
       end).to eq 2
     end
-    
+
     it "should execute SQL statement with bind parameters and yield all results in block" do
       @now = Time.local(2008,05,31,23,22,11)
       expect(@conn.select_all("SELECT :1,:2,:3,:4 FROM dual UNION ALL SELECT :1,:2,:3,:4 FROM dual",
@@ -276,7 +280,7 @@ describe "Connection" do
     end
 
   end
-  
+
   describe "PL/SQL procedures" do
     before(:all) do
       @random = rand(1000)
@@ -313,9 +317,9 @@ describe "Connection" do
       expect(cursor[":p_date"]).to eq @now
       expect(cursor.close).to be_nil
     end
-  
+
   end
-  
+
   describe "commit and rollback" do
     before(:all) do
       expect(@conn.exec("CREATE TABLE test_commit (dummy VARCHAR2(100))")).to be true

data/spec/plsql/package_spec.rb

@@ -47,6 +47,14 @@ describe "Package" do
     expect(plsql.test_package.test_procedure('xxx')).to eq('XXX')
   end
 
+  it "should report an existing procedure as existing" do
+    expect(plsql.test_package.procedure_defined?(:test_procedure)).to be_truthy
+  end
+
+  it "should report an inexistent procedure as not existing" do
+    expect(plsql.test_package.procedure_defined?(:inexistent_procedure)).to be_falsey
+  end
+
   describe "variables" do
     it "should set and get package variable value" do
       plsql.test_package.test_variable = 1

data/spec/plsql/schema_spec.rb

@@ -227,10 +227,13 @@ describe "DBMS_OUTPUT logging" do
   before(:all) do
     plsql.connection = get_connection
     plsql.execute <<-SQL
-      CREATE OR REPLACE PROCEDURE test_dbms_output(p_string VARCHAR2)
+      CREATE OR REPLACE PROCEDURE test_dbms_output(p_string VARCHAR2, p_raise_error BOOLEAN := false)
       IS
       BEGIN
         DBMS_OUTPUT.PUT_LINE(p_string);
+        IF p_raise_error THEN
+          RAISE_APPLICATION_ERROR(-20000 - 12, 'Test Error');
+        END IF;
       END;
     SQL
     plsql.execute <<-SQL
@@ -272,6 +275,11 @@ describe "DBMS_OUTPUT logging" do
       expect(@buffer.string).to eq("DBMS_OUTPUT: test_dbms_output\n")
     end
 
+    it "should log output to specified stream in case of exception" do
+      expect { plsql.test_dbms_output("test_dbms_output", true) }.to raise_error /Test Error/
+      expect(@buffer.string).to eq("DBMS_OUTPUT: test_dbms_output\n")
+    end
+
     it "should not log output to stream when output is disabled" do
       plsql.test_dbms_output("enabled")
       plsql.dbms_output_stream = nil

data/spec/spec_helper.rb

@@ -23,7 +23,16 @@ end
 
 require 'ruby-plsql'
 
-DATABASE_NAME = ENV['DATABASE_NAME'] || 'orcl'
+# Requires supporting ruby files with custom matchers and macros, etc,
+# in spec/support/ and its subdirectories.
+Dir[File.join(File.dirname(__FILE__), 'support/**/*.rb')].each {|f| require f}
+
+if ENV['USE_VM_DATABASE'] == 'Y'
+  DATABASE_NAME = 'XE'
+else
+  DATABASE_NAME = ENV['DATABASE_NAME'] || 'orcl'
+end
+
 DATABASE_SERVICE_NAME = (defined?(JRUBY_VERSION) ? "/" : "") +
                         (ENV['DATABASE_SERVICE_NAME'] || DATABASE_NAME)
 DATABASE_HOST = ENV['DATABASE_HOST'] || 'localhost'
@@ -35,6 +44,20 @@ DATABASE_USERS_AND_PASSWORDS = [
 # specify which database version is used (will be verified in one test)
 DATABASE_VERSION = ENV['DATABASE_VERSION'] || '10.2.0.4'
 
+if ENV['USE_VM_DATABASE'] == 'Y'
+  RSpec.configure do |config|
+    config.before(:suite) do
+      TestDb.build
+
+      # Set Verbose off to hide warning: already initialized constant DATABASE_VERSION
+      original_verbosity = $VERBOSE
+      $VERBOSE           = nil
+      DATABASE_VERSION   = TestDb.database_version
+      $VERBOSE           = original_verbosity
+    end
+  end
+end
+
 def get_eazy_connect_url(svc_separator = "")
   "#{DATABASE_HOST}:#{DATABASE_PORT}#{svc_separator}#{DATABASE_SERVICE_NAME}"
 end

data/spec/support/file_check_script.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+set -e
+
+FILE=/vagrant/oracle-xe-11.2.0-1.0.x86_64.rpm.zip
+
+if [ ! -f "$FILE" ] ; then
+  echo "Oracle XE database installation (oracle-xe-11.2.0-1.0.x86_64.rpm.zip) can not be found. Please download from Oracle homepage and put it into project home directory."
+  exit 1
+fi

data/spec/support/test_db.rb

@@ -0,0 +1,150 @@
+class TestDb
+
+  DATABASE_USERS = %w{hr arunit}
+
+  def self.build
+    db = self.new
+    db.cleanup_database_users
+    db.create_user_tablespace
+    db.setup_database_users
+    db.connection.logoff
+  end
+
+  def self.database_version
+     db = self.new
+     db.database_version
+  end
+
+  def connection
+    unless defined?(@connection)
+      begin
+        Timeout::timeout(5) {
+          if defined?(JRUBY_VERSION)
+            @connection = java.sql.DriverManager.get_connection(
+              'jdbc:oracle:thin:@127.0.0.1:1521/XE',
+              'system',
+              'oracle'
+            );
+          else
+            @connection = OCI8.new(
+              'system',
+              'oracle',
+              '(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=127.0.0.1)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=XE)))'
+            )
+          end
+        }
+      rescue Timeout::Error
+        raise "Cannot establish connection with Oracle database as SYSTEM user. Seams you need to start local Oracle database"
+      end
+    end
+    @connection
+  end
+
+  def create_user_tablespace
+    return unless connection
+    execute_statement(<<-STATEMENT
+      DECLARE
+        v_exists number;
+      BEGIN
+        SELECT count(1)
+          INTO v_exists
+          FROM dba_tablespaces
+          WHERE tablespace_name = 'TBS_USERS';
+
+          IF v_exists = 0 THEN
+            EXECUTE IMMEDIATE 'ALTER SYSTEM SET DB_CREATE_FILE_DEST = ''/u01/app/oracle/oradata/XE''';
+            EXECUTE IMMEDIATE 'CREATE TABLESPACE TBS_USERS DATAFILE ''tbs_users.dat'' SIZE 10M REUSE AUTOEXTEND ON NEXT 10M MAXSIZE 200M';
+          END IF;
+      END;
+      STATEMENT
+      )
+  end
+
+  def database_users
+    DATABASE_USERS.inject([]){|array, user| array << [user.upcase, user]}
+  end
+
+  def cleanup_database_users
+    return unless connection
+    database_users.each do | db, _ |
+      execute_statement(<<-STATEMENT
+        DECLARE
+           v_count INTEGER := 0;
+           l_cnt   INTEGER;
+        BEGIN
+
+          SELECT COUNT (1)
+            INTO v_count
+            FROM dba_users
+            WHERE username = '#{db}';
+
+          IF v_count != 0 THEN
+            FOR x IN (SELECT *
+                        FROM v$session
+                        WHERE username = '#{db}')
+            LOOP
+              EXECUTE IMMEDIATE 'ALTER SYSTEM DISCONNECT SESSION ''' || x.sid || ',' || x.serial# || ''' IMMEDIATE';
+            END LOOP;
+
+            EXECUTE IMMEDIATE ('DROP USER #{db} CASCADE');
+          END IF;
+        END;
+        STATEMENT
+      )
+    end
+  end
+
+  def setup_database_users
+    return unless connection
+    database_users.each do | db, passwd |
+      execute_statement(<<-STATEMENT
+        DECLARE
+           v_count INTEGER := 0;
+        BEGIN
+
+          SELECT COUNT (1)
+            INTO v_count
+            FROM dba_users
+            WHERE username = '#{db}';
+
+          IF v_count = 0 THEN
+            EXECUTE IMMEDIATE ('CREATE USER #{db} IDENTIFIED BY #{passwd} DEFAULT TABLESPACE TBS_USERS QUOTA 10m ON TBS_USERS');
+            EXECUTE IMMEDIATE ('GRANT create session, create table, create sequence, create procedure, create type, create view, create synonym TO #{db}');
+          END IF;
+        END;
+        STATEMENT
+      )
+    end
+  end
+
+  def database_version
+    query = 'SELECT version FROM V$INSTANCE'
+
+    if defined?(JRUBY_VERSION)
+      statement = connection.create_statement
+      resource  = statement.execute_query(query)
+
+      resource.next
+      value = resource.get_string('VERSION')
+
+      resource.close
+      statement.close
+    else
+      cursor = execute_statement(query)
+      value = cursor.fetch()[0]
+      cursor.close
+    end
+
+    value.match(/(.*)\.\d$/)[1]
+  end
+
+  def execute_statement(statement)
+    if defined?(JRUBY_VERSION)
+      statement = connection.prepare_call(statement)
+      statement.execute
+      statement.close
+    else
+      connection.exec(statement)
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby-plsql
 version: !ruby/object:Gem::Version
-  version: 0.5.2
+  version: 0.5.3
 platform: ruby
 authors:
 - Raimonds Simanovskis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-10-23 00:00:00.000000000 Z
+date: 2015-05-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jeweler
@@ -44,7 +44,7 @@ dependencies:
     requirements:
     - - "<"
       - !ruby/object:Gem::Version
-        version: 4.2.0
+        version: 4.3.0
     - - ">="
       - !ruby/object:Gem::Version
         version: 3.2.3
@@ -54,7 +54,7 @@ dependencies:
     requirements:
     - - "<"
       - !ruby/object:Gem::Version
-        version: 4.2.0
+        version: 4.3.0
     - - ">="
       - !ruby/object:Gem::Version
         version: 3.2.3
@@ -122,6 +122,7 @@ files:
 - README.md
 - Rakefile
 - VERSION
+- Vagrantfile
 - lib/plsql/connection.rb
 - lib/plsql/helpers.rb
 - lib/plsql/jdbc_connection.rb
@@ -154,6 +155,8 @@ files:
 - spec/plsql/view_spec.rb
 - spec/spec.opts
 - spec/spec_helper.rb
+- spec/support/file_check_script.sh
+- spec/support/test_db.rb
 homepage: http://github.com/rsim/ruby-plsql
 licenses: []
 metadata: {}
@@ -173,7 +176,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.4.6
 signing_key: 
 specification_version: 4
 summary: Ruby API for calling Oracle PL/SQL procedures.