ruby-oci8 2.1.8 → 2.2.0.1

data/lib/oci8/oci8.rb

@@ -1,6 +1,6 @@
 # oci8.rb -- OCI8
 #
-# Copyright (C) 2002-2013 Kubo Takehiro <kubo@jiubao.org>
+# Copyright (C) 2002-2015 Kubo Takehiro <kubo@jiubao.org>
 #
 # Original Copyright is:
 #   Oracle module for Ruby
@@ -140,10 +140,12 @@ class OCI8
       @session_handle.send(:attr_set_string, OCI_ATTR_USERNAME, username) if username
       @session_handle.send(:attr_set_string, OCI_ATTR_PASSWORD, password) if password
       if @@oracle_client_version >= ORAVER_11_1
-        # 'rubyoci8' is displayed in V$SESSION_CONNECT_INFO.CLIENT_DRIVER
+        # Sets the driver name displayed in V$SESSION_CONNECT_INFO.CLIENT_DRIVER
         # if both the client and the server are Oracle 11g or upper.
+        # Only the first 8 chracters "ruby-oci" are displayed when the Oracle
+        # server version is lower than 12.0.1.2.
         # 424: OCI_ATTR_DRIVER_NAME
-        @session_handle.send(:attr_set_string, 424, 'rubyoci8')
+        @session_handle.send(:attr_set_string, 424, "ruby-oci8 : #{OCI8::VERSION}")
       end
       server_attach(dbname, attach_mode)
       session_begin(cred ? cred : OCI_CRED_RDBMS, mode ? mode : OCI_DEFAULT)
@@ -157,7 +159,7 @@ class OCI8
       attr_set_ub4(176, stmt_cache_size) # 176: OCI_ATTR_STMTCACHESIZE
     end
 
-    @prefetch_rows = nil
+    @prefetch_rows = 100
     @username = nil
   end
 
@@ -329,12 +331,12 @@ class OCI8
     end
   end
 
-  # Sets the prefetch rows size. The default value is one.
+  # Sets the prefetch rows size. The default value is 100.
   # When a select statement is executed, the OCI library allocate
   # prefetch buffer to reduce the number of network round trips by
   # retrieving specified number of rows in one round trip.
   #
-  # Note: Active record adaptors set 100 by default.
+  # Note: The default value had been 1 before ruby-oci8 2.2.0.
   def prefetch_rows=(num)
     @prefetch_rows = num
   end
@@ -531,19 +533,16 @@ class OraDate
     Date.new(year, month, day)
   end
 
-  if defined? DateTime # ruby 1.8.0 or upper
-
-    # timezone offset of the time the command started
-    # @private
-    @@tz_offset = Time.now.utc_offset.to_r/86400
+  # timezone offset of the time the command started
+  # @private
+  @@tz_offset = Time.now.utc_offset.to_r/86400
 
-    # Returns a DateTime object which denotes self.
-    #
-    # Note that this is not daylight saving time aware.
-    # The Time zone offset is that of the time the command started.
-    def to_datetime
-      DateTime.new(year, month, day, hour, minute, second, @@tz_offset)
-    end
+  # Returns a DateTime object which denotes self.
+  #
+  # Note that this is not daylight saving time aware.
+  # The Time zone offset is that of the time the command started.
+  def to_datetime
+    DateTime.new(year, month, day, hour, minute, second, @@tz_offset)
   end
 
   # @private

data/lib/oci8/properties.rb

@@ -15,10 +15,6 @@ class OCI8
     :cancel_read_at_exit => false,
   }
 
-  if OCI8.oracle_client_version < OCI8::ORAVER_9_2
-    @@properties[:statement_cache_size] = nil
-  end
-
   # @private
   def @@properties.[](name)
     raise IndexError, "No such property name: #{name}" unless @@properties.has_key?(name)
@@ -45,9 +41,6 @@ class OCI8
         raise ArgumentError, "float_conversion_type's value should be either :ruby or :oracle."
       end
     when :statement_cache_size
-      if OCI8.oracle_client_version < OCI8::ORAVER_9_2
-        raise RuntimeError, ":statement_cache_size is disabled on Oracle 9iR1 client."
-      end
       val = val.to_i
       raise ArgumentError, "The property value for :statement_cache_size must not be negative." if val < 0
     when :events_mode
@@ -101,7 +94,7 @@ class OCI8
   #     From ruby 1.9.2, a float value converted from Oracle number 15.7 by
   #     the Oracle function OCINumberToReal() makes a string representation
   #     15.700000000000001 by Float#to_s.
-  #     See: http://rubyforge.org/forum/forum.php?thread_id=50030&forum_id=1078
+  #     See: https://web.archive.org/web/20140521195004/https://rubyforge.org/forum/forum.php?thread_id=50030&forum_id=1078
   #     
   #     *Since:* 2.1.0
   #
@@ -109,7 +102,6 @@ class OCI8
   #     
   #     The statement cache size per each session. The default size is 0, which
   #     means no statement cache, since 2.1.2. It was 20 in 2.1.1.
-  #     This feature is available on Oracle 9iR2 or later.
   #     See: http://docs.oracle.com/cd/E11882_01/appdev.112/e10646/oci09adv.htm#i471377
   #     
   #     *Since:* 2.1.1

data/lib/oci8/version.rb

@@ -0,0 +1,3 @@
+class OCI8
+  VERSION = "2.2.0.1"
+end

data/ruby-oci8.gemspec

@@ -14,15 +14,25 @@ else
   gem_platform = Gem::Platform::RUBY
 end
 
