ruby-oci8 2.1.5.1-x64-mingw32

data/lib/oci8/oracle_version.rb

@@ -0,0 +1,143 @@
+# oracle_version.rb implements OCI8::OracleVersion.
+#
+# Copyright (C) 2009-2013 Kubo Takehiro <kubo@jiubao.org>
+
+#
+class OCI8
+
+  # The data class, representing Oracle version.
+  #
+  # Oracle version is represented by five numbers:
+  # *major*, *minor*, *update*, *patch* and *port_update*.
+  #
+  # @see OCI8.oracle_client_version
+  # @see OCI8#oracle_server_version
+  class OracleVersion
+    include Comparable
+
+    # The first part of the Oracle version.
+    attr_reader :major
+    # The second part of the Oracle version.
+    attr_reader :minor
+    # The third part of the Oracle version.
+    attr_reader :update
+    # The fourth part of the Oracle version.
+    attr_reader :patch
+    # The fifth part of the Oracle version.
+    attr_reader :port_update
+
+    # Creates an OCI8::OracleVersion object.
+    #
+    # If the first argument _arg_ is a String, it is parsed as dotted
+    # version string. If it is bigger than 0x08000000, it is parsed as
+    # a number contains 5-digit Oracle version. Otherwise, it is used
+    # as a major version and the rest arguments are minor, update,
+    # patch and port_update. Unspecified version numbers are zeros by
+    # default.
+    #
+    # @example
+    #   # When the first argument is a String,
+    #   oraver = OCI8::OracleVersion.new('11.2.0.3')
+    #   oraver.major       # => 11
+    #   oraver.minor       # =>  2
+    #   oraver.update      # =>  0
+    #   oraver.patch       # =>  3
+    #   oraver.port_update # =>  0
+    #
+    #   # When the first argument is bigger than 0x08000000,
+    #   oraver = OCI8::OracleVersion.new(0x0b200300)
+    #   oraver.major       # => 11
+    #   oraver.minor       # =>  2
+    #   oraver.update      # =>  0
+    #   oraver.patch       # =>  3
+    #   oraver.port_update # =>  0
+    #
+    #   # Otherwise,
+    #   oraver = OCI8::OracleVersion.new(11, 2, 0, 3)
+    #   oraver.major       # => 11
+    #   oraver.minor       # =>  2
+    #   oraver.update      # =>  0
+    #   oraver.patch       # =>  3
+    #   oraver.port_update # =>  0
+    #
+    # @return [OCI8::OracleVersion]
+    def initialize(arg, minor = nil, update = nil, patch = nil, port_update = nil)
+      if arg.is_a? String
+        major, minor, update, patch, port_update = arg.split('.').collect do |v|
+          v.to_i
+        end
+      elsif arg >= 0x08000000
+        major  = (arg & 0xFF000000) >> 24
+        minor  = (arg & 0x00F00000) >> 20
+        update = (arg & 0x000FF000) >> 12
+        patch  = (arg & 0x00000F00) >> 8
+        port_update = (arg & 0x000000FF)
+      else
+        major = arg
+      end
+      @major = major
+      @minor = minor || 0
+      @update = update || 0
+      @patch = patch || 0
+      @port_update = port_update || 0
+      @vernum = (@major << 24) | (@minor << 20) | (@update << 12) | (@patch << 8) | @port_update
+    end
+
+    # Compares +self+ and +other+.
+    #
+    # <=> is the basis for the methods <, <=, ==, >, >=, and between?,
+    # included from the Comparable module.
+    #
+    # @return [-1, 0, +1]
+    def <=>(other)
+      @vernum <=> other.to_i
+    end
+
+    # Returns an integer number contains 5-digit Oracle version.
+    #
+    # If the hexadecimal notation is 0xAABCCDEE, *major*, *minor*,
+    # *update*, *patch* and *port_update* are 0xAA, 0xB, 0xCC, 0xD and
+    # 0xEE respectively.
+    #
+    # @example
+    #   oraver = OCI8::OracleVersion.new('11.2.0.3')
+    #   oraver.to_i          # => 186647296
+    #   '%08x' % oraver.to_i # => "0b200300"
+    #
+    # @return [Integer]
+    def to_i
+      @vernum
+    end
+
+    # Returns a dotted version string of the Oracle version.
+    #
+    # @example
+    #   oraver = OCI8::OracleVersion.new('11.2.0.3')
+    #   oraver.to_s          # => '11.2.0.3.0'
+    #
+    # @return [String]
+    def to_s
+      format('%d.%d.%d.%d.%d', @major, @minor, @update, @patch, @port_update)
+    end
+
+    # Returns true if +self+ and +other+ are the same type and have
+    # equal values.
+    #
+    # @return [true or false]
+    def eql?(other)
+      other.is_a? OCI8::OracleVersion and (self <=> other) == 0
+    end
+
+    # Returns a hash based on the value of +self+.
+    #
+    # @return [Integer]
+    def hash
+      @vernum
+    end
+
+    # @private
+    def inspect
+      "#<#{self.class.to_s}: #{self.to_s}>"
+    end
+  end
+end

