ruby-plsql 0.5.3 → 0.8.0

data/.travis/setup_accounts.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+
+set -ev
+
+"$ORACLE_HOME/bin/sqlplus" -L -S / AS SYSDBA <<SQL
+@@spec/support/unlock_and_setup_hr_user.sql
+@@spec/support/create_arunit_user.sql
+exit
+SQL

data/Gemfile

@@ -1,16 +1,24 @@
-source 'http://rubygems.org'
+source "http://rubygems.org"
 
 group :development do
-  gem 'jeweler', '~> 2.0.1'
-  gem 'rspec', '~> 3.1'
+  gem "juwelier", "~> 2.0"
+  gem "rspec_junit_formatter"
+  gem "rubocop", "0.81", require: false
+  gem "rubocop-performance", require: false
+  gem "rubocop-rails", require: false
+end
+
+group :test, :development do
+  gem "rake", ">= 10.0"
+  gem "rspec", "~> 3.1"
 
-  unless ENV['NO_ACTIVERECORD']
-    gem 'activerecord', '>= 3.2.3', '< 4.3.0'
-    gem 'activerecord-oracle_enhanced-adapter', '>= 1.4.1', '< 1.6.0'
-    gem 'simplecov', '>= 0'
+  unless ENV["NO_ACTIVERECORD"]
+    gem "activerecord", "~> 5.0"
+    gem "activerecord-oracle_enhanced-adapter", "~> 1.7"
+    gem "simplecov", ">= 0"
   end
 
-  platforms :ruby do
-    gem 'ruby-oci8', '~> 2.1.2'
+  platforms :ruby, :mswin, :mingw do
+    gem "ruby-oci8", "~> 2.1"
   end
 end

data/History.txt