+if defined? OCI8
+  oci8_version = OCI8::VERSION
+else
+  # Load oci8/version.rb temporarily and delete OCI8.
+  # Some 'bundler' tasks load this file before 'require "oci8"'
+  # and fail with 'TypeError: superclass mismatch for class OCI8.'
+  Kernel.load File.dirname(__FILE__) + '/lib/oci8/version.rb'
+  oci8_version = OCI8::VERSION
+  Object.send(:remove_const, :OCI8)
+end
+
 spec = Gem::Specification.new do |s|
   s.name = 'ruby-oci8'
-  s.version = File.read('VERSION').strip
+  s.version = oci8_version
   s.summary = 'Ruby interface for Oracle using OCI8 API'
   s.email = 'kubo@jiubao.org'
-  s.homepage = 'https://github.com/kubo/ruby-oci8/'
-  s.rubyforge_project = 'ruby-oci8'
+  s.homepage = 'http://www.rubydoc.info/github/kubo/ruby-oci8'
   s.description = <<EOS
-ruby-oci8 is a ruby interface for Oracle using OCI8 API. It is available with Oracle8i, Oracle9i, Oracle10g, Oracle11g and Oracle Instant Client.
+ruby-oci8 is a ruby interface for Oracle using OCI8 API. It is available with Oracle 10g or later including Oracle Instant Client.
 EOS
   s.has_rdoc = 'yard'
   s.authors = ['Kubo Takehiro']
@@ -31,7 +41,7 @@ EOS
   files = File.read('dist-files').split("\n")
   if gem_platform == Gem::Platform::RUBY
     s.extensions << 'ext/oci8/extconf.rb'
-    s.required_ruby_version = '>= 1.8.0'
+    s.required_ruby_version = '>= 1.9.1'
   else
     so_files = Dir.glob('ext/oci8/oci8lib_*.so')
     so_vers = so_files.collect do |file|

data/test/test_oci8.rb

@@ -481,8 +481,20 @@ EOS
   def test_client_driver_name
     if OCI8.oracle_client_version >= OCI8::ORAVER_11_1 and @conn.oracle_server_version >= OCI8::ORAVER_11_1
       sid = @conn.select_one("select userenv('sid') from dual")[0].to_i
-      driver_name = @conn.select_one('select client_driver from v$session_connect_info where sid = :1', sid)[0]
-      assert_equal('rubyoci8', driver_name)
+      cursor = @conn.parse('select client_driver from v$session_connect_info where sid = :1')
+      cursor.exec(sid)
+      column_size = cursor.column_metadata[0].data_size
+      expected_value = case column_size
+                       when 30 # Oracle version >= 12.1.0.2
+                         "ruby-oci8 : #{OCI8::VERSION}"
+                       when 9  # Oracle version <  12.1.0.2
+                         'ruby-oci' # only the first 8 characters
+                       else
+                         raise "Unknown column size #{column_size}"
+                       end
+      driver_name = cursor.fetch[0]
+      cursor.close
+      assert_equal(expected_value, driver_name)
     end
   end
 end # TestOCI8

data/test/test_package_type.rb