data/lib/oci8/properties.rb

@@ -0,0 +1,134 @@
+# properties.rb -- implements OCI8.properties
+#
+# Copyright (C) 2010-2013 KUBO Takehiro <kubo@jiubao.org>
+
+#
+class OCI8
+
+  # @private
+  @@properties = {
+    :length_semantics => :byte,
+    :bind_string_as_nchar => false,
+    :float_conversion_type => OCI8.__get_prop(1) ? :ruby : :oracle,
+    :statement_cache_size => 0,
+    :events_mode => ((OCI8.__get_prop(2) & 4) != 0) # 4 <- OCI_EVENTS in oci.h
+  }
+
+  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)
+    super(name)
+  end
+
+  # @private
+  def @@properties.[]=(name, val)
+    raise IndexError, "No such property name: #{name}" unless @@properties.has_key?(name)
+    case name
+    when :length_semantic
+      if val != :byte and val != :char
+        raise ArgumentError, "Invalid property value #{val} for :length_semantics."
+      end
+    when :bind_string_as_nchar
+      val = val ? true : false
+    when :float_conversion_type
+      case val
+      when :ruby
+        OCI8.__set_prop(1, true)
+      when :oracle
+        OCI8.__set_prop(1, false)
+      else
+        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
+      val = val ? true : false
+      if val
+        OCI8.__set_prop(2, OCI8.__get_prop(2) | 4) # set OCI_EVENTS
+      else
+        OCI8.__set_prop(2, OCI8.__get_prop(2) & ~4) # unset OCI_EVENTS
+      end
+    end
+    super(name, val)
+  end
+
+  # Returns a Hash which ruby-oci8 global settings.
+  # The hash's setter and getter methods are customized to check
+  # property names and values.
+  #
+  #   # get properties
+  #   OCI8.properties[:bind_string_as_nchar]  # => false
+  #   OCI8.properties[:invalid_property_name] # raises an IndexError
+  #
+  #   # set properties
+  #   OCI8.properties[:bind_string_as_nchar] = true
+  #   OCI8.properties[:invalid_property_name] = true # raises an IndexError
+  #
+  # Supported properties are listed below:
+  #
+  # [:length_semantics]
+  #     
+  #     +:char+ when Oracle character length is counted by the number of characters.
+  #     +:byte+ when it is counted by the number of bytes.
+  #     The default setting is +:byte+ because +:char+ causes unexpected behaviour on
+  #     Oracle 9i.
+  #     
+  #     *Since:* 2.1.0
+  #
+  # [:bind_string_as_nchar]
+  #     
+  #     +true+ when string bind variables are bound as NCHAR,
+  #     otherwise +false+. The default value is +false+.
+  #
+  # [:float_conversion_type]
+  #     
+  #     +:ruby+ when Oracle decimal numbers are converted to ruby Float values
+  #     same as Float#to_s does. (default)
+  #     +:oracle:+ when they are done by Oracle OCI functions.
+  #     
+  #     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
+  #     
+  #     *Since:* 2.1.0
+  #
+  # [:statement_cache_size]
+  #     
+  #     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
+  #
+  # [:events_mode]
+  #     
+  #     +true+ when Fast Application Notification (FAN) Support is enabled.
+  #     +false+ when it is disabled. The default value is +false+.
+  #     This corresponds to {http://php.net/manual/en/oci8.configuration.php#ini.oci8.events +oci8.events+ in PHP}.
+  #     
+  #     This parameter can be changed only when no OCI methods are called.
+  #     
+  #       require 'oci8'
+  #       OCI8.properties[:events_mode] = true # works fine.
+  #       ... call some OCI methods ...
+  #       OCI8.properties[:events_mode] = true # raises a runtime error.
+  #     
+  #     *Since:* 2.1.4
+  #
+  # @return [a customized Hash]
+  # @since 2.0.5
+  #
+  def self.properties
+    @@properties
+  end
+end