@@ -1,3 +1,79 @@
+== 0.8.0 2021-08-10
+* Improvements and fixes
+  * Support Rails 6.1 [#193]
+  * Support Rails 6.0 [#178]
+  * Support Oracle Database 18c or higher [#196]
+  * case-insensitive table names and proc params [#185]
+  * Use OCI driver type for RUBY_ENGINE TruffleRuby [#190]
+  * Replace NativeException with Java::JavaSql::SQLException [#192]
+  * Fixnum and Bignum are deprecated in Ruby 2.4 [#191]
+
+* CI
+  * Run CI with GitHub Actions [#198]
+  * CI against Rails 6.1 [#193]
+  * CI against Rails 6.0 [#178]
+  * CI against Ruby 3.0.2, 2.7.4 and 2.6.8 [#197]
+  * Exclude jruby-head with Rails main [#194]
+  * Exclude jruby-head with Rails main [#194]
+  * Bump RuboCop version to 0.81.0 [#186]
+  * Run RuboCop using GitHub Actions [#180, #182]
+  * Remove .codeclimate.yml [#181]
+  * Fallback to bundler 1.7.13 [#171]
+  * Terminate CI against Ruby 2.2.x [#172]
+  * Use Ubuntu Xenial at Travis CI [#176]
+
+== 0.7.1 2018-09-03
+* Fix
+  * Address incorrect versions in Gemfile 
+
+== 0.7.0 2018-09-03
+* Improvements and fixes
+
+  * Support Rails 5.0, 5.1 and 5.2
+  * Drop Rails 4.1 and 4.2 support
+  * Drop JRuby 1.7 support
+  * Drop JRuby 9.0 support
+  * Drop CRuby 2.1 or lower support
+  * Allow calling procedures in INVALID status
+  * Bignum, Fixnum, Integer fixes for Ruby 2.4
+  * Replace deprecated BigDecimal.new() with BigDecimal()
+  * Suppress warning `BigDecimal.new` is deprecated
+  * Avoid using `OCI8#describe_synonym`
+  * Allow ojdbc7.jar when Java version is 1.7 or higher
+  * Fix unguarded OCIError (breaks on JRuby)
+  * Suppress `warning: instance variable @dbms_output_stream not initialized`
+  * Suppress `warning: assigned but unused variable`
+  * Suppress `warning: shadowing outer local variable - column`
+  * Add license to gemspec
+  * Migrate from jeweler to juwelier
+  * CI against JRuby 9.1.8 and CRuby 2.4 and 2.5
+  * CI against jruby-head and ruby-head
+  * Enable RuboCop
+  * Set `disk_asynch_io` to `false`
+  * Skip XMLType specs if Oracle Database version is 12c or higher
+
+== 0.6.0 2016-03-13
+* Improvements
+  * Add support for records with boolean attributes - as input and output parameters and as return values of stored procedures
+  * Add support for VARCHAR, SIMPLE_INTEGER+subtypes
+  * Accessing to package objects via #[]
+  * Add XMLTYPE support for procedures and functions
+  * New procedure argument metadata option 'defaulted'
+  * Use current_schema in PLSQL::Schema#schema_name
+  * Add support for ruby-oci8 ~> 2.1 (was ~> 2.1.2) - as ruby-oci8 2.2.x is already available
+  * Add support for Oracle enhanced adapter 1.6.x
+* Bug fixes
+  * Time-zone configuration support fixes and improvements. Support for Session timezone from ENV['TZ'] removed
+  * Fix thread safety problem in PLSQL::OCIConnection::Cursor
+  * Fix: JRuby PLS_INTEGER, BINARY_INTEGER NULL value becomes 0
+* Internal (development) improvements
+  * Travis CI setup for the project
+  * Allow reporting of Unit Tests on Jenkins CI with "RspecJunitFormatter"
+  * Vagrant box CentOS version updated to v7.2
+  * Unit tests setup/teardown fixes for procedure_spec
+* Documentation
+  * Add reference to ruby-plsql cheat sheet
+
 == 0.5.3 2015-05-07
 
 * Improvements

data/README.md

@@ -1,3 +1,5 @@
+[![Build Status](https://travis-ci.com/rsim/ruby-plsql.svg?branch=master)](https://travis-ci.com/rsim/ruby-plsql)
+
 ruby-plsql
 ==========
 
@@ -8,9 +10,9 @@ DESCRIPTION
 
 ruby-plsql gem provides simple Ruby API for calling Oracle PL/SQL procedures. It could be used both for accessing Oracle PL/SQL API procedures in legacy applications as well as it could be used to create PL/SQL unit tests using Ruby testing libraries.
 
-NUMBER, BINARY_INTEGER, PLS_INTEGER, VARCHAR2, NVARCHAR2, CHAR, NCHAR, DATE, TIMESTAMP, CLOB, BLOB, BOOLEAN, PL/SQL RECORD, TABLE, VARRAY, OBJECT and CURSOR types are supported for input and output parameters and return values of PL/SQL procedures and functions.
+NUMBER, BINARY_INTEGER, PLS_INTEGER, NATURAL, NATURALN, POSITIVE, POSITIVEN, SIGNTYPE, SIMPLE_INTEGER, VARCHAR, VARCHAR2, NVARCHAR2, CHAR, NCHAR, DATE, TIMESTAMP, CLOB, BLOB, BOOLEAN, PL/SQL RECORD, TABLE, VARRAY, OBJECT and CURSOR types are supported for input and output parameters and return values of PL/SQL procedures and functions.
 
-ruby-plsql supports Ruby 1.8.7, 1.9.3, 2.1.3 and JRuby 1.6.7, 1.7.16 implementations.
+ruby-plsql supports Ruby 2.2, 2.3, 2.4, 2.5 (ruby-oci8 2.2.3+ is needed for Ruby 2.4) and JRuby 9.1 implementations.
 
 USAGE
 -----
@@ -117,6 +119,11 @@ plsql.activerecord_class = ActiveRecord::Base
 
 and then you do not need to specify plsql.connection (this is also safer when ActiveRecord reestablishes connection to database).
 
+
+### Cheat Sheet:
+
+You may have a look at this [Cheat Sheet](http://cheatography.com/jgebal/cheat-sheets/ruby-plsql-cheat-sheet/) for instructions on how to use ruby-plsql
+
 INSTALLATION
 ------------
 
@@ -128,15 +135,31 @@ or include gem in Gemfile if using bundler.
 
 In addition install either ruby-oci8 (for MRI/YARV) or copy Oracle JDBC driver to $JRUBY_HOME/lib (for JRuby).
 
-If you are using MRI 1.8, 1.9 or 2.x Ruby implementation then you need to install ruby-oci8 gem (version 2.0.x or 2.1.x)
+If you are using MRI Ruby implementation then you need to install ruby-oci8 gem (version 2.0.x or 2.1.x)
 as well as Oracle client, e.g. [Oracle Instant Client](http://www.oracle.com/technetwork/database/features/instant-client/index-097480.html).
 
-If you are using JRuby then you need to download latest [Oracle JDBC driver](http://www.oracle.com/technetwork/database/enterprise-edition/jdbc-112010-090769.html) - either ojdbc6.jar for Java 6, 7, 8 or ojdbc5.jar for Java 5. And copy this file to one of these locations:
+If you are using JRuby then you need to download latest [Oracle JDBC driver](http://www.oracle.com/technetwork/database/enterprise-edition/jdbc-112010-090769.html) - either ojdbc7.jar for Java 8 and 7, ojdbc6.jar for Java 6, 7, 8 or ojdbc5.jar for Java 5. You can refer [the support matrix](http://www.oracle.com/technetwork/database/enterprise-edition/jdbc-faq-090281.html#01_03) for details.
+
+And copy this file to one of these locations. JDBC driver will be searched in this order:
 
-* in `./lib` directory of Rails application and require it manually
-* in some directory which is in `PATH`
 * in `JRUBY_HOME/lib` directory
+* in `./lib` directory of Rails application
 * or include path to JDBC driver jar file in Java `CLASSPATH`
+* in some directory which is in `PATH`
+
+If you put multiple versions of JDBC driver in the same directory the higher version one will be used.
+
+Make sure to setup the following Oracle-specific environment variables properly
+
+* [NLS_LANG](http://www.orafaq.com/wiki/NLS_LANG) - preferred value `NLS_LANG=AMERICAN_AMERICA.AL32UTF8`
+* [ORA_SDTZ](http://docs.oracle.com/cd/E18283_01/server.112/e10729/ch4datetime.htm#CBBEEAFB) The setting should point a machine timezone like: `ORA_SDTZ=Europe/Riga`, otherwise Oracle by default uses a Fixed-offset timezone (like `03:00`) that is not daylight saving (DST) aware, which will lead to wrong translations of the timestamp values between Ruby code (DTS-aware) and Oracle session (non-DST-aware).
+* [ORACLE_HOME](http://www.orafaq.com/wiki/ORACLE_HOME)
+
+You may either alter your environment settings or set the values in file `spec/support/custom_config.rb`. Sample file `custom_config.rb.sample` shows how to do that.
+
+
+Make sure you use correct version of Oracle client for database you're connecting to. Otherwise you may encounter TimeZone errors like [this](http://stackoverflow.com/questions/7678485/oracle-ora-01805-on-oracle-11g-database)
+
 
 TESTS
 -----

data/Rakefile

@@ -1,5 +1,5 @@
-require 'rubygems'
-require 'bundler'
+require "rubygems"
+require "bundler"
 begin
   Bundler.setup(:default, :development)
 rescue Bundler::BundlerError => e
@@ -8,41 +8,46 @@ rescue Bundler::BundlerError => e
   exit e.status_code
 end
 
-require 'rake'
+require "rake"
 
-require 'jeweler'
-Jeweler::Tasks.new do |gem|
-  gem.name = "ruby-plsql"
-  gem.summary = "Ruby API for calling Oracle PL/SQL procedures."
-  gem.description = <<-EOS
-ruby-plsql gem provides simple Ruby API for calling Oracle PL/SQL procedures.
-It could be used both for accessing Oracle PL/SQL API procedures in legacy applications
-as well as it could be used to create PL/SQL unit tests using Ruby testing libraries.
-EOS
-  gem.email = "raimonds.simanovskis@gmail.com"
-  gem.homepage = "http://github.com/rsim/ruby-plsql"
-  gem.authors = ["Raimonds Simanovskis"]
-  gem.extra_rdoc_files = ['README.md']
+begin
+  require "juwelier"
+  Juwelier::Tasks.new do |gem|
+    gem.name = "ruby-plsql"
+    gem.summary = "Ruby API for calling Oracle PL/SQL procedures."
+    gem.description = <<-EOS
+  ruby-plsql gem provides simple Ruby API for calling Oracle PL/SQL procedures.
+  It could be used both for accessing Oracle PL/SQL API procedures in legacy applications
+  as well as it could be used to create PL/SQL unit tests using Ruby testing libraries.
+  EOS
+    gem.email = "raimonds.simanovskis@gmail.com"
+    gem.homepage = "http://github.com/rsim/ruby-plsql"
+    gem.license = "MIT".freeze
+    gem.authors = ["Raimonds Simanovskis"]
+    gem.extra_rdoc_files = ["README.md"]
+  end
+  Juwelier::RubygemsDotOrgTasks.new
+rescue LoadError
+  # juwelier not installed
 end
-Jeweler::RubygemsDotOrgTasks.new
 
-require 'rspec/core/rake_task'
+require "rspec/core/rake_task"
 RSpec::Core::RakeTask.new(:spec)
 
 desc "Code coverage detail"
 task :simplecov do
-  ENV['COVERAGE'] = "true"
-  Rake::Task['spec'].execute
+  ENV["COVERAGE"] = "true"
+  Rake::Task["spec"].execute
 end
 
-task :default => :spec
+task default: :spec
 
-require 'rdoc/task'
+require "rdoc/task"
 Rake::RDocTask.new do |rdoc|
-  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+  version = File.exist?("VERSION") ? File.read("VERSION") : ""
 
-  rdoc.rdoc_dir = 'doc'
+  rdoc.rdoc_dir = "doc"
   rdoc.title = "ruby-plsql #{version}"
-  rdoc.rdoc_files.include('README*')
-  rdoc.rdoc_files.include('lib/**/*.rb')
+  rdoc.rdoc_files.include("README*")
+  rdoc.rdoc_files.include("lib/**/*.rb")
 end

data/VERSION

@@ -1 +1 @@
-0.5.3
+0.8.0

data/Vagrantfile

@@ -4,7 +4,7 @@ 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.box = "boxcutter/centos72"
   config.vm.hostname = "vagrant.oracle"
   config.vm.network :forwarded_port, guest: 1521, host: 1521
 
@@ -23,13 +23,13 @@ Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
   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: "unzip -o -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: '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: '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

data/ci/network/admin/tnsnames.ora

@@ -0,0 +1,7 @@
+XEPDB1 =
+  (DESCRIPTION =
+    (ADDRESS = (PROTOCOL = TCP)(HOST = 127.0.0.1)(PORT = 1521))
+    (CONNECT_DATA =
+      (SERVICE_NAME = XEPDB1)
+    )
+  )

data/ci/setup_accounts.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+
+set -ev
+
+${ORACLE_HOME}/bin/sqlplus system/${DATABASE_SYS_PASSWORD}@${DATABASE_NAME} <<SQL
+@@spec/support/unlock_and_setup_hr_user.sql
+@@spec/support/create_arunit_user.sql
+exit
+SQL

data/gemfiles/Gemfile.activerecord-5.0

@@ -0,0 +1,21 @@
+source 'http://rubygems.org'
+
+group :development do
+  gem 'juwelier', '~> 2.0'
+  gem 'rspec_junit_formatter'
+end
+
+group :test, :development do
+  gem 'rake', '>= 10.0'
+  gem 'rspec', '~> 3.1'
+
+  unless ENV['NO_ACTIVERECORD']
+    gem 'activerecord', '~> 5.0.0'
+    gem 'activerecord-oracle_enhanced-adapter', '~> 1.7.0'
+    gem 'simplecov', '>= 0'
+  end
+
+  platforms :ruby, :mswin, :mingw do
+    gem 'ruby-oci8', '~> 2.1'
+  end
+end

data/gemfiles/Gemfile.activerecord-5.1

@@ -0,0 +1,21 @@
+source 'http://rubygems.org'
+
+group :development do
+  gem 'juwelier', '~> 2.0'
+  gem 'rspec_junit_formatter'
+end
+
+group :test, :development do
+  gem 'rake', '>= 10.0'
+  gem 'rspec', '~> 3.1'
+
+  unless ENV['NO_ACTIVERECORD']
+    gem 'activerecord', '~> 5.1.0'
+    gem 'activerecord-oracle_enhanced-adapter', '~> 1.8.0'
+    gem 'simplecov', '>= 0'
+  end
+
+  platforms :ruby, :mswin, :mingw do
+    gem 'ruby-oci8', '~> 2.1'
+  end
+end

data/gemfiles/Gemfile.activerecord-5.2

@@ -0,0 +1,21 @@
+source 'http://rubygems.org'
+
+group :development do
+  gem 'juwelier', '~> 2.0'
+  gem 'rspec_junit_formatter'
+end
+
+group :test, :development do
+  gem 'rake', '>= 10.0'
+  gem 'rspec', '~> 3.1'
+
+  unless ENV['NO_ACTIVERECORD']
+    gem 'activerecord', '~> 5.2.0.beta'
+    gem 'activerecord-oracle_enhanced-adapter', '~> 5.2.0.beta'
+    gem 'simplecov', '>= 0'
+  end
+
+  platforms :ruby, :mswin, :mingw do
+    gem 'ruby-oci8', '~> 2.1'
+  end
+end

data/gemfiles/Gemfile.activerecord-6.0

@@ -0,0 +1,21 @@
+source 'http://rubygems.org'
+
+group :development do
+  gem 'juwelier', '~> 2.0'
+  gem 'rspec_junit_formatter'
+end
+
+group :test, :development do
+  gem 'rake', '>= 10.0'
+  gem 'rspec', '~> 3.1'
+
+  unless ENV['NO_ACTIVERECORD']
+    gem 'activerecord', '~> 6.0.0.rc1'
+    gem 'activerecord-oracle_enhanced-adapter', '~>6.0.0.rc1'
+    gem 'simplecov', '>= 0'
+  end
+
+  platforms :ruby, :mswin, :mingw do
+    gem 'ruby-oci8', '~> 2.1'
+  end
+end

data/gemfiles/Gemfile.activerecord-6.1

@@ -0,0 +1,21 @@
+source 'http://rubygems.org'
+
+group :development do
+  gem 'juwelier', '~> 2.0'
+  gem 'rspec_junit_formatter'
+end
+
+group :test, :development do
+  gem 'rake', '>= 10.0'
+  gem 'rspec', '~> 3.1'
+
+  unless ENV['NO_ACTIVERECORD']
+    gem 'activerecord', '~> 6.1.0'
+    gem 'activerecord-oracle_enhanced-adapter', '~>6.1.0'
+    gem 'simplecov', '>= 0'
+  end
+
+  platforms :ruby, :mswin, :mingw do
+    gem 'ruby-oci8', '~> 2.1'
+  end
+end

data/gemfiles/Gemfile.activerecord-main

@@ -0,0 +1,21 @@
+source 'http://rubygems.org'
+
+group :development do
+  gem 'juwelier', '~> 2.0'
+  gem 'rspec_junit_formatter'
+end
+
+group :test, :development do
+  gem 'rake', '>= 10.0'
+  gem 'rspec', '~> 3.1'
+
+  unless ENV['NO_ACTIVERECORD']
+    gem 'activerecord',   github: 'rails/rails', branch: 'main'
+    gem 'activerecord-oracle_enhanced-adapter', github: 'rsim/oracle-enhanced', branch: 'master'
+    gem 'simplecov', '>= 0'
+  end
+
+  platforms :ruby, :mswin, :mingw do
+    gem 'ruby-oci8', '~> 2.1'
+  end
+end