@@ -0,0 +1,967 @@
+require 'oci8'
+require File.dirname(__FILE__) + '/config'
+
+if $oracle_version < OCI8::ORAVER_12_1
+  raise "Package types are not supported in this Oracle version."
+end
+
+conn = OCI8.new($dbuser, $dbpass, $dbname)
+test_package_version = nil
+begin
+  cursor = conn.parse('begin :1 := rb_test_pkg.package_version; end;')
+  cursor.bind_param(1, nil, Integer)
+  cursor.exec
+  test_package_version = cursor[1]
+  cursor.close
+rescue OCIError
+  raise if $!.code != 6550
+end
+raise <<EOS if test_package_version != 1
+You need to execute SQL statements in #{File.dirname(__FILE__)}/setup_test_package.sql as follows:
+
+  $ sqlplus USERNAME/PASSWORD
+  SQL> @test/setup_test_package.sql
+
+EOS
+
+class TestPackageType < Minitest::Test
+  def setup
+    @conn = get_oci8_connection
+  end
+
+  def teardown
+    @conn.logoff
+  end
+
+  def check_attributes(msg, obj, attrs)
+    attrs.each do |method, expected_value|
+      val = method.is_a?(Array) ? obj[method[0]] : obj.send(method)
+      if expected_value.is_a? Hash
+        check_attributes("#{msg} > #{method}", val, expected_value)
+      else
+        assert_equal(expected_value, val, "#{msg} > #{method}")
+      end
+    end
+  end
+
+  def test_describe_package
+    integer_type_attrs = {
+      :class => OCI8::Metadata::Type,
+      #:typecode => nil,
+      #:collection_typecode => nil,
+      :is_incomplete_type? => false,
+      :is_system_type? => true,
+      :is_predefined_type? => true,
+      :is_transient_type? => false,
+      :is_system_generated_type? => false,
+      :has_nested_table? => false,
+      :has_lob? => false,
+      :has_file? => false,
+      #:collection_element => nil,
+      :num_type_attrs => 0,
+      :num_type_methods => 0,
+      #:map_method => nil,
+      #:order_method => nil,
+      :is_invoker_rights? => false,
+      :name => 'INTEGER',
+      :schema_name => 'SYS',
+      :is_final_type? => true,
+      :is_instantiable_type? => true,
+      :is_subtype? => false,
+      :supertype_schema_name => nil,
+      :supertype_name => nil,
+      :package_name => nil,
+      :type_attrs => [],
+      #:type_methods => [],
+      :inspect => '#<OCI8::Metadata::Type:(0) SYS.INTEGER>', # TODO: change to "INTEGER"
+    }
+
+    pls_integer_type_attrs = {
+      :class => OCI8::Metadata::Type,
+      #:typecode => nil,
+      #:collection_typecode => nil,
+      :is_incomplete_type? => false,
+      :is_system_type? => true,
+      :is_predefined_type? => true,
+      :is_transient_type? => false,
+      :is_system_generated_type? => false,
+      :has_nested_table? => false,
+      :has_lob? => false,
+      :has_file? => false,
+      #:collection_element => nil,
+      :num_type_attrs => 0,
+      :num_type_methods => 0,
+      #:map_method => nil,
+      #:order_method => nil,
+      :is_invoker_rights? => false,
+      :name => 'PL/SQL PLS INTEGER',
+      :schema_name => 'SYS',
+      :is_final_type? => true,
+      :is_instantiable_type? => true,
+      :is_subtype? => false,
+      :supertype_schema_name => nil,
+      :supertype_name => nil,
+      :package_name => nil,
+      :type_attrs => [],
+      #:type_methods => [],
+      :inspect => '#<OCI8::Metadata::Type:(0) SYS.PL/SQL PLS INTEGER>', # TODO: change to "PLS_INTEGER"
+    }
+
+    boolean_type_attrs = {
+      :class => OCI8::Metadata::Type,
+      #:typecode => nil,
+      #:collection_typecode => nil,
+      :is_incomplete_type? => false,
+      :is_system_type? => true,
+      :is_predefined_type? => true,
+      :is_transient_type? => false,
+      :is_system_generated_type? => false,
+      :has_nested_table? => false,
+      :has_lob? => false,
+      :has_file? => false,
+      #:collection_element => nil,
+      :num_type_attrs => 0,
+      :num_type_methods => 0,
+      #:map_method => nil,
+      #:order_method => nil,
+      :is_invoker_rights? => false,
+      :name => 'PL/SQL BOOLEAN',
+      :schema_name => 'SYS',
+      :is_final_type? => true,
+      :is_instantiable_type? => true,
+      :is_subtype? => false,
+      :supertype_schema_name => nil,
+      :supertype_name => nil,
+      :package_name => nil,
+      :type_attrs => [],
+      #:type_methods => [],
+      :inspect => '#<OCI8::Metadata::Type:(0) SYS.PL/SQL BOOLEAN>', # TODO: change to "BOOLEAN"
+    }
+
+    varchar2_type_attrs = {
+      :class => OCI8::Metadata::Type,
+      #:typecode => nil,
+      #:collection_typecode => nil,
+      :is_incomplete_type? => false,
+      :is_system_type? => true,
+      :is_predefined_type? => true,
+      :is_transient_type? => false,
+      :is_system_generated_type? => false,
+      :has_nested_table? => false,
+      :has_lob? => false,
+      :has_file? => false,
+      #:collection_element => nil,
+      :num_type_attrs => 0,
+      :num_type_methods => 0,
+      #:map_method => nil,
+      #:order_method => nil,
+      :is_invoker_rights? => false,
+      :name => 'VARCHAR2',
+      :schema_name => 'SYS',
+      :is_final_type? => true,
+      :is_instantiable_type? => true,
+      :is_subtype? => false,
+      :supertype_schema_name => nil,
+      :supertype_name => nil,
+      :package_name => nil,
+      :type_attrs => [],
+      #:type_methods => #[],
+      :inspect => '#<OCI8::Metadata::Type:(0) SYS.VARCHAR2>', # TODO: change to "VARCHAR2"
+    }
+
+    array_of_integer_type_attrs = {
+      :class => OCI8::Metadata::Type,
+      :typecode => :named_collection,
+      :collection_typecode => :varray,
+      :is_incomplete_type? => false,
+      :is_system_type? => false,
+      :is_predefined_type? => false,
+      :is_transient_type? => false,
+      :is_system_generated_type? => false,
+      :has_nested_table? => false,
+      :has_lob? => false,
+      :has_file? => false,
+      :collection_element => {
+        :class => OCI8::Metadata::Collection,
+        :data_size => 22,
+        :typecode => :integer,
+        :data_type => :number,
+        :num_elems => 50,
+        :precision => 38,
+        :scale => 0,
+        :type_name => 'INTEGER',
+        :schema_name => 'SYS',
+        :type_metadata => integer_type_attrs,
+        :inspect => '#<OCI8::Metadata::Collection: NUMBER(38)>', # TODO: change to "INTEGER"
+      },
+      :num_type_attrs => 0,
+      :num_type_methods => 0,
+      :map_method => nil,
+      :order_method => nil,
+      :is_invoker_rights? => false,
+      :name => 'ARRAY_OF_INTEGER',
+      :schema_name => @conn.username,
+      :is_final_type? => true,
+      :is_instantiable_type? => true,
+      :is_subtype? => false,
+      :supertype_schema_name => nil,
+      :supertype_name => nil,
+      :package_name => 'RB_TEST_PKG',
+      :type_attrs => [],
+      :type_methods => [],
+      :inspect => "#<OCI8::Metadata::Type:(0) #{@conn.username}.ARRAY_OF_INTEGER>", # TODO: change to "#{@conn.username}.RB_TEST_PKG.ARRAY_OF_INTEGER"
+    }
+
+    table_of_pls_integer_type_attrs = {
+      :class => OCI8::Metadata::Type,
+      :typecode => :named_collection,
+      :collection_typecode => :table,
+      :is_incomplete_type? => false,
+      :is_system_type? => false,
+      :is_predefined_type? => false,
+      :is_transient_type? => false,
+      :is_system_generated_type? => false,
+      :has_nested_table? => true,
+      :has_lob? => false,
+      :has_file? => false,
+      :collection_element => {
+        :class => OCI8::Metadata::Collection,
+        :data_size => 0,
+        :typecode => :pls_integer,
+        :data_type => :pls_integer,
+        :num_elems => 0,
+        :precision => 0,
+        :scale => 0,
+        :type_name => 'PL/SQL PLS INTEGER',
+        :schema_name => 'SYS',
+        :type_metadata => pls_integer_type_attrs,
+        :inspect => '#<OCI8::Metadata::Collection: PLS_INTEGER>',
+      },
+      :num_type_attrs => 0,
+      :num_type_methods => 0,
+      :map_method => nil,
+      :order_method => nil,
+      :is_invoker_rights? => false,
+      :name => 'TABLE_OF_PLS_INTEGER',
+      :schema_name => @conn.username,
+      :is_final_type? => true,
+      :is_instantiable_type? => true,
+      :is_subtype? => false,
+      :supertype_schema_name => nil,
+      :supertype_name => nil,
+      :package_name => 'RB_TEST_PKG',
+      :type_attrs => [],
+      :type_methods => [],
+      :inspect => "#<OCI8::Metadata::Type:(0) #{@conn.username}.TABLE_OF_PLS_INTEGER>", # TODO: change to "#{@conn.username}.RB_TEST_PKG.TABLE_OF_PLS_INTEGER"
+    }
+
+    table_of_boolean_type_attrs = {
+      :class => OCI8::Metadata::Type,
+      :typecode => :named_collection,
+      :collection_typecode => :table,
+      :is_incomplete_type? => false,
+      :is_system_type? => false,
+      :is_predefined_type? => false,
+      :is_transient_type? => false,
+      :is_system_generated_type? => false,
+      :has_nested_table? => true,
+      :has_lob? => false,
+      :has_file? => false,
+      :collection_element => {
+        :class => OCI8::Metadata::Collection,
+        :data_size => 0,
+        :typecode => :boolean,
+        :data_type => :boolean,
+        :num_elems => 0,
+        :precision => 0,
+        :scale => 0,
+        :type_name => 'PL/SQL BOOLEAN',
+        :schema_name => 'SYS',
+        :type_metadata => boolean_type_attrs,
+        :inspect => '#<OCI8::Metadata::Collection: BOOLEAN>',
+      },
+      :num_type_attrs => 0,
+      :num_type_methods => 0,
+      :map_method => nil,
+      :order_method => nil,
+      :is_invoker_rights? => false,
+      :name => 'TABLE_OF_BOOLEAN',
+      :schema_name => @conn.username,
+      :is_final_type? => true,
+      :is_instantiable_type? => true,
+      :is_subtype? => false,
+      :supertype_schema_name => nil,
+      :supertype_name => nil,
+      :package_name => 'RB_TEST_PKG',
+      :type_attrs => [],
+      :type_methods => [],
+      :inspect => "#<OCI8::Metadata::Type:(0) #{@conn.username}.TABLE_OF_BOOLEAN>", # TODO: change to "#{@conn.username}.RB_TEST_PKG.TABLE_OF_BOOLEAN"
+    }
+
+    indexed_table_of_varchar2_type_attrs = {
+      :class => OCI8::Metadata::Type,
+      :typecode => :named_collection,
+      :collection_typecode => :itable,
+      :is_incomplete_type? => false,
+      :is_system_type? => false,
+      :is_predefined_type? => false,
+      :is_transient_type? => false,
+      :is_system_generated_type? => false,
+      :has_nested_table? => false,
+      :has_lob? => false,
+      :has_file? => false,
+      :collection_element => {
+        :class => OCI8::Metadata::Collection,
+        :data_size => 10,
+        :typecode => :varchar2,
+        :data_type => :varchar2,
+        :num_elems => 5,
+        :precision => 0,
+        :scale => 0,
+        :type_name => 'VARCHAR2',
+        :schema_name => 'SYS',
+        :type_metadata => varchar2_type_attrs,
+        :inspect => '#<OCI8::Metadata::Collection: VARCHAR2(10)>',
+      },
+      :num_type_attrs => 0,
+      :num_type_methods => 0,
+      :map_method => nil,
+      :order_method => nil,
+      :is_invoker_rights? => false,
+      :name => 'INDEXED_TABLE_OF_VARCHAR2',
+      :schema_name => @conn.username,
+      :is_final_type? => true,
+      :is_instantiable_type? => true,
+      :is_subtype? => false,
+      :supertype_schema_name => nil,
+      :supertype_name => nil,
+      :package_name => 'RB_TEST_PKG',
+      :type_attrs => [],
+      :type_methods => [],
+      :inspect => "#<OCI8::Metadata::Type:(0) #{@conn.username}.INDEXED_TABLE_OF_VARCHAR2>", # TODO: change to "#{@conn.username}.RB_TEST_PKG.INDEXED_TABLE_OF_VARCHAR2"
+    }
+
+    rec1_type_attrs = {
+      :class => OCI8::Metadata::Type,
+      :typecode => :record,
+      :collection_typecode => nil,
+      :is_incomplete_type? => false,
+      :is_system_type? => false,
+      :is_predefined_type? => false,
+      :is_transient_type? => false,
+      :is_system_generated_type? => false,
+      :has_nested_table? => false,
+      :has_lob? => false,
+      :has_file? => false,
+      :collection_element => nil,
+      :num_type_attrs => 2,
+      :num_type_methods => 0,
+      :map_method => nil,
+      :order_method => nil,
+      :is_invoker_rights? => false,
+      :name => 'REC1',
+      :schema_name => @conn.username,
+      :is_final_type? => true,
+      :is_instantiable_type? => true,
+      :is_subtype? => false,
+      :supertype_schema_name => nil,
+      :supertype_name => nil,
+      :package_name => 'RB_TEST_PKG',
+      :type_attrs => {
+        :class => Array,
+        :size => 2,
+        [0] => {
+          :class => OCI8::Metadata::TypeAttr,
+          :data_size => 0,
+          :typecode => :pls_integer,
+          :data_type => :pls_integer,
+          :name => 'I',
+          :precision => 0,
+          :scale => 0,
+          :type_name => 'PL/SQL PLS INTEGER',
+          :schema_name => 'SYS',
+          :fsprecision => 0,
+          :lfprecision => 0,
+          :type_metadata => pls_integer_type_attrs,
+          :inspect => '#<OCI8::Metadata::TypeAttr: I PLS_INTEGER>',
+        },
+        [1] => {
+          :class => OCI8::Metadata::TypeAttr,
+          :data_size => 22,
+          :typecode => :integer,
+          :data_type => :number,
+          :name => 'J',
+          :precision => 38,
+          :scale => 0,
+          :type_name => 'INTEGER',
+          :schema_name => 'SYS',
+          :fsprecision => 0,
+          :lfprecision => 0,
+          :type_metadata => integer_type_attrs,
+          :inspect => '#<OCI8::Metadata::TypeAttr: J NUMBER(38)>', # TODO: change to "INTEGER"
+        },
+      },
+      :type_methods => [],
+      :inspect => "#<OCI8::Metadata::Type:(0) #{@conn.username}.REC1>", # TODO: change to "#{@conn.username}.RB_TEST_PKG.REC1"
+    }
+
+    rec2_type_attrs = {
+      :class => OCI8::Metadata::Type,
+      :typecode => :record,
+      :collection_typecode => nil,
+      :is_incomplete_type? => false,
+      :is_system_type? => false,
+      :is_predefined_type? => false,
+      :is_transient_type? => false,
+      :is_system_generated_type? => false,
+      :has_nested_table? => false,
+      :has_lob? => false,
+      :has_file? => false,
+      :collection_element => nil,
+      :num_type_attrs => 3,
+      :num_type_methods => 0,
+      :map_method => nil,
+      :order_method => nil,
+      :is_invoker_rights? => false,
+      :name => 'REC2',
+      :schema_name => @conn.username,
+      :is_final_type? => true,
+      :is_instantiable_type? => true,
+      :is_subtype? => false,
+      :supertype_schema_name => nil,
+      :supertype_name => nil,
+      :package_name => 'RB_TEST_PKG',
+      :type_attrs => {
+        :class => Array,
+        :size => 3,
+        [0] => {
+          :class => OCI8::Metadata::TypeAttr,
+          :data_size => 0,
+          :typecode => :boolean,
+          :data_type => :boolean,
+          :name => 'B',
+          :precision => 0,
+          :scale => 0,
+          :type_name => 'PL/SQL BOOLEAN',
+          :schema_name => 'SYS',
+          :fsprecision => 0,
+          :lfprecision => 0,
+          :type_metadata => boolean_type_attrs,
+          :inspect => '#<OCI8::Metadata::TypeAttr: B BOOLEAN>',
+        },
+        [1] => {
+          :class => OCI8::Metadata::TypeAttr,
+          :data_size => 0,
+          :typecode => :named_collection,
+          :data_type => :named_type,
+          :name => 'IT',
+          :precision => 0,
+          :scale => 0,
+          :type_name => 'INDEXED_TABLE_OF_VARCHAR2',
+          :schema_name => @conn.username,
+          :fsprecision => 0,
+          :lfprecision => 0,
+          :type_metadata => indexed_table_of_varchar2_type_attrs,
+          :inspect => "#<OCI8::Metadata::TypeAttr: IT #{@conn.username}.INDEXED_TABLE_OF_VARCHAR2>", # TODO: change to "#{@conn.username}.RB_TEST_PKG.INDEXED_TABLE_OF_VARCHAR2"
+        },
+        [2] => {
+          :class => OCI8::Metadata::TypeAttr,
+          :data_size => 0,
+          :typecode => :record,
+          :data_type => :record,
+          :name => 'REC',
+          :precision => 0,
+          :scale => 0,
+          :type_name => 'REC1',
+          :schema_name => @conn.username,
+          :fsprecision => 0,
+          :lfprecision => 0,
+          :type_metadata => rec1_type_attrs,
+          :inspect => "#<OCI8::Metadata::TypeAttr: REC #{@conn.username}.REC1>", # TODO: change to "#{@conn.username}.RB_TEST_PKG.REC1"
+        },
+      },
+      :type_methods => [],
+      :inspect => "#<OCI8::Metadata::Type:(0) #{@conn.username}.REC2>", # TODO: change to "#{@conn.username}.RB_TEST_PKG.REC2"
+    }
+
+    table_of_rec1_type_attrs = {
+      :class => OCI8::Metadata::Type,
+      :typecode => :named_collection,
+      :collection_typecode => :table,
+      :is_incomplete_type? => false,
+      :is_system_type? => false,
+      :is_predefined_type? => false,
+      :is_transient_type? => false,
+      :is_system_generated_type? => false,
+      :has_nested_table? => true,
+      :has_lob? => false,
+      :has_file? => false,
+      :collection_element => {
+        :class => OCI8::Metadata::Collection,
+        :data_size => 0,
+        :typecode => :record,
+        :data_type => :record,
+        :num_elems => 0,
+        :precision => 0,
+        :scale => 0,
+        :type_name => 'REC1',
+        :schema_name => @conn.username,
+        :type_metadata => rec1_type_attrs,
+        :inspect => "#<OCI8::Metadata::Collection: #{@conn.username}.REC1>", # TODO: change to "#{@conn.username}.RB_TEST_PKG.REC1"
+      },
+      :num_type_attrs => 0,
+      :num_type_methods => 0,
+      :map_method => nil,
+      :order_method => nil,
+      :is_invoker_rights? => false,
+      :name => 'TABLE_OF_REC1',
+      :schema_name => @conn.username,
+      :is_final_type? => true,
+      :is_instantiable_type? => true,
+      :is_subtype? => false,
+      :supertype_schema_name => nil,
+      :supertype_name => nil,
+      :package_name => 'RB_TEST_PKG',
+      :type_attrs => [],
+      :type_methods => [],
+      :inspect => "#<OCI8::Metadata::Type:(0) #{@conn.username}.TABLE_OF_REC1>", # TODO: change to "#{@conn.username}.RB_TEST_PKG.TABLE_OF_REC1"
+    }
+
+    table_of_rec2_type_attrs = {
+      :class => OCI8::Metadata::Type,
+      :typecode => :named_collection,
+      :collection_typecode => :table,
+      :is_incomplete_type? => false,
+      :is_system_type? => false,
+      :is_predefined_type? => false,
+      :is_transient_type? => false,
+      :is_system_generated_type? => false,
+      :has_nested_table? => true,
+      :has_lob? => false,
+      :has_file? => false,
+      :collection_element => {
+        :class => OCI8::Metadata::Collection,
+        :data_size => 0,
+        :typecode => :record,
+        :data_type => :record,
+        :num_elems => 0,
+        :precision => 0,
+        :scale => 0,
+        :type_name => 'REC2',
+        :schema_name => @conn.username,
+        :type_metadata => rec2_type_attrs,
+        :inspect => "#<OCI8::Metadata::Collection: #{@conn.username}.REC2>",
+        #:inspect => "#<OCI8::Metadata::Collection: #{@conn.username}.RB_TEST_PKG.REC2>",
+      },
+      :num_type_attrs => 0,
+      :num_type_methods => 0,
+      :map_method => nil,
+      :order_method => nil,
+      :is_invoker_rights? => false,
+      :name => 'TABLE_OF_REC2',
+      :schema_name => @conn.username,
+      :is_final_type? => true,
+      :is_instantiable_type? => true,
+      :is_subtype? => false,
+      :supertype_schema_name => nil,
+      :supertype_name => nil,
+      :package_name => 'RB_TEST_PKG',
+      :type_attrs => [],
+      :type_methods => [],
+      :inspect => "#<OCI8::Metadata::Type:(0) #{@conn.username}.TABLE_OF_REC2>", # TODO: change to "#{@conn.username}.RB_TEST_PKG.TABLE_OF_REC2"
+    }
+
+    type_metadata_attrs = {
+      'ARRAY_OF_INTEGER' => array_of_integer_type_attrs,
+      'TABLE_OF_PLS_INTEGER' => table_of_pls_integer_type_attrs,
+      'TABLE_OF_BOOLEAN' => table_of_boolean_type_attrs,
+      'INDEXED_TABLE_OF_VARCHAR2' => indexed_table_of_varchar2_type_attrs,
+      'REC1' => rec1_type_attrs,
+      'REC2' => rec2_type_attrs,
+      'TABLE_OF_REC1' => table_of_rec1_type_attrs,
+      'TABLE_OF_REC2' => table_of_rec2_type_attrs,
+    }
+
+    sum_table_of_pls_integer_subprogram_attrs = {
+      :class => OCI8::Metadata::Function,
+      :obj_name => 'SUM_TABLE_OF_PLS_INTEGER',
+      :obj_schema => nil,
+      :is_invoker_rights? => false,
+      :name => 'SUM_TABLE_OF_PLS_INTEGER',
+      :overload_id => 0,
+      :arguments => {
+        :class => Array,
+        :size => 2,
+        [0] => {
+          :class => OCI8::Metadata::Argument,
+          :obj_name => nil,
+          :obj_schema => nil,
+          :name => "",
+          :position => 0,
+          #:typecode => nil,
+          :data_type => 3,
+          :data_size => 0,
+          :precision => 0,
+          :scale => 0,
+          :level => 0,
+          :has_default => 0,
+          :has_default? => false,
+          :iomode => :out,
+          :radix => 0,
+          :type_name => "",
+          :schema_name => "",
+          :sub_name => "",
+          :link => "",
+          #:type_metadata => nil,
+          :arguments => [],
+          :inspect => '#<OCI8::Metadata::Argument:  unknown(3)>', # TODO: change to "PLS_INTEGER"
+        },
+        [1] => {
+          :class => OCI8::Metadata::Argument,
+          :obj_name => nil,
+          :obj_schema => nil,
+          :name => "TBL",
+          :position => 1,
+          #:typecode => nil,
+          :data_type => :named_type,
+          :data_size => 0,
+          :precision => 0,
+          :scale => 0,
+          :level => 0,
+          :has_default => 0,
+          :has_default? => false,
+          :iomode => :in,
+          :radix => 0,
+          :type_name => "RB_TEST_PKG",
+          :schema_name => @conn.username,
+          :sub_name => "TABLE_OF_PLS_INTEGER",
+          :link => "",
+          #:type_metadata => nil,
+          :arguments => {
+            :class => Array,
+            :size => 1,
+            [0] => {
+              :class => OCI8::Metadata::Argument,
+              :obj_name => nil,
+              :obj_schema => nil,
+              :name => "",
+              :position => 1,
+              #:typecode => nil,
+              :data_type => 3,
+              :data_size => 0,
+              :precision => 0,
+              :scale => 0,
+              :level => 1,
+              :has_default => 0,
+              :has_default? => false,
+              :iomode => :in,
+              :radix => 0,
+              :type_name => "",
+              :schema_name => "",
+              :sub_name => "",
+              :link => "",
+              #:type_metadata => nil,
+              :arguments => [],
+              :inspect => '#<OCI8::Metadata::Argument:  unknown(3)>', # TODO: change to "PLS_INTEGER"
+            },
+          },
+          :inspect => "#<OCI8::Metadata::Argument: TBL #{@conn.username}.RB_TEST_PKG>", # TODO: change to "#{@conn.username}.RB_TEST_PKG.TABLE_OF_PLS_INTEGER"
+        },
+      },
+      :is_standalone? => false,
+      :inspect => '#<OCI8::Metadata::Function: SUM_TABLE_OF_PLS_INTEGER>', # FIXME
+    }
+
+    add_rec1_values_subprogram_attrs = {
+      :class => OCI8::Metadata::Function,
+      :obj_name => 'ADD_REC1_VALUES',
+      :obj_schema => nil,
+      :is_invoker_rights? => false,
+      :name => 'ADD_REC1_VALUES',
+      :overload_id => 0,
+      :arguments => {
+        :class => Array,
+        :size => 2,
+        [0] => {
+          :class => OCI8::Metadata::Argument,
+          :obj_name => nil,
+          :obj_schema => nil,
+          :name => "",
+          :position => 0,
+          #:typecode => nil,
+          :data_type => 3,
+          :data_size => 0,
+          :precision => 0,
+          :scale => 0,
+          :level => 0,
+          :has_default => 0,
+          :has_default? => false,
+          :iomode => :out,
+          :radix => 0,
+          :type_name => "",
+          :schema_name => "",
+          :sub_name => "",
+          :link => "",
+          #:type_metadata => nil,
+          :arguments => [],
+          :inspect => '#<OCI8::Metadata::Argument:  unknown(3)>', # TODO: change to "PLS_INTEGER"
+        },
+        [1] => {
+          :class => OCI8::Metadata::Argument,
+          :obj_name => nil,
+          :obj_schema => nil,
+          :name => "TBL",
+          :position => 1,
+          #:typecode => nil,
+          :data_type => :named_type,
+          :data_size => 0,
+          :precision => 0,
+          :scale => 0,
+          :level => 0,
+          :has_default => 0,
+          :has_default? => false,
+          :iomode => :in,
+          :radix => 0,
+          :type_name => "RB_TEST_PKG",
+          :schema_name => @conn.username,
+          :sub_name => "TABLE_OF_REC1",
+          :link => "",
+          #:type_metadata => nil,
+          :arguments => {
+            :class => Array,
+            :size => 1,
+            [0] => {
+              :class => OCI8::Metadata::Argument,
+              :obj_name => nil,
+              :obj_schema => nil,
+              :name => "",
+              :position => 1,
+              #:typecode => nil,
+              :data_type => 250,
+              :data_size => 0,
+              :precision => 0,
+              :scale => 0,
+              :level => 1,
+              :has_default => 0,
+              :has_default? => false,
+              :iomode => :in,
+              :radix => 0,
+              :type_name => "RB_TEST_PKG",
+              :schema_name => @conn.username,
+              :sub_name => "REC1",
+              :link => "",
+              #:type_metadata => nil,
+              :arguments => {
+                :class => Array,
+                :size => 2,
+                [0] => {
+                  :class => OCI8::Metadata::Argument,
+                  :obj_name => nil,
+                  :obj_schema => nil,
+                  :name => "I",
+                  :position => 1,
+                  #:typecode => nil,
+                  :data_type => 3,
+                  :data_size => 0,
+                  :precision => 0,
+                  :scale => 0,
+                  :level => 2,
+                  :has_default => 0,
+                  :has_default? => false,
+                  :iomode => :in,
+                  :radix => 0,
+                  :type_name => "",
+                  :schema_name => "",
+                  :sub_name => "",
+                  :link => "",
+                  #:type_metadata => nil,
+                  :arguments => [],
+                  :inspect => '#<OCI8::Metadata::Argument: I unknown(3)>', # TODO: change to "PLS_INTEGER"
+                },
+                [1] => {
+                  :class => OCI8::Metadata::Argument,
+                  :obj_name => nil,
+                  :obj_schema => nil,
+                  :name => "J",
+                  :position => 2,
+                  #:typecode => nil,
+                  :data_type => :number,
+                  :data_size => 22,
+                  :precision => 38,
+                  :scale => 0,
+                  :level => 2,
+                  :has_default => 0,
+                  :has_default? => false,
+                  :iomode => :in,
+                  :radix => 10,
+                  :type_name => "",
+                  :schema_name => "",
+                  :sub_name => "",
+                  :link => "",
+                  #:type_metadata => nil,
+                  :arguments => [],
+                  :inspect => '#<OCI8::Metadata::Argument: J NUMBER(38)>', # TODO: change to "INTEGER"
+                },
+              },
+              :inspect => '#<OCI8::Metadata::Argument:  unknown(250)>', # TODO: change to "#{@conn.username}.RB_TEST_PKG.REC1"
+            },
+          },
+          :inspect => "#<OCI8::Metadata::Argument: TBL #{@conn.username}.RB_TEST_PKG>", # TODO: change to "#{@conn.username}.RB_TEST_PKG.TABLE_OF_REC1"
+        },
+      },
+      :is_standalone? => false,
+      :inspect => '#<OCI8::Metadata::Function: ADD_REC1_VALUES>', # TODO: change to "#{@conn.username}.RB_TEST_PKG.ADD_REC1_VALUES"
+    }
+
+    out_rec1_values_subprogram_attrs = {
+      :class => OCI8::Metadata::Procedure,
+      :obj_name => 'OUT_REC1_VALUES',
+      :obj_schema => nil,
+      :is_invoker_rights? => false,
+      :name => 'OUT_REC1_VALUES',
+      :overload_id => 0,
+      :arguments => {
+        :class => Array,
+        :size => 1,
+        [0] => {
+          :class => OCI8::Metadata::Argument,
+          :obj_name => nil,
+          :obj_schema => nil,
+          :name => "TBL",
+          :position => 1,
+          #:typecode => nil,
+          :data_type => :named_type,
+          :data_size => 0,
+          :precision => 0,
+          :scale => 0,
+          :level => 0,
+          :has_default => 0,
+          :has_default? => false,
+          :iomode => :out,
+          :radix => 0,
+          :type_name => "RB_TEST_PKG",
+          :schema_name => @conn.username,
+          :sub_name => "TABLE_OF_REC1",
+          :link => "",
+          #:type_metadata => nil,
+          :arguments => {
+            :class => Array,
+            :size => 1,
+            [0] => {
+              :class => OCI8::Metadata::Argument,
+              :obj_name => nil,
+              :obj_schema => nil,
+              :name => "",
+              :position => 1,
+              #:typecode => nil,
+              :data_type => 250,
+              :data_size => 0,
+              :precision => 0,
+              :scale => 0,
+              :level => 1,
+              :has_default => 0,
+              :has_default? => false,
+              :iomode => :out,
+              :radix => 0,
+              :type_name => "RB_TEST_PKG",
+              :schema_name => @conn.username,
+              :sub_name => "REC1",
+              :link => "",
+              #:type_metadata => nil,
+              :arguments => {
+                :class => Array,
+                :size => 2,
+                [0] => {
+                  :class => OCI8::Metadata::Argument,
+                  :obj_name => nil,
+                  :obj_schema => nil,
+                  :name => "I",
+                  :position => 1,
+                  #:typecode => nil,
+                  :data_type => 3,
+                  :data_size => 0,
+                  :precision => 0,
+                  :scale => 0,
+                  :level => 2,
+                  :has_default => 0,
+                  :has_default? => false,
+                  :iomode => :out,
+                  :radix => 0,
+                  :type_name => "",
+                  :schema_name => "",
+                  :sub_name => "",
+                  :link => "",
+                  #:type_metadata => nil,
+                  :arguments => [],
+                  :inspect => '#<OCI8::Metadata::Argument: I unknown(3)>', # TODO: change to "PLS_INTEGER"
+                },
+                [1] => {
+                  :class => OCI8::Metadata::Argument,
+                  :obj_name => nil,
+                  :obj_schema => nil,
+                  :name => "J",
+                  :position => 2,
+                  #:typecode => nil,
+                  :data_type => :number,
+                  :data_size => 22,
+                  :precision => 38,
+                  :scale => 0,
+                  :level => 2,
+                  :has_default => 0,
+                  :has_default? => false,
+                  :iomode => :out,
+                  :radix => 10,
+                  :type_name => "",
+                  :schema_name => "",
+                  :sub_name => "",
+                  :link => "",
+                  #:type_metadata => nil,
+                  :arguments => [],
+                  :inspect => '#<OCI8::Metadata::Argument: J NUMBER(38)>', # TODO: change to "INTEGER"
+                },
+              },
+              :inspect => '#<OCI8::Metadata::Argument:  unknown(250)>', # TODO: change to "#{@conn.username}.RB_TEST_PKG.REC1"
+            },
+          },
+          :inspect => "#<OCI8::Metadata::Argument: TBL #{@conn.username}.RB_TEST_PKG>", # TODO: change to "#{@conn.username}.RB_TEST_PKG.TABLE_OF_REC1"
+        },
+      },
+      :is_standalone? => false,
+      :inspect => '#<OCI8::Metadata::Procedure: OUT_REC1_VALUES>', # TODO: change to "#{@conn.username}.RB_TEST_PKG.OUT_REC1_VALUES"
+    }
+
+    subprogram_metadata_attrs = {
+      'SUM_TABLE_OF_PLS_INTEGER' => sum_table_of_pls_integer_subprogram_attrs,
+      'ADD_REC1_VALUES' => add_rec1_values_subprogram_attrs,
+      'OUT_REC1_VALUES' => out_rec1_values_subprogram_attrs,
+    }
+
+    pkg_metadata = @conn.describe_package('rb_test_pkg')
+
+    assert_kind_of(OCI8::Metadata::Package, pkg_metadata)
+    assert_equal(false, pkg_metadata.is_invoker_rights?)
+    type_metadata = pkg_metadata.types
+    assert_kind_of(Array, type_metadata)
+    assert_equal(8, type_metadata.size)
+    type_metadata.each do |md|
+      attrs = type_metadata_attrs[md.name]
+      if attrs
+        check_attributes(md.name, md, attrs)
+      else
+        raise "unknown type name #{md.name}"
+      end
+    end
+
+    subprogram_metadata = pkg_metadata.subprograms
+    assert_kind_of(Array, subprogram_metadata)
+    assert_equal(3, subprogram_metadata.size)
+    subprogram_metadata.each do |md|
+      attrs = subprogram_metadata_attrs[md.name]
+      if attrs
+        check_attributes(md.name, md, attrs)
+      else
+        raise "unknown subprogram name #{md.name}"
+      end
+    end
+  end
+end