data/metaconfig

@@ -0,0 +1,142 @@
+# --*- ruby -*--
+
+ToplevelInstaller::TASKS.push ['test', 'run test.']
+ToplevelInstaller::TASKS.push ['distbin', 'make binary package.']
+ToplevelInstaller.module_eval {
+  alias parsearg_test parsearg_no_options
+  alias parsearg_distbin parsearg_no_options
+
+  def exec_test
+    old = Dir.pwd
+    @installer.mkdir_p "#{objdir_root}/test"
+    Dir.chdir "#{objdir_root}/test"
+    @installer.ruby("-w -I#{srcdir_root}/ext/oci8 -I#{srcdir_root}/lib -I#{srcdir_root}/support -I#{srcdir_root}/test #{srcdir_root}/test/test_all.rb")
+    Dir.chdir old
+  end
+
+  def get_zcontent(file)
+    require 'base64'
+    require 'zlib'
+    File.open(file, 'rb') do |f|
+      Base64.encode64(Zlib::Deflate::deflate(f.read))
+    end
+  end
+
+  def exec_distbin
+    File.open("ruby-oci8-#{RUBY_PLATFORM}.rb", 'w') do |f|
+      f.write <<-EOT
+# ruby-oci8 binary installer for #{RUBY_PLATFORM}
+require 'rbconfig'
+require 'base64'
+require 'ftools'
+require 'zlib'
+
+def msg_error(msg)
+  puts "ERROR: "
+  puts msg
+  exit 1
+end
+
+def msg_ok(msg)
+  puts msg
+end
+
+def msg_ask(msg)
+  puts msg
+  $stdout.print "Enter Yes/No: "
+  $stdout.flush
+  ret = gets().chomp.downcase
+  if ret == 'y' || ret == 'ye' || ret == 'yes'
+     return
+  else
+     exit 1
+  end
+end
+
+if '#{RUBY_PLATFORM}' != RUBY_PLATFORM
+  msg_ask "This package is for #{RUBY_PLATFORM}\\ninstall anyway?"
+end
+
+class Installer
+  @@log = ""
+  def initialize(install_files)
+    @files = []
+    install_files.each do |file, content|
+      basename = File.basename(file)
+      dirname = File.dirname(file)
+      if dirname == '.'
+        dirname = ''
+      else
+        dirname = '/' + dirname 
+      end
+      case basename
+      when /\.so$/
+        dirname = "\#{Config::CONFIG['sitearchdir']}\#{dirname}"
+      else
+        dirname = "\#{Config::CONFIG['sitelibdir']}\#{dirname}"
+      end
+      @files << [basename, dirname, content]
+    end
+    @files.sort! do |x, y| x[0] <=> y[0] end
+  end
+
+  def confirm
+    msg = ""
+    @files.each do |f|
+      basename, dirname, content = f
+      msg << "Copy \#{basename} to \#{dirname}\\n"
+    end
+    msg << "OK?\\n"
+    msg_ask(msg)
+  end
+
+  def install
+    @@log = ""
+    @files.each do |f|
+      basename, dirname, content = f
+      @@log << "Copying \#{basename} to \#{dirname} ... "
+      if not FileTest.directory?(dirname)
+        File.makedirs(dirname)
+      end
+      File.open("\#{dirname}/\#{basename}", "wb") do |f|
+        f.write(Zlib::Inflate::inflate(Base64.decode64(content)))
+      end
+      @@log << "done\\n"
+    end
+    @@log << "OK\\n"
+    msg_ok(@@log)
+  end
+
+  def self.log
+    @@log
+  end
+end
+
+install_files = {}
+
+install_files['oci8lib.so'] = <<-EOS
+#{get_zcontent('ext/oci8/oci8lib.so')}EOS
+
+install_files['oci8.rb'] = <<-EOS
+#{get_zcontent('lib/oci8.rb')}EOS
+
+install_files['DBD/OCI8/OCI8.rb'] = <<-EOS
+#{get_zcontent('lib/DBD/OCI8/OCI8.rb')}EOS
+
+begin
+  installer = Installer.new(install_files)
+  installer.confirm
+  installer.install
+rescue
+  msg_error(Installer.log + "\\n" + $!.to_s)
+end
+EOT
+    end
+  end
+}
+
+
+ConfigTable.add_entry('oracle_version', ['',
+                                         'name',
+                                         'Oracle version name',
+                                         'NONE' ])

data/pre-distclean.rb

@@ -0,0 +1,7 @@
+rm_f "#{curr_objdir}/lib/oci8.rb"
+rm_f "#{curr_objdir}/ext/oci8/oci8lib_18.map"
+rm_f "#{curr_objdir}/ext/oci8/oci8lib_191.map"
+if RUBY_PLATFORM =~ /cygwin/
+  rm_f "#{curr_objdir}/ext/oci8/OCI.def"
+  rm_f "#{curr_objdir}/ext/oci8/libOCI.a"
+end

data/ruby-oci8.gemspec

@@ -0,0 +1,80 @@
+# -*- ruby -*-
+#
+# To make a pure ruby gems package:
+#   gem build ruby-oci8.gemspec
+#
+# To make a binary gems package:
+#   gem build ruby-oci8.gemspec -- current
+#
+require 'fileutils'
+
+if ARGV.include?("--") and ARGV[(ARGV.index("--") + 1)] == 'current'
+  gem_platform = 'current'
+else
+  gem_platform = Gem::Platform::RUBY
+end
+
+spec = Gem::Specification.new do |s|
+  s.name = 'ruby-oci8'
+  s.version = File.read('VERSION').strip
+  s.summary = 'Ruby interface for Oracle using OCI8 API'
+  s.email = 'kubo@jiubao.org'
+  s.homepage = 'http://ruby-oci8.rubyforge.org'
+  s.rubyforge_project = '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.
+EOS
+  s.has_rdoc = 'yard'
+  s.authors = ['Kubo Takehiro']
+  s.platform = gem_platform
+  s.license = '2-clause BSD-style license'
+  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'
+  else
+    so_files = Dir.glob('ext/oci8/oci8lib_*.so')
+    so_vers = so_files.collect do |file|
+      $1 if /ext\/oci8\/oci8lib_(\S+).so/ =~ file
+    end.sort
+
+    # add map files to analyze a core (minidump) file.
+    so_vers.each do |ver|
+      map_file = 'ext/oci8/oci8lib_#{ver}.map'
+      so_files << map_file if File.exists? map_file
+    end
+
+    # least version in so_vers
+    so_vermin = so_vers.collect do |ver|
+      "#$1.#$2.#{$3||'0'}" if /^(?:rbx)?(\d)(\d)(\d)?/ =~ ver
+    end.sort.first
+
+    case so_vers.length
+    when 0
+      raise "No compiled binary are found. Run make in advance."
+    when 1
+      puts "Binary gem for ruby #{so_vers.first}"
+      if so_vers[0] < '2.0.0'
+        s.required_ruby_version = "~> #{so_vermin}"
+      else
+        s.required_ruby_version = "~> #{so_vermin}.0"
+      end
+    else
+      puts "Binary gem for ruby #{so_vers.join(', ')}"
+      s.required_ruby_version = ">= #{so_vermin}"
+    end
+
+    FileUtils.copy so_files, 'lib', :preserve => true
+    files.reject! do |fname|
+      fname =~ /^ext/
+    end
+    so_files.each do |fname|
+      files << 'lib/' + File.basename(fname)
+    end
+    files << 'lib/oci8.rb'
+  end
+  s.require_paths = ['lib', 'ext/oci8']
+  s.files = files
+  s.test_files = 'test/test_all.rb'
+  s.extra_rdoc_files = ['README.md']
